@nookplot/runtime 0.5.131 → 0.5.132

package/dist/signalActionMap.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Signal Action Map — Single source of truth for which actions are available per signal type.
+ *
+ * Replaces the 4 duplicated `getAvailableActions()` switch statements that existed in:
+ * - cli/src/utils/agentLoop.ts
+ * - cli/src/commands/listen.ts
+ * - runtime/src/autonomous.ts
+ * - runtime-py/nookplot_runtime/autonomous.py
+ *
+ * New tools are auto-discoverable through their ACTION_CATALOG category via `browse_tools`.
+ * No switch statements to update when adding new tools.
+ */
+export type SelectionMode = "lenient" | "moderate" | "aggressive" | "strict";
+export declare const CORE_ACTIONS: string[];
+/**
+ * Signal type → MAD selection mode for WakeUpStack L2 retrieval.
+ *
+ * Derived from the retrieval focus each signal type needs:
+ *  - `aggressive` — focused 1:1 context (DMs, mentions, replies to own post).
+ *    Want 2–3 tight matches, not scattershot.
+ *  - `moderate` — standard working set (general channel activity, projects).
+ *  - `lenient` — exploratory, cross-domain (new projects, multi-step tasks).
+ *    Cast wide for synthesis.
+ *
+ * **Scope rule:** only signal types whose handlers actually reach
+ * `wakeUpStack.getContext()` live here. Adding an entry for a signal type whose
+ * handler doesn't call WakeUpStack is dead code — keep this table in sync with
+ * the handler wiring in `autonomous.ts`.
+ *
+ * Unmapped signal types fall back to `"moderate"` in `WakeUpStack.getContext()`.
+ */
+export declare const SIGNAL_SELECTION_MODE: Record<string, SelectionMode>;
+export declare const SIGNAL_CONTEXT_ACTIONS: Record<string, string[]>;
+/**
+ * Returns true when progressive disclosure is enabled for this process.
+ *
+ * Reads `NOOKPLOT_PROGRESSIVE_DISCLOSURE` from the environment. Default off —
+ * existing agents see no behavioral change unless they opt in.
+ */
+export declare function isProgressiveDisclosureEnabled(): boolean;
+/**
+ * Derive the full list of available actions for a given signal type and loaded categories.
+ *
+ * Default mode:
+ * 1. CORE_ACTIONS (always available, ~30)
+ * 2. SIGNAL_CONTEXT_ACTIONS for the signal type (contextual, 0-6)
+ * 3. All actions from loaded categories (dynamically loaded via browse_tools)
+ *
+ * Progressive disclosure mode (NOOKPLOT_PROGRESSIVE_DISCLOSURE=1):
+ *   Returns CORE_ACTIONS only — signal-context tools become discoverable only
+ *   via nookplot_search_skills + nookplot_load_skill. More aggressive than
+ *   browse_tools (which loads a category at a time).
+ *
+ * @param signalType - The signal type (e.g. "directive", "bounty_claimed")
+ * @param loadedCategories - Set of category names loaded via browse_tools
+ * @returns Deduplicated array of action names
+ */
+export declare function getAvailableActionsFromMap(signalType: string, loadedCategories: Set<string>): string[];
+//# sourceMappingURL=signalActionMap.d.ts.map

package/dist/signalActionMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalActionMap.d.ts","sourceRoot":"","sources":["../src/signalActionMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAC;AAM7E,eAAO,MAAM,YAAY,EAAE,MAAM,EA4BhC,CAAC;AAOF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAqB/D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA+L3D,CAAC;AAGF;;;;;GAKG;AACH,wBAAgB,8BAA8B,IAAI,OAAO,CAGxD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC5B,MAAM,EAAE,CA0BV"}

package/dist/signalActionMap.js

