@sovara/runner 0.1.1 → 0.3.3

package/dist/trace.js

@@ -0,0 +1,133 @@
+import { buildToolErrorOutput, buildToolSuccessOutput, prepareToolTrace, recordPreparedToolOutput, shouldTraceTool, } from "./toolTraceUtils.js";
+const API_TYPE = "sovara.trace";
+export function trace(first, second) {
+    if (typeof first === "function" && isClassMethodContext(second)) {
+        return makeWrapped(first, undefined, String(second.name));
+    }
+    if (typeof first === "function") {
+        return makeWrapped(first, isTraceOptions(second) ? second : undefined);
+    }
+    if (isTraceOptions(first)) {
+        return (value, ctx) => {
+            if (!isClassMethodContext(ctx)) {
+                return makeWrapped(value, first);
+            }
+            return makeWrapped(value, first, String(ctx.name));
+        };
+    }
+    throw new TypeError("trace expects a function, decorator context, or options object");
+}
+function isTraceOptions(value) {
+    return Boolean(value) && typeof value === "object" && !isClassMethodContext(value);
+}
+function isClassMethodContext(value) {
+    return Boolean(value) && typeof value === "object" && value.kind === "method";
+}
+function isPromiseLike(value) {
+    return (Boolean(value) &&
+        (typeof value === "object" || typeof value === "function") &&
+        typeof value.then === "function");
+}
+function warnTraceFailure() {
+    console.warn("[sovara] Failed to trace decorated function.");
+}
+function resolveToolName(fn, options, contextName) {
+    if (options?.name) {
+        return options.name;
+    }
+    if (fn.name) {
+        return fn.name;
+    }
+    if (contextName) {
+        return contextName;
+    }
+    const constructorName = fn.constructor?.name;
+    return typeof constructorName === "string" && constructorName ? constructorName : "Function";
+}
+function prepareInvocation(args) {
+    const toolCallId = crypto.randomUUID();
+    if (!shouldTraceTool(toolCallId)) {
+        return null;
+    }
+    const toolName = resolveToolName(args.fn, args.options, args.contextName);
+    const toolInput = { args: args.callArgs };
+    const prepared = prepareToolTrace({
+        toolName,
+        toolInput,
+        toolCallId,
+        apiType: API_TYPE,
+        meta: args.options?.meta,
+    }).catch(() => {
+        warnTraceFailure();
+        return null;
+    });
+    return {
+        toolName,
+        toolCallId,
+        meta: args.options?.meta,
+        prepared,
+    };
+}
+async function recordSuccess(invocation, output) {
+    if (!invocation) {
+        return;
+    }
+    const prepared = await invocation.prepared;
+    if (!prepared) {
+        return;
+    }
+    await recordPreparedToolOutput(prepared, buildToolSuccessOutput({
+        toolName: invocation.toolName,
+        toolCallId: invocation.toolCallId,
+        result: output,
+        meta: invocation.meta,
+    }), API_TYPE);
+}
+async function recordError(invocation, error) {
+    if (!invocation) {
+        return;
+    }
+    const prepared = await invocation.prepared;
+    if (!prepared) {
+        return;
+    }
+    await recordPreparedToolOutput(prepared, buildToolErrorOutput({
+        toolName: invocation.toolName,
+        toolCallId: invocation.toolCallId,
+        error,
+    }), API_TYPE);
+}
+function makeWrapped(fn, options, contextName) {
+    const wrapped = function traced(...args) {
+        const invocation = prepareInvocation({ fn, callArgs: args, options, contextName });
+        let result;
+        try {
+            result = fn.apply(this, args);
+        }
+        catch (error) {
+            void recordError(invocation, error).catch(warnTraceFailure);
+            throw error;
+        }
+        if (isPromiseLike(result)) {
+            return (async () => {
+                try {
+                    const value = await result;
+                    await recordSuccess(invocation, value).catch(warnTraceFailure);
+                    return value;
+                }
+                catch (error) {
+                    await recordError(invocation, error).catch(warnTraceFailure);
+                    throw error;
+                }
+            })();
+        }
+        void recordSuccess(invocation, result).catch(warnTraceFailure);
+        return result;
+    };
+    Object.defineProperty(wrapped, "name", {
+        configurable: true,
+        value: fn.name,
+    });
+    return wrapped;
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"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"}

package/dist/user.js

@@ -26,6 +26,6 @@ export async function resolveActiveUser(client, overrides) {
             email,
         };
     }
-    throw new Error("Sovara user setup is missing. Run `so-cli init --user-name <full-name> --user-email <email>` and retry.");
+    throw new Error("Sovara user setup is missing. Run `sovara init --user-name <full-name> --user-email <email>` and retry.");
 }
 //# sourceMappingURL=user.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sovara/runner",
-  "version": "0.1.1",
+  "version": "0.3.3",
   "description": "TypeScript runner for Sovara — wrap a script in a single function to record every LLM call, tool invocation, and log line into a structured run graph.",
   "license": "Apache-2.0",
   "author": "SovaraLabs",
@@ -68,6 +68,7 @@
     "vitest": "^2.1.8"
   },
   "dependencies": {
-    "flat": "^6.0.1"
+    "flat": "^6.0.1",
+    "superjson": "^2.2.6"
   }
 }