@xemahq/agent-runtime-bridge

HTTP bridge driving the agent runtime to completion

Overview

An HTTP driver that runs an agent session against a running agent runtime. It parses the streamed session protocol into lossless runtime frames, projects them into session frames, routes interaction replies back, and applies workspace images over HTTP.

When to use it

• A host needs to drive an agent session over HTTP and consume its events as a stable frame stream.

Installation

pnpm add @xemahq/agent-runtime-bridge

Usage

import { HttpAgentSessionDriver } from '@xemahq/agent-runtime-bridge';

const driver = new HttpAgentSessionDriver({ authHeaders });

// drive() yields RuntimeFrame values; driveToCompletion() runs to the end.
const result = await driver.driveToCompletion(allocation, params, abortSignal);

HttpWorkspaceImageApplier applies workspace image plans over HTTP.

Configuration

| Option | Meaning | | --- | --- | | SessionDriverHttpOptions.authHeaders | Headers forwarded on every driver request. |

Peer requirements

• @xemahq/agent-session-runtime >=0.20.0
• @xemahq/contracts >=0.42.0

License

Apache-2.0 © Xema — xema.dev