@letsping/adapters 0.1.2 → 0.1.5

package/README.md

@@ -81,5 +81,6 @@ Make sure the following compatible versions are installed in your project:
 - The `apiKey` is passed per-tool. For most applications you will use the same key across tools.
 - The `schema` (Zod) is used both for type safety and to generate an editable form in the LetsPing dashboard.
 - If the human modifies values in the form, the resolved payload will contain the updated values (`patched_payload` in the LetsPing SDK response).
+- **Important**: These adapters handle the *execution pause* natively within standard framework constructs, but they do *not* automatically rehydrate the framework once the process exits. You must handle webhook delivery and instantiate your framework resumption logic manually.
 
 For full LetsPing API documentation, see: https://letsping.co/docs

package/dist/langchain.d.mts

@@ -9,11 +9,8 @@ interface AdapterOptions<T extends z.ZodType> {
     service?: string;
     priority?: "low" | "medium" | "high" | "critical";
     timeout?: number;
+    handler?: (args: z.infer<T>) => Promise<any> | any;
 }
-/**
- * Creates a LangChain Tool that pauses execution for human approval.
- * Compatible with LangGraph and standard Agents.
- */
 declare function createLetsPingTool<T extends z.ZodType>(options: AdapterOptions<T>): DynamicStructuredTool<any>;
 
 export { createLetsPingTool };

package/dist/langchain.d.ts

@@ -9,11 +9,8 @@ interface AdapterOptions<T extends z.ZodType> {
     service?: string;
     priority?: "low" | "medium" | "high" | "critical";
     timeout?: number;
+    handler?: (args: z.infer<T>) => Promise<any> | any;
 }
-/**
- * Creates a LangChain Tool that pauses execution for human approval.
- * Compatible with LangGraph and standard Agents.
- */
 declare function createLetsPingTool<T extends z.ZodType>(options: AdapterOptions<T>): DynamicStructuredTool<any>;
 
 export { createLetsPingTool };

package/dist/langchain.js

@@ -51,11 +51,30 @@ function createLetsPingTool(options) {
             metadata: decision.metadata
           });
         }
