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

package/dist/agents/delegate.js

@@ -0,0 +1,68 @@
+/**
+ * Agent-to-agent delegation helper (Director sprint slice 15d).
+ *
+ * Encapsulates: bridge.sendMessage (with cap + loop detector) +
+ * runtime.dispatchAgent (with status gate) + result projection.
+ *
+ * The iterative step calls this when the LLM invokes
+ * `yujin.agent.delegate`. The chat server / CLI wires the
+ * runtime + bridge root before invoking the step.
+ *
+ * Graceful: every failure (ACL denial, paused target, runtime
+ * unreachable) returns `{ok:false, error}` so the LLM can
+ * surface it to the user instead of crashing the run.
+ *
+ * ASCII-only.
+ */
+import { sendMessage, BridgeError } from './bridge.js';
+export async function delegateToAgent(opts) {
+    /* Step 1: enqueue via the bridge so the cap + loop detector
+     * + ACL check fire BEFORE we touch the runtime. */
+    try {
+        await sendMessage({
+            from_slug: opts.from_slug,
+            to_slug: opts.to_slug,
+            payload: opts.payload,
+            tokens_used: opts.tokens_used,
+        }, { root: opts.root });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            target_slug: opts.to_slug,
+            error: err instanceof BridgeError
+                ? (err.message + ' (code=' + err.code + ')')
+                : (err instanceof Error ? err.message : String(err)),
+        };
+    }
+    /* Step 2: fire-and-forget when no runtime provided. */
+    if (!opts.runtime) {
+        return { ok: true, target_slug: opts.to_slug };
+    }
+    /* Step 3: dispatch the target via runtime. The runtime enforces
+     * status gates (paused / deleted / unknown -> failed run). */
+    const triggerReason = 'bridge: from=' + opts.from_slug;
+    try {
+        const run = await opts.runtime.dispatchAgent(opts.to_slug, triggerReason);
+        return {
+            ok: run.status === 'succeeded',
+            target_slug: opts.to_slug,
+            trigger_reason: triggerReason,
+            run_status: run.status,
+            last_reply: run.last_reply_summary,
+            tokens_in: run.tokens_in,
+            tokens_out: run.tokens_out,
+            error: run.status === 'succeeded'
+                ? undefined
+                : ('target run status=' + run.status + (run.kill_reason ? ' (' + run.kill_reason + ')' : '')),
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            target_slug: opts.to_slug,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+//# sourceMappingURL=delegate.js.map

package/dist/agents/delegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../src/agents/delegate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAsCvD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAkB;IACtD;uDACmD;IACnD,IAAI,CAAC;QACH,MAAM,WAAW,CACf;YACE,SAAS,EAAI,IAAI,CAAC,SAAS;YAC3B,OAAO,EAAM,IAAI,CAAC,OAAO;YACzB,OAAO,EAAM,IAAI,CAAC,OAAO;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CACpB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAW,KAAK;YAClB,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,KAAK,EAAQ,GAAG,YAAY,WAAW;gBACrC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,GAAG,SAAS,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;gBAC5C,CAAC,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;SACvD,CAAC;IACJ,CAAC;IAED,uDAAuD;IACvD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC;IAED;kEAC8D;IAC9D,MAAM,aAAa,GAAG,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC1E,OAAO;YACL,EAAE,EAAc,GAAG,CAAC,MAAM,KAAK,WAAW;YAC1C,WAAW,EAAK,IAAI,CAAC,OAAO;YAC5B,cAAc,EAAE,aAAa;YAC7B,UAAU,EAAM,GAAG,CAAC,MAAM;YAC1B,UAAU,EAAM,GAAG,CAAC,kBAAkB;YACtC,SAAS,EAAO,GAAG,CAAC,SAAS;YAC7B,UAAU,EAAM,GAAG,CAAC,UAAU;YAC9B,KAAK,EAAW,GAAG,CAAC,MAAM,KAAK,WAAW;gBACxC,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,CAAC,oBAAoB,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAChG,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAW,KAAK;YAClB,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,KAAK,EAAQ,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/agents/iterative_step.d.ts

@@ -0,0 +1,95 @@
+import type { AgentDefinition } from './types.js';
+import type { StepFn } from './runner.js';
+interface MinimalClaude {
+    chat(req: {
+        system?: string;
+        messages: Array<{
+            role: 'user' | 'assistant' | 'system';
+            content: string;
+        }>;
+        tools?: Array<{
+            name: string;
+            description?: string;
+            input_schema?: Record<string, unknown>;
+        }>;
+        runTool?: (name: string, input: Record<string, unknown>) => Promise<unknown>;
+        maxTokens?: number;
+    }): Promise<{
+        text: string;
+        tokensIn: number;
+        tokensOut: number;
+        model?: string;
+        toolRounds: Array<{
+            tool: string;
+            input: Record<string, unknown>;
+            result: unknown;
+            is_error?: boolean;
+            tool_use_id: string;
+        }>;
+    }>;
+}
+type RunNac3InvokeFn = (rawArgs: {
+    verb_id: string;
+    args?: Record<string, unknown>;
+}, ctx: unknown, opts: {
+    legacyRun: unknown;
+    panelSessionId?: string;
+    llmTurnId?: string;
+    agentSlug?: string;
+}) => Promise<{
+    tool: string;
+    is_error?: boolean;
+    result: unknown;
+}>;
+export type DelegateFn = (to_slug: string, payload: string) => Promise<{
+    ok: boolean;
+    target_slug: string;
+    run_status?: string;
+    last_reply?: string;
+    tokens_in?: number;
+    tokens_out?: number;
+    error?: string;
+}>;
+export interface BuildIterativeStepOpts {
+    def: AgentDefinition;
+    claude: MinimalClaude;
+    /** The dispatcher that resolves a verb_id to a result. The
+     *  step gives it the ctx + opts the chat server uses; for
+     *  tests, inject a mock. */
+    runNac3Invoke: RunNac3InvokeFn;
+    project_root: string;
+    project_name: string;
+    forge_version: string;
+    /** Becomes the initial user message of the conversation. */
+    trigger_reason: string;
+    /** Pre-rendered, role-filtered graph snapshot (slice 11). */
+    graph_snapshot_section?: string;
+    workflow_section?: string;
+    /** Max tokens per Claude turn. Defaults to 2048. */
+    max_tokens?: number;
+    /** Optional ctx pass-through for runNac3Invoke (project root /
+     *  panel session id etc). The dispatcher needs SOMETHING; an
+     *  empty object satisfies tests. */
+    nac3_ctx?: unknown;
+    /** Legacy handler for runNac3Invoke. Tests inject a stub; the
+     *  chat server wires it to runForgeTool. */
+    legacy_run?: unknown;
+    /** Director sprint slice 15d -- when present, intercepts the
+     *  `yujin.agent.delegate` verb BEFORE the runNac3Invoke gate.
+     *  Used by the chat server / CLI to wire bridge.sendMessage +
+     *  runtime.dispatchAgent into one call. */
+    delegate?: DelegateFn;
+    /** Director closure pendiente 4 -- conversation persistence.
+     *  When `conversation_id` is set, the step loads any existing
+     *  history from <conversation_root>/<id>.json on construction
+     *  + atomically saves after each step. Across runtime restarts
+     *  the LLM continues with the prior context.
+     *
+     *  conversation_root defaults to ~/.yujin-forge/agents/by-slug/
+     *  <slug>/conversations -- co-located with the runs/ store. */
+    conversation_id?: string;
+    conversation_root?: string;
+}
+export declare function buildIterativeLlmStep(opts: BuildIterativeStepOpts): StepFn;
+export {};
+//# sourceMappingURL=iterative_step.d.ts.map

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

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

package/dist/agents/iterative_step.js

@@ -0,0 +1,249 @@
+/**
+ * Iterative agent LLM step (Director sprint slice 15c).
+ *
+ * Multi-turn capable step: each call to the returned StepFn does
+ * ONE Claude chat (which itself may run several tool rounds
+ * internally via the Claude client's tool-calling loop). The
+ * conversation history accumulates in closure so the runner can
+ * call the step on each iteration and Claude sees the prior
+ * context.
+ *
+ * Tool surface: a single `nac3_invoke` exposed to Claude. The
+ * runTool callback gates each call against `def.allowed_verbs`
+ * before delegating to `runNac3Invoke`. A verb NOT in the
+ * whitelist returns is_error so Claude (and the audit log) see
+ * the explicit denial.
+ *
+ * "done" detection:
+ *  - Claude emitted zero tool calls AND text is non-empty       -> done.
+ *  - reply.text matches a terminal marker (\[DONE\], etc)       -> done.
+ *  - One of the tool results is `nac3_panel_approval_required`  -> done
+ *    (with pending_approval=true so the runner records the
+ *     pause; user resumes via /api/agent/approve in slice 10).
+ *  - Otherwise (tools called + no terminal marker)              -> done=false
+ *    so the runner calls step again next iteration.
+ *
+ * ASCII-only.
+ */
+import { promises as fs, existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { buildAgentSystemPrompt } from './system_prompt.js';
+import { NAC3_INVOKE_SPEC } from '../chat/tools/nac3_invoke.js';
+/** Markers that flag a step turn as conclusive even when Claude
+ *  did call tools mid-turn. ASCII-only / case-insensitive. */
+const TERMINAL_MARKERS = [
+    /\[DONE\]/i,
+    /\bdone\.\s*$/i,
+    /\blisto\b[\s,.]*(termine|terminado|todo listo)?/i,
+    /\bterminado\b/i,
+];
+function isApprovalPending(toolRounds) {
+    /* The approval envelope may sit at toolRound.result.nac3_panel_approval_required
+     * (when the result is the flat envelope) OR at
+     * toolRound.result.result.nac3_panel_approval_required (when the
+     * runTool returned the full {tool, is_error, result} wrapper). We
+     * accept both shapes so the contract is robust. */
+    for (const r of toolRounds) {
+        const res = r.result;
+        if (!res || typeof res !== 'object')
+            continue;
+        if (res.nac3_panel_approval_required === true)
+            return true;
+        const inner = res.result;
+        if (inner && typeof inner === 'object' && inner.nac3_panel_approval_required === true)
+            return true;
+    }
+    return false;
+}
+function hasTerminalMarker(text) {
+    for (const re of TERMINAL_MARKERS)
+        if (re.test(text))
+            return true;
+    return false;
+}
+export function buildIterativeLlmStep(opts) {
+    const system = buildAgentSystemPrompt({
+        def: opts.def,
+        project_root: opts.project_root,
+        project_name: opts.project_name,
+        forge_version: opts.forge_version,
+        graph_snapshot_section: opts.graph_snapshot_section,
+        workflow_section: opts.workflow_section,
+    });
+    /* Closure-held conversation history. Grows across step calls.
+     * When conversation_id is set, also persisted to disk so it
+     * survives runtime restarts. */
+    let messages = [];
+    let firstCall = true;
+    const convFile = opts.conversation_id && opts.conversation_root
+        ? path.join(opts.conversation_root, opts.conversation_id + '.json')
+        : null;
+    if (convFile && existsSync(convFile)) {
+        try {
+            const raw = readFileSync(convFile, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (parsed && Array.isArray(parsed.messages)) {
+                messages = parsed.messages;
+                /* History exists -> first call should NOT append trigger
+                 * as a new user msg; the conversation already started. */
+                firstCall = false;
+            }
+        }
+        catch { /* corrupt -- treat as empty */ }
+    }
+    async function persistConversation() {
+        if (!convFile)
+            return;
+        try {
+            await fs.mkdir(path.dirname(convFile), { recursive: true });
+            /* Direct write -- atomic-rename pattern fails on Windows
+             * when the destination already exists. The conversation
+             * payload is small enough that a crash in the middle is
+             * acceptable (worst case: one partial conversation file). */
+            await fs.writeFile(convFile, JSON.stringify({ version: 1, messages }, null, 2), 'utf-8');
+        }
+        catch (err) {
+            /* surface but never crash the run */
+            try {
+                console.error('iterative_step: conversation persist failed: ' + (err instanceof Error ? err.message : String(err)));
+            }
+            catch { /* console redirected */ }
+        }
+    }
+    const allowed = new Set(opts.def.allowed_verbs ?? []);
+    /* runTool gate: nac3_invoke -> validate verb_id is allowed,
+     * then delegate to runNac3Invoke. Anything else -> denied. */
+    async function runTool(name, input) {
+        if (name !== NAC3_INVOKE_SPEC.name) {
+            return {
+                tool: name,
+                is_error: true,
+                result: { error: 'tool "' + name + '" is not exposed to this agent' },
+            };
+        }
+        const verbId = typeof input.verb_id === 'string' ? input.verb_id : '';
+        if (!verbId) {
+            return {
+                tool: NAC3_INVOKE_SPEC.name,
+                is_error: true,
+                result: { error: 'verb_id is required' },
+            };
+        }
+        if (!allowed.has(verbId)) {
+            return {
+                tool: NAC3_INVOKE_SPEC.name,
+                is_error: true,
+                result: {
+                    error: 'verb_id "' + verbId + '" not in allowed_verbs of agent "' + opts.def.slug + '"',
+                    allowed_verbs: Array.from(allowed),
+                },
+            };
+        }
+        const args = (input.args && typeof input.args === 'object' && !Array.isArray(input.args))
+            ? input.args
+            : {};
+        /* Slice 15d -- intercept yujin.agent.delegate before the
+         * regular runNac3Invoke path. Routes through the injected
+         * delegate callback (bridge + runtime). */
+        if (verbId === 'yujin.agent.delegate' && opts.delegate) {
+            const toSlug = typeof args.to_slug === 'string' ? args.to_slug : '';
+            const payload = typeof args.payload === 'string' ? args.payload : '';
+            if (!toSlug || !payload) {
+                return {
+                    tool: NAC3_INVOKE_SPEC.name,
+                    is_error: true,
+                    result: { error: 'yujin.agent.delegate requires {to_slug, payload}' },
+                };
+            }
+            try {
+                const r = await opts.delegate(toSlug, payload);
+                return {
+                    tool: NAC3_INVOKE_SPEC.name,
+                    is_error: !r.ok,
+                    result: r,
+                };
+            }
+            catch (err) {
+                return {
+                    tool: NAC3_INVOKE_SPEC.name,
+                    is_error: true,
+                    result: { error: err instanceof Error ? err.message : String(err) },
+                };
+            }
+        }
+        return opts.runNac3Invoke({ verb_id: verbId, args }, opts.nac3_ctx ?? {}, {
+            legacyRun: opts.legacy_run ?? (() => { throw new Error('legacy_run not wired'); }),
+            /* Tag the approval-queue row with this agent's slug so the
+             * eventual /api/agent/approve can emit
+             * agent_run_paused_resolved targeting the right SVG node. */
+            agentSlug: opts.def.slug,
+        });
+    }
+    return async (_state) => {
+        if (firstCall) {
+            messages.push({ role: 'user', content: opts.trigger_reason });
+            firstCall = false;
+        }
+        else if (messages.length > 0 && messages[messages.length - 1].role === 'assistant') {
+            /* Bug fix found in E2E live with Claude API (2026-06-05):
+             * each Claude /v1/messages call must end with a user
+             * message. After the first iterative turn the closure
+             * already pushed the assistant reply, so the next call
+             * would 400 with "This model does not support assistant
+             * message prefill". Inject a synthetic "continue" user
+             * turn so the next iteration is valid. */
+            messages.push({ role: 'user', content: 'Continue.' });
+        }
+        const reply = await opts.claude.chat({
+            system,
+            messages: messages.slice(),
+            /* Bug fix found in E2E live with Claude API (2026-06-05):
+             * passing only `[{name}]` makes the API reject the request
+             * with "tools.0.custom.input_schema: Field required".
+             * The Claude client builds the body from {name, description,
+             * input_schema}, so we must hand the full spec. */
+            tools: [{
+                    name: NAC3_INVOKE_SPEC.name,
+                    description: NAC3_INVOKE_SPEC.description,
+                    input_schema: NAC3_INVOKE_SPEC.input_schema,
+                }],
+            runTool,
+            maxTokens: opts.max_tokens ?? 2048,
+        });
+        if (reply.text) {
+            messages.push({ role: 'assistant', content: reply.text });
+        }
+        const toolCount = Array.isArray(reply.toolRounds) ? reply.toolRounds.length : 0;
+        const pendingApproval = isApprovalPending(reply.toolRounds || []);
+        let done;
+        if (pendingApproval) {
+            done = true;
+        }
+        else if (toolCount === 0) {
+            done = true;
+        }
+        else if (hasTerminalMarker(reply.text)) {
+            done = true;
+        }
+        else {
+            done = false;
+        }
+        /* Director closure pendiente 4 -- fire-and-forget persist
+         * after every step so a runtime restart resumes from the
+         * latest assistant reply. */
+        if (convFile) {
+            persistConversation().catch(() => undefined);
+        }
+        const out = {
+            text: reply.text,
+            tokens_in: reply.tokensIn,
+            tokens_out: reply.tokensOut,
+            tool_calls: toolCount,
+            done,
+        };
+        if (pendingApproval)
+            out.pending_approval = true;
+        return out;
+    };
+}
+//# sourceMappingURL=iterative_step.js.map

package/dist/agents/iterative_step.js.map

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

package/dist/agents/llm_step.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Agent LLM step (Director sprint slice 15b).
+ *
+ * Builds a StepFn that the runner can call. The step composes
+ * the agent's system prompt + emits one Claude call + returns a
+ * StepResult. Single-shot for now: every step returns done=true
+ * so the runner stops after one iteration. Multi-step
+ * tool-calling within an agent run lands in slice 16.
+ *
+ * The Claude client + the (def, project, snapshot) inputs are
+ * injected -- this module does not own them so the runtime can
+ * compose them with the per-turn context.
+ *
+ * ASCII-only.
+ */
+import type { AgentDefinition } from './types.js';
+import type { StepFn } from './runner.js';
+export interface LlmStepOpts {
+    def: AgentDefinition;
+    claude: {
+        chat: (req: {
+            system?: string;
+            messages: Array<{
+                role: 'user' | 'assistant' | 'system';
+                content: string;
+            }>;
+            maxTokens?: number;
+        }) => Promise<{
+            text: string;
+            tokensIn: number;
+            tokensOut: number;
+            model: string;
+            toolRounds: unknown[];
+        }>;
+    };
+    project_root: string;
+    project_name: string;
+    forge_version: string;
+    /** Inbound bridge payload OR the run trigger reason -- becomes
+     *  the user message of the Claude turn. */
+    trigger_reason: string;
+    /** Pre-rendered + role-filtered graph snapshot (slice 11). */
+    graph_snapshot_section?: string;
+    /** Pre-rendered workflow state section (workflow_inject). */
+    workflow_section?: string;
+    /** Max tokens for the Claude reply. Defaults to 2048. */
+    max_tokens?: number;
+}
+export declare function buildLlmStep(opts: LlmStepOpts): StepFn;
+//# sourceMappingURL=llm_step.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm_step.d.ts","sourceRoot":"","sources":["../../src/agents/llm_step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAwB,MAAM,aAAa,CAAC;AAGhE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAY,eAAe,CAAC;IAC/B,MAAM,EAAS;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE;YAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,KAAK,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,OAAO,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC7G,YAAY,EAAG,MAAM,CAAC;IACtB,YAAY,EAAG,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB;+CAC2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CA0BtD"}

package/dist/agents/llm_step.js

@@ -0,0 +1,28 @@
+import { buildAgentSystemPrompt } from './system_prompt.js';
+export function buildLlmStep(opts) {
+    const system = buildAgentSystemPrompt({
+        def: opts.def,
+        project_root: opts.project_root,
+        project_name: opts.project_name,
+        forge_version: opts.forge_version,
+        graph_snapshot_section: opts.graph_snapshot_section,
+        workflow_section: opts.workflow_section,
+    });
+    return async (_state) => {
+        const reply = await opts.claude.chat({
+            system,
+            messages: [
+                { role: 'user', content: opts.trigger_reason },
+            ],
+            maxTokens: opts.max_tokens ?? 2048,
+        });
+        return {
+            text: reply.text,
+            tokens_in: reply.tokensIn,
+            tokens_out: reply.tokensOut,
+            tool_calls: Array.isArray(reply.toolRounds) ? reply.toolRounds.length : 0,
+            done: true,
+        };
+    };
+}
+//# sourceMappingURL=llm_step.js.map

package/dist/agents/llm_step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm_step.js","sourceRoot":"","sources":["../../src/agents/llm_step.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAuB5D,MAAM,UAAU,YAAY,CAAC,IAAiB;IAC5C,MAAM,MAAM,GAAG,sBAAsB,CAAC;QACpC,GAAG,EAAY,IAAI,CAAC,GAAG;QACvB,YAAY,EAAG,IAAI,CAAC,YAAY;QAChC,YAAY,EAAG,IAAI,CAAC,YAAY;QAChC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;QACnD,gBAAgB,EAAQ,IAAI,CAAC,gBAAgB;KAC9C,CAAC,CAAC;IAEH,OAAO,KAAK,EAAE,MAAgB,EAAuB,EAAE;QACrD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACnC,MAAM;YACN,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE;aAC/C;YACD,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;SACnC,CAAC,CAAC;QACH,OAAO;YACL,IAAI,EAAQ,KAAK,CAAC,IAAI;YACtB,SAAS,EAAG,KAAK,CAAC,QAAQ;YAC1B,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACzE,IAAI,EAAQ,IAAI;SACjB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/agents/real_step_factory.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Real agent step factory (Director sprint slice 15e).
+ *
+ * Production wiring: composes the live Claude-driven iterative
+ * step. Use this from the chat server, the CLI (`yf agent run
+ * --real`), and the E2E smoke harness.
+ *
+ * Inputs (injected so tests + production stay aligned):
+ *  - claude:        the ClaudeClient (or compatible).
+ *  - runNac3Invoke: the nac3 dispatcher (chat/tools/nac3_invoke).
+ *  - runtime:       optional. When present, the factory wires
+ *                   yujin.agent.delegate -> delegateToAgent so
+ *                   inter-agent bridges work end-to-end.
+ *  - bridge_root:   optional. Override the ~/.yujin-forge root
+ *                   the bridge persists to (tests only).
+ *
+ * Output: a function (def, trigger_reason) => StepFn the runner
+ * can call directly.
+ *
+ * ASCII-only.
+ */
+import type { AgentDefinition } from './types.js';
+import type { StepFn } from './runner.js';
+import type { Runtime } from './runtime.js';
+interface MinimalClaude {
+    chat(req: {
+        system?: string;
+        messages: Array<{
+            role: 'user' | 'assistant' | 'system';
+            content: string;
+        }>;
+        tools?: Array<{
+            name: string;
+            description?: string;
+            input_schema?: Record<string, unknown>;
+        }>;
+        runTool?: (name: string, input: Record<string, unknown>) => Promise<unknown>;
+        maxTokens?: number;
+    }): Promise<{
+        text: string;
+        tokensIn: number;
+        tokensOut: number;
+        model?: string;
+        toolRounds: Array<{
+            tool: string;
+            input: Record<string, unknown>;
+            result: unknown;
+            is_error?: boolean;
+            tool_use_id: string;
+        }>;
+    }>;
+}
+type RunNac3InvokeFn = (rawArgs: {
+    verb_id: string;
+    args?: Record<string, unknown>;
+}, ctx: unknown, opts: {
+    legacyRun: unknown;
+    panelSessionId?: string;
+    llmTurnId?: string;
+    agentSlug?: string;
+}) => Promise<{
+    tool: string;
+    is_error?: boolean;
+    result: unknown;
+}>;
+export interface BuildStepFactoryOpts {
+    claude: MinimalClaude;
+    runNac3Invoke: RunNac3InvokeFn;
+    project_root: string;
+    project_name: string;
+    forge_version: string;
+    /** Optional. When present, wire the delegate verb so inter-
+     *  agent calls (Director -> Analyst) work end-to-end. */
+    runtime?: Runtime;
+    /** Optional bridge root override (tests inject tmp). */
+    bridge_root?: string;
+    /** Optional pre-rendered, role-filtered graph snapshot from
+     *  slice 11. The chat server / CLI can compute this once per
+     *  project + reuse across factory calls (cache hit). */
+    graph_snapshot_section?: string;
+    workflow_section?: string;
+    /** Optional ctx pass-through for runNac3Invoke. */
+    nac3_ctx?: unknown;
+    legacy_run?: unknown;
+    /** Director closure pendiente 4 -- conversation persistence.
+     *  When provided, the conversation is loaded from
+     *  <conversation_root>/<conversation_id>.json on factory call
+     *  + persisted after every step. Survives runtime restarts. */
+    conversation_id?: string;
+    conversation_root?: string;
+}
+export type AgentStepFactory = (def: AgentDefinition, trigger_reason: string) => StepFn;
+export declare function buildAgentStepFactory(opts: BuildStepFactoryOpts): AgentStepFactory;
+export {};
+//# sourceMappingURL=real_step_factory.d.ts.map

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

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