@nookplot/runtime 0.5.140 → 0.5.142

package/dist/autonomous.js

@@ -40,11 +40,11 @@
  * @module autonomous
  */
 import { prepareSignRelay } from "./signing.js";
+import { runFrontierPass } from "./frontierPass.js";
 import { wrapUntrusted, sanitizeForPrompt, UNTRUSTED_CONTENT_INSTRUCTION } from "./contentSafety.js";
 import { getAvailableActionsFromMap } from "./signalActionMap.js";
 import { getCategoryListing, getToolsInCategory } from "./actionCatalog.js";
 import { WakeUpStack } from "./wakeUpStack.js";
-import { GoalLoop } from "./goal/goalLoop.js";
 import { hooks as defaultHooks } from "./hooks.js";
 import { guardrails as defaultGuardrails, GuardrailTripped, InputGuardrailTripped, } from "./guardrails.js";
 import { buildCorrectivePrompt, checkForDoomLoopFromSignatures, makeSignature, } from "./doomLoop.js";
@@ -243,21 +243,6 @@ export class AutonomousAgent {
         if (this.verbose) {
             console.log("[autonomous] AutonomousAgent started — handling signals + actions");
         }
-        // Pre-load tool categories so the LLM always has web_search +
-        // search_knowledge visible without a browse_tools cold-start.
-        // Saves ~1 LLM turn per goal-driven agent and simplifies the first
-        // step for reactive agents too (CLAUDE.md rule — small code change).
-        this.loadedCategories.add("tools");
-        this.loadedCategories.add("discovery");
-        this.loadedCategories.add("knowledge");
-        // Goal bootstrap — run the GoalLoop in background if this agent was
-        // forged with initial_goal set (L1 swarm auto-deploy). Failures are
-        // non-fatal: the agent continues in normal reactive mode.
-        this.maybeBootstrapGoal().catch((err) => {
-            if (this.verbose) {
-                console.error("[autonomous] Goal bootstrap failed:", err);
-            }
-        });
     }
     /** Stop the autonomous agent. */
     stop() {
@@ -267,157 +252,6 @@ export class AutonomousAgent {
         }
     }
     // ================================================================
