agent-relay 3.0.2 → 3.1.1

package/packages/openclaw/dist/mcp/server.js

@@ -0,0 +1,105 @@
+import { createInterface } from 'node:readline';
+import { getToolDefinitions, handleToolCall, cleanup } from './tools.js';
+/**
+ * MCP stdio server — JSON-RPC 2.0 transport over stdin/stdout.
+ *
+ * Exposes spawn_openclaw, list_openclaws, release_openclaw tools.
+ * Registered in openclaw.json as "openclaw-spawner" MCP server.
+ */
+export async function startMcpServer() {
+    const rl = createInterface({ input: process.stdin, terminal: false });
+    rl.on('line', async (line) => {
+        let request;
+        try {
+            request = JSON.parse(line);
+        }
+        catch {
+            writeResponse({
+                jsonrpc: '2.0',
+                id: null,
+                error: { code: -32700, message: 'Parse error' },
+            });
+            return;
+        }
+        const { id, method, params } = request;
+        try {
+            switch (method) {
+                case 'initialize': {
+                    writeResponse({
+                        jsonrpc: '2.0',
+                        id,
+                        result: {
+                            protocolVersion: '2024-11-05',
+                            capabilities: {
+                                tools: {},
+                            },
+                            serverInfo: {
+                                name: 'openclaw-spawner',
+                                version: '1.0.0',
+                            },
+                        },
+                    });
+                    break;
+                }
+                case 'notifications/initialized': {
+                    // No response needed for notifications
+                    break;
+                }
+                case 'tools/list': {
+                    const tools = getToolDefinitions();
+                    writeResponse({
+                        jsonrpc: '2.0',
+                        id,
+                        result: { tools },
+                    });
+                    break;
+                }
+                case 'tools/call': {
+                    const toolName = params?.name ?? '';
+                    const toolArgs = params?.arguments ?? {};
+                    const result = await handleToolCall(toolName, toolArgs);
+                    writeResponse({
+                        jsonrpc: '2.0',
+                        id,
+                        result,
+                    });
+                    break;
+                }
+                default: {
+                    writeResponse({
+                        jsonrpc: '2.0',
+                        id,
+                        error: { code: -32601, message: `Method not found: ${method}` },
+                    });
+                }
+            }
+        }
+        catch (err) {
+            writeResponse({
+                jsonrpc: '2.0',
+                id,
+                error: {
+                    code: -32603,
+                    message: err instanceof Error ? err.message : String(err),
+                },
+            });
+        }
+    });
+    rl.on('close', async () => {
+        await cleanup();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await cleanup();
+        process.exit(0);
+    });
+    process.on('SIGINT', async () => {
+        await cleanup();
+        process.exit(0);
+    });
+    process.stderr.write('[openclaw-spawner] MCP server started (stdio)\n');
+}
+function writeResponse(response) {
+    process.stdout.write(JSON.stringify(response) + '\n');
+}
+//# sourceMappingURL=server.js.map

package/packages/openclaw/dist/mcp/server.js.map

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

package/packages/openclaw/dist/mcp/tools.d.ts

