@letsping/sdk 0.2.0 → 0.3.0

package/dist/integrations/langgraph.js

@@ -1,150 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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);
-
-// src/integrations/langgraph.ts
-var langgraph_exports = {};
-__export(langgraph_exports, {
-  LetsPingCheckpointer: () => LetsPingCheckpointer
-});
-module.exports = __toCommonJS(langgraph_exports);
-var import_langgraph = require("@langchain/langgraph");
-var LetsPingCheckpointer = class extends import_langgraph.BaseCheckpointSaver {
-  constructor(client) {
-    super();
-    this.client = client;
-    this.checkpoints = {};
-  }
-  getTransport() {
-    const clientAny = this.client;
-    if (typeof clientAny.request === "function") {
-      return clientAny.request.bind(this.client);
-    }
-    return null;
-  }
-  async saveRemote(threadId, checkpointId, checkpoint, metadata) {
-    const transport = this.getTransport();
-    if (!transport) {
-      console.warn("[LetsPingCheckpointer] Missing underlying transport; falling back to in-memory only.");
-      return;
-    }
-    try {
-      await transport("POST", "/langgraph/checkpoints", {
-        thread_id: threadId,
-        checkpoint_id: checkpointId,
-        checkpoint,
-        metadata
-      });
-    } catch (e) {
-      console.warn("[LetsPingCheckpointer] Failed to persist checkpoint remotely; falling back to in-memory only.", e);
-    }
-  }
-  async loadRemote(threadId, checkpointId) {
-    const transport = this.getTransport();
-    if (!transport) {
-      console.warn("[LetsPingCheckpointer] Missing underlying transport; using in-memory checkpoints only.");
-      return null;
-    }
-    const search = checkpointId ? `?thread_id=${encodeURIComponent(threadId)}&checkpoint_id=${encodeURIComponent(checkpointId)}` : `?thread_id=${encodeURIComponent(threadId)}&latest=1`;
-    try {
-      const res = await transport("GET", `/langgraph/checkpoints${search}`);
-      if (res && res.checkpoint && res.metadata) {
-        return { checkpoint: res.checkpoint, metadata: res.metadata };
-      }
-    } catch (e) {
-      console.warn("[LetsPingCheckpointer] Failed to load remote checkpoint", e);
-    }
-    return null;
-  }
-  async deleteRemote(threadId) {
-    const transport = this.getTransport();
-    if (!transport) return;
-    const search = `?thread_id=${encodeURIComponent(threadId)}`;
-    try {
-      await transport("DELETE", `/langgraph/checkpoints${search}`);
-    } catch (e) {
-      console.warn("[LetsPingCheckpointer] Failed to delete remote checkpoints", e);
-    }
-  }
-  async put(config, checkpoint, metadata, newVersions) {
-    const threadId = config.configurable?.thread_id;
-    const checkpointId = checkpoint.id;
-    if (!threadId || !checkpointId) {
-      return config;
-    }
-    this.checkpoints[`${threadId}:${checkpointId}`] = { checkpoint, metadata };
-    await this.saveRemote(threadId, checkpointId, checkpoint, metadata);
-    return {
-      configurable: {
-        thread_id: threadId,
-        checkpoint_id: checkpointId
-      }
-    };
-  }
-  // METHODS REQUIRED BY LANGGRAPH V0.1+
-  async putWrites(config, writes, taskId) {
-  }
-  async deleteThread(threadId) {
-    for (const key of Object.keys(this.checkpoints)) {
-      if (key.startsWith(`${threadId}:`)) {
-        delete this.checkpoints[key];
-      }
-    }
-    await this.deleteRemote(threadId);
-  }
-  async getTuple(config) {
-    const threadId = config.configurable?.thread_id;
-    const checkpointId = config.configurable?.checkpoint_id;
-    if (!threadId) return void 0;
-    const remote = await this.loadRemote(threadId, checkpointId);
-    if (remote) {
-      return { config, checkpoint: remote.checkpoint, metadata: remote.metadata };
-    }
-    if (checkpointId) {
-      const match = this.checkpoints[`${threadId}:${checkpointId}`];
-      if (match) {
-        return { config, checkpoint: match.checkpoint, metadata: match.metadata };
-      }
-    }
-    let latest;
-    for (const [key, val] of Object.entries(this.checkpoints)) {
-      if (key.startsWith(`${threadId}:`)) {
-        latest = { config, checkpoint: val.checkpoint, metadata: val.metadata };
-      }
-    }
-    return latest;
-  }
-  async *list(config, options) {
-    const threadId = config.configurable?.thread_id;
-    if (!threadId) return;
-    const remoteLatest = await this.loadRemote(threadId);
-    if (remoteLatest) {
-      yield { config, checkpoint: remoteLatest.checkpoint, metadata: remoteLatest.metadata };
-    }
-    for (const [key, val] of Object.entries(this.checkpoints)) {
-      if (key.startsWith(`${threadId}:`)) {
-        yield { config, checkpoint: val.checkpoint, metadata: val.metadata };
-      }
-    }
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  LetsPingCheckpointer
-});
-//# sourceMappingURL=langgraph.js.map

