connectonion 0.0.18 → 0.0.20

package/dist/connect/auth.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @llm-note
+ *   Dependencies: imports from [src/address] | imported by [src/connect/remote-agent.ts, src/connect/handlers.ts]
+ *   Data flow: ensureKeys resolves or generates Ed25519 keypair | signPayload signs messages for authenticated requests
+ *   State/Effects: ensureKeys may write to localStorage (browser) | no persistent module state
+ */
+import * as address from '../address';
+export declare function isBrowser(): boolean;
+export declare function sortedStringify(obj: Record<string, unknown>): string;
+export declare function ensureKeys(existing?: address.AddressData): address.AddressData;
+/**
+ * Sign a payload with Ed25519 keys.
+ * Returns the signed envelope { payload, from, signature, timestamp }
+ * or a fallback { prompt } if no keys provided.
+ */
+export declare function signPayload(keys: address.AddressData | undefined, payload: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/connect/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/connect/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAEtC,wBAAgB,SAAS,IAAI,OAAO,CAInC;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAOpE;AAED,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAQ9E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,CAAC,WAAW,GAAG,SAAS,EACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/dist/connect/auth.js

@@ -0,0 +1,90 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBrowser = isBrowser;
+exports.sortedStringify = sortedStringify;
+exports.ensureKeys = ensureKeys;
+exports.signPayload = signPayload;
+/**
+ * @llm-note
+ *   Dependencies: imports from [src/address] | imported by [src/connect/remote-agent.ts, src/connect/handlers.ts]
+ *   Data flow: ensureKeys resolves or generates Ed25519 keypair | signPayload signs messages for authenticated requests
+ *   State/Effects: ensureKeys may write to localStorage (browser) | no persistent module state
+ */
+const address = __importStar(require("../address"));
+function isBrowser() {
+    return typeof globalThis !== 'undefined' &&
+        typeof globalThis.window !== 'undefined' &&
+        typeof globalThis.localStorage !== 'undefined';
+}
+function sortedStringify(obj) {
+    const sortedKeys = Object.keys(obj).sort();
+    const sortedObj = {};
+    for (const key of sortedKeys) {
+        sortedObj[key] = obj[key];
+    }
+    return JSON.stringify(sortedObj);
+}
+function ensureKeys(existing) {
+    if (existing)
+        return existing;
+    const inBrowser = isBrowser();
+    const loaded = inBrowser ? address.loadBrowser() : address.load();
+    if (loaded)
+        return loaded;
+    const keys = inBrowser ? address.generateBrowser() : address.generate();
+    if (inBrowser)
+        address.saveBrowser(keys);
+    return keys;
+}
+/**
+ * Sign a payload with Ed25519 keys.
+ * Returns the signed envelope { payload, from, signature, timestamp }
+ * or a fallback { prompt } if no keys provided.
+ */
+function signPayload(keys, payload) {
+    if (!keys) {
+        return { prompt: payload.prompt };
+    }
+    const canonicalMessage = sortedStringify(payload);
+    const signer = isBrowser() ? address.signBrowser : address.sign;
+    const signature = signer(keys, canonicalMessage);
+    return {
+        payload,
+        from: keys.address,
+        signature,
+        timestamp: payload.timestamp,
+    };
+}

package/dist/connect/chat-item-mapper.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @llm-note
+ *   Dependencies: imports from [src/connect/types] | imported by [src/connect/handlers.ts]
+ *   Data flow: pure function — maps server event → ChatItem mutations on the chatItems array
+ *   State/Effects: mutates chatItems array in-place (push via addItem, update existing entries)
+ *   Integration: called by handlers.ts for stream event types (tool_call, llm_call, etc.)
+ */
+import { ChatItem, ChatItemType } from './types';
+export declare function mapEventToChatItem(chatItems: ChatItem[], event: Record<string, unknown>, addItem: (item: Partial<ChatItem> & {
+    type: ChatItemType;
+}) => void): void;
+//# sourceMappingURL=chat-item-mapper.d.ts.map

package/dist/connect/chat-item-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-item-mapper.d.ts","sourceRoot":"","sources":["../../src/connect/chat-item-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEjD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,QAAQ,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,KAAK,IAAI,GAClE,IAAI,CAqLN"}

package/dist/connect/chat-item-mapper.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapEventToChatItem = mapEventToChatItem;
+function mapEventToChatItem(chatItems, event, addItem) {
+    switch (event.type) {
+        case 'tool_call': {
+            const toolId = (event.tool_id || event.id);
+            addItem({
+                type: 'tool_call',
+                id: toolId,
+                name: event.name,
+                args: event.args,
+                status: 'running',
+            });
+            break;
+        }
+        case 'tool_result': {
+            const toolId = (event.tool_id || event.id);
+            const existing = chatItems.find((e) => e.type === 'tool_call' && e.id === toolId);
+            if (existing) {
+                existing.status = event.status === 'error' ? 'error' : 'done';
+                existing.result = event.result;
+                if (typeof event.timing_ms === 'number') {
+                    existing.timing_ms = event.timing_ms;
+                }
+            }
+            break;
+        }
+        case 'llm_call': {
+            addItem({
+                type: 'thinking',
+                id: event.id,
+                status: 'running',
+                model: event.model,
+            });
+            break;
+        }
+        case 'llm_result': {
+            const llmId = event.id;
+            const existingThinking = chatItems.find((e) => e.type === 'thinking' && e.id === llmId);
+            if (existingThinking) {
+                existingThinking.status = event.status === 'error' ? 'error' : 'done';
+                if (typeof event.duration_ms === 'number')
+                    existingThinking.duration_ms = event.duration_ms;
+                if (event.model)
+                    existingThinking.model = event.model;
+                if (event.usage) {
+                    existingThinking.usage = event.usage;
+                }
+                if (typeof event.context_percent === 'number')
+                    existingThinking.context_percent = event.context_percent;
+            }
+            break;
+        }
+        case 'thinking': {
+            addItem({
+                type: 'thinking',
+                id: event.id != null ? String(event.id) : undefined,
+                status: 'done',
+                content: event.content,
+                kind: event.kind,
+            });
+            break;
+        }
+        case 'assistant': {
+            if (event.content) {
+                addItem({
+                    type: 'agent',
+                    id: event.id != null ? String(event.id) : undefined,
+                    content: event.content,
+                });
+            }
+            break;
+        }
+        case 'agent_image': {
+            const imageData = event.image;
+            if (imageData) {
+                const lastAgent = chatItems.filter((e) => e.type === 'agent').pop();
+                if (lastAgent) {
+                    if (!lastAgent.images)
+                        lastAgent.images = [];
+                    lastAgent.images.push(imageData);
+                }
+                else {
+                    addItem({
+                        type: 'agent',
+                        id: event.id != null ? String(event.id) : undefined,
+                        content: '',
+                        images: [imageData],
+                    });
+                }
+            }
+            break;
+        }
+        case 'intent': {
+            const intentId = event.id;
+            const status = event.status;
+            if (status === 'analyzing') {
+                addItem({ type: 'intent', id: intentId, status: 'analyzing' });
+            }
+            else if (status === 'understood') {
+                const existing = chatItems.find((e) => e.type === 'intent' && e.id === intentId);
+                if (existing) {
+                    existing.status = 'understood';
+                    existing.ack = event.ack;
+                    existing.is_build = event.is_build;
+                }
+            }
+            break;
+        }
+        case 'eval': {
+            const evalId = event.id;
+            const evalStatus = event.status;
+            if (evalStatus === 'evaluating') {
+                addItem({
+                    type: 'eval',
+                    id: evalId,
+                    status: 'evaluating',
+                    expected: event.expected,
+                    eval_path: event.eval_path,
+                });
+            }
+            else if (evalStatus === 'done') {
+                const existing = chatItems.find((e) => e.type === 'eval' && e.id === evalId);
+                if (existing) {
+                    existing.status = 'done';
+                    existing.passed = event.passed;
+                    existing.summary = event.summary;
+                    existing.expected = event.expected;
+                    existing.eval_path = event.eval_path;
+                }
+            }
+            break;
+        }
+        case 'compact': {
+            const compactId = event.id;
+            const compactStatus = event.status;
+            if (compactStatus === 'compacting') {
+                addItem({
+                    type: 'compact',
+                    id: compactId,
+                    status: 'compacting',
+                    context_percent: event.context_percent,
+                });
+            }
+            else {
+                const existing = chatItems.find((e) => e.type === 'compact' && e.id === compactId);
+                if (existing) {
+                    existing.status = compactStatus;
+                    existing.context_before = event.context_before;
+                    existing.context_after = event.context_after;
+                    existing.message = event.message;
+                    existing.error = event.error;
+                }
+            }
+            break;
+        }
+        case 'tool_blocked': {
+            addItem({
+                type: 'tool_blocked',
+                tool: event.tool,
+                reason: event.reason,
+                message: event.message,
+                command: event.command,
+            });
+            break;
+        }
+    }
+}

package/dist/connect/endpoint.d.ts

@@ -1,10 +1,15 @@
+/**
+ * @llm-note
+ *   Dependencies: imports from [src/connect/types] | imported by [src/connect/remote-agent.ts, src/connect/handlers.ts, src/connect/index.ts]
+ *   Data flow: resolveEndpoint fetches agent endpoints from relay → verifies identity → returns {httpUrl, wsUrl}
+ *   State/Effects: HTTP fetch requests to relay/agent endpoints (timeout-bounded) | no persistent state
+ *   Integration: exposes resolveEndpoint(), fetchAgentInfo(), getWebSocketCtor(), generateUUID(), normalizeRelayUrl(), DEFAULT_RELAY
+ */
 import { AgentInfo, ResolvedEndpoint, WebSocketCtor } from './types';
 export declare const DEFAULT_RELAY = "wss://oo.openonion.ai";
-export declare function defaultWebSocketCtor(): WebSocketCtor;
+export declare function getWebSocketCtor(): WebSocketCtor;
 export declare function generateUUID(): string;
-export declare function isBrowserEnv(): boolean;
-export declare function canonicalJSON(obj: Record<string, unknown>): string;
-export declare function normalizeRelayBase(relayUrl: string): string;
+export declare function normalizeRelayUrl(relayUrl: string): string;
 export declare function resolveEndpoint(agentAddress: string, relayUrl: string, timeoutMs?: number): Promise<ResolvedEndpoint | null>;
 /**
  * Fetch agent info by resolving through relay then hitting /info endpoint.

package/dist/connect/endpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/connect/endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAErE,eAAO,MAAM,aAAa,0BAA0B,CAAC;AAErD,wBAAgB,oBAAoB,IAAI,aAAa,CAQpD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAUrC;AAED,wBAAgB,YAAY,IAAI,OAAO,CAItC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAOlE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAaD,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAO,GACf,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA6BlC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,QAAQ,SAAgB,GACvB,OAAO,CAAC,SAAS,CAAC,CA0BpB"}
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/connect/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAErE,eAAO,MAAM,aAAa,0BAA0B,CAAC;AAErD,wBAAgB,gBAAgB,IAAI,aAAa,CAQhD;AAED,wBAAgB,YAAY,IAAI,MAAM,CASrC;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAaD,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAO,GACf,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA6BlC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,QAAQ,SAAgB,GACvB,OAAO,CAAC,SAAS,CAAC,CA0BpB"}

package/dist/connect/endpoint.js

@@ -1,15 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_RELAY = void 0;
-exports.defaultWebSocketCtor = defaultWebSocketCtor;
+exports.getWebSocketCtor = getWebSocketCtor;
 exports.generateUUID = generateUUID;
-exports.isBrowserEnv = isBrowserEnv;
-exports.canonicalJSON = canonicalJSON;
-exports.normalizeRelayBase = normalizeRelayBase;
+exports.normalizeRelayUrl = normalizeRelayUrl;
 exports.resolveEndpoint = resolveEndpoint;
 exports.fetchAgentInfo = fetchAgentInfo;
 exports.DEFAULT_RELAY = 'wss://oo.openonion.ai';
-function defaultWebSocketCtor() {
+function getWebSocketCtor() {
     const g = globalThis;
     if (typeof g.WebSocket === 'function') {
         return g.WebSocket;
@@ -22,27 +20,13 @@ function generateUUID() {
     if (typeof crypto !== 'undefined' && crypto.randomUUID) {
         return crypto.randomUUID();
     }
-    // Fallback for older environments
     return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
         const r = (Math.random() * 16) | 0;
         const v = c === 'x' ? r : (r & 0x3) | 0x8;
         return v.toString(16);
     });
 }
-function isBrowserEnv() {
-    return typeof globalThis !== 'undefined' &&
-        typeof globalThis.window !== 'undefined' &&
-        typeof globalThis.localStorage !== 'undefined';
-}
-function canonicalJSON(obj) {
-    const sortedKeys = Object.keys(obj).sort();
-    const sortedObj = {};
-    for (const key of sortedKeys) {
-        sortedObj[key] = obj[key];
-    }
-    return JSON.stringify(sortedObj);
-}
-function normalizeRelayBase(relayUrl) {
+function normalizeRelayUrl(relayUrl) {
     let normalized = relayUrl.replace(/\/$/, '');
     if (normalized.endsWith('/ws/announce')) {
         normalized = normalized.slice(0, -('/ws/announce'.length));
@@ -52,7 +36,7 @@ function normalizeRelayBase(relayUrl) {
     }
     return normalized;
 }
-function sortEndpoints(endpoints) {
+function sortByProximity(endpoints) {
     return [...endpoints].sort((a, b) => {
         const getPriority = (url) => {
             if (url.includes('localhost') || url.includes('127.0.0.1'))
@@ -65,7 +49,7 @@ function sortEndpoints(endpoints) {
     });
 }
 async function resolveEndpoint(agentAddress, relayUrl, timeoutMs = 3000) {
-    const normalizedRelay = normalizeRelayBase(relayUrl);
+    const normalizedRelay = normalizeRelayUrl(relayUrl);
     const httpsRelay = normalizedRelay.replace(/^wss?:\/\//, 'https://');
     const response = await fetch(`${httpsRelay}/api/relay/agents/${agentAddress}`, {
         signal: AbortSignal.timeout(timeoutMs),
@@ -75,7 +59,7 @@ async function resolveEndpoint(agentAddress, relayUrl, timeoutMs = 3000) {
     const agentInfo = await response.json();
     if (!agentInfo.endpoints?.length)
         return null;
-    const httpEndpoints = sortEndpoints(agentInfo.endpoints).filter(ep => ep.startsWith('http'));
+    const httpEndpoints = sortByProximity(agentInfo.endpoints).filter(ep => ep.startsWith('http'));
     for (const httpUrl of httpEndpoints) {
         const infoResponse = await fetch(`${httpUrl}/info`, {
             signal: AbortSignal.timeout(timeoutMs),
@@ -109,14 +93,14 @@ async function resolveEndpoint(agentAddress, relayUrl, timeoutMs = 3000) {
  * ```
  */
 async function fetchAgentInfo(agentAddress, relayUrl = exports.DEFAULT_RELAY) {
-    const httpsRelay = normalizeRelayBase(relayUrl).replace(/^wss?:\/\//, 'https://');
+    const httpsRelay = normalizeRelayUrl(relayUrl).replace(/^wss?:\/\//, 'https://');
     const relayRes = await fetch(`${httpsRelay}/api/relay/agents/${agentAddress}`, {
         signal: AbortSignal.timeout(5000),
     });
     if (!relayRes.ok)
         return { address: agentAddress, online: false };
     const { endpoints = [] } = await relayRes.json();
-    const httpEndpoints = sortEndpoints(endpoints.filter(ep => ep.startsWith('http')));
+    const httpEndpoints = sortByProximity(endpoints.filter(ep => ep.startsWith('http')));
     for (const httpUrl of httpEndpoints) {
         const infoRes = await fetch(`${httpUrl}/info`, { signal: AbortSignal.timeout(3000) });
         if (!infoRes.ok)

package/dist/connect/index.d.ts

@@ -1,3 +1,10 @@
+/**
+ * @llm-note
+ *   Dependencies: imports from [src/connect/types, src/connect/remote-agent, src/connect/endpoint] | imported by [src/index.ts, src/react/]
+ *   Data flow: connect(agentAddress, options?) → new RemoteAgent(agentAddress, options)
+ *   State/Effects: pure factory, no state
+ *   Integration: barrel for connect subsystem — re-exports types, RemoteAgent, fetchAgentInfo
+ */
 import { ConnectOptions } from './types';
 import { RemoteAgent } from './remote-agent';
 export * from './types';

package/dist/connect/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,OAAO,CACrB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,cAAmB,GAC3B,WAAW,CAEb"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connect/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,OAAO,CACrB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,cAAmB,GAC3B,WAAW,CAEb"}

package/dist/connect/remote-agent.d.ts

@@ -1,94 +1,79 @@
-import { AgentStatus, ApprovalMode, ChatItem, ConnectionState, ConnectOptions, Response, SessionState } from './types';
 /**
- * Proxy to a remote agent with streaming support.
- *
- * @example
- * ```typescript
- * const agent = connect("0x123abc");
- *
- * // Simple usage
- * const response = await agent.input("Search for Python docs");
- * console.log(response.text);  // Agent's response
- * console.log(response.done);  // true if complete
- *
- * // Access UI events for rendering
- * console.log(agent.ui);      // Array of UI events
- * console.log(agent.status);  // 'idle' | 'working' | 'waiting'
- * ```
+ * @llm-note
+ *   Dependencies: imports from [src/connect/types, src/connect/endpoint, src/connect/auth, src/connect/handlers, src/address]
+ *   Data flow: input() → _connectAndSend() → creates WS + Promise → attachWsHandlers() dispatches events → resolve on OUTPUT
+ *   State/Effects: owns WebSocket lifecycle + mutable _chatItems + _currentSession
+ *   Integration: public API consumed by connect() factory and React useAgentForHuman hook
  */
+import * as address from '../address';
+import { AgentStatus, ApprovalMode, ChatItem, ChatItemType, ConnectionState, ConnectOptions, ResolvedEndpoint, Response, SessionState, WebSocketCtor, WebSocketLike } from './types';
 export declare class RemoteAgent {
-    /** Agent's public address */
     readonly address: string;
-    /** Alias for address (backwards compatibility) */
-    get agentAddress(): string;
-    private _keys?;
-    private _relayUrl;
-    private _directUrl?;
-    private _resolvedEndpoint?;
-    private _endpointResolutionAttempted;
-    private _WS;
-    private _status;
-    private _connectionState;
-    private _currentSession;
-    private _chatItems;
-    private _activeWs;
-    private _pendingPrompt;
-    private _pendingInputId;
-    private _pendingSessionId;
-    private _lastPingTime;
-    private _healthCheckInterval;
-    private _reconnectAttempts;
-    private _maxReconnectAttempts;
-    private _reconnectBaseDelay;
-    private _shouldReconnect;
+    _keys?: address.AddressData;
+    _relayUrl: string;
+    _directUrl?: string;
+    _resolvedEndpoint?: ResolvedEndpoint;
+    _endpointResolutionAttempted: boolean;
+    _WS: WebSocketCtor;
+    _status: AgentStatus;
+    _connectionState: ConnectionState;
+    _currentSession: SessionState | null;
+    _chatItems: ChatItem[];
+    _activeWs: WebSocketLike | null;
+    _pendingPrompt: string | null;
+    _pendingInputId: string | null;
+    _pendingSessionId: string | null;
+    _lastPingTime: number;
+    _healthCheckInterval: ReturnType<typeof setInterval> | null;
+    _reconnectAttempts: number;
+    _maxReconnectAttempts: number;
+    _reconnectBaseDelay: number;
+    _shouldReconnect: boolean;
     constructor(agentAddress: string, options?: ConnectOptions);
+    get agentAddress(): string;
     get status(): AgentStatus;
     get connectionState(): ConnectionState;
     get currentSession(): SessionState | null;
     get ui(): ChatItem[];
     get mode(): ApprovalMode;
-    setMode(mode: ApprovalMode, options?: {
-        turns?: number;
-    }): void;
-    setPrompt(prompt: string): void;
-    reset(): void;
-    resetConversation(): void;
+    get error(): Error | null;
+    _error: Error | null;
+    _onMessage: (() => void) | null;
+    set onMessage(fn: (() => void) | null);
     input(prompt: string, options?: {
         images?: string[];
         timeoutMs?: number;
     }): Promise<Response>;
+    /** Reconnect to an existing session to receive pending output without adding duplicate UI items */
+    reconnect(sessionId?: string): Promise<Response>;
     inputAsync(prompt: string, options?: {
         images?: string[];
         timeoutMs?: number;
     }): Promise<Response>;
-    respond(answer: string | string[]): void;
-    respondToApproval(approved: boolean, scope?: 'once' | 'session', mode?: 'reject_soft' | 'reject_hard' | 'reject_explain', feedback?: string): void;
-    submitOnboard(options: {
+    setMode(mode: ApprovalMode, options?: {
+        turns?: number;
+    }): void;
+    reset(): void;
+    resetConversation(): void;
+    send(message: Record<string, unknown>): void;
+    signOnboard(options: {
         inviteCode?: string;
         payment?: number;
+    }): Record<string, unknown>;
+    checkSession(sessionId?: string): Promise<'running' | 'done' | 'not_found'>;
+    checkSessionStatus(sessionId: string): Promise<'running' | 'suspended' | 'completed' | 'not_found'>;
+    _addChatItem(event: Partial<ChatItem> & {
+        type: ChatItemType;
     }): void;
-    respondToPlanReview(message: string): void;
-    respondToUlwTurnsReached(action: 'continue' | 'switch_mode', options?: {
-        turns?: number;
-        mode?: ApprovalMode;
-    }): void;
-    private _ensureKeys;
-    private _deriveWsUrl;
-    private _startHealthCheck;
-    private _stopHealthCheck;
-    private _attemptReconnect;
+    _clearPlaceholder(): void;
+    _stopPingMonitor(): void;
+    _attemptReconnect(resolve: (value: Response) => void, reject: (reason?: any) => void): void;
+    _sendInput(ws: WebSocketLike, inputId: string, prompt: string, sessionId: string, isDirect: boolean, images?: string[]): void;
+    private _startPingMonitor;
+    private _resolveWsUrl;
+    private _resolveEndpointOnce;
+    private _connectAndSend;
     private _reconnect;
-    private _tryResolveEndpoint;
-    private _streamInput;
-    /**
-     * Attach onmessage/onerror/onclose to a WebSocket.
-     * Shared by _streamInput (initial connection) and _reconnect.
-     */
-    private _attachMessageHandlers;
-    private _removeOptimisticThinking;
-    private _handleStreamEvent;
-    private _addChatItem;
-    private _signPayload;
     toString(): string;
 }
 //# sourceMappingURL=remote-agent.d.ts.map

package/dist/connect/remote-agent.d.ts.map

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