-    //  Goal bootstrap (L3 — migration 247)
-    // ================================================================
-    /**
-     * Check whether this agent has an initial_goal + pending status, and
-     * if so, spin up a GoalLoop in the background. Non-blocking — start()
-     * returns immediately so WebSocket signal subscriptions are live even
-     * while the goal loop is running its first step.
-     */
-    async maybeBootstrapGoal() {
-        let goalConfig;
-        try {
-            goalConfig = await this.runtime.identity.getGoal();
-        }
-        catch (err) {
-            if (this.verbose) {
-                console.error("[autonomous] getGoal failed — treating as no goal:", err);
-            }
-            return;
-        }
-        if (!goalConfig || !goalConfig.initialGoal)
-            return;
-        if (goalConfig.goalStatus !== "pending") {
-            if (this.verbose) {
-                console.log(`[autonomous] Skipping goal bootstrap — status is ${goalConfig.goalStatus}, not 'pending'`);
-            }
-            return;
-        }
-        if (this.verbose) {
-            console.log(`[autonomous] Goal bootstrap: "${goalConfig.initialGoal.slice(0, 80)}..." budget=${goalConfig.goalBudgetNook ?? "unlimited"}`);
-        }
-        // Transition status atomically before running the loop. If the
-        // gateway rejects (network, permissions), bail out — we do not want
-        // to run the loop with a mismatched DB state.
-        try {
-            await this.runtime.identity.updateGoalStatus("in_progress");
-        }
-        catch (err) {
-            if (this.verbose) {
-                console.error("[autonomous] Failed to transition goal → in_progress:", err);
-            }
-            return;
-        }
-        const budgetNook = goalConfig.goalBudgetNook ? BigInt(goalConfig.goalBudgetNook) : 0n;
-        const loopOptions = {
-            runtime: this.runtime,
-            goal: goalConfig.initialGoal,
-            budgetNook,
-            parentSwarmId: goalConfig.goalParentSwarmId,
-            verbose: this.verbose,
-        };
-        const loop = new GoalLoop(loopOptions);
-        let result;
-        try {
-            result = await loop.run();
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (this.verbose) {
-                console.error("[autonomous] GoalLoop threw:", err);
-            }
-            // Transition to failed so the UI reflects the error.
-            await this.runtime.identity.updateGoalStatus("failed").catch(() => { });
-            await this.runtime.identity.createPendingTask({
-                reason: "unclear_goal",
-                description: `Goal loop crashed: ${msg.slice(0, 400)}`,
-                parentSwarmId: goalConfig.goalParentSwarmId,
-            }).catch(() => { });
-            return;
-        }
-        await this.handleGoalResult(result, goalConfig);
-    }
-    /**
-     * Dispatch on the terminal state of a GoalLoop run:
-     *   - complete       → store artifact in private KG, pause agent
-     *   - blocked_budget → create pending task (budget_exhausted), pause
-     *   - blocked_stuck  → create pending task (stuck_3x), pause
-     *   - blocked_capability → create pending task (needs_capability), pause
-     */
-    async handleGoalResult(result, goalConfig) {
-        if (result.outcome === "complete") {
-            // Store deliverable in private KG
-            let artifactId = null;
-            try {
-                const storeResult = (await this.runtime.connection.request("POST", "/v1/agents/me/knowledge", {
-                    contentText: result.artifact.body,
-                    title: result.artifact.title,
-                    domain: result.artifact.domain,
-                    visibility: "private",
-                    knowledgeType: "fact",
-                    sourceType: "import",
-                    metadata: {
-                        goal: goalConfig.initialGoal,
-                        parentSwarmId: goalConfig.goalParentSwarmId,
-                        stepsExecuted: result.stepsExecuted,
-                        spentNook: result.spentNook.toString(),
-                    },
-                }));
-                artifactId = storeResult?.id ?? null;
-            }
-            catch (err) {
-                if (this.verbose) {
-                    console.error("[autonomous] Failed to store goal artifact:", err);
-                }
-            }
-            try {
-                await this.runtime.identity.completeGoal(artifactId ?? "unknown");
-            }
-            catch (err) {
-                if (this.verbose) {
-                    console.error("[autonomous] completeGoal failed:", err);
-                }
-            }
-            // Q3: agent pauses after completion, does not stay reactive
-            this.stop();
-            return;
-        }
-        if (result.outcome === "blocked_budget") {
-            // initialGoal is non-null here — maybeBootstrapGoal returned early otherwise.
-            const goalText = goalConfig.initialGoal ?? "(unknown)";
-            await this.runtime.identity.createPendingTask({
-                reason: "budget_exhausted",
-                description: `Needs top-off to continue goal: ${goalText.slice(0, 300)}`,
-                parentSwarmId: goalConfig.goalParentSwarmId,
-            }).catch(() => { });
-            await this.runtime.identity.updateGoalStatus("paused_awaiting_topoff").catch(() => { });
-            this.stop();
-            return;
-        }
-        if (result.outcome === "blocked_stuck") {
-            await this.runtime.identity.createPendingTask({
-                reason: "stuck_3x",
-                description: result.stuckReason,
-                parentSwarmId: goalConfig.goalParentSwarmId,
-            }).catch(() => { });
-            await this.runtime.identity.updateGoalStatus("blocked_needs_decision").catch(() => { });
-            this.stop();
-            return;
-        }
-        if (result.outcome === "blocked_capability") {
-            await this.runtime.identity.createPendingTask({
-                reason: "needs_capability",
-                description: result.capabilityNeeded,
-                suggestedPresetId: result.suggestedPreset,
-                parentSwarmId: goalConfig.goalParentSwarmId,
-            }).catch(() => { });
-            await this.runtime.identity.updateGoalStatus("blocked_needs_decision").catch(() => { });
-            this.stop();
-            return;
-        }
-    }
-    // ================================================================
     //  Signal handling (proactive.signal)
     // ================================================================
     /**
@@ -499,8 +333,6 @@ export class AutonomousAgent {
                 return `proj_bounty_done:${data.bountyId ?? ""}`;
             case "guild_opportunity":
                 return `guild:${data.guildId ?? ""}:${addr}`;
-            case "workspace_opportunity":
-                return `workspace:${data.workspaceId ?? data.sourceId ?? ""}:${addr}`;
             case "team_assembly_suggested":
                 return `team_suggest:${data.txHash ?? ""}`;
             case "team_invitation":
@@ -650,7 +482,9 @@ export class AutonomousAgent {
             case "community_gap":
                 await this.handleCommunityGap(data);
                 break;
-            // DD-7: directive case removed — swarm coordination uses DMs
+            case "directive":
+                await this.handleDirective(data);
+                break;
             case "files_committed":
                 await this.handleFilesCommitted(data);
                 break;
@@ -763,10 +597,6 @@ export class AutonomousAgent {
             case "guild_opportunity":
                 await this.handleGuildOpportunity(data);
                 break;
-            // ── Open Cognitive Workspaces (P3): discoverable/open workspace to join ──
-            case "workspace_opportunity":
-                await this.handleWorkspaceOpportunity(data);
-                break;
             // ── Mining signals ──
             case "mining_opportunity":
                 await this.handleMiningOpportunity(data);
@@ -1293,51 +1123,6 @@ export class AutonomousAgent {
                 console.error("[autonomous] Guild opportunity handling failed:", err);
         }
     }
-    async handleWorkspaceOpportunity(data) {
-        const meta = data;
-        const name = meta.name ?? meta.title ?? "Unknown Workspace";
-        const workspaceId = meta.workspaceId ?? meta.sourceId ?? "";
-        const visibility = meta.visibility ?? "discoverable";
-        const description = meta.description ?? data.messagePreview ?? "";
-        const memberCount = meta.memberCount ?? 0;
-        const regionCounts = meta.regionCounts ?? {};
-        const openJoinRole = meta.openJoinRole ?? 0;
-        try {
-            const isOpen = visibility === "open";
-            const joinNote = isOpen
-                ? `You can self-join instantly (you would join as ${openJoinRole === 1 ? "editor" : "viewer"}).`
-                : "You can request to join; the owner approves.";
-            const regionSummary = Object.entries(regionCounts)
-                .map(([r, c]) => `${r}: ${c}`)
-                .join(", ") || "no cognitive state yet";
-            const prompt = `${UNTRUSTED_CONTENT_INSTRUCTION}\n\n` +
-                "A cognitive workspace opportunity was found on Nookplot.\n" +
-                `Workspace: ${sanitizeForPrompt(name)}\n` +
-                `Description: ${wrapUntrusted(description, "workspace description")}\n` +
-                `Visibility: ${visibility}\n` +
-                `Members: ${memberCount}\n` +
-                `Cognitive state: ${sanitizeForPrompt(regionSummary)}\n` +
-                `ID: ${workspaceId}\n` +
-                `${joinNote}\n\n` +
-                "Should you join this workspace to collaborate on its shared reasoning state? Respond with INTERESTED or SKIP.\n" +
-                "If interested, briefly explain why (under 200 chars).\n\n" +
-                "Format:\nDECISION: INTERESTED or SKIP\nREASON: why you want to join";
-            const response = await this.generateResponse(prompt);
-            const text = response?.trim() ?? "";
-            if (text.toUpperCase().includes("INTERESTED")) {
-                if (this.verbose) {
-                    console.log(`[autonomous] ✓ Interested in workspace "${name}" (supervised — join surfaced as an action)`);
-                }
-                // Joining is surfaced as an available action (join_workspace /
-                // request_workspace_join) for the agent's decision loop — not
-                // auto-executed here (adversarial default: no auto-join).
-            }
-        }
-        catch (err) {
-            if (this.verbose)
-                console.error("[autonomous] Workspace opportunity handling failed:", err);
-        }
-    }
     async handleMiningOpportunity(data) {
         const meta = data;
         const opportunityType = meta.opportunityType ?? "unknown";
@@ -2230,7 +2015,40 @@ export class AutonomousAgent {
                 console.error("[autonomous] Community gap handling failed:", err);
         }
     }
-    // DD-7: handleDirective removed — swarm coordination uses DMs exclusively
+    async handleDirective(data) {
+        const directiveContent = data.messagePreview ?? "";
+        const channelId = data.channelId;
+        const community = data.community ?? "general";
+        try {
+            const prompt = `${UNTRUSTED_CONTENT_INSTRUCTION}\n\n` +
+                "You received a directive on Nookplot.\n" +
+                `Directive:\n${wrapUntrusted(directiveContent, "directive")}\n\n` +
+                "Follow the directive and compose your response.\n" +
+                "If it asks you to post, write the post content.\n" +
+                "If it asks you to discuss, write a discussion message.\n" +
+                "If you can't follow this directive, respond with exactly: [SKIP]\n\n" +
+                "Your response (under 500 chars):";
+            const response = await this.generateResponse(prompt);
+            const content = response?.trim() ?? "";
+            if (content && content !== "[SKIP]") {
+                if (channelId) {
+                    await this.runtime.channels.send(channelId, content);
+                    if (this.verbose)
+                        console.log(`[autonomous] ✓ Directive response sent to channel ${channelId.slice(0, 12)}`);
+                }
+                else {
+                    const title = content.slice(0, 100);
+                    await this.runtime.memory.publishKnowledge({ title, body: content, community });
+                    if (this.verbose)
+                        console.log(`[autonomous] ✓ Directive response posted in ${community}`);
+                }
+            }
+        }
+        catch (err) {
+            if (this.verbose)
+                console.error("[autonomous] Directive handling failed:", err);
+        }
+    }
     // ================================================================
     //  Project collaboration signal handlers
     // ================================================================
@@ -2864,6 +2682,16 @@ export class AutonomousAgent {
     // ================================================================
     //  Action request handling (proactive.action.request)
     // ================================================================
+    /**
+     * Execute a `use_frontier_model` action — delegates to the shared
+     * {@link runFrontierPass} so the runtime + CLI dispatch paths can't drift on
+     * this money path. Consumes an owner-reserved pass, runs a one-shot Surplus
+     * completion paid by the agent's OWN x402 key, finalizes (or reverts on
+     * failure). Returns the frontier answer, or an `{ error }` tool result.
+     */
+    async executeFrontierPass(args, agentAddress) {
+        return runFrontierPass(this.runtime.connection, this.runtime.economy, args, agentAddress);
+    }
     async handleActionRequest(event) {
         if (!this.isRunning)
             return;
@@ -2917,18 +2745,6 @@ export class AutonomousAgent {
                 triggers: this.doomLoopTriggers,
                 actionType,
             });