package/dist/integrations/langgraph.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/integrations/langgraph.ts"],"sourcesContent":["import { BaseCheckpointSaver, Checkpoint, CheckpointMetadata, CheckpointTuple } from \"@langchain/langgraph\";\r\nimport { RunnableConfig } from \"@langchain/core/runnables\";\r\nimport { LetsPing } from \"../index\";\r\n\r\ntype StoredCheckpoint = {\r\n    checkpoint: Checkpoint;\r\n    metadata: CheckpointMetadata;\r\n};\r\n\r\nexport class LetsPingCheckpointer extends BaseCheckpointSaver {\r\n    private checkpoints: Record<string, StoredCheckpoint> = {};\r\n\r\n    constructor(public client: LetsPing) {\r\n        super();\r\n    }\r\n\r\n    private getTransport(): (<T = any>(method: string, path: string, body?: any) => Promise<T>) | null {\r\n        const clientAny = this.client as any;\r\n        if (typeof clientAny.request === \"function\") {\r\n            return clientAny.request.bind(this.client);\r\n        }\r\n        return null;\r\n    }\r\n\r\n    private async saveRemote(\r\n        threadId: string,\r\n        checkpointId: string,\r\n        checkpoint: Checkpoint,\r\n        metadata: CheckpointMetadata\r\n    ): Promise<void> {\r\n        const transport = this.getTransport();\r\n        if (!transport) {\r\n            console.warn(\"[LetsPingCheckpointer] Missing underlying transport; falling back to in-memory only.\");\r\n            return;\r\n        }\r\n        try {\r\n            await transport(\"POST\", \"/langgraph/checkpoints\", {\r\n                thread_id: threadId,\r\n                checkpoint_id: checkpointId,\r\n                checkpoint,\r\n                metadata,\r\n            });\r\n        } catch (e) {\r\n            console.warn(\"[LetsPingCheckpointer] Failed to persist checkpoint remotely; falling back to in-memory only.\", e);\r\n        }\r\n    }\r\n\r\n    private async loadRemote(\r\n        threadId: string,\r\n        checkpointId?: string\r\n    ): Promise<StoredCheckpoint | null> {\r\n        const transport = this.getTransport();\r\n        if (!transport) {\r\n            console.warn(\"[LetsPingCheckpointer] Missing underlying transport; using in-memory checkpoints only.\");\r\n            return null;\r\n        }\r\n        const search = checkpointId\r\n            ? `?thread_id=${encodeURIComponent(threadId)}&checkpoint_id=${encodeURIComponent(checkpointId)}`\r\n            : `?thread_id=${encodeURIComponent(threadId)}&latest=1`;\r\n        try {\r\n            const res = await transport<any>(\"GET\", `/langgraph/checkpoints${search}`);\r\n            if (res && res.checkpoint && res.metadata) {\r\n                return { checkpoint: res.checkpoint as Checkpoint, metadata: res.metadata as CheckpointMetadata };\r\n            }\r\n        } catch (e) {\r\n            // If not found or backend unavailable, fall back to local cache only.\r\n            console.warn(\"[LetsPingCheckpointer] Failed to load remote checkpoint\", e);\r\n        }\r\n        return null;\r\n    }\r\n\r\n    private async deleteRemote(threadId: string): Promise<void> {\r\n        const transport = this.getTransport();\r\n        if (!transport) return;\r\n        const search = `?thread_id=${encodeURIComponent(threadId)}`;\r\n        try {\r\n            await transport(\"DELETE\", `/langgraph/checkpoints${search}`);\r\n        } catch (e) {\r\n            console.warn(\"[LetsPingCheckpointer] Failed to delete remote checkpoints\", e);\r\n        }\r\n    }\r\n\r\n    async put(\r\n        config: RunnableConfig,\r\n        checkpoint: Checkpoint,\r\n        metadata: CheckpointMetadata,\r\n        newVersions?: Record<string, string | number>\r\n    ): Promise<RunnableConfig> {\r\n        const threadId = config.configurable?.thread_id;\r\n        const checkpointId = checkpoint.id;\r\n\r\n        if (!threadId || !checkpointId) {\r\n            return config;\r\n        }\r\n\r\n        this.checkpoints[`${threadId}:${checkpointId}`] = { checkpoint, metadata };\r\n        await this.saveRemote(threadId, checkpointId, checkpoint, metadata);\r\n\r\n        return {\r\n            configurable: {\r\n                thread_id: threadId,\r\n                checkpoint_id: checkpointId,\r\n            },\r\n        };\r\n    }\r\n\r\n    // METHODS REQUIRED BY LANGGRAPH V0.1+\r\n    async putWrites(config: RunnableConfig, writes: any, taskId: string): Promise<void> {\r\n        // No-op for V1: LetsPing focuses on primary state parking, not granular sub-task writes.\r\n    }\r\n\r\n    async deleteThread(threadId: string): Promise<void> {\r\n        for (const key of Object.keys(this.checkpoints)) {\r\n            if (key.startsWith(`${threadId}:`)) {\r\n                delete this.checkpoints[key];\r\n            }\r\n        }\r\n        await this.deleteRemote(threadId);\r\n    }\r\n\r\n    async getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined> {\r\n        const threadId = config.configurable?.thread_id;\r\n        const checkpointId = config.configurable?.checkpoint_id;\r\n        if (!threadId) return undefined;\r\n\r\n        // Prefer remote truth, fall back to local cache.\r\n        const remote = await this.loadRemote(threadId, checkpointId);\r\n        if (remote) {\r\n            return { config, checkpoint: remote.checkpoint, metadata: remote.metadata };\r\n        }\r\n\r\n        if (checkpointId) {\r\n            const match = this.checkpoints[`${threadId}:${checkpointId}`];\r\n            if (match) {\r\n                return { config, checkpoint: match.checkpoint, metadata: match.metadata };\r\n            }\r\n        }\r\n\r\n        let latest: CheckpointTuple | undefined;\r\n        for (const [key, val] of Object.entries(this.checkpoints)) {\r\n            if (key.startsWith(`${threadId}:`)) {\r\n                latest = { config, checkpoint: val.checkpoint, metadata: val.metadata };\r\n            }\r\n        }\r\n        return latest;\r\n    }\r\n\r\n    async *list(config: RunnableConfig, options?: any): AsyncGenerator<CheckpointTuple> {\r\n        const threadId = config.configurable?.thread_id;\r\n        if (!threadId) return;\r\n\r\n        const remoteLatest = await this.loadRemote(threadId);\r\n        if (remoteLatest) {\r\n            yield { config, checkpoint: remoteLatest.checkpoint, metadata: remoteLatest.metadata };\r\n        }\r\n\r\n        for (const [key, val] of Object.entries(this.checkpoints)) {\r\n            if (key.startsWith(`${threadId}:`)) {\r\n                yield { config, checkpoint: val.checkpoint, metadata: val.metadata };\r\n            }\r\n        }\r\n    }\r\n}"],"mappings":"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","names":[]}

