agent-relay 3.1.0 → 3.1.1

package/packages/openclaw/dist/spawn/manager.js

@@ -0,0 +1,140 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync } from 'node:fs';
+import { DockerSpawnProvider } from './docker.js';
+import { ProcessSpawnProvider } from './process.js';
+/** Default maximum number of concurrent spawns per manager. */
+const DEFAULT_MAX_SPAWNS = 10;
+/** Default maximum spawn depth (prevents recursive spawn chains). */
+const DEFAULT_MAX_SPAWN_DEPTH = 3;
+/**
+ * Detect whether Docker is available by checking if the socket exists.
+ * Used to auto-select spawn mode when not explicitly configured.
+ */
+function isDockerAvailable() {
+    const socketPath = process.env.DOCKER_SOCKET ?? '/var/run/docker.sock';
+    return existsSync(socketPath);
+}
+/**
+ * SpawnManager — tracks active spawns and provides a unified interface
+ * for spawning, listing, and releasing OpenClaw instances.
+ *
+ * Security controls:
+ *   - maxSpawns: Maximum concurrent spawns (default: 10)
+ *   - maxDepth: Maximum spawn depth to prevent recursive chains (default: 3)
+ *   - Persistent state in spawns.json for recovery on restart
+ */
+export class SpawnManager {
+    provider;
+    handles = new Map();
+    maxSpawns;
+    maxDepth;
+    stateFile;
+    currentDepth;
+    constructor(options) {
+        // Mode resolution: explicit > env > auto-detect (docker if available, else process)
+        const explicitMode = options?.mode ?? process.env.OPENCLAW_SPAWN_MODE;
+        const resolvedMode = explicitMode ?? (isDockerAvailable() ? 'docker' : 'process');
+        this.provider = resolvedMode === 'docker'
+            ? new DockerSpawnProvider()
+            : new ProcessSpawnProvider();
+        this.maxSpawns = options?.maxSpawns
+            ?? Number(process.env.OPENCLAW_MAX_SPAWNS || DEFAULT_MAX_SPAWNS);
+        this.maxDepth = options?.maxDepth
+            ?? Number(process.env.OPENCLAW_MAX_SPAWN_DEPTH || DEFAULT_MAX_SPAWN_DEPTH);
+        this.currentDepth = options?.spawnDepth
+            ?? Number(process.env.OPENCLAW_SPAWN_DEPTH || 0);
+        this.stateFile = join(homedir(), '.openclaw', 'workspace', 'relaycast', 'spawns.json');
+    }
+    async spawn(options) {
+        // Enforce spawn depth limit — prevents recursive spawn chains
+        if (this.currentDepth >= this.maxDepth) {
+            throw new Error(`Spawn depth limit reached (${this.maxDepth}). ` +
+                'Cannot spawn from a spawn chain this deep. Set OPENCLAW_MAX_SPAWN_DEPTH to increase.');
+        }
+        // Enforce concurrent spawn limit
+        if (this.handles.size >= this.maxSpawns) {
+            throw new Error(`Maximum concurrent spawns reached (${this.maxSpawns}). ` +
+                'Release an existing OpenClaw before spawning a new one. Set OPENCLAW_MAX_SPAWNS to increase.');
+        }
+        // Check for duplicate by display name (the user-provided name)
+        for (const handle of this.handles.values()) {
+            if (handle.displayName === options.name) {
+                throw new Error(`OpenClaw "${options.name}" is already running (id: ${handle.id})`);
+            }
+        }
+        const handle = await this.provider.spawn(options);
+        this.handles.set(handle.id, handle);
+        await this.persistState();
+        return handle;
+    }
+    async release(id) {
+        const handle = this.handles.get(id);
+        if (!handle)
+            return false;
+        await handle.destroy();
+        this.handles.delete(id);
+        await this.persistState();
+        return true;
+    }
+    async releaseByName(name) {
+        for (const [id, handle] of this.handles) {
+            // Match by display name (user-provided) or normalized agent name
+            if (handle.displayName === name || handle.agentName === name) {
+                await handle.destroy();
+                this.handles.delete(id);
+                await this.persistState();
+                return true;
+            }
+        }
+        return false;
+    }
+    async releaseAll() {
+        const ids = Array.from(this.handles.keys());
+        await Promise.allSettled(ids.map((id) => this.release(id)));
+    }
+    list() {
+        return Array.from(this.handles.values());
+    }
+    get(id) {
+        return this.handles.get(id);
+    }
+    get size() {
+        return this.handles.size;
+    }
+    /** Persist spawn state to disk for recovery. */
+    async persistState() {
+        try {
+            const dir = join(homedir(), '.openclaw', 'workspace', 'relaycast');
+            await mkdir(dir, { recursive: true });
+            const state = {
+                spawns: Array.from(this.handles.values()).map((h) => ({
+                    id: h.id,
+                    displayName: h.displayName,
+                    agentName: h.agentName,
+                    gatewayPort: h.gatewayPort,
+                    spawnedAt: new Date().toISOString(),
+                })),
+            };
+            await writeFile(this.stateFile, JSON.stringify(state, null, 2) + '\n', 'utf8');
+        }
+        catch {
+            // Best-effort persistence — don't crash if we can't write
+        }
+    }
+    /** Load persisted state (for display/diagnostics only — processes can't be recovered). */
+    async loadPersistedState() {
+        try {
+            if (!existsSync(this.stateFile))
+                return [];
+            const raw = await readFile(this.stateFile, 'utf8');
+            const state = JSON.parse(raw);
+            return state.spawns ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/packages/openclaw/dist/spawn/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/spawn/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIpD,+DAA+D;AAC/D,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,qEAAqE;AACrE,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAclC;;;GAGG;AACH,SAAS,iBAAiB;IACxB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,sBAAsB,CAAC;IACvE,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACN,QAAQ,CAAgB;IACxB,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IACzC,SAAS,CAAS;IAClB,QAAQ,CAAS;IACjB,SAAS,CAAS;IAC3B,YAAY,CAAS;IAE7B,YAAY,OAKX;QACC,oFAAoF;QACpF,MAAM,YAAY,GAAG,OAAO,EAAE,IAAI,IAAK,OAAO,CAAC,GAAG,CAAC,mBAA6C,CAAC;QACjG,MAAM,YAAY,GAAG,YAAY,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAElF,IAAI,CAAC,QAAQ,GAAG,YAAY,KAAK,QAAQ;YACvC,CAAC,CAAC,IAAI,mBAAmB,EAAE;YAC3B,CAAC,CAAC,IAAI,oBAAoB,EAAE,CAAC;QAE/B,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS;eAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,kBAAkB,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ;eAC5B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,uBAAuB,CAAC,CAAC;QAC7E,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,UAAU;eAClC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC/B,8DAA8D;QAC9D,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,CAAC,QAAQ,KAAK;gBAChD,sFAAsF,CACvF,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,sCAAsC,IAAI,CAAC,SAAS,KAAK;gBACzD,8FAA8F,CAC/F,CAAC;QACJ,CAAC;QAED,+DAA+D;QAC/D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,WAAW,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,CAAC,IAAI,6BAA6B,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACpC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAY;QAC9B,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,iEAAiE;YACjE,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;gBAC7D,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,gDAAgD;IACxC,KAAK,CAAC,YAAY;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;YACnE,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEtC,MAAM,KAAK,GAAgB;gBACzB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACpD,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC,CAAC;aACJ,CAAC;YAEF,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;IACH,CAAC;IAED,0FAA0F;IAC1F,KAAK,CAAC,kBAAkB;QACtB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,KAAK,GAAgB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3C,OAAO,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/packages/openclaw/dist/spawn/process.d.ts

@@ -0,0 +1,16 @@
+import type { SpawnProvider, SpawnOptions, SpawnHandle } from './types.js';
+/**
+ * Spawn OpenClaw instances as local child processes.
+ * No Docker required — simplest local mode.
+ *
+ * Each spawn:
+ *   1. Starts `openclaw gateway` on an OS-assigned free port
+ *   2. Uses AgentRelay SDK to spawn a broker + bridge agent connected to the gateway
+ */
+export declare class ProcessSpawnProvider implements SpawnProvider {
+    private readonly handles;
+    spawn(options: SpawnOptions): Promise<SpawnHandle>;
+    destroy(id: string): Promise<void>;
+    list(): Promise<SpawnHandle[]>;
+}
+//# sourceMappingURL=process.d.ts.map

package/packages/openclaw/dist/spawn/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/spawn/process.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAqC3E;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAEtD,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAoKlD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CASrC"}

package/packages/openclaw/dist/spawn/process.js

@@ -0,0 +1,241 @@
+import { spawn as cpSpawn } from 'node:child_process';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { mkdir } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { createServer } from 'node:net';
+import { fileURLToPath } from 'node:url';
+import { AgentRelay } from '@agent-relay/sdk';
+import { normalizeModelRef } from '../identity/model.js';
+import { buildIdentityTask } from '../identity/contract.js';
+import { buildAgentName } from '../identity/naming.js';
+import { ensureWorkspace } from '../identity/files.js';
+import { convertCodexAuth } from '../auth/converter.js';
+import { writeOpenClawConfig } from '../runtime/openclaw-config.js';
+import { patchOpenClawDist, clearJitCache } from '../runtime/patch.js';
+/**
+ * Find a free port by briefly binding to port 0 and reading the OS-assigned port.
+ */
+async function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.listen(0, '127.0.0.1', () => {
+            const addr = server.address();
+            if (!addr || typeof addr === 'string') {
+                server.close();
+                reject(new Error('Failed to get ephemeral port'));
+                return;
+            }
+            const port = addr.port;
+            server.close(() => resolve(port));
+        });
+        server.on('error', reject);
+    });
+}
+/**
+ * Spawn OpenClaw instances as local child processes.
+ * No Docker required — simplest local mode.
+ *
+ * Each spawn:
+ *   1. Starts `openclaw gateway` on an OS-assigned free port
+ *   2. Uses AgentRelay SDK to spawn a broker + bridge agent connected to the gateway
+ */
+export class ProcessSpawnProvider {
+    handles = new Map();
+    async spawn(options) {
+        const workspaceId = options.workspaceId ?? `local-${Date.now().toString(36)}`;
+        const agentName = buildAgentName(workspaceId, options.name);
+        const channels = options.channels?.length ? options.channels : ['general'];
+        const gatewayToken = randomUUID().replace(/-/g, '').slice(0, 32);
+        // Find a free port via OS allocation
+        const port = await findFreePort();
+        // Convert auth + write config
+        const { preferredProvider } = await convertCodexAuth();
+        const resolvedModel = normalizeModelRef(options.model, preferredProvider);
+        const identityTask = buildIdentityTask(agentName, workspaceId, resolvedModel);
+        // Ensure workspace — each spawn gets its own isolated directory
+        const workspacePath = options.workspacePath ?? join(homedir(), '.openclaw', 'spawns', options.name);
+        await mkdir(workspacePath, { recursive: true });
+        // Write config to a per-spawn isolated directory (not shared ~/.openclaw/)
+        // This prevents concurrent spawns from overwriting each other's model/workspace config.
+        const spawnHome = join(homedir(), '.openclaw', 'spawns', options.name, '.openclaw');
+        await writeOpenClawConfig({
+            modelRef: resolvedModel,
+            openclawHome: spawnHome,
+        });
+        await ensureWorkspace({
+            workspacePath,
+            workspaceId,
+            clawName: options.name,
+            role: options.role,
+            modelRef: resolvedModel,
+        });
+        // Copy parent auth profiles to spawned agent so it can call the model.
+        // OpenClaw stores auth in ~/.openclaw/agents/main/agent/auth-profiles.json
+        const parentAuthDir = join(homedir(), '.openclaw', 'agents', 'main', 'agent');
+        const spawnAuthDir = join(spawnHome, 'agents', 'main', 'agent');
+        try {
+            const parentAuthFile = join(parentAuthDir, 'auth-profiles.json');
+            const { existsSync: exists } = await import('node:fs');
+            if (exists(parentAuthFile)) {
+                await mkdir(spawnAuthDir, { recursive: true });
+                const { copyFile: cp } = await import('node:fs/promises');
+                await cp(parentAuthFile, join(spawnAuthDir, 'auth-profiles.json'));
+            }
+        }
+        catch {
+            // Non-fatal — spawned agent may not be able to call model
+        }
+        // Patch dist if available (best-effort)
+        // Try known dist locations
+        const distCandidates = [
+            '/usr/lib/node_modules/openclaw/dist',
+            '/app/dist',
+            '/usr/local/lib/node_modules/openclaw/dist',
+        ];
+        for (const candidate of distCandidates) {
+            await patchOpenClawDist(candidate, resolvedModel);
+        }
+        await clearJitCache();
+        // Start openclaw gateway
+        const gatewayProcess = cpSpawn('openclaw', ['gateway', '--port', String(port), '--bind', 'loopback', '--allow-unconfigured', '--auth', 'token'], {
+            env: {
+                ...process.env,
+                OPENCLAW_GATEWAY_TOKEN: gatewayToken,
+                OPENCLAW_MODEL: resolvedModel,
+                OPENCLAW_NAME: options.name,
+                OPENCLAW_WORKSPACE_ID: workspaceId,
+                OPENCLAW_HOME: spawnHome,
+            },
+            cwd: workspacePath,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        gatewayProcess.stderr?.on('data', (data) => {
+            process.stderr.write(`[spawn:${options.name}:gateway] ${data}`);
+        });
+        // Wait for gateway to be healthy. If it fails, kill the gateway.
+        try {
+            await waitForGateway(port, 30);
+        }
+        catch (err) {
+            gatewayProcess.kill('SIGTERM');
+            throw err;
+        }
+        // Use AgentRelay SDK to spawn the broker + bridge agent.
+        // This replaces shelling out to `agent-relay broker-spawn --from-env`.
+        const bridgePath = resolvePackageBridgePath();
+        let relay = null;
+        try {
+            relay = new AgentRelay({
+                brokerName: agentName,
+                channels,
+                cwd: workspacePath,
+                env: {
+                    ...process.env,
+                    GATEWAY_PORT: String(port),
+                    OPENCLAW_GATEWAY_TOKEN: gatewayToken,
+                    OPENCLAW_WORKSPACE_ID: workspaceId,
+                    OPENCLAW_NAME: options.name,
+                    OPENCLAW_ROLE: options.role ?? 'general',
+                    OPENCLAW_MODEL: resolvedModel,
+                    RELAY_API_KEY: options.relayApiKey,
+                    RELAY_BASE_URL: options.relayBaseUrl || 'https://api.relaycast.dev',
+                    BROKER_NO_REMOTE_SPAWN: '1',
+                },
+            });
+            await relay.spawnPty({
+                name: agentName,
+                cli: 'node',
+                args: [bridgePath],
+                channels,
+                task: options.systemPrompt
+                    ? `${options.systemPrompt}\n\n${identityTask}`
+                    : identityTask,
+            });
+            relay.onAgentExited = (agent) => {
+                process.stderr.write(`[spawn:${options.name}] Agent exited: ${agent.name} code=${agent.exitCode ?? 'none'}\n`);
+            };
+        }
+        catch (err) {
+            // If SDK broker spawn fails, clean up gateway and propagate
+            gatewayProcess.kill('SIGTERM');
+            if (relay) {
+                await relay.shutdown().catch(() => { });
+            }
+            throw new Error(`Failed to start broker for "${options.name}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const handle = {
+            id: `proc-${options.name}-${port}`,
+            displayName: options.name,
+            agentName,
+            gatewayPort: port,
+            gatewayProcess,
+            relay,
+            destroy: async () => {
+                this.handles.delete(handle.id);
+                // Shutdown relay (broker + agent) first via SDK
+                if (relay) {
+                    await relay.shutdown().catch(() => { });
+                }
+                // Then kill gateway
+                gatewayProcess.kill('SIGTERM');
+                await new Promise((r) => setTimeout(r, 2000));
+                if (!gatewayProcess.killed)
+                    gatewayProcess.kill('SIGKILL');
+            },
+        };
+        this.handles.set(handle.id, handle);
+        return handle;
+    }
+    async destroy(id) {
+        const handle = this.handles.get(id);
+        if (handle) {
+            await handle.destroy();
+        }
+    }
+    async list() {
+        return Array.from(this.handles.values()).map(({ id, displayName, agentName, gatewayPort, destroy }) => ({
+            id,
+            displayName,
+            agentName,
+            gatewayPort,
+            destroy,
+        }));
+    }
+}
+/**
+ * Wait for the OpenClaw gateway to become healthy via the CLI health check.
+ */
+async function waitForGateway(port, timeoutSeconds) {
+    for (let i = 0; i < timeoutSeconds; i++) {
+        try {
+            const result = cpSpawn('openclaw', ['health', '--port', String(port)], {
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            const code = await new Promise((resolve) => {
+                result.on('close', resolve);
+                result.on('error', () => resolve(1));
+            });
+            if (code === 0)
+                return;
+        }
+        catch {
+            // Not ready yet
+        }
+        await new Promise((r) => setTimeout(r, 1000));
+    }
+    throw new Error(`OpenClaw gateway on port ${port} failed to start after ${timeoutSeconds}s`);
+}
+/**
+ * Resolve the path to bridge.mjs bundled with this package.
+ */
+function resolvePackageBridgePath() {
+    try {
+        const thisFile = fileURLToPath(import.meta.url);
+        return join(dirname(thisFile), '..', '..', 'bridge', 'bridge.mjs');
+    }
+    catch {
+        return join(process.cwd(), 'node_modules', '@agent-relay', 'openclaw', 'bridge', 'bridge.mjs');
+    }
+}
+//# sourceMappingURL=process.js.map

package/packages/openclaw/dist/spawn/process.js.map

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

package/packages/openclaw/dist/spawn/types.d.ts

@@ -0,0 +1,42 @@
+export interface SpawnOptions {
+    /** Display name for the new OpenClaw (e.g. "researcher"). */
+    name: string;
+    /** Relay API key for Relaycast messaging. */
+    relayApiKey: string;
+    /** Channels to auto-join. */
+    channels?: string[];
+    /** Agent role description. */
+    role?: string;
+    /** Model reference (e.g. "openai-codex/gpt-5.3-codex"). */
+    model?: string;
+    /** System prompt / task description. */
+    systemPrompt?: string;
+    /** Path to an existing workspace directory (for bind-mounting). */
+    workspacePath?: string;
+    /** Relay base URL (default: https://api.relaycast.dev). */
+    relayBaseUrl?: string;
+    /** Workspace ID for identity. */
+    workspaceId?: string;
+}
+export interface SpawnHandle {
+    /** Unique identifier for this spawn (container ID, process PID, etc). */
+    id: string;
+    /** The user-provided display name (e.g. "researcher"). Used for lookups. */
+    displayName: string;
+    /** Relay agent name assigned to this spawn (normalized: claw-<workspace>-<name>). */
+    agentName: string;
+    /** Gateway port this spawn is listening on. */
+    gatewayPort: number;
+    /** Destroy (stop + clean up) this spawn. */
+    destroy: () => Promise<void>;
+}
+/**
+ * Provider interface for spawning OpenClaw instances.
+ * Implementations handle the details of container vs process spawning.
+ */
+export interface SpawnProvider {
+    spawn(options: SpawnOptions): Promise<SpawnHandle>;
+    destroy(id: string): Promise<void>;
+    list(): Promise<SpawnHandle[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/openclaw/dist/spawn/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/spawn/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAChC"}

package/packages/openclaw/dist/spawn/types.js

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

package/packages/openclaw/dist/spawn/types.js.map

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

package/packages/openclaw/dist/types.d.ts

@@ -0,0 +1,37 @@
+export interface GatewayConfig {
+    /** Relaycast workspace API key (rk_live_*). */
+    apiKey: string;
+    /** Name for this claw in the Relaycast workspace. */
+    clawName: string;
+    /** Relaycast API base URL (default: https://api.relaycast.dev). */
+    baseUrl: string;
+    /** Channels to auto-join on connect. */
+    channels: string[];
+    /** OpenClaw gateway token for authenticating with the local gateway API. */
+    openclawGatewayToken?: string;
+    /** OpenClaw gateway port (default: 18789). */
+    openclawGatewayPort?: number;
+}
+export interface InboundMessage {
+    /** Relaycast message ID. */
+    id: string;
+    /** Channel the message was posted to. */
+    channel: string;
+    /** Agent name of the sender. */
+    from: string;
+    /** Message body text. */
+    text: string;
+    /** ISO timestamp. */
+    timestamp: string;
+    /** Parent message ID when this is a thread reply. */
+    threadParentId?: string;
+}
+export interface DeliveryResult {
+    /** Whether delivery succeeded. */
+    ok: boolean;
+    /** Which method delivered: 'relay_sdk' | 'gateway_ws' | 'failed'. */
+    method: 'relay_sdk' | 'gateway_ws' | 'failed';
+    /** Error message if failed. */
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/openclaw/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,qEAAqE;IACrE,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC9C,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/packages/openclaw/dist/types.js

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

package/packages/openclaw/dist/types.js.map

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

package/packages/openclaw/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@agent-relay/openclaw",
+  "version": "3.1.1",
+  "description": "Relaycast bridge for OpenClaw — messaging, identity, runtime setup, and local spawning",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "relay-openclaw": "./bin/relay-openclaw.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/openclaw"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepack": "npm run build",
+    "postinstall": "node -e \"try{require('child_process').execSync('ldd --version 2>&1',{stdio:'pipe'})}catch{try{require('child_process').execSync('apk info gcompat 2>/dev/null',{stdio:'pipe'})}catch{console.warn('\\n\\u26a0\\ufe0f  @agent-relay/openclaw: Alpine detected without gcompat. Spawning requires glibc.\\n   Install with: apk add gcompat libstdc++\\n')}}\""
+  },
+  "dependencies": {
+    "@agent-relay/sdk": "3.1.1",
+    "@relaycast/sdk": "^0.4.0",
+    "ws": "^8.0.0"
+  },
+  "optionalDependencies": {
+    "dockerode": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "@types/ws": "^8.0.0",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.0"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "bridge/",
+    "skill/",
+    "templates/",
+    "README.md"
+  ],
+  "keywords": [
+    "openclaw",
+    "relaycast",
+    "agent-relay",
+    "multi-agent",
+    "messaging",
+    "spawn",
+    "ai-agents"
+  ],
+  "license": "Apache-2.0"
+}