@@ -0,0 +1,17 @@
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export declare function getToolDefinitions(): McpToolDefinition[];
+export declare function handleToolCall(toolName: string, args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Cleanup: no-op since spawns are managed by the gateway process.
+ */
+export declare function cleanup(): Promise<void>;
+//# sourceMappingURL=tools.d.ts.map

package/packages/openclaw/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,wBAAgB,kBAAkB,IAAI,iBAAiB,EAAE,CA6DxD;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAmF7D;AAMD;;GAEG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7C"}

package/packages/openclaw/dist/mcp/tools.js

@@ -0,0 +1,145 @@
+import { InboundGateway } from '../gateway.js';
+/** Control API base URL — the gateway's spawn control server. */
+const CONTROL_URL = `http://127.0.0.1:${Number(process.env.RELAYCAST_CONTROL_PORT) || InboundGateway.DEFAULT_CONTROL_PORT}`;
+export function getToolDefinitions() {
+    return [
+        {
+            name: 'spawn_openclaw',
+            description: 'Spawn a new independent OpenClaw instance. The spawned instance gets its own gateway, ' +
+                'relay broker, and Relaycast messaging. It runs as an independent peer, not a child.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: 'Name for the new OpenClaw instance (e.g. "researcher", "coder").',
+                    },
+                    role: {
+                        type: 'string',
+                        description: 'Role description for the agent (e.g. "code review specialist").',
+                    },
+                    model: {
+                        type: 'string',
+                        description: 'Model reference (e.g. "openai-codex/gpt-5.3-codex"). Defaults to parent model.',
+                    },
+                    channels: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Relaycast channels to join (default: ["#general"]).',
+                    },
+                    system_prompt: {
+                        type: 'string',
+                        description: 'System prompt / task description for the spawned agent.',
+                    },
+                },
+                required: ['name'],
+            },
+        },
+        {
+            name: 'list_openclaws',
+            description: 'List all currently running OpenClaw instances spawned by this agent.',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+            },
+        },
+        {
+            name: 'release_openclaw',
+            description: 'Stop and release a spawned OpenClaw instance by name or ID.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: 'Name of the OpenClaw to release (as provided during spawn).',
+                    },
+                    id: {
+                        type: 'string',
+                        description: 'ID of the OpenClaw to release (from list_openclaws).',
+                    },
+                },
+            },
+        },
+    ];
+}
+export async function handleToolCall(toolName, args) {
+    switch (toolName) {
+        case 'spawn_openclaw': {
+            const name = args.name;
+            if (!name) {
+                return text('Error: "name" is required.');
+            }
+            try {
+                const res = await fetch(`${CONTROL_URL}/spawn`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(args),
+                });
+                const body = await res.json();
+                if (!body.ok) {
+                    return text(`Failed to spawn "${name}": ${body.error ?? 'unknown error'}`);
+                }
+                return text(`Spawned OpenClaw "${name}"\n` +
+                    `  Agent name: ${body.agentName}\n` +
+                    `  ID: ${body.id}\n` +
+                    `  Gateway port: ${body.gatewayPort}\n` +
+                    `  Total active: ${body.active}`);
+            }
+            catch (err) {
+                return text(`Failed to spawn "${name}": ${err instanceof Error ? err.message : String(err)}\n` +
+                    'Is the gateway running? Start it with: relay-openclaw gateway');
+            }
+        }
+        case 'list_openclaws': {
+            try {
+                const res = await fetch(`${CONTROL_URL}/list`);
+                const body = await res.json();
+                const claws = body.claws;
+                if (!claws || claws.length === 0) {
+                    return text('No spawned OpenClaws currently running.');
+                }
+                const lines = claws.map((h) => `- ${h.name} → ${h.agentName} (id: ${h.id}, port: ${h.gatewayPort})`);
+                return text(`Active OpenClaws (${claws.length}):\n${lines.join('\n')}`);
+            }
+            catch (err) {
+                return text(`Failed to list claws: ${err instanceof Error ? err.message : String(err)}\n` +
+                    'Is the gateway running? Start it with: relay-openclaw gateway');
+            }
+        }
+        case 'release_openclaw': {
+            const name = args.name;
+            const id = args.id;
+            if (!name && !id) {
+                return text('Error: provide either "name" or "id" to release.');
+            }
+            try {
+                const res = await fetch(`${CONTROL_URL}/release`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ name, id }),
+                });
+                const body = await res.json();
+                if (body.ok) {
+                    return text(`Released OpenClaw "${name ?? id}". Active: ${body.active}`);
+                }
+                return text(`OpenClaw "${name ?? id}" not found among active spawns.`);
+            }
+            catch (err) {
+                return text(`Failed to release: ${err instanceof Error ? err.message : String(err)}\n` +
+                    'Is the gateway running? Start it with: relay-openclaw gateway');
+            }
+        }
+        default:
+            return text(`Unknown tool: ${toolName}`);
+    }
+}
+function text(message) {
+    return { content: [{ type: 'text', text: message }] };
+}
+/**
+ * Cleanup: no-op since spawns are managed by the gateway process.
+ */
+export async function cleanup() {
+    // Spawns live in the gateway — nothing to clean up here.
+}
+//# sourceMappingURL=tools.js.map

