@letsping/sdk 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -1,37 +1,44 @@
-type Priority = "low" | "medium" | "high" | "critical";
-interface RequestOptions {
+export type Priority = "low" | "medium" | "high" | "critical";
+export interface RequestOptions {
     service: string;
     action: string;
     payload: Record<string, any>;
     priority?: Priority;
     schema?: Record<string, any>;
     timeoutMs?: number;
+    role?: string;
 }
-interface Decision {
-    status: "APPROVED" | "REJECTED";
+export interface Decision {
+    status: "APPROVED" | "REJECTED" | "APPROVED_WITH_MODIFICATIONS";
     payload: any;
     patched_payload?: any;
+    diff_summary?: any;
     metadata?: {
         resolved_at: string;
         actor_id: string;
         method?: string;
     };
 }
-declare class LetsPingError extends Error {
+export declare class LetsPingError extends Error {
     status?: number | undefined;
     constructor(message: string, status?: number | undefined);
 }
-declare class LetsPing {
+declare function computeDiff(original: any, patched: any): any;
+export declare class LetsPing {
     private readonly apiKey;
     private readonly baseUrl;
+    private readonly encryptionKey;
     constructor(apiKey?: string, options?: {
         baseUrl?: string;
+        encryptionKey?: string;
     });
+    private _encrypt;
+    private _decrypt;
     ask(options: RequestOptions): Promise<Decision>;
     defer(options: RequestOptions): Promise<{
         id: string;
     }>;
     private request;
+    tool(service: string, action: string, priority?: Priority): (context: string | Record<string, any>) => Promise<string>;
 }
-
-export { type Decision, LetsPing, LetsPingError, type Priority, type RequestOptions };
+export { computeDiff };

package/dist/index.js

@@ -3,6 +3,9 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -17,13 +20,58 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "@letsping/sdk",
+      version: "0.1.3",
+      description: "The Human-in-the-Loop SDK for Autonomous Agents",
+      main: "./dist/index.js",
+      module: "./dist/index.mjs",
+      files: [
+        "dist"
+      ],
+      types: "./dist/index.d.ts",
+      exports: {
+        ".": {
+          types: "./dist/index.d.ts",
+          require: "./dist/index.js",
+          import: "./dist/index.mjs"
+        }
+      },
+      scripts: {
+        build: "tsup && tsc --emitDeclarationOnly --outDir dist",
+        dev: "tsup --watch",
+        clean: "rm -rf dist .turbo"
+      },
+      dependencies: {},
+      devDependencies: {
+        tsup: "^8.0.0",
+        typescript: "^5.7.2",
+        "@types/node": "^22.0.0"
+      },
+      publishConfig: {
+        access: "public"
+      }
+    };
+  }
+});
+
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
   LetsPing: () => LetsPing,
-  LetsPingError: () => LetsPingError
+  LetsPingError: () => LetsPingError,
+  computeDiff: () => computeDiff
 });
 module.exports = __toCommonJS(index_exports);