-            // Track C.2: also push to gateway as fire-and-forget telemetry so
-            // ops dashboards can answer "which tools most often misbehave?"
-            // and "is this agent stuck right now?" — see
-            // gateway/src/services/doomLoopMetrics.ts. Errors are swallowed so
-            // a backend outage never blocks the runtime's recovery path.
-            void this.runtime.connection
-                .request("POST", "/v1/agents/me/doom-loop-event", {
-                offender: doomOffender,
-                triggers: this.doomLoopTriggers,
-                actionType,
-            })
-                .catch(() => { });
             if (this.doomLoopTriggers >= AUTONOMOUS_DOOM_LOOP_MAX_TRIGGERS) {
                 if (this.verbose) {
                     console.warn(`[autonomous] ✗ doom loop on '${doomOffender}' (${this.doomLoopTriggers} triggers) — aborting cycle`);
@@ -3034,6 +2850,24 @@ export class AutonomousAgent {
                 });
                 return;
             }
+            // ── Intercept use_frontier_model (client-executed frontier pass) ──
+            // Not a gateway tool: consume an owner-reserved pass, run a one-shot
+            // Surplus completion paid by the agent's OWN client-signed x402 key, then
+            // finalize (or revert on failure). The gateway can't run this
+            // non-custodially. See ROADMAP_frontier-passes.md.
+            if (actionType === "use_frontier_model") {
+                result = await this.executeFrontierPass(args, agentAddress);
+                result = await guardrails.runOutput(actionType, result);
+                hooks.emitFireAndForget("tool_output", { toolName: actionType, args, result });
+                if (actionId)
+                    await this.runtime.proactive.completeAction(actionId, undefined, result);
+                if (this.verbose)
+                    console.log(`[autonomous] ✓ use_frontier_model`);
+                hooks.emitFireAndForget("action_end", {
+                    actionType, args, result, durationMs: Date.now() - startTime, actionId,
+                });
+                return;
+            }
             // ── Unified dispatch via POST /v1/actions/execute ──
             // The gateway's ToolDispatcher routes the call to the correct internal
             // endpoint, replacing the 2000+ line switch statement that was here before.