@nac3/forge-cli 0.2.0-alpha.9 → 0.2.1-alpha.60

package/dist/agents/runtime.js

@@ -0,0 +1,429 @@
+/**
+ * Agent runtime (Director sprint slice 4).
+ *
+ * Thin event-loop scheduler that lives inside `yf chat`. Walks
+ * the registered agents on each tick, fires due work (cron tick,
+ * bridge inbox drain), and exposes a typed event stream that the
+ * panel SSE will tap into in slice 5.
+ *
+ * Contracts:
+ *  - createRuntime(opts) -> Runtime { start, stop, status,
+ *      dispatchAgent, tickNow, on('event', cb) }.
+ *  - start() / stop() are idempotent.
+ *  - dispatchAgent(slug, reason) runs the real (or DI-injected)
+ *    runner + returns the AgentRun row. Refuses when:
+ *      * runtime not started
+ *      * slug not registered
+ *      * agent status='paused' or 'deleted' or 'auto_revoked'
+ *  - Tick interval comes from opts.tickIntervalMs OR
+ *    getAgentConfig('agent.runtime.tick_interval_ms') if added,
+ *    else 5000ms default.
+ *  - State persists to ~/.yujin-forge/runtime.json (last_tick_at).
+ *
+ * Zero LLM calls -- runner is injected for tests. Real binding
+ * happens in `yf chat` startup.
+ *
+ * ASCII-only.
+ */
+import { promises as fs, readFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { EventEmitter } from 'node:events';
+import { listAgentDefinitions, getAgentDefinition } from './store.js';
+import { drainInbox } from './bridge.js';
+import { getAgentConfig } from './config_resolver.js';
+function defaultRoot() {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    return path.join(home, '.yujin-forge');
+}
+const EMPTY_STATE = { version: 1, last_tick_at: null };
+function readStateSync(root) {
+    try {
+        const file = path.join(root, 'runtime.json');
+        if (!existsSync(file))
+            return { ...EMPTY_STATE };
+        const raw = readFileSync(file, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed && parsed.version === 1)
+            return parsed;
+    }
+    catch { /* missing */ }
+    return { ...EMPTY_STATE };
+}
+async function writeState(root, state) {
+    await fs.mkdir(root, { recursive: true });
+    const file = path.join(root, 'runtime.json');
+    const tmp = file + '.tmp';
+    await fs.writeFile(tmp, JSON.stringify(state, null, 2), 'utf-8');
+    await fs.rename(tmp, file);
+}
+export function createRuntime(opts = {}) {
+    const root = opts.root ?? defaultRoot();
+    const clock = opts.clock ?? Date.now;
+    const tickIntervalMs = clamp(typeof opts.tickIntervalMs === 'number' ? opts.tickIntervalMs : 5000, 1000, 60_000);
+    const emitter = new EventEmitter();
+    let running = false;
+    /* Sync-load persisted state at construction so status() is
+     * truthful immediately after createRuntime() -- the "restart
+     * reads previous tick" test depends on this. */
+    let lastTickAt = readStateSync(root).last_tick_at;
+    let pendingTimer = null;
+    /* Slice 2 N-projects sprint -- concurrency semaphores.
+     * Increment on dispatch entry, decrement on exit. Two scopes:
+     * - global: total runs in-flight across all projects.
+     * - per-project: per-slug counter. */
+    let globalRunning = 0;
+    const perProjectRunning = new Map();
+    /* Cached caps. Refreshed lazily on each acquire (cheap; config
+     * resolver has its own 5s cache). */
+    let cachedGlobalCap = 6;
+    let cachedPerProjectCap = 2;
+    /* Wait queue: every blocked acquire pushes a {resolve, scope}
+     * onto its scope's array. release() pops + resolves the oldest. */
+    const globalWaiters = [];
+    const projectWaiters = new Map();
+    async function refreshCaps() {
+        try {
+            cachedGlobalCap = await getAgentConfig('agent.runtime.max_concurrent_runs_global');
+        }
+        catch { /* keep last */ }
+        try {
+            cachedPerProjectCap = await getAgentConfig('agent.runtime.max_concurrent_runs_per_project');
+        }
+        catch { /* keep last */ }
+    }
+    async function acquireSlot(slug, project_slug) {
+        await refreshCaps();
+        /* Global gate */
+        while (globalRunning >= cachedGlobalCap) {
+            emit({
+                kind: 'agent_run_throttled',
+                slug, project_slug,
+                scope: 'global',
+                running: globalRunning, cap: cachedGlobalCap,
+                at: clock(),
+            });
+            await new Promise((resolve) => globalWaiters.push(resolve));
+            await refreshCaps();
+        }
+        /* Per-project gate */
+        while ((perProjectRunning.get(project_slug) ?? 0) >= cachedPerProjectCap) {
+            const cur = perProjectRunning.get(project_slug) ?? 0;
+            emit({
+                kind: 'agent_run_throttled',
+                slug, project_slug,
+                scope: 'per_project',
+                running: cur, cap: cachedPerProjectCap,
+                at: clock(),
+            });
+            let waiters = projectWaiters.get(project_slug);
+            if (!waiters) {
+                waiters = [];
+                projectWaiters.set(project_slug, waiters);
+            }
+            const local = waiters;
+            await new Promise((resolve) => local.push(resolve));
+            await refreshCaps();
+        }
+        globalRunning++;
+        perProjectRunning.set(project_slug, (perProjectRunning.get(project_slug) ?? 0) + 1);
+    }
+    function releaseSlot(project_slug) {
+        globalRunning = Math.max(0, globalRunning - 1);
+        const cur = perProjectRunning.get(project_slug) ?? 0;
+        if (cur <= 1)
+            perProjectRunning.delete(project_slug);
+        else
+            perProjectRunning.set(project_slug, cur - 1);
+        /* Wake waiters fairly. Per-project first (more likely to
+         * unblock something useful) then global. */
+        const pw = projectWaiters.get(project_slug);
+        if (pw && pw.length > 0) {
+            const next = pw.shift();
+            if (pw.length === 0)
+                projectWaiters.delete(project_slug);
+            next();
+        }
+        if (globalWaiters.length > 0) {
+            const next = globalWaiters.shift();
+            next();
+        }
+    }
+    async function resolveRunner() {
+        if (opts.runner)
+            return opts.runner;
+        /* Lazy import to avoid circular + to allow tests to skip
+         * pulling Anthropic deps. */
+        const mod = await import('./runner.js');
+        /* Adapt the real runner shape to our (slug, reason) -> AgentRun
+         * contract. The real runner.ts exports `runAgent` with a wider
+         * signature; we adapt minimally. */
+        return async (slug, trigger_reason, opts) => {
+            if (typeof mod.runAgent === 'function') {
+                const run = await mod.runAgent;
+                return run(slug, trigger_reason, opts);
+            }
+            throw new Error('agents/runner.ts has no runAgent export');
+        };
+    }
+    function emit(e) {
+        emitter.emit('event', e);
+    }
+    async function persistState() {
+        await writeState(root, { version: 1, last_tick_at: lastTickAt });
+    }
+    async function tickNow() {
+        const now = clock();
+        lastTickAt = now;
+        emit({ kind: 'tick', at: now });
+        /* Drain inbox of every registered active agent. The runtime
+         * does not (yet) auto-dispatch the runner on drain; it emits
+         * the event so the panel / future Director can react. */
+        const defs = await listAgentDefinitions({ root });
+        for (const def of defs) {
+            if (def.status !== 'active')
+                continue;
+            try {
+                const r = await drainInbox(def.slug, { root, now: clock });
+                if (r.drained.length > 0) {
+                    emit({
+                        kind: 'bridge_drain',
+                        slug: def.slug,
+                        message_count: r.drained.length,
+                        at: now,
+                    });
+                }
+            }
+            catch { /* unregistered slugs throw -- ignore */ }
+        }
+        await persistState();
+    }
+    function scheduleTick() {
+        if (!running)
+            return;
+        pendingTimer = setTimeout(() => {
+            pendingTimer = null;
+            tickNow().catch(() => { })
+                .finally(() => scheduleTick());
+        }, tickIntervalMs);
+        /* Unref so a stray runtime does not block Node exit (tests). */
+        if (pendingTimer && typeof pendingTimer.unref === 'function') {
+            pendingTimer.unref();
+        }
+    }
+    function start() {
+        if (running)
+            return;
+        running = true;
+        scheduleTick();
+    }
+    async function stop() {
+        if (!running)
+            return;
+        running = false;
+        if (pendingTimer) {
+            clearTimeout(pendingTimer);
+            pendingTimer = null;
+        }
+        /* Flush any in-flight state. */
+        await persistState();
+    }
+    async function dispatchAgent(slug, trigger_reason, opts) {
+        if (!running) {
+            throw new Error('runtime not started -- call start() first');
+        }
+        const def = await getAgentDefinition(slug, { root });
+        if (!def) {
+            throw new Error('agent "' + slug + '" not registered');
+        }
+        /* Slice 1 of N-projects sprint -- default to 'self' so legacy
+         * single-project callers keep their behaviour. */
+        const project_slug = opts?.project_slug || 'self';
+        if (def.status !== 'active') {
+            emit({
+                kind: 'agent_run_skipped',
+                slug,
+                reason: 'agent status=' + def.status,
+                at: clock(),
+                project_slug,
+            });
+            throw new Error('agent "' + slug + '" is ' + def.status + ' -- not dispatched');
+        }
+        /* Slice 2 -- gate on global + per-project semaphores. */
+        await acquireSlot(slug, project_slug);
+        let run;
+        try {
+            emit({
+                kind: 'agent_run_started',
+                slug,
+                trigger_reason,
+                at: clock(),
+                project_slug,
+            });
+            const runner = await resolveRunner();
+            try {
+                run = await runner(slug, trigger_reason, { project_slug });
+            }
+            catch (err) {
+                emit({
+                    kind: 'agent_run_finished',
+                    slug,
+                    run_id: 'run-error',
+                    status: 'failed',
+                    at: clock(),
+                    project_slug,
+                });
+                throw err;
+            }
+            /* Make sure the AgentRun carries project_slug for downstream
+             * consumers (Activity feed, store JSON) even if the runner
+             * didn't already attach it. */
+            if (!run.project_slug)
+                run.project_slug = project_slug;
+            emit({
+                kind: 'agent_run_finished',
+                slug,
+                run_id: run.id,
+                status: run.status,
+                at: clock(),
+                project_slug,
+            });
+        }
+        finally {
+            releaseSlot(project_slug);
+        }
+        return run;
+    }
+    function status() {
+        const perProject = {};
+        for (const [k, v] of perProjectRunning.entries())
+            perProject[k] = v;
+        return {
+            running,
+            tick_interval_ms: tickIntervalMs,
+            last_tick_at: lastTickAt,
+            concurrency: {
+                global_running: globalRunning,
+                global_max: cachedGlobalCap,
+                per_project_running: perProject,
+                per_project_max: cachedPerProjectCap,
+            },
+        };
+    }
+    /* Special-case: when dispatchAgent throws for a 'paused' agent,
+     * we emit the skipped event but the test expects no throw. The
+     * test reads runnerCalls.length === 0 + checks the event. To
+     * avoid the throw breaking the test, we wrap. Actually re-read
+     * the test: `await rt.dispatchAgent('alpha', 'should-skip')` --
+     * does NOT expect.rejects. So the dispatch must RESOLVE for
+     * non-active agents. Fix: return a synthetic "skipped" run
+     * instead of throwing. */
+    async function dispatchAgentSoft(slug, trigger_reason, opts) {
+        if (!running) {
+            throw new Error('runtime not started -- call start() first');
+        }
+        const def = await getAgentDefinition(slug, { root });
+        if (!def) {
+            throw new Error('agent "' + slug + '" not registered');
+        }
+        const project_slug = opts?.project_slug || 'self';
+        if (def.status !== 'active') {
+            const now = clock();
+            emit({
+                kind: 'agent_run_skipped',
+                slug,
+                reason: 'agent status=' + def.status,
+                at: now,
+                project_slug,
+            });
+            return {
+                id: 'skipped-' + now,
+                slug,
+                trigger_kind: 'manual',
+                trigger_reason,
+                started_at: now,
+                ended_at: now,
+                status: 'failed',
+                tokens_in: 0,
+                tokens_out: 0,
+                tool_calls: 0,
+                rejected_approvals: 0,
+                last_reply_summary: 'skipped: ' + def.status,
+                kill_reason: 'agent not active (status=' + def.status + ')',
+                project_slug,
+            };
+        }
+        /* Slice 2 -- gate on semaphores. */
+        await acquireSlot(slug, project_slug);
+        let run;
+        try {
+            emit({
+                kind: 'agent_run_started',
+                slug,
+                trigger_reason,
+                at: clock(),
+                project_slug,
+            });
+            const runner = await resolveRunner();
+            try {
+                run = await runner(slug, trigger_reason, { project_slug });
+            }
+            catch (err) {
+                emit({
+                    kind: 'agent_run_finished',
+                    slug,
+                    run_id: 'run-error',
+                    status: 'failed',
+                    at: clock(),
+                    project_slug,
+                });
+                throw err;
+            }
+            if (!run.project_slug)
+                run.project_slug = project_slug;
+            emit({
+                kind: 'agent_run_finished',
+                slug,
+                run_id: run.id,
+                status: run.status,
+                at: clock(),
+                project_slug,
+            });
+        }
+        finally {
+            releaseSlot(project_slug);
+        }
+        return run;
+    }
+    /* Wire emitter passthrough. */
+    function on(event, cb) {
+        emitter.on(event, cb);
+    }
+    function off(event, cb) {
+        emitter.off(event, cb);
+    }
+    /* Suppress unused warning. dispatchAgent is the public path;
+     * dispatchAgentSoft is the actual implementation chosen. */
+    void dispatchAgent;
+    return {
+        start,
+        stop,
+        status,
+        dispatchAgent: dispatchAgentSoft,
+        tickNow,
+        on,
+        off,
+        getAgentsRoot: () => root,
+        emitExternal: (e) => { emit(e); },
+    };
+}
+function clamp(n, lo, hi) {
+    if (!Number.isFinite(n))
+        return lo;
+    if (n < lo)
+        return lo;
+    if (n > hi)
+        return hi;
+    return n;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/agents/runtime.js.map

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

package/dist/agents/store.d.ts

@@ -0,0 +1,33 @@
+import { type AgentDefinition, type AgentRun, type AgentDefinitionStatus } from './types.js';
+export interface StoreOptions {
+    /** Override the root. Defaults to ~/.yujin-forge/agents. */
+    root?: string;
+}
+export declare function listAgentSlugs(opts?: StoreOptions): Promise<string[]>;
+export declare function getAgentDefinition(slug: string, opts?: StoreOptions): Promise<AgentDefinition | null>;
+export declare function listAgentDefinitions(opts?: StoreOptions): Promise<AgentDefinition[]>;
+/** Create or overwrite an agent definition. Returns false if the
+ *  slug is invalid; throws if disk IO fails. */
+export declare function saveAgentDefinition(def: AgentDefinition, opts?: StoreOptions): Promise<boolean>;
+/** Move an agent to the deletion grace partition. Runs travel
+ *  with it. Re-create + restore is a separate operation (TBD
+ *  in the deletion-undo slice). */
+export declare function softDeleteAgent(slug: string, opts?: StoreOptions): Promise<boolean>;
+/** Append a run record under the agent's runs/ dir. Run id is
+ *  generated if absent. */
+export declare function appendAgentRun(slug: string, run: Omit<AgentRun, 'id' | 'slug'> & {
+    id?: string;
+}, opts?: StoreOptions): Promise<AgentRun>;
+/** List runs for an agent, newest first. `limit` defaults to 50. */
+export declare function listAgentRuns(slug: string, limit?: number, opts?: StoreOptions): Promise<AgentRun[]>;
+/** True iff `~/.yujin-forge/agents/` exists with at least one
+ *  agent. Used by `yf agent install --defaults` to decide whether
+ *  to seed. */
+export declare function isStoreSeeded(opts?: StoreOptions): Promise<boolean>;
+/** Build a minimal AgentDefinition with sensible defaults. Used
+ *  by both `yf agent install --defaults` and tests. */
+export declare function buildAgentDefinitionDraft(slug: string, name: string, opts?: Partial<AgentDefinition>): AgentDefinition;
+/** Filter an agent list by status (handy for `yf agent list
+ *  --status=active`). */
+export declare function filterByStatus(defs: AgentDefinition[], status: AgentDefinitionStatus): AgentDefinition[];
+//# sourceMappingURL=store.d.ts.map

package/dist/agents/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/agents/store.ts"],"names":[],"mappings":"AA2BA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAE3B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA+CD,wBAAsB,cAAc,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAU/E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAG/G;AAED,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAQ9F;AAED;gDACgD;AAChD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzG;AAED;;mCAEmC;AACnC,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAY7F;AAMD;2BAC2B;AAC3B,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBnJ;AAED,oEAAoE;AACpE,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAgB1G;AAMD;;eAEe;AACf,wBAAsB,aAAa,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAG7E;AAED;uDACuD;AACvD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAiB1H;AAED;yBACyB;AACzB,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,qBAAqB,GAAG,eAAe,EAAE,CAExG"}