@sovara/sdk 0.0.0-stage → 0.9.1

package/dist/mcpPatch.js

@@ -0,0 +1,202 @@
+import { performance } from "node:perf_hooks";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { API_TYPE_MCP_CLIENT_SESSION_SEND_REQUEST } from "./apiTypes.js";
+import { getCurrentTraceScope } from "./context.js";
+import { wrapForStorage } from "./payload/wrap.js";
+import { stableJsonStringify } from "./util/stableJson.js";
+import { sanitizeStackTrace } from "./util/stackTrace.js";
+import { warnOnce } from "./util/logger.js";
+const MCP_API_TYPE = API_TYPE_MCP_CLIENT_SESSION_SEND_REQUEST;
+const MCP_PATCHED_SYMBOL = Symbol.for("sovara.mcpCallToolPatched");
+const MCP_PATCHING_SYMBOL = Symbol.for("sovara.mcpCallToolPatching");
+const MCP_CLIENT_PROTOTYPE_PATCHED_SYMBOL = Symbol.for("sovara.mcpClientPrototypePatched");
+const MCP_CLIENT_SPECIFIER = "@modelcontextprotocol/sdk/client/index.js";
+const DEBUG_MCP_PATCH = process.env.SOVARA_DEBUG_MCP_PATCH === "1";
+function isCallToolParams(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    return typeof value.name === "string";
+}
+function buildErrorPayload(error) {
+    return stableJsonStringify({
+        kind: "exception",
+        source: MCP_API_TYPE,
+        message: error instanceof Error ? error.message : String(error),
+        type: error instanceof Error ? error.name : "Error",
+        details: {},
+    });
+}
+function cjsPathToEsmPath(resolvedPath) {
+    const marker = `${path.sep}dist${path.sep}cjs${path.sep}`;
+    const replacement = `${path.sep}dist${path.sep}esm${path.sep}`;
+    if (resolvedPath.includes(marker)) {
+        return resolvedPath.replace(marker, replacement);
+    }
+    return resolvedPath;
+}
+function buildModuleCandidateSpecifiers() {
+    const candidates = new Set();
+    try {
+        candidates.add(import.meta.resolve(MCP_CLIENT_SPECIFIER));
+    }
+    catch {
+        // ignore
+    }
+    try {
+        const cwdEntry = path.join(process.cwd(), "__sovara_mcp_patch__.js");
+        const resolver = createRequire(cwdEntry);
+        const resolvedCjsPath = resolver.resolve(MCP_CLIENT_SPECIFIER);
+        candidates.add(pathToFileURL(resolvedCjsPath).href);
+        candidates.add(pathToFileURL(cjsPathToEsmPath(resolvedCjsPath)).href);
+    }
+    catch {
+        // ignore
+    }
+    candidates.add(MCP_CLIENT_SPECIFIER);
+    const out = Array.from(candidates);
+    if (DEBUG_MCP_PATCH) {
+        console.error("[sovara:mcp] candidate module specifier count:", out.length);
+    }
+    return out;
+}
+function patchClientPrototype(clientPrototype) {
+    if (!clientPrototype ||
+        clientPrototype[MCP_CLIENT_PROTOTYPE_PATCHED_SYMBOL] ||
+        typeof clientPrototype.callTool !== "function") {
+        return false;
+    }
+    const originalCallTool = clientPrototype.callTool;
+    const patchedCallTool = async function patchedCallTool(...args) {
+        const scope = getCurrentTraceScope();
+        const params = args[0];
+        if (!scope ||
+            !isCallToolParams(params) ||
+            typeof scope.client.prepareCall !== "function" ||
+            typeof scope.client.recordOutput !== "function" ||
+            typeof scope.client.recordException !== "function") {
+            return originalCallTool.apply(this, args);
+        }
+        const stackTrace = sanitizeStackTrace(new Error().stack);
+        const wrappedInput = wrapForStorage({
+            root: {
+                method: "tools/call",
+                params,
+            },
+        });
+        const inputJson = stableJsonStringify(wrappedInput);
+        const startedAt = performance.now();
+        let preparedCall = null;
+        try {
+            const prepared = await scope.client.prepareCall({
+                credentials: scope.credentials,
+                turnId: scope.turnId,
+                inputJson,
+                apiType: MCP_API_TYPE,
+                stackTrace,
+                promptBearingSuffixJson: "[]",
+                prepareRuntimeLessons: true,
+                lessonScopePaths: scope.lessonScopePaths,
+            });
+            preparedCall = {
+                stepUuid: prepared.stepUuid,
+                stepKind: prepared.stepKind ?? null,
+                preparedInputJson: prepared.preparedInputJson ?? inputJson,
+                suffixKeysJson: prepared.suffixKeysJson ?? "[]",
+                promptBearingSuffixJson: prepared.promptBearingSuffixJson ?? "[]",
+            };
+        }
+        catch {
+            warnOnce("mcp-patch-prepare", "[sovara] Failed to prepare MCP call.");
+            return originalCallTool.apply(this, args);
+        }
+        try {
+            const result = await originalCallTool.apply(this, args);
+            const outputJson = stableJsonStringify(wrapForStorage(result));
+            await scope.client.recordOutput({
+                credentials: scope.credentials,
+                turnId: scope.turnId,
+                stepUuid: preparedCall.stepUuid,
+                apiType: MCP_API_TYPE,
+                inputJson: preparedCall.preparedInputJson,
+                outputJson,
+                latencySeconds: Math.max(0, (performance.now() - startedAt) / 1000),
+                stackTrace,
+                stepKind: preparedCall.stepKind,
+                suffixKeysJson: preparedCall.suffixKeysJson,
+                promptBearingSuffixJson: preparedCall.promptBearingSuffixJson,
+            });
+            return result;
+        }
+        catch (error) {
+            await scope.client
+                .recordException({
+                credentials: scope.credentials,
+                turnId: scope.turnId,
+                stepUuid: preparedCall.stepUuid,
+                apiType: MCP_API_TYPE,
+                inputJson: preparedCall.preparedInputJson,
+                errorJson: buildErrorPayload(error),
+                latencySeconds: Math.max(0, (performance.now() - startedAt) / 1000),
+                stackTrace,
+                stepKind: preparedCall.stepKind,
+                suffixKeysJson: preparedCall.suffixKeysJson,
+                promptBearingSuffixJson: preparedCall.promptBearingSuffixJson,
+                clearOutput: true,
+            })
+                .catch(() => {
+                warnOnce("mcp-patch-record-exception", "[sovara] Failed to finalize MCP exception.");
+            });
+            throw error;
+        }
+    };
+    clientPrototype.callTool = patchedCallTool;
+    clientPrototype[MCP_CLIENT_PROTOTYPE_PATCHED_SYMBOL] = true;
+    if (DEBUG_MCP_PATCH) {
+        console.error("[sovara:mcp] patched MCP Client.prototype.callTool");
+    }
+    return true;
+}
+export async function ensureMcpPatchInstalled() {
+    const globalObject = globalThis;
+    if (globalObject[MCP_PATCHED_SYMBOL]) {
+        return;
+    }
+    if (globalObject[MCP_PATCHING_SYMBOL]) {
+        return globalObject[MCP_PATCHING_SYMBOL];
+    }
+    globalObject[MCP_PATCHING_SYMBOL] = (async () => {
+        let installedAny = false;
+        const candidates = buildModuleCandidateSpecifiers();
+        for (const specifier of candidates) {
+            try {
+                const mod = (await import(specifier));
+                const ClientCtor = mod?.Client;
+                if (patchClientPrototype(ClientCtor?.prototype)) {
+                    installedAny = true;
+                }
+            }
+            catch {
+                // keep trying other candidate module copies
+                if (DEBUG_MCP_PATCH) {
+                    console.error("[sovara:mcp] failed to import candidate");
+                }
+            }
+        }
+        if (installedAny) {
+            globalObject[MCP_PATCHED_SYMBOL] = true;
+        }
+        else if (DEBUG_MCP_PATCH) {
+            console.error("[sovara:mcp] no MCP client prototype was patched");
+        }
+    })();
+    try {
+        await globalObject[MCP_PATCHING_SYMBOL];
+    }
+    finally {
+        delete globalObject[MCP_PATCHING_SYMBOL];
+    }
+}
+//# sourceMappingURL=mcpPatch.js.map

package/dist/mcpPatch.js.map

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

package/dist/openaiAgentsPatch.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureOpenAIAgentsPatchInstalled(): Promise<void>;
+//# sourceMappingURL=openaiAgentsPatch.d.ts.map

package/dist/openaiAgentsPatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiAgentsPatch.d.ts","sourceRoot":"","sources":["../src/openaiAgentsPatch.ts"],"names":[],"mappings":"AAwJA,wBAAgB,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBhE"}

package/dist/openaiAgentsPatch.js

@@ -0,0 +1,112 @@
+import { randomUUID } from "node:crypto";
+import { API_TYPE_OPENAI_AGENTS_FUNCTION_TOOL_RUN } from "./apiTypes.js";
+import { getCurrentTraceScope } from "./context.js";
+import { buildToolErrorOutput, buildToolSuccessOutput, prepareToolTrace, recordPreparedToolOutput, } from "./toolTraceUtils.js";
+import { warnOnce } from "./util/logger.js";
+const AGENT_PATCHED_SYMBOL = Symbol.for("sovara.openAIAgentsAgentPatched");
+const TOOL_PATCHED_SYMBOL = Symbol.for("sovara.openAIAgentsFunctionToolPatched");
+let installPromise;
+function parseToolInput(input) {
+    if (!input) {
+        return {};
+    }
+    try {
+        return JSON.parse(input);
+    }
+    catch {
+        return input;
+    }
+}
+function preparedToolInput(preparedRawInput, fallback) {
+    if (!preparedRawInput || typeof preparedRawInput !== "object" || Array.isArray(preparedRawInput)) {
+        return fallback;
+    }
+    const input = preparedRawInput.tool_input;
+    return input === undefined ? fallback : input;
+}
+function patchFunctionTool(tool) {
+    if (!tool ||
+        typeof tool !== "object" ||
+        tool.type !== "function" ||
+        typeof tool.invoke !== "function") {
+        return;
+    }
+    const functionTool = tool;
+    if (functionTool[TOOL_PATCHED_SYMBOL]) {
+        return;
+    }
+    const originalInvoke = functionTool.invoke;
+    functionTool.invoke = async function sovaraPatchedFunctionTool(runContext, input, details) {
+        if (!getCurrentTraceScope()) {
+            return originalInvoke.call(this, runContext, input, details);
+        }
+        const toolCallId = details?.toolCall?.callId || randomUUID();
+        const toolInput = parseToolInput(input);
+        let prepared;
+        try {
+            prepared = await prepareToolTrace({
+                toolName: functionTool.name,
+                toolInput,
+                toolCallId,
+                apiType: API_TYPE_OPENAI_AGENTS_FUNCTION_TOOL_RUN,
+            });
+        }
+        catch {
+            warnOnce("openai-agents-tool-prepare", "[sovara] Failed to prepare OpenAI Agents tool call.");
+            return originalInvoke.call(this, runContext, input, details);
+        }
+        const executedToolInput = preparedToolInput(prepared.preparedCall.preparedRawInput, toolInput);
+        const executedInput = JSON.stringify(executedToolInput);
+        if (details?.toolCall) {
+            details.toolCall.arguments = executedInput;
+        }
+        try {
+            const result = await originalInvoke.call(this, runContext, executedInput, details);
+            await recordPreparedToolOutput(prepared, buildToolSuccessOutput({ toolName: functionTool.name, toolCallId, result }), API_TYPE_OPENAI_AGENTS_FUNCTION_TOOL_RUN).catch(() => {
+                warnOnce("openai-agents-tool-output", "[sovara] Failed to record OpenAI Agents tool output.");
+            });
+            return result;
+        }
+        catch (error) {
+            await recordPreparedToolOutput(prepared, buildToolErrorOutput({ toolName: functionTool.name, toolCallId, error }), API_TYPE_OPENAI_AGENTS_FUNCTION_TOOL_RUN).catch(() => {
+                warnOnce("openai-agents-tool-error", "[sovara] Failed to record OpenAI Agents tool error.");
+            });
+            throw error;
+        }
+    };
+    Object.defineProperty(functionTool, TOOL_PATCHED_SYMBOL, { value: true });
+}
+function patchAgentConstructor(AgentClass) {
+    const prototype = AgentClass.prototype;
+    if (prototype[AGENT_PATCHED_SYMBOL]) {
+        return;
+    }
+    const originalGetAllTools = prototype.getAllTools;
+    if (typeof originalGetAllTools !== "function") {
+        throw new TypeError("OpenAI Agents Agent.getAllTools() is unavailable.");
+    }
+    prototype.getAllTools = async function sovaraPatchedGetAllTools(runContext) {
+        for (const tool of this.tools) {
+            patchFunctionTool(tool);
+        }
+        return originalGetAllTools.call(this, runContext);
+    };
+    Object.defineProperty(prototype, AGENT_PATCHED_SYMBOL, { value: true });
+}
+export function ensureOpenAIAgentsPatchInstalled() {
+    installPromise ??= import("@openai/agents")
+        .then((module) => {
+        patchAgentConstructor(module.Agent);
+    })
+        .catch((error) => {
+        const code = error && typeof error === "object"
+            ? error.code
+            : undefined;
+        if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {
+            return;
+        }
+        warnOnce("openai-agents-patch", "[sovara] Failed to install OpenAI Agents tool patch.");
+    });
+    return installPromise;
+}
+//# sourceMappingURL=openaiAgentsPatch.js.map

