@chozzz/vargos 3.1.5 → 3.2.1

package/dist/scripts/verify-core.js

@@ -0,0 +1,191 @@
+/**
+ * Acceptance verification for the re-architected core. Loads real service modules
+ * from a temp dir through the actual ServiceLoader, exercises all three surfaces
+ * (CLI projection, agent-tool projection, JSON-RPC), reloads from disk, and checks
+ * bus semantics + dispose discipline. Run: pnpm tsx scripts/verify-core.ts
+ */
+import { mkdtempSync, writeFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { createConnection } from 'node:net';
+import { z } from 'zod';
+import { EmitterBus } from '../core/bus.js';
+import { ServiceLoader } from '../core/loader.js';
+import { startRpcServer } from '../core/rpc-server.js';
+import { buildParams, renderHelp, RpcClient } from '../core/cli.js';
+import { bootLocal } from '../core/local.js';
+import { MethodNotFoundError } from '../core/errors.js';
+let pass = 0, fail = 0;
+function ok(label, cond, detail = '') {
+    console.log(`${cond ? '  ✅' : '  ❌'} ${label}${detail ? ` — ${detail}` : ''}`);
+    if (cond)
+        pass++;
+    else
+        fail++;
+}
+const dir = mkdtempSync(path.join(tmpdir(), 'vargos-verify-'));
+const g = globalThis;
+g.__ticks = 0;
+const channelV1 = `
+export function createService() {
+  let timer;
+  return {
+    name: 'channel',
+    init(bus) {
+      bus.register('channel.send', {
+        description: 'Send a message via a channel',
+        schema: { safeParse: (p) => (p && typeof p.recipient === 'string' && typeof p.message === 'string')
+          ? { success: true, data: p }
+          : { success: false, error: { issues: [{ path: ['message'], message: 'Required' }] } } },
+        cli: { positional: ['recipient', 'message'] },
+      }, (p) => ({ sent: true, via: 'v1', to: p.recipient, text: p.message }));
+      timer = setInterval(() => { globalThis.__ticks++; }, 25);
+    },
+    dispose() { clearInterval(timer); },
+  };
+}
+`;
+// v2: changed return value (D1), removed channel.send, added channel.ping (D3).
+const channelV2 = `
+export function createService() {
+  let timer;
+  return {
+    name: 'channel',
+    init(bus) {
+      bus.register('channel.ping', {
+        description: 'Ping',
+        schema: { safeParse: (p) => ({ success: true, data: p ?? {} }) },
+      }, () => ({ via: 'v2', pong: true }));
+      timer = setInterval(() => { globalThis.__ticks++; }, 25);
+    },
+    dispose() { clearInterval(timer); },
+  };
+}
+`;
+const memory = `
+export function createService() {
+  return {
+    name: 'memory',
+    init(bus) {
+      bus.register('memory.search', {
+        description: 'Search memory',
+        schema: { safeParse: (p) => (p && typeof p.query === 'string')
+          ? { success: true, data: p }
+          : { success: false, error: { issues: [{ path: ['query'], message: 'Required' }] } } },
+        cli: { positional: ['query'] },
+      }, (p) => [{ citation: 'MEMORY.md', content: 'found: ' + p.query }]);
+    },
+    dispose() {},
+  };
+}
+`;
+const chanPath = path.join(dir, 'channel.mjs');
+const memPath = path.join(dir, 'memory.mjs');
+writeFileSync(chanPath, channelV1);
+writeFileSync(memPath, memory);
+const rpcCall = (port, body) => new Promise((resolve, reject) => {
+    const s = createConnection({ host: '127.0.0.1', port }, () => s.write(JSON.stringify(body) + '\n'));
+    let buf = '';
+    s.on('data', (d) => { buf += d; if (buf.includes('\n')) {
+        s.end();
+        resolve(JSON.parse(buf.split('\n')[0]));
+    } });
+    s.on('error', reject);
+});
+async function main() {
+    const pid = process.pid;
+    const bus = new EmitterBus();
+    const loader = new ServiceLoader(bus);
+    await loader.load({ name: 'channel', modulePath: chanPath });
+    await loader.load({ name: 'memory', modulePath: memPath });
+    console.log('\nA. Centralization — one registration, three surfaces');
+    const list = bus.list();
+    const send = list.find(m => m.name === 'channel.send');
+    ok('A1 channel.send in registry/CLI list with description', !!send && send.description === 'Send a message via a channel');
+    ok('A1 --help renders description + arg shape', renderHelp('channel', bus.list('channel')).includes('Send a message via a channel'));
+    const sendRes = await bus.call('channel.send', { recipient: 'telegram:42', message: 'hi' });
+    ok('A2 invocable via bus/CLI path', JSON.stringify(sendRes) === JSON.stringify({ sent: true, via: 'v1', to: 'telegram:42', text: 'hi' }));
+    const rpcStop = await startRpcServer(bus, '127.0.0.1', 19099);
+    const r = await rpcCall(19099, { jsonrpc: '2.0', method: 'channel.send', params: { recipient: 'x', message: 'y' }, id: 1 });
+    ok('A3 invocable via JSON-RPC', r.result?.sent === true, JSON.stringify(r.result));
+    const agentTools = bus.list().filter(m => !m.internal); // agent-tool projection
+    ok('A4 present in agent tool list with matching description', agentTools.some(m => m.name === 'channel.send' && m.description === send.description));
+    console.log('\nB. CLI introspection');
+    ok('B1 vargos <service> lists exactly that service', bus.list('channel').every(m => m.service === 'channel') && bus.list('channel').length === 1);
+    // B2 with a real zod schema (the fake schema above can't be converted to JSON Schema):
+    const zbus = new EmitterBus();
+    zbus.register('demo.send', {
+        description: 'Send a message via a channel',
+        schema: z.object({ recipient: z.string(), message: z.string() }),
+        cli: { positional: ['recipient', 'message'] },
+    }, () => ({}));
+    ok('B2 --help shows arg shape from registry', /<recipient>.*<message>/s.test(renderHelp('demo', zbus.list('demo'))));
+    ok('B3 positional args map to schema keys', JSON.stringify(buildParams(send, ['telegram:7', 'hello'])) === JSON.stringify({ recipient: 'telegram:7', message: 'hello' }));
+    let usageErr = '';
+    try {
+        buildParams(send, ['a', 'b', 'c']);
+    }
+    catch (e) {
+        usageErr = e.message;
+    }
+    ok('B3 wrong arg count → clear usage error (not stack trace)', usageErr.includes('too many arguments'));
+    // B4: same validation error on every surface
+    let directErr = '';
+    try {
+        await bus.call('channel.send', { recipient: 'only' });
+    }
+    catch (e) {
+        directErr = e.message;
+    }
+    const rpcErr = await rpcCall(19099, { jsonrpc: '2.0', method: 'channel.send', params: { recipient: 'only' }, id: 2 });
+    ok('B4 same validation error on direct + RPC', directErr.includes('Invalid params') && rpcErr.error?.code === -32602, `${directErr} | rpc=${rpcErr.error?.code}`);
+    console.log('\nC. Bus semantics');
+    let notFound;
+    try {
+        await bus.call('nope.missing');
+    }
+    catch (e) {
+        notFound = e;
+    }
+    ok('C1 call unregistered → MethodNotFoundError', notFound instanceof MethodNotFoundError && notFound.code === -32601);
+    const rpcMissing = await rpcCall(19099, { jsonrpc: '2.0', method: 'nope.missing', params: {}, id: 3 });
+    ok('C1 RPC returns -32601', rpcMissing.error?.code === -32601);
+    let emitThrew = false;
+    try {
+        bus.emit('event.with.no.listeners', { a: 1 });
+    }
+    catch {
+        emitThrew = true;
+    }
+    ok('C2 emit with no listeners is a silent no-op', !emitThrew);
+    console.log('\nD. Hot in-process reload (same PID)');
+    await new Promise(r => setTimeout(r, 120));
+    const ticksBefore = g.__ticks;
+    writeFileSync(chanPath, channelV2); // git pull simulation
+    await loader.restart('channel');
+    ok('D1 same PID across reload', process.pid === pid);
+    const afterList = bus.list('channel');
+    ok('D1 new code observed (return value changed v1→v2)', JSON.stringify(await bus.call('channel.ping')) === JSON.stringify({ via: 'v2', pong: true }));
+    ok('D3 added method appears on all surfaces', afterList.some(m => m.name === 'channel.ping') && (await rpcCall(19099, { jsonrpc: '2.0', method: 'channel.ping', id: 4 })).result?.pong === true);
+    ok('D3 removed method disappears from all surfaces', !bus.has('channel.send') && (await rpcCall(19099, { jsonrpc: '2.0', method: 'channel.send', params: {}, id: 5 })).error?.code === -32601);
+    ok('D4 other service untouched (memory still works)', JSON.stringify(await bus.call('memory.search', { query: 'z' })) === JSON.stringify([{ citation: 'MEMORY.md', content: 'found: z' }]));
+    // D2: old interval cleared on dispose → exactly one timer running, not two.
+    const t1 = g.__ticks;
+    await new Promise(r => setTimeout(r, 250));
+    const rate = (g.__ticks - t1) / 0.25; // ticks/sec
+    ok('D2 no duplicate timers after reload (≈40/s, one interval)', rate > 20 && rate < 60, `${rate.toFixed(0)}/s`);
+    void ticksBefore;
+    await rpcStop();
+    console.log('\nE. CLI ↔ daemon coexistence');
+    const client = new RpcClient('127.0.0.1', 19098);
+    ok('E2 no daemon → isUp() false', !(await client.isUp()));
+    const stack = await bootLocal(['config'], path.resolve('.'), 'ts'); // boots real config service locally
+    ok('E2 local stack boots only needed services (config)', stack.bus.list('config').some(m => m.name === 'config.get'));
+    await stack.dispose();
+    ok('E2 local stack disposes cleanly', true);
+    rmSync(dir, { recursive: true, force: true });
+    console.log(`\n${fail === 0 ? '✅ ALL PASS' : '❌ FAILURES'} — ${pass} passed, ${fail} failed\n`);
+    process.exit(fail === 0 ? 0 : 1);
+}
+main().catch(err => { console.error(err); process.exit(1); });
+//# sourceMappingURL=verify-core.js.map

package/dist/scripts/verify-core.js.map

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

package/dist/services/agent/index.d.ts

@@ -7,12 +7,11 @@
  * - Debug mode for inspecting tools, prompts, history
  * - Streaming events passthrough to bus (agent.onDelta, agent.onTool, agent.onCompleted)
  */
-import type { Bus } from '../../gateway/bus.js';
-import type { EventMap } from '../../gateway/events.js';
+import type { Bus, Service } from '../../core/types.js';
 import type { AppConfig } from '../../services/config/index.js';
-import type { AgentDeps } from './types.js';
 import { SettingsManager, AuthStorage, ModelRegistry, DefaultResourceLoader, type AgentSession, type ToolDefinition, type CreateAgentSessionOptions, type CreateAgentSessionResult } from '@earendil-works/pi-coding-agent';
-export declare class AgentService {
+export declare class AgentService implements Service {
+    readonly name = "agent";
     protected bus: Bus;
     protected config: AppConfig;
     protected sessions: Map<string, AgentSession>;
@@ -23,32 +22,32 @@ export declare class AgentService {
     protected authStorage: AuthStorage;
     protected modelRegistry: ModelRegistry;
     protected settings: SettingsManager;
-    constructor(deps: AgentDeps);
+    init(bus: Bus): Promise<void>;
+    private registerMethods;
+    dispose(): void;
     /**
      * Persist retry settings to disk during boot
      */
-    start(): Promise<void>;
+    private persistRetrySettings;
     /**
-     * agent.execute — Run a task
-     *
-     * Note: sessionKey is declared optional here because it's auto-injected by
-     * wrapEventAsToolDefinition() when the agent calls this as a tool. Direct callers
-     * (channels, cron, webhooks, TCP) still provide sessionKey via EventMap.
+     * agent.execute — Run a task. `sessionKey` is auto-injected by the tool wrapper when
+     * the agent calls this as a tool; direct callers (channels, cron, webhooks, RPC)
+     * supply it. It survives validation via the schema's .passthrough().
      */
-    execute(params: EventMap['agent.execute']['params']): Promise<EventMap['agent.execute']['result']>;
+    private execute;
     /**
      * agent.appendMessage — Append message to session JSONL without executing agent.
      * Records inbound messages in session history (observe-only for non-whitelisted).
      * Internal only — not exposed as an agent tool.
      */
-    appendMessage(params: EventMap['agent.appendMessage']['params']): Promise<void>;
+    private appendMessage;
     /**
      * agent.status — Inventory cached sessions (parents, subagents, idle) with their
      * run state, parent relationship, and model. When `sessionKey` is given, the result
      * is scoped to that session and its subagents — letting a parent observe its own
      * subtree. `activeRuns` is kept for callers that only need the executing keys.
      */
-    status(params: EventMap['agent.status']['params']): Promise<EventMap['agent.status']['result']>;
+    private status;
     /**
      * Get or create AgentSession for sessionKey.
      * Uses SessionManager.continueRecent() to load the latest session file,
@@ -112,9 +111,6 @@ export declare class AgentService {
      * `stopReason`/`errorMessage` here, those would surface as silent empty completions.
      */
     private extractFinalAssistant;
-    stop(): void;
 }
-export declare function boot(bus: Bus): Promise<{
-    stop(): void;
-}>;
+export declare function createService(): Service;
 //# sourceMappingURL=index.d.ts.map

package/dist/services/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../services/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAQ,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAMhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,OAAO,EAGL,eAAe,EACf,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAoBzC,qBAAa,YAAY;IACvB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IACnB,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC;IAC5B,SAAS,CAAC,QAAQ,4BAAmC;IACrD,mFAAmF;IACnF,SAAS,CAAC,WAAW,sBAA6B;IAClD,SAAS,CAAC,UAAU,cAAqB;IAEzC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;IACnC,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,SAAS,CAAC,QAAQ,EAAE,eAAe,CAAC;gBAExB,IAAI,EAAE,SAAS;IAuC3B;;OAEG;IACG,KAAK;IAyBX;;;;;;OAMG;IAaG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,CAAC;IA2CxG;;;;OAIG;IAEG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCrF;;;;;OAKG;IAKG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAC;IAkBrG;;;;OAIG;cACa,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAqEzH;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIhG;;;OAGG;YACW,kBAAkB;IAQhC,wFAAwF;IACxF,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,SAAS,CAAC,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAsEnF;;;OAGG;cACa,oBAAoB,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAsBjH;;;;;OAKG;YACW,oBAAoB;IAQlC;;;;;;;OAOG;YACW,eAAe;IAsD7B;;;;OAIG;cACa,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IASzG;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAuC7B,IAAI,IAAI,IAAI;CAOb;AAID,wBAAsB,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC;IAAE,IAAI,IAAI,IAAI,CAAA;CAAE,CAAC,CAM9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../services/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAQ,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAWhE,OAAO,EAGL,eAAe,EACf,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AA4BzC,qBAAa,YAAa,YAAW,OAAO;IAC1C,QAAQ,CAAC,IAAI,WAAW;IACxB,SAAS,CAAC,GAAG,EAAG,GAAG,CAAC;IACpB,SAAS,CAAC,MAAM,EAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,QAAQ,4BAAmC;IACrD,mFAAmF;IACnF,SAAS,CAAC,WAAW,sBAA6B;IAClD,SAAS,CAAC,UAAU,cAAqB;IAEzC,SAAS,CAAC,QAAQ,EAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,WAAW,EAAG,WAAW,CAAC;IACpC,SAAS,CAAC,aAAa,EAAG,aAAa,CAAC;IACxC,SAAS,CAAC,QAAQ,EAAG,eAAe,CAAC;IAE/B,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCnC,OAAO,CAAC,eAAe;IA0BvB,OAAO,IAAI,IAAI;IAMf;;OAEG;YACW,oBAAoB;IAyBlC;;;;OAIG;YACW,OAAO;IA2CrB;;;;OAIG;YACW,aAAa;IAoC3B;;;;;OAKG;YACW,MAAM;IAkBpB;;;;OAIG;cACa,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAqEzH;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIhG;;;OAGG;YACW,kBAAkB;IAQhC,wFAAwF;IACxF,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,SAAS,CAAC,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAqEnF;;;OAGG;cACa,oBAAoB,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAsBjH;;;;;OAKG;YACW,oBAAoB;IAQlC;;;;;;;OAOG;YACW,eAAe;IAsD7B;;;;OAIG;cACa,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IASzG;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CAoC9B;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}