agent-relay 3.1.0 → 3.1.1

package/packages/openclaw/dist/__tests__/gateway-threads.test.js

@@ -0,0 +1,320 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// ---------------------------------------------------------------------------
+// Mocks — declared before importing the module under test
+// ---------------------------------------------------------------------------
+// Store registered event handlers so tests can fire them
+const eventHandlers = {};
+function registerHandler(event) {
+    return (handler) => {
+        if (!eventHandlers[event])
+            eventHandlers[event] = [];
+        eventHandlers[event].push(handler);
+        return () => {
+            eventHandlers[event] = eventHandlers[event].filter((h) => h !== handler);
+        };
+    };
+}
+function fireEvent(event, ...args) {
+    for (const handler of eventHandlers[event] ?? []) {
+        handler(...args);
+    }
+}
+const mockAgentClient = {
+    connect: vi.fn(),
+    disconnect: vi.fn().mockResolvedValue(undefined),
+    subscribe: vi.fn(),
+    unsubscribe: vi.fn(),
+    presence: {
+        markOnline: vi.fn().mockResolvedValue(undefined),
+        heartbeat: vi.fn().mockResolvedValue(undefined),
+        markOffline: vi.fn().mockResolvedValue(undefined),
+    },
+    channels: {
+        join: vi.fn().mockResolvedValue({ ok: true }),
+        create: vi.fn().mockResolvedValue({ name: 'general' }),
+    },
+    on: {
+        connected: registerHandler('connected'),
+        messageCreated: registerHandler('messageCreated'),
+        threadReply: registerHandler('threadReply'),
+        reconnecting: registerHandler('reconnecting'),
+        disconnected: registerHandler('disconnected'),
+        error: registerHandler('error'),
+        any: registerHandler('any'),
+    },
+};
+vi.mock('@relaycast/sdk', () => ({
+    RelayCast: vi.fn().mockImplementation(() => ({
+        agents: {
+            registerOrGet: vi.fn().mockResolvedValue({ name: 'viewer-test-claw', token: 'tok_test' }),
+        },
+        channels: { join: vi.fn().mockResolvedValue({ ok: true }) },
+        messages: { list: vi.fn().mockResolvedValue([]) },
+        as: vi.fn().mockReturnValue(mockAgentClient),
+    })),
+}));
+vi.mock('../spawn/manager.js', () => ({
+    SpawnManager: vi.fn().mockImplementation(() => ({
+        size: 0,
+        spawn: vi.fn(),
+        release: vi.fn(),
+        releaseByName: vi.fn(),
+        releaseAll: vi.fn().mockResolvedValue(undefined),
+        list: vi.fn().mockReturnValue([]),
+        get: vi.fn(),
+    })),
+}));
+vi.mock('node:fs/promises', () => ({
+    readFile: vi.fn().mockResolvedValue('{"spawns":[]}'),
+    writeFile: vi.fn().mockResolvedValue(undefined),
+    mkdir: vi.fn().mockResolvedValue(undefined),
+}));
+vi.mock('node:fs', () => ({
+    existsSync: vi.fn().mockReturnValue(false),
+}));
+// Mock createServer to avoid binding real ports
+vi.mock('node:http', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        createServer: vi.fn().mockReturnValue({
+            listen: vi.fn((_port, _host, cb) => cb()),
+            close: vi.fn((cb) => cb?.()),
+            address: vi.fn().mockReturnValue({ port: 18790 }),
+        }),
+    };
+});
+// ---------------------------------------------------------------------------
+// Import after mocks
+// ---------------------------------------------------------------------------
+import { InboundGateway } from '../gateway.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function createGateway(overrides) {
+    const sendMessage = vi.fn().mockResolvedValue({ event_id: 'evt_1' });
+    const gateway = new InboundGateway({
+        config: {
+            apiKey: 'rk_live_test',
+            clawName: overrides?.clawName ?? 'test-claw',
+            baseUrl: 'https://api.relaycast.dev',
+            channels: overrides?.channels ?? ['general'],
+        },
+        relaySender: { sendMessage },
+    });
+    return { gateway, sendMessage };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('InboundGateway — thread reply injection', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        for (const key of Object.keys(eventHandlers)) {
+            eventHandlers[key] = [];
+        }
+    });
+    afterEach(async () => {
+        vi.useRealTimers();
+    });
+    describe('message formatting', () => {
+        it('should format regular channel messages without thread prefix', async () => {
+            const { gateway, sendMessage } = createGateway();
+            await gateway.start();
+            fireEvent('messageCreated', {
+                type: 'message.created',
+                channel: 'general',
+                message: {
+                    id: 'msg_1',
+                    agentName: 'alice',
+                    text: 'hello world',
+                    attachments: [],
+                },
+            });
+            await vi.waitFor(() => {
+                expect(sendMessage).toHaveBeenCalled();
+            });
+            const call = sendMessage.mock.calls[0][0];
+            expect(call.text).toBe('[relaycast:general] @alice: hello world');
+            expect(call.text).not.toContain('[thread]');
+            await gateway.stop();
+        });
+        it('should format thread replies with [thread] prefix', async () => {
+            const { gateway, sendMessage } = createGateway();
+            await gateway.start();
+            fireEvent('threadReply', {
+                type: 'thread.reply',
+                channel: 'general',
+                parentId: 'msg_parent_1',
+                message: {
+                    id: 'msg_reply_1',
+                    agentName: 'bob',
+                    text: 'replying in thread',
+                },
+            });
+            await vi.waitFor(() => {
+                expect(sendMessage).toHaveBeenCalled();
+            });
+            const call = sendMessage.mock.calls[0][0];
+            expect(call.text).toBe('[thread] [relaycast:general] @bob: replying in thread');
+            await gateway.stop();
+        });
+    });
+    describe('thread reply event handling', () => {
+        it('should deliver thread replies from subscribed channels', async () => {
+            const { gateway, sendMessage } = createGateway({ channels: ['general', 'dev'] });
+            await gateway.start();
+            fireEvent('threadReply', {
+                type: 'thread.reply',
+                channel: 'dev',
+                parentId: 'msg_100',
+                message: {
+                    id: 'msg_101',
+                    agentName: 'carol',
+                    text: 'thread in dev channel',
+                },
+            });
+            await vi.waitFor(() => {
+                expect(sendMessage).toHaveBeenCalled();
+            });
+            const call = sendMessage.mock.calls[0][0];
+            expect(call.text).toContain('[thread]');
+            expect(call.text).toContain('[relaycast:dev]');
+            expect(call.text).toContain('@carol');
+            await gateway.stop();
+        });
+        it('should ignore thread replies from unsubscribed channels', async () => {
+            const { gateway, sendMessage } = createGateway({ channels: ['general'] });
+            await gateway.start();
+            fireEvent('threadReply', {
+                type: 'thread.reply',
+                channel: 'random',
+                parentId: 'msg_200',
+                message: {
+                    id: 'msg_201',
+                    agentName: 'dave',
+                    text: 'thread in random',
+                },
+            });
+            await new Promise((r) => setTimeout(r, 50));
+            expect(sendMessage).not.toHaveBeenCalled();
+            await gateway.stop();
+        });
+        it('should skip thread replies from the claw itself (echo prevention)', async () => {
+            const { gateway, sendMessage } = createGateway({ clawName: 'my-claw' });
+            await gateway.start();
+            fireEvent('threadReply', {
+                type: 'thread.reply',
+                channel: 'general',
+                parentId: 'msg_300',
+                message: {
+                    id: 'msg_301',
+                    agentName: 'my-claw',
+                    text: 'my own reply',
+                },
+            });
+            await new Promise((r) => setTimeout(r, 50));
+            expect(sendMessage).not.toHaveBeenCalled();
+            await gateway.stop();
+        });
+        it('should skip thread replies from the viewer identity', async () => {
+            const { gateway, sendMessage } = createGateway({ clawName: 'my-claw' });
+            await gateway.start();
+            fireEvent('threadReply', {
+                type: 'thread.reply',
+                channel: 'general',
+                parentId: 'msg_400',
+                message: {
+                    id: 'msg_401',
+                    agentName: 'viewer-my-claw',
+                    text: 'viewer echo',
+                },
+            });
+            await new Promise((r) => setTimeout(r, 50));
+            expect(sendMessage).not.toHaveBeenCalled();
+            await gateway.stop();
+        });
+        it('should deduplicate thread replies with the same message ID', async () => {
+            const { gateway, sendMessage } = createGateway();
+            await gateway.start();
+            const event = {
+                type: 'thread.reply',
+                channel: 'general',
+                parentId: 'msg_500',
+                message: {
+                    id: 'msg_501',
+                    agentName: 'eve',
+                    text: 'duplicate test',
+                },
+            };
+            fireEvent('threadReply', event);
+            fireEvent('threadReply', event);
+            await vi.waitFor(() => {
+                expect(sendMessage).toHaveBeenCalled();
+            });
+            await new Promise((r) => setTimeout(r, 50));
+            expect(sendMessage).toHaveBeenCalledTimes(1);
+            await gateway.stop();
+        });
+    });
+    describe('mixed message and thread delivery', () => {
+        it('should deliver both channel messages and thread replies', async () => {
+            const { gateway, sendMessage } = createGateway();
+            await gateway.start();
+            fireEvent('messageCreated', {
+                type: 'message.created',
+                channel: 'general',
+                message: {
+                    id: 'msg_600',
+                    agentName: 'frank',
+                    text: 'original message',
+                    attachments: [],
+                },
+            });
+            await vi.waitFor(() => {
+                expect(sendMessage).toHaveBeenCalledTimes(1);
+            });
+            fireEvent('threadReply', {
+                type: 'thread.reply',
+                channel: 'general',
+                parentId: 'msg_600',
+                message: {
+                    id: 'msg_601',
+                    agentName: 'grace',
+                    text: 'reply to frank',
+                },
+            });
+            await vi.waitFor(() => {
+                expect(sendMessage).toHaveBeenCalledTimes(2);
+            });
+            const firstCall = sendMessage.mock.calls[0][0];
+            expect(firstCall.text).toBe('[relaycast:general] @frank: original message');
+            const secondCall = sendMessage.mock.calls[1][0];
+            expect(secondCall.text).toBe('[thread] [relaycast:general] @grace: reply to frank');
+            await gateway.stop();
+        });
+        it('should include source metadata in relay sender data', async () => {
+            const { gateway, sendMessage } = createGateway();
+            await gateway.start();
+            fireEvent('threadReply', {
+                type: 'thread.reply',
+                channel: 'general',
+                parentId: 'msg_parent_700',
+                message: {
+                    id: 'msg_700',
+                    agentName: 'heidi',
+                    text: 'metadata check',
+                },
+            });
+            await vi.waitFor(() => {
+                expect(sendMessage).toHaveBeenCalled();
+            });
+            const call = sendMessage.mock.calls[0][0];
+            expect(call.data.source).toBe('relaycast');
+            expect(call.data.channel).toBe('general');
+            expect(call.data.messageId).toBe('msg_700');
+            await gateway.stop();
+        });
+    });
+});
+//# sourceMappingURL=gateway-threads.test.js.map

