@agentvault/agentvault 0.14.1 → 0.14.2

package/dist/create-agent.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AgentVault "create" command — spin up a brand new OpenClaw peer agent.
+ *
+ * Ports the logic from ~/.openclaw/workspace/scripts/create-agent.sh into
+ * TypeScript, eliminating the jq dependency.
+ *
+ * Usage: npx @agentvault/agentvault create <name> --token=av_tok_...
+ */
+export interface CreateAgentOptions {
+    name: string;
+    token: string;
+    port?: number;
+    apiUrl: string;
+    force?: boolean;
+}
+/** Resolve the OpenClaw home directory (~/.openclaw) */
+export declare function openclawHome(): string;
+/** Parse openclaw.json and return its contents. */
+export declare function readOpenClawConfig(home: string): any;
+/**
+ * Scan all accounts in openclaw.json for httpPort values and return next free port.
+ * Minimum port is `startPort` (default 18790).
+ */
+export declare function findNextPort(config: any, startPort?: number): number;
+/** Generate workspace template files for a new agent. */
+export declare function generateWorkspaceFiles(name: string): Record<string, string>;
+export declare function runCreateCommand(options: CreateAgentOptions): Promise<void>;
+//# sourceMappingURL=create-agent.d.ts.map

package/dist/create-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent.d.ts","sourceRoot":"","sources":["../src/create-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAID,wDAAwD;AACxD,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAIpD;AAUD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,SAAQ,GAAG,MAAM,CAwBnE;AAgBD,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8C3E;AAID,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6KjF"}

package/dist/gateway-send.d.ts