@@ -0,0 +1,305 @@
+/**
+ * Signal Action Map — Single source of truth for which actions are available per signal type.
+ *
+ * Replaces the 4 duplicated `getAvailableActions()` switch statements that existed in:
+ * - cli/src/utils/agentLoop.ts
+ * - cli/src/commands/listen.ts
+ * - runtime/src/autonomous.ts
+ * - runtime-py/nookplot_runtime/autonomous.py
+ *
+ * New tools are auto-discoverable through their ACTION_CATALOG category via `browse_tools`.
+ * No switch statements to update when adding new tools.
+ */
+import { ACTION_CATALOG } from "./actionCatalog.js";
+// ── Core Actions (~30) ──
+// Every agent gets these on every turn, regardless of signal type.
+// Designed for immediate usefulness without needing to browse categories.
+export const CORE_ACTIONS = [
+    // Meta
+    "ignore", "browse_tools",
+    // Communication
+    "reply", "send_dm", "send_message", "send_channel_message",
+    // Social
+    "follow", "vote", "comment_on_content",
+    // Discovery
+    "find_agents", "discover", "search_knowledge", "read_feed", "leaderboard",
+    // Swarm participation (available_subtasks is useless without claim/submit)
+    "available_subtasks", "claim_subtask", "submit_subtask_result",
+    // Identity
+    "my_profile", "check_balance", "update_profile",
+    // Content
+    "publish_insight", "post_content",
+    // Building (projects + bundles)
+    "create_project", "commit_files", "create_bundle",
+    "list_project_files", "read_project_file",
+    // Knowledge
+    "store_knowledge_item", "compile_knowledge",
+    // Memory
+    "store_memory", "recall_memory",
+    // Utility
+    "check_reputation", "get_comments",
+    // Latent space coordination
+    "discover_bundles_semantic", "update_manifest", "suggest_citations",
+    // Skill discovery (SRA — universal capability, not specialization-specific)
+    "search_skills", "load_skill",
+];
+// ── Signal Context Actions ──
+// Per-signal-type additions. Only the actions *specific* to that signal.
+// "reply" and "ignore" are in CORE_ACTIONS — excluded here (always available).
+// Cross-referenced across all 4 portals for consistency.
+/**
+ * Signal type → MAD selection mode for WakeUpStack L2 retrieval.
+ *
+ * Derived from the retrieval focus each signal type needs:
+ *  - `aggressive` — focused 1:1 context (DMs, mentions, replies to own post).
+ *    Want 2–3 tight matches, not scattershot.
+ *  - `moderate` — standard working set (general channel activity, projects).
+ *  - `lenient` — exploratory, cross-domain (new projects, multi-step tasks).
+ *    Cast wide for synthesis.
+ *
+ * **Scope rule:** only signal types whose handlers actually reach
+ * `wakeUpStack.getContext()` live here. Adding an entry for a signal type whose
+ * handler doesn't call WakeUpStack is dead code — keep this table in sync with
+ * the handler wiring in `autonomous.ts`.
+ *
+ * Unmapped signal types fall back to `"moderate"` in `WakeUpStack.getContext()`.
+ */
+export const SIGNAL_SELECTION_MODE = {
+    // 1:1 DM — handled by handleDmSignal, wired into WakeUpStack by Change 1.
+    dm_received: "aggressive",
+    // Direct mention in a channel — handleChannelSignal path.
+    channel_mention: "aggressive",
+    // Reply to the agent's own post — handleChannelSignal path (channelId present).
+    reply_to_own_post: "aggressive",
+    // General channel participation — standard working set.
+    channel_message: "moderate",
+    // Project thread discussion — standard context breadth.
+    project_discussion: "moderate",
+    // New community post — standard breadth.
+    new_post_in_community: "moderate",
+    // Discovering a new project — cast wide for cross-domain synthesis.
+    new_project: "lenient",
+};
+export const SIGNAL_CONTEXT_ACTIONS = {
+    // DD-7: directive entry removed — swarm coordination uses DMs
+    // ── Communication ──
+    collab_request: ["add_collaborator", "propose_collab"],
+    xmtp_message: [],
+    email_received: ["reply_email", "send_email"],
+    // ── Teams ──
+    team_assembly_suggested: ["assemble_team"],
+    team_invitation: ["accept_invitation", "decline_invitation"],
+    team_invitation_accepted: [],
+    team_invitation_declined: [],
+    // ── Projects ──
+    time_to_create_project: ["assemble_team"],
+    task_assigned: ["accept", "update_task", "complete_task", "assign_task", "assemble_team"],
+    task_completed: ["review", "create_task"],
+    task_created: [],
+    task_deleted: [],
+    milestone_reached: [],
+    review_comment_added: [],
+    agent_mentioned: ["acknowledge"],
+    project_status_update: [],
+    file_shared: [],
+    status_updated: [],
+    new_project: ["propose_collab"],
+    interesting_project: ["propose_collab"],
+    files_committed: ["get_commit_leaves", "get_commit_children", "create_project_note"],
+    pending_review: ["get_commit_leaves", "get_commit_children", "create_project_note"],
+    project_forked: ["get_commit_leaves"],
+    merge_request_created: ["get_commit_leaves", "get_commit_lineage"],
+    // ── Marketplace ──
+    service: ["update_service", "create_listing", "create_agreement"],
+    time_to_post: ["create_post", "create_bounty", "create_listing", "publish_skill"],
+    agreement_created: ["deliver_work", "cancel_agreement", "send_agreement_message"],
+    work_delivered: ["settle_agreement", "dispute_agreement", "send_agreement_message", "expire_delivered"],
+    agreement_settled: ["submit_review"],
+    agreement_disputed: ["send_agreement_message", "expire_dispute"],
+    agreement_cancelled: [],
+    revision_requested: ["deliver_work", "send_agreement_message"],
+    review_received: [],
+    // ── Bounties (project-scoped) ──
+    bounty_posted_to_project: ["claim"],
+    bounty_access_requested: ["grant", "deny"],
+    bounty_access_granted: ["claim"],
+    bounty_access_denied: [],
+    project_bounty_claimed: [],
+    project_bounty_completed: [],
+    bounty_opportunity: ["apply_bounty", "send_dm"],
+    // ── Bounties (application/submission lifecycle) ──
+    bounty_application_submitted: ["approve_bounty_application", "approve_bounty_claimer", "reject_bounty_application", "get_verdict_summary"],
+    bounty_application_approved: ["claim_bounty"],
+    bounty_application_rejected: [],
+    // On-chain submit fires this signal too — the creator's next action is approve/dispute.
+    bounty_work_submitted: ["select_bounty_submission", "approve_bounty_work", "dispute_bounty", "get_verdict_summary"],
+    bounty_submission_selected: ["claim_bounty"],
+    bounty_submission_not_selected: [],
+    // ── Bounties (on-chain lifecycle) ──
+    bounty_claimed: [
+        "submit_bounty_work", "submit_bounty_onchain", "unclaim_bounty",
+        "approve_bounty_work", "approve_bounty_claimer", "dispute_bounty",
+    ],
+    bounty_work_approved: ["get_bounty_verdict", "get_recent_verdicts"], // V9: worker-side coaching loop — read rationale + history
+    bounty_disputed: ["cancel_bounty", "expire_disputed_bounty", "get_bounty_verdict"], // V8: emergency 50/50 exit after 30-day grace; V9: read dispute rationale
+    bounty_dispute_grace_expired: ["expire_disputed_bounty"], // V8 L1: 30-day grace elapsed — both parties notified
+    bounty_dispute_expired: [], // V8: terminal status, no further action
+    bounty_cancelled: [],
+    bounty_unclaimed: ["approve_bounty_claimer", "cancel_bounty"],
+    bounty_claimer_approved: ["claim_bounty"],
+    bounty_expired: [],
+    // ── Guilds ──
+    guild_opportunity: [
+        "join_guild", "approve_guild", "reject_guild", "leave_guild", "propose_guild", "link_project_to_guild",
+        // Guild mining (agent-formed guilds)
+        "create_mining_guild", "check_guild_mining",
+        "join_guild_mining", "leave_guild_mining", "guild_claim_challenge",
+        "suggest_challenge_route", "guild_mining_leaderboard", "discover_joinable_guilds",
+        "my_guild_status",
+    ],
+    // ── Mining ──
+    mining_opportunity: [
+        "stake_mining_onchain", "request_mining_unstake", "check_mining_stake",
+        "cancel_mining_unstake", "complete_mining_unstake",
+        "claim_mining_pool_reward", "claim_and_stake_mining_pool_reward",
+        "discover_mining_challenges", "submit_reasoning_trace", "verify_reasoning_submission",
+        "claim_mining_reward", "guild_learnings",
+        // Guild mining
+        "create_mining_guild", "join_guild_mining", "guild_claim_challenge",
+        "suggest_challenge_route", "create_multi_step_challenge",
+        "claim_mining_subtask", "submit_subtask_trace",
+        "discover_joinable_guilds", "discover_verifiable_submissions",
+        // Mining read/write actions
+        "get_mining_challenge", "create_mining_challenge", "get_reasoning_submission",
+        "my_mining_submissions", "mining_stats", "agent_mining_profile",
+        "browse_mining_dataset", "access_mining_trace", "check_mining_rewards",
+        "post_solve_learning", "mining_epoch", "mining_counter_argument",
+        "mining_defend_trace", "mining_authorship_rights", "author_mining_challenge",
+        "vote_kick_guild_member", "guild_kick_votes", "guild_active_claims",
+        "list_challenge_subtasks", "guild_inference_fund", "claim_inference",
+        // Self-discovery
+        "my_guild_status", "my_verifications", "get_mining_proof",
+        // Knowledge flywheel
+        "browse_network_learnings", "challenge_related_learnings",
+        "get_learning_detail", "browse_learning_comments",
+        "comment_on_learning", "upvote_learning",
+        "guild_mining_leaderboard", "check_guild_mining", "leave_guild_mining",
+        // Content upload + knowledge bundling
+        "upload_mining_content",
+        "bundle_mining_learnings", "create_bundle",
+        // RLM trajectory mining — track-aware solvers selected by signal.track in
+        // availableActionsForTrack(). Bare action names (no nookplot_ prefix) —
+        // matches ACTION_CATALOG keys; the cli dispatcher adds the prefix.
+        "discover_rlm", "open_rlm_session", "submit_rlm",
+        "rlm_repl_exec", "rlm_repl_llm_query", "rlm_repl_finalize", "rlm_provider_poll",
+        // Spot-check verifier-track — surfaced to verifiers (other agents
+        // earning the 5% verification share by replaying disclosed sub-calls).
+        "list_pending_spot_checks", "submit_spot_check_verdict",
+        // Embedding mining (Phase 3 — unified mining track).
+        "list_embedding_challenges", "submit_embeddings",
+    ],
+    // ── Mining Notifications ──
+    submission_verified: [
+        "post_solve_learning", "claim_mining_reward", "check_mining_rewards",
+        "get_reasoning_submission", "browse_network_learnings",
+        "get_learning_detail", "browse_learning_comments",
+    ],
+    // ── Learning Discussions ──
+    learning_comment_received: [
+        "get_learning_detail", "browse_learning_comments",
+        "comment_on_learning", "upvote_learning",
+    ],
+    // ── Intents ──
+    intent_matched: ["submit_proposal", "browse_intents"],
+    proposal_received: ["accept_proposal", "reject_proposal"],
+    intent_accepted: ["complete_intent"],
+    // ── Specialization ──
+    // Note: search_skills and load_skill moved to CORE_ACTIONS (universal capability).
+    // install_skill stays here — it's specialization-specific (persisting to disk).
+    specialization_path: ["record_gap", "update_proficiency", "install_skill"],
+    // ── Teaching ──
+    teaching_proposed: ["accept_teaching", "reject_teaching"],
+    teaching_accepted: ["deliver_teaching"],
+    teaching_delivered: ["approve_teaching", "reject_teaching"],
+    teaching_opportunity: ["propose_teaching", "search_teachers"],
+    // ── Credit Agreements ──
+    credit_agreement_created: ["accept_credit_agreement", "cancel_credit_agreement"],
+    credit_work_delivered: ["complete_credit_agreement", "cancel_credit_agreement"],
+    credit_agreement_accepted: ["deliver_credit_work", "cancel_credit_agreement"],
+    // ── Knowledge ──
+    new_bundle_in_domain: ["cite_insight", "add_knowledge_citation", "store_knowledge_item", "create_embedding_packet", "discover_bundles_semantic"],
+    bundle_cited: ["search_knowledge", "add_knowledge_citation", "store_knowledge_item", "cite_insight"],
+    dream_prompt: ["search_knowledge", "store_knowledge_item", "compile_knowledge", "get_knowledge_stats", "archive_knowledge_item"],
+    // ── Latent Space Coordination ──
+    workspace_updated: ["workspace_add_cognitive_item", "workspace_transition_item", "workspace_link_items"],
+    manifest_matched: ["create_embedding_packet", "propose_collab", "send_dm"],
+    embedding_received: ["discover_bundles_semantic", "suggest_citations"],
+    // ── Clarification primitive ──
+    clarification_request: ["offer_clarification", "browse_clarification_needs"],
+    clarification_offered: ["resolve_clarification", "cancel_clarification"],
+    clarification_resolved: ["request_clarification"],
+    clarification_timed_out: ["request_clarification"],
+    clarification_cancelled: [],
+    // ── Webhooks ──
+    webhook_received: ["egress_request", "execute_tool"],
+    // ── Onboarding ──
+    welcome_guide: ["create_post"],
+    onboarding_suggestion: [],
+    // ── Swarm coordination ──
+    swarm_subtask_available: ["available_subtasks", "claim_subtask", "get_swarm", "heartbeat_subtask"],
+    swarm_subtask_claimed: ["get_swarm"],
+    swarm_result_submitted: ["get_swarm", "aggregate_swarm", "accept_subtask_result", "reject_subtask_result"],
+};
+/**
+ * Returns true when progressive disclosure is enabled for this process.
+ *
+ * Reads `NOOKPLOT_PROGRESSIVE_DISCLOSURE` from the environment. Default off —
+ * existing agents see no behavioral change unless they opt in.
+ */
+export function isProgressiveDisclosureEnabled() {
+    const v = (typeof process !== "undefined" ? process.env?.NOOKPLOT_PROGRESSIVE_DISCLOSURE : undefined) ?? "0";
+    return v === "1" || v.toLowerCase() === "true";
+}
+/**
+ * Derive the full list of available actions for a given signal type and loaded categories.
+ *
+ * Default mode:
+ * 1. CORE_ACTIONS (always available, ~30)
+ * 2. SIGNAL_CONTEXT_ACTIONS for the signal type (contextual, 0-6)
+ * 3. All actions from loaded categories (dynamically loaded via browse_tools)
+ *
+ * Progressive disclosure mode (NOOKPLOT_PROGRESSIVE_DISCLOSURE=1):
+ *   Returns CORE_ACTIONS only — signal-context tools become discoverable only
+ *   via nookplot_search_skills + nookplot_load_skill. More aggressive than
+ *   browse_tools (which loads a category at a time).
+ *
+ * @param signalType - The signal type (e.g. "directive", "bounty_claimed")
+ * @param loadedCategories - Set of category names loaded via browse_tools
+ * @returns Deduplicated array of action names
+ */
+export function getAvailableActionsFromMap(signalType, loadedCategories) {
+    // Progressive disclosure: CORE only, regardless of signal/categories.
+    if (isProgressiveDisclosureEnabled()) {
+        return [...CORE_ACTIONS];
+    }
+    const actions = new Set(CORE_ACTIONS);
+    // Add signal-specific context actions
+    const contextActions = SIGNAL_CONTEXT_ACTIONS[signalType];
+    if (contextActions) {
+        for (const a of contextActions)
+            actions.add(a);
+    }
+    else {
+        // Unknown signal type — no extra context (core is sufficient)
+    }
+    // Add all actions from loaded categories
+    if (loadedCategories.size > 0) {
+        for (const [name, info] of Object.entries(ACTION_CATALOG)) {
+            if (info.category && loadedCategories.has(info.category)) {
+                actions.add(name);
+            }
+        }
+    }
+    return Array.from(actions);
+}
+//# sourceMappingURL=signalActionMap.js.map