-        return JSON.stringify({
+        const executed_input = decision.patched_payload || decision.payload;
+        let execution_output;
+        if (options.handler) {
+          execution_output = await options.handler(executed_input);
+        }
+        if (decision.patched_payload) {
+          const diff = (0, import_sdk.computeDiff)(decision.payload, decision.patched_payload);
+          const diff_summary = diff ? { changes: diff } : { changes: "Unknown structure changes" };
+          const letsping_context2 = {
+            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,
+            original_input: decision.payload,
+            executed_input,
+            metadata: decision.metadata
+          };
+          return JSON.stringify(options.handler ? { letsping_context: letsping_context2, execution_output } : letsping_context2);
+        }
+        const letsping_context = {
           status: "APPROVED",
-          approved_input: decision.patched_payload || decision.payload,
+          executed_input,
           metadata: decision.metadata
-        });
+        };
+        return JSON.stringify(options.handler ? { letsping_context, execution_output } : letsping_context);
       } catch (error) {
         return JSON.stringify({
           status: "ERROR",

package/dist/langchain.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/langchain.ts"],"sourcesContent":["import { DynamicStructuredTool } from \"@langchain/core/tools\";\r\nimport { LetsPing } from \"@letsping/sdk\";\r\nimport { z } from \"zod\";\r\n\r\ninterface AdapterOptions<T extends z.ZodType> {\r\n    name: string;\r\n    description: string;\r\n    schema: T;\r\n    apiKey: string;\r\n    service?: string;\r\n    priority?: \"low\" | \"medium\" | \"high\" | \"critical\";\r\n    timeout?: number;\r\n}\r\n\r\n/**\r\n * Creates a LangChain Tool that pauses execution for human approval.\r\n * Compatible with LangGraph and standard Agents.\r\n */\r\nexport function createLetsPingTool<T extends z.ZodType>(options: AdapterOptions<T>) {\r\n    if (!options.apiKey) {\r\n        throw new Error(\"LetsPing Adapter Error: 'apiKey' is required.\");\r\n    }\r\n\r\n    const lp = new LetsPing(options.apiKey);\r\n\r\n    return new DynamicStructuredTool({\r\n        name: options.name,\r\n        description: `${options.description} [SYSTEM NOTE: This tool pauses execution until a human approves the request via LetsPing. Do not expect an immediate result.]`,\r\n        schema: options.schema as any,\r\n        func: async (args: any) => {\r\n            try {\r\n                const decision = await lp.ask({\r\n                    service: options.service || \"langchain-agent\",\r\n                    action: options.name,\r\n                    priority: options.priority || \"medium\",\r\n                    payload: args,\r\n                    schema: options.schema,\r\n                    timeoutMs: options.timeout\r\n                });\r\n\r\n                if (decision.status === \"REJECTED\") {\r\n                    return JSON.stringify({\r\n                        status: \"REJECTED\",\r\n                        message: \"The human operator denied this request. Do not proceed with the action.\",\r\n                        metadata: decision.metadata\r\n                    });\r\n                }\r\n\r\n                return JSON.stringify({\r\n                    status: \"APPROVED\",\r\n                    approved_input: decision.patched_payload || decision.payload,\r\n                    metadata: decision.metadata\r\n                });\r\n\r\n            } catch (error: any) {\r\n                return JSON.stringify({\r\n                    status: \"ERROR\",\r\n                    error: error.message || \"Unknown error during LetsPing approval process\",\r\n                    suggestion: \"Inform the user that the request for approval failed or timed out.\"\r\n                });\r\n            }\r\n        }\r\n    });\r\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAsC;AACtC,iBAAyB;AAiBlB,SAAS,mBAAwC,SAA4B;AAChF,MAAI,CAAC,QAAQ,QAAQ;AACjB,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACnE;AAEA,QAAM,KAAK,IAAI,oBAAS,QAAQ,MAAM;AAEtC,SAAO,IAAI,mCAAsB;AAAA,IAC7B,MAAM,QAAQ;AAAA,IACd,aAAa,GAAG,QAAQ,WAAW;AAAA,IACnC,QAAQ,QAAQ;AAAA,IAChB,MAAM,OAAO,SAAc;AACvB,UAAI;AACA,cAAM,WAAW,MAAM,GAAG,IAAI;AAAA,UAC1B,SAAS,QAAQ,WAAW;AAAA,UAC5B,QAAQ,QAAQ;AAAA,UAChB,UAAU,QAAQ,YAAY;AAAA,UAC9B,SAAS;AAAA,UACT,QAAQ,QAAQ;AAAA,UAChB,WAAW,QAAQ;AAAA,QACvB,CAAC;AAED,YAAI,SAAS,WAAW,YAAY;AAChC,iBAAO,KAAK,UAAU;AAAA,YAClB,QAAQ;AAAA,YACR,SAAS;AAAA,YACT,UAAU,SAAS;AAAA,UACvB,CAAC;AAAA,QACL;AAEA,eAAO,KAAK,UAAU;AAAA,UAClB,QAAQ;AAAA,UACR,gBAAgB,SAAS,mBAAmB,SAAS;AAAA,UACrD,UAAU,SAAS;AAAA,QACvB,CAAC;AAAA,MAEL,SAAS,OAAY;AACjB,eAAO,KAAK,UAAU;AAAA,UAClB,QAAQ;AAAA,UACR,OAAO,MAAM,WAAW;AAAA,UACxB,YAAY;AAAA,QAChB,CAAC;AAAA,MACL;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;","names":[]}
+{"version":3,"sources":["../src/langchain.ts"],"sourcesContent":["import { DynamicStructuredTool } from \"@langchain/core/tools\";\r\nimport { LetsPing, computeDiff } from \"@letsping/sdk\";\r\nimport { z } from \"zod\";\r\n\r\ninterface AdapterOptions<T extends z.ZodType> {\r\n    name: string;\r\n    description: string;\r\n    schema: T;\r\n    apiKey: string;\r\n    service?: string;\r\n    priority?: \"low\" | \"medium\" | \"high\" | \"critical\";\r\n    timeout?: number;\r\n    handler?: (args: z.infer<T>) => Promise<any> | any;\r\n}\r\n\nexport function createLetsPingTool<T extends z.ZodType>(options: AdapterOptions<T>) {\r\n    if (!options.apiKey) {\r\n        throw new Error(\"LetsPing Adapter Error: 'apiKey' is required.\");\r\n    }\r\n\r\n    const lp = new LetsPing(options.apiKey);\r\n\r\n    return new DynamicStructuredTool({\r\n        name: options.name,\r\n        description: `${options.description} [SYSTEM NOTE: This tool pauses execution until a human approves the request via LetsPing. Do not expect an immediate result.]`,\r\n        schema: options.schema as any,\r\n        func: async (args: any) => {\r\n            try {\r\n                const decision = await lp.ask({\r\n                    service: options.service || \"langchain-agent\",\r\n                    action: options.name,\r\n                    priority: options.priority || \"medium\",\r\n                    payload: args,\r\n                    schema: options.schema,\r\n                    timeoutMs: options.timeout\r\n                });\r\n\r\n                if (decision.status === \"REJECTED\") {\r\n                    return JSON.stringify({\r\n                        status: \"REJECTED\",\r\n                        message: \"The human operator denied this request. Do not proceed with the action.\",\r\n                        metadata: decision.metadata\r\n                    });\r\n                }\r\n\r\n                const executed_input = decision.patched_payload || decision.payload;\r\n                let execution_output;\r\n                if (options.handler) {\r\n                    execution_output = await options.handler(executed_input);\r\n                }\r\n\r\n                if (decision.patched_payload) {\r\n                    const diff = computeDiff(decision.payload, decision.patched_payload);\r\n                    const diff_summary = diff ? { changes: diff } : { changes: \"Unknown structure changes\" };\r\n\r\n                    const letsping_context = {\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,\r\n                        original_input: decision.payload,\r\n                        executed_input,\r\n                        metadata: decision.metadata\r\n                    };\r\n\r\n                    return JSON.stringify(options.handler ? { letsping_context, execution_output } : letsping_context);\r\n                }\r\n\r\n                const letsping_context = {\r\n                    status: \"APPROVED\",\r\n                    executed_input,\r\n                    metadata: decision.metadata\r\n                };\r\n\r\n                return JSON.stringify(options.handler ? { letsping_context, execution_output } : letsping_context);\r\n\r\n            } catch (error: any) {\r\n                return JSON.stringify({\r\n                    status: \"ERROR\",\r\n                    error: error.message || \"Unknown error during LetsPing approval process\",\r\n                    suggestion: \"Inform the user that the request for approval failed or timed out.\"\r\n                });\r\n            }\r\n        }\r\n    });\r\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAsC;AACtC,iBAAsC;AAc/B,SAAS,mBAAwC,SAA4B;AAChF,MAAI,CAAC,QAAQ,QAAQ;AACjB,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACnE;AAEA,QAAM,KAAK,IAAI,oBAAS,QAAQ,MAAM;AAEtC,SAAO,IAAI,mCAAsB;AAAA,IAC7B,MAAM,QAAQ;AAAA,IACd,aAAa,GAAG,QAAQ,WAAW;AAAA,IACnC,QAAQ,QAAQ;AAAA,IAChB,MAAM,OAAO,SAAc;AACvB,UAAI;AACA,cAAM,WAAW,MAAM,GAAG,IAAI;AAAA,UAC1B,SAAS,QAAQ,WAAW;AAAA,UAC5B,QAAQ,QAAQ;AAAA,UAChB,UAAU,QAAQ,YAAY;AAAA,UAC9B,SAAS;AAAA,UACT,QAAQ,QAAQ;AAAA,UAChB,WAAW,QAAQ;AAAA,QACvB,CAAC;AAED,YAAI,SAAS,WAAW,YAAY;AAChC,iBAAO,KAAK,UAAU;AAAA,YAClB,QAAQ;AAAA,YACR,SAAS;AAAA,YACT,UAAU,SAAS;AAAA,UACvB,CAAC;AAAA,QACL;AAEA,cAAM,iBAAiB,SAAS,mBAAmB,SAAS;AAC5D,YAAI;AACJ,YAAI,QAAQ,SAAS;AACjB,6BAAmB,MAAM,QAAQ,QAAQ,cAAc;AAAA,QAC3D;AAEA,YAAI,SAAS,iBAAiB;AAC1B,gBAAM,WAAO,wBAAY,SAAS,SAAS,SAAS,eAAe;AACnE,gBAAM,eAAe,OAAO,EAAE,SAAS,KAAK,IAAI,EAAE,SAAS,4BAA4B;AAEvF,gBAAMA,oBAAmB;AAAA,YACrB,QAAQ;AAAA,YACR,SAAS;AAAA,YACT;AAAA,YACA,gBAAgB,SAAS;AAAA,YACzB;AAAA,YACA,UAAU,SAAS;AAAA,UACvB;AAEA,iBAAO,KAAK,UAAU,QAAQ,UAAU,EAAE,kBAAAA,mBAAkB,iBAAiB,IAAIA,iBAAgB;AAAA,QACrG;AAEA,cAAM,mBAAmB;AAAA,UACrB,QAAQ;AAAA,UACR;AAAA,UACA,UAAU,SAAS;AAAA,QACvB;AAEA,eAAO,KAAK,UAAU,QAAQ,UAAU,EAAE,kBAAkB,iBAAiB,IAAI,gBAAgB;AAAA,MAErG,SAAS,OAAY;AACjB,eAAO,KAAK,UAAU;AAAA,UAClB,QAAQ;AAAA,UACR,OAAO,MAAM,WAAW;AAAA,UACxB,YAAY;AAAA,QAChB,CAAC;AAAA,MACL;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;","names":["letsping_context"]}

package/dist/langchain.mjs

@@ -1,6 +1,6 @@
 // src/langchain.ts
 import { DynamicStructuredTool } from "@langchain/core/tools";
-import { LetsPing } from "@letsping/sdk";
+import { LetsPing, computeDiff } from "@letsping/sdk";
 function createLetsPingTool(options) {
   if (!options.apiKey) {
     throw new Error("LetsPing Adapter Error: 'apiKey' is required.");
@@ -27,11 +27,30 @@ function createLetsPingTool(options) {
             metadata: decision.metadata
           });
         }
-        return JSON.stringify({
+        const executed_input = decision.patched_payload || decision.payload;
+        let execution_output;
+        if (options.handler) {
+          execution_output = await options.handler(executed_input);
+        }
+        if (decision.patched_payload) {
+          const diff = computeDiff(decision.payload, decision.patched_payload);
+          const diff_summary = diff ? { changes: diff } : { changes: "Unknown structure changes" };
+          const letsping_context2 = {
+            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,
+            original_input: decision.payload,
+            executed_input,
+            metadata: decision.metadata
+          };
+          return JSON.stringify(options.handler ? { letsping_context: letsping_context2, execution_output } : letsping_context2);
+        }
+        const letsping_context = {
           status: "APPROVED",
-          approved_input: decision.patched_payload || decision.payload,
+          executed_input,
           metadata: decision.metadata
-        });
+        };
+        return JSON.stringify(options.handler ? { letsping_context, execution_output } : letsping_context);
       } catch (error) {
         return JSON.stringify({
           status: "ERROR",

package/dist/langchain.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/langchain.ts"],"sourcesContent":["import { DynamicStructuredTool } from \"@langchain/core/tools\";\r\nimport { LetsPing } from \"@letsping/sdk\";\r\nimport { z } from \"zod\";\r\n\r\ninterface AdapterOptions<T extends z.ZodType> {\r\n    name: string;\r\n    description: string;\r\n    schema: T;\r\n    apiKey: string;\r\n    service?: string;\r\n    priority?: \"low\" | \"medium\" | \"high\" | \"critical\";\r\n    timeout?: number;\r\n}\r\n\r\n/**\r\n * Creates a LangChain Tool that pauses execution for human approval.\r\n * Compatible with LangGraph and standard Agents.\r\n */\r\nexport function createLetsPingTool<T extends z.ZodType>(options: AdapterOptions<T>) {\r\n    if (!options.apiKey) {\r\n        throw new Error(\"LetsPing Adapter Error: 'apiKey' is required.\");\r\n    }\r\n\r\n    const lp = new LetsPing(options.apiKey);\r\n\r\n    return new DynamicStructuredTool({\r\n        name: options.name,\r\n        description: `${options.description} [SYSTEM NOTE: This tool pauses execution until a human approves the request via LetsPing. Do not expect an immediate result.]`,\r\n        schema: options.schema as any,\r\n        func: async (args: any) => {\r\n            try {\r\n                const decision = await lp.ask({\r\n                    service: options.service || \"langchain-agent\",\r\n                    action: options.name,\r\n                    priority: options.priority || \"medium\",\r\n                    payload: args,\r\n                    schema: options.schema,\r\n                    timeoutMs: options.timeout\r\n                });\r\n\r\n                if (decision.status === \"REJECTED\") {\r\n                    return JSON.stringify({\r\n                        status: \"REJECTED\",\r\n                        message: \"The human operator denied this request. Do not proceed with the action.\",\r\n                        metadata: decision.metadata\r\n                    });\r\n                }\r\n\r\n                return JSON.stringify({\r\n                    status: \"APPROVED\",\r\n                    approved_input: decision.patched_payload || decision.payload,\r\n                    metadata: decision.metadata\r\n                });\r\n\r\n            } catch (error: any) {\r\n                return JSON.stringify({\r\n                    status: \"ERROR\",\r\n                    error: error.message || \"Unknown error during LetsPing approval process\",\r\n                    suggestion: \"Inform the user that the request for approval failed or timed out.\"\r\n                });\r\n            }\r\n        }\r\n    });\r\n}"],"mappings":";AAAA,SAAS,6BAA6B;AACtC,SAAS,gBAAgB;AAiBlB,SAAS,mBAAwC,SAA4B;AAChF,MAAI,CAAC,QAAQ,QAAQ;AACjB,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACnE;AAEA,QAAM,KAAK,IAAI,SAAS,QAAQ,MAAM;AAEtC,SAAO,IAAI,sBAAsB;AAAA,IAC7B,MAAM,QAAQ;AAAA,IACd,aAAa,GAAG,QAAQ,WAAW;AAAA,IACnC,QAAQ,QAAQ;AAAA,IAChB,MAAM,OAAO,SAAc;AACvB,UAAI;AACA,cAAM,WAAW,MAAM,GAAG,IAAI;AAAA,UAC1B,SAAS,QAAQ,WAAW;AAAA,UAC5B,QAAQ,QAAQ;AAAA,UAChB,UAAU,QAAQ,YAAY;AAAA,UAC9B,SAAS;AAAA,UACT,QAAQ,QAAQ;AAAA,UAChB,WAAW,QAAQ;AAAA,QACvB,CAAC;AAED,YAAI,SAAS,WAAW,YAAY;AAChC,iBAAO,KAAK,UAAU;AAAA,YAClB,QAAQ;AAAA,YACR,SAAS;AAAA,YACT,UAAU,SAAS;AAAA,UACvB,CAAC;AAAA,QACL;AAEA,eAAO,KAAK,UAAU;AAAA,UAClB,QAAQ;AAAA,UACR,gBAAgB,SAAS,mBAAmB,SAAS;AAAA,UACrD,UAAU,SAAS;AAAA,QACvB,CAAC;AAAA,MAEL,SAAS,OAAY;AACjB,eAAO,KAAK,UAAU;AAAA,UAClB,QAAQ;AAAA,UACR,OAAO,MAAM,WAAW;AAAA,UACxB,YAAY;AAAA,QAChB,CAAC;AAAA,MACL;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;","names":[]}
+{"version":3,"sources":["../src/langchain.ts"],"sourcesContent":["import { DynamicStructuredTool } from \"@langchain/core/tools\";\r\nimport { LetsPing, computeDiff } from \"@letsping/sdk\";\r\nimport { z } from \"zod\";\r\n\r\ninterface AdapterOptions<T extends z.ZodType> {\r\n    name: string;\r\n    description: string;\r\n    schema: T;\r\n    apiKey: string;\r\n    service?: string;\r\n    priority?: \"low\" | \"medium\" | \"high\" | \"critical\";\r\n    timeout?: number;\r\n    handler?: (args: z.infer<T>) => Promise<any> | any;\r\n}\r\n\nexport function createLetsPingTool<T extends z.ZodType>(options: AdapterOptions<T>) {\r\n    if (!options.apiKey) {\r\n        throw new Error(\"LetsPing Adapter Error: 'apiKey' is required.\");\r\n    }\r\n\r\n    const lp = new LetsPing(options.apiKey);\r\n\r\n    return new DynamicStructuredTool({\r\n        name: options.name,\r\n        description: `${options.description} [SYSTEM NOTE: This tool pauses execution until a human approves the request via LetsPing. Do not expect an immediate result.]`,\r\n        schema: options.schema as any,\r\n        func: async (args: any) => {\r\n            try {\r\n                const decision = await lp.ask({\r\n                    service: options.service || \"langchain-agent\",\r\n                    action: options.name,\r\n                    priority: options.priority || \"medium\",\r\n                    payload: args,\r\n                    schema: options.schema,\r\n                    timeoutMs: options.timeout\r\n                });\r\n\r\n                if (decision.status === \"REJECTED\") {\r\n                    return JSON.stringify({\r\n                        status: \"REJECTED\",\r\n                        message: \"The human operator denied this request. Do not proceed with the action.\",\r\n                        metadata: decision.metadata\r\n                    });\r\n                }\r\n\r\n                const executed_input = decision.patched_payload || decision.payload;\r\n                let execution_output;\r\n                if (options.handler) {\r\n                    execution_output = await options.handler(executed_input);\r\n                }\r\n\r\n                if (decision.patched_payload) {\r\n                    const diff = computeDiff(decision.payload, decision.patched_payload);\r\n                    const diff_summary = diff ? { changes: diff } : { changes: \"Unknown structure changes\" };\r\n\r\n                    const letsping_context = {\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,\r\n                        original_input: decision.payload,\r\n                        executed_input,\r\n                        metadata: decision.metadata\r\n                    };\r\n\r\n                    return JSON.stringify(options.handler ? { letsping_context, execution_output } : letsping_context);\r\n                }\r\n\r\n                const letsping_context = {\r\n                    status: \"APPROVED\",\r\n                    executed_input,\r\n                    metadata: decision.metadata\r\n                };\r\n\r\n                return JSON.stringify(options.handler ? { letsping_context, execution_output } : letsping_context);\r\n\r\n            } catch (error: any) {\r\n                return JSON.stringify({\r\n                    status: \"ERROR\",\r\n                    error: error.message || \"Unknown error during LetsPing approval process\",\r\n                    suggestion: \"Inform the user that the request for approval failed or timed out.\"\r\n                });\r\n            }\r\n        }\r\n    });\r\n}"],"mappings":";AAAA,SAAS,6BAA6B;AACtC,SAAS,UAAU,mBAAmB;AAc/B,SAAS,mBAAwC,SAA4B;AAChF,MAAI,CAAC,QAAQ,QAAQ;AACjB,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACnE;AAEA,QAAM,KAAK,IAAI,SAAS,QAAQ,MAAM;AAEtC,SAAO,IAAI,sBAAsB;AAAA,IAC7B,MAAM,QAAQ;AAAA,IACd,aAAa,GAAG,QAAQ,WAAW;AAAA,IACnC,QAAQ,QAAQ;AAAA,IAChB,MAAM,OAAO,SAAc;AACvB,UAAI;AACA,cAAM,WAAW,MAAM,GAAG,IAAI;AAAA,UAC1B,SAAS,QAAQ,WAAW;AAAA,UAC5B,QAAQ,QAAQ;AAAA,UAChB,UAAU,QAAQ,YAAY;AAAA,UAC9B,SAAS;AAAA,UACT,QAAQ,QAAQ;AAAA,UAChB,WAAW,QAAQ;AAAA,QACvB,CAAC;AAED,YAAI,SAAS,WAAW,YAAY;AAChC,iBAAO,KAAK,UAAU;AAAA,YAClB,QAAQ;AAAA,YACR,SAAS;AAAA,YACT,UAAU,SAAS;AAAA,UACvB,CAAC;AAAA,QACL;AAEA,cAAM,iBAAiB,SAAS,mBAAmB,SAAS;AAC5D,YAAI;AACJ,YAAI,QAAQ,SAAS;AACjB,6BAAmB,MAAM,QAAQ,QAAQ,cAAc;AAAA,QAC3D;AAEA,YAAI,SAAS,iBAAiB;AAC1B,gBAAM,OAAO,YAAY,SAAS,SAAS,SAAS,eAAe;AACnE,gBAAM,eAAe,OAAO,EAAE,SAAS,KAAK,IAAI,EAAE,SAAS,4BAA4B;AAEvF,gBAAMA,oBAAmB;AAAA,YACrB,QAAQ;AAAA,YACR,SAAS;AAAA,YACT;AAAA,YACA,gBAAgB,SAAS;AAAA,YACzB;AAAA,YACA,UAAU,SAAS;AAAA,UACvB;AAEA,iBAAO,KAAK,UAAU,QAAQ,UAAU,EAAE,kBAAAA,mBAAkB,iBAAiB,IAAIA,iBAAgB;AAAA,QACrG;AAEA,cAAM,mBAAmB;AAAA,UACrB,QAAQ;AAAA,UACR;AAAA,UACA,UAAU,SAAS;AAAA,QACvB;AAEA,eAAO,KAAK,UAAU,QAAQ,UAAU,EAAE,kBAAkB,iBAAiB,IAAI,gBAAgB;AAAA,MAErG,SAAS,OAAY;AACjB,eAAO,KAAK,UAAU;AAAA,UAClB,QAAQ;AAAA,UACR,OAAO,MAAM,WAAW;AAAA,UACxB,YAAY;AAAA,QAChB,CAAC;AAAA,MACL;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;","names":["letsping_context"]}

package/dist/vercel.d.mts

@@ -9,42 +9,80 @@ interface AdapterOptions<T extends z.ZodType> {
     service?: string;
     priority?: "low" | "medium" | "high" | "critical";
     timeout?: number;
+    handler?: (args: z.infer<T>) => Promise<any> | any;
 }
-/**
- * Creates a Vercel AI SDK Tool that pauses execution for human approval.
- * @example
- * const tools = {
- * refund: letsPing({
- * name: "refund_user",
- * description: "Refund a user transaction",
- * schema: z.object({ amount: z.number() }),
- * apiKey: process.env.LETSPING_API_KEY!
- * })
- * }
- */
 declare function letsPing<T extends z.ZodType>(options: AdapterOptions<T>): ai.CoreTool<T, {
     status: string;
     message: string;
+    diff_summary: {
+        changes: any;
+    };
+    original_input: any;
+    executed_input: any;
     metadata: {
         resolved_at: string;
         actor_id: string;
         method?: string;
     } | undefined;
-    rejection_reason: any;
-    original_input?: undefined;
-    approved_input?: undefined;
-    error?: undefined;
-    suggestion?: undefined;
 } | {
     status: string;
     original_input: T extends ai.Schema<any> ? T["_type"] : T extends z.ZodTypeAny ? z.TypeOf<T> : never;
-    approved_input: any;
+    executed_input: any;
     metadata: {
         resolved_at: string;
         actor_id: string;
         method?: string;
     } | undefined;
+} | {
+    status: string;
+    message: string;
+    metadata: {
+        resolved_at: string;
+        actor_id: string;
+        method?: string;
+    } | undefined;
+    rejection_reason: any;
+    letsping_context?: undefined;
+    execution_output?: undefined;
+    error?: undefined;
+    suggestion?: undefined;
+} | {
+    letsping_context: {
+        status: string;
+        message: string;
+        diff_summary: {
+            changes: any;
+        };
+        original_input: any;
+        executed_input: any;
+        metadata: {
+            resolved_at: string;
+            actor_id: string;
+            method?: string;
+        } | undefined;
+    };
+    execution_output: any;
+    status?: undefined;
+    message?: undefined;
+    metadata?: undefined;
+    rejection_reason?: undefined;
+    error?: undefined;
+    suggestion?: undefined;
+} | {
+    letsping_context: {
+        status: string;
+        original_input: T extends ai.Schema<any> ? T["_type"] : T extends z.ZodTypeAny ? z.TypeOf<T> : never;
+        executed_input: any;
+        metadata: {
+            resolved_at: string;
+            actor_id: string;
+            method?: string;
+        } | undefined;
+    };
+    execution_output: any;
+    status?: undefined;
     message?: undefined;
+    metadata?: undefined;
     rejection_reason?: undefined;
     error?: undefined;
     suggestion?: undefined;
@@ -55,34 +93,83 @@ declare function letsPing<T extends z.ZodType>(options: AdapterOptions<T>): ai.C
     message?: undefined;
     metadata?: undefined;
     rejection_reason?: undefined;
-    original_input?: undefined;
-    approved_input?: undefined;
+    letsping_context?: undefined;
+    execution_output?: undefined;
 }> & {
     execute: (args: T extends ai.Schema<any> ? T["_type"] : T extends z.ZodTypeAny ? z.TypeOf<T> : never, options: {
         abortSignal?: AbortSignal;
     }) => PromiseLike<{
         status: string;
         message: string;
+        diff_summary: {
+            changes: any;
+        };
+        original_input: any;
+        executed_input: any;
         metadata: {
             resolved_at: string;
             actor_id: string;
             method?: string;
         } | undefined;
-        rejection_reason: any;
-        original_input?: undefined;
-        approved_input?: undefined;
-        error?: undefined;
-        suggestion?: undefined;
     } | {
         status: string;
         original_input: T extends ai.Schema<any> ? T["_type"] : T extends z.ZodTypeAny ? z.TypeOf<T> : never;
-        approved_input: any;
+        executed_input: any;
         metadata: {
             resolved_at: string;
             actor_id: string;
             method?: string;
         } | undefined;
+    } | {
+        status: string;
+        message: string;
+        metadata: {
+            resolved_at: string;
+            actor_id: string;
+            method?: string;
+        } | undefined;
+        rejection_reason: any;
+        letsping_context?: undefined;
+        execution_output?: undefined;
+        error?: undefined;
+        suggestion?: undefined;
+    } | {
+        letsping_context: {
+            status: string;
+            message: string;
+            diff_summary: {
+                changes: any;
+            };
+            original_input: any;
+            executed_input: any;
+            metadata: {
+                resolved_at: string;
+                actor_id: string;
+                method?: string;
+            } | undefined;
+        };
+        execution_output: any;
+        status?: undefined;
         message?: undefined;
+        metadata?: undefined;
+        rejection_reason?: undefined;
+        error?: undefined;
+        suggestion?: undefined;
+    } | {
+        letsping_context: {
+            status: string;
+            original_input: T extends ai.Schema<any> ? T["_type"] : T extends z.ZodTypeAny ? z.TypeOf<T> : never;
+            executed_input: any;
+            metadata: {
+                resolved_at: string;
+                actor_id: string;
+                method?: string;
+            } | undefined;
+        };
+        execution_output: any;
+        status?: undefined;
+        message?: undefined;
+        metadata?: undefined;
         rejection_reason?: undefined;
         error?: undefined;
         suggestion?: undefined;
@@ -93,8 +180,8 @@ declare function letsPing<T extends z.ZodType>(options: AdapterOptions<T>): ai.C
         message?: undefined;
         metadata?: undefined;
         rejection_reason?: undefined;
-        original_input?: undefined;
-        approved_input?: undefined;
+        letsping_context?: undefined;
+        execution_output?: undefined;
     }>;
 };
 

package/dist/vercel.d.ts

@@ -9,42 +9,80 @@ interface AdapterOptions<T extends z.ZodType> {
     service?: string;
     priority?: "low" | "medium" | "high" | "critical";
     timeout?: number;
+    handler?: (args: z.infer<T>) => Promise<any> | any;
 }
-/**
- * Creates a Vercel AI SDK Tool that pauses execution for human approval.
- * @example
- * const tools = {
- * refund: letsPing({
- * name: "refund_user",
- * description: "Refund a user transaction",
- * schema: z.object({ amount: z.number() }),
- * apiKey: process.env.LETSPING_API_KEY!
- * })
- * }
- */
 declare function letsPing<T extends z.ZodType>(options: AdapterOptions<T>): ai.CoreTool<T, {
     status: string;
     message: string;
+    diff_summary: {
+        changes: any;
+    };
+    original_input: any;
+    executed_input: any;
     metadata: {
         resolved_at: string;
         actor_id: string;
         method?: string;
     } | undefined;
-    rejection_reason: any;
-    original_input?: undefined;
-    approved_input?: undefined;
-    error?: undefined;
-    suggestion?: undefined;
 } | {
     status: string;
     original_input: T extends ai.Schema<any> ? T["_type"] : T extends z.ZodTypeAny ? z.TypeOf<T> : never;
-    approved_input: any;
+    executed_input: any;
     metadata: {
         resolved_at: string;
         actor_id: string;
         method?: string;
     } | undefined;
+} | {
+    status: string;
+    message: string;
+    metadata: {
+        resolved_at: string;
+        actor_id: string;
+        method?: string;
+    } | undefined;
+    rejection_reason: any;
+    letsping_context?: undefined;
+    execution_output?: undefined;
+    error?: undefined;
+    suggestion?: undefined;
+} | {
+    letsping_context: {
+        status: string;
+        message: string;
+        diff_summary: {
+            changes: any;
+        };
+        original_input: any;
+        executed_input: any;
+        metadata: {
+            resolved_at: string;
+            actor_id: string;
+            method?: string;
+        } | undefined;
+    };
+    execution_output: any;
+    status?: undefined;
+    message?: undefined;
+    metadata?: undefined;
+    rejection_reason?: undefined;
+    error?: undefined;
+    suggestion?: undefined;
+} | {
+    letsping_context: {
+        status: string;
+        original_input: T extends ai.Schema<any> ? T["_type"] : T extends z.ZodTypeAny ? z.TypeOf<T> : never;
+        executed_input: any;
+        metadata: {
+            resolved_at: string;
+            actor_id: string;
+            method?: string;
+        } | undefined;
+    };
+    execution_output: any;
+    status?: undefined;
     message?: undefined;
+    metadata?: undefined;
     rejection_reason?: undefined;
     error?: undefined;
     suggestion?: undefined;
@@ -55,34 +93,83 @@ declare function letsPing<T extends z.ZodType>(options: AdapterOptions<T>): ai.C
     message?: undefined;
     metadata?: undefined;
     rejection_reason?: undefined;
-    original_input?: undefined;
-    approved_input?: undefined;
+    letsping_context?: undefined;
+    execution_output?: undefined;
 }> & {
     execute: (args: T extends ai.Schema<any> ? T["_type"] : T extends z.ZodTypeAny ? z.TypeOf<T> : never, options: {
         abortSignal?: AbortSignal;
     }) => PromiseLike<{
         status: string;
         message: string;
+        diff_summary: {
+            changes: any;
+        };
+        original_input: any;
+        executed_input: any;
         metadata: {
             resolved_at: string;
             actor_id: string;
             method?: string;
         } | undefined;
-        rejection_reason: any;
-        original_input?: undefined;
-        approved_input?: undefined;
-        error?: undefined;
-        suggestion?: undefined;
     } | {
         status: string;
         original_input: T extends ai.Schema<any> ? T["_type"] : T extends z.ZodTypeAny ? z.TypeOf<T> : never;
-        approved_input: any;
+        executed_input: any;
         metadata: {
             resolved_at: string;
             actor_id: string;
             method?: string;
         } | undefined;
+    } | {
+        status: string;
+        message: string;
+        metadata: {
+            resolved_at: string;
+            actor_id: string;
+            method?: string;
+        } | undefined;
+        rejection_reason: any;
+        letsping_context?: undefined;
+        execution_output?: undefined;
+        error?: undefined;
+        suggestion?: undefined;
+    } | {
+        letsping_context: {
+            status: string;
+            message: string;
+            diff_summary: {
+                changes: any;
+            };
+            original_input: any;
+            executed_input: any;
+            metadata: {
+                resolved_at: string;
+                actor_id: string;
+                method?: string;
+            } | undefined;
+        };
+        execution_output: any;
+        status?: undefined;
         message?: undefined;
+        metadata?: undefined;
+        rejection_reason?: undefined;
+        error?: undefined;
+        suggestion?: undefined;
+    } | {
+        letsping_context: {
+            status: string;
+            original_input: T extends ai.Schema<any> ? T["_type"] : T extends z.ZodTypeAny ? z.TypeOf<T> : never;
+            executed_input: any;
+            metadata: {
+                resolved_at: string;
+                actor_id: string;
+                method?: string;
+            } | undefined;
+        };
+        execution_output: any;
+        status?: undefined;
+        message?: undefined;
+        metadata?: undefined;
         rejection_reason?: undefined;
         error?: undefined;
         suggestion?: undefined;
@@ -93,8 +180,8 @@ declare function letsPing<T extends z.ZodType>(options: AdapterOptions<T>): ai.C
         message?: undefined;
         metadata?: undefined;
         rejection_reason?: undefined;
-        original_input?: undefined;
-        approved_input?: undefined;
+        letsping_context?: undefined;
+        execution_output?: undefined;
     }>;
 };
 

package/dist/vercel.js

@@ -51,12 +51,31 @@ function letsPing(options) {
             rejection_reason: decision.rejection_reason || "No reason provided"
           };
         }
-        return {
+        const executed_input = decision.patched_payload || decision.payload;
+        let execution_output;
+        if (options.handler) {
+          execution_output = await options.handler(executed_input);
+        }
+        if (decision.patched_payload) {
+          const diff = (0, import_sdk.computeDiff)(decision.payload, decision.patched_payload);
+          const diff_summary = diff ? { changes: diff } : { changes: "Unknown structure changes" };
+          const letsping_context2 = {
+            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,
+            original_input: decision.payload,
+            executed_input,
+            metadata: decision.metadata
+          };
+          return options.handler ? { letsping_context: letsping_context2, execution_output } : letsping_context2;
+        }
+        const letsping_context = {
           status: "APPROVED",
           original_input: args,
-          approved_input: decision.patched_payload || decision.payload,
+          executed_input,
           metadata: decision.metadata
         };
+        return options.handler ? { letsping_context, execution_output } : letsping_context;
       } catch (error) {
         return {
           status: "ERROR",

package/dist/vercel.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/vercel.ts"],"sourcesContent":["import { tool as createVercelTool } from \"ai\";\r\nimport { LetsPing } from \"@letsping/sdk\";\r\nimport { z } from \"zod\";\r\n\r\ninterface AdapterOptions<T extends z.ZodType> {\r\n    name: string;\r\n    description: string;\r\n    schema: T;\r\n    apiKey: string;\r\n    service?: string;\r\n    priority?: \"low\" | \"medium\" | \"high\" | \"critical\";\r\n    timeout?: number;\r\n}\r\n\r\n/**\r\n * Creates a Vercel AI SDK Tool that pauses execution for human approval.\r\n * @example\r\n * const tools = {\r\n * refund: letsPing({\r\n * name: \"refund_user\",\r\n * description: \"Refund a user transaction\",\r\n * schema: z.object({ amount: z.number() }),\r\n * apiKey: process.env.LETSPING_API_KEY!\r\n * })\r\n * }\r\n */\r\nexport function letsPing<T extends z.ZodType>(options: AdapterOptions<T>) {\r\n    if (!options.apiKey) {\r\n        throw new Error(\"LetsPing Adapter Error: 'apiKey' is required.\");\r\n    }\r\n\r\n    const lp = new LetsPing(options.apiKey);\r\n\r\n    return createVercelTool({\r\n        description: `${options.description} [SYSTEM NOTE: This tool pauses execution to wait for human approval. Do not expect an immediate result.]`,\r\n        parameters: options.schema,\r\n        execute: async (args) => {\r\n            try {\r\n                const decision = await lp.ask({\r\n                    service: options.service || \"vercel-ai-sdk\",\r\n                    action: options.name,\r\n                    priority: options.priority || \"medium\",\r\n                    payload: args,\r\n                    schema: options.schema,\r\n                    timeoutMs: options.timeout\r\n                });\r\n\r\n                if (decision.status === \"REJECTED\") {\r\n                    return {\r\n                        status: \"REJECTED\",\r\n                        message: \"The human operator explicitly denied this action. Do not proceed.\",\r\n                        metadata: decision.metadata,\r\n                        rejection_reason: (decision as any).rejection_reason || \"No reason provided\"\r\n                    };\r\n                }\r\n\r\n                return {\r\n                    status: \"APPROVED\",\r\n                    original_input: args,\r\n                    approved_input: decision.patched_payload || decision.payload,\r\n                    metadata: decision.metadata\r\n                };\r\n\r\n            } catch (error: any) {\r\n                return {\r\n                    status: \"ERROR\",\r\n                    error: error.message || \"Control plane unreachable or request timed out.\",\r\n                    suggestion: \"Inform the user that the request for approval failed.\"\r\n                };\r\n            }\r\n        },\r\n    });\r\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gBAAyC;AACzC,iBAAyB;AAyBlB,SAAS,SAA8B,SAA4B;AACtE,MAAI,CAAC,QAAQ,QAAQ;AACjB,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACnE;AAEA,QAAM,KAAK,IAAI,oBAAS,QAAQ,MAAM;AAEtC,aAAO,UAAAA,MAAiB;AAAA,IACpB,aAAa,GAAG,QAAQ,WAAW;AAAA,IACnC,YAAY,QAAQ;AAAA,IACpB,SAAS,OAAO,SAAS;AACrB,UAAI;AACA,cAAM,WAAW,MAAM,GAAG,IAAI;AAAA,UAC1B,SAAS,QAAQ,WAAW;AAAA,UAC5B,QAAQ,QAAQ;AAAA,UAChB,UAAU,QAAQ,YAAY;AAAA,UAC9B,SAAS;AAAA,UACT,QAAQ,QAAQ;AAAA,UAChB,WAAW,QAAQ;AAAA,QACvB,CAAC;AAED,YAAI,SAAS,WAAW,YAAY;AAChC,iBAAO;AAAA,YACH,QAAQ;AAAA,YACR,SAAS;AAAA,YACT,UAAU,SAAS;AAAA,YACnB,kBAAmB,SAAiB,oBAAoB;AAAA,UAC5D;AAAA,QACJ;AAEA,eAAO;AAAA,UACH,QAAQ;AAAA,UACR,gBAAgB;AAAA,UAChB,gBAAgB,SAAS,mBAAmB,SAAS;AAAA,UACrD,UAAU,SAAS;AAAA,QACvB;AAAA,MAEJ,SAAS,OAAY;AACjB,eAAO;AAAA,UACH,QAAQ;AAAA,UACR,OAAO,MAAM,WAAW;AAAA,UACxB,YAAY;AAAA,QAChB;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;","names":["createVercelTool"]}
+{"version":3,"sources":["../src/vercel.ts"],"sourcesContent":["import { tool as createVercelTool } from \"ai\";\r\nimport { LetsPing, computeDiff } from \"@letsping/sdk\";\r\nimport { z } from \"zod\";\r\n\r\ninterface AdapterOptions<T extends z.ZodType> {\r\n    name: string;\r\n    description: string;\r\n    schema: T;\r\n    apiKey: string;\r\n    service?: string;\r\n    priority?: \"low\" | \"medium\" | \"high\" | \"critical\";\r\n    timeout?: number;\r\n    handler?: (args: z.infer<T>) => Promise<any> | any;\r\n}\r\n\nexport function letsPing<T extends z.ZodType>(options: AdapterOptions<T>) {\r\n    if (!options.apiKey) {\r\n        throw new Error(\"LetsPing Adapter Error: 'apiKey' is required.\");\r\n    }\r\n\r\n    const lp = new LetsPing(options.apiKey);\r\n\r\n    return createVercelTool({\r\n        description: `${options.description} [SYSTEM NOTE: This tool pauses execution to wait for human approval. Do not expect an immediate result.]`,\r\n        parameters: options.schema,\r\n        execute: async (args) => {\r\n            try {\r\n                const decision = await lp.ask({\r\n                    service: options.service || \"vercel-ai-sdk\",\r\n                    action: options.name,\r\n                    priority: options.priority || \"medium\",\r\n                    payload: args,\r\n                    schema: options.schema,\r\n                    timeoutMs: options.timeout\r\n                });\r\n\r\n                if (decision.status === \"REJECTED\") {\r\n                    return {\r\n                        status: \"REJECTED\",\r\n                        message: \"The human operator explicitly denied this action. Do not proceed.\",\r\n                        metadata: decision.metadata,\r\n                        rejection_reason: (decision as any).rejection_reason || \"No reason provided\"\r\n                    };\r\n                }\r\n\r\n                const executed_input = decision.patched_payload || decision.payload;\r\n                let execution_output;\r\n                if (options.handler) {\r\n                    execution_output = await options.handler(executed_input);\r\n                }\r\n\r\n                if (decision.patched_payload) {\r\n                    const diff = computeDiff(decision.payload, decision.patched_payload);\r\n                    const diff_summary = diff ? { changes: diff } : { changes: \"Unknown structure changes\" };\r\n\r\n                    const letsping_context = {\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,\r\n                        original_input: decision.payload,\r\n                        executed_input,\r\n                        metadata: decision.metadata\r\n                    };\r\n\r\n                    return options.handler ? { letsping_context, execution_output } : letsping_context;\r\n                }\r\n\r\n                const letsping_context = {\r\n                    status: \"APPROVED\",\r\n                    original_input: args,\r\n                    executed_input,\r\n                    metadata: decision.metadata\r\n                };\r\n\r\n                return options.handler ? { letsping_context, execution_output } : letsping_context;\r\n\r\n            } catch (error: any) {\r\n                return {\r\n                    status: \"ERROR\",\r\n                    error: error.message || \"Control plane unreachable or request timed out.\",\r\n                    suggestion: \"Inform the user that the request for approval failed.\"\r\n                };\r\n            }\r\n        },\r\n    });\r\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gBAAyC;AACzC,iBAAsC;AAc/B,SAAS,SAA8B,SAA4B;AACtE,MAAI,CAAC,QAAQ,QAAQ;AACjB,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACnE;AAEA,QAAM,KAAK,IAAI,oBAAS,QAAQ,MAAM;AAEtC,aAAO,UAAAA,MAAiB;AAAA,IACpB,aAAa,GAAG,QAAQ,WAAW;AAAA,IACnC,YAAY,QAAQ;AAAA,IACpB,SAAS,OAAO,SAAS;AACrB,UAAI;AACA,cAAM,WAAW,MAAM,GAAG,IAAI;AAAA,UAC1B,SAAS,QAAQ,WAAW;AAAA,UAC5B,QAAQ,QAAQ;AAAA,UAChB,UAAU,QAAQ,YAAY;AAAA,UAC9B,SAAS;AAAA,UACT,QAAQ,QAAQ;AAAA,UAChB,WAAW,QAAQ;AAAA,QACvB,CAAC;AAED,YAAI,SAAS,WAAW,YAAY;AAChC,iBAAO;AAAA,YACH,QAAQ;AAAA,YACR,SAAS;AAAA,YACT,UAAU,SAAS;AAAA,YACnB,kBAAmB,SAAiB,oBAAoB;AAAA,UAC5D;AAAA,QACJ;AAEA,cAAM,iBAAiB,SAAS,mBAAmB,SAAS;AAC5D,YAAI;AACJ,YAAI,QAAQ,SAAS;AACjB,6BAAmB,MAAM,QAAQ,QAAQ,cAAc;AAAA,QAC3D;AAEA,YAAI,SAAS,iBAAiB;AAC1B,gBAAM,WAAO,wBAAY,SAAS,SAAS,SAAS,eAAe;AACnE,gBAAM,eAAe,OAAO,EAAE,SAAS,KAAK,IAAI,EAAE,SAAS,4BAA4B;AAEvF,gBAAMC,oBAAmB;AAAA,YACrB,QAAQ;AAAA,YACR,SAAS;AAAA,YACT;AAAA,YACA,gBAAgB,SAAS;AAAA,YACzB;AAAA,YACA,UAAU,SAAS;AAAA,UACvB;AAEA,iBAAO,QAAQ,UAAU,EAAE,kBAAAA,mBAAkB,iBAAiB,IAAIA;AAAA,QACtE;AAEA,cAAM,mBAAmB;AAAA,UACrB,QAAQ;AAAA,UACR,gBAAgB;AAAA,UAChB;AAAA,UACA,UAAU,SAAS;AAAA,QACvB;AAEA,eAAO,QAAQ,UAAU,EAAE,kBAAkB,iBAAiB,IAAI;AAAA,MAEtE,SAAS,OAAY;AACjB,eAAO;AAAA,UACH,QAAQ;AAAA,UACR,OAAO,MAAM,WAAW;AAAA,UACxB,YAAY;AAAA,QAChB;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;","names":["createVercelTool","letsping_context"]}

package/dist/vercel.mjs

@@ -1,6 +1,6 @@
 // src/vercel.ts
 import { tool as createVercelTool } from "ai";
-import { LetsPing } from "@letsping/sdk";
+import { LetsPing, computeDiff } from "@letsping/sdk";
 function letsPing(options) {
   if (!options.apiKey) {
     throw new Error("LetsPing Adapter Error: 'apiKey' is required.");
@@ -27,12 +27,31 @@ function letsPing(options) {
             rejection_reason: decision.rejection_reason || "No reason provided"
           };
         }
-        return {
+        const executed_input = decision.patched_payload || decision.payload;
+        let execution_output;
+        if (options.handler) {
+          execution_output = await options.handler(executed_input);
+        }
+        if (decision.patched_payload) {
+          const diff = computeDiff(decision.payload, decision.patched_payload);
+          const diff_summary = diff ? { changes: diff } : { changes: "Unknown structure changes" };
+          const letsping_context2 = {
+            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,
+            original_input: decision.payload,
+            executed_input,
+            metadata: decision.metadata
+          };
+          return options.handler ? { letsping_context: letsping_context2, execution_output } : letsping_context2;
+        }
+        const letsping_context = {
           status: "APPROVED",
           original_input: args,
-          approved_input: decision.patched_payload || decision.payload,
+          executed_input,
           metadata: decision.metadata
         };
+        return options.handler ? { letsping_context, execution_output } : letsping_context;
       } catch (error) {
         return {
           status: "ERROR",

package/dist/vercel.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/vercel.ts"],"sourcesContent":["import { tool as createVercelTool } from \"ai\";\r\nimport { LetsPing } from \"@letsping/sdk\";\r\nimport { z } from \"zod\";\r\n\r\ninterface AdapterOptions<T extends z.ZodType> {\r\n    name: string;\r\n    description: string;\r\n    schema: T;\r\n    apiKey: string;\r\n    service?: string;\r\n    priority?: \"low\" | \"medium\" | \"high\" | \"critical\";\r\n    timeout?: number;\r\n}\r\n\r\n/**\r\n * Creates a Vercel AI SDK Tool that pauses execution for human approval.\r\n * @example\r\n * const tools = {\r\n * refund: letsPing({\r\n * name: \"refund_user\",\r\n * description: \"Refund a user transaction\",\r\n * schema: z.object({ amount: z.number() }),\r\n * apiKey: process.env.LETSPING_API_KEY!\r\n * })\r\n * }\r\n */\r\nexport function letsPing<T extends z.ZodType>(options: AdapterOptions<T>) {\r\n    if (!options.apiKey) {\r\n        throw new Error(\"LetsPing Adapter Error: 'apiKey' is required.\");\r\n    }\r\n\r\n    const lp = new LetsPing(options.apiKey);\r\n\r\n    return createVercelTool({\r\n        description: `${options.description} [SYSTEM NOTE: This tool pauses execution to wait for human approval. Do not expect an immediate result.]`,\r\n        parameters: options.schema,\r\n        execute: async (args) => {\r\n            try {\r\n                const decision = await lp.ask({\r\n                    service: options.service || \"vercel-ai-sdk\",\r\n                    action: options.name,\r\n                    priority: options.priority || \"medium\",\r\n                    payload: args,\r\n                    schema: options.schema,\r\n                    timeoutMs: options.timeout\r\n                });\r\n\r\n                if (decision.status === \"REJECTED\") {\r\n                    return {\r\n                        status: \"REJECTED\",\r\n                        message: \"The human operator explicitly denied this action. Do not proceed.\",\r\n                        metadata: decision.metadata,\r\n                        rejection_reason: (decision as any).rejection_reason || \"No reason provided\"\r\n                    };\r\n                }\r\n\r\n                return {\r\n                    status: \"APPROVED\",\r\n                    original_input: args,\r\n                    approved_input: decision.patched_payload || decision.payload,\r\n                    metadata: decision.metadata\r\n                };\r\n\r\n            } catch (error: any) {\r\n                return {\r\n                    status: \"ERROR\",\r\n                    error: error.message || \"Control plane unreachable or request timed out.\",\r\n                    suggestion: \"Inform the user that the request for approval failed.\"\r\n                };\r\n            }\r\n        },\r\n    });\r\n}"],"mappings":";AAAA,SAAS,QAAQ,wBAAwB;AACzC,SAAS,gBAAgB;AAyBlB,SAAS,SAA8B,SAA4B;AACtE,MAAI,CAAC,QAAQ,QAAQ;AACjB,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACnE;AAEA,QAAM,KAAK,IAAI,SAAS,QAAQ,MAAM;AAEtC,SAAO,iBAAiB;AAAA,IACpB,aAAa,GAAG,QAAQ,WAAW;AAAA,IACnC,YAAY,QAAQ;AAAA,IACpB,SAAS,OAAO,SAAS;AACrB,UAAI;AACA,cAAM,WAAW,MAAM,GAAG,IAAI;AAAA,UAC1B,SAAS,QAAQ,WAAW;AAAA,UAC5B,QAAQ,QAAQ;AAAA,UAChB,UAAU,QAAQ,YAAY;AAAA,UAC9B,SAAS;AAAA,UACT,QAAQ,QAAQ;AAAA,UAChB,WAAW,QAAQ;AAAA,QACvB,CAAC;AAED,YAAI,SAAS,WAAW,YAAY;AAChC,iBAAO;AAAA,YACH,QAAQ;AAAA,YACR,SAAS;AAAA,YACT,UAAU,SAAS;AAAA,YACnB,kBAAmB,SAAiB,oBAAoB;AAAA,UAC5D;AAAA,QACJ;AAEA,eAAO;AAAA,UACH,QAAQ;AAAA,UACR,gBAAgB;AAAA,UAChB,gBAAgB,SAAS,mBAAmB,SAAS;AAAA,UACrD,UAAU,SAAS;AAAA,QACvB;AAAA,MAEJ,SAAS,OAAY;AACjB,eAAO;AAAA,UACH,QAAQ;AAAA,UACR,OAAO,MAAM,WAAW;AAAA,UACxB,YAAY;AAAA,QAChB;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;","names":[]}
+{"version":3,"sources":["../src/vercel.ts"],"sourcesContent":["import { tool as createVercelTool } from \"ai\";\r\nimport { LetsPing, computeDiff } from \"@letsping/sdk\";\r\nimport { z } from \"zod\";\r\n\r\ninterface AdapterOptions<T extends z.ZodType> {\r\n    name: string;\r\n    description: string;\r\n    schema: T;\r\n    apiKey: string;\r\n    service?: string;\r\n    priority?: \"low\" | \"medium\" | \"high\" | \"critical\";\r\n    timeout?: number;\r\n    handler?: (args: z.infer<T>) => Promise<any> | any;\r\n}\r\n\nexport function letsPing<T extends z.ZodType>(options: AdapterOptions<T>) {\r\n    if (!options.apiKey) {\r\n        throw new Error(\"LetsPing Adapter Error: 'apiKey' is required.\");\r\n    }\r\n\r\n    const lp = new LetsPing(options.apiKey);\r\n\r\n    return createVercelTool({\r\n        description: `${options.description} [SYSTEM NOTE: This tool pauses execution to wait for human approval. Do not expect an immediate result.]`,\r\n        parameters: options.schema,\r\n        execute: async (args) => {\r\n            try {\r\n                const decision = await lp.ask({\r\n                    service: options.service || \"vercel-ai-sdk\",\r\n                    action: options.name,\r\n                    priority: options.priority || \"medium\",\r\n                    payload: args,\r\n                    schema: options.schema,\r\n                    timeoutMs: options.timeout\r\n                });\r\n\r\n                if (decision.status === \"REJECTED\") {\r\n                    return {\r\n                        status: \"REJECTED\",\r\n                        message: \"The human operator explicitly denied this action. Do not proceed.\",\r\n                        metadata: decision.metadata,\r\n                        rejection_reason: (decision as any).rejection_reason || \"No reason provided\"\r\n                    };\r\n                }\r\n\r\n                const executed_input = decision.patched_payload || decision.payload;\r\n                let execution_output;\r\n                if (options.handler) {\r\n                    execution_output = await options.handler(executed_input);\r\n                }\r\n\r\n                if (decision.patched_payload) {\r\n                    const diff = computeDiff(decision.payload, decision.patched_payload);\r\n                    const diff_summary = diff ? { changes: diff } : { changes: \"Unknown structure changes\" };\r\n\r\n                    const letsping_context = {\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,\r\n                        original_input: decision.payload,\r\n                        executed_input,\r\n                        metadata: decision.metadata\r\n                    };\r\n\r\n                    return options.handler ? { letsping_context, execution_output } : letsping_context;\r\n                }\r\n\r\n                const letsping_context = {\r\n                    status: \"APPROVED\",\r\n                    original_input: args,\r\n                    executed_input,\r\n                    metadata: decision.metadata\r\n                };\r\n\r\n                return options.handler ? { letsping_context, execution_output } : letsping_context;\r\n\r\n            } catch (error: any) {\r\n                return {\r\n                    status: \"ERROR\",\r\n                    error: error.message || \"Control plane unreachable or request timed out.\",\r\n                    suggestion: \"Inform the user that the request for approval failed.\"\r\n                };\r\n            }\r\n        },\r\n    });\r\n}"],"mappings":";AAAA,SAAS,QAAQ,wBAAwB;AACzC,SAAS,UAAU,mBAAmB;AAc/B,SAAS,SAA8B,SAA4B;AACtE,MAAI,CAAC,QAAQ,QAAQ;AACjB,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACnE;AAEA,QAAM,KAAK,IAAI,SAAS,QAAQ,MAAM;AAEtC,SAAO,iBAAiB;AAAA,IACpB,aAAa,GAAG,QAAQ,WAAW;AAAA,IACnC,YAAY,QAAQ;AAAA,IACpB,SAAS,OAAO,SAAS;AACrB,UAAI;AACA,cAAM,WAAW,MAAM,GAAG,IAAI;AAAA,UAC1B,SAAS,QAAQ,WAAW;AAAA,UAC5B,QAAQ,QAAQ;AAAA,UAChB,UAAU,QAAQ,YAAY;AAAA,UAC9B,SAAS;AAAA,UACT,QAAQ,QAAQ;AAAA,UAChB,WAAW,QAAQ;AAAA,QACvB,CAAC;AAED,YAAI,SAAS,WAAW,YAAY;AAChC,iBAAO;AAAA,YACH,QAAQ;AAAA,YACR,SAAS;AAAA,YACT,UAAU,SAAS;AAAA,YACnB,kBAAmB,SAAiB,oBAAoB;AAAA,UAC5D;AAAA,QACJ;AAEA,cAAM,iBAAiB,SAAS,mBAAmB,SAAS;AAC5D,YAAI;AACJ,YAAI,QAAQ,SAAS;AACjB,6BAAmB,MAAM,QAAQ,QAAQ,cAAc;AAAA,QAC3D;AAEA,YAAI,SAAS,iBAAiB;AAC1B,gBAAM,OAAO,YAAY,SAAS,SAAS,SAAS,eAAe;AACnE,gBAAM,eAAe,OAAO,EAAE,SAAS,KAAK,IAAI,EAAE,SAAS,4BAA4B;AAEvF,gBAAMA,oBAAmB;AAAA,YACrB,QAAQ;AAAA,YACR,SAAS;AAAA,YACT;AAAA,YACA,gBAAgB,SAAS;AAAA,YACzB;AAAA,YACA,UAAU,SAAS;AAAA,UACvB;AAEA,iBAAO,QAAQ,UAAU,EAAE,kBAAAA,mBAAkB,iBAAiB,IAAIA;AAAA,QACtE;AAEA,cAAM,mBAAmB;AAAA,UACrB,QAAQ;AAAA,UACR,gBAAgB;AAAA,UAChB;AAAA,UACA,UAAU,SAAS;AAAA,QACvB;AAEA,eAAO,QAAQ,UAAU,EAAE,kBAAkB,iBAAiB,IAAI;AAAA,MAEtE,SAAS,OAAY;AACjB,eAAO;AAAA,UACH,QAAQ;AAAA,UACR,OAAO,MAAM,WAAW;AAAA,UACxB,YAAY;AAAA,QAChB;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;","names":["letsping_context"]}

package/package.json

@@ -1,44 +1,44 @@
-{
-    "name": "@letsping/adapters",
-    "version": "0.1.2",
-    "description": "Drop-in Human-in-the-Loop adapters for Vercel AI SDK and LangChain",
-    "files": [
-        "dist"
-    ],
-    "exports": {
-        "./vercel": {
-            "types": "./dist/vercel.d.ts",
-            "import": "./dist/vercel.js",
-            "require": "./dist/vercel.js"
-        },
-        "./langchain": {
-            "types": "./dist/langchain.d.ts",
-            "import": "./dist/langchain.js",
-            "require": "./dist/langchain.js"
-        }
-    },
-    "scripts": {
-        "build": "tsup",
-        "dev": "tsup --watch",
-        "clean": "rm -rf dist .turbo"
-    },
-    "peerDependencies": {
-        "@langchain/core": ">=0.1.0",
-        "ai": ">=2.0.0",
-        "zod": ">=3.0.0"
-    },
-    "dependencies": {
-        "@letsping/sdk": "^0.1.0"
-    },
-    "devDependencies": {
-        "tsup": "^8.0.0",
-        "typescript": "^5.0.0",
-        "@types/node": "^20.0.0",
-        "ai": "^3.0.0",
-        "@langchain/core": "^0.1.0",
-        "zod": "^3.0.0"
-    },
-    "publishConfig": {
-        "access": "public"
-    }
+{
+  "name": "@letsping/adapters",
+  "version": "0.1.5",
+  "description": "LetsPing Framework Adapters for Vercel AI SDK and LangChain",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "./vercel": {
+      "types": "./dist/vercel.d.ts",
+      "import": "./dist/vercel.js",
+      "require": "./dist/vercel.js"
+    },
+    "./langchain": {
+      "types": "./dist/langchain.d.ts",
+      "import": "./dist/langchain.js",
+      "require": "./dist/langchain.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist .turbo"
+  },
+  "peerDependencies": {
+    "@langchain/core": ">=0.1.0",
+    "ai": ">=2.0.0",
+    "zod": ">=3.0.0"
+  },
+  "dependencies": {
+    "@letsping/sdk": "0.1.5"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0",
+    "ai": "^3.0.0",
+    "@langchain/core": "^0.1.0",
+    "zod": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }