@agentvault/agentvault 0.8.0 → 0.9.0

package/dist/crypto-helpers.d.ts

@@ -1,12 +1,2 @@
-import type { EncryptedMessage } from "@agentvault/crypto";
-export declare function hexToBytes(hex: string): Uint8Array;
-export declare function bytesToHex(bytes: Uint8Array): string;
-export declare function base64ToBytes(b64: string): Uint8Array;
-export declare function bytesToBase64(bytes: Uint8Array): string;
-export interface TransportMessage {
-    header_blob: string;
-    ciphertext: string;
-}
-export declare function encryptedMessageToTransport(msg: EncryptedMessage): TransportMessage;
-export declare function transportToEncryptedMessage(transport: TransportMessage): EncryptedMessage;
+export { hexToBytes, bytesToHex, base64ToBytes, bytesToBase64, encryptedMessageToTransport, transportToEncryptedMessage, type TransportMessage, } from "@agentvault/crypto";
 //# sourceMappingURL=crypto-helpers.d.ts.map

package/dist/crypto-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-helpers.d.ts","sourceRoot":"","sources":["../src/crypto-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAElD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAErD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEvD;AAKD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,gBAAgB,GACpB,gBAAgB,CAgBlB;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,gBAAgB,GAC1B,gBAAgB,CAelB"}
+{"version":3,"file":"crypto-helpers.d.ts","sourceRoot":"","sources":["../src/crypto-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,2BAA2B,EAC3B,2BAA2B,EAC3B,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/gateway-send.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Gateway send helper — lets agents send messages to their owner
+ * via the plugin's local HTTP server (port 18790).
+ *
+ * Delivery path: sendToOwner() → plugin HTTP /send → SecureChannel.send()
+ *   → Double Ratchet encrypt → WebSocket → backend → owner's app
+ */
+export interface GatewaySendOptions {
+    /** Override the gateway port (default: env GATEWAY_SEND_PORT or 18790) */
+    port?: number;
+    /** Override the gateway host (default: 127.0.0.1) */
+    host?: string;
+    /** AbortSignal for cancellation */
+    signal?: AbortSignal;
+}
+export interface GatewaySendResult {
+    ok: boolean;
+    error?: string;
+}
+export interface GatewayStatusResult {
+    ok: boolean;
+    state?: string;
+    deviceId?: string;
+    sessions?: number;
+    error?: string;
+}
+/**
+ * Send a plaintext message to the agent's owner via the gateway HTTP server.
+ * Never throws — returns `{ ok: false, error }` on failure.
+ */
+export declare function sendToOwner(text: string, options?: GatewaySendOptions): Promise<GatewaySendResult>;
+/**
+ * Check gateway health / status.
+ * Never throws — returns `{ ok: false, error }` on failure.
+ */
+export declare function checkGateway(options?: GatewaySendOptions): Promise<GatewayStatusResult>;
+//# sourceMappingURL=gateway-send.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-send.d.ts","sourceRoot":"","sources":["../src/gateway-send.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,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;AAsBD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAuB5B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAmB9B"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { SecureChannel } from "./channel.js";
 export type { SecureChannelConfig, ChannelState, MessageMetadata, AttachmentData, PersistedState, LegacyPersistedState, DeviceSession, HistoryEntry, SendOptions, DecisionOption, DecisionRequest, DecisionResponse, ContextRef, HeartbeatStatus, StatusAlert, RoomInfo, RoomMemberInfo, RoomConversationInfo, RoomState, A2AChannel, A2AMessage, RoomParticipantEvent, } from "./types.js";
 export { agentVaultPlugin, setOcRuntime, getActiveChannel } from "./openclaw-plugin.js";
-export declare const VERSION = "0.7.0";
+export { sendToOwner, checkGateway } from "./gateway-send.js";
+export type { GatewaySendOptions, GatewaySendResult, GatewayStatusResult, } from "./gateway-send.js";
+export declare const VERSION = "0.9.0";
 //# sourceMappingURL=index.d.ts.map

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,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExF,eAAO,MAAM,OAAO,UAAU,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,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;AAE3B,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -45106,7 +45106,7 @@ var ScanEngine = class {
   }
 };
 
-// src/crypto-helpers.ts
+// ../crypto/dist/transport.js
 function hexToBytes(hex) {
   return libsodium_wrappers_default.from_hex(hex);
 }
@@ -45128,18 +45128,14 @@ function encryptedMessageToTransport(msg) {
     nonce: bytesToBase64(msg.nonce)
   };
   const headerJson = JSON.stringify(headerObj);
-  const headerBlob = bytesToBase64(
-    new TextEncoder().encode(headerJson)
-  );
+  const headerBlob = bytesToBase64(new TextEncoder().encode(headerJson));
   return {
     header_blob: headerBlob,
     ciphertext: bytesToBase64(msg.ciphertext)
   };
 }
 function transportToEncryptedMessage(transport) {
-  const headerJson = new TextDecoder().decode(
-    base64ToBytes(transport.header_blob)
-  );
+  const headerJson = new TextDecoder().decode(base64ToBytes(transport.header_blob));
   const headerObj = JSON.parse(headerJson);
   return {
     header: {
@@ -47597,13 +47593,67 @@ async function _handleInbound(params) {
   });
 }
 
+// src/gateway-send.ts
+function resolveBaseUrl(options) {
+  const host = options?.host ?? "127.0.0.1";
+  const port = options?.port ?? (process.env.GATEWAY_SEND_PORT ? Number(process.env.GATEWAY_SEND_PORT) : 18790);
+  return `http://${host}:${port}`;
+}
+function friendlyError(err) {
+  if (err instanceof TypeError && String(err.cause ?? err.message).includes("ECONNREFUSED")) {
+    return "Gateway not reachable \u2014 is OpenClaw running?";
+  }
+  return err instanceof Error ? err.message : String(err);
+}
+async function sendToOwner(text, options) {
+  if (typeof text !== "string" || text.trim().length === 0) {
+    return { ok: false, error: "Message text must be a non-empty string" };
+  }
+  try {
+    const base = resolveBaseUrl(options);
+    const res = await fetch(`${base}/send`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ text }),
+      signal: options?.signal
+    });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      return { ok: false, error: `HTTP ${res.status}${body ? `: ${body}` : ""}` };
+    }
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: friendlyError(err) };
+  }
+}
+async function checkGateway(options) {
+  try {
+    const base = resolveBaseUrl(options);
+    const res = await fetch(`${base}/status`, { signal: options?.signal });
+    if (!res.ok) {
+      return { ok: false, error: `HTTP ${res.status}` };
+    }
+    const data = await res.json();
+    return {
+      ok: true,
+      state: data.state,
+      deviceId: data.deviceId,
+      sessions: data.sessions
+    };
+  } catch (err) {
+    return { ok: false, error: friendlyError(err) };
+  }
+}
+
 // src/index.ts
-var VERSION = "0.7.0";
+var VERSION = "0.9.0";
 export {
   SecureChannel,
   VERSION,
   agentVaultPlugin,
+  checkGateway,
   getActiveChannel,
+  sendToOwner,
   setOcRuntime
 };
 //# sourceMappingURL=index.js.map