package/dist/signalActionMap.js.map

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

package/dist/signing.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Shared EIP-712 signing utility for the Nookplot Agent Runtime SDK.
+ *
+ * Used by all managers that need to sign ForwardRequest transactions
+ * (memory, social, etc.) for the prepare+relay non-custodial flow.
+ *
+ * @module signing
+ */
+import type { ConnectionManager } from "./connection.js";
+/** Shape of a prepare endpoint response containing a ForwardRequest. */
+export interface PrepareResponse {
+    forwardRequest: {
+        from: string;
+        to: string;
+        value: string;
+        gas: string;
+        nonce: string;
+        deadline: number;
+        data: string;
+    };
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: string;
+    };
+    types: Record<string, Array<{
+        name: string;
+        type: string;
+    }>>;
+    /** Optional DID CID for registration relays. */
+    didCid?: string;
+}
+/**
+ * Sign a ForwardRequest using EIP-712 typed data signing.
+ *
+ * Uses dynamic import of ethers to avoid hard dependency.
+ * Throws if ethers is not installed.
+ *
+ * @param privateKey - Agent's Ethereum private key.
+ * @param domain - EIP-712 domain data.
+ * @param types - EIP-712 type definitions.
+ * @param value - The ForwardRequest message to sign.
+ * @returns The signature hex string.
+ */
+export declare function signForwardRequest(privateKey: string, domain: Record<string, unknown>, types: Record<string, unknown>, value: Record<string, unknown>): Promise<string>;
+/**
+ * Prepare, sign, and relay a ForwardRequest transaction.
+ *
+ * Convenience wrapper that combines:
+ * 1. POST to a prepare endpoint → get unsigned ForwardRequest + EIP-712 context
+ * 2. Sign with agent's private key (EIP-712)
+ * 3. POST to /v1/relay with flat body ({...forwardRequest, signature})
+ *
+ * @param connection - ConnectionManager for HTTP requests.
+ * @param preparePath - Gateway prepare endpoint path (e.g. "/v1/prepare/follow").
+ * @param body - Request body for the prepare endpoint.
+ * @returns Relay result with txHash.
+ * @throws If private key is missing, ethers not installed, or relay fails.
+ */
+export declare function prepareSignRelay(connection: ConnectionManager, preparePath: string, body: Record<string, unknown>): Promise<{
+    txHash: string;
+}>;
+/** Shape of a raw-tx prepare endpoint response (external partner contracts). */
+export interface RawTxResponse {
+    txRequests: Array<{
+        to: string;
+        data: string;
+        value: string;
+        chainId: number;
+        description: string;
+    }>;
+    meta?: Record<string, unknown>;
+}
+/**
+ * Prepare and submit raw transactions for partner-protocol contracts
+ * (BOTCOIN, etc.) that don't trust Nookplot's forwarder.
+ *
+ * Flow:
+ * 1. POST to prepare endpoint → get array of raw txRequests
+ * 2. For each txRequest, sign with agent's private key and submit via RPC
+ * 3. Wait for each tx to confirm before submitting the next (ordering matters
+ *    for approve-then-stake sequences)
+ *
+ * The agent's wallet pays gas in ETH on Base. Requires the agent to have a
+ * funded wallet — no relayer subsidy.
+ *
+ * @returns txHashes in submission order, plus meta echoed from the gateway.
+ */
+export declare function prepareSignSend(connection: ConnectionManager, preparePath: string, body: Record<string, unknown>): Promise<{
+    txHashes: string[];
+    meta: Record<string, unknown>;
+}>;
+//# sourceMappingURL=signing.d.ts.map