@@ -29,6 +29,33 @@ export interface GatewayStatusResult {
  * Never throws — returns `{ ok: false, error }` on failure.
  */
 export declare function sendToOwner(text: string, options?: GatewaySendOptions): Promise<GatewaySendResult>;
+/**
+ * Send a decision request to the agent's owner via the gateway HTTP server.
+ * Never throws — returns `{ ok: false, error }` on failure.
+ */
+export declare function sendDecisionToOwner(request: {
+    title: string;
+    description?: string;
+    options: Array<{
+        option_id: string;
+        label: string;
+        risk_level?: string;
+        is_default?: boolean;
+    }>;
+    context_refs?: Array<{
+        type: string;
+        uri: string;
+        label: string;
+    }>;
+    deadline?: string;
+    auto_action?: {
+        option_id: string;
+        trigger: string;
+        description?: string;
+    };
+}, options?: GatewaySendOptions): Promise<GatewaySendResult & {
+    decision_id?: string;
+}>;
 /**
  * Check gateway health / status.
  * Never throws — returns `{ ok: false, error }` on failure.

package/dist/gateway-send.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-send.d.ts","sourceRoot":"","sources":["../src/gateway-send.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4BD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CA4B5B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAoB9B"}
+{"version":3,"file":"gateway-send.d.ts","sourceRoot":"","sources":["../src/gateway-send.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4BD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CA4B5B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChG,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5E,EACD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BvD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAoB9B"}

package/dist/http-handlers.d.ts

@@ -21,6 +21,10 @@ export declare function handleSendRequest(parsed: Record<string, unknown>, chann
  * Handle POST /action — send an action confirmation.
  */
 export declare function handleActionRequest(parsed: Record<string, unknown>, channel: SecureChannel): Promise<HandlerResult>;
+/**
+ * Handle POST /decision — send a decision request to the owner.
+ */
+export declare function handleDecisionRequest(parsed: Record<string, unknown>, channel: SecureChannel): Promise<HandlerResult>;
 /**
  * Handle GET /status — return channel health info.
  */

package/dist/http-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-handlers.d.ts","sourceRoot":"","sources":["../src/http-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAuBxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAUzE"}
+{"version":3,"file":"http-handlers.d.ts","sourceRoot":"","sources":["../src/http-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAuBxB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CA8BxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAUzE"}

package/dist/index.d.ts

@@ -3,11 +3,11 @@ export type { SecureChannelConfig, ChannelState, MessageMetadata, AttachmentData
 export { listAccountIds, resolveAccount } from "./account-config.js";
 export type { ResolvedAccount } from "./account-config.js";
 export { agentVaultPlugin, setOcRuntime, getActiveChannel } from "./openclaw-plugin.js";
-export { sendToOwner, checkGateway } from "./gateway-send.js";
+export { sendToOwner, sendDecisionToOwner, checkGateway } from "./gateway-send.js";
 export type { GatewaySendOptions, GatewaySendResult, GatewayStatusResult, } from "./gateway-send.js";
 export { requestHeartbeatNow, onAgentEvent, onSessionTranscriptUpdate } from "./openclaw-compat.js";
 export { isUsingManagedRoutes } from "./openclaw-entry.js";
-export { handleSendRequest, handleActionRequest, handleStatusRequest } from "./http-handlers.js";
+export { handleSendRequest, handleActionRequest, handleDecisionRequest, handleStatusRequest } from "./http-handlers.js";
 export type { HandlerResult } from "./http-handlers.js";
 export type { OpenClawPluginApi, PluginRuntime, ChannelGatewayContext, ChannelOutboundPayloadContext, ReplyPayload, MessageSentEvent, SessionStartEvent, SessionEndEvent, AgentEventPayload, TranscriptUpdatePayload, } from "./openclaw-types.js";
 export declare const VERSION = "0.14.1";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,UAAU,EACV,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,6BAA6B,EAC7B,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,UAAU,EACV,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxF,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnF,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACxH,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,6BAA6B,EAC7B,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/dist/index.js

@@ -45880,6 +45880,7 @@ var init_openclaw_compat = __esm({
 var http_handlers_exports = {};
 __export(http_handlers_exports, {
   handleActionRequest: () => handleActionRequest,
+  handleDecisionRequest: () => handleDecisionRequest,
   handleSendRequest: () => handleSendRequest,
   handleStatusRequest: () => handleStatusRequest
 });
@@ -45933,6 +45934,34 @@ async function handleActionRequest(parsed, channel) {
     return { status: 500, body: { ok: false, error: String(err) } };
   }
 }
+async function handleDecisionRequest(parsed, channel) {
+  const title = parsed.title;
+  if (!title || typeof title !== "string") {
+    return { status: 400, body: { ok: false, error: "Missing 'title' field" } };
+  }
+  const options = parsed.options;
+  if (!Array.isArray(options) || options.length < 2) {
+    return { status: 400, body: { ok: false, error: "'options' must be an array with at least 2 items" } };
+  }
+  for (const opt of options) {
+    if (!opt || typeof opt !== "object" || !opt.option_id || !opt.label) {
+      return { status: 400, body: { ok: false, error: "Each option must have 'option_id' and 'label'" } };
+    }
+  }
+  try {
+    const decision_id = await channel.sendDecisionRequest({
+      title,
+      description: parsed.description,
+      options,
+      context_refs: parsed.context_refs,
+      deadline: parsed.deadline,
+      auto_action: parsed.auto_action
+    });
+    return { status: 200, body: { ok: true, decision_id } };
+  } catch (err) {
+    return { status: 500, body: { ok: false, error: String(err) } };
+  }
+}
 function handleStatusRequest(channel) {
   return {
     status: 200,
@@ -46737,6 +46766,22 @@ var init_channel = __esm({
                 res.end(JSON.stringify({ ok: false, error: String(err) }));
               }
             });
+          } else if (req.method === "POST" && req.url === "/decision") {
+            let body = "";
+            req.on("data", (chunk) => {
+              body += chunk.toString();
+            });
+            req.on("end", async () => {
+              try {
+                const parsed = JSON.parse(body);
+                const result = await handlers.handleDecisionRequest(parsed, this);
+                res.writeHead(result.status, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(result.body));
+              } catch (err) {
+                res.writeHead(500, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ ok: false, error: String(err) }));
+              }
+            });
           } else if (req.method === "POST" && req.url === "/action") {
             let body = "";
             req.on("data", (chunk) => {
@@ -46759,7 +46804,7 @@ var init_channel = __esm({
             res.end(JSON.stringify(result.body));
           } else {
             res.writeHead(404, { "Content-Type": "application/json" });
-            res.end(JSON.stringify({ ok: false, error: "Not found. Use POST /send, POST /action, or GET /status" }));
+            res.end(JSON.stringify({ ok: false, error: "Not found. Use POST /send, POST /decision, POST /action, or GET /status" }));
           }
         });
         this._httpServer.listen(port, "127.0.0.1", () => {
@@ -49029,6 +49074,34 @@ async function sendToOwner(text, options) {
     return { ok: false, error: friendlyError(err) };
   }
 }
+async function sendDecisionToOwner(request, options) {
+  if (!request.title || typeof request.title !== "string") {
+    return { ok: false, error: "Decision title must be a non-empty string" };
+  }
+  if (!Array.isArray(request.options) || request.options.length < 2) {
+    return { ok: false, error: "Decision must have at least 2 options" };
+  }
+  requestHeartbeatNow({ reason: "proactive-decision" }).catch(() => {
+  });
+  try {
+    const base = resolveBaseUrl(options);
+    const path = process.env.OPENCLAW_GATEWAY_URL ? "/agentvault/decision" : "/decision";
+    const res = await fetch(`${base}${path}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(request),
+      signal: options?.signal
+    });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      return { ok: false, error: `HTTP ${res.status}${body ? `: ${body}` : ""}` };
+    }
+    const data = await res.json();
+    return { ok: true, decision_id: data.decision_id };
+  } catch (err) {
+    return { ok: false, error: friendlyError(err) };
+  }
+}
 async function checkGateway(options) {
   try {
     const base = resolveBaseUrl(options);
@@ -49100,6 +49173,7 @@ export {
   checkGateway,
   getActiveChannel,
   handleActionRequest,
+  handleDecisionRequest,
   handleSendRequest,
   handleStatusRequest,
   isUsingManagedRoutes,
@@ -49108,6 +49182,7 @@ export {
   onSessionTranscriptUpdate,
   requestHeartbeatNow,
   resolveAccount,
+  sendDecisionToOwner,
   sendToOwner,
   setOcRuntime
 };