package/packages/openclaw/dist/__tests__/gateway-threads.test.js.map

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

package/packages/openclaw/dist/__tests__/naming.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=naming.test.d.ts.map

package/packages/openclaw/dist/__tests__/naming.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/naming.test.ts"],"names":[],"mappings":""}

package/packages/openclaw/dist/__tests__/naming.test.js

@@ -0,0 +1,21 @@
+import { describe, it, expect } from 'vitest';
+import { buildAgentName } from '../identity/naming.js';
+describe('buildAgentName', () => {
+    it('should build agent name from workspace and claw name', () => {
+        const result = buildAgentName('ws123', 'researcher');
+        expect(result).toBe('claw-ws123-researcher');
+    });
+    it('should handle hyphens in workspace id', () => {
+        const result = buildAgentName('ws-abc-123', 'coder');
+        expect(result).toBe('claw-ws-abc-123-coder');
+    });
+    it('should handle hyphens in claw name', () => {
+        const result = buildAgentName('workspace', 'code-reviewer');
+        expect(result).toBe('claw-workspace-code-reviewer');
+    });
+    it('should handle empty strings', () => {
+        const result = buildAgentName('', '');
+        expect(result).toBe('claw--');
+    });
+});
+//# sourceMappingURL=naming.test.js.map

package/packages/openclaw/dist/__tests__/naming.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.test.js","sourceRoot":"","sources":["../../src/__tests__/naming.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/packages/openclaw/dist/__tests__/spawn-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spawn-manager.test.d.ts.map

package/packages/openclaw/dist/__tests__/spawn-manager.test.d.ts.map

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

package/packages/openclaw/dist/__tests__/spawn-manager.test.js

@@ -0,0 +1,126 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { SpawnManager } from '../spawn/manager.js';
+// Mock the spawn providers
+vi.mock('../spawn/docker.js', () => ({
+    DockerSpawnProvider: vi.fn().mockImplementation(() => ({
+        spawn: vi.fn().mockResolvedValue({
+            id: 'test-id-1',
+            displayName: 'test-claw',
+            agentName: 'claw-ws123-test-claw',
+            gatewayPort: 18789,
+            destroy: vi.fn().mockResolvedValue(undefined),
+        }),
+        destroy: vi.fn().mockResolvedValue(undefined),
+        list: vi.fn().mockResolvedValue([]),
+    })),
+}));
+vi.mock('../spawn/process.js', () => ({
+    ProcessSpawnProvider: vi.fn().mockImplementation(() => {
+        let callCount = 0;
+        return {
+            spawn: vi.fn().mockImplementation((options) => {
+                callCount++;
+                return Promise.resolve({
+                    id: `test-id-${callCount}`,
+                    displayName: options.name,
+                    agentName: `claw-ws123-${options.name}`,
+                    gatewayPort: 18790,
+                    destroy: vi.fn().mockResolvedValue(undefined),
+                });
+            }),
+            destroy: vi.fn().mockResolvedValue(undefined),
+            list: vi.fn().mockResolvedValue([]),
+        };
+    }),
+}));
+// Mock fs operations
+vi.mock('node:fs/promises', () => ({
+    readFile: vi.fn().mockResolvedValue('{"spawns":[]}'),
+    writeFile: vi.fn().mockResolvedValue(undefined),
+    mkdir: vi.fn().mockResolvedValue(undefined),
+}));
+vi.mock('node:fs', () => ({
+    existsSync: vi.fn().mockReturnValue(false),
+}));
+describe('SpawnManager', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should initialize with default values', () => {
+        const manager = new SpawnManager({ mode: 'process' });
+        expect(manager.size).toBe(0);
+    });
+    it('should enforce maxSpawns limit', async () => {
+        const manager = new SpawnManager({ mode: 'process', maxSpawns: 1 });
+        // First spawn should succeed
+        await manager.spawn({
+            name: 'claw-1',
+            relayApiKey: 'rk_live_test',
+        });
+        expect(manager.size).toBe(1);
+        // Second spawn should fail due to limit
+        await expect(manager.spawn({
+            name: 'claw-2',
+            relayApiKey: 'rk_live_test',
+        })).rejects.toThrow(/Maximum concurrent spawns reached/);
+    });
+    it('should enforce maxDepth limit', async () => {
+        const manager = new SpawnManager({
+            mode: 'process',
+            maxDepth: 2,
+            spawnDepth: 2, // Already at max depth
+        });
+        await expect(manager.spawn({
+            name: 'claw-1',
+            relayApiKey: 'rk_live_test',
+        })).rejects.toThrow(/Spawn depth limit reached/);
+    });
+    it('should prevent duplicate spawns by name', async () => {
+        const manager = new SpawnManager({ mode: 'process' });
+        await manager.spawn({
+            name: 'researcher',
+            relayApiKey: 'rk_live_test',
+        });
+        await expect(manager.spawn({
+            name: 'researcher',
+            relayApiKey: 'rk_live_test',
+        })).rejects.toThrow(/already running/);
+    });
+    it('should list spawned handles', async () => {
+        const manager = new SpawnManager({ mode: 'process' });
+        await manager.spawn({
+            name: 'worker-1',
+            relayApiKey: 'rk_live_test',
+        });
+        const list = manager.list();
+        expect(list).toHaveLength(1);
+        expect(list[0].displayName).toBe('worker-1');
+    });
+    it('should release by id', async () => {
+        const manager = new SpawnManager({ mode: 'process' });
+        const handle = await manager.spawn({
+            name: 'worker-1',
+            relayApiKey: 'rk_live_test',
+        });
+        expect(manager.size).toBe(1);
+        const released = await manager.release(handle.id);
+        expect(released).toBe(true);
+        expect(manager.size).toBe(0);
+    });
+    it('should release by name', async () => {
+        const manager = new SpawnManager({ mode: 'process' });
+        await manager.spawn({
+            name: 'worker-1',
+            relayApiKey: 'rk_live_test',
+        });
+        const released = await manager.releaseByName('worker-1');
+        expect(released).toBe(true);
+        expect(manager.size).toBe(0);
+    });
+    it('should return false when releasing non-existent spawn', async () => {
+        const manager = new SpawnManager({ mode: 'process' });
+        const released = await manager.release('non-existent-id');
+        expect(released).toBe(false);
+    });
+});
+//# sourceMappingURL=spawn-manager.test.js.map

