@roll-agent/relay-client 0.0.0 → 0.1.1

package/dist/schemas.js

@@ -0,0 +1 @@
+import{relayInteractionRequestSchemaV11 as t,relayRequestMethodSchemasV11 as e}from"@roll-agent/relay-protocol";import{relayClientErrorCodeSchema as r}from"@roll-agent/relay-protocol/control";import{z as n}from"zod/v4";const a=e["thread.open"].params.def.innerType.shape.threadId,o=e["turn.cancel"].params.def.innerType.shape.turnId,s=e["thread.snapshot"].result;export const RELAY_CONNECTION_STATUSES={idle:"idle",connecting:"connecting",connected:"connected",reconnecting:"reconnecting",closed:"closed"};export const relayConnectionStateSchema=n.discriminatedUnion("status",[n.object({status:n.literal(RELAY_CONNECTION_STATUSES.idle)}).strict().readonly(),n.object({status:n.literal(RELAY_CONNECTION_STATUSES.connecting),attempt:n.number().int().positive()}).strict().readonly(),n.object({status:n.literal(RELAY_CONNECTION_STATUSES.connected),workspaceStatus:n.enum(["online","offline"])}).strict().readonly(),n.object({status:n.literal(RELAY_CONNECTION_STATUSES.reconnecting),attempt:n.number().int().positive(),retryAt:n.string().datetime({offset:!0})}).strict().readonly(),n.object({status:n.literal(RELAY_CONNECTION_STATUSES.closed),reason:n.enum(["client","session","transport","protocol"])}).strict().readonly()]);export const RELAY_CLIENT_TRANSPORT_ERROR_CODES={aborted:"ABORTED",closed:"CLIENT_CLOSED",connectionUnavailable:"CONNECTION_UNAVAILABLE",invalidSession:"INVALID_SESSION",outcomeUnknown:"OUTCOME_UNKNOWN",protocolError:"PROTOCOL_ERROR",requestTimeout:"REQUEST_TIMEOUT",transportError:"TRANSPORT_ERROR",workspaceOffline:"WORKSPACE_OFFLINE"};export const relayClientTransportErrorCodeSchema=n.enum(RELAY_CLIENT_TRANSPORT_ERROR_CODES);const i={message:n.string(),retryable:n.boolean()};export const relayClientErrorDetailsSchema=n.discriminatedUnion("kind",[n.object({kind:n.literal("transport"),...i,code:relayClientTransportErrorCodeSchema}).strict().readonly(),n.object({kind:n.literal("session"),...i,code:r}).strict().readonly(),n.object({kind:n.literal("remote"),...i,code:n.string().min(1)}).strict().readonly()]);export const relayLiveAssistantMessageSchema=n.discriminatedUnion("status",[n.object({status:n.literal("streaming"),streamId:n.string().uuid(),text:n.string()}).strict().readonly(),n.object({status:n.literal("completed"),streamId:n.string().uuid(),text:n.string()}).strict().readonly()]);const l={interactionId:t.options[0].def.innerType.shape.interactionId,threadId:a,turnId:o,method:t.options[0].def.innerType.shape.method.or(t.options[1].def.innerType.shape.method)};export const relayInteractionStateSchema=n.discriminatedUnion("status",[n.object({status:n.literal("pending"),request:t}).strict().readonly(),n.object({status:n.literal("responding"),request:t}).strict().readonly(),n.object({status:n.literal("resolved"),...l}).strict().readonly(),n.object({status:n.literal("cancelled"),...l}).strict().readonly()]);export const relayTurnStateSchema=n.discriminatedUnion("status",[n.object({status:n.literal("idle")}).strict().readonly(),n.object({status:n.literal("running"),turnId:o}).strict().readonly(),n.object({status:n.literal("cancelling"),turnId:o}).strict().readonly(),n.object({status:n.literal("completed"),turnId:o}).strict().readonly(),n.object({status:n.literal("cancelled"),turnId:o}).strict().readonly(),n.object({status:n.literal("failed"),turnId:o,stage:n.enum(["bootstrap","plan","execute"])}).strict().readonly()]);const c={threadId:a,liveAssistantMessages:n.array(relayLiveAssistantMessageSchema).readonly(),interactions:n.array(relayInteractionStateSchema).readonly(),turn:relayTurnStateSchema};export const relayThreadViewSchema=n.discriminatedUnion("status",[n.object({status:n.literal("loading"),...c,snapshot:n.null()}).strict().readonly(),n.object({status:n.literal("ready"),...c,snapshot:s}).strict().readonly(),n.object({status:n.literal("error"),...c,snapshot:s.nullable(),error:relayClientErrorDetailsSchema}).strict().readonly()]);export function getPendingInteractionRequest(t){return"pending"===t.status||"responding"===t.status?t.request:void 0}

