opsveritas-sdk 0.4.3 → 0.4.4

package/dist/index.d.mts

@@ -3,6 +3,7 @@ declare function init(apiKey: string, options?: {
     metadataOnly?: boolean;
 }): void;
 
+declare function reportAction(note: string, confirmed?: boolean): void;
 declare function run<T>(agentName: string, fn: () => Promise<T>, opts?: {
     userId?: string;
 }): Promise<T>;
@@ -90,6 +91,7 @@ interface ExecutionPayload {
     error_message?: string | null;
     user_id?: string;
     output_summary?: string;
+    action_confirmed?: boolean;
     /** Set automatically by the SDK so the server can identify SDK vs raw-webhook ingestion. Not user-configurable. */
     source?: 'sdk';
 }
@@ -97,10 +99,11 @@ interface ExecutionPayload {
 declare const OpsVeritas: {
     init: typeof init;
     run: typeof run;
+    reportAction: typeof reportAction;
     trace: typeof trace;
     wrap: typeof wrap;
     langchain: typeof langchain;
     wrapLangChain: typeof wrapLangChain;
 };
 
-export { type ExecutionPayload, type LangChainOptions, OpsVeritas, OpsVeritasKilledError, type TraceOptions, type WrapOptions, OpsVeritas as default, init, langchain, run, trace, wrap, wrapLangChain };
+export { type ExecutionPayload, type LangChainOptions, OpsVeritas, OpsVeritasKilledError, type TraceOptions, type WrapOptions, OpsVeritas as default, init, langchain, reportAction, run, trace, wrap, wrapLangChain };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ declare function init(apiKey: string, options?: {
     metadataOnly?: boolean;
 }): void;
 
+declare function reportAction(note: string, confirmed?: boolean): void;
 declare function run<T>(agentName: string, fn: () => Promise<T>, opts?: {
     userId?: string;
 }): Promise<T>;
@@ -90,6 +91,7 @@ interface ExecutionPayload {
     error_message?: string | null;
     user_id?: string;
     output_summary?: string;
+    action_confirmed?: boolean;
     /** Set automatically by the SDK so the server can identify SDK vs raw-webhook ingestion. Not user-configurable. */
     source?: 'sdk';
 }
@@ -97,10 +99,11 @@ interface ExecutionPayload {
 declare const OpsVeritas: {
     init: typeof init;
     run: typeof run;
+    reportAction: typeof reportAction;
     trace: typeof trace;
     wrap: typeof wrap;
     langchain: typeof langchain;
     wrapLangChain: typeof wrapLangChain;
 };
 
-export { type ExecutionPayload, type LangChainOptions, OpsVeritas, OpsVeritasKilledError, type TraceOptions, type WrapOptions, OpsVeritas as default, init, langchain, run, trace, wrap, wrapLangChain };
+export { type ExecutionPayload, type LangChainOptions, OpsVeritas, OpsVeritasKilledError, type TraceOptions, type WrapOptions, OpsVeritas as default, init, langchain, reportAction, run, trace, wrap, wrapLangChain };

package/dist/index.js

@@ -25,6 +25,7 @@ __export(index_exports, {
   default: () => index_default,
   init: () => init,
   langchain: () => langchain,
+  reportAction: () => reportAction,
   run: () => run,
   trace: () => trace,
   wrap: () => wrap,
@@ -131,6 +132,13 @@ var storage = new import_async_hooks.AsyncLocalStorage();
 function getActiveRun() {
   return storage.getStore();
 }
+function reportAction(note, confirmed = true) {
+  const ctx = getActiveRun();
+  if (!ctx) return;
+  if (note) ctx.actionNotes.push(note);
+  if (confirmed === false) ctx.actionConfirmed = false;
+  else if (ctx.actionConfirmed === void 0) ctx.actionConfirmed = true;
+}
 async function run(agentName, fn, opts) {
   const ctx = {
     agentName,
@@ -138,7 +146,9 @@ async function run(agentName, fn, opts) {
     startTime: Date.now(),
     executedAt: (/* @__PURE__ */ new Date()).toISOString(),
     calls: [],
-    status: "success"
+    status: "success",
+    actionNotes: [],
+    actionConfirmed: void 0
   };
   return storage.run(ctx, async () => {
     try {
@@ -154,7 +164,8 @@ async function run(agentName, fn, opts) {
       const totalCost = ctx.calls.reduce((s, c) => s + (c.costUsd ?? 0), 0);
       const models = [...new Set(ctx.calls.map((c) => c.model).filter((m) => !!m))];
       const platform = ctx.calls[0]?.platform ?? "custom_webhook";
-      const outputSummary = [...ctx.calls].reverse().find((c) => c.outputSummary)?.outputSummary;
+      const callSummary = [...ctx.calls].reverse().find((c) => c.outputSummary)?.outputSummary;
+      const outputSummary = [callSummary, ...ctx.actionNotes].filter(Boolean).join("\n\n") || void 0;
       const payload = {
         platform,
         agent_name: agentName,
@@ -169,6 +180,7 @@ async function run(agentName, fn, opts) {
       if (models.length) payload.models = models;
       if (ctx.userId) payload.user_id = ctx.userId;
       if (outputSummary) payload.output_summary = outputSummary;
+      if (ctx.actionConfirmed !== void 0) payload.action_confirmed = ctx.actionConfirmed;
       void sendExecution(payload);
     }
   });
@@ -776,7 +788,7 @@ function wrapLangChain(model, opts) {
 }
 
 // src/index.ts
-var OpsVeritas = { init, run, trace, wrap, langchain, wrapLangChain };
+var OpsVeritas = { init, run, reportAction, trace, wrap, langchain, wrapLangChain };
 var index_default = OpsVeritas;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -784,6 +796,7 @@ var index_default = OpsVeritas;
   OpsVeritasKilledError,
   init,
   langchain,
+  reportAction,
   run,
   trace,
   wrap,

package/dist/index.mjs

@@ -97,6 +97,13 @@ var storage = new AsyncLocalStorage();
 function getActiveRun() {
   return storage.getStore();
 }
+function reportAction(note, confirmed = true) {
+  const ctx = getActiveRun();
+  if (!ctx) return;
+  if (note) ctx.actionNotes.push(note);
+  if (confirmed === false) ctx.actionConfirmed = false;
+  else if (ctx.actionConfirmed === void 0) ctx.actionConfirmed = true;
+}
 async function run(agentName, fn, opts) {
   const ctx = {
     agentName,
@@ -104,7 +111,9 @@ async function run(agentName, fn, opts) {
     startTime: Date.now(),
     executedAt: (/* @__PURE__ */ new Date()).toISOString(),
     calls: [],
-    status: "success"
+    status: "success",
+    actionNotes: [],
+    actionConfirmed: void 0
   };
   return storage.run(ctx, async () => {
     try {
@@ -120,7 +129,8 @@ async function run(agentName, fn, opts) {
       const totalCost = ctx.calls.reduce((s, c) => s + (c.costUsd ?? 0), 0);
       const models = [...new Set(ctx.calls.map((c) => c.model).filter((m) => !!m))];
       const platform = ctx.calls[0]?.platform ?? "custom_webhook";
-      const outputSummary = [...ctx.calls].reverse().find((c) => c.outputSummary)?.outputSummary;
+      const callSummary = [...ctx.calls].reverse().find((c) => c.outputSummary)?.outputSummary;
+      const outputSummary = [callSummary, ...ctx.actionNotes].filter(Boolean).join("\n\n") || void 0;
       const payload = {
         platform,
         agent_name: agentName,
@@ -135,6 +145,7 @@ async function run(agentName, fn, opts) {
       if (models.length) payload.models = models;
       if (ctx.userId) payload.user_id = ctx.userId;
       if (outputSummary) payload.output_summary = outputSummary;
+      if (ctx.actionConfirmed !== void 0) payload.action_confirmed = ctx.actionConfirmed;
       void sendExecution(payload);
     }
   });
@@ -742,7 +753,7 @@ function wrapLangChain(model, opts) {
 }
 
 // src/index.ts
-var OpsVeritas = { init, run, trace, wrap, langchain, wrapLangChain };
+var OpsVeritas = { init, run, reportAction, trace, wrap, langchain, wrapLangChain };
 var index_default = OpsVeritas;
 export {
   OpsVeritas,
@@ -750,6 +761,7 @@ export {
   index_default as default,
   init,
   langchain,
+  reportAction,
   run,
   trace,
   wrap,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opsveritas-sdk",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Monitor your AI agents in 3 lines of code — tokens, cost, latency, and silent failures",
   "main": "dist/index.js",
   "module": "dist/index.mjs",