package/packages/openclaw/dist/__tests__/spawn-manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-manager.test.js","sourceRoot":"","sources":["../../src/__tests__/spawn-manager.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,2BAA2B;AAC3B,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,mBAAmB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC/B,EAAE,EAAE,WAAW;YACf,WAAW,EAAE,WAAW;YACxB,SAAS,EAAE,sBAAsB;YACjC,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;SAC9C,CAAC;QACF,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC7C,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;KACpC,CAAC,CAAC;CACJ,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;IACpC,oBAAoB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;QACpD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,OAAO;YACL,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,OAAyB,EAAE,EAAE;gBAC9D,SAAS,EAAE,CAAC;gBACZ,OAAO,OAAO,CAAC,OAAO,CAAC;oBACrB,EAAE,EAAE,WAAW,SAAS,EAAE;oBAC1B,WAAW,EAAE,OAAO,CAAC,IAAI;oBACzB,SAAS,EAAE,cAAc,OAAO,CAAC,IAAI,EAAE;oBACvC,WAAW,EAAE,KAAK;oBAClB,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;iBAC9C,CAAC,CAAC;YACL,CAAC,CAAC;YACF,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YAC7C,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;SACpC,CAAC;IACJ,CAAC,CAAC;CACH,CAAC,CAAC,CAAC;AAEJ,qBAAqB;AACrB,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC;IACpD,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;IAC/C,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;CAC5C,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACxB,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC;CAC3C,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QAEpE,6BAA6B;QAC7B,MAAM,OAAO,CAAC,KAAK,CAAC;YAClB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE7B,wCAAwC;QACxC,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YACzB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC;YAC/B,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,CAAC,EAAG,uBAAuB;SACxC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YACzB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAEtD,MAAM,OAAO,CAAC,KAAK,CAAC;YAClB,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YACzB,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAEtD,MAAM,OAAO,CAAC,KAAK,CAAC;YAClB,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QACpC,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC;YACjC,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE7B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAEtD,MAAM,OAAO,CAAC,KAAK,CAAC;YAClB,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAEtD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC1D,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/packages/openclaw/dist/auth/converter.d.ts

