@nac3/forge-cli 0.2.0-alpha.59z.123 → 0.2.0-alpha.59z.158

package/dist/agents/real_step_factory.js

@@ -0,0 +1,51 @@
+import { buildIterativeLlmStep } from './iterative_step.js';
+import { delegateToAgent } from './delegate.js';
+export function buildAgentStepFactory(opts) {
+    return (def, trigger_reason) => {
+        /* Wire the delegate callback only when a runtime is provided.
+         * Without a runtime, yujin.agent.delegate falls through to the
+         * runNac3Invoke path (which the chat server may handle via a
+         * server-side handler, or which simply 404s). */
+        let delegate;
+        if (opts.runtime) {
+            const runtime = opts.runtime;
+            const bridgeRoot = opts.bridge_root;
+            delegate = async (to_slug, payload) => {
+                const r = await delegateToAgent({
+                    from_slug: def.slug,
+                    to_slug,
+                    payload,
+                    tokens_used: Math.ceil(payload.length / 4),
+                    root: bridgeRoot,
+                    runtime,
+                });
+                return {
+                    ok: r.ok,
+                    target_slug: r.target_slug,
+                    run_status: r.run_status,
+                    last_reply: r.last_reply,
+                    tokens_in: r.tokens_in,
+                    tokens_out: r.tokens_out,
+                    error: r.error,
+                };
+            };
+        }
+        return buildIterativeLlmStep({
+            def,
+            claude: opts.claude,
+            runNac3Invoke: opts.runNac3Invoke,
+            project_root: opts.project_root,
+            project_name: opts.project_name,
+            forge_version: opts.forge_version,
+            trigger_reason,
+            graph_snapshot_section: opts.graph_snapshot_section,
+            workflow_section: opts.workflow_section,
+            nac3_ctx: opts.nac3_ctx,
+            legacy_run: opts.legacy_run,
+            delegate,
+            conversation_id: opts.conversation_id,
+            conversation_root: opts.conversation_root,
+        });
+    };
+}
+//# sourceMappingURL=real_step_factory.js.map

