@agentconnect/sdk 0.1.7 → 0.2.1

package/README.md

@@ -91,6 +91,23 @@ await session.close();
 client.close();
 ```
 
+## Embedded host (Node backend)
+
+```ts
+import { AgentConnect } from '@agentconnect/sdk';
+import { createHostBridge } from '@agentconnect/host';
+
+globalThis.__AGENTCONNECT_BRIDGE__ = createHostBridge({
+  mode: 'embedded',
+  basePath: process.cwd(),
+});
+
+const client = await AgentConnect.connect({ preferInjected: true });
+```
+
+If your SDK runs in the browser, expose a WebSocket host from your backend using
+`startDevHost` and connect with `AgentConnect.connect({ host: 'ws://...' })`.
+
 ## Provider and model helpers
 
 ```ts

package/dist/index.d.ts

@@ -46,6 +46,7 @@ export type SessionEvent = {
 } | {
     type: 'final';
     text: string;
+    cancelled?: boolean;
     providerSessionId?: string | null;
     providerDetail?: ProviderDetail;
 } | {
@@ -62,6 +63,7 @@ export type SessionEvent = {
 } | {
     type: 'error';
     message: string;
+    cancelled?: boolean;
     providerSessionId?: string | null;
     providerDetail?: ProviderDetail;
 } | {
@@ -116,7 +118,8 @@ export type AgentConnectConnectOptions = {
     webSocket?: WebSocketConstructor;
 };
 export type SessionCreateOptions = {
-    model: string;
+    model?: string;
+    provider?: ProviderId;
     reasoningEffort?: string;
     system?: string;
     metadata?: Record<string, unknown>;
@@ -163,7 +166,10 @@ export interface AgentConnectClient {
     close(): void;
     providers: {
         list(): Promise<ProviderInfo[]>;
-        status(provider: ProviderId): Promise<ProviderInfo>;
+        status(provider: ProviderId, options?: {
+            fast?: boolean;
+            force?: boolean;
+        }): Promise<ProviderInfo>;
         ensureInstalled(provider: ProviderId): Promise<InstallResult>;
         update(provider: ProviderId): Promise<ProviderInfo>;
         login(provider: ProviderId, options?: ProviderLoginOptions): Promise<{

package/dist/index.js

@@ -268,6 +268,7 @@ class AgentConnectClientImpl {
             return {
                 type: 'final',
                 text: String(data?.text ?? ''),
+                cancelled: typeof data?.cancelled === 'boolean' ? data.cancelled : undefined,
                 providerSessionId,
                 ...(providerDetail && { providerDetail }),
             };
@@ -295,6 +296,7 @@ class AgentConnectClientImpl {
             return {
                 type: 'error',
                 message: String(data?.message ?? 'Unknown error'),
+                cancelled: typeof data?.cancelled === 'boolean' ? data.cancelled : undefined,
                 providerSessionId,
                 ...(providerDetail && { providerDetail }),
             };
@@ -386,8 +388,8 @@ class AgentConnectClientImpl {
             const res = (await this.request('acp.providers.list'));
             return res.providers ?? [];
         },
-        status: async (provider) => {
-            const res = (await this.request('acp.providers.status', { provider }));
+        status: async (provider, options) => {
+            const res = (await this.request('acp.providers.status', { provider, options }));
             return res.provider;
         },
         update: async (provider) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentconnect/sdk",
-  "version": "0.1.7",
+  "version": "0.2.1",
   "license": "MIT",
   "type": "module",
   "homepage": "https://github.com/rayzhudev/agent-connect",
@@ -19,11 +19,6 @@
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
-    },
-    "./host": {
-      "import": "./dist/host.js",
-      "types": "./dist/host.d.ts",
-      "default": "./dist/host.js"
     }
   },
   "files": [

package/dist/host.d.ts

@@ -1,10 +0,0 @@
-export type EnsureHostOptions = {
-    host?: string;
-    port?: number;
-    appPath?: string;
-    cliPackage?: string;
-    runtime?: string;
-    timeoutMs?: number;
-    debug?: boolean;
-};
-export declare function ensureAgentConnectHost(options?: EnsureHostOptions): Promise<void>;

package/dist/host.js

@@ -1,184 +0,0 @@
-import fs from 'fs';
-import net from 'net';
-import path from 'path';
-import { spawn } from 'child_process';
-const HOST_KEY = '__agentconnectHostState__';
-function getState() {
-    const globalAny = globalThis;
-    if (!globalAny[HOST_KEY]) {
-        globalAny[HOST_KEY] = { status: 'idle' };
-    }
-    return globalAny[HOST_KEY];
-}
-function findExecutable(name) {
-    const envPath = process.env.PATH || '';
-    const extensions = process.platform === 'win32' ? ['.exe', '.cmd', '.bat', ''] : [''];
-    for (const entry of envPath.split(path.delimiter)) {
-        if (!entry)
-            continue;
-        for (const ext of extensions) {
-            const candidate = path.join(entry, `${name}${ext}`);
-            try {
-                fs.accessSync(candidate, fs.constants.X_OK);
-                return candidate;
-            }
-            catch {
-                continue;
-            }
-        }
-    }
-    return null;
-}
-function findPackageRoot(startDir, pkgName) {
-    let current = startDir;
-    while (true) {
-        const candidate = path.join(current, 'node_modules', pkgName, 'package.json');
-        if (fs.existsSync(candidate))
-            return path.dirname(candidate);
-        const parent = path.dirname(current);
-        if (parent === current)
-            break;
-        current = parent;
-    }
-    return null;
-}
-function resolveCliEntry(appPath, cliPackage) {
-    const pkgRoot = findPackageRoot(appPath, cliPackage);
-    if (!pkgRoot) {
-        throw new Error(`AgentConnect CLI not found. Install ${cliPackage} and retry.`);
-    }
-    const pkgJsonPath = path.join(pkgRoot, 'package.json');
-    const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
-    let entry = pkg.main || 'dist/index.js';
-    if (typeof pkg.bin === 'string') {
-        entry = pkg.bin;
-    }
-    else if (pkg.bin && typeof pkg.bin === 'object') {
-        entry = pkg.bin.agentconnect || entry;
-    }
-    const resolved = path.join(pkgRoot, entry);
-    if (!fs.existsSync(resolved)) {
-        throw new Error(`AgentConnect CLI entry not found at ${resolved}`);
-    }
-    return resolved;
-}
-function resolveRuntime(runtime) {
-    if (runtime)
-        return runtime;
-    const override = process.env.AGENTCONNECT_NODE;
-    if (override)
-        return override;
-    if (!process.execPath.toLowerCase().includes('bun'))
-        return process.execPath;
-    return findExecutable('node') || 'node';
-}
-function isPortOpen(host, port, timeoutMs = 300) {
-    return new Promise((resolve) => {
-        const socket = new net.Socket();
-        const finalize = (result) => {
-            socket.destroy();
-            resolve(result);
-        };
-        socket.setTimeout(timeoutMs);
-        socket.once('error', () => finalize(false));
-        socket.once('timeout', () => finalize(false));
-        socket.connect(port, host, () => finalize(true));
-    });
-}
-async function waitForPort(host, port, child, timeoutMs) {
-    const start = Date.now();
-    while (Date.now() - start < timeoutMs) {
-        if (await isPortOpen(host, port))
-            return true;
-        if (child?.exitCode !== null)
-            return false;
-        await new Promise((resolve) => setTimeout(resolve, 250));
-    }
-    return isPortOpen(host, port);
-}
-function registerCleanup(state) {
-    if (state.cleanupRegistered)
-        return;
-    state.cleanupRegistered = true;
-    process.on('exit', () => {
-        state.child?.kill('SIGTERM');
-    });
-    process.on('SIGINT', () => {
-        state.child?.kill('SIGTERM');
-        process.exit(0);
-    });
-}
-async function startHost(options, state) {
-    const cliPath = resolveCliEntry(options.appPath, options.cliPackage);
-    const args = [
-        cliPath,
-        'dev',
-        '--host',
-        options.host,
-        '--port',
-        String(options.port),
-        '--app',
-        options.appPath,
-    ];
-    const runtime = resolveRuntime(options.runtime);
-    if (options.debug) {
-        console.info('[AgentConnect][Host] starting', { runtime, args });
-    }
-    const child = spawn(runtime, args, { stdio: options.debug ? 'pipe' : 'ignore' });
-    state.child = child;
-    state.status = 'starting';
-    registerCleanup(state);
-    if (options.debug) {
-        child.stdout?.on('data', (chunk) => {
-            console.info('[AgentConnect][Host]', String(chunk).trim());
-        });
-        child.stderr?.on('data', (chunk) => {
-            console.error('[AgentConnect][Host]', String(chunk).trim());
-        });
-    }
-    child.on('error', (error) => {
-        if (options.debug) {
-            console.error('[AgentConnect][Host] spawn error', error);
-        }
-    });
-    child.on('exit', () => {
-        if (state.child === child) {
-            state.status = 'idle';
-            state.child = undefined;
-        }
-    });
-    const started = await waitForPort(options.host, options.port, child, options.timeoutMs);
-    if (!started) {
-        child.kill('SIGTERM');
-        throw new Error('AgentConnect host failed to start. Ensure Node.js 20+ is installed.');
-    }
-    state.status = 'running';
-}
-export async function ensureAgentConnectHost(options = {}) {
-    const state = getState();
-    const resolvedOptions = {
-        host: options.host || process.env.AGENTCONNECT_HOST || '127.0.0.1',
-        port: options.port || Number(process.env.AGENTCONNECT_PORT || 9630),
-        appPath: options.appPath || process.env.AGENTCONNECT_APP_PATH || process.cwd(),
-        cliPackage: options.cliPackage || process.env.AGENTCONNECT_CLI_PACKAGE || '@agentconnect/cli',
-        runtime: options.runtime || '',
-        timeoutMs: options.timeoutMs || 8000,
-        debug: options.debug ?? process.env.AGENTCONNECT_DEBUG === '1',
-    };
-    if (await isPortOpen(resolvedOptions.host, resolvedOptions.port)) {
-        state.status = 'running';
-        return;
-    }
-    if (state.startPromise)
-        return state.startPromise;
-    state.startPromise = startHost(resolvedOptions, state)
-        .catch((error) => {
-        state.status = 'idle';
-        state.child = undefined;
-        throw error;
-    })
-        .finally(() => {
-        state.startPromise = undefined;
-    });
-    return state.startPromise;
-}