package/packages/openclaw/dist/mcp/tools.js.map

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

package/packages/openclaw/dist/runtime/openclaw-config.d.ts

@@ -0,0 +1,20 @@
+export interface OpenClawConfigOptions {
+    /** Fully-qualified model ref, e.g. "openai-codex/gpt-5.3-codex". */
+    modelRef: string;
+    /** Path to ~/.openclaw/ (default: $HOME/.openclaw). */
+    openclawHome?: string;
+    /** Default workspace path (default: ~/.openclaw/workspace). */
+    workspacePath?: string;
+    /** MCP servers to include. Keys are server names, values are MCP server configs. */
+    mcpServers?: Record<string, {
+        command: string;
+        args: string[];
+        env?: Record<string, string>;
+    }>;
+}
+/**
+ * Write (or update) ~/.openclaw/openclaw.json with model, workspace, skipBootstrap,
+ * and MCP server configuration.
+ */
+export declare function writeOpenClawConfig(options: OpenClawConfigOptions): Promise<void>;
+//# sourceMappingURL=openclaw-config.d.ts.map

package/packages/openclaw/dist/runtime/openclaw-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-config.d.ts","sourceRoot":"","sources":["../../src/runtime/openclaw-config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;CAChG;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CvF"}

package/packages/openclaw/dist/runtime/openclaw-config.js

@@ -0,0 +1,50 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Write (or update) ~/.openclaw/openclaw.json with model, workspace, skipBootstrap,
+ * and MCP server configuration.
+ */
+export async function writeOpenClawConfig(options) {
+    const home = options.openclawHome ?? join(process.env.HOME ?? '/home/node', '.openclaw');
+    await mkdir(home, { recursive: true });
+    const configPath = join(home, 'openclaw.json');
+    let config = {};
+    try {
+        const raw = await readFile(configPath, 'utf8');
+        config = JSON.parse(raw);
+    }
+    catch {
+        // File doesn't exist or isn't valid JSON — start fresh
+        config = {};
+    }
+    if (!config || typeof config !== 'object')
+        config = {};
+    // agents.defaults
+    if (!config.agents || typeof config.agents !== 'object')
+        config.agents = {};
+    const agents = config.agents;
+    if (!agents.defaults || typeof agents.defaults !== 'object')
+        agents.defaults = {};
+    const defaults = agents.defaults;
+    if (!defaults.workspace || typeof defaults.workspace !== 'string') {
+        defaults.workspace = options.workspacePath ?? '~/.openclaw/workspace';
+    }
+    // Model shape: { primary: "provider/model" }
+    if (typeof defaults.model === 'string') {
+        defaults.model = { primary: defaults.model };
+    }
+    else if (!defaults.model || typeof defaults.model !== 'object') {
+        defaults.model = {};
+    }
+    defaults.model.primary = options.modelRef;
+    defaults.skipBootstrap = true;
+    // MCP servers
+    if (options.mcpServers) {
+        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+            config.mcpServers = {};
+        }
+        Object.assign(config.mcpServers, options.mcpServers);
+    }
+    await writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+}
+//# sourceMappingURL=openclaw-config.js.map

package/packages/openclaw/dist/runtime/openclaw-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-config.js","sourceRoot":"","sources":["../../src/runtime/openclaw-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAajC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAA8B;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,YAAY,EAAE,WAAW,CAAC,CAAC;IACzF,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC/C,IAAI,MAAM,GAA4B,EAAE,CAAC;IAEzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;QACvD,MAAM,GAAG,EAAE,CAAC;IACd,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,MAAM,GAAG,EAAE,CAAC;IAEvD,kBAAkB;IAClB,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC;IAC5E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAiC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;IAClF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAmC,CAAC;IAE5D,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClE,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC;IACxE,CAAC;IAED,6CAA6C;IAC7C,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,QAAQ,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC/C,CAAC;SAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjE,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;IACtB,CAAC;IACA,QAAQ,CAAC,KAAgC,CAAC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAEtE,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC;IAE9B,cAAc;IACd,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;QACzB,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAqC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC"}