package/dist/integrations/langgraph.mjs

@@ -1,125 +0,0 @@
-// src/integrations/langgraph.ts
-import { BaseCheckpointSaver } from "@langchain/langgraph";
-var LetsPingCheckpointer = class extends BaseCheckpointSaver {
-  constructor(client) {
-    super();
-    this.client = client;
-    this.checkpoints = {};
-  }
-  getTransport() {
-    const clientAny = this.client;
-    if (typeof clientAny.request === "function") {
-      return clientAny.request.bind(this.client);
-    }
-    return null;
-  }
-  async saveRemote(threadId, checkpointId, checkpoint, metadata) {
-    const transport = this.getTransport();
-    if (!transport) {
-      console.warn("[LetsPingCheckpointer] Missing underlying transport; falling back to in-memory only.");
-      return;
-    }
-    try {
-      await transport("POST", "/langgraph/checkpoints", {
-        thread_id: threadId,
-        checkpoint_id: checkpointId,
-        checkpoint,
-        metadata
-      });
-    } catch (e) {
-      console.warn("[LetsPingCheckpointer] Failed to persist checkpoint remotely; falling back to in-memory only.", e);
-    }
-  }
-  async loadRemote(threadId, checkpointId) {
-    const transport = this.getTransport();
-    if (!transport) {
-      console.warn("[LetsPingCheckpointer] Missing underlying transport; using in-memory checkpoints only.");
-      return null;
-    }
-    const search = checkpointId ? `?thread_id=${encodeURIComponent(threadId)}&checkpoint_id=${encodeURIComponent(checkpointId)}` : `?thread_id=${encodeURIComponent(threadId)}&latest=1`;
-    try {
-      const res = await transport("GET", `/langgraph/checkpoints${search}`);
-      if (res && res.checkpoint && res.metadata) {
-        return { checkpoint: res.checkpoint, metadata: res.metadata };
-      }
-    } catch (e) {
-      console.warn("[LetsPingCheckpointer] Failed to load remote checkpoint", e);
-    }
-    return null;
-  }
-  async deleteRemote(threadId) {
-    const transport = this.getTransport();
-    if (!transport) return;
-    const search = `?thread_id=${encodeURIComponent(threadId)}`;
-    try {
-      await transport("DELETE", `/langgraph/checkpoints${search}`);
-    } catch (e) {
-      console.warn("[LetsPingCheckpointer] Failed to delete remote checkpoints", e);
-    }
-  }
-  async put(config, checkpoint, metadata, newVersions) {
-    const threadId = config.configurable?.thread_id;
-    const checkpointId = checkpoint.id;
-    if (!threadId || !checkpointId) {
-      return config;
-    }
-    this.checkpoints[`${threadId}:${checkpointId}`] = { checkpoint, metadata };
-    await this.saveRemote(threadId, checkpointId, checkpoint, metadata);
-    return {
-      configurable: {
-        thread_id: threadId,
-        checkpoint_id: checkpointId
-      }
-    };
-  }
-  // METHODS REQUIRED BY LANGGRAPH V0.1+
-  async putWrites(config, writes, taskId) {
-  }
-  async deleteThread(threadId) {
-    for (const key of Object.keys(this.checkpoints)) {
-      if (key.startsWith(`${threadId}:`)) {
-        delete this.checkpoints[key];
-      }
-    }
-    await this.deleteRemote(threadId);
-  }
-  async getTuple(config) {
-    const threadId = config.configurable?.thread_id;
-    const checkpointId = config.configurable?.checkpoint_id;
-    if (!threadId) return void 0;
-    const remote = await this.loadRemote(threadId, checkpointId);
-    if (remote) {
-      return { config, checkpoint: remote.checkpoint, metadata: remote.metadata };
-    }
-    if (checkpointId) {
-      const match = this.checkpoints[`${threadId}:${checkpointId}`];
-      if (match) {
-        return { config, checkpoint: match.checkpoint, metadata: match.metadata };
-      }
-    }
-    let latest;
-    for (const [key, val] of Object.entries(this.checkpoints)) {
-      if (key.startsWith(`${threadId}:`)) {
-        latest = { config, checkpoint: val.checkpoint, metadata: val.metadata };
-      }
-    }
-    return latest;
-  }
-  async *list(config, options) {
-    const threadId = config.configurable?.thread_id;
-    if (!threadId) return;
-    const remoteLatest = await this.loadRemote(threadId);
-    if (remoteLatest) {
-      yield { config, checkpoint: remoteLatest.checkpoint, metadata: remoteLatest.metadata };
-    }
-    for (const [key, val] of Object.entries(this.checkpoints)) {
-      if (key.startsWith(`${threadId}:`)) {
-        yield { config, checkpoint: val.checkpoint, metadata: val.metadata };
-      }
-    }
-  }
-};
-export {
-  LetsPingCheckpointer
-};
-//# sourceMappingURL=langgraph.mjs.map

