@nookplot/runtime 0.5.20 → 0.5.21

package/dist/autonomous.d.ts

@@ -76,6 +76,11 @@ export type GenerateResponseFn = (prompt: string) => Promise<string | null | und
  * If provided, bypasses the built-in prompt building + action execution.
  */
 export type SignalHandler = (signal: SignalEvent, runtime: NookplotRuntime) => Promise<void>;
+/**
+ * Approval callback for on-chain actions. Return `true` to allow execution,
+ * `false` to reject. Called before any on-chain action when provided.
+ */
+export type ApprovalCallback = (actionType: string, payload: Record<string, unknown>) => Promise<boolean>;
 /** Options for the AutonomousAgent. */
 export interface AutonomousAgentOptions {
     /** Log actions to console (default: true). */
@@ -94,6 +99,11 @@ export interface AutonomousAgentOptions {
     generateResponse?: GenerateResponseFn;
     /** Custom action handler — overrides default on-chain action dispatch. */
     onAction?: (event: ActionRequestEvent) => Promise<void>;
+    /**
+     * Approval gate for on-chain actions. When provided, on-chain actions
+     * (create_post, vote, follow, attest, etc.) require approval before execution.
+     */
+    onApproval?: ApprovalCallback;
     /** Per-channel response cooldown in seconds (default: 120). */
     responseCooldown?: number;
 }
@@ -103,6 +113,7 @@ export declare class AutonomousAgent {
     private readonly generateResponse?;
     private readonly signalHandler?;
     private readonly actionHandler?;
+    private readonly approvalHandler?;
     private readonly cooldownSec;
     private isRunning;
     private channelCooldowns;

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,12 +44,22 @@ import { wrapUntrusted, sanitizeForPrompt, UNTRUSTED_CONTENT_INSTRUCTION } from
 // ----------------------------------------------------------------
 //  AutonomousAgent
 // ----------------------------------------------------------------
+/** On-chain actions that go through prepare→sign→relay and mutate state. */
+const ON_CHAIN_ACTIONS = new Set([
+    "create_post", "post_reply", "vote", "follow_agent", "attest_agent",
+    "create_community", "propose_guild", "propose_clique", "create_project",
+    "create_bounty", "create_bundle", "claim", "claim_bounty",
+    "approve_bounty_claimer", "create_listing", "create_agreement",
+    "deliver_work", "settle_agreement", "dispute_agreement", "cancel_agreement",
+    "expire_dispute", "expire_delivered",
+]);
 export class AutonomousAgent {
     runtime;
     verbose;
     generateResponse;
     signalHandler;
     actionHandler;
+    approvalHandler;
     cooldownSec;
     isRunning = false;
     channelCooldowns = new Map();
@@ -61,6 +71,7 @@ export class AutonomousAgent {
         this.generateResponse = options.generateResponse;
         this.signalHandler = options.onSignal;
         this.actionHandler = options.onAction;
+        this.approvalHandler = options.onApproval;
         this.cooldownSec = options.responseCooldown ?? 120;
     }
     /** Start listening for proactive signals and action requests. */
@@ -2144,6 +2155,21 @@ export class AutonomousAgent {
         if (this.verbose) {
             console.log(`[autonomous] Action request: ${actionType}${actionId ? ` (${actionId})` : ""}`);
         }
+        // Approval gate: on-chain actions require approval when handler is set
+        if (this.approvalHandler && ON_CHAIN_ACTIONS.has(actionType)) {
+            const approved = await this.approvalHandler(actionType, (payload ?? {}));
+            if (!approved) {
+                if (this.verbose)
+                    console.log(`[autonomous] Action rejected by approval handler: ${actionType}`);
+                if (actionId) {
+                    try {
+                        await this.runtime.proactive.rejectDelegatedAction(actionId, "Rejected by approval handler");
+                    }
+                    catch { /* best-effort */ }
+                }
+                return;
+            }
+        }
         try {
             let txHash;
             let result;
@@ -2411,6 +2437,30 @@ export class AutonomousAgent {
                     result = bountyRelay;
                     break;
                 }
+                case "create_bundle": {
+                    const name = (suggestedContent ?? payload?.name);
+                    const cids = payload?.cids;
+                    if (!name || !cids || !Array.isArray(cids) || cids.length === 0) {
+                        throw new Error("create_bundle requires name and non-empty cids array");
+                    }
+                    const bundleBody = { name, cids };
+                    if (payload?.description)
+                        bundleBody.description = payload.description;
+                    if (payload?.bundleType)
+                        bundleBody.bundleType = payload.bundleType;
+                    if (payload?.tags)
+                        bundleBody.tags = payload.tags;
+                    if (payload?.domain)
+                        bundleBody.domain = payload.domain;
+                    if (payload?.summary)
+                        bundleBody.summary = payload.summary;
+                    if (payload?.contributors)
+                        bundleBody.contributors = payload.contributors;
+                    const bundleRelay = await prepareSignRelay(this.runtime.connection, "/v1/prepare/bundle", bundleBody);
+                    txHash = bundleRelay.txHash;
+                    result = bundleRelay;
+                    break;
+                }
                 case "add_collaborator": {
                     const projId = payload?.projectId;
                     const collabAddr = (payload?.collaboratorAddress ?? payload?.address);
@@ -2718,6 +2768,98 @@ export class AutonomousAgent {
                     result = r;
                     break;
                 }
+                case "workspace_create": {
+                    const wsName = (payload?.name ?? suggestedContent);
+                    if (!wsName)
+                        throw new Error("workspace_create requires name");
+                    const ws = await this.runtime.workspaces.create({
+                        name: wsName,
+                        description: payload?.description,
+                        sourceType: payload?.sourceType,
+                        sourceId: payload?.sourceId,
+                    });
+                    result = ws;
+                    break;
+                }
+                case "workspace_set": {
+                    const wsId = payload?.workspaceId;
+                    const wsKey = payload?.key;
+                    const wsVal = payload?.value ?? suggestedContent;
+                    if (!wsId || !wsKey)
+                        throw new Error("workspace_set requires workspaceId and key");
+                    const wsResult = await this.runtime.workspaces.setState(wsId, wsKey, wsVal);
+                    result = wsResult;
+                    break;
+                }
+                case "workspace_snapshot": {
+                    const wsId = payload?.workspaceId;
+                    if (!wsId)
+                        throw new Error("workspace_snapshot requires workspaceId");
+                    const snap = await this.runtime.workspaces.createSnapshot(wsId, payload?.label);
+                    result = snap;
+                    break;
+                }
+                case "review":
+                case "comment": {
+                    const projId = payload?.projectId;
+                    const commitId = payload?.commitId;
+                    if (!projId || !commitId)
+                        throw new Error("review requires projectId and commitId");
+                    const verdict = (payload?.verdict ?? "comment");
+                    const body = (suggestedContent ?? payload?.body ?? "");
+                    const reviewResult = await this.runtime.projects.submitReview(projId, commitId, verdict, body);
+                    result = reviewResult;
+                    break;
+                }
+                case "grant": {
+                    const projId = payload?.projectId;
+                    const bountyId = payload?.bountyId;
+                    const reqId = payload?.requestId;
+                    if (!projId || !bountyId || !reqId)
+                        throw new Error("grant requires projectId, bountyId, requestId");
+                    result = await this.runtime.connection.request("POST", `/v1/projects/${projId}/bounties/${bountyId}/grant-access`, { requestId: reqId });
+                    break;
+                }
+                case "deny": {
+                    const projId = payload?.projectId;
+                    const bountyId = payload?.bountyId;
+                    const reqId = payload?.requestId;
+                    if (!projId || !bountyId || !reqId)
+                        throw new Error("deny requires projectId, bountyId, requestId");
+                    result = await this.runtime.connection.request("POST", `/v1/projects/${projId}/bounties/${bountyId}/deny-access`, { requestId: reqId });
+                    break;
+                }
+                case "accept": {
+                    const ch = payload?.channelId;
+                    const msg = (suggestedContent ?? "Accepted — I'll get started.");
+                    if (ch) {
+                        await this.runtime.channels.send(ch, msg);
+                    }
+                    result = { accepted: true };
+                    break;
+                }
+                case "acknowledge": {
+                    const ch = payload?.channelId;
+                    const msg = (suggestedContent ?? "Got it, thanks for the mention!");
+                    if (ch) {
+                        await this.runtime.channels.send(ch, msg);
+                    }
+                    result = { acknowledged: true };
+                    break;
+                }
+                case "execute": {
+                    const ch = payload?.channelId;
+                    const target = payload?.recipientAddress;
+                    const msg = (suggestedContent ?? "");
+                    if (ch) {
+                        await this.runtime.channels.send(ch, msg);
+                    }
+                    else if (target) {
+                        await this.runtime.inbox.send({ to: target, content: msg });
+                    }
+                    result = { executed: true };
+                    break;
+                }
                 default:
                     if (this.verbose)
                         console.warn(`[autonomous] Unknown action: ${actionType}`);