@@ -0,0 +1,28 @@
+export interface CodexOAuthTokens {
+    access_token: string;
+    refresh_token?: string;
+}
+export interface CodexAuth {
+    tokens?: CodexOAuthTokens;
+    OPENAI_API_KEY?: string;
+}
+export interface ConvertResult {
+    /** Whether auth was written. */
+    ok: boolean;
+    /** Provider hint derived from auth source (e.g. 'openai-codex' for OAuth). */
+    preferredProvider: string;
+}
+/**
+ * Convert Codex CLI auth.json into OpenClaw's legacy auth format.
+ *
+ * Reads ~/.codex/auth.json (or codexAuthPath) and writes the converted
+ * auth to ~/.openclaw/agents/main/agent/auth.json (or openclawAuthDir).
+ *
+ * Falls back to OPENAI_API_KEY env var if no codex auth file exists.
+ */
+export declare function convertCodexAuth(options?: {
+    codexAuthPath?: string;
+    openclawAuthDir?: string;
+    openaiApiKey?: string;
+}): Promise<ConvertResult>;
+//# sourceMappingURL=converter.d.ts.map

package/packages/openclaw/dist/auth/converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../src/auth/converter.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,8EAA8E;IAC9E,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwDzB"}

package/packages/openclaw/dist/auth/converter.js

