@letsping/sdk 0.1.1 → 0.1.3

package/dist/index.d.mts

@@ -0,0 +1,37 @@
+type Priority = "low" | "medium" | "high" | "critical";
+interface RequestOptions {
+    service: string;
+    action: string;
+    payload: Record<string, any>;
+    priority?: Priority;
+    schema?: Record<string, any>;
+    timeoutMs?: number;
+}
+interface Decision {
+    status: "APPROVED" | "REJECTED";
+    payload: any;
+    patched_payload?: any;
+    metadata?: {
+        resolved_at: string;
+        actor_id: string;
+        method?: string;
+    };
+}
+declare class LetsPingError extends Error {
+    status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+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;
+}
+
+export { type Decision, LetsPing, LetsPingError, type Priority, type RequestOptions };

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+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

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

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

@@ -0,0 +1,261 @@
+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);
+    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 = 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) {
+      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}`;
+      }
+    };
+  }
+};
+export {
+  LetsPing,
+  LetsPingError,
+  computeDiff
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"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.1",
-    "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.0.0",
-        "@types/node": "^20.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.ts

@@ -1,122 +0,0 @@
-export type Priority = "low" | "medium" | "high" | "critical";
-
-export interface RequestOptions {
-    service: string;
-    action: string;
-    payload: Record<string, any>;
-    priority?: Priority;
-    /**
-     * JSON Schema object defining the structure of the payload for the Human UI.
-     * Note: If using Zod, use `zod-to-json-schema` before passing it here.
-     */
-    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 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> {
-        // Warn if a raw Zod object is passed, as it serializes to {}
-        if (options.schema && (options.schema as any)._def) {
-            console.warn("\x1b[33m%s\x1b[0m", "⚠️ LetsPing Warning: It looks like you passed a raw Zod object to 'schema'. This will result in an empty form. Please convert it to JSON Schema first (e.g. using 'zod-to-json-schema').");
-        }
-
-        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
-        });
-
-        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) {
-                // Ignore 404 (pending) and 429 (rate limit), throw everything else
-                if (e.status !== 404 && e.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> {
-        const headers: Record<string, string> = {
-            "Authorization": `Bearer ${this.apiKey}`,
-            "Content-Type": "application/json",
-            "User-Agent": "letsping-node/0.1.0"
-        };
-
-        try {
-            const response = await fetch(`${this.baseUrl}${path}`, {
-                method,
-                headers,
-                body: body ? JSON.stringify(body) : undefined,
-            });
-
-            if (!response.ok) {
-                const errorText = await response.text();
-                throw new LetsPingError(`LetsPing API Error [${response.status}]: ${errorText}`, response.status);
-            }
-
-            return response.json() as Promise<T>;
-        } catch (e: any) {
-            if (e instanceof LetsPingError) throw e;
-            throw new LetsPingError(`Network Error: ${e.message}`);
-        }
-    }
-}

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-    "compilerOptions": {
-        "target": "ES2020",
-        "module": "ESNext",
-        "moduleResolution": "Bundler",
-        "strict": true,
-        "declaration": true,
-        "esModuleInterop": true,
-        "skipLibCheck": true,
-        "forceConsistentCasingInFileNames": true,
-        "baseUrl": "."
-    },
-    "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,
-});