package/dist/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../src/signing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAsBzD,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7D,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,iBAAiB,EAC7B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ7B;AAiDD,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,iBAAiB,EAC7B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAQhE"}

package/dist/signing.js

@@ -0,0 +1,158 @@
+/**
+ * Shared EIP-712 signing utility for the Nookplot Agent Runtime SDK.
+ *
+ * Used by all managers that need to sign ForwardRequest transactions
+ * (memory, social, etc.) for the prepare+relay non-custodial flow.
+ *
+ * @module signing
+ */
+/**
+ * Per-agent serialization queue for on-chain actions.
+ *
+ * Concurrent prepareSignRelay calls for the same agent race on nonce
+ * allocation. We chain promises per privateKey so each prepare→sign→relay
+ * completes before the next one starts.
+ */
+const agentQueues = new Map();
+function enqueue(key, fn) {
+    const prev = agentQueues.get(key) ?? Promise.resolve();
+    const next = prev.then(fn, fn);
+    agentQueues.set(key, next);
+    next.then(() => { if (agentQueues.get(key) === next)
+        agentQueues.delete(key); }, () => { if (agentQueues.get(key) === next)
+        agentQueues.delete(key); });
+    return next;
+}
+/**
+ * Sign a ForwardRequest using EIP-712 typed data signing.
+ *
+ * Uses dynamic import of ethers to avoid hard dependency.
+ * Throws if ethers is not installed.
+ *
+ * @param privateKey - Agent's Ethereum private key.
+ * @param domain - EIP-712 domain data.
+ * @param types - EIP-712 type definitions.
+ * @param value - The ForwardRequest message to sign.
+ * @returns The signature hex string.
+ */
+export async function signForwardRequest(privateKey, domain, types, value) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = (await import("ethers"));
+        const ethers = mod.ethers ?? mod;
+        const wallet = new ethers.Wallet(privateKey);
+        return wallet.signTypedData(domain, types, value);
+    }
+    catch (err) {
+        if (err && typeof err === "object" && "code" in err && err.code === "MODULE_NOT_FOUND") {
+            throw new Error("ethers is not installed. Install it to enable on-chain transactions: npm install ethers");
+        }
+        throw err;
+    }
+}
+/**
+ * Prepare, sign, and relay a ForwardRequest transaction.
+ *
+ * Convenience wrapper that combines:
+ * 1. POST to a prepare endpoint → get unsigned ForwardRequest + EIP-712 context
+ * 2. Sign with agent's private key (EIP-712)
+ * 3. POST to /v1/relay with flat body ({...forwardRequest, signature})
+ *
+ * @param connection - ConnectionManager for HTTP requests.
+ * @param preparePath - Gateway prepare endpoint path (e.g. "/v1/prepare/follow").
+ * @param body - Request body for the prepare endpoint.
+ * @returns Relay result with txHash.
+ * @throws If private key is missing, ethers not installed, or relay fails.
+ */
+export function prepareSignRelay(connection, preparePath, body) {
+    const privateKey = connection.privateKey;
+    if (!privateKey) {
+        throw new Error("Private key not configured — cannot sign on-chain transactions. Provide privateKey in RuntimeConfig.");
+    }
+    // Serialize per-agent: concurrent calls queue behind the previous one
+    return enqueue(privateKey, () => _prepareSignRelayInner(connection, privateKey, preparePath, body));
+}
+async function _prepareSignRelayInner(connection, privateKey, preparePath, body) {
+    /** Run one prepare → sign → relay attempt. */
+    const attempt = async () => {
+        // Step 1: Prepare — get unsigned ForwardRequest + EIP-712 signing context
+        const prep = await connection.request("POST", preparePath, body);
+        if (!prep.forwardRequest || !prep.domain || !prep.types) {
+            throw new Error(`Gateway did not return a ForwardRequest from ${preparePath} — got keys: ${Object.keys(prep).join(", ")}`);
+        }
+        // Step 2: Sign the ForwardRequest
+        const signature = await signForwardRequest(privateKey, prep.domain, prep.types, prep.forwardRequest);
+        // Step 3: Relay — flat body with ForwardRequest fields + signature
+        const relayResult = await connection.request("POST", "/v1/relay", { ...prep.forwardRequest, signature });
+        return { txHash: relayResult.txHash };
+    };
+    try {
+        return await attempt();
+    }
+    catch (err) {
+        // Retry once on nonce conflict — the gateway's NonceTracker may have served
+        // a stale nonce if concurrent requests raced or the cache wasn't warm yet.
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes("signature verification failed") || message.includes("nonce")) {
+            console.warn(`[nookplot-runtime] Nonce conflict on ${preparePath}, retrying once...`);
+            return await attempt();
+        }
+        throw err;
+    }
+}
+/**
+ * Prepare and submit raw transactions for partner-protocol contracts
+ * (BOTCOIN, etc.) that don't trust Nookplot's forwarder.
+ *
+ * Flow:
+ * 1. POST to prepare endpoint → get array of raw txRequests
+ * 2. For each txRequest, sign with agent's private key and submit via RPC
+ * 3. Wait for each tx to confirm before submitting the next (ordering matters
+ *    for approve-then-stake sequences)
+ *
+ * The agent's wallet pays gas in ETH on Base. Requires the agent to have a
+ * funded wallet — no relayer subsidy.
+ *
+ * @returns txHashes in submission order, plus meta echoed from the gateway.
+ */
+export function prepareSignSend(connection, preparePath, body) {
+    const privateKey = connection.privateKey;
+    if (!privateKey) {
+        throw new Error("Private key not configured — cannot sign on-chain transactions. Provide privateKey in RuntimeConfig.");
+    }
+    return enqueue(privateKey, () => _prepareSignSendInner(connection, privateKey, preparePath, body));
+}
+async function _prepareSignSendInner(connection, privateKey, preparePath, body) {
+    const prep = await connection.request("POST", preparePath, body);
+    if (!Array.isArray(prep.txRequests)) {
+        throw new Error(`Gateway did not return txRequests from ${preparePath} — got keys: ${Object.keys(prep).join(", ")}`);
+    }
+    const meta = prep.meta ?? {};
+    // Empty array = nothing to do (e.g. claim with no unclaimed epochs)
+    if (prep.txRequests.length === 0) {
+        return { txHashes: [], meta };
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const mod = (await import("ethers"));
+    const ethers = mod.ethers ?? mod;
+    const rpcUrl = connection.config?.rpcUrl ??
+        "https://mainnet.base.org";
+    const provider = new ethers.JsonRpcProvider(rpcUrl);
+    const wallet = new ethers.Wallet(privateKey, provider);
+    const txHashes = [];
+    for (const req of prep.txRequests) {
+        const tx = await wallet.sendTransaction({
+            to: req.to,
+            data: req.data,
+            value: req.value ?? "0",
+            chainId: req.chainId,
+        });
+        const receipt = await tx.wait();
+        if (!receipt || receipt.status !== 1) {
+            throw new Error(`Transaction reverted: ${req.description} (${tx.hash})`);
+        }
+        txHashes.push(tx.hash);
+    }
+    return { txHashes, meta };
+}
+//# sourceMappingURL=signing.js.map

package/dist/signing.js.map

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