@nookplot/runtime 0.5.120 → 0.5.121

package/dist/autonomous.d.ts

@@ -126,6 +126,16 @@ export interface AutonomousAgentOptions {
  * ```
  */
 export declare function getAvailableActions(signalType: string, loadedCategories?: Set<string>): string[];
+/**
+ * Maps a `mining_opportunity` signal's optional `track` field to the
+ * track-specific action set the agent's brain should consider. Values are
+ * comma-joined strings ready to drop into the prompt's "Available actions"
+ * line.
+ *
+ * Unknown / missing track falls back to the generic mining action list —
+ * preserves pre-Phase-3 behaviour for callers that don't set `track`.
+ */
+export declare function availableActionsForTrack(track: string): string;
 export declare class AutonomousAgent {
     private readonly runtime;
     private readonly verbose;
@@ -158,6 +168,21 @@ export declare class AutonomousAgent {
     start(): void;
     /** Stop the autonomous agent. */
     stop(): void;
+    /**
+     * 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.
+     */
+    private maybeBootstrapGoal;
+    /**
+     * 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
+     */
+    private handleGoalResult;
     /**
      * Build a stable dedup key from a signal so we can detect duplicates.
      * DMs dedup on sender, followers dedup on address, channels dedup on channel+sender.
@@ -202,7 +227,6 @@ export declare class AutonomousAgent {
     private handleOnboardingSuggestion;
     private handleSpecializationPath;
     private handleCommunityGap;
-    private handleDirective;
     private handleFilesCommitted;
     private handleReviewSubmitted;
     private handleCollaboratorAdded;

package/dist/autonomous.d.ts.map

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

package/dist/autonomous.js

@@ -44,6 +44,7 @@ import { wrapUntrusted, sanitizeForPrompt, UNTRUSTED_CONTENT_INSTRUCTION } from
 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";
@@ -94,6 +95,10 @@ const ON_CHAIN_ACTIONS = new Set([
     "vote_kick_guild_member",
     "mining_counter_argument", "mining_defend_trace",
     "claim_mining_subtask", "submit_subtask_trace",
+    // RLM trajectory submission — symmetric with submit_reasoning_trace per
+    // 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",
@@ -139,6 +144,29 @@ const ON_CHAIN_ACTIONS = new Set([
 export function getAvailableActions(signalType, loadedCategories) {
     return getAvailableActionsFromMap(signalType, loadedCategories ?? new Set());
 }
+/**
+ * Maps a `mining_opportunity` signal's optional `track` field to the
+ * track-specific action set the agent's brain should consider. Values are
+ * comma-joined strings ready to drop into the prompt's "Available actions"
+ * line.
+ *
+ * Unknown / missing track falls back to the generic mining action list —
+ * preserves pre-Phase-3 behaviour for callers that don't set `track`.
+ */
+export function availableActionsForTrack(track) {
+    switch (track) {
+        case "knowledge":
+            return "discover_mining_challenges, get_mining_challenge, submit_reasoning_trace, upload_mining_content";
+        case "embedding":
+            return "list_embedding_challenges, submit_embeddings";
+        case "rlm":
+            return "discover_mining_challenges, get_mining_challenge, rlm_repl_exec, rlm_repl_llm_query, rlm_repl_finalize";
+        case "gradient":
+            return "discover_mining_challenges, get_mining_challenge"; // gradient solver still TBD
+        default:
+            return "discover_mining_challenges, get_mining_challenge, submit_reasoning_trace, upload_mining_content";
+    }
+}
 export class AutonomousAgent {
     runtime;
     verbose;
@@ -211,6 +239,21 @@ 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() {
@@ -220,6 +263,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)
     // ================================================================
     /**
@@ -450,9 +644,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;
@@ -1098,6 +1290,12 @@ export class AutonomousAgent {
         const challengeId = meta.challengeId ?? "";
         const difficulty = meta.difficulty ?? "";
         const domainTags = meta.domainTags ?? [];
+        // Phase 3d: optional `track` discriminator routes the prompt's "Available
+        // actions" hint to the right per-track action set so the agent's brain
+        // suggests the appropriate solver tool. `track` is informational — the
+        // existing dispatch surface still handles every action via the unified
+        // POST /v1/actions/execute route.
+        const track = meta.track ?? "";
         try {
             let prompt = `${UNTRUSTED_CONTENT_INSTRUCTION}\n\nA mining opportunity was found on Nookplot.\n`;
             if (opportunityType === "open_challenge") {
@@ -1105,8 +1303,10 @@ export class AutonomousAgent {
                 prompt += `Challenge: ${sanitizeForPrompt(challengeId)}\n`;
                 prompt += `Difficulty: ${difficulty}\n`;
                 prompt += `Domains: ${domainTags.join(", ")}\n\n`;
+                if (track)
+                    prompt += `Track: ${sanitizeForPrompt(track)}\n`;
                 prompt += "Should you attempt this challenge? Consider your expertise and current staking tier.\n";
-                prompt += "Available actions: discover_mining_challenges, get_mining_challenge, submit_reasoning_trace, upload_mining_content\n";
+                prompt += `Available actions: ${availableActionsForTrack(track)}\n`;
             }
             else if (opportunityType === "unclaimed_royalties") {
                 prompt += `Type: Unclaimed mining rewards\n`;
@@ -1971,40 +2171,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
     // ================================================================
@@ -2691,6 +2858,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`);