agent-relay 2.2.24 → 2.3.0

package/packages/sdk-ts/src/protocol.ts

@@ -0,0 +1,266 @@
+export const PROTOCOL_VERSION = 1 as const;
+
+export type AgentRuntime = "pty" | "headless_claude";
+
+export interface AgentSpec {
+  name: string;
+  runtime: AgentRuntime;
+  cli?: string;
+  args?: string[];
+  channels?: string[];
+}
+
+export interface RelayDelivery {
+  delivery_id: string;
+  event_id: string;
+  from: string;
+  target: string;
+  body: string;
+  thread_id?: string;
+  priority?: number;
+}
+
+export interface ProtocolEnvelope<TPayload> {
+  v: number;
+  type: string;
+  request_id?: string;
+  payload: TPayload;
+}
+
+export type SdkToBroker =
+  | {
+      type: "hello";
+      payload: { client_name: string; client_version: string };
+    }
+  | {
+      type: "spawn_agent";
+      payload: { agent: AgentSpec };
+    }
+  | {
+      type: "send_message";
+      payload: {
+        to: string;
+        text: string;
+        from?: string;
+        thread_id?: string;
+        priority?: number;
+      };
+    }
+  | {
+      type: "release_agent";
+      payload: { name: string };
+    }
+  | {
+      type: "list_agents";
+      payload: Record<string, never>;
+    }
+  | {
+      type: "get_status";
+      payload: Record<string, never>;
+    }
+  | {
+      type: "shutdown";
+      payload: Record<string, never>;
+    };
+
+export interface PendingDeliveryInfo {
+  delivery_id: string;
+  worker_name: string;
+  event_id: string;
+  attempts: number;
+}
+
+export interface BrokerStatus {
+  agent_count: number;
+  agents: Array<{
+    name: string;
+    runtime: AgentRuntime;
+    channels: string[];
+    parent?: string;
+    pid?: number;
+  }>;
+  pending_delivery_count: number;
+  pending_deliveries: PendingDeliveryInfo[];
+}
+
+export interface ProtocolError {
+  code: string;
+  message: string;
+  retryable: boolean;
+  data?: unknown;
+}
+
+export type BrokerEvent =
+  | {
+      kind: "agent_spawned";
+      name: string;
+      runtime: AgentRuntime;
+      parent?: string;
+    }
+  | {
+      kind: "agent_released";
+      name: string;
+    }
+  | {
+      kind: "agent_exited";
+      name: string;
+      code?: number;
+      signal?: string;
+    }
+  | {
+      kind: "relay_inbound";
+      event_id: string;
+      from: string;
+      target: string;
+      body: string;
+      thread_id?: string;
+    }
+  | {
+      kind: "worker_stream";
+      name: string;
+      stream: string;
+      chunk: string;
+    }
+  | {
+      kind: "delivery_retry";
+      name: string;
+      delivery_id: string;
+      event_id: string;
+      attempts: number;
+    }
+  | {
+      kind: "delivery_dropped";
+      name: string;
+      count: number;
+      reason: string;
+    }
+  | {
+      kind: "delivery_queued";
+      name: string;
+      delivery_id: string;
+      event_id: string;
+      timestamp?: unknown;
+    }
+  | {
+      kind: "delivery_injected";
+      name: string;
+      delivery_id: string;
+      event_id: string;
+      timestamp?: unknown;
+    }
+  | {
+      kind: "delivery_verified";
+      name: string;
+      delivery_id: string;
+      event_id: string;
+    }
+  | {
+      kind: "delivery_failed";
+      name: string;
+      delivery_id: string;
+      event_id: string;
+      reason: string;
+    }
+  | {
+      kind: "delivery_active";
+      name: string;
+      delivery_id: string;
+      event_id: string;
+    }
+  | {
+      kind: "delivery_ack";
+      name: string;
+      delivery_id: string;
+      event_id: string;
+    }
+  | {
+      kind: "worker_ready";
+      name: string;
+      runtime: AgentRuntime;
+    }
+  | {
+      kind: "worker_error";
+      name: string;
+      code: string;
+      message: string;
+    }
+  | {
+      kind: "relaycast_published";
+      event_id: string;
+      to: string;
+      target_type: string;
+    }
+  | {
+      kind: "relaycast_publish_failed";
+      event_id: string;
+      to: string;
+      reason: string;
+    }
+  | {
+      kind: "acl_denied";
+      name: string;
+      sender: string;
+      owner_chain: string[];
+    };
+
+export type BrokerToSdk =
+  | {
+      type: "hello_ack";
+      payload: { broker_version: string; protocol_version: number };
+    }
+  | {
+      type: "ok";
+      payload: { result: unknown };
+    }
+  | {
+      type: "error";
+      payload: ProtocolError;
+    }
+  | {
+      type: "event";
+      payload: BrokerEvent;
+    };
+
+export type BrokerToWorker =
+  | {
+      type: "init_worker";
+      payload: { agent: AgentSpec };
+    }
+  | {
+      type: "deliver_relay";
+      payload: RelayDelivery;
+    }
+  | {
+      type: "shutdown_worker";
+      payload: { reason: string; grace_ms?: number };
+    }
+  | {
+      type: "ping";
+      payload: { ts_ms: number };
+    };
+
+export type WorkerToBroker =
+  | {
+      type: "worker_ready";
+      payload: { name: string; runtime: AgentRuntime };
+    }
+  | {
+      type: "delivery_ack";
+      payload: { delivery_id: string; event_id: string };
+    }
+  | {
+      type: "worker_stream";
+      payload: { stream: string; chunk: string };
+    }
+  | {
+      type: "worker_error";
+      payload: ProtocolError;
+    }
+  | {
+      type: "worker_exited";
+      payload: { code?: number; signal?: string };
+    }
+  | {
+      type: "pong";
+      payload: { ts_ms: number };
+    };

package/packages/sdk-ts/src/pty.ts

@@ -0,0 +1,16 @@
+/**
+ * PTY stream utilities — ANSI stripping and line extraction.
+ */
+
+// eslint-disable-next-line no-control-regex
+const ANSI_RE = /\x1b(?:\[[0-9;?]*[A-Za-z]|\][^\x07\x1b]*(?:\x07|\x1b\\)?|[()][0-9A-Za-z]|[\x20-\x2f]*[\x40-\x7e])|\x1b/g;
+
+/** Strip ANSI escape sequences from a string. */
+export function stripAnsi(s: string): string {
+  return s.replace(ANSI_RE, "");
+}
+
+/** Strip ANSI, split on newlines, trim, and drop empty lines. */
+export function cleanLines(raw: string): string[] {
+  return stripAnsi(raw).split(/\r?\n/).map(l => l.trimEnd()).filter(Boolean);
+}