package/dist/integrations/langgraph.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/integrations/langgraph.ts"],"sourcesContent":["import { BaseCheckpointSaver, Checkpoint, CheckpointMetadata, CheckpointTuple } from \"@langchain/langgraph\";\r\nimport { RunnableConfig } from \"@langchain/core/runnables\";\r\nimport { LetsPing } from \"../index\";\r\n\r\ntype StoredCheckpoint = {\r\n    checkpoint: Checkpoint;\r\n    metadata: CheckpointMetadata;\r\n};\r\n\r\nexport class LetsPingCheckpointer extends BaseCheckpointSaver {\r\n    private checkpoints: Record<string, StoredCheckpoint> = {};\r\n\r\n    constructor(public client: LetsPing) {\r\n        super();\r\n    }\r\n\r\n    private getTransport(): (<T = any>(method: string, path: string, body?: any) => Promise<T>) | null {\r\n        const clientAny = this.client as any;\r\n        if (typeof clientAny.request === \"function\") {\r\n            return clientAny.request.bind(this.client);\r\n        }\r\n        return null;\r\n    }\r\n\r\n    private async saveRemote(\r\n        threadId: string,\r\n        checkpointId: string,\r\n        checkpoint: Checkpoint,\r\n        metadata: CheckpointMetadata\r\n    ): Promise<void> {\r\n        const transport = this.getTransport();\r\n        if (!transport) {\r\n            console.warn(\"[LetsPingCheckpointer] Missing underlying transport; falling back to in-memory only.\");\r\n            return;\r\n        }\r\n        try {\r\n            await transport(\"POST\", \"/langgraph/checkpoints\", {\r\n                thread_id: threadId,\r\n                checkpoint_id: checkpointId,\r\n                checkpoint,\r\n                metadata,\r\n            });\r\n        } catch (e) {\r\n            console.warn(\"[LetsPingCheckpointer] Failed to persist checkpoint remotely; falling back to in-memory only.\", e);\r\n        }\r\n    }\r\n\r\n    private async loadRemote(\r\n        threadId: string,\r\n        checkpointId?: string\r\n    ): Promise<StoredCheckpoint | null> {\r\n        const transport = this.getTransport();\r\n        if (!transport) {\r\n            console.warn(\"[LetsPingCheckpointer] Missing underlying transport; using in-memory checkpoints only.\");\r\n            return null;\r\n        }\r\n        const search = checkpointId\r\n            ? `?thread_id=${encodeURIComponent(threadId)}&checkpoint_id=${encodeURIComponent(checkpointId)}`\r\n            : `?thread_id=${encodeURIComponent(threadId)}&latest=1`;\r\n        try {\r\n            const res = await transport<any>(\"GET\", `/langgraph/checkpoints${search}`);\r\n            if (res && res.checkpoint && res.metadata) {\r\n                return { checkpoint: res.checkpoint as Checkpoint, metadata: res.metadata as CheckpointMetadata };\r\n            }\r\n        } catch (e) {\r\n            // If not found or backend unavailable, fall back to local cache only.\r\n            console.warn(\"[LetsPingCheckpointer] Failed to load remote checkpoint\", e);\r\n        }\r\n        return null;\r\n    }\r\n\r\n    private async deleteRemote(threadId: string): Promise<void> {\r\n        const transport = this.getTransport();\r\n        if (!transport) return;\r\n        const search = `?thread_id=${encodeURIComponent(threadId)}`;\r\n        try {\r\n            await transport(\"DELETE\", `/langgraph/checkpoints${search}`);\r\n        } catch (e) {\r\n            console.warn(\"[LetsPingCheckpointer] Failed to delete remote checkpoints\", e);\r\n        }\r\n    }\r\n\r\n    async put(\r\n        config: RunnableConfig,\r\n        checkpoint: Checkpoint,\r\n        metadata: CheckpointMetadata,\r\n        newVersions?: Record<string, string | number>\r\n    ): Promise<RunnableConfig> {\r\n        const threadId = config.configurable?.thread_id;\r\n        const checkpointId = checkpoint.id;\r\n\r\n        if (!threadId || !checkpointId) {\r\n            return config;\r\n        }\r\n\r\n        this.checkpoints[`${threadId}:${checkpointId}`] = { checkpoint, metadata };\r\n        await this.saveRemote(threadId, checkpointId, checkpoint, metadata);\r\n\r\n        return {\r\n            configurable: {\r\n                thread_id: threadId,\r\n                checkpoint_id: checkpointId,\r\n            },\r\n        };\r\n    }\r\n\r\n    // METHODS REQUIRED BY LANGGRAPH V0.1+\r\n    async putWrites(config: RunnableConfig, writes: any, taskId: string): Promise<void> {\r\n        // No-op for V1: LetsPing focuses on primary state parking, not granular sub-task writes.\r\n    }\r\n\r\n    async deleteThread(threadId: string): Promise<void> {\r\n        for (const key of Object.keys(this.checkpoints)) {\r\n            if (key.startsWith(`${threadId}:`)) {\r\n                delete this.checkpoints[key];\r\n            }\r\n        }\r\n        await this.deleteRemote(threadId);\r\n    }\r\n\r\n    async getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined> {\r\n        const threadId = config.configurable?.thread_id;\r\n        const checkpointId = config.configurable?.checkpoint_id;\r\n        if (!threadId) return undefined;\r\n\r\n        // Prefer remote truth, fall back to local cache.\r\n        const remote = await this.loadRemote(threadId, checkpointId);\r\n        if (remote) {\r\n            return { config, checkpoint: remote.checkpoint, metadata: remote.metadata };\r\n        }\r\n\r\n        if (checkpointId) {\r\n            const match = this.checkpoints[`${threadId}:${checkpointId}`];\r\n            if (match) {\r\n                return { config, checkpoint: match.checkpoint, metadata: match.metadata };\r\n            }\r\n        }\r\n\r\n        let latest: CheckpointTuple | undefined;\r\n        for (const [key, val] of Object.entries(this.checkpoints)) {\r\n            if (key.startsWith(`${threadId}:`)) {\r\n                latest = { config, checkpoint: val.checkpoint, metadata: val.metadata };\r\n            }\r\n        }\r\n        return latest;\r\n    }\r\n\r\n    async *list(config: RunnableConfig, options?: any): AsyncGenerator<CheckpointTuple> {\r\n        const threadId = config.configurable?.thread_id;\r\n        if (!threadId) return;\r\n\r\n        const remoteLatest = await this.loadRemote(threadId);\r\n        if (remoteLatest) {\r\n            yield { config, checkpoint: remoteLatest.checkpoint, metadata: remoteLatest.metadata };\r\n        }\r\n\r\n        for (const [key, val] of Object.entries(this.checkpoints)) {\r\n            if (key.startsWith(`${threadId}:`)) {\r\n                yield { config, checkpoint: val.checkpoint, metadata: val.metadata };\r\n            }\r\n        }\r\n    }\r\n}"],"mappings":"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","names":[]}

package/dist-tsc/index.d.ts

@@ -1,68 +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" | "APPROVED_WITH_MODIFICATIONS";
-    /** The original payload submitted */
-    payload: any;
-    /** The modified payload if the human edited values during approval */
-    patched_payload?: any;
-    /** Structural diff of the modifications */
-    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);
-}
-export declare function computeDiff(original: any, patched: any): any;
-export declare class LetsPing {
-    private readonly apiKey;
-    private readonly baseUrl;
-    private readonly encryptionKey;
-    /**
-     * @param apiKey         Your LetsPing API key (or set LETSPING_API_KEY env var).
-     * @param options.encryptionKey
-     *   Optional base64-encoded AES-256 key for payload encryption.
-     *   If not provided here, the SDK reads LETSPING_ENCRYPTION_KEY from process.env.
-     *   Generate once from the dashboard (Settings → Encryption).
-     *   When set, all payloads are encrypted before leaving this process.
-     *   LetsPing's backend never sees plaintext values.
-     */
-    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>;
-}