@@ -0,0 +1,64 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+/**
+ * Convert Codex CLI auth.json into OpenClaw's legacy auth format.
+ *
+ * Reads ~/.codex/auth.json (or codexAuthPath) and writes the converted
+ * auth to ~/.openclaw/agents/main/agent/auth.json (or openclawAuthDir).
+ *
+ * Falls back to OPENAI_API_KEY env var if no codex auth file exists.
+ */
+export async function convertCodexAuth(options) {
+    const home = process.env.HOME ?? '/home/node';
+    const codexPath = options?.codexAuthPath ?? join(home, '.codex', 'auth.json');
+    const openclawAgentDir = options?.openclawAuthDir ?? join(home, '.openclaw', 'agents', 'main', 'agent');
+    const openclawAuthPath = join(openclawAgentDir, 'auth.json');
+    let preferredProvider = 'openai';
+    if (existsSync(codexPath)) {
+        const codex = JSON.parse(await readFile(codexPath, 'utf8'));
+        await mkdir(openclawAgentDir, { recursive: true });
+        if (codex.tokens?.access_token) {
+            // OAuth tokens from codex subscription
+            const auth = {
+                'openai-codex': {
+                    type: 'oauth',
+                    provider: 'openai-codex',
+                    access: codex.tokens.access_token,
+                    refresh: codex.tokens.refresh_token ?? '',
+                    expires: Date.now() + 3600000,
+                },
+            };
+            await writeFile(openclawAuthPath, JSON.stringify(auth, null, 2), 'utf8');
+            preferredProvider = 'openai-codex';
+            return { ok: true, preferredProvider };
+        }
+        if (codex.OPENAI_API_KEY && typeof codex.OPENAI_API_KEY === 'string') {
+            const auth = {
+                openai: {
+                    type: 'api_key',
+                    provider: 'openai',
+                    key: codex.OPENAI_API_KEY,
+                },
+            };
+            await writeFile(openclawAuthPath, JSON.stringify(auth, null, 2), 'utf8');
+            return { ok: true, preferredProvider };
+        }
+    }
+    // Fallback: use OPENAI_API_KEY from env
+    const envKey = options?.openaiApiKey ?? process.env.OPENAI_API_KEY;
+    if (envKey) {
+        await mkdir(openclawAgentDir, { recursive: true });
+        const auth = {
+            openai: {
+                type: 'api_key',
+                provider: 'openai',
+                key: envKey,
+            },
+        };
+        await writeFile(openclawAuthPath, JSON.stringify(auth, null, 2), 'utf8');
+        return { ok: true, preferredProvider };
+    }
+    return { ok: false, preferredProvider };
+}
+//# sourceMappingURL=converter.js.map

package/packages/openclaw/dist/auth/converter.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

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