package/dist/agents/real_step_factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"real_step_factory.js","sourceRoot":"","sources":["../../src/agents/real_step_factory.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,qBAAqB,EAAmB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAqDhD,MAAM,UAAU,qBAAqB,CAAC,IAA0B;IAC9D,OAAO,CAAC,GAAoB,EAAE,cAAsB,EAAU,EAAE;QAC9D;;;yDAGiD;QACjD,IAAI,QAAgC,CAAC;QACrC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;YACpC,QAAQ,GAAG,KAAK,EAAE,OAAe,EAAE,OAAe,EAAE,EAAE;gBACpD,MAAM,CAAC,GAAG,MAAM,eAAe,CAAC;oBAC9B,SAAS,EAAI,GAAG,CAAC,IAAI;oBACrB,OAAO;oBACP,OAAO;oBACP,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;oBAC1C,IAAI,EAAS,UAAU;oBACvB,OAAO;iBACR,CAAC,CAAC;gBACH,OAAO;oBACL,EAAE,EAAY,CAAC,CAAC,EAAE;oBAClB,WAAW,EAAG,CAAC,CAAC,WAAW;oBAC3B,UAAU,EAAI,CAAC,CAAC,UAAU;oBAC1B,UAAU,EAAI,CAAC,CAAC,UAAU;oBAC1B,SAAS,EAAK,CAAC,CAAC,SAAS;oBACzB,UAAU,EAAI,CAAC,CAAC,UAAU;oBAC1B,KAAK,EAAS,CAAC,CAAC,KAAK;iBACtB,CAAC;YACJ,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,qBAAqB,CAAC;YAC3B,GAAG;YACH,MAAM,EAAkB,IAAI,CAAC,MAAM;YACnC,aAAa,EAAW,IAAI,CAAC,aAAa;YAC1C,YAAY,EAAY,IAAI,CAAC,YAAY;YACzC,YAAY,EAAY,IAAI,CAAC,YAAY;YACzC,aAAa,EAAW,IAAI,CAAC,aAAa;YAC1C,cAAc;YACd,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;YACnD,gBAAgB,EAAQ,IAAI,CAAC,gBAAgB;YAC7C,QAAQ,EAAgB,IAAI,CAAC,QAAQ;YACrC,UAAU,EAAc,IAAI,CAAC,UAAU;YACvC,QAAQ;YACR,eAAe,EAAS,IAAI,CAAC,eAAe;YAC5C,iBAAiB,EAAO,IAAI,CAAC,iBAAiB;SAC/C,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/agents/runner.d.ts

@@ -46,6 +46,12 @@ export interface StepResult {
     rejected_approval?: boolean;
     /** True iff the step says "I am done, stop looping". */
     done?: boolean;
+    /** Director sprint slice 15c -- set when one of the nac3_invoke
+     *  tool results carried `nac3_panel_approval_required:true`. The
+     *  runner records it in the AgentRun so the panel / CLI can
+     *  surface "waiting for user". Resumption happens through
+     *  /api/agent/approve (slice 10), not by re-entering this run. */
+    pending_approval?: boolean;
 }
 export type StepFn = (state: RunState) => Promise<StepResult>;
 export interface RunAgentOptions {
@@ -71,6 +77,14 @@ export interface RunAgentOptions {
     /** Persist the resulting AgentRun via the store. Default true.
      *  Tests pass false to keep the filesystem clean. */
     persist?: boolean;
+    /** Director sprint phase II, slice 11 -- the project graph
+     *  snapshot section the LLM step will splice into the agent's
+     *  system prompt. The runner does NOT build the section itself
+     *  to keep this layer agnostic; the caller (chat server / CLI)
+     *  builds it via buildGraphSnapshotSection + filterSnapshotForRole
+     *  and hands the rendered text in. Empty string = no panorama
+     *  (graceful no-op). */
+    graph_snapshot_section?: string;
 }
 /** Run one agent through its lifecycle. */
 export declare function runAgent(def: AgentDefinition, opts: RunAgentOptions): Promise<AgentRun>;

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

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9F,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB;+CAC2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;+BAE2B;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wDAAwD;IACxD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB;wDACoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb;;gCAE4B;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;sEACkE;IAClE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;mDAC+C;IAC/C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;wDAEoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;yDACqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAqBD,2CAA2C;AAC3C,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,QAAQ,CAAC,CAkInB;AAID,iBAAS,YAAY,CAAC,GAAG,EAAE,QAAQ;;;;;;;;;;;;EAclC;AAGD,eAAO,MAAM,WAAW;;CAAmB,CAAC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9F,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB;+CAC2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;+BAE2B;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wDAAwD;IACxD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;sEAIkE;IAClE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB;wDACoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb;;gCAE4B;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;sEACkE;IAClE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;mDAC+C;IAC/C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;wDAEoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;yDACqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;4BAMwB;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAqBD,2CAA2C;AAC3C,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,QAAQ,CAAC,CA2InB;AAID,iBAAS,YAAY,CAAC,GAAG,EAAE,QAAQ;;;;;;;;;;;;EAclC;AAGD,eAAO,MAAM,WAAW;;CAAmB,CAAC"}

package/dist/agents/runner.js

@@ -106,7 +106,16 @@ export async function runAgent(def, opts) {
             }
             /* Step says done */
             if (result.done) {
-                finalStatus = 'succeeded';
+                /* Director closure pendiente 3 -- when the step surfaces
+                 * pending_approval, the run is concluded but the agent
+                 * is WAITING for the user to resolve via the R8 modal /
+                 * POST /api/agent/approve. The status distinguishes this
+                 * from a clean succeeded run so the panel + CLI can show
+                 * a different visual state. */
+                finalStatus = result.pending_approval ? 'paused_for_approval' : 'succeeded';
+                if (result.pending_approval) {
+                    killReason = 'pending R8 approval -- resolve via /api/agent/approve';
+                }
                 break;
             }
         }

package/dist/agents/runner.js.map

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

package/dist/agents/runtime.d.ts

@@ -0,0 +1,115 @@
+import type { AgentRun, AgentRunStatus } from './types.js';
+export type RuntimeEvent = {
+    kind: 'agent_run_started';
+    slug: string;
+    trigger_reason: string;
+    at: number;
+    project_slug?: string;
+} | {
+    kind: 'agent_run_finished';
+    slug: string;
+    run_id: string;
+    status: AgentRunStatus;
+    at: number;
+    project_slug?: string;
+} | {
+    kind: 'agent_run_skipped';
+    slug: string;
+    reason: string;
+    at: number;
+    project_slug?: string;
+} | {
+    kind: 'bridge_drain';
+    slug: string;
+    message_count: number;
+    at: number;
+    project_slug?: string;
+}
+/** Director closure pendiente 5 followup -- emitted by the server
+ *  /api/agent/approve handler when a pending R8 approval row
+ *  resolves AND the row carries an agent_slug. The panel uses
+ *  this to clear the persistent .paused-for-approval marker on
+ *  the SVG node WITHOUT waiting for a new run to start. */
+ | {
+    kind: 'agent_run_paused_resolved';
+    slug: string;
+    trace_id: string;
+    decision: 'approved' | 'rejected';
+    at: number;
+    project_slug?: string;
+}
+/** Slice 2 of N-projects sprint -- emitted when a dispatch hits
+ *  the global or per-project semaphore and the caller has to
+ *  wait. The Activity panel surfaces this as a throttle badge
+ *  so the operator understands why a click did not fire
+ *  instantly. `cap` is the limit that tripped; `running` is
+ *  the live counter for that scope at the moment of throttle. */
+ | {
+    kind: 'agent_run_throttled';
+    slug: string;
+    project_slug?: string;
+    scope: 'global' | 'per_project';
+    running: number;
+    cap: number;
+    at: number;
+} | {
+    kind: 'tick';
+    at: number;
+};
+/** Slice 1 of N-projects sprint -- dispatch options.
+ *  project_slug defaults to 'self' (single-project legacy mode).
+ *  Callers that know the project (CLI, Activity inject endpoint,
+ *  panel switcher) pass an explicit slug. */
+export interface DispatchOpts {
+    project_slug?: string;
+}
+export type RunnerFn = (slug: string, trigger_reason: string, opts?: DispatchOpts) => Promise<AgentRun>;
+export interface RuntimeOpts {
+    /** Override ~/.yujin-forge for tests. */
+    root?: string;
+    /** Override Date.now for deterministic tests. */
+    clock?: () => number;
+    /** Inject the runner (real or stub). When omitted, falls back
+     *  to the canonical src/agents/runner.ts (dynamic import to
+     *  avoid pulling Anthropic deps in tests). */
+    runner?: RunnerFn;
+    /** Tick cadence in ms. Defaults to 5000ms. */
+    tickIntervalMs?: number;
+}
+export interface RuntimeStatus {
+    running: boolean;
+    tick_interval_ms: number;
+    last_tick_at: number | null;
+    /** Slice 2 of N-projects sprint -- live concurrency snapshot. */
+    concurrency: {
+        /** Total runs in-flight (sum across all projects). */
+        global_running: number;
+        /** Cap for global runs (config: agent.runtime.max_concurrent_runs_global). */
+        global_max: number;
+        /** Per-project running counters keyed by project_slug. */
+        per_project_running: Record<string, number>;
+        /** Cap per project (config: agent.runtime.max_concurrent_runs_per_project). */
+        per_project_max: number;
+    };
+}
+export interface Runtime {
+    start(): void;
+    stop(): Promise<void>;
+    status(): RuntimeStatus;
+    dispatchAgent(slug: string, trigger_reason: string, opts?: DispatchOpts): Promise<AgentRun>;
+    tickNow(): Promise<void>;
+    on(event: 'event', cb: (e: RuntimeEvent) => void): void;
+    off(event: 'event', cb: (e: RuntimeEvent) => void): void;
+    /** Director sprint slice 5 -- the agent-store root the runtime
+     *  was constructed with. The panel endpoints need this so they
+     *  can list the same definitions the runtime sees. */
+    getAgentsRoot(): string;
+    /** Director closure pendiente 5 followup -- the
+     *  /api/agent/approve handler emits agent_run_paused_resolved
+     *  via this method when a pending row carrying agent_slug
+     *  resolves. The SSE bus forwards it to the panel SVG which
+     *  clears the amber dashed marker. */
+    emitExternal(e: RuntimeEvent): void;
+}
+export declare function createRuntime(opts?: RuntimeOpts): Runtime;
+//# sourceMappingURL=runtime.d.ts.map

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

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