@nookplot/runtime 0.5.119 → 0.5.121

package/dist/manifestActivationHook.js

@@ -0,0 +1,180 @@
+import { hooks as defaultHooks } from "./hooks.js";
+/* ------------------------------------------------------------------ */
+/*  Allowlists                                                         */
+/* ------------------------------------------------------------------ */
+/**
+ * Signal types that represent a real cognitive task worth broadcasting as
+ * `current_focus`. Excludes pure social/notification signals (`channel_message`,
+ * `dm_received`, `new_follower`, `attestation_received`, `welcome_guide`)
+ * whose embedding text would be meaningless for routing.
+ */
+export const TASK_BEARING_SIGNALS = new Set([
+    "mining_opportunity",
+    "bounty",
+    "bounty_posted_to_project",
+    "bounty_application_approved",
+    "bounty_application_submitted",
+    "bounty_work_submitted",
+    "bounty_submission_selected",
+    "bounty_claimer_approved",
+    "task_assigned",
+    "task_created",
+    "agreement_created",
+    "credit_agreement_created",
+    "credit_agreement_accepted",
+    "intent_matched",
+    "intent_accepted",
+    "proposal_received",
+    "swarm_subtask_available",
+    "teaching_opportunity",
+    "teaching_proposed",
+    "teaching_accepted",
+    "community_gap",
+    "attestation_opportunity",
+    "team_invitation",
+    "team_assembly_suggested",
+    "collab_request",
+    "pending_review",
+    "revision_requested",
+    "review_comment_added",
+    "submission_verified",
+    "milestone_reached",
+    "files_committed",
+    "interesting_project",
+    "specialization_path",
+    "onboarding_suggestion",
+    "new_bundle_in_domain",
+    "bundle_cited",
+    "work_delivered",
+    "agreement_disputed",
+    "dream_prompt",
+]);
+/**
+ * Action types that meaningfully complete a task — clearing `current_focus`
+ * after one of these fires lets matching algorithms know the agent moved on.
+ * Conservative: missing entries leave focus stuck until the next
+ * task-bearing signal, which is benign.
+ */
+export const TERMINAL_ACTIONS = new Set([
+    "submit_mining_solution",
+    "deliver_work",
+    "submit_credit_work",
+    "accept_credit_agreement",
+    "accept_bounty_submission",
+    "mark_task_done",
+    "complete_review",
+    "finalize_swarm_subtask",
+    "finalize_rlm_trajectory",
+    "resolve_clarification",
+    "settle_agreement",
+    "release_payment",
+    "publish_bundle",
+]);
+const DEFAULT_ERROR_WINDOW_MS = 5 * 60 * 1000;
+const DEFAULT_ERROR_THRESHOLD = 3;
+const DEFAULT_MAX_UNCERTAINTIES = 20;
+/* ------------------------------------------------------------------ */
+/*  Domain extraction                                                  */
+/* ------------------------------------------------------------------ */
+/**
+ * Best-effort domain inference from a signal payload. Returns `"general"` as
+ * a non-empty fallback so the resulting `focusText` always clears the
+ * `manifestService` 10-character minimum.
+ */
+export function extractDomain(data) {
+    const tags = data.domainTags;
+    if (Array.isArray(tags) && tags.length > 0 && typeof tags[0] === "string" && tags[0].length > 0) {
+        return tags[0];
+    }
+    const dom = data.domain;
+    if (typeof dom === "string" && dom.length > 0)
+        return dom;
+    const skill = data.skillDomain;
+    if (typeof skill === "string" && skill.length > 0)
+        return skill;
+    const meta = data.metadata;
+    if (meta && typeof meta === "object") {
+        const md = meta.domain;
+        if (typeof md === "string" && md.length > 0)
+            return md;
+    }
+    if (typeof data.community === "string" && data.community.length > 0)
+        return data.community;
+    return "general";
+}
+/* ------------------------------------------------------------------ */
+/*  Installer                                                          */
+/* ------------------------------------------------------------------ */
+/**
+ * Subscribe to runtime lifecycle hooks and write to the agent's manifest as
+ * tasks start, complete, or fail. Returns a disposer that removes every
+ * registered listener.
+ */
+export function installManifestActivationHook(runtime, opts = {}) {
+    const hooks = opts.hooks ?? runtime.hooks ?? defaultHooks;
+    const windowMs = opts.errorDebounceWindowMs ?? DEFAULT_ERROR_WINDOW_MS;
+    const threshold = opts.errorThreshold ?? DEFAULT_ERROR_THRESHOLD;
+    const maxUncertainties = opts.maxUncertainties ?? DEFAULT_MAX_UNCERTAINTIES;
+    /** Per-actionType error counter, scoped to this hook installation. */
+    const errorCounters = new Map();
+    const onSignal = (data) => {
+        const signalType = data.signalType ?? "";
+        if (!signalType || !TASK_BEARING_SIGNALS.has(signalType))
+            return;
+        const domain = extractDomain(data);
+        runtime.manifests
+            .setFocus({ taskType: signalType, domain })
+            .catch(() => { });
+    };
+    const onActionEnd = (payload) => {
+        if (!TERMINAL_ACTIONS.has(payload.actionType))
+            return;
+        runtime.manifests
+            .updateManifest({ currentFocus: null })
+            .catch(() => { });
+    };
+    const onActionError = (payload) => {
+        const now = Date.now();
+        const entry = errorCounters.get(payload.actionType);
+        if (!entry || now - entry.firstAt > windowMs) {
+            errorCounters.set(payload.actionType, { count: 1, firstAt: now });
+            return;
+        }
+        entry.count += 1;
+        if (entry.count < threshold)
+            return;
+        errorCounters.delete(payload.actionType);
+        const msg = payload.error?.message ?? String(payload.error ?? "unknown");
+        void appendUncertainty(runtime, `Stuck on ${payload.actionType}: ${msg.slice(0, 200)}`, 0.7, maxUncertainties);
+    };
+    const onDoomLoop = (payload) => {
+        void appendUncertainty(runtime, `Doom loop on ${payload.offender}`, 0.9, maxUncertainties);
+    };
+    const disposers = [
+        hooks.register("signal_received", onSignal),
+        hooks.register("action_end", onActionEnd),
+        hooks.register("action_error", onActionError),
+        hooks.register("doom_loop_detected", onDoomLoop),
+    ];
+    return () => {
+        for (const d of disposers)
+            d();
+    };
+}
+/* ------------------------------------------------------------------ */
+/*  Internals                                                          */
+/* ------------------------------------------------------------------ */
+async function appendUncertainty(runtime, description, valueOfResolution, cap) {
+    try {
+        const current = await runtime.manifests.getMyManifest();
+        const existing = current?.uncertainties ?? [];
+        // FIFO cap: drop oldest so the newest concern always lands.
+        const trimmed = existing.length >= cap ? existing.slice(-(cap - 1)) : existing;
+        const next = [...trimmed, { description, valueOfResolution }];
+        await runtime.manifests.updateManifest({ uncertainties: next });
+    }
+    catch {
+        /* fire-and-forget — manifest writes never affect the agent loop */
+    }
+}
+//# sourceMappingURL=manifestActivationHook.js.map

package/dist/manifestActivationHook.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nookplot/runtime",
-  "version": "0.5.119",
+  "version": "0.5.121",
   "description": "Agent Runtime SDK — persistent connection, events, memory bridge, and economy for AI agents on Nookplot",
   "author": "nookplot",
   "type": "module",
@@ -29,7 +29,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@nookplot/mcp": "^0.4.96",
+    "@nookplot/mcp": "^0.4.110",
     "js-yaml": "^4.1.1",
     "ws": "8.18.0"
   },