@nookplot/runtime 0.5.147 → 0.5.148

package/dist/autonomous.js

@@ -40,12 +40,13 @@
  * @module autonomous
  */
 import { prepareSignRelay } from "./signing.js";
-import { runFrontierPass } from "./frontierPass.js";
+import { formatUsdc } from "./usdcBudget.js";
 import { wrapUntrusted, sanitizeForPrompt, UNTRUSTED_CONTENT_INSTRUCTION } from "./contentSafety.js";
 import { getAvailableActionsFromMap, resolveDispatchToolName, CORE_ACTIONS } from "./signalActionMap.js";
 import { resolvePackActions } from "./pack.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";
@@ -63,7 +64,7 @@ const ON_CHAIN_ACTIONS = new Set([
     "cancel_bounty", "unclaim_bounty",
     "expire_disputed_bounty", "sweep_treasury_fees", // V8
     "sweep_creator_refund", // V9 H4 admin recovery
-    "create_listing", "list_service", "update_service", "create_agreement",
+    "create_listing", "list_service", "update_service", "create_agreement", "api_onboard",
     "deliver_work", "settle_agreement", "dispute_agreement", "cancel_agreement",
     "expire_dispute", "expire_delivered",
     "deploy_preview",
@@ -101,7 +102,6 @@ const ON_CHAIN_ACTIONS = new Set([
     // roadmap §1h Decision 11. Approval-gates the submission before the gateway
     // pipes the artifact through /submit-solution → submitRlmTrajectory.
     "submit_rlm",
-    // API marketplace on-chain actions use existing service/* prepare endpoints
     // Social (missing)
     "remove_vote", "revoke_attestation",
     // Bounty lifecycle (missing)
@@ -125,6 +125,9 @@ const ON_CHAIN_ACTIONS = new Set([
     "claim_pending_guild_mining_treasury",
     // Ecosystem partner protocols (raw-tx, agent pays own gas)
     "ecosystem_stake_tokens", "ecosystem_claim_rewards",
+    // Per-call x402 API purchase (client-signed EIP-3009 USDC auth, spends real
+    // USDC) — gated for the same reason as ecosystem_*: it moves the agent's money.
+    "pay_api",
     // V11: Multi-payout Open bounties (6 actions — creator + submitter + recovery)
     "create_open_bounty", "submit_open_bounty", "approve_open_submission",
     "top_up_open_bounty", "close_open_bounty", "sweep_worker_payout",
@@ -269,6 +272,13 @@ 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");
         // External MCP tools — loaded once at boot so mounted servers' tools
         // surface in getAvailableActions and dispatch as `mcp:<server>:<tool>`.
         this.refreshExternalMcpActions().catch((err) => {
@@ -276,6 +286,14 @@ export class AutonomousAgent {
                 console.error("[autonomous] External MCP tool load failed:", err);
             }
         });
+        // 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() {
@@ -285,6 +303,157 @@ 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)
     // ================================================================
     /**
@@ -366,6 +535,8 @@ 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":
@@ -515,9 +686,7 @@ export class AutonomousAgent {
             case "community_gap":
                 await this.handleCommunityGap(data);
                 break;
-            case "directive":
-                await this.handleDirective(data);
-                break;
+            // DD-7: directive case removed — swarm coordination uses DMs
             case "files_committed":
                 await this.handleFilesCommitted(data);
                 break;
@@ -630,6 +799,10 @@ 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);
@@ -1156,6 +1329,59 @@ 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;
+        const sourceType = meta.sourceType ?? "";
+        const sourceRef = meta.sourceRef ?? "";
+        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";
+            // Unit A (A3): surface the bounty linkage so the agent knows this is a
+            // team forming to compete for an open bounty, not a generic workspace.
+            const bountyLine = sourceType === "bounty" && sourceRef
+                ? `Bounty: this team is forming to compete for open bounty #${sanitizeForPrompt(sourceRef)}.\n`
+                : "";
+            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` +
+                bountyLine +
+                `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";
@@ -2052,40 +2278,7 @@ export class AutonomousAgent {
                 console.error("[autonomous] Community gap handling failed:", err);
         }
     }
-    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);
-        }
-    }
+    // DD-7: handleDirective removed — swarm coordination uses DMs exclusively
     // ================================================================
     //  Project collaboration signal handlers
     // ================================================================
@@ -2719,16 +2912,6 @@ 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;
@@ -2805,6 +2988,18 @@ 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`);
@@ -2910,21 +3105,43 @@ 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);
+            // ── Intercept pay_api (per-call x402 purchase) ──
+            // Client-side-signed like ecosystem_*: payAndCall signs an EIP-3009 USDC
+            // authorization with the agent's own key (the gateway is non-custodial), so
+            // it CANNOT route through the unified dispatch. The hard USDC spend cap
+            // (budgetUsdc) is enforced HERE, at the point of spend.
+            if (actionType === "pay_api") {
+                const privateKey = this.runtime.connection.privateKey;
+                if (!privateKey)
+                    throw new Error("pay_api requires the agent's private key (none configured)");
+                const budget = this.runtime.usdcBudget;
+                const maxForCall = budget.maxForNextCall(); // bigint | undefined; 0n = exhausted
+                if (maxForCall === 0n) {
+                    result = { paid: false, blocked: "usdc_budget_exhausted", reason: `USDC daily spend cap exhausted (spent ${formatUsdc(budget.spent)})` };
+                }
+                else {
+                    const { ethers } = await import("ethers");
+                    const wallet = new ethers.Wallet(privateKey);
+                    const payResult = await this.runtime.x402.payAndCall({
+                        listingId: args.listingId,
+                        path: String(args.path ?? ""),
+                        method: args.method,
+                        body: args.body,
+                        ...(maxForCall !== undefined ? { maxAmountBaseUnits: maxForCall } : {}),
+                    }, wallet);
+                    if (payResult.paid && payResult.amountPaidBaseUnits)
+                        budget.record(BigInt(payResult.amountPaidBaseUnits));
+                    result = { ...payResult };
+                }
                 result = await guardrails.runOutput(actionType, result);
                 hooks.emitFireAndForget("tool_output", { toolName: actionType, args, result });
+                // No txHash — the settlement tx is internal to the facilitator.
                 if (actionId)
                     await this.runtime.proactive.completeAction(actionId, undefined, result);
                 if (this.verbose)
-                    console.log(`[autonomous] ✓ use_frontier_model`);
+                    console.log(`[autonomous] ✓ pay_api listing=${String(args.listingId)} paid=${result.paid}`);
                 hooks.emitFireAndForget("action_end", {
-                    actionType, args, result, durationMs: Date.now() - startTime, actionId,
+                    actionType, args, result, durationMs: Date.now() - startTime, actionId, txHash: undefined,
                 });
                 return;
             }