package/packages/openclaw/dist/runtime/patch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Patch OpenClaw's compiled dist JS files to replace hardcoded identity constants.
+ *
+ * FRAGILE: This is a best-effort operation. OpenClaw bakes Claude defaults into
+ * its compiled output. These patterns may change between OpenClaw versions.
+ * Prefer runtime identity enforcement (SOUL.md, runtime-identity.json, identity
+ * preamble in bridge) over relying on this patch.
+ *
+ * Known hardcoded constants (as of OpenClaw ~0.x):
+ *   - DEFAULT_MODEL = "claude-opus-4-6"
+ *   - KILOCODE_DEFAULT_MODEL_ID = "anthropic/claude-opus-4.6"
+ *   - KILOCODE_DEFAULT_MODEL_NAME = "Claude Opus 4.6"
+ *   - "Claude Code" branding
+ *
+ * @param distDir - Path to OpenClaw's dist directory (e.g. /usr/lib/node_modules/openclaw/dist)
+ * @param modelRef - Full model reference (e.g. "openai-codex/gpt-5.3-codex")
+ * @returns Number of files patched, or 0 if dist not found or patching skipped
+ */
+export declare function patchOpenClawDist(distDir: string, modelRef: string): Promise<number>;
+/**
+ * Clear JIT cache (/tmp/jiti/) which may contain unpatched constants.
+ */
+export declare function clearJitCache(): Promise<void>;
+//# sourceMappingURL=patch.d.ts.map

package/packages/openclaw/dist/runtime/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../src/runtime/patch.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqE1F;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD"}

package/packages/openclaw/dist/runtime/patch.js

