@cereworker/cli 26.329.12 → 26.329.14

package/dist/service.integration.test.js

@@ -0,0 +1,181 @@
+import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { configSchema } from '@cereworker/config';
+import { createService } from './service.js';
+import { buildChannelConversationKey } from './channel-conversations.js';
+function makeConfig(overrides = {}) {
+    return configSchema.parse({
+        cerebrum: {
+            defaultProvider: 'local',
+            defaultModel: 'llama3.3',
+            providers: {
+                local: {
+                    baseUrl: 'http://127.0.0.1:11434',
+                    model: 'llama3.3',
+                },
+            },
+            streamStallThreshold: 1,
+            maxNudgeRetries: 1,
+        },
+        cerebellum: {
+            enabled: false,
+            verification: { enabled: false },
+            finetune: { enabled: false },
+        },
+        hippocampus: { enabled: false },
+        proactive: { enabled: false },
+        subAgents: { enabled: false },
+        tools: {
+            shell: { enabled: false },
+            fileOps: { enabled: false },
+            http: { enabled: false },
+            web: { enabled: false },
+            browser: { enabled: false },
+        },
+        channels: { dmPolicy: 'open' },
+        ...overrides,
+    });
+}
+function createWatchdogCerebellum() {
+    return {
+        isConnected: vi.fn(() => true),
+        verifyToolResult: vi.fn(async () => ({ passed: false, checks: [], modelVerdict: false })),
+        ingestTrainingData: vi.fn(async () => 0),
+        startFineTune: vi.fn(async () => ({ jobId: '', started: false, error: '' })),
+        getFineTuneStatus: vi.fn(async () => null),
+    };
+}
+describe('createService integration', () => {
+    let homeDir;
+    beforeEach(() => {
+        homeDir = mkdtempSync(join(tmpdir(), 'cereworker-service-'));
+        vi.stubEnv('HOME', homeDir);
+    });
+    afterEach(async () => {
+        vi.useRealTimers();
+        vi.unstubAllEnvs();
+        rmSync(homeDir, { recursive: true, force: true });
+    });
+    it('retries a stalled stream through the real service bridge without surfacing a false error', async () => {
+        vi.useFakeTimers();
+        const service = createService(makeConfig());
+        const cerebellum = createWatchdogCerebellum();
+        service.orchestrator.setCerebellum(cerebellum, { enabled: false });
+        let attempts = 0;
+        service.cerebrum.stream = vi.fn(async (_messages, _tools, callbacks, options) => {
+            attempts++;
+            if (attempts === 1) {
+                await new Promise((_resolve, reject) => {
+                    const signal = options?.abortSignal;
+                    if (!signal) {
+                        reject(new Error('missing abort signal'));
+                        return;
+                    }
+                    const onAbort = () => {
+                        callbacks.onError(new Error('intentional nudge abort'));
+                        reject(new Error('intentional nudge abort'));
+                    };
+                    if (signal.aborted) {
+                        onAbort();
+                        return;
+                    }
+                    signal.addEventListener('abort', onAbort, { once: true });
+                });
+                return;
+            }
+            callbacks.onChunk('Recovered reply');
+            callbacks.onFinish('Recovered reply');
+        });
+        const errors = [];
+        const nudges = [];
+        service.orchestrator.on('error', ({ error }) => errors.push(error));
+        service.orchestrator.on('cerebrum:stall:nudge', ({ attempt }) => nudges.push(attempt));
+        const sendPromise = service.orchestrator.sendMessage('hello from watchdog');
+        await vi.advanceTimersByTimeAsync(15_000);
+        await sendPromise;
+        const messages = service.orchestrator.getMessages();
+        expect(attempts).toBe(2);
+        expect(errors).toEqual([]);
+        expect(nudges).toEqual([1]);
+        expect(messages.slice(-3).map((message) => [message.role, message.content])).toEqual([
+            ['user', 'hello from watchdog'],
+            ['system', '[Cerebellum] You stopped mid-response. Continue from where you left off.'],
+            ['cerebrum', 'Recovered reply'],
+        ]);
+        await service.shutdown();
+    });
+    it('keeps short-term channel conversations separate while persisting the session map', async () => {
+        const service = createService(makeConfig());
+        service.cerebrum.stream = vi.fn(async (messages, _tools, callbacks) => {
+            const lastUser = [...messages].reverse().find((message) => message.role === 'user');
+            callbacks.onFinish(`reply:${lastUser?.content ?? ''}`);
+        });
+        let inboundHandler = null;
+        let connected = false;
+        const fakeChannel = {
+            id: 'discord',
+            meta: { name: 'Discord', emoji: '💬' },
+            start: vi.fn(async (handler) => {
+                inboundHandler = handler;
+                connected = true;
+            }),
+            stop: vi.fn(async () => {
+                connected = false;
+            }),
+            send: vi.fn(async () => { }),
+            isAllowed: vi.fn(() => true),
+            isConnected: vi.fn(() => connected),
+        };
+        service.channelManager.register(fakeChannel);
+        await service.startChannels();
+        expect(inboundHandler).not.toBeNull();
+        const messageA1 = {
+            channelId: 'discord',
+            senderId: 'user-a',
+            senderName: 'Alice',
+            sessionId: 'dm:user-a',
+            text: 'hello from a',
+            timestamp: Date.now(),
+        };
+        const messageB1 = {
+            channelId: 'discord',
+            senderId: 'user-b',
+            senderName: 'Bob',
+            sessionId: 'dm:user-b',
+            text: 'hello from b',
+            timestamp: Date.now() + 1,
+        };
+        const messageA2 = {
+            ...messageA1,
+            text: 'follow up from a',
+            timestamp: Date.now() + 2,
+        };
+        await expect(inboundHandler(messageA1)).resolves.toBe('reply:hello from a');
+        await expect(inboundHandler(messageB1)).resolves.toBe('reply:hello from b');
+        await expect(inboundHandler(messageA2)).resolves.toBe('reply:follow up from a');
+        const mapPath = join(homeDir, '.cereworker', 'channel-conversations.json');
+        const savedMap = JSON.parse(readFileSync(mapPath, 'utf-8'));
+        const keyA = buildChannelConversationKey(messageA1);
+        const keyB = buildChannelConversationKey(messageB1);
+        expect(savedMap[keyA]).toBeTruthy();
+        expect(savedMap[keyB]).toBeTruthy();
+        expect(savedMap[keyA]).not.toBe(savedMap[keyB]);
+        const conversationStore = service.orchestrator.getConversationStore();
+        const conversationA = conversationStore.get(savedMap[keyA]);
+        const conversationB = conversationStore.get(savedMap[keyB]);
+        expect(conversationA?.messages.map((message) => message.content)).toEqual([
+            'hello from a',
+            'reply:hello from a',
+            'follow up from a',
+            'reply:follow up from a',
+        ]);
+        expect(conversationB?.messages.map((message) => message.content)).toEqual([
+            'hello from b',
+            'reply:hello from b',
+        ]);
+        await service.shutdown();
+    });
+});
+//# sourceMappingURL=service.integration.test.js.map

package/dist/service.integration.test.js.map

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

package/dist/service.js

@@ -15,7 +15,16 @@ import { GatewayServer, GatewayNodeClient, createProxyTools } from '@cereworker/
 import { buildCerebellumComposeCommand, buildCerebellumComposeEnv, resolveCerebellumDockerModel, } from './cerebellum-docker.js';
 import { buildChannelConversationKey, loadChannelConversationState, saveChannelConversationState, } from './channel-conversations.js';
 const log = createLogger('service');
-export function createService(config) {
+export function createService(config, deps = {}) {
+    const execSyncImpl = deps.execSync ?? execSync;
+    const execFileSyncImpl = deps.execFileSync ?? execFileSync;
+    const spawnImpl = deps.spawn ?? spawn;
+    const homeDir = deps.homeDir ?? homedir;
+    const createCerebrumImpl = deps.createCerebrum
+        ?? ((providerConfig, options) => new CerebrumProvider(providerConfig, options));
+    const createChannelManagerImpl = deps.createChannelManager ?? createChannelManager;
+    const createCerebellumClientImpl = deps.createCerebellumClient
+        ?? ((address) => new CerebellumClient(address));
     // Create persistent conversation store
     const conversationStore = new ConversationStore();
     // Instance identity
@@ -62,7 +71,7 @@ export function createService(config) {
         maxSteps: config.cerebrum.maxSteps,
         temperature: config.cerebrum.temperature,
     };
-    const cerebrum = new CerebrumProvider(cerebrumConfig, {
+    const cerebrum = createCerebrumImpl(cerebrumConfig, {
         denyList: config.tools.shell.denyList,
         timeout: config.tools.shell.timeout,
         maxOutputSize: config.tools.shell.maxOutputSize,
@@ -86,7 +95,7 @@ export function createService(config) {
     const skillRegistry = new SkillRegistry();
     const skillDirs = [
         ...config.skills.directories,
-        join(homedir(), '.cereworker', 'skills'),
+        join(homeDir(), '.cereworker', 'skills'),
         join(process.cwd(), 'skills'),
     ];
     const allSkills = loadSkills(skillDirs);
@@ -104,7 +113,7 @@ export function createService(config) {
         log.info('Recurring tasks configured', { count: enabledTasks.length });
     }
     // Load persisted task state (conversationId mappings)
-    const taskStateFile = join(homedir(), '.cereworker', 'task-state.json');
+    const taskStateFile = join(homeDir(), '.cereworker', 'task-state.json');
     let taskState = {};
     try {
         if (existsSync(taskStateFile)) {
@@ -129,7 +138,7 @@ export function createService(config) {
             log.warn('Failed to save task state', { error: err.message });
         }
     }
-    const channelConversationStateFile = join(homedir(), '.cereworker', 'channel-conversations.json');
+    const channelConversationStateFile = join(homeDir(), '.cereworker', 'channel-conversations.json');
     let channelConversationState = loadChannelConversationState(channelConversationStateFile);
     for (const [sessionKey, conversationId] of Object.entries(channelConversationState)) {
         if (!conversationStore.get(conversationId)) {
@@ -296,7 +305,7 @@ export function createService(config) {
         }
     }
     // Create channel manager
-    const channelManager = createChannelManager(config, CHANNEL_COMMANDS);
+    const channelManager = createChannelManagerImpl(config, CHANNEL_COMMANDS);
     // Create pairing store and wire to channel manager
     const pairingStore = new PairingStore();
     channelManager.setDmPolicy(config.channels.dmPolicy);
@@ -373,7 +382,7 @@ export function createService(config) {
             log.info('Discovery completed, instance profile updated', { name: result.name });
             // Write training pairs from the discovery conversation to pending.jsonl
             try {
-                const pendingPath = join(homedir(), '.cereworker', 'finetune', 'pending.jsonl');
+                const pendingPath = join(homeDir(), '.cereworker', 'finetune', 'pending.jsonl');
                 mkdirSync(dirname(pendingPath), { recursive: true });
                 const messages = orchestrator.getMessages();
                 for (let i = 0; i < messages.length - 1; i++) {
@@ -457,14 +466,14 @@ export function createService(config) {
         // Check if Docker is installed (check PATH, then common locations)
         let dockerBin = '';
         try {
-            dockerBin = execSync('which docker', { stdio: 'pipe' }).toString().trim();
+            dockerBin = execSyncImpl('which docker', { stdio: 'pipe' }).toString().trim();
         }
         catch {
             // Not in PATH — check common install locations
             const candidates = ['/usr/bin/docker', '/usr/local/bin/docker', '/snap/bin/docker'];
             for (const c of candidates) {
                 try {
-                    execSync(`test -x ${c}`, { stdio: 'pipe' });
+                    execSyncImpl(`test -x ${c}`, { stdio: 'pipe' });
                     dockerBin = c;
                     break;
                 }
@@ -477,7 +486,7 @@ export function createService(config) {
         }
         // Try without sudo first
         try {
-            execSync(`${dockerBin} info`, { stdio: 'pipe', timeout: 10_000 });
+            execSyncImpl(`${dockerBin} info`, { stdio: 'pipe', timeout: 10_000 });
             return true;
         }
         catch (err) {
@@ -486,9 +495,9 @@ export function createService(config) {
             if (msg.includes('Is the docker daemon running') || msg.includes('Cannot connect to the Docker daemon')) {
                 // Try to start the service
                 try {
-                    execSync('sudo -n systemctl start docker', { stdio: 'pipe', timeout: 15_000 });
+                    execSyncImpl('sudo -n systemctl start docker', { stdio: 'pipe', timeout: 15_000 });
                     log.info('Started Docker service');
-                    execSync(`${dockerBin} info`, { stdio: 'pipe', timeout: 10_000 });
+                    execSyncImpl(`${dockerBin} info`, { stdio: 'pipe', timeout: 10_000 });
                     return true;
                 }
                 catch {
@@ -498,7 +507,7 @@ export function createService(config) {
             }
             // Permission denied — try with sudo
             try {
-                execSync(`sudo -n ${dockerBin} info`, { stdio: 'pipe', timeout: 10_000 });
+                execSyncImpl(`sudo -n ${dockerBin} info`, { stdio: 'pipe', timeout: 10_000 });
                 dockerPrefix = 'sudo ';
                 log.info('Using sudo for Docker commands (add user to docker group to avoid this)');
                 return true;
@@ -508,7 +517,7 @@ export function createService(config) {
                 const user = process.env.USER || process.env.LOGNAME;
                 if (user) {
                     try {
-                        execSync(`sudo -n usermod -aG docker ${user}`, { stdio: 'pipe' });
+                        execSyncImpl(`sudo -n usermod -aG docker ${user}`, { stdio: 'pipe' });
                         dockerPrefix = 'sudo ';
                         log.info('Added user to docker group. Using sudo for this session — re-login to use Docker without sudo.');
                         return true;
@@ -525,13 +534,13 @@ export function createService(config) {
     function ensureImageExists() {
         const image = config.cerebellum.docker.image;
         try {
-            const exists = execSync(`${dockerPrefix}docker images -q ${image}`, { stdio: 'pipe' }).toString().trim();
+            const exists = execSyncImpl(`${dockerPrefix}docker images -q ${image}`, { stdio: 'pipe' }).toString().trim();
             if (exists) {
                 // Image exists — try background pull for updates (non-blocking)
                 try {
                     const pullCmd = dockerPrefix ? 'sudo' : 'docker';
                     const pullArgs = dockerPrefix ? ['docker', 'pull', image] : ['pull', image];
-                    const child = spawn(pullCmd, pullArgs, { stdio: ['ignore', 'pipe', 'ignore'], detached: true });
+                    const child = spawnImpl(pullCmd, pullArgs, { stdio: ['ignore', 'pipe', 'ignore'], detached: true });
                     child.unref();
                     let pullOutput = '';
                     child.stdout?.on('data', (data) => { pullOutput += data.toString(); });
@@ -553,7 +562,7 @@ export function createService(config) {
         // Image missing — pull synchronously
         try {
             log.info(`Pulling Cerebellum image ${image} from Docker Hub...`);
-            execSync(`${dockerPrefix}docker pull ${image}`, { stdio: 'pipe', timeout: 3_600_000 });
+            execSyncImpl(`${dockerPrefix}docker pull ${image}`, { stdio: 'pipe', timeout: 3_600_000 });
             log.info('Cerebellum image pulled from Docker Hub');
             return true;
         }
@@ -565,7 +574,7 @@ export function createService(config) {
         if (composeFile) {
             log.info('Building Cerebellum Docker image from source...');
             try {
-                execSync(`${dockerPrefix}docker compose -f "${composeFile}" build cerebellum`, {
+                execSyncImpl(`${dockerPrefix}docker compose -f "${composeFile}" build cerebellum`, {
                     cwd: dirname(composeFile),
                     stdio: 'pipe',
                     timeout: 600_000,
@@ -586,7 +595,7 @@ export function createService(config) {
         const resolvedModel = resolveCerebellumDockerModel(config);
         const getConfiguredModelPath = () => {
             try {
-                const envLines = execSync(`${dockerPrefix}docker inspect -f "{{range .Config.Env}}{{println .}}{{end}}" cereworker-cerebellum`, { stdio: 'pipe' }).toString().trim().split('\n');
+                const envLines = execSyncImpl(`${dockerPrefix}docker inspect -f "{{range .Config.Env}}{{println .}}{{end}}" cereworker-cerebellum`, { stdio: 'pipe' }).toString().trim().split('\n');
                 const modelLine = envLines.find((line) => line.startsWith('MODEL_PATH='));
                 return modelLine ? modelLine.slice('MODEL_PATH='.length) : null;
             }
@@ -596,7 +605,7 @@ export function createService(config) {
         };
         // Check if already running
         try {
-            const out = execSync(`${dockerPrefix}docker ps -q -f name=cereworker-cerebellum`, {
+            const out = execSyncImpl(`${dockerPrefix}docker ps -q -f name=cereworker-cerebellum`, {
                 stdio: 'pipe',
             }).toString().trim();
             if (out) {
@@ -609,20 +618,20 @@ export function createService(config) {
         }
         // Check if container exists but stopped
         try {
-            const stopped = execSync(`${dockerPrefix}docker ps -aq -f name=cereworker-cerebellum`, {
+            const stopped = execSyncImpl(`${dockerPrefix}docker ps -aq -f name=cereworker-cerebellum`, {
                 stdio: 'pipe',
             }).toString().trim();
             if (stopped) {
                 const configuredModelPath = getConfiguredModelPath();
                 if (configuredModelPath && configuredModelPath !== resolvedModel.modelPath) {
-                    execSync(`${dockerPrefix}docker rm -f cereworker-cerebellum`, { stdio: 'pipe' });
+                    execSyncImpl(`${dockerPrefix}docker rm -f cereworker-cerebellum`, { stdio: 'pipe' });
                     log.info('Removed stale Cerebellum container to refresh model path', {
                         previousModelPath: configuredModelPath,
                         nextModelPath: resolvedModel.modelPath,
                     });
                 }
                 else {
-                    execSync(`${dockerPrefix}docker start cereworker-cerebellum`, { stdio: 'pipe' });
+                    execSyncImpl(`${dockerPrefix}docker start cereworker-cerebellum`, { stdio: 'pipe' });
                     log.info('Restarted stopped Cerebellum container');
                     return true;
                 }
@@ -640,7 +649,7 @@ export function createService(config) {
             try {
                 const composeEnv = buildCerebellumComposeEnv(config);
                 const command = buildCerebellumComposeCommand(composeFile, composeEnv, Boolean(dockerPrefix));
-                execFileSync(command.command, command.args, {
+                execFileSyncImpl(command.command, command.args, {
                     ...(command.env ? { env: command.env } : {}),
                     stdio: 'pipe',
                     cwd: dirname(composeFile),
@@ -660,11 +669,11 @@ export function createService(config) {
             const port = config.cerebellum.address.split(':')[1] ?? '50051';
             // Use host models directory if it exists (pre-downloaded during onboarding),
             // otherwise fall back to Docker named volume
-            const modelsPath = config.cerebellum.docker.modelsPath.replace(/^~/, homedir());
+            const modelsPath = config.cerebellum.docker.modelsPath.replace(/^~/, homeDir());
             const modelsVolume = existsSync(modelsPath)
                 ? `"${modelsPath}":/root/.cache/huggingface`
                 : 'cerebellum-models:/root/.cache/huggingface';
-            execSync(`${dockerPrefix}docker run -d --name cereworker-cerebellum` +
+            execSyncImpl(`${dockerPrefix}docker run -d --name cereworker-cerebellum` +
                 ` -p ${port}:50051` +
                 ` -e MODEL_PATH=${modelId}` +
                 ` -e HEARTBEAT_INTERVAL=${interval}` +
@@ -691,10 +700,10 @@ export function createService(config) {
             if (!isDockerAvailable()) {
                 // Determine specific reason
                 try {
-                    execSync('which docker', { stdio: 'pipe' });
+                    execSyncImpl('which docker', { stdio: 'pipe' });
                     // Docker binary found but daemon not running or permission denied
                     try {
-                        execSync('docker info', { stdio: 'pipe', timeout: 5000 });
+                        execSyncImpl('docker info', { stdio: 'pipe', timeout: 5000 });
                     }
                     catch (e) {
                         const msg = e.message;
@@ -715,7 +724,7 @@ export function createService(config) {
             else if (!ensureDockerRunning()) {
                 // Gather container logs for diagnostics
                 try {
-                    const logs = execSync(`${dockerPrefix}docker logs --tail 20 cereworker-cerebellum 2>&1`, { stdio: 'pipe', timeout: 5000 }).toString().trim();
+                    const logs = execSyncImpl(`${dockerPrefix}docker logs --tail 20 cereworker-cerebellum 2>&1`, { stdio: 'pipe', timeout: 5000 }).toString().trim();
                     dockerReason = `Container failed to start.\nLast logs:\n${logs}`;
                 }
                 catch {
@@ -726,7 +735,7 @@ export function createService(config) {
         // Connect gRPC client with retries
         // First run downloads model weights (~1.2 GB for Qwen3 0.6B) and loads them,
         // which can take 2-5 minutes depending on network and hardware.
-        const client = new CerebellumClient(config.cerebellum.address);
+        const client = createCerebellumClientImpl(config.cerebellum.address);
         const maxRetries = 60;
         const retryDelay = 5000;
         let lastError = '';
@@ -769,7 +778,7 @@ export function createService(config) {
             else {
                 // Docker started fine but gRPC failed — grab container logs for clues
                 try {
-                    const logs = execSync(`${dockerPrefix}docker logs --tail 20 cereworker-cerebellum 2>&1`, { stdio: 'pipe', timeout: 5000 }).toString().trim();
+                    const logs = execSyncImpl(`${dockerPrefix}docker logs --tail 20 cereworker-cerebellum 2>&1`, { stdio: 'pipe', timeout: 5000 }).toString().trim();
                     if (logs)
                         parts.push(`Container logs:\n${logs}`);
                 }