@annals/bridge-protocol 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+/** Standard Bridge Protocol error codes */
+export declare const BridgeErrorCode: {
+    readonly TIMEOUT: "timeout";
+    readonly ADAPTER_CRASH: "adapter_crash";
+    readonly AGENT_BUSY: "agent_busy";
+    readonly AUTH_FAILED: "auth_failed";
+    readonly AGENT_OFFLINE: "agent_offline";
+    readonly INVALID_MESSAGE: "invalid_message";
+    readonly SESSION_NOT_FOUND: "session_not_found";
+    readonly RATE_LIMITED: "rate_limited";
+    readonly INTERNAL_ERROR: "internal_error";
+};
+export type BridgeErrorCode = (typeof BridgeErrorCode)[keyof typeof BridgeErrorCode];
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,eAAO,MAAM,eAAe;;;;;;;;;;CAUlB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}

package/dist/errors.js

@@ -0,0 +1,13 @@
+/** Standard Bridge Protocol error codes */
+export const BridgeErrorCode = {
+    TIMEOUT: 'timeout',
+    ADAPTER_CRASH: 'adapter_crash',
+    AGENT_BUSY: 'agent_busy',
+    AUTH_FAILED: 'auth_failed',
+    AGENT_OFFLINE: 'agent_offline',
+    INVALID_MESSAGE: 'invalid_message',
+    SESSION_NOT_FOUND: 'session_not_found',
+    RATE_LIMITED: 'rate_limited',
+    INTERNAL_ERROR: 'internal_error',
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,eAAe;IAC9B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;IACtC,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;CACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './messages.js';
+export * from './errors.js';
+export { BRIDGE_PROTOCOL_VERSION } from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './messages.js';
+export * from './errors.js';
+export { BRIDGE_PROTOCOL_VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,91 @@
+import type { BridgeErrorCode } from './errors.js';
+/** Sent immediately after WebSocket connection to authenticate */
+export interface Register {
+    type: 'register';
+    agent_id: string;
+    token: string;
+    bridge_version: string;
+    agent_type: 'openclaw' | 'claude' | 'codex' | 'gemini' | string;
+    capabilities: string[];
+}
+/** Incremental text chunk from agent */
+export interface Chunk {
+    type: 'chunk';
+    session_id: string;
+    request_id: string;
+    delta: string;
+}
+/** Agent finished responding */
+export interface Done {
+    type: 'done';
+    session_id: string;
+    request_id: string;
+}
+/** Agent encountered an error */
+export interface BridgeError {
+    type: 'error';
+    session_id: string;
+    request_id: string;
+    code: BridgeErrorCode | string;
+    message: string;
+}
+/** Periodic heartbeat from bridge CLI */
+export interface Heartbeat {
+    type: 'heartbeat';
+    active_sessions: number;
+    uptime_ms: number;
+}
+/** All messages sent from Bridge CLI to Worker */
+export type BridgeToWorkerMessage = Register | Chunk | Done | BridgeError | Heartbeat;
+/** Registration acknowledgment */
+export interface Registered {
+    type: 'registered';
+    status: 'ok' | 'error';
+    error?: string;
+}
+/** User message forwarded to agent */
+export interface Message {
+    type: 'message';
+    session_id: string;
+    request_id: string;
+    content: string;
+    attachments: Attachment[];
+}
+/** Cancel an in-progress request */
+export interface Cancel {
+    type: 'cancel';
+    session_id: string;
+    request_id: string;
+}
+/** All messages sent from Worker to Bridge CLI */
+export type WorkerToBridgeMessage = Registered | Message | Cancel;
+export interface Attachment {
+    name: string;
+    url: string;
+    type: string;
+}
+/** Any Bridge Protocol message */
+export type BridgeMessage = BridgeToWorkerMessage | WorkerToBridgeMessage;
+/** POST /api/relay request body */
+export interface RelayRequest {
+    agent_id: string;
+    session_id: string;
+    request_id: string;
+    content: string;
+    attachments?: Attachment[];
+}
+/** SSE event from relay endpoint */
+export interface RelayChunkEvent {
+    type: 'chunk';
+    delta: string;
+}
+export interface RelayDoneEvent {
+    type: 'done';
+}
+export interface RelayErrorEvent {
+    type: 'error';
+    code: string;
+    message: string;
+}
+export type RelayEvent = RelayChunkEvent | RelayDoneEvent | RelayErrorEvent;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"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"}

package/dist/messages.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** Bridge Protocol version */
+export declare const BRIDGE_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,eAAO,MAAM,uBAAuB,IAAI,CAAC"}

package/dist/version.js

@@ -0,0 +1,3 @@
+/** Bridge Protocol version */
+export const BRIDGE_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@annals/bridge-protocol",
+  "version": "0.1.0",
+  "description": "Bridge Protocol type definitions for agent-bridge",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "files": ["dist"],
+  "license": "MIT"
+}