@@ -0,0 +1,92 @@
+import { readdir, readFile, writeFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+/**
+ * Patch OpenClaw's compiled dist JS files to replace hardcoded identity constants.
+ *
+ * FRAGILE: This is a best-effort operation. OpenClaw bakes Claude defaults into
+ * its compiled output. These patterns may change between OpenClaw versions.
+ * Prefer runtime identity enforcement (SOUL.md, runtime-identity.json, identity
+ * preamble in bridge) over relying on this patch.
+ *
+ * Known hardcoded constants (as of OpenClaw ~0.x):
+ *   - DEFAULT_MODEL = "claude-opus-4-6"
+ *   - KILOCODE_DEFAULT_MODEL_ID = "anthropic/claude-opus-4.6"
+ *   - KILOCODE_DEFAULT_MODEL_NAME = "Claude Opus 4.6"
+ *   - "Claude Code" branding
+ *
+ * @param distDir - Path to OpenClaw's dist directory (e.g. /usr/lib/node_modules/openclaw/dist)
+ * @param modelRef - Full model reference (e.g. "openai-codex/gpt-5.3-codex")
+ * @returns Number of files patched, or 0 if dist not found or patching skipped
+ */
+export async function patchOpenClawDist(distDir, modelRef) {
+    if (!existsSync(distDir)) {
+        process.stderr.write(`[patch] OpenClaw dist not found at ${distDir}, skipping\n`);
+        return 0;
+    }
+    // Extract bare model ID (e.g. "gpt-5.3-codex" from "openai-codex/gpt-5.3-codex")
+    const modelId = modelRef.includes('/') ? modelRef.split('/').pop() : modelRef;
+    // Order matters: replace fully-qualified patterns before bare model IDs,
+    // otherwise the bare pattern destroys the substring the qualified pattern needs.
+    const replacements = [
+        [/anthropic\/claude-opus-4\.6/g, modelRef],
+        [/Claude Opus 4\.6/g, modelRef],
+        [/claude-opus-4\.6/g, modelId],
+        [/claude-opus-4-6/g, modelId],
+        [/Claude Code/g, 'OpenClaw Agent'],
+    ];
+    let patchedCount = 0;
+    try {
+        async function walkAndPatch(dir) {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    await walkAndPatch(fullPath);
+                }
+                else if (entry.isFile() && entry.name.endsWith('.js')) {
+                    try {
+                        let content = await readFile(fullPath, 'utf8');
+                        let modified = false;
+                        for (const [pattern, replacement] of replacements) {
+                            const newContent = content.replace(pattern, replacement);
+                            if (newContent !== content) {
+                                content = newContent;
+                                modified = true;
+                            }
+                        }
+                        if (modified) {
+                            await writeFile(fullPath, content, 'utf8');
+                            patchedCount++;
+                        }
+                    }
+                    catch (err) {
+                        // Individual file patch failure is non-fatal
+                        process.stderr.write(`[patch] Warning: could not patch ${fullPath}: ${err instanceof Error ? err.message : String(err)}\n`);
+                    }
+                }
+            }
+        }
+        await walkAndPatch(distDir);
+    }
+    catch (err) {
+        // Entire patching failure is non-fatal — runtime identity enforcement is the primary defense
+        process.stderr.write(`[patch] Warning: dist patching failed (non-fatal): ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+    if (patchedCount > 0) {
+        process.stderr.write(`[patch] Patched ${patchedCount} file(s) in ${distDir}\n`);
+    }
+    return patchedCount;
+}
+/**
+ * Clear JIT cache (/tmp/jiti/) which may contain unpatched constants.
+ */
+export async function clearJitCache() {
+    try {
+        await rm('/tmp/jiti', { recursive: true, force: true });
+    }
+    catch {
+        // Ignore — cache may not exist
+    }
+}
+//# sourceMappingURL=patch.js.map

package/packages/openclaw/dist/runtime/patch.js.map

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

package/packages/openclaw/dist/runtime/setup.d.ts

@@ -0,0 +1,26 @@
+export interface RuntimeSetupOptions {
+    /** Raw model string (e.g. "gpt-5.3-codex"). Defaults to env OPENCLAW_MODEL. */
+    model?: string;
+    /** Agent name. Defaults to env OPENCLAW_NAME or AGENT_NAME. */
+    name?: string;
+    /** Workspace ID. Defaults to env OPENCLAW_WORKSPACE_ID. */
+    workspaceId?: string;
+    /** Agent role. Defaults to env OPENCLAW_ROLE. */
+    role?: string;
+    /** OpenClaw dist directory for patching. Defaults to /usr/lib/node_modules/openclaw/dist. */
+    openclawDistDir?: string;
+    /** Home directory. Defaults to $HOME. */
+    homeDir?: string;
+}
+/**
+ * Full runtime setup: auth conversion, config writing, identity files, dist patching, JIT cache clear.
+ *
+ * This replaces the inline node -e block + shell logic in start-claw.sh.
+ * Call this before starting the OpenClaw gateway.
+ */
+export declare function runtimeSetup(options?: RuntimeSetupOptions): Promise<{
+    modelRef: string;
+    agentName: string;
+    workspaceId: string;
+}>;
+//# sourceMappingURL=setup.d.ts.map

package/packages/openclaw/dist/runtime/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/runtime/setup.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAiDD"}

package/packages/openclaw/dist/runtime/setup.js

@@ -0,0 +1,58 @@
+import { join } from 'node:path';
+import { unlink } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { normalizeModelRef } from '../identity/model.js';
+import { convertCodexAuth } from '../auth/converter.js';
+import { writeOpenClawConfig } from './openclaw-config.js';
+import { patchOpenClawDist, clearJitCache } from './patch.js';
+import { ensureWorkspace, } from '../identity/files.js';
+/**
+ * Full runtime setup: auth conversion, config writing, identity files, dist patching, JIT cache clear.
+ *
+ * This replaces the inline node -e block + shell logic in start-claw.sh.
+ * Call this before starting the OpenClaw gateway.
+ */
+export async function runtimeSetup(options = {}) {
+    const home = options.homeDir ?? process.env.HOME ?? '/home/node';
+    const model = options.model ?? process.env.OPENCLAW_MODEL ?? 'openai-codex/gpt-5.3-codex';
+    const name = options.name ?? process.env.OPENCLAW_NAME ?? process.env.AGENT_NAME ?? 'agent';
+    const workspaceId = options.workspaceId ?? process.env.OPENCLAW_WORKSPACE_ID ?? 'unknown';
+    const role = options.role ?? process.env.OPENCLAW_ROLE ?? 'general';
+    // Resolve OpenClaw dist dir: try explicit, then known install locations
+    const distDirCandidates = options.openclawDistDir
+        ? [options.openclawDistDir]
+        : [
+            '/usr/lib/node_modules/openclaw/dist', // Global npm (ClawRunner sandbox)
+            '/app/dist', // Vanilla Docker image
+            '/usr/local/lib/node_modules/openclaw/dist', // Global npm (macOS/other)
+        ];
+    const distDir = distDirCandidates.find((d) => existsSync(d)) ?? distDirCandidates[0];
+    // 1. Convert codex auth
+    const { preferredProvider } = await convertCodexAuth();
+    const modelRef = normalizeModelRef(model, preferredProvider);
+    // 2. Write openclaw.json config
+    await writeOpenClawConfig({
+        modelRef,
+        openclawHome: join(home, '.openclaw'),
+    });
+    // 3. Write identity files in workspace
+    const wsDir = join(home, '.openclaw', 'workspace');
+    await ensureWorkspace({
+        workspacePath: wsDir,
+        workspaceId,
+        clawName: name,
+        role,
+        modelRef,
+    });
+    // Remove BOOTSTRAP.md if present (agent is pre-configured)
+    const bootstrapPath = join(wsDir, 'BOOTSTRAP.md');
+    if (existsSync(bootstrapPath)) {
+        await unlink(bootstrapPath);
+    }
+    // 4. Patch OpenClaw dist
+    await patchOpenClawDist(distDir, modelRef);
+    // 5. Clear JIT cache
+    await clearJitCache();
+    return { modelRef, agentName: name, workspaceId };
+}
+//# sourceMappingURL=setup.js.map

package/packages/openclaw/dist/runtime/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/runtime/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAGL,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAiB9B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAA+B,EAAE;IAKlE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,YAAY,CAAC;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,4BAA4B,CAAC;IAC1F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC;IAC5F,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,SAAS,CAAC;IAC1F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS,CAAC;IACpE,wEAAwE;IACxE,MAAM,iBAAiB,GAAG,OAAO,CAAC,eAAe;QAC/C,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;QAC3B,CAAC,CAAC;YACE,qCAAqC,EAAK,kCAAkC;YAC5E,WAAW,EAAiC,uBAAuB;YACnE,2CAA2C,EAAE,2BAA2B;SACzE,CAAC;IACN,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAErF,wBAAwB;IACxB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAE7D,gCAAgC;IAChC,MAAM,mBAAmB,CAAC;QACxB,QAAQ;QACR,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;KACtC,CAAC,CAAC;IAEH,uCAAuC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACnD,MAAM,eAAe,CAAC;QACpB,aAAa,EAAE,KAAK;QACpB,WAAW;QACX,QAAQ,EAAE,IAAI;QACd,IAAI;QACJ,QAAQ;KACT,CAAC,CAAC;IAEH,2DAA2D;IAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,yBAAyB;IACzB,MAAM,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE3C,qBAAqB;IACrB,MAAM,aAAa,EAAE,CAAC;IAEtB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACpD,CAAC"}

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

@@ -0,0 +1,29 @@
+export interface SetupOptions {
+    /** If provided, join this workspace. Otherwise create a new one. */
+    apiKey?: string;
+    /** Name for this claw (default: hostname). */
+    clawName?: string;
+    /** Channels to auto-join (default: ['general']). */
+    channels?: string[];
+    /** Relaycast API base URL. */
+    baseUrl?: string;
+}
+export interface SetupResult {
+    ok: boolean;
+    apiKey: string;
+    clawName: string;
+    skillDir: string;
+    message: string;
+}
+/**
+ * Install the Relaycast bridge into an OpenClaw workspace.
+ *
+ * 1. Detect OpenClaw installation
+ * 2. Create/join workspace via Relaycast API (if no key provided)
+ * 3. Install SKILL.md
+ * 4. Write .env config
+ * 5. Configure MCP server in openclaw.json
+ * 6. Print success summary
+ */
+export declare function setup(options: SetupOptions): Promise<SetupResult>;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA4PvE"}