package/dist/testing.d.ts

@@ -0,0 +1,10 @@
+import { type CreateRelayClientOptions, type RelayClient } from "./client.ts";
+import { type RelayScheduler, type RelaySocketCloseEvent, type RelaySocketHandlers, type RelayTimerHandle, type RelayWebSocketFactory, type RelayWebSocketLike } from "./transport.ts";
+export interface RelayClientTestingOptions {
+    readonly createWebSocket: RelayWebSocketFactory;
+    readonly createUuid?: () => string;
+    readonly scheduler?: RelayScheduler;
+    readonly reconnectDelayMs?: (attempt: number) => number;
+}
+export declare function createRelayClientForTesting(options: CreateRelayClientOptions, testing: RelayClientTestingOptions): RelayClient;
+export type { RelayScheduler, RelaySocketCloseEvent, RelaySocketHandlers, RelayTimerHandle, RelayWebSocketFactory, RelayWebSocketLike, };

package/dist/testing.js

@@ -0,0 +1 @@
+import{createRelayClientWithRuntime as e}from"./client.js";import{browserRelayRuntimeDependencies as r}from"./transport.js";export function createRelayClientForTesting(t,c){const n={createWebSocket:c.createWebSocket,createUuid:c.createUuid??r.createUuid,scheduler:c.scheduler??r.scheduler,reconnectDelayMs:c.reconnectDelayMs??r.reconnectDelayMs};return e(t,n)}

package/dist/transport.d.ts

@@ -0,0 +1,31 @@
+export interface RelaySocketCloseEvent {
+    readonly code: number;
+    readonly reason: string;
+    readonly wasClean: boolean;
+}
+export interface RelaySocketHandlers {
+    readonly onOpen: () => void;
+    readonly onMessage: (data: unknown) => void;
+    readonly onClose: (event: RelaySocketCloseEvent) => void;
+    readonly onError: () => void;
+}
+export interface RelayWebSocketLike {
+    readonly readyState: number;
+    setHandlers(handlers: RelaySocketHandlers): void;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+}
+export type RelayWebSocketFactory = (url: string) => RelayWebSocketLike;
+export type RelayTimerHandle = ReturnType<typeof globalThis.setTimeout>;
+export interface RelayScheduler {
+    now(): number;
+    setTimer(callback: () => void, delayMs: number): RelayTimerHandle;
+    clearTimer(handle: RelayTimerHandle): void;
+}
+export interface RelayClientRuntimeDependencies {
+    readonly createWebSocket: RelayWebSocketFactory;
+    readonly createUuid: () => string;
+    readonly scheduler: RelayScheduler;
+    readonly reconnectDelayMs: (attempt: number) => number;
+}
+export declare const browserRelayRuntimeDependencies: RelayClientRuntimeDependencies;

package/dist/transport.js

@@ -0,0 +1 @@
+class BrowserRelayWebSocket{#e;constructor(e){this.#e=new WebSocket(e)}get readyState(){return this.#e.readyState}setHandlers(e){this.#e.onopen=()=>{e.onOpen()},this.#e.onmessage=o=>{e.onMessage(o.data)},this.#e.onclose=o=>{e.onClose({code:o.code,reason:o.reason,wasClean:o.wasClean})},this.#e.onerror=()=>{e.onError()}}send(e){this.#e.send(e)}close(e,o){this.#e.close(e,o)}}export const browserRelayRuntimeDependencies={createWebSocket:e=>new BrowserRelayWebSocket(e),createUuid:()=>globalThis.crypto.randomUUID(),scheduler:{now:()=>Date.now(),setTimer:(e,o)=>globalThis.setTimeout(e,o),clearTimer:e=>{globalThis.clearTimeout(e)}},reconnectDelayMs:e=>Math.min(3e4,250*2**Math.min(e-1,7))};

package/package.json

@@ -1,12 +1,47 @@
 {
   "name": "@roll-agent/relay-client",
-  "version": "0.0.0",
-  "description": "Bootstrap placeholder that creates this package on npm so Trusted Publishing can be configured. Contains no code; real releases start at 0.1.0.",
+  "version": "0.1.1",
+  "type": "module",
+  "sideEffects": false,
   "repository": {
     "type": "git",
     "url": "https://github.com/steveoon/roll-agent"
   },
+  "homepage": "https://github.com/steveoon/roll-agent",
+  "bugs": {
+    "url": "https://github.com/steveoon/roll-agent/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    }
+  },
   "publishConfig": {
     "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.6.0"
+  },
+  "dependencies": {
+    "zod": "3.25.76",
+    "@roll-agent/relay-protocol": "0.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "0.28.1"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && node ../../scripts/obfuscate.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "node --experimental-strip-types --test \"src/**/*.test.ts\"",
+    "clean": "rm -rf dist"
   }
-}
+}