@letsping/sdk 0.1.3 → 0.1.6

package/src/integrations/langgraph.ts

@@ -0,0 +1,65 @@
+import { BaseCheckpointSaver, Checkpoint, CheckpointMetadata, CheckpointTuple } from "@langchain/langgraph";
+import { RunnableConfig } from "@langchain/core/runnables";
+import { LetsPing } from "../index";
+
+export class LetsPingCheckpointer extends BaseCheckpointSaver {
+    private checkpoints: Record<string, [Checkpoint, CheckpointMetadata]> = {};
+
+    constructor(public client: LetsPing) {
+        super();
+    }
+
+    async put(
+        config: RunnableConfig,
+        checkpoint: Checkpoint,
+        metadata: CheckpointMetadata,
+        newVersions?: Record<string, string | number>
+    ): Promise<RunnableConfig> {
+        const threadId = config.configurable?.thread_id;
+        const checkpointId = checkpoint.id;
+
+        this.checkpoints[`${threadId}:${checkpointId}`] = [checkpoint, metadata];
+
+        return {
+            configurable: {
+                thread_id: threadId,
+                checkpoint_id: checkpointId,
+            }
+        };
+    }
+
+    // --- NEW METHODS REQUIRED BY LANGGRAPH V0.1+ ---
+    async putWrites(config: RunnableConfig, writes: any, taskId: string): Promise<void> {
+        // No-op for V1: LetsPing focuses on primary state parking, not granular sub-task writes.
+    }
+
+    async deleteThread(threadId: string): Promise<void> {
+        for (const key of Object.keys(this.checkpoints)) {
+            if (key.startsWith(`${threadId}:`)) {
+                delete this.checkpoints[key];
+            }
+        }
+    }
+
+    async getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined> {
+        const threadId = config.configurable?.thread_id;
+        const checkpointId = config.configurable?.checkpoint_id;
+
+        if (checkpointId) {
+            const match = this.checkpoints[`${threadId}:${checkpointId}`];
+            if (match) return { config, checkpoint: match[0], metadata: match[1] };
+        }
+
+        let latest: CheckpointTuple | undefined;
+        for (const [key, val] of Object.entries(this.checkpoints)) {
+            if (key.startsWith(`${threadId}:`)) {
+                latest = { config, checkpoint: val[0], metadata: val[1] };
+            }
+        }
+        return latest;
+    }
+
+    async *list(config: RunnableConfig, options?: any): AsyncGenerator<CheckpointTuple> {
+        yield* [];
+    }
+}

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+    "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

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

package/dist/index.d.ts

@@ -1,44 +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;
-    role?: string;
-}
-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;
-    };
-}
-export declare class LetsPingError extends Error {
-    status?: number | undefined;
-    constructor(message: string, status?: number | undefined);
-}
-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 { computeDiff };

package/dist/index.js

@@ -1,286 +0,0 @@
-"use strict";
-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 });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-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,
-  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);
-    this.status = status;
-    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) {
-      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("POST", "/ingest", {
-      service: options.service,
-      action: options.action,
-      payload: this._encrypt(options.payload),
-      priority: options.priority || "medium",
-      schema: options.schema,
-      metadata: { role: options.role, sdk: "node" }
-    });
-    const timeout = options.timeoutMs || 24 * 60 * 60 * 1e3;
-    const start = Date.now();
-    let delay = 1e3;
-    const maxDelay = 1e4;
-    while (Date.now() - start < timeout) {
-      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: finalStatus,
-            payload: decryptedPayload,
-            patched_payload: decryptedPatched,
-            diff_summary,
-            metadata: {
-              resolved_at: check.resolved_at,
-              actor_id: check.actor_id
-            }
-          };
-        }
-      } catch (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));
-      delay = Math.min(delay * 1.5, maxDelay);
-    }
-    throw new LetsPingError(`Request ${id} timed out waiting for approval.`);
-  }
-  async defer(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/${SDK_VERSION}`
-    };
-    try {
-      const response = await fetch(`${this.baseUrl}${path}`, {
-        method,
-        headers,
-        body: body ? JSON.stringify(body) : void 0
-      });
-      if (!response.ok) {
-        const errorText = await response.text();
-        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();
-    } catch (e) {
-      if (e instanceof LetsPingError) throw e;
-      throw new LetsPingError(`Network Error: ${e.message}`);
-    }
-  }
-  tool(service, action, priority = "medium") {
-    return async (context) => {
-      let payload;
-      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 {
-          payload = { raw_context: String(context) };
-        }
-        const result = await this.ask({ service, action, payload, priority });
-        if (result.status === "REJECTED") {
-          return "STOP: Action Rejected by Human.";
-        }
-        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}`;
-      }
-    };
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  LetsPing,
-  LetsPingError,
-  computeDiff
-});
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"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"]}