package/dist/openaiAgentsPatch.js.map

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

package/dist/payload/editIoExcludePatterns.json

@@ -0,0 +1,322 @@
+[
+  {
+    "pattern": "^_.*"
+  },
+  {
+    "pattern": "^sse(\\.|$)"
+  },
+  {
+    "pattern": "^ndjson(\\.|$)"
+  },
+  {
+    "pattern": "(^|.*\\.)[^.]*encrypted[^.]*($|\\.)",
+    "flags": "i"
+  },
+  {
+    "pattern": "^url$"
+  },
+  {
+    "pattern": "(^|.*\\.)(?:urls)(?:\\.|$)"
+  },
+  {
+    "pattern": "(^|.*\\.)(?:[^.]+_url|[^.]+Url)$"
+  },
+  {
+    "pattern": "^max_tokens$"
+  },
+  {
+    "pattern": "^stream$"
+  },
+  {
+    "pattern": "^temperature$"
+  },
+  {
+    "pattern": "^metadata\\.user_id$"
+  },
+  {
+    "pattern": "^thinking(\\.|$)"
+  },
+  {
+    "pattern": "^context_management(\\.|$)"
+  },
+  {
+    "pattern": "^output_config\\.(?!effort$).+"
+  },
+  {
+    "pattern": "^body\\.metadata\\.user_id$"
+  },
+  {
+    "pattern": "^body\\.thinking(\\.|$)"
+  },
+  {
+    "pattern": "^body\\.context_management(\\.|$)"
+  },
+  {
+    "pattern": "^body\\.output_config\\.(?!effort$).+"
+  },
+  {
+    "pattern": "^body\\.attribution(\\.|$)"
+  },
+  {
+    "pattern": "^body\\.(?:requestPriority|bypassCaching|traceContext|sessionId)$"
+  },
+  {
+    "pattern": "^body\\.request\\.type$"
+  },
+  {
+    "pattern": "^body\\.request\\.gptChat\\.(?:reasoningEffort|temperature|top_p|n|stop|max_tokens|presence_penalty|frequency_penalty|logit_bias|seed|response_format|tool_choice)$"
+  },
+  {
+    "pattern": "^body\\.request\\.generic\\.(?!prompt$).+"
+  },
+  {
+    "pattern": "^body\\.stream$"
+  },
+  {
+    "pattern": "^body\\.contents\\.\\d+\\.parts\\.\\d+\\.thoughtSignature$"
+  },
+  {
+    "pattern": "^body\\.messages\\.\\d+\\.content\\.\\d+\\.signature$"
+  },
+  {
+    "pattern": "^body\\.inferenceConfig\\.(maxTokens|temperature)$"
+  },
+  {
+    "pattern": "^content\\.id$"
+  },
+  {
+    "pattern": "^content\\.type$"
+  },
+  {
+    "pattern": "^content\\.object$"
+  },
+  {
+    "pattern": "^content\\.created(_at)?$"
+  },
+  {
+    "pattern": "^content\\.completed_at$"
+  },
+  {
+    "pattern": "^content\\.model$"
+  },
+  {
+    "pattern": "^content\\.modelVersion$"
+  },
+  {
+    "pattern": "^content\\.status$"
+  },
+  {
+    "pattern": "^content\\.background$"
+  },
+  {
+    "pattern": "^content\\.context(\\.|$)"
+  },
+  {
+    "pattern": "^content\\.error$"
+  },
+  {
+    "pattern": "^content\\.instructions$"
+  },
+  {
+    "pattern": "^content\\.metadata"
+  },
+  {
+    "pattern": "^content\\.moderation$"
+  },
+  {
+    "pattern": "^content\\.request_id$"
+  },
+  {
+    "pattern": "^content\\.usage"
+  },
+  {
+    "pattern": "^content\\.service_tier$"
+  },
+  {
+    "pattern": "^content\\.system_fingerprint$"
+  },
+  {
+    "pattern": "^content\\.stop_sequence$"
+  },
+  {
+    "pattern": "^content\\.billing"
+  },
+  {
+    "pattern": "^content\\.max_output_tokens$"
+  },
+  {
+    "pattern": "^content\\.max_tool_calls$"
+  },
+  {
+    "pattern": "^content\\.createTime$"
+  },
+  {
+    "pattern": "^content\\.frequency_penalty$"
+  },
+  {
+    "pattern": "^content\\.incomplete_details(\\.|$)"
+  },
+  {
+    "pattern": "^content\\.parallel_tool_calls$"
+  },
+  {
+    "pattern": "^content\\.presence_penalty$"
+  },
+  {
+    "pattern": "^content\\.previous_response_id$"
+  },
+  {
+    "pattern": "^content\\.prompt_cache"
+  },
+  {
+    "pattern": "^content\\.reasoning\\.(effort|summary)$"
+  },
+  {
+    "pattern": "^content\\.safety_identifier$"
+  },
+  {
+    "pattern": "^content\\.signature$"
+  },
+  {
+    "pattern": "^content\\.store$"
+  },
+  {
+    "pattern": "^content\\.temperature$"
+  },
+  {
+    "pattern": "^content\\.text\\.(format\\.type|verbosity)$"
+  },
+  {
+    "pattern": "^content\\.tool_choice$"
+  },
+  {
+    "pattern": "^content\\.tools(\\.|$)"
+  },
+  {
+    "pattern": "^content\\.top_(logprobs|p)$"
+  },
+  {
+    "pattern": "^content\\.truncation$"
+  },
+  {
+    "pattern": "^content\\.user$"
+  },
+  {
+    "pattern": "^content\\.responseId$"
+  },
+  {
+    "pattern": "^content\\.metrics(\\.|$)"
+  },
+  {
+    "pattern": "^content\\.stopReason$"
+  },
+  {
+    "pattern": "^content\\.\\d+\\.signature$"
+  },
+  {
+    "pattern": "^content\\.content\\.\\d+\\.(type|id|signature)$"
+  },
+  {
+    "pattern": "^content\\.content\\.\\d+\\.content\\.\\d+\\.type$"
+  },
+  {
+    "pattern": "^content\\.choices\\.\\d+\\.index$"
+  },
+  {
+    "pattern": "^content\\.choices\\.\\d+\\.finish_reason$"
+  },
+  {
+    "pattern": "^content\\.choices\\.\\d+\\.message\\.(refusal|annotations|reasoning)$"
+  },
+  {
+    "pattern": "^content\\.choices\\.\\d+\\.(logprobs|seed)$"
+  },
+  {
+    "pattern": "^content\\.gptChat\\.(?:id|object|created|model)$"
+  },
+  {
+    "pattern": "^content\\.[^.]+\\.(?:usage|usageMetadata)"
+  },
+  {
+    "pattern": "^content\\.gptChat\\.choices\\.\\d+\\.(?:index|finish_reason)$"
+  },
+  {
+    "pattern": "^content\\.output\\.\\d+\\.(id|type|status)$"
+  },
+  {
+    "pattern": "^content\\.output\\.\\d+\\.content\\.\\d+\\.(type|annotations|logprobs)$"
+  },
+  {
+    "pattern": "^content\\.candidates\\.\\d+\\.avgLogprobs$"
+  },
+  {
+    "pattern": "^content\\.candidates\\.\\d+\\.(finishReason|index)$"
+  },
+  {
+    "pattern": "^content\\.candidates\\.\\d+\\.content\\.parts\\.\\d+\\.thoughtSignature$"
+  },
+  {
+    "pattern": "^content\\.usageMetadata"
+  },
+  {
+    "pattern": "^tools\\.\\d+\\.parameters\\.(additionalProperties|properties|required|type)$"
+  },
+  {
+    "pattern": "^tools\\.\\d+\\.strict$"
+  },
+  {
+    "pattern": "^content\\.done$"
+  },
+  {
+    "pattern": "^content\\.done_reason$"
+  },
+  {
+    "pattern": "^content\\.eval_count$"
+  },
+  {
+    "pattern": "^content\\.eval_duration$"
+  },
+  {
+    "pattern": "^content\\.load_duration$"
+  },
+  {
+    "pattern": "^content\\.prompt_eval_count$"
+  },
+  {
+    "pattern": "^content\\.prompt_eval_duration$"
+  },
+  {
+    "pattern": "^content\\.total_duration$"
+  },
+  {
+    "pattern": "^headers(\\.|$)",
+    "flags": "i"
+  },
+  {
+    "pattern": "^client_message(_type)?(\\.|$)"
+  },
+  {
+    "pattern": "^content\\.output_transcription_segments(\\.|$)"
+  },
+  {
+    "pattern": "^protocol$"
+  },
+  {
+    "pattern": "^server_messages(\\.|$)"
+  },
+  {
+    "pattern": "^setup(\\.|$)"
+  },
+  {
+    "pattern": "^uri$"
+  },
+  {
+    "pattern": "^request_headers(\\.|$)"
+  },
+  {
+    "pattern": "^(method|path|pool_(host|port|scheme))$"
+  },
+  {
+    "pattern": "^(reason|reason_phrase|request_url|status|status_code|version|version_string)$"
+  }
+]

package/dist/payload/filterDict.d.ts

@@ -0,0 +1,3 @@
+export declare function shouldExcludeKey(key: string): boolean;
+export declare function filterDict(input: unknown): Record<string, unknown>;
+//# sourceMappingURL=filterDict.d.ts.map

package/dist/payload/filterDict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterDict.d.ts","sourceRoot":"","sources":["../../src/payload/filterDict.ts"],"names":[],"mappings":"AAiBA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBlE"}