+var import_node_crypto = require("crypto");
+var SDK_VERSION = "0.1.2";
+try {
+  SDK_VERSION = require_package().version;
+} catch {
+}
 var LetsPingError = class extends Error {
   constructor(message, status) {
     super(message);
@@ -31,12 +79,81 @@ var LetsPingError = class extends Error {
     this.name = "LetsPingError";
   }
 };
+function isEncEnvelope(v) {
+  return typeof v === "object" && v !== null && v._lp_enc === true && typeof v.iv === "string" && typeof v.ct === "string";
+}
+function encryptPayload(keyBase64, payload) {
+  const keyBuf = Buffer.from(keyBase64, "base64");
+  const iv = (0, import_node_crypto.randomBytes)(12);
+  const cipher = (0, import_node_crypto.createCipheriv)("aes-256-gcm", keyBuf, iv);
+  const plain = Buffer.from(JSON.stringify(payload), "utf8");
+  const ct = Buffer.concat([cipher.update(plain), cipher.final(), cipher.getAuthTag()]);
+  return {
+    _lp_enc: true,
+    iv: iv.toString("base64"),
+    ct: ct.toString("base64")
+  };
+}
+function decryptPayload(keyBase64, envelope) {
+  const keyBuf = Buffer.from(keyBase64, "base64");
+  const iv = Buffer.from(envelope.iv, "base64");
+  const ctFull = Buffer.from(envelope.ct, "base64");
+  const authTag = ctFull.subarray(ctFull.length - 16);
+  const ct = ctFull.subarray(0, ctFull.length - 16);
+  const decipher = (0, import_node_crypto.createDecipheriv)("aes-256-gcm", keyBuf, iv);
+  decipher.setAuthTag(authTag);
+  const plain = Buffer.concat([decipher.update(ct), decipher.final()]);
+  return JSON.parse(plain.toString("utf8"));
+}
+function computeDiff(original, patched) {
+  if (original === patched) return null;
+  if (typeof original !== "object" || typeof patched !== "object" || original === null || patched === null || Array.isArray(original) || Array.isArray(patched)) {
+    if (JSON.stringify(original) !== JSON.stringify(patched)) {
+      return { from: original, to: patched };
+    }
+    return null;
+  }
+  const changes = {};
+  let hasChanges = false;
+  const allKeys = /* @__PURE__ */ new Set([...Object.keys(original), ...Object.keys(patched)]);
+  for (const key of allKeys) {
+    const oV = original[key];
+    const pV = patched[key];
+    if (!(key in original)) {
+      changes[key] = { from: void 0, to: pV };
+      hasChanges = true;
+    } else if (!(key in patched)) {
+      changes[key] = { from: oV, to: void 0 };
+      hasChanges = true;
+    } else {
+      const nestedDiff = computeDiff(oV, pV);
+      if (nestedDiff) {
+        changes[key] = nestedDiff;
+        hasChanges = true;
+      }
+    }
+  }
+  return hasChanges ? changes : null;
+}
 var LetsPing = class {
   constructor(apiKey, options) {
     const key = apiKey || process.env.LETSPING_API_KEY;
     if (!key) throw new Error("LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.");
     this.apiKey = key;
     this.baseUrl = options?.baseUrl || "https://letsping.co/api";
+    this.encryptionKey = options?.encryptionKey ?? process.env.LETSPING_ENCRYPTION_KEY ?? null;
+  }
+  _encrypt(payload) {
+    if (!this.encryptionKey) return payload;
+    return encryptPayload(this.encryptionKey, payload);
+  }
+  _decrypt(val) {
+    if (!this.encryptionKey || !isEncEnvelope(val)) return val;
+    try {
+      return decryptPayload(this.encryptionKey, val);
+    } catch {
+      return val;
+    }
   }
   async ask(options) {
     if (options.schema && options.schema._def) {
@@ -45,13 +162,10 @@ var LetsPing = class {
     const { id } = await this.request("POST", "/ingest", {
       service: options.service,
       action: options.action,
-      payload: options.payload,
+      payload: this._encrypt(options.payload),
       priority: options.priority || "medium",
       schema: options.schema,
-      metadata: {
-        role: options.role,
-        sdk: "node"
-      }
+      metadata: { role: options.role, sdk: "node" }
     });
     const timeout = options.timeoutMs || 24 * 60 * 60 * 1e3;
     const start = Date.now();
@@ -61,10 +175,20 @@ var LetsPing = class {
       try {
         const check = await this.request("GET", `/status/${id}`);
         if (check.status === "APPROVED" || check.status === "REJECTED") {
+          const decryptedPayload = this._decrypt(check.payload) ?? options.payload;
+          const decryptedPatched = check.patched_payload ? this._decrypt(check.patched_payload) : void 0;
+          let diff_summary;
+          let finalStatus = check.status;
+          if (check.status === "APPROVED" && decryptedPatched !== void 0) {
+            finalStatus = "APPROVED_WITH_MODIFICATIONS";
+            const diff = computeDiff(decryptedPayload, decryptedPatched);
+            diff_summary = diff ? { changes: diff } : { changes: "Unknown structure changes" };
+          }
           return {
-            status: check.status,
-            payload: options.payload,
-            patched_payload: check.patched_payload || options.payload,
+            status: finalStatus,
+            payload: decryptedPayload,
+            patched_payload: decryptedPatched,
+            diff_summary,
             metadata: {
               resolved_at: check.resolved_at,
               actor_id: check.actor_id
@@ -72,10 +196,8 @@ var LetsPing = class {
           };
         }
       } catch (e) {
-        const status = e.status;
-        if (status && status >= 400 && status < 500 && status !== 404 && status !== 429) {
-          throw e;
-        }
+        const s = e.status;
+        if (s && s >= 400 && s < 500 && s !== 404 && s !== 429) throw e;
       }
       const jitter = Math.random() * 200;
       await new Promise((r) => setTimeout(r, delay + jitter));
@@ -84,13 +206,16 @@ var LetsPing = class {
     throw new LetsPingError(`Request ${id} timed out waiting for approval.`);
   }
   async defer(options) {
-    return this.request("POST", "/ingest", options);
+    return this.request("POST", "/ingest", {
+      ...options,
+      payload: this._encrypt(options.payload)
+    });
   }
   async request(method, path, body) {
     const headers = {
       "Authorization": `Bearer ${this.apiKey}`,
       "Content-Type": "application/json",
-      "User-Agent": "letsping-node/0.1.2"
+      "User-Agent": `letsping-node/${SDK_VERSION}`
     };
     try {
       const response = await fetch(`${this.baseUrl}${path}`, {
@@ -129,17 +254,23 @@ var LetsPing = class {
         } else {
           payload = { raw_context: String(context) };
         }
-        const result = await this.ask({
-          service,
-          action,
-          payload,
-          priority
-        });
+        const result = await this.ask({ service, action, payload, priority });
         if (result.status === "REJECTED") {
-          return `STOP: Action Rejected by Human.`;
+          return "STOP: Action Rejected by Human.";
         }
-        const finalPayload = result.patched_payload || result.payload;
-        return JSON.stringify(finalPayload);
+        if (result.status === "APPROVED_WITH_MODIFICATIONS") {
+          return JSON.stringify({
+            status: "APPROVED_WITH_MODIFICATIONS",
+            message: "The human reviewer authorized this action but modified your original payload. Please review the diff_summary to learn from this correction.",
+            diff_summary: result.diff_summary,
+            original_payload: result.payload,
+            executed_payload: result.patched_payload
+          });
+        }
+        return JSON.stringify({
+          status: "APPROVED",
+          executed_payload: result.payload
+        });
       } catch (e) {
         return `ERROR: System Failure: ${e.message}`;
       }
@@ -149,6 +280,7 @@ var LetsPing = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LetsPing,
-  LetsPingError
+  LetsPingError,
+  computeDiff
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type Priority = \"low\" | \"medium\" | \"high\" | \"critical\";\r\n\r\n/**\r\n * Options for configuring a LetsPing approval request.\r\n */\r\nexport interface RequestOptions {\r\n    /** Name of the agent or service (e.g., \"billing-agent\") */\r\n    service: string;\r\n    /** Specific action being requested (e.g., \"refund_user\") */\r\n    action: string;\r\n    /** The data payload to be reviewed by the human */\r\n    payload: Record<string, any>;\r\n    /** Urgency level affecting notification routing (default: \"medium\") */\r\n    priority?: Priority;\r\n    /** JSON Schema (Draft 7) for rendering a structured form in the dashboard */\r\n    schema?: Record<string, any>;\r\n    /** Maximum time to wait for approval in milliseconds (default: 24h) */\r\n    timeoutMs?: number;\r\n    /** (Enterprise) Specific role required for approval (e.g., \"finance\") */\r\n    role?: string;\r\n}\r\n\r\n/**\r\n * The result of a human approval decision.\r\n */\r\nexport interface Decision {\r\n    status: \"APPROVED\" | \"REJECTED\";\r\n    /** The original payload submitted */\r\n    payload: any;\r\n    /** The modified payload if the human edited values during approval */\r\n    patched_payload?: any;\r\n    metadata?: {\r\n        resolved_at: string;\r\n        actor_id: string;\r\n        method?: string;\r\n    };\r\n}\r\n\r\nexport class LetsPingError extends Error {\r\n    constructor(message: string, public status?: number) {\r\n        super(message);\r\n        this.name = \"LetsPingError\";\r\n    }\r\n}\r\n\r\nexport class LetsPing {\r\n    private readonly apiKey: string;\r\n    private readonly baseUrl: string;\r\n\r\n    constructor(apiKey?: string, options?: { baseUrl?: string }) {\r\n        const key = apiKey || process.env.LETSPING_API_KEY;\r\n        if (!key) throw new Error(\"LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.\");\r\n\r\n        this.apiKey = key;\r\n        this.baseUrl = options?.baseUrl || \"https://letsping.co/api\";\r\n    }\r\n\r\n    async ask(options: RequestOptions): Promise<Decision> {\r\n        if (options.schema && (options.schema as any)._def) {\r\n            throw new LetsPingError(\"LetsPing Error: Raw Zod schema detected. You must convert it to JSON Schema (e.g. using 'zod-to-json-schema') before passing it to the SDK.\");\r\n        }\r\n\r\n        const { id } = await this.request<{ id: string }>(\"POST\", \"/ingest\", {\r\n            service: options.service,\r\n            action: options.action,\r\n            payload: options.payload,\r\n            priority: options.priority || \"medium\",\r\n            schema: options.schema,\r\n            metadata: {\r\n                role: options.role,\r\n                sdk: \"node\"\r\n            }\r\n        });\r\n\r\n        const timeout = options.timeoutMs || 24 * 60 * 60 * 1000;\r\n        const start = Date.now();\r\n        let delay = 1000;\r\n        const maxDelay = 10000;\r\n\r\n        while (Date.now() - start < timeout) {\r\n            try {\r\n                const check = await this.request<any>(\"GET\", `/status/${id}`);\r\n\r\n                if (check.status === \"APPROVED\" || check.status === \"REJECTED\") {\r\n                    return {\r\n                        status: check.status,\r\n                        payload: options.payload,\r\n                        patched_payload: check.patched_payload || options.payload,\r\n                        metadata: {\r\n                            resolved_at: check.resolved_at,\r\n                            actor_id: check.actor_id\r\n                        }\r\n                    };\r\n                }\r\n            } catch (e: any) {\r\n                // Retry on:\r\n                // 1. Network errors (status is undefined)\r\n                // 2. 404 (not found yet)\r\n                // 3. 429 (rate limit)\r\n                // 4. 5xx (server error)\r\n                // Fail on: 400, 401, 403 (client errors)\r\n                const status = e.status;\r\n                if (status && status >= 400 && status < 500 && status !== 404 && status !== 429) {\r\n                    throw e;\r\n                }\r\n            }\r\n\r\n            const jitter = Math.random() * 200;\r\n            await new Promise(r => setTimeout(r, delay + jitter));\r\n            delay = Math.min(delay * 1.5, maxDelay);\r\n        }\r\n\r\n        throw new LetsPingError(`Request ${id} timed out waiting for approval.`);\r\n    }\r\n\r\n    async defer(options: RequestOptions): Promise<{ id: string }> {\r\n        return this.request<{ id: string }>(\"POST\", \"/ingest\", options);\r\n    }\r\n\r\n    private async request<T>(method: string, path: string, body?: any): Promise<T> {\r\n        // Shared headers\r\n        const headers: Record<string, string> = {\r\n            \"Authorization\": `Bearer ${this.apiKey}`,\r\n            \"Content-Type\": \"application/json\",\r\n            \"User-Agent\": \"letsping-node/0.1.2\"\r\n        };\r\n\r\n        try {\r\n            const response = await fetch(`${this.baseUrl}${path}`, {\r\n                method,\r\n                headers,\r\n                body: body ? JSON.stringify(body) : undefined,\r\n            });\r\n\r\n            if (!response.ok) {\r\n                const errorText = await response.text();\r\n                // Try parsing JSON error message\r\n                let message = errorText;\r\n                try {\r\n                    const json = JSON.parse(errorText);\r\n                    if (json.message) message = json.message;\r\n                } catch { }\r\n\r\n                throw new LetsPingError(`API Error [${response.status}]: ${message}`, response.status);\r\n            }\r\n\r\n            return response.json() as Promise<T>;\r\n        } catch (e: any) {\r\n            if (e instanceof LetsPingError) throw e;\r\n            // Fetch/Network errors\r\n            throw new LetsPingError(`Network Error: ${e.message}`);\r\n        }\r\n    }\r\n    tool(service: string, action: string, priority: Priority = \"medium\"): (context: string | Record<string, any>) => Promise<string> {\r\n        return async (context: string | Record<string, any>): Promise<string> => {\r\n            let payload: Record<string, any>;\r\n            try {\r\n                if (typeof context === 'string') {\r\n                    try {\r\n                        payload = JSON.parse(context);\r\n                    } catch {\r\n                        payload = { raw_context: context };\r\n                    }\r\n                } else if (typeof context === 'object' && context !== null) {\r\n                    payload = context;\r\n                } else {\r\n                    // Handle numbers, booleans, undefined, etc.\r\n                    payload = { raw_context: String(context) };\r\n                }\r\n\r\n                const result = await this.ask({\r\n                    service,\r\n                    action,\r\n                    payload,\r\n                    priority\r\n                });\r\n\r\n                if (result.status === \"REJECTED\") {\r\n                    return `STOP: Action Rejected by Human.`;\r\n                }\r\n\r\n                const finalPayload = result.patched_payload || result.payload;\r\n                return JSON.stringify(finalPayload);\r\n            } catch (e: any) {\r\n                return `ERROR: System Failure: ${e.message}`;\r\n            }\r\n        };\r\n    }\r\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsCO,IAAM,gBAAN,cAA4B,MAAM;AAAA,EACrC,YAAY,SAAwB,QAAiB;AACjD,UAAM,OAAO;AADmB;AAEhC,SAAK,OAAO;AAAA,EAChB;AACJ;AAEO,IAAM,WAAN,MAAe;AAAA,EAIlB,YAAY,QAAiB,SAAgC;AACzD,UAAM,MAAM,UAAU,QAAQ,IAAI;AAClC,QAAI,CAAC,IAAK,OAAM,IAAI,MAAM,4FAA4F;AAEtH,SAAK,SAAS;AACd,SAAK,UAAU,SAAS,WAAW;AAAA,EACvC;AAAA,EAEA,MAAM,IAAI,SAA4C;AAClD,QAAI,QAAQ,UAAW,QAAQ,OAAe,MAAM;AAChD,YAAM,IAAI,cAAc,6IAA6I;AAAA,IACzK;AAEA,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,QAAwB,QAAQ,WAAW;AAAA,MACjE,SAAS,QAAQ;AAAA,MACjB,QAAQ,QAAQ;AAAA,MAChB,SAAS,QAAQ;AAAA,MACjB,UAAU,QAAQ,YAAY;AAAA,MAC9B,QAAQ,QAAQ;AAAA,MAChB,UAAU;AAAA,QACN,MAAM,QAAQ;AAAA,QACd,KAAK;AAAA,MACT;AAAA,IACJ,CAAC;AAED,UAAM,UAAU,QAAQ,aAAa,KAAK,KAAK,KAAK;AACpD,UAAM,QAAQ,KAAK,IAAI;AACvB,QAAI,QAAQ;AACZ,UAAM,WAAW;AAEjB,WAAO,KAAK,IAAI,IAAI,QAAQ,SAAS;AACjC,UAAI;AACA,cAAM,QAAQ,MAAM,KAAK,QAAa,OAAO,WAAW,EAAE,EAAE;AAE5D,YAAI,MAAM,WAAW,cAAc,MAAM,WAAW,YAAY;AAC5D,iBAAO;AAAA,YACH,QAAQ,MAAM;AAAA,YACd,SAAS,QAAQ;AAAA,YACjB,iBAAiB,MAAM,mBAAmB,QAAQ;AAAA,YAClD,UAAU;AAAA,cACN,aAAa,MAAM;AAAA,cACnB,UAAU,MAAM;AAAA,YACpB;AAAA,UACJ;AAAA,QACJ;AAAA,MACJ,SAAS,GAAQ;AAOb,cAAM,SAAS,EAAE;AACjB,YAAI,UAAU,UAAU,OAAO,SAAS,OAAO,WAAW,OAAO,WAAW,KAAK;AAC7E,gBAAM;AAAA,QACV;AAAA,MACJ;AAEA,YAAM,SAAS,KAAK,OAAO,IAAI;AAC/B,YAAM,IAAI,QAAQ,OAAK,WAAW,GAAG,QAAQ,MAAM,CAAC;AACpD,cAAQ,KAAK,IAAI,QAAQ,KAAK,QAAQ;AAAA,IAC1C;AAEA,UAAM,IAAI,cAAc,WAAW,EAAE,kCAAkC;AAAA,EAC3E;AAAA,EAEA,MAAM,MAAM,SAAkD;AAC1D,WAAO,KAAK,QAAwB,QAAQ,WAAW,OAAO;AAAA,EAClE;AAAA,EAEA,MAAc,QAAW,QAAgB,MAAc,MAAwB;AAE3E,UAAM,UAAkC;AAAA,MACpC,iBAAiB,UAAU,KAAK,MAAM;AAAA,MACtC,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAClB;AAEA,QAAI;AACA,YAAM,WAAW,MAAM,MAAM,GAAG,KAAK,OAAO,GAAG,IAAI,IAAI;AAAA,QACnD;AAAA,QACA;AAAA,QACA,MAAM,OAAO,KAAK,UAAU,IAAI,IAAI;AAAA,MACxC,CAAC;AAED,UAAI,CAAC,SAAS,IAAI;AACd,cAAM,YAAY,MAAM,SAAS,KAAK;AAEtC,YAAI,UAAU;AACd,YAAI;AACA,gBAAM,OAAO,KAAK,MAAM,SAAS;AACjC,cAAI,KAAK,QAAS,WAAU,KAAK;AAAA,QACrC,QAAQ;AAAA,QAAE;AAEV,cAAM,IAAI,cAAc,cAAc,SAAS,MAAM,MAAM,OAAO,IAAI,SAAS,MAAM;AAAA,MACzF;AAEA,aAAO,SAAS,KAAK;AAAA,IACzB,SAAS,GAAQ;AACb,UAAI,aAAa,cAAe,OAAM;AAEtC,YAAM,IAAI,cAAc,kBAAkB,EAAE,OAAO,EAAE;AAAA,IACzD;AAAA,EACJ;AAAA,EACA,KAAK,SAAiB,QAAgB,WAAqB,UAAsE;AAC7H,WAAO,OAAO,YAA2D;AACrE,UAAI;AACJ,UAAI;AACA,YAAI,OAAO,YAAY,UAAU;AAC7B,cAAI;AACA,sBAAU,KAAK,MAAM,OAAO;AAAA,UAChC,QAAQ;AACJ,sBAAU,EAAE,aAAa,QAAQ;AAAA,UACrC;AAAA,QACJ,WAAW,OAAO,YAAY,YAAY,YAAY,MAAM;AACxD,oBAAU;AAAA,QACd,OAAO;AAEH,oBAAU,EAAE,aAAa,OAAO,OAAO,EAAE;AAAA,QAC7C;AAEA,cAAM,SAAS,MAAM,KAAK,IAAI;AAAA,UAC1B;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACJ,CAAC;AAED,YAAI,OAAO,WAAW,YAAY;AAC9B,iBAAO;AAAA,QACX;AAEA,cAAM,eAAe,OAAO,mBAAmB,OAAO;AACtD,eAAO,KAAK,UAAU,YAAY;AAAA,MACtC,SAAS,GAAQ;AACb,eAAO,0BAA0B,EAAE,OAAO;AAAA,MAC9C;AAAA,IACJ;AAAA,EACJ;AACJ;","names":[]}
+{"version":3,"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@letsping/sdk\",\n  \"version\": \"0.1.3\",\n  \"description\": \"The Human-in-the-Loop SDK for Autonomous Agents\",\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.mjs\",\n  \"files\": [\n    \"dist\"\n  ],\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"require\": \"./dist/index.js\",\n      \"import\": \"./dist/index.mjs\"\n    }\n  },\n  \"scripts\": {\n    \"build\": \"tsup && tsc --emitDeclarationOnly --outDir dist\",\n    \"dev\": \"tsup --watch\",\n    \"clean\": \"rm -rf dist .turbo\"\n  },\n  \"dependencies\": {},\n  \"devDependencies\": {\n    \"tsup\": \"^8.0.0\",\n    \"typescript\": \"^5.7.2\",\n    \"@types/node\": \"^22.0.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  }\n}","import { createCipheriv, createDecipheriv, randomBytes } from \"node:crypto\";\r\n\nlet SDK_VERSION = \"0.1.2\";\r\ntry {\r\n    \n    SDK_VERSION = require(\"../package.json\").version;\r\n} catch {  }\r\n\r\nexport type Priority = \"low\" | \"medium\" | \"high\" | \"critical\";\r\n\nexport interface RequestOptions {\r\n    \r\n    service: string;\r\n    \r\n    action: string;\r\n    \r\n    payload: Record<string, any>;\r\n    \r\n    priority?: Priority;\r\n    \r\n    schema?: Record<string, any>;\r\n    \r\n    timeoutMs?: number;\r\n    \r\n    role?: string;\r\n}\r\n\nexport interface Decision {\r\n    status: \"APPROVED\" | \"REJECTED\" | \"APPROVED_WITH_MODIFICATIONS\";\r\n    \r\n    payload: any;\r\n    \r\n    patched_payload?: any;\r\n    \r\n    diff_summary?: any;\r\n    metadata?: {\r\n        resolved_at: string;\r\n        actor_id: string;\r\n        method?: string;\r\n    };\r\n}\r\n\r\nexport class LetsPingError extends Error {\r\n    constructor(message: string, public status?: number) {\r\n        super(message);\r\n        this.name = \"LetsPingError\";\r\n    }\r\n}\r\n\ninterface EncEnvelope {\r\n    _lp_enc: true;\r\n    iv: string;  \n    ct: string;  \n}\r\n\r\nfunction isEncEnvelope(v: unknown): v is EncEnvelope {\r\n    return (\r\n        typeof v === \"object\" && v !== null &&\r\n        (v as any)._lp_enc === true &&\r\n        typeof (v as any).iv === \"string\" &&\r\n        typeof (v as any).ct === \"string\"\r\n    );\r\n}\r\n\r\nfunction encryptPayload(keyBase64: string, payload: Record<string, any>): EncEnvelope {\r\n    const keyBuf = Buffer.from(keyBase64, \"base64\");\r\n    const iv = randomBytes(12);\r\n    const cipher = createCipheriv(\"aes-256-gcm\", keyBuf, iv);\r\n    const plain = Buffer.from(JSON.stringify(payload), \"utf8\");\r\n    const ct = Buffer.concat([cipher.update(plain), cipher.final(), cipher.getAuthTag()]);\r\n    return {\r\n        _lp_enc: true,\r\n        iv: iv.toString(\"base64\"),\r\n        ct: ct.toString(\"base64\"),\r\n    };\r\n}\r\n\r\nfunction decryptPayload(keyBase64: string, envelope: EncEnvelope): Record<string, any> {\r\n    const keyBuf = Buffer.from(keyBase64, \"base64\");\r\n    const iv = Buffer.from(envelope.iv, \"base64\");\r\n    const ctFull = Buffer.from(envelope.ct, \"base64\");\r\n    \n    const authTag = ctFull.subarray(ctFull.length - 16);\r\n    const ct = ctFull.subarray(0, ctFull.length - 16);\r\n    const decipher = createDecipheriv(\"aes-256-gcm\", keyBuf, iv);\r\n    decipher.setAuthTag(authTag);\r\n    const plain = Buffer.concat([decipher.update(ct), decipher.final()]);\r\n    return JSON.parse(plain.toString(\"utf8\"));\r\n}\r\n\r\nfunction computeDiff(original: any, patched: any): any {\r\n    if (original === patched) return null;\r\n\r\n    if (\r\n        typeof original !== \"object\" ||\r\n        typeof patched !== \"object\" ||\r\n        original === null ||\r\n        patched === null ||\r\n        Array.isArray(original) ||\r\n        Array.isArray(patched)\r\n    ) {\r\n        if (JSON.stringify(original) !== JSON.stringify(patched)) {\r\n            return { from: original, to: patched };\r\n        }\r\n        return null;\r\n    }\r\n\r\n    const changes: Record<string, any> = {};\r\n    let hasChanges = false;\r\n    const allKeys = new Set([...Object.keys(original), ...Object.keys(patched)]);\r\n\r\n    for (const key of allKeys) {\r\n        const oV = original[key];\r\n        const pV = patched[key];\r\n\r\n        if (!(key in original)) {\r\n            changes[key] = { from: undefined, to: pV };\r\n            hasChanges = true;\r\n        } else if (!(key in patched)) {\r\n            changes[key] = { from: oV, to: undefined };\r\n            hasChanges = true;\r\n        } else {\r\n            const nestedDiff = computeDiff(oV, pV);\r\n            if (nestedDiff) {\r\n                changes[key] = nestedDiff;\r\n                hasChanges = true;\r\n            }\r\n        }\r\n    }\r\n\r\n    return hasChanges ? changes : null;\r\n}\r\n\nexport class LetsPing {\r\n    private readonly apiKey: string;\r\n    private readonly baseUrl: string;\r\n    private readonly encryptionKey: string | null;\r\n\n    constructor(apiKey?: string, options?: { baseUrl?: string; encryptionKey?: string }) {\r\n        const key = apiKey || process.env.LETSPING_API_KEY;\r\n        if (!key) throw new Error(\"LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.\");\r\n\r\n        this.apiKey = key;\r\n        this.baseUrl = options?.baseUrl || \"https://letsping.co/api\";\r\n        this.encryptionKey = options?.encryptionKey\r\n            ?? process.env.LETSPING_ENCRYPTION_KEY\r\n            ?? null;\r\n    }\r\n\r\n    private _encrypt(payload: Record<string, any>): Record<string, any> {\r\n        if (!this.encryptionKey) return payload;\r\n        return encryptPayload(this.encryptionKey, payload) as any;\r\n    }\r\n\r\n    private _decrypt(val: any): any {\r\n        if (!this.encryptionKey || !isEncEnvelope(val)) return val;\r\n        try {\r\n            return decryptPayload(this.encryptionKey, val);\r\n        } catch {\r\n            \n            return val;\r\n        }\r\n    }\r\n\n    async ask(options: RequestOptions): Promise<Decision> {\r\n        if (options.schema && (options.schema as any)._def) {\r\n            throw new LetsPingError(\"LetsPing Error: Raw Zod schema detected. You must convert it to JSON Schema (e.g. using 'zod-to-json-schema') before passing it to the SDK.\");\r\n        }\r\n\r\n        const { id } = await this.request<{ id: string }>(\"POST\", \"/ingest\", {\r\n            service: options.service,\r\n            action: options.action,\r\n            payload: this._encrypt(options.payload),\r\n            priority: options.priority || \"medium\",\r\n            schema: options.schema,\r\n            metadata: { role: options.role, sdk: \"node\" }\r\n        });\r\n\r\n        const timeout = options.timeoutMs || 24 * 60 * 60 * 1000;\r\n        const start = Date.now();\r\n        let delay = 1000;\r\n        const maxDelay = 10000;\r\n\r\n        while (Date.now() - start < timeout) {\r\n            try {\r\n                const check = await this.request<any>(\"GET\", `/status/${id}`);\r\n\r\n                if (check.status === \"APPROVED\" || check.status === \"REJECTED\") {\r\n                    const decryptedPayload = this._decrypt(check.payload) ?? options.payload;\r\n                    const decryptedPatched = check.patched_payload ? this._decrypt(check.patched_payload) : undefined;\r\n\r\n                    let diff_summary;\r\n                    let finalStatus = check.status;\r\n                    if (check.status === \"APPROVED\" && decryptedPatched !== undefined) {\r\n                        finalStatus = \"APPROVED_WITH_MODIFICATIONS\";\r\n                        const diff = computeDiff(decryptedPayload, decryptedPatched);\r\n                        diff_summary = diff ? { changes: diff } : { changes: \"Unknown structure changes\" };\r\n                    }\r\n\r\n                    return {\r\n                        status: finalStatus,\r\n                        payload: decryptedPayload,\r\n                        patched_payload: decryptedPatched,\r\n                        diff_summary,\r\n                        metadata: {\r\n                            resolved_at: check.resolved_at,\r\n                            actor_id: check.actor_id,\r\n                        }\r\n                    };\r\n                }\r\n            } catch (e: any) {\r\n                const s = e.status;\r\n                if (s && s >= 400 && s < 500 && s !== 404 && s !== 429) throw e;\r\n            }\r\n\r\n            const jitter = Math.random() * 200;\r\n            await new Promise(r => setTimeout(r, delay + jitter));\r\n            delay = Math.min(delay * 1.5, maxDelay);\r\n        }\r\n\r\n        throw new LetsPingError(`Request ${id} timed out waiting for approval.`);\r\n    }\r\n\r\n    async defer(options: RequestOptions): Promise<{ id: string }> {\r\n        return this.request<{ id: string }>(\"POST\", \"/ingest\", {\r\n            ...options,\r\n            payload: this._encrypt(options.payload),\r\n        });\r\n    }\r\n\r\n    private async request<T>(method: string, path: string, body?: any): Promise<T> {\r\n        const headers: Record<string, string> = {\r\n            \"Authorization\": `Bearer ${this.apiKey}`,\r\n            \"Content-Type\": \"application/json\",\r\n            \"User-Agent\": `letsping-node/${SDK_VERSION}`,\r\n        };\r\n\r\n        try {\r\n            const response = await fetch(`${this.baseUrl}${path}`, {\r\n                method,\r\n                headers,\r\n                body: body ? JSON.stringify(body) : undefined,\r\n            });\r\n\r\n            if (!response.ok) {\r\n                const errorText = await response.text();\r\n                let message = errorText;\r\n                try {\r\n                    const json = JSON.parse(errorText);\r\n                    if (json.message) message = json.message;\r\n                } catch { }\r\n                throw new LetsPingError(`API Error [${response.status}]: ${message}`, response.status);\r\n            }\r\n\r\n            return response.json() as Promise<T>;\r\n        } catch (e: any) {\r\n            if (e instanceof LetsPingError) throw e;\r\n            throw new LetsPingError(`Network Error: ${e.message}`);\r\n        }\r\n    }\r\n\r\n    tool(service: string, action: string, priority: Priority = \"medium\"): (context: string | Record<string, any>) => Promise<string> {\r\n        return async (context: string | Record<string, any>): Promise<string> => {\r\n            let payload: Record<string, any>;\r\n            try {\r\n                if (typeof context === \"string\") {\r\n                    try { payload = JSON.parse(context); }\r\n                    catch { payload = { raw_context: context }; }\r\n                } else if (typeof context === \"object\" && context !== null) {\r\n                    payload = context;\r\n                } else {\r\n                    payload = { raw_context: String(context) };\r\n                }\r\n\r\n                const result = await this.ask({ service, action, payload, priority });\r\n\r\n                if (result.status === \"REJECTED\") {\r\n                    return \"STOP: Action Rejected by Human.\";\r\n                }\r\n\r\n                if (result.status === \"APPROVED_WITH_MODIFICATIONS\") {\r\n                    return JSON.stringify({\r\n                        status: \"APPROVED_WITH_MODIFICATIONS\",\r\n                        message: \"The human reviewer authorized this action but modified your original payload. Please review the diff_summary to learn from this correction.\",\r\n                        diff_summary: result.diff_summary,\r\n                        original_payload: result.payload,\r\n                        executed_payload: result.patched_payload\r\n                    });\r\n                }\r\n\r\n                return JSON.stringify({\r\n                    status: \"APPROVED\",\r\n                    executed_payload: result.payload\r\n                });\r\n            } catch (e: any) {\r\n                return `ERROR: System Failure: ${e.message}`;\r\n            }\r\n        };\r\n    }\r\n}\r\n\r\nexport { computeDiff };"],"mappings":"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","names":["exports","module"]}

package/dist/index.mjs

@@ -1,4 +1,53 @@
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports, module) {
+    module.exports = {
+      name: "@letsping/sdk",
+      version: "0.1.3",
+      description: "The Human-in-the-Loop SDK for Autonomous Agents",
+      main: "./dist/index.js",
+      module: "./dist/index.mjs",
+      files: [
+        "dist"
+      ],
+      types: "./dist/index.d.ts",
+      exports: {
+        ".": {
+          types: "./dist/index.d.ts",
+          require: "./dist/index.js",
+          import: "./dist/index.mjs"
+        }
+      },
+      scripts: {
+        build: "tsup && tsc --emitDeclarationOnly --outDir dist",
+        dev: "tsup --watch",
+        clean: "rm -rf dist .turbo"
+      },
+      dependencies: {},
+      devDependencies: {
+        tsup: "^8.0.0",
+        typescript: "^5.7.2",
+        "@types/node": "^22.0.0"
+      },
+      publishConfig: {
+        access: "public"
+      }
+    };
+  }
+});
+
 // src/index.ts
+import { createCipheriv, createDecipheriv, randomBytes } from "crypto";
+var SDK_VERSION = "0.1.2";
+try {
+  SDK_VERSION = require_package().version;
+} catch {
+}
 var LetsPingError = class extends Error {
   constructor(message, status) {
     super(message);
@@ -6,12 +55,81 @@ var LetsPingError = class extends Error {
     this.name = "LetsPingError";
   }
 };
+function isEncEnvelope(v) {
+  return typeof v === "object" && v !== null && v._lp_enc === true && typeof v.iv === "string" && typeof v.ct === "string";
+}
+function encryptPayload(keyBase64, payload) {
+  const keyBuf = Buffer.from(keyBase64, "base64");
+  const iv = randomBytes(12);
+  const cipher = createCipheriv("aes-256-gcm", keyBuf, iv);
+  const plain = Buffer.from(JSON.stringify(payload), "utf8");
+  const ct = Buffer.concat([cipher.update(plain), cipher.final(), cipher.getAuthTag()]);
+  return {
+    _lp_enc: true,
+    iv: iv.toString("base64"),
+    ct: ct.toString("base64")
+  };
+}
+function decryptPayload(keyBase64, envelope) {
+  const keyBuf = Buffer.from(keyBase64, "base64");
+  const iv = Buffer.from(envelope.iv, "base64");
+  const ctFull = Buffer.from(envelope.ct, "base64");
+  const authTag = ctFull.subarray(ctFull.length - 16);
+  const ct = ctFull.subarray(0, ctFull.length - 16);
+  const decipher = createDecipheriv("aes-256-gcm", keyBuf, iv);
+  decipher.setAuthTag(authTag);
+  const plain = Buffer.concat([decipher.update(ct), decipher.final()]);
+  return JSON.parse(plain.toString("utf8"));
+}
+function computeDiff(original, patched) {
+  if (original === patched) return null;
+  if (typeof original !== "object" || typeof patched !== "object" || original === null || patched === null || Array.isArray(original) || Array.isArray(patched)) {
+    if (JSON.stringify(original) !== JSON.stringify(patched)) {
+      return { from: original, to: patched };
+    }
+    return null;
+  }
+  const changes = {};
+  let hasChanges = false;
+  const allKeys = /* @__PURE__ */ new Set([...Object.keys(original), ...Object.keys(patched)]);
+  for (const key of allKeys) {
+    const oV = original[key];
+    const pV = patched[key];
+    if (!(key in original)) {
+      changes[key] = { from: void 0, to: pV };
+      hasChanges = true;
+    } else if (!(key in patched)) {
+      changes[key] = { from: oV, to: void 0 };
+      hasChanges = true;
+    } else {
+      const nestedDiff = computeDiff(oV, pV);
+      if (nestedDiff) {
+        changes[key] = nestedDiff;
+        hasChanges = true;
+      }
+    }
+  }
+  return hasChanges ? changes : null;
+}
 var LetsPing = class {
   constructor(apiKey, options) {
     const key = apiKey || process.env.LETSPING_API_KEY;
     if (!key) throw new Error("LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.");
     this.apiKey = key;
     this.baseUrl = options?.baseUrl || "https://letsping.co/api";
+    this.encryptionKey = options?.encryptionKey ?? process.env.LETSPING_ENCRYPTION_KEY ?? null;
+  }
+  _encrypt(payload) {
+    if (!this.encryptionKey) return payload;
+    return encryptPayload(this.encryptionKey, payload);
+  }
+  _decrypt(val) {
+    if (!this.encryptionKey || !isEncEnvelope(val)) return val;
+    try {
+      return decryptPayload(this.encryptionKey, val);
+    } catch {
+      return val;
+    }
   }
   async ask(options) {
     if (options.schema && options.schema._def) {
@@ -20,13 +138,10 @@ var LetsPing = class {
     const { id } = await this.request("POST", "/ingest", {
       service: options.service,
       action: options.action,
-      payload: options.payload,
+      payload: this._encrypt(options.payload),
       priority: options.priority || "medium",
       schema: options.schema,
-      metadata: {
-        role: options.role,
-        sdk: "node"
-      }
+      metadata: { role: options.role, sdk: "node" }
     });
     const timeout = options.timeoutMs || 24 * 60 * 60 * 1e3;
     const start = Date.now();
@@ -36,10 +151,20 @@ var LetsPing = class {
       try {
         const check = await this.request("GET", `/status/${id}`);
         if (check.status === "APPROVED" || check.status === "REJECTED") {
+          const decryptedPayload = this._decrypt(check.payload) ?? options.payload;
+          const decryptedPatched = check.patched_payload ? this._decrypt(check.patched_payload) : void 0;
+          let diff_summary;
+          let finalStatus = check.status;
+          if (check.status === "APPROVED" && decryptedPatched !== void 0) {
+            finalStatus = "APPROVED_WITH_MODIFICATIONS";
+            const diff = computeDiff(decryptedPayload, decryptedPatched);
+            diff_summary = diff ? { changes: diff } : { changes: "Unknown structure changes" };
+          }
           return {
-            status: check.status,
-            payload: options.payload,
-            patched_payload: check.patched_payload || options.payload,
+            status: finalStatus,
+            payload: decryptedPayload,
+            patched_payload: decryptedPatched,
+            diff_summary,
             metadata: {
               resolved_at: check.resolved_at,
               actor_id: check.actor_id
@@ -47,10 +172,8 @@ var LetsPing = class {
           };
         }
       } catch (e) {
-        const status = e.status;
-        if (status && status >= 400 && status < 500 && status !== 404 && status !== 429) {
-          throw e;
-        }
+        const s = e.status;
+        if (s && s >= 400 && s < 500 && s !== 404 && s !== 429) throw e;
       }
       const jitter = Math.random() * 200;
       await new Promise((r) => setTimeout(r, delay + jitter));
@@ -59,13 +182,16 @@ var LetsPing = class {
     throw new LetsPingError(`Request ${id} timed out waiting for approval.`);
   }
   async defer(options) {
-    return this.request("POST", "/ingest", options);
+    return this.request("POST", "/ingest", {
+      ...options,
+      payload: this._encrypt(options.payload)
+    });
   }
   async request(method, path, body) {
     const headers = {
       "Authorization": `Bearer ${this.apiKey}`,
       "Content-Type": "application/json",
-      "User-Agent": "letsping-node/0.1.2"
+      "User-Agent": `letsping-node/${SDK_VERSION}`
     };
     try {
       const response = await fetch(`${this.baseUrl}${path}`, {
@@ -104,17 +230,23 @@ var LetsPing = class {
         } else {
           payload = { raw_context: String(context) };
         }
-        const result = await this.ask({
-          service,
-          action,
-          payload,
-          priority
-        });
+        const result = await this.ask({ service, action, payload, priority });
         if (result.status === "REJECTED") {
-          return `STOP: Action Rejected by Human.`;
+          return "STOP: Action Rejected by Human.";
         }
-        const finalPayload = result.patched_payload || result.payload;
-        return JSON.stringify(finalPayload);
+        if (result.status === "APPROVED_WITH_MODIFICATIONS") {
+          return JSON.stringify({
+            status: "APPROVED_WITH_MODIFICATIONS",
+            message: "The human reviewer authorized this action but modified your original payload. Please review the diff_summary to learn from this correction.",
+            diff_summary: result.diff_summary,
+            original_payload: result.payload,
+            executed_payload: result.patched_payload
+          });
+        }
+        return JSON.stringify({
+          status: "APPROVED",
+          executed_payload: result.payload
+        });
       } catch (e) {
         return `ERROR: System Failure: ${e.message}`;
       }
@@ -123,6 +255,7 @@ var LetsPing = class {
 };
 export {
   LetsPing,
-  LetsPingError
+  LetsPingError,
+  computeDiff
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type Priority = \"low\" | \"medium\" | \"high\" | \"critical\";\r\n\r\n/**\r\n * Options for configuring a LetsPing approval request.\r\n */\r\nexport interface RequestOptions {\r\n    /** Name of the agent or service (e.g., \"billing-agent\") */\r\n    service: string;\r\n    /** Specific action being requested (e.g., \"refund_user\") */\r\n    action: string;\r\n    /** The data payload to be reviewed by the human */\r\n    payload: Record<string, any>;\r\n    /** Urgency level affecting notification routing (default: \"medium\") */\r\n    priority?: Priority;\r\n    /** JSON Schema (Draft 7) for rendering a structured form in the dashboard */\r\n    schema?: Record<string, any>;\r\n    /** Maximum time to wait for approval in milliseconds (default: 24h) */\r\n    timeoutMs?: number;\r\n    /** (Enterprise) Specific role required for approval (e.g., \"finance\") */\r\n    role?: string;\r\n}\r\n\r\n/**\r\n * The result of a human approval decision.\r\n */\r\nexport interface Decision {\r\n    status: \"APPROVED\" | \"REJECTED\";\r\n    /** The original payload submitted */\r\n    payload: any;\r\n    /** The modified payload if the human edited values during approval */\r\n    patched_payload?: any;\r\n    metadata?: {\r\n        resolved_at: string;\r\n        actor_id: string;\r\n        method?: string;\r\n    };\r\n}\r\n\r\nexport class LetsPingError extends Error {\r\n    constructor(message: string, public status?: number) {\r\n        super(message);\r\n        this.name = \"LetsPingError\";\r\n    }\r\n}\r\n\r\nexport class LetsPing {\r\n    private readonly apiKey: string;\r\n    private readonly baseUrl: string;\r\n\r\n    constructor(apiKey?: string, options?: { baseUrl?: string }) {\r\n        const key = apiKey || process.env.LETSPING_API_KEY;\r\n        if (!key) throw new Error(\"LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.\");\r\n\r\n        this.apiKey = key;\r\n        this.baseUrl = options?.baseUrl || \"https://letsping.co/api\";\r\n    }\r\n\r\n    async ask(options: RequestOptions): Promise<Decision> {\r\n        if (options.schema && (options.schema as any)._def) {\r\n            throw new LetsPingError(\"LetsPing Error: Raw Zod schema detected. You must convert it to JSON Schema (e.g. using 'zod-to-json-schema') before passing it to the SDK.\");\r\n        }\r\n\r\n        const { id } = await this.request<{ id: string }>(\"POST\", \"/ingest\", {\r\n            service: options.service,\r\n            action: options.action,\r\n            payload: options.payload,\r\n            priority: options.priority || \"medium\",\r\n            schema: options.schema,\r\n            metadata: {\r\n                role: options.role,\r\n                sdk: \"node\"\r\n            }\r\n        });\r\n\r\n        const timeout = options.timeoutMs || 24 * 60 * 60 * 1000;\r\n        const start = Date.now();\r\n        let delay = 1000;\r\n        const maxDelay = 10000;\r\n\r\n        while (Date.now() - start < timeout) {\r\n            try {\r\n                const check = await this.request<any>(\"GET\", `/status/${id}`);\r\n\r\n                if (check.status === \"APPROVED\" || check.status === \"REJECTED\") {\r\n                    return {\r\n                        status: check.status,\r\n                        payload: options.payload,\r\n                        patched_payload: check.patched_payload || options.payload,\r\n                        metadata: {\r\n                            resolved_at: check.resolved_at,\r\n                            actor_id: check.actor_id\r\n                        }\r\n                    };\r\n                }\r\n            } catch (e: any) {\r\n                // Retry on:\r\n                // 1. Network errors (status is undefined)\r\n                // 2. 404 (not found yet)\r\n                // 3. 429 (rate limit)\r\n                // 4. 5xx (server error)\r\n                // Fail on: 400, 401, 403 (client errors)\r\n                const status = e.status;\r\n                if (status && status >= 400 && status < 500 && status !== 404 && status !== 429) {\r\n                    throw e;\r\n                }\r\n            }\r\n\r\n            const jitter = Math.random() * 200;\r\n            await new Promise(r => setTimeout(r, delay + jitter));\r\n            delay = Math.min(delay * 1.5, maxDelay);\r\n        }\r\n\r\n        throw new LetsPingError(`Request ${id} timed out waiting for approval.`);\r\n    }\r\n\r\n    async defer(options: RequestOptions): Promise<{ id: string }> {\r\n        return this.request<{ id: string }>(\"POST\", \"/ingest\", options);\r\n    }\r\n\r\n    private async request<T>(method: string, path: string, body?: any): Promise<T> {\r\n        // Shared headers\r\n        const headers: Record<string, string> = {\r\n            \"Authorization\": `Bearer ${this.apiKey}`,\r\n            \"Content-Type\": \"application/json\",\r\n            \"User-Agent\": \"letsping-node/0.1.2\"\r\n        };\r\n\r\n        try {\r\n            const response = await fetch(`${this.baseUrl}${path}`, {\r\n                method,\r\n                headers,\r\n                body: body ? JSON.stringify(body) : undefined,\r\n            });\r\n\r\n            if (!response.ok) {\r\n                const errorText = await response.text();\r\n                // Try parsing JSON error message\r\n                let message = errorText;\r\n                try {\r\n                    const json = JSON.parse(errorText);\r\n                    if (json.message) message = json.message;\r\n                } catch { }\r\n\r\n                throw new LetsPingError(`API Error [${response.status}]: ${message}`, response.status);\r\n            }\r\n\r\n            return response.json() as Promise<T>;\r\n        } catch (e: any) {\r\n            if (e instanceof LetsPingError) throw e;\r\n            // Fetch/Network errors\r\n            throw new LetsPingError(`Network Error: ${e.message}`);\r\n        }\r\n    }\r\n    tool(service: string, action: string, priority: Priority = \"medium\"): (context: string | Record<string, any>) => Promise<string> {\r\n        return async (context: string | Record<string, any>): Promise<string> => {\r\n            let payload: Record<string, any>;\r\n            try {\r\n                if (typeof context === 'string') {\r\n                    try {\r\n                        payload = JSON.parse(context);\r\n                    } catch {\r\n                        payload = { raw_context: context };\r\n                    }\r\n                } else if (typeof context === 'object' && context !== null) {\r\n                    payload = context;\r\n                } else {\r\n                    // Handle numbers, booleans, undefined, etc.\r\n                    payload = { raw_context: String(context) };\r\n                }\r\n\r\n                const result = await this.ask({\r\n                    service,\r\n                    action,\r\n                    payload,\r\n                    priority\r\n                });\r\n\r\n                if (result.status === \"REJECTED\") {\r\n                    return `STOP: Action Rejected by Human.`;\r\n                }\r\n\r\n                const finalPayload = result.patched_payload || result.payload;\r\n                return JSON.stringify(finalPayload);\r\n            } catch (e: any) {\r\n                return `ERROR: System Failure: ${e.message}`;\r\n            }\r\n        };\r\n    }\r\n}"],"mappings":"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","names":[]}
+{"version":3,"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@letsping/sdk\",\n  \"version\": \"0.1.3\",\n  \"description\": \"The Human-in-the-Loop SDK for Autonomous Agents\",\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.mjs\",\n  \"files\": [\n    \"dist\"\n  ],\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"require\": \"./dist/index.js\",\n      \"import\": \"./dist/index.mjs\"\n    }\n  },\n  \"scripts\": {\n    \"build\": \"tsup && tsc --emitDeclarationOnly --outDir dist\",\n    \"dev\": \"tsup --watch\",\n    \"clean\": \"rm -rf dist .turbo\"\n  },\n  \"dependencies\": {},\n  \"devDependencies\": {\n    \"tsup\": \"^8.0.0\",\n    \"typescript\": \"^5.7.2\",\n    \"@types/node\": \"^22.0.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  }\n}","import { createCipheriv, createDecipheriv, randomBytes } from \"node:crypto\";\r\n\nlet SDK_VERSION = \"0.1.2\";\r\ntry {\r\n    \n    SDK_VERSION = require(\"../package.json\").version;\r\n} catch {  }\r\n\r\nexport type Priority = \"low\" | \"medium\" | \"high\" | \"critical\";\r\n\nexport interface RequestOptions {\r\n    \r\n    service: string;\r\n    \r\n    action: string;\r\n    \r\n    payload: Record<string, any>;\r\n    \r\n    priority?: Priority;\r\n    \r\n    schema?: Record<string, any>;\r\n    \r\n    timeoutMs?: number;\r\n    \r\n    role?: string;\r\n}\r\n\nexport interface Decision {\r\n    status: \"APPROVED\" | \"REJECTED\" | \"APPROVED_WITH_MODIFICATIONS\";\r\n    \r\n    payload: any;\r\n    \r\n    patched_payload?: any;\r\n    \r\n    diff_summary?: any;\r\n    metadata?: {\r\n        resolved_at: string;\r\n        actor_id: string;\r\n        method?: string;\r\n    };\r\n}\r\n\r\nexport class LetsPingError extends Error {\r\n    constructor(message: string, public status?: number) {\r\n        super(message);\r\n        this.name = \"LetsPingError\";\r\n    }\r\n}\r\n\ninterface EncEnvelope {\r\n    _lp_enc: true;\r\n    iv: string;  \n    ct: string;  \n}\r\n\r\nfunction isEncEnvelope(v: unknown): v is EncEnvelope {\r\n    return (\r\n        typeof v === \"object\" && v !== null &&\r\n        (v as any)._lp_enc === true &&\r\n        typeof (v as any).iv === \"string\" &&\r\n        typeof (v as any).ct === \"string\"\r\n    );\r\n}\r\n\r\nfunction encryptPayload(keyBase64: string, payload: Record<string, any>): EncEnvelope {\r\n    const keyBuf = Buffer.from(keyBase64, \"base64\");\r\n    const iv = randomBytes(12);\r\n    const cipher = createCipheriv(\"aes-256-gcm\", keyBuf, iv);\r\n    const plain = Buffer.from(JSON.stringify(payload), \"utf8\");\r\n    const ct = Buffer.concat([cipher.update(plain), cipher.final(), cipher.getAuthTag()]);\r\n    return {\r\n        _lp_enc: true,\r\n        iv: iv.toString(\"base64\"),\r\n        ct: ct.toString(\"base64\"),\r\n    };\r\n}\r\n\r\nfunction decryptPayload(keyBase64: string, envelope: EncEnvelope): Record<string, any> {\r\n    const keyBuf = Buffer.from(keyBase64, \"base64\");\r\n    const iv = Buffer.from(envelope.iv, \"base64\");\r\n    const ctFull = Buffer.from(envelope.ct, \"base64\");\r\n    \n    const authTag = ctFull.subarray(ctFull.length - 16);\r\n    const ct = ctFull.subarray(0, ctFull.length - 16);\r\n    const decipher = createDecipheriv(\"aes-256-gcm\", keyBuf, iv);\r\n    decipher.setAuthTag(authTag);\r\n    const plain = Buffer.concat([decipher.update(ct), decipher.final()]);\r\n    return JSON.parse(plain.toString(\"utf8\"));\r\n}\r\n\r\nfunction computeDiff(original: any, patched: any): any {\r\n    if (original === patched) return null;\r\n\r\n    if (\r\n        typeof original !== \"object\" ||\r\n        typeof patched !== \"object\" ||\r\n        original === null ||\r\n        patched === null ||\r\n        Array.isArray(original) ||\r\n        Array.isArray(patched)\r\n    ) {\r\n        if (JSON.stringify(original) !== JSON.stringify(patched)) {\r\n            return { from: original, to: patched };\r\n        }\r\n        return null;\r\n    }\r\n\r\n    const changes: Record<string, any> = {};\r\n    let hasChanges = false;\r\n    const allKeys = new Set([...Object.keys(original), ...Object.keys(patched)]);\r\n\r\n    for (const key of allKeys) {\r\n        const oV = original[key];\r\n        const pV = patched[key];\r\n\r\n        if (!(key in original)) {\r\n            changes[key] = { from: undefined, to: pV };\r\n            hasChanges = true;\r\n        } else if (!(key in patched)) {\r\n            changes[key] = { from: oV, to: undefined };\r\n            hasChanges = true;\r\n        } else {\r\n            const nestedDiff = computeDiff(oV, pV);\r\n            if (nestedDiff) {\r\n                changes[key] = nestedDiff;\r\n                hasChanges = true;\r\n            }\r\n        }\r\n    }\r\n\r\n    return hasChanges ? changes : null;\r\n}\r\n\nexport class LetsPing {\r\n    private readonly apiKey: string;\r\n    private readonly baseUrl: string;\r\n    private readonly encryptionKey: string | null;\r\n\n    constructor(apiKey?: string, options?: { baseUrl?: string; encryptionKey?: string }) {\r\n        const key = apiKey || process.env.LETSPING_API_KEY;\r\n        if (!key) throw new Error(\"LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.\");\r\n\r\n        this.apiKey = key;\r\n        this.baseUrl = options?.baseUrl || \"https://letsping.co/api\";\r\n        this.encryptionKey = options?.encryptionKey\r\n            ?? process.env.LETSPING_ENCRYPTION_KEY\r\n            ?? null;\r\n    }\r\n\r\n    private _encrypt(payload: Record<string, any>): Record<string, any> {\r\n        if (!this.encryptionKey) return payload;\r\n        return encryptPayload(this.encryptionKey, payload) as any;\r\n    }\r\n\r\n    private _decrypt(val: any): any {\r\n        if (!this.encryptionKey || !isEncEnvelope(val)) return val;\r\n        try {\r\n            return decryptPayload(this.encryptionKey, val);\r\n        } catch {\r\n            \n            return val;\r\n        }\r\n    }\r\n\n    async ask(options: RequestOptions): Promise<Decision> {\r\n        if (options.schema && (options.schema as any)._def) {\r\n            throw new LetsPingError(\"LetsPing Error: Raw Zod schema detected. You must convert it to JSON Schema (e.g. using 'zod-to-json-schema') before passing it to the SDK.\");\r\n        }\r\n\r\n        const { id } = await this.request<{ id: string }>(\"POST\", \"/ingest\", {\r\n            service: options.service,\r\n            action: options.action,\r\n            payload: this._encrypt(options.payload),\r\n            priority: options.priority || \"medium\",\r\n            schema: options.schema,\r\n            metadata: { role: options.role, sdk: \"node\" }\r\n        });\r\n\r\n        const timeout = options.timeoutMs || 24 * 60 * 60 * 1000;\r\n        const start = Date.now();\r\n        let delay = 1000;\r\n        const maxDelay = 10000;\r\n\r\n        while (Date.now() - start < timeout) {\r\n            try {\r\n                const check = await this.request<any>(\"GET\", `/status/${id}`);\r\n\r\n                if (check.status === \"APPROVED\" || check.status === \"REJECTED\") {\r\n                    const decryptedPayload = this._decrypt(check.payload) ?? options.payload;\r\n                    const decryptedPatched = check.patched_payload ? this._decrypt(check.patched_payload) : undefined;\r\n\r\n                    let diff_summary;\r\n                    let finalStatus = check.status;\r\n                    if (check.status === \"APPROVED\" && decryptedPatched !== undefined) {\r\n                        finalStatus = \"APPROVED_WITH_MODIFICATIONS\";\r\n                        const diff = computeDiff(decryptedPayload, decryptedPatched);\r\n                        diff_summary = diff ? { changes: diff } : { changes: \"Unknown structure changes\" };\r\n                    }\r\n\r\n                    return {\r\n                        status: finalStatus,\r\n                        payload: decryptedPayload,\r\n                        patched_payload: decryptedPatched,\r\n                        diff_summary,\r\n                        metadata: {\r\n                            resolved_at: check.resolved_at,\r\n                            actor_id: check.actor_id,\r\n                        }\r\n                    };\r\n                }\r\n            } catch (e: any) {\r\n                const s = e.status;\r\n                if (s && s >= 400 && s < 500 && s !== 404 && s !== 429) throw e;\r\n            }\r\n\r\n            const jitter = Math.random() * 200;\r\n            await new Promise(r => setTimeout(r, delay + jitter));\r\n            delay = Math.min(delay * 1.5, maxDelay);\r\n        }\r\n\r\n        throw new LetsPingError(`Request ${id} timed out waiting for approval.`);\r\n    }\r\n\r\n    async defer(options: RequestOptions): Promise<{ id: string }> {\r\n        return this.request<{ id: string }>(\"POST\", \"/ingest\", {\r\n            ...options,\r\n            payload: this._encrypt(options.payload),\r\n        });\r\n    }\r\n\r\n    private async request<T>(method: string, path: string, body?: any): Promise<T> {\r\n        const headers: Record<string, string> = {\r\n            \"Authorization\": `Bearer ${this.apiKey}`,\r\n            \"Content-Type\": \"application/json\",\r\n            \"User-Agent\": `letsping-node/${SDK_VERSION}`,\r\n        };\r\n\r\n        try {\r\n            const response = await fetch(`${this.baseUrl}${path}`, {\r\n                method,\r\n                headers,\r\n                body: body ? JSON.stringify(body) : undefined,\r\n            });\r\n\r\n            if (!response.ok) {\r\n                const errorText = await response.text();\r\n                let message = errorText;\r\n                try {\r\n                    const json = JSON.parse(errorText);\r\n                    if (json.message) message = json.message;\r\n                } catch { }\r\n                throw new LetsPingError(`API Error [${response.status}]: ${message}`, response.status);\r\n            }\r\n\r\n            return response.json() as Promise<T>;\r\n        } catch (e: any) {\r\n            if (e instanceof LetsPingError) throw e;\r\n            throw new LetsPingError(`Network Error: ${e.message}`);\r\n        }\r\n    }\r\n\r\n    tool(service: string, action: string, priority: Priority = \"medium\"): (context: string | Record<string, any>) => Promise<string> {\r\n        return async (context: string | Record<string, any>): Promise<string> => {\r\n            let payload: Record<string, any>;\r\n            try {\r\n                if (typeof context === \"string\") {\r\n                    try { payload = JSON.parse(context); }\r\n                    catch { payload = { raw_context: context }; }\r\n                } else if (typeof context === \"object\" && context !== null) {\r\n                    payload = context;\r\n                } else {\r\n                    payload = { raw_context: String(context) };\r\n                }\r\n\r\n                const result = await this.ask({ service, action, payload, priority });\r\n\r\n                if (result.status === \"REJECTED\") {\r\n                    return \"STOP: Action Rejected by Human.\";\r\n                }\r\n\r\n                if (result.status === \"APPROVED_WITH_MODIFICATIONS\") {\r\n                    return JSON.stringify({\r\n                        status: \"APPROVED_WITH_MODIFICATIONS\",\r\n                        message: \"The human reviewer authorized this action but modified your original payload. Please review the diff_summary to learn from this correction.\",\r\n                        diff_summary: result.diff_summary,\r\n                        original_payload: result.payload,\r\n                        executed_payload: result.patched_payload\r\n                    });\r\n                }\r\n\r\n                return JSON.stringify({\r\n                    status: \"APPROVED\",\r\n                    executed_payload: result.payload\r\n                });\r\n            } catch (e: any) {\r\n                return `ERROR: System Failure: ${e.message}`;\r\n            }\r\n        };\r\n    }\r\n}\r\n\r\nexport { computeDiff };"],"mappings":"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","names":[]}

package/package.json

@@ -1,29 +1,32 @@
-{
-    "name": "@letsping/sdk",
-    "version": "0.1.2",
-    "description": "The Human-in-the-Loop SDK for Autonomous Agents",
-    "main": "./dist/index.js",
-    "module": "./dist/index.mjs",
-    "types": "./dist/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "require": "./dist/index.js",
-            "import": "./dist/index.mjs"
-        }
-    },
-    "scripts": {
-        "build": "tsup",
-        "dev": "tsup --watch",
-        "clean": "rm -rf dist .turbo"
-    },
-    "dependencies": {},
-    "devDependencies": {
-        "tsup": "^8.0.0",
-        "typescript": "^5.7.2",
-        "@types/node": "^22.0.0"
-    },
-    "publishConfig": {
-        "access": "public"
-    }
+{
+  "name": "@letsping/sdk",
+  "version": "0.1.3",
+  "description": "The Human-in-the-Loop SDK for Autonomous Agents",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "files": [
+    "dist"
+  ],
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --outDir dist",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist .turbo"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2",
+    "@types/node": "^22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/src/index.d.ts

@@ -1,35 +0,0 @@
-export type Priority = "low" | "medium" | "high" | "critical";
-export interface RequestOptions {
-    service: string;
-    action: string;
-    payload: Record<string, any>;
-    priority?: Priority;
-    schema?: Record<string, any>;
-    timeoutMs?: number;
-}
-export interface Decision {
-    status: "APPROVED" | "REJECTED";
-    payload: any;
-    patched_payload?: any;
-    metadata?: {
-        resolved_at: string;
-        actor_id: string;
-        method?: string;
-    };
-}
-export declare class LetsPingError extends Error {
-    status?: number | undefined;
-    constructor(message: string, status?: number | undefined);
-}
-export declare class LetsPing {
-    private readonly apiKey;
-    private readonly baseUrl;
-    constructor(apiKey?: string, options?: {
-        baseUrl?: string;
-    });
-    ask(options: RequestOptions): Promise<Decision>;
-    defer(options: RequestOptions): Promise<{
-        id: string;
-    }>;
-    private request;
-}

package/src/index.ts

@@ -1,189 +0,0 @@
-export type Priority = "low" | "medium" | "high" | "critical";
-
-/**
- * Options for configuring a LetsPing approval request.
- */
-export interface RequestOptions {
-    /** Name of the agent or service (e.g., "billing-agent") */
-    service: string;
-    /** Specific action being requested (e.g., "refund_user") */
-    action: string;
-    /** The data payload to be reviewed by the human */
-    payload: Record<string, any>;
-    /** Urgency level affecting notification routing (default: "medium") */
-    priority?: Priority;
-    /** JSON Schema (Draft 7) for rendering a structured form in the dashboard */
-    schema?: Record<string, any>;
-    /** Maximum time to wait for approval in milliseconds (default: 24h) */
-    timeoutMs?: number;
-    /** (Enterprise) Specific role required for approval (e.g., "finance") */
-    role?: string;
-}
-
-/**
- * The result of a human approval decision.
- */
-export interface Decision {
-    status: "APPROVED" | "REJECTED";
-    /** The original payload submitted */
-    payload: any;
-    /** The modified payload if the human edited values during approval */
-    patched_payload?: any;
-    metadata?: {
-        resolved_at: string;
-        actor_id: string;
-        method?: string;
-    };
-}
-
-export class LetsPingError extends Error {
-    constructor(message: string, public status?: number) {
-        super(message);
-        this.name = "LetsPingError";
-    }
-}
-
-export class LetsPing {
-    private readonly apiKey: string;
-    private readonly baseUrl: string;
-
-    constructor(apiKey?: string, options?: { baseUrl?: string }) {
-        const key = apiKey || process.env.LETSPING_API_KEY;
-        if (!key) throw new Error("LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.");
-
-        this.apiKey = key;
-        this.baseUrl = options?.baseUrl || "https://letsping.co/api";
-    }
-
-    async ask(options: RequestOptions): Promise<Decision> {
-        if (options.schema && (options.schema as any)._def) {
-            throw new LetsPingError("LetsPing Error: Raw Zod schema detected. You must convert it to JSON Schema (e.g. using 'zod-to-json-schema') before passing it to the SDK.");
-        }
-
-        const { id } = await this.request<{ id: string }>("POST", "/ingest", {
-            service: options.service,
-            action: options.action,
-            payload: options.payload,
-            priority: options.priority || "medium",
-            schema: options.schema,
-            metadata: {
-                role: options.role,
-                sdk: "node"
-            }
-        });
-
-        const timeout = options.timeoutMs || 24 * 60 * 60 * 1000;
-        const start = Date.now();
-        let delay = 1000;
-        const maxDelay = 10000;
-
-        while (Date.now() - start < timeout) {
-            try {
-                const check = await this.request<any>("GET", `/status/${id}`);
-
-                if (check.status === "APPROVED" || check.status === "REJECTED") {
-                    return {
-                        status: check.status,
-                        payload: options.payload,
-                        patched_payload: check.patched_payload || options.payload,
-                        metadata: {
-                            resolved_at: check.resolved_at,
-                            actor_id: check.actor_id
-                        }
-                    };
-                }
-            } catch (e: any) {
-                // Retry on:
-                // 1. Network errors (status is undefined)
-                // 2. 404 (not found yet)
-                // 3. 429 (rate limit)
-                // 4. 5xx (server error)
-                // Fail on: 400, 401, 403 (client errors)
-                const status = e.status;
-                if (status && status >= 400 && status < 500 && status !== 404 && status !== 429) {
-                    throw e;
-                }
-            }
-
-            const jitter = Math.random() * 200;
-            await new Promise(r => setTimeout(r, delay + jitter));
-            delay = Math.min(delay * 1.5, maxDelay);
-        }
-
-        throw new LetsPingError(`Request ${id} timed out waiting for approval.`);
-    }
-
-    async defer(options: RequestOptions): Promise<{ id: string }> {
-        return this.request<{ id: string }>("POST", "/ingest", options);
-    }
-
-    private async request<T>(method: string, path: string, body?: any): Promise<T> {
-        // Shared headers
-        const headers: Record<string, string> = {
-            "Authorization": `Bearer ${this.apiKey}`,
-            "Content-Type": "application/json",
-            "User-Agent": "letsping-node/0.1.2"
-        };
-
-        try {
-            const response = await fetch(`${this.baseUrl}${path}`, {
-                method,
-                headers,
-                body: body ? JSON.stringify(body) : undefined,
-            });
-
-            if (!response.ok) {
-                const errorText = await response.text();
-                // Try parsing JSON error message
-                let message = errorText;
-                try {
-                    const json = JSON.parse(errorText);
-                    if (json.message) message = json.message;
-                } catch { }
-
-                throw new LetsPingError(`API Error [${response.status}]: ${message}`, response.status);
-            }
-
-            return response.json() as Promise<T>;
-        } catch (e: any) {
-            if (e instanceof LetsPingError) throw e;
-            // Fetch/Network errors
-            throw new LetsPingError(`Network Error: ${e.message}`);
-        }
-    }
-    tool(service: string, action: string, priority: Priority = "medium"): (context: string | Record<string, any>) => Promise<string> {
-        return async (context: string | Record<string, any>): Promise<string> => {
-            let payload: Record<string, any>;
-            try {
-                if (typeof context === 'string') {
-                    try {
-                        payload = JSON.parse(context);
-                    } catch {
-                        payload = { raw_context: context };
-                    }
-                } else if (typeof context === 'object' && context !== null) {
-                    payload = context;
-                } else {
-                    // Handle numbers, booleans, undefined, etc.
-                    payload = { raw_context: String(context) };
-                }
-
-                const result = await this.ask({
-                    service,
-                    action,
-                    payload,
-                    priority
-                });
-
-                if (result.status === "REJECTED") {
-                    return `STOP: Action Rejected by Human.`;
-                }
-
-                const finalPayload = result.patched_payload || result.payload;
-                return JSON.stringify(finalPayload);
-            } catch (e: any) {
-                return `ERROR: System Failure: ${e.message}`;
-            }
-        };
-    }
-}

package/tsc_error.log

@@ -1,213 +0,0 @@
-npm warn Unknown user config "email". This will stop working in the next major version of npm.
-../../node_modules/@types/node/globals.d.ts(95,18): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(95,27): error TS1005: ')' expected.
-../../node_modules/@types/node/globals.d.ts(96,18): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(96,27): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(97,31): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(97,35): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(97,43): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(98,22): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(99,27): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(100,29): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(100,38): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(100,97): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(100,107): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(101,33): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(102,38): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(102,46): error TS1228: A type predicate is only allowed in return type position for functions and methods.
-../../node_modules/@types/node/globals.d.ts(102,49): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(102,53): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(102,68): error TS1005: '(' expected.
-../../node_modules/@types/node/globals.d.ts(102,83): error TS1005: ')' expected.
-../../node_modules/@types/node/globals.d.ts(102,105): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(102,112): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(102,117): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(103,21): error TS1003: Identifier expected.
-../../node_modules/@types/node/globals.d.ts(103,22): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(104,38): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(109,20): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(110,18): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(111,18): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(112,9): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(116,14): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(116,23): error TS1005: ')' expected.
-../../node_modules/@types/node/globals.d.ts(117,14): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(117,23): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(118,19): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(118,23): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(118,49): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(119,28): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(119,32): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(119,40): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(120,22): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(121,22): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(123,27): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(124,30): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(124,39): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(124,154): error TS1109: Expression expected.
-../../node_modules/@types/node/globals.d.ts(126,36): error TS1005: ',' expected.
-../../node_modules/@types/node/globals.d.ts(127,38): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(127,47): error TS1005: ')' expected.
-../../node_modules/@types/node/globals.d.ts(128,42): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(128,51): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(129,54): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(129,58): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(129,66): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(130,46): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(132,51): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(133,53): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(133,62): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(133,103): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(133,112): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(133,126): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(134,57): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(135,65): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(135,70): error TS1435: Unknown keyword or identifier. Did you mean 'get'?
-../../node_modules/@types/node/globals.d.ts(135,76): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(135,86): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(135,90): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(135,94): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(135,99): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(135,102): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(135,112): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(135,114): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(135,124): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(135,138): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(135,143): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(136,29): error TS1003: Identifier expected.
-../../node_modules/@types/node/globals.d.ts(136,30): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(137,62): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(141,18): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(141,27): error TS1005: ')' expected.
-../../node_modules/@types/node/globals.d.ts(142,30): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(142,34): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(142,66): error TS1109: Expression expected.
-../../node_modules/@types/node/globals.d.ts(143,38): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(144,22): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(145,25): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(149,29): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(149,36): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(153,30): error TS1005: ',' expected.
-../../node_modules/@types/node/globals.d.ts(153,44): error TS1005: ',' expected.
-../../node_modules/@types/node/globals.d.ts(153,71): error TS1005: ',' expected.
-../../node_modules/@types/node/globals.d.ts(153,72): error TS1109: Expression expected.
-../../node_modules/@types/node/globals.d.ts(153,74): error TS1109: Expression expected.
-../../node_modules/@types/node/globals.d.ts(155,2): error TS1110: Type expected.
-../../node_modules/@types/node/globals.d.ts(156,6): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(157,17): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(157,18): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(161,14): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(161,23): error TS1005: ')' expected.
-../../node_modules/@types/node/globals.d.ts(162,18): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(162,27): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(163,21): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(163,30): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(163,69): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(163,78): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(164,25): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(164,68): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(164,73): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(164,98): error TS1005: ',' expected.
-../../node_modules/@types/node/globals.d.ts(164,112): error TS1351: An identifier or keyword cannot immediately follow a numeric literal.
-../../node_modules/@types/node/globals.d.ts(164,122): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(164,126): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(164,131): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(164,135): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(164,146): error TS1003: Identifier expected.
-../../node_modules/@types/node/globals.d.ts(164,147): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(165,26): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(167,31): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(168,34): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(168,43): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(170,37): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(170,42): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(171,17): error TS1005: ':' expected.
-../../node_modules/@types/node/globals.d.ts(173,21): error TS1005: ':' expected.
-../../node_modules/@types/node/globals.d.ts(174,10): error TS1109: Expression expected.
-../../node_modules/@types/node/globals.d.ts(175,10): error TS1110: Type expected.
-../../node_modules/@types/node/globals.d.ts(176,10): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(178,15): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(179,18): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(179,27): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(180,23): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(180,32): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(180,106): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(180,117): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(181,22): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(183,27): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(184,31): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(184,40): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(186,30): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(191,15): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(191,19): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(191,27): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(192,14): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(193,14): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(194,14): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(197,16): error TS1136: Property assignment expected.
-../../node_modules/@types/node/globals.d.ts(197,19): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(202,6): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(203,6): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(204,17): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(204,18): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(208,14): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(208,23): error TS1005: ')' expected.
-../../node_modules/@types/node/globals.d.ts(209,18): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(209,27): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(210,21): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(210,30): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(210,71): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(210,83): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(211,25): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(211,69): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(211,83): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(211,88): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(211,93): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(211,98): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(211,112): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(211,116): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(211,119): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(211,133): error TS1003: Identifier expected.
-../../node_modules/@types/node/globals.d.ts(211,134): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(212,26): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(214,31): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(216,33): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(220,20): error TS1005: ':' expected.
-../../node_modules/@types/node/globals.d.ts(222,17): error TS1136: Property assignment expected.
-../../node_modules/@types/node/globals.d.ts(222,21): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(226,6): error TS1109: Expression expected.
-../../node_modules/@types/node/globals.d.ts(227,6): error TS1110: Type expected.
-../../node_modules/@types/node/globals.d.ts(231,14): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(231,23): error TS1005: ')' expected.
-../../node_modules/@types/node/globals.d.ts(232,26): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(232,30): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(232,38): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(233,18): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(234,25): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(237,6): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(237,15): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(239,33): error TS1005: '>' expected.
-../../node_modules/@types/node/globals.d.ts(239,40): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(240,24): error TS1005: ',' expected.
-../../node_modules/@types/node/globals.d.ts(240,50): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(243,26): error TS1005: ',' expected.
-../../node_modules/@types/node/globals.d.ts(243,40): error TS1005: ',' expected.
-../../node_modules/@types/node/globals.d.ts(243,67): error TS1005: ',' expected.
-../../node_modules/@types/node/globals.d.ts(243,68): error TS1109: Expression expected.
-../../node_modules/@types/node/globals.d.ts(243,70): error TS1109: Expression expected.
-../../node_modules/@types/node/globals.d.ts(243,91): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(244,2): error TS1110: Type expected.
-../../node_modules/@types/node/globals.d.ts(247,12): error TS1136: Property assignment expected.
-../../node_modules/@types/node/globals.d.ts(247,15): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(247,33): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(250,10): error TS1005: ';' expected.
-../../node_modules/@types/node/globals.d.ts(250,13): error TS1434: Unexpected keyword or identifier.
-../../node_modules/@types/node/globals.d.ts(251,10): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(252,10): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(253,10): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(254,17): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(254,18): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(255,2): error TS1110: Type expected.
-../../node_modules/@types/node/globals.d.ts(256,6): error TS1161: Unterminated regular expression literal.
-../../node_modules/@types/node/globals.d.ts(257,5): error TS1128: Declaration or statement expected.
-../../node_modules/@types/node/globals.d.ts(258,1): error TS1128: Declaration or statement expected.

package/tsconfig.json

@@ -1,23 +0,0 @@
-{
-    "compilerOptions": {
-        "target": "ES2020",
-        "module": "ESNext",
-        "moduleResolution": "Bundler",
-        "strict": true,
-        "declaration": true,
-        "esModuleInterop": true,
-        "skipLibCheck": true,
-        "forceConsistentCasingInFileNames": true,
-        "baseUrl": ".",
-        "lib": [
-            "ES2020",
-            "DOM"
-        ],
-        "types": [
-            "node"
-        ]
-    },
-    "include": [
-        "src"
-    ]
-}

package/tsup.config.ts

@@ -1,10 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-    entry: ["src/index.ts"],
-    format: ["cjs", "esm"],
-    dts: true,
-    clean: true,
-    sourcemap: true,
-    splitting: false,
-});