@nookplot/runtime 0.5.147 → 0.5.149

package/dist/goal/goalLoop.js

@@ -0,0 +1,388 @@
+/**
+ * GoalLoop — the L3 step-by-step execution engine for goal-driven agents.
+ *
+ * Invoked by `AutonomousAgent.bootstrapGoal()` when an agent was forged
+ * with `initial_goal` set (typically via an L1 swarm suggestion).
+ *
+ * The loop:
+ *   1. Asks the LLM "what's the next step?" given the goal + recent history
+ *   2. Parses a JSON decision from the response
+ *   3. Executes or records the decision
+ *   4. Checks termination conditions (complete, budget, stuck, capability gap)
+ *
+ * Design choices (see ROADMAP_orchestrator-swarm-autodeploy.md §3):
+ *   - Atomic goals, no project decomposition (v1 simplification)
+ *   - Budget is soft — the real gate is owner NOOK balance, not the goal cap
+ *   - 3 reformulations of the same step → blocked_stuck
+ *   - 3 consecutive no-ops → treat as complete (the agent has nothing else to do)
+ *
+ * @module goal/goalLoop
+ */
+import { GOAL_STEP_SYSTEM_PROMPT, buildGoalStepUserPrompt } from "./goalPrompts.js";
+import { buildCorrectivePrompt, checkForDoomLoopFromSignatures, makeSignature, } from "../doomLoop.js";
+const DEFAULT_MAX_STEPS = 20;
+const DEFAULT_MAX_NOOPS = 3;
+const DEFAULT_MAX_REFORMULATIONS = 3;
+const DOOM_LOOP_MAX_TRIGGERS = 3;
+const DOOM_LOOP_SIGNATURE_WINDOW = 30;
+export class GoalLoop {
+    runtime;
+    goal;
+    budgetNook;
+    maxSteps;
+    maxNoops;
+    maxReformulations;
+    verbose;
+    inferenceCall;
+    parentSwarmId;
+    recentSteps = [];
+    spentNook = 0n;
+    stepsExecuted = 0;
+    toolSignatures = [];
+    doomLoopTriggers = 0;
+    doomLoopNote = null;
+    constructor(opts) {
+        this.runtime = opts.runtime;
+        this.goal = opts.goal;
+        this.budgetNook = opts.budgetNook;
+        this.maxSteps = opts.maxSteps ?? DEFAULT_MAX_STEPS;
+        this.maxNoops = opts.maxConsecutiveNoops ?? DEFAULT_MAX_NOOPS;
+        this.maxReformulations = opts.maxReformulations ?? DEFAULT_MAX_REFORMULATIONS;
+        this.verbose = opts.verbose ?? false;
+        this.parentSwarmId = opts.parentSwarmId ?? null;
+        this.inferenceCall = opts.inferenceCall ?? this.defaultInferenceCall.bind(this);
+    }
+    /**
+     * Run the loop to completion. Returns exactly one of four outcomes.
+     * Never throws for normal termination — only throws for unrecoverable
+     * infrastructure errors (e.g. runtime not connected).
+     */
+    async run() {
+        let consecutiveNoops = 0;
+        let sameStepRepetitions = 0;
+        let lastStepDescription = "";
+        for (let step = 0; step < this.maxSteps; step++) {
+            // Hard USDC spend cap (budgetUsdc) — a per-agent ledger shared with every
+            // pay_api dispatch site in this process. Unlike budgetNook (soft/warn-only
+            // below) this TERMINATES the loop so goal work can't continue spending
+            // once the cap is consumed. Optional-chained so mock runtimes without a
+            // usdcBudget (tests) are unaffected.
+            if (this.runtime.usdcBudget?.isExhausted()) {
+                return {
+                    outcome: "blocked_budget",
+                    spentNook: this.spentNook,
+                    spentUsdcBaseUnits: this.runtime.usdcBudget.spent,
+                };
+            }
+            const decision = await this.askLLMForNextAction();
+            if (!decision) {
+                consecutiveNoops++;
+                if (consecutiveNoops >= this.maxNoops) {
+                    return this.finalizeFallback("LLM returned unparseable output 3x");
+                }
+                continue;
+            }
+            // --- Termination check: complete ---
+            if (decision.type === "complete") {
+                return {
+                    outcome: "complete",
+                    artifact: {
+                        title: decision.title?.slice(0, 200) || "Goal artifact",
+                        body: decision.body?.slice(0, 80_000) || "(empty)",
+                        domain: decision.domain?.slice(0, 120) || "general",
+                    },
+                    stepsExecuted: this.stepsExecuted,
+                    spentNook: this.spentNook,
+                };
+            }
+            // --- Termination check: capability gap ---
+            if (decision.type === "needs_capability") {
+                return {
+                    outcome: "blocked_capability",
+                    capabilityNeeded: decision.description.slice(0, 1000),
+                    suggestedPreset: decision.suggestedPreset,
+                    spentNook: this.spentNook,
+                };
+            }
+            // --- Stuck detection (same step repeated N times) ---
+            if (decision.description === lastStepDescription) {
+                sameStepRepetitions++;
+                if (sameStepRepetitions >= this.maxReformulations) {
+                    return {
+                        outcome: "blocked_stuck",
+                        stuckReason: decision.description.slice(0, 1000),
+                        spentNook: this.spentNook,
+                    };
+                }
+            }
+            else {
+                sameStepRepetitions = 0;
+            }
+            lastStepDescription = decision.description;
+            // --- No-op ---
+            if (decision.type === "noop") {
+                consecutiveNoops++;
+                if (consecutiveNoops >= this.maxNoops) {
+                    return this.finalizeFallback("agent returned 3 no-ops in a row");
+                }
+                await this.recordStepRemotely(step + 1, "noop", decision.description, "", 0);
+                continue;
+            }
+            consecutiveNoops = 0;
+            // --- Execute the action ---
+            const execResult = await this.executeAction(decision);
+            this.spentNook += BigInt(Math.max(0, Math.round(execResult.costNook)));
+            this.stepsExecuted++;
+            this.recentSteps.push({
+                stepNumber: step + 1,
+                actionType: decision.actionName,
+                outputSummary: execResult.output,
+            });
+            if (this.recentSteps.length > 16)
+                this.recentSteps.shift();
+            await this.recordStepRemotely(step + 1, decision.actionName, decision.description, execResult.output, execResult.costNook);
+            // --- Doom-loop detection (same tool+args 3x, or A,B,A,B patterns) ---
+            //     Triggers inject a corrective prompt for the next turn.
+            //     3 triggers in one goal short-circuits to blocked_stuck.
+            this.toolSignatures.push(makeSignature(decision.actionName, decision.actionParams));
+            if (this.toolSignatures.length > DOOM_LOOP_SIGNATURE_WINDOW) {
+                this.toolSignatures = this.toolSignatures.slice(-DOOM_LOOP_SIGNATURE_WINDOW);
+            }
+            const offender = checkForDoomLoopFromSignatures(this.toolSignatures);
+            if (offender) {
+                this.doomLoopTriggers++;
+                if (this.doomLoopTriggers >= DOOM_LOOP_MAX_TRIGGERS) {
+                    return {
+                        outcome: "blocked_stuck",
+                        stuckReason: `doom loop on '${offender}' (${this.doomLoopTriggers} triggers)`.slice(0, 1000),
+                        spentNook: this.spentNook,
+                    };
+                }
+                this.doomLoopNote = buildCorrectivePrompt(offender);
+            }
+            // --- Soft budget warning (non-blocking) ---
+            if (this.spentNook > this.budgetNook) {
+                if (this.verbose) {
+                    console.warn(`[goalLoop] Over soft budget: spent=${this.spentNook} budget=${this.budgetNook}`);
+                }
+            }
+        }
+        // Hit maxSteps cap without calling `complete` — treat as done.
+        return this.finalizeFallback(`hit maxSteps cap (${this.maxSteps})`);
+    }
+    // =======================================================================
+    //  Private helpers
+    // =======================================================================
+    async askLLMForNextAction() {
+        try {
+            let userPrompt = buildGoalStepUserPrompt(this.goal, this.recentSteps, this.spentNook, this.budgetNook);
+            if (this.doomLoopNote) {
+                userPrompt = `${this.doomLoopNote}\n\n---\n\n${userPrompt}`;
+                this.doomLoopNote = null;
+            }
+            const response = await this.inferenceCall({
+                systemPrompt: GOAL_STEP_SYSTEM_PROMPT,
+                userPrompt,
+                maxTokens: 1024,
+                temperature: 0.5,
+            });
+            this.spentNook += BigInt(Math.max(0, Math.round(response.costNook ?? 0)));
+            return parseGoalAction(response.content);
+        }
+        catch (err) {
+            if (this.verbose) {
+                console.error("[goalLoop] LLM call failed:", err);
+            }
+            return null;
+        }
+    }
+    /**
+     * Default inference caller — uses the runtime's inference API if available,
+     * otherwise returns a noop response. Consumers with custom inference wiring
+     * should pass `inferenceCall` in GoalLoopOptions.
+     */
+    async defaultInferenceCall(input) {
+        // The runtime economy manager exposes inference via /v1/agents/me/inference.
+        // We don't take a hard dependency on its exact API here — cast through
+        // unknown so environments without inference wired up fall through cleanly.
+        const economy = this.runtime.economy;
+        if (!economy?.inference) {
+            throw new Error("GoalLoop has no inferenceCall configured and runtime.economy.inference is unavailable");
+        }
+        const result = (await economy.inference({
+            messages: [
+                { role: "system", content: input.systemPrompt },
+                { role: "user", content: input.userPrompt },
+            ],
+            maxTokens: input.maxTokens,
+            temperature: input.temperature,
+        }));
+        return {
+            content: result.content ?? "",
+            costNook: result.costNook,
+        };
+    }
+    /**
+     * Execute one action via the runtime's action dispatch pipeline.
+     *
+     * All actions go through `POST /v1/actions/execute` which handles both
+     * off-chain (direct) and on-chain (sign-required) action types. This
+     * preserves the CLAUDE.md Rule 5 invariant that all on-chain state
+     * changes go through prepare → sign → relay.
+     */
+    async executeAction(action) {
+        try {
+            const connection = this.runtime.connection;
+            if (!connection?.request) {
+                return { ok: false, output: "runtime not connected", costNook: 0 };
+            }
+            const dispatchResult = (await connection.request("POST", "/v1/actions/execute", {
+                toolName: `nookplot_${action.actionName}`,
+                payload: action.actionParams,
+            }));
+            const status = dispatchResult?.status ?? "completed";
+            if (status === "error") {
+                return {
+                    ok: false,
+                    output: String(dispatchResult.error ?? "action failed").slice(0, 500),
+                    costNook: 0,
+                    error: dispatchResult.error,
+                };
+            }
+            // NOTE: sign_required actions are NOT auto-signed here. The goal loop
+            // v1 focuses on off-chain research/synthesis tools. If the LLM requests
+            // an on-chain action, we return it to the loop as output but do NOT
+            // execute — the autonomous signal path handles approval + relay for
+            // delegated actions separately.
+            if (status === "sign_required") {
+                return {
+                    ok: true,
+                    output: `[sign_required] ${action.actionName} — skipped in goal loop v1 (use directive or on-chain action flow)`,
+                    costNook: 0,
+                };
+            }
+            const outputText = typeof dispatchResult.result === "string"
+                ? dispatchResult.result
+                : JSON.stringify(dispatchResult.result ?? {}).slice(0, 500);
+            return {
+                ok: true,
+                output: outputText.slice(0, 500),
+                costNook: Number(dispatchResult.costNook ?? 0),
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { ok: false, output: msg.slice(0, 500), costNook: 0, error: msg };
+        }
+    }
+    async recordStepRemotely(stepNumber, actionType, inputSummary, outputSummary, costNook) {
+        try {
+            await this.runtime.identity.recordGoalStep({
+                stepNumber,
+                actionType,
+                inputSummary: inputSummary.slice(0, 500),
+                outputSummary: outputSummary.slice(0, 500),
+                nookSpent: Math.max(0, Math.round(costNook)),
+            });
+        }
+        catch (err) {
+            if (this.verbose) {
+                console.error("[goalLoop] recordGoalStep failed:", err);
+            }
+            // Non-fatal — the loop continues
+        }
+    }
+    /**
+     * Treat the current state as a completed goal. Used when the LLM stalls
+     * or the max step count is exceeded. Produces a summary artifact from
+     * the recent step history so the user has something to review.
+     */
+    finalizeFallback(reason) {
+        const body = this.recentSteps.length === 0
+            ? `Goal loop terminated: ${reason}.\n\nNo progress was made on: ${this.goal}`
+            : [
+                `# Goal Progress`,
+                ``,
+                `**Goal:** ${this.goal}`,
+                ``,
+                `**Termination:** ${reason}`,
+                ``,
+                `**Steps executed:** ${this.stepsExecuted}`,
+                ``,
+                `## Recent steps`,
+                ``,
+                ...this.recentSteps.map((s, i) => `${i + 1}. **${s.actionType ?? "?"}** — ${(s.outputSummary ?? "").slice(0, 200)}`),
+            ].join("\n");
+        return {
+            outcome: "complete",
+            artifact: {
+                title: this.goal.slice(0, 200),
+                body,
+                domain: "goal-fallback",
+            },
+            stepsExecuted: this.stepsExecuted,
+            spentNook: this.spentNook,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+//  JSON parsing — tolerant to prose wrapping the JSON block
+// ---------------------------------------------------------------------------
+/**
+ * Parse a goal action from an LLM response. Tries to extract the first
+ * `{...}` JSON block from the content and coerce it into a GoalAction.
+ *
+ * Exported for unit testing.
+ */
+export function parseGoalAction(content) {
+    if (!content)
+        return null;
+    const match = content.match(/\{[\s\S]*\}/);
+    if (!match)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(match[0]);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object")
+        return null;
+    const obj = parsed;
+    const type = typeof obj.type === "string" ? obj.type : null;
+    if (!type)
+        return null;
+    if (type === "action") {
+        const actionName = typeof obj.action_name === "string" ? obj.action_name : "";
+        const actionParams = typeof obj.action_params === "object" && obj.action_params !== null
+            ? obj.action_params
+            : {};
+        const description = typeof obj.description === "string" ? obj.description : actionName;
+        if (!actionName)
+            return null;
+        return { type: "action", actionName, actionParams, description };
+    }
+    if (type === "complete") {
+        const title = typeof obj.title === "string" ? obj.title : "";
+        const body = typeof obj.body === "string" ? obj.body : "";
+        const domain = typeof obj.domain === "string" ? obj.domain : "general";
+        const description = typeof obj.description === "string" ? obj.description : "complete";
+        if (!title || !body)
+            return null;
+        return { type: "complete", title, body, domain, description };
+    }
+    if (type === "noop") {
+        const description = typeof obj.description === "string" ? obj.description : "noop";
+        return { type: "noop", description };
+    }
+    if (type === "needs_capability") {
+        const description = typeof obj.description === "string" ? obj.description : "";
+        const suggestedPreset = typeof obj.suggested_preset === "string" ? obj.suggested_preset : undefined;
+        if (!description)
+            return null;
+        return { type: "needs_capability", description, suggestedPreset };
+    }
+    return null;
+}
+//# sourceMappingURL=goalLoop.js.map

package/dist/goal/goalLoop.js.map

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

package/dist/goal/goalPrompts.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Prompt templates for the goal loop.
+ *
+ * The system prompt is deliberately terse — the agent's own soul (personality,
+ * style) is layered on top by whatever higher-level chat driver the consumer
+ * chooses. The goal loop cares only about producing valid JSON actions.
+ *
+ * @module goal/goalPrompts
+ */
+export declare const GOAL_STEP_SYSTEM_PROMPT = "You are an autonomous Nookplot agent working on a specific goal. Each turn, you choose the single next action that moves you toward completion.\n\nYou have access to tools including web_search (search the live web), search_knowledge (query your KG + mining traces + network), egress_request (call external APIs), and publishing actions.\n\nYour decision each turn is ONE of:\n\n1. Execute an action \u2014 return { \"type\": \"action\", \"action_name\": \"...\", \"action_params\": {...}, \"description\": \"...\" }\n2. Complete the goal \u2014 return { \"type\": \"complete\", \"title\": \"...\", \"body\": \"<final markdown artifact>\", \"domain\": \"<short topic>\", \"description\": \"...\" }\n3. Declare no-op \u2014 return { \"type\": \"noop\", \"description\": \"...\" }  (use sparingly; 3 consecutive no-ops ends the goal)\n4. Declare capability gap \u2014 return { \"type\": \"needs_capability\", \"description\": \"...\", \"suggested_preset\": \"...\" | null }\n\nRules:\n- Be concise and focused. Do NOT explore beyond the goal.\n- Cite sources in the body when using web_search results.\n- Prefer search_knowledge (free) before web_search (costs credits) for anything that might be in the knowledge graph.\n- You have a hard cap of 20 steps. Do not waste them.\n- If the goal is ambiguous, interpret narrowly \u2014 complete a narrow version rather than wandering broadly.\n- Budget is a soft cap \u2014 stay under if you can, but the goal matters more than the estimate.\n- When finished, ALWAYS return type \"complete\" with the deliverable in \"body\". Do NOT keep iterating after the goal is achieved.\n\nReturn only valid JSON. No prose outside the JSON block.";
+/**
+ * Build the per-step user prompt. Includes the goal, recent steps, and
+ * current spend. Kept deliberately compact to fit alongside the catalog
+ * of available actions that the consumer may choose to append.
+ */
+export declare function buildGoalStepUserPrompt(goal: string, previousSteps: Array<{
+    actionType: string | null;
+    outputSummary: string | null;
+}>, spentNook: bigint, budgetNook: bigint): string;
+//# sourceMappingURL=goalPrompts.d.ts.map

package/dist/goal/goalPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goalPrompts.d.ts","sourceRoot":"","sources":["../../src/goal/goalPrompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,uBAAuB,kpDAoBqB,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,EACjF,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAkBR"}

package/dist/goal/goalPrompts.js

@@ -0,0 +1,54 @@
+/**
+ * Prompt templates for the goal loop.
+ *
+ * The system prompt is deliberately terse — the agent's own soul (personality,
+ * style) is layered on top by whatever higher-level chat driver the consumer
+ * chooses. The goal loop cares only about producing valid JSON actions.
+ *
+ * @module goal/goalPrompts
+ */
+export const GOAL_STEP_SYSTEM_PROMPT = `You are an autonomous Nookplot agent working on a specific goal. Each turn, you choose the single next action that moves you toward completion.
+
+You have access to tools including web_search (search the live web), search_knowledge (query your KG + mining traces + network), egress_request (call external APIs), and publishing actions.
+
+Your decision each turn is ONE of:
+
+1. Execute an action — return { "type": "action", "action_name": "...", "action_params": {...}, "description": "..." }
+2. Complete the goal — return { "type": "complete", "title": "...", "body": "<final markdown artifact>", "domain": "<short topic>", "description": "..." }
+3. Declare no-op — return { "type": "noop", "description": "..." }  (use sparingly; 3 consecutive no-ops ends the goal)
+4. Declare capability gap — return { "type": "needs_capability", "description": "...", "suggested_preset": "..." | null }
+
+Rules:
+- Be concise and focused. Do NOT explore beyond the goal.
+- Cite sources in the body when using web_search results.
+- Prefer search_knowledge (free) before web_search (costs credits) for anything that might be in the knowledge graph.
+- You have a hard cap of 20 steps. Do not waste them.
+- If the goal is ambiguous, interpret narrowly — complete a narrow version rather than wandering broadly.
+- Budget is a soft cap — stay under if you can, but the goal matters more than the estimate.
+- When finished, ALWAYS return type "complete" with the deliverable in "body". Do NOT keep iterating after the goal is achieved.
+
+Return only valid JSON. No prose outside the JSON block.`;
+/**
+ * Build the per-step user prompt. Includes the goal, recent steps, and
+ * current spend. Kept deliberately compact to fit alongside the catalog
+ * of available actions that the consumer may choose to append.
+ */
+export function buildGoalStepUserPrompt(goal, previousSteps, spentNook, budgetNook) {
+    const spent = spentNook.toString();
+    const budget = budgetNook.toString();
+    const stepsText = previousSteps.length === 0
+        ? "(no previous steps)"
+        : previousSteps
+            .slice(-8)
+            .map((s, i) => `${i + 1}. ${s.actionType ?? "?"}: ${(s.outputSummary ?? "").slice(0, 180)}`)
+            .join("\n");
+    return `Goal: ${goal}
+
+Previous steps:
+${stepsText}
+
+Spent so far: ${spent} / ${budget} NOOK (soft cap)
+
+Choose the next action. Return JSON only.`;
+}
+//# sourceMappingURL=goalPrompts.js.map

package/dist/goal/goalPrompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goalPrompts.js","sourceRoot":"","sources":["../../src/goal/goalPrompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;yDAoBkB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,aAAiF,EACjF,SAAiB,EACjB,UAAkB;IAElB,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,KAAK,CAAC;QAC1C,CAAC,CAAC,qBAAqB;QACvB,CAAC,CAAC,aAAa;aACV,KAAK,CAAC,CAAC,CAAC,CAAC;aACT,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,UAAU,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;aAC3F,IAAI,CAAC,IAAI,CAAC,CAAC;IAElB,OAAO,SAAS,IAAI;;;EAGpB,SAAS;;gBAEK,KAAK,MAAM,MAAM;;0CAES,CAAC;AAC3C,CAAC"}

package/dist/goal/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Goal loop types — shared interfaces for the L3 autonomous goal execution loop.
+ *
+ * @module goal/types
+ */
+import type { NookplotRuntime } from "../index.js";
+/**
+ * One action the LLM can return each turn of the goal loop.
+ * Parsed from the model's JSON response.
+ */
+export type GoalAction = {
+    type: "action";
+    actionName: string;
+    actionParams: Record<string, unknown>;
+    description: string;
+} | {
+    type: "complete";
+    title: string;
+    body: string;
+    domain: string;
+    description: string;
+} | {
+    type: "noop";
+    description: string;
+} | {
+    type: "needs_capability";
+    description: string;
+    suggestedPreset?: string;
+};
+/**
+ * Terminal state of a GoalLoop.run() invocation. Always one of the four
+ * outcomes — the loop never throws for normal termination conditions.
+ */
+export type GoalResult = {
+    outcome: "complete";
+    artifact: {
+        title: string;
+        body: string;
+        domain: string;
+    };
+    stepsExecuted: number;
+    spentNook: bigint;
+} | {
+    outcome: "blocked_budget";
+    spentNook: bigint;
+    /** USDC base units spent via `pay_api` when the hard `budgetUsdc` cap
+     *  halted the loop. (The legacy `budgetNook` cap is soft/warn-only and
+     *  never produces this outcome.) */
+    spentUsdcBaseUnits: bigint;
+} | {
+    outcome: "blocked_stuck";
+    stuckReason: string;
+    spentNook: bigint;
+} | {
+    outcome: "blocked_capability";
+    capabilityNeeded: string;
+    suggestedPreset?: string;
+    spentNook: bigint;
+};
+/**
+ * Configuration for a single run of the GoalLoop.
+ */
+export interface GoalLoopOptions {
+    runtime: NookplotRuntime;
+    goal: string;
+    /** Soft cap — loop continues past this but emits a warning. */
+    budgetNook: bigint;
+    parentSwarmId?: string | null;
+    /** Hard stop on step count. Default 20. */
+    maxSteps?: number;
+    /** Hard stop on consecutive no-op responses. Default 3. */
+    maxConsecutiveNoops?: number;
+    /** Hard stop on consecutive identical step descriptions. Default 3. */
+    maxReformulations?: number;
+    /** Optional verbose logging. */
+    verbose?: boolean;
+    /**
+     * Optional LLM caller — defaults to runtime.economy.inference or a runtime
+     * provided by the consumer. The caller is abstracted because different
+     * environments wire inference differently (platform / BYOK / Ollama).
+     */
+    inferenceCall?: (input: {
+        systemPrompt: string;
+        userPrompt: string;
+        maxTokens: number;
+        temperature: number;
+    }) => Promise<{
+        content: string;
+        costNook?: number;
+    }>;
+}
+/**
+ * Result of executing a single step within the goal loop.
+ * costNook is optional because many actions are free (off-chain tools).
+ */
+export interface StepExecutionResult {
+    ok: boolean;
+    output: string;
+    costNook: number;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/goal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/goal/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB;;wCAEoC;IACpC,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GACD;IACE,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,OAAO,EAAE,oBAAoB,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/goal/types.js

@@ -0,0 +1,7 @@
+/**
+ * Goal loop types — shared interfaces for the L3 autonomous goal execution loop.
+ *
+ * @module goal/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/goal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/goal/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}