@once-agent/sdk 0.1.11 → 0.1.12

package/dist/openai-agents-execution-observer.js

@@ -0,0 +1,163 @@
+import { executionToolFingerprint, observeToolExecution, } from "./execution-observation.js";
+import { discoverOpenAIAgentRuntime, } from "./runtime-tool-discovery.js";
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function ownDataValue(value, key) {
+    const record = asRecord(value);
+    if (!record)
+        return undefined;
+    const descriptor = Object.getOwnPropertyDescriptor(record, key);
+    return descriptor && "value" in descriptor
+        ? descriptor.value
+        : undefined;
+}
+function ownString(value, key) {
+    const raw = ownDataValue(value, key);
+    return typeof raw === "string" && raw.trim() !== ""
+        ? raw
+        : undefined;
+}
+function agentTools(agent) {
+    const tools = ownDataValue(agent, "tools");
+    return Array.isArray(tools) ? tools : [];
+}
+function safeAgentSnapshot(agent) {
+    const name = ownString(agent, "name");
+    const tools = agentTools(agent);
+    const mcpServers = ownDataValue(agent, "mcpServers");
+    const mcpConfig = ownDataValue(agent, "mcpConfig");
+    return discoverOpenAIAgentRuntime({
+        ...(name ? { name } : {}),
+        tools,
+        ...(Array.isArray(mcpServers) ? { mcpServers } : {}),
+        ...(mcpConfig && typeof mcpConfig === "object" ? { mcpConfig } : {}),
+    });
+}
+function findToolArgument(args, byObject) {
+    for (const arg of args) {
+        if (!arg || typeof arg !== "object")
+            continue;
+        const observation = byObject.get(arg);
+        if (observation) {
+            return {
+                raw: arg,
+                observation,
+            };
+        }
+    }
+    return undefined;
+}
+function callIdFromArgs(args) {
+    for (let index = args.length - 1; index >= 0; index--) {
+        const details = args[index];
+        const toolCall = ownDataValue(details, "toolCall");
+        const callId = ownString(toolCall, "callId");
+        if (callId)
+            return callId;
+    }
+    return undefined;
+}
+/**
+ * Build dependency-free OpenAI Agents lifecycle handlers for execution evidence.
+ *
+ * The returned callbacks are meant to be registered with either an Agent or a
+ * Runner `agent_tool_start` / `agent_tool_end` hook. This helper never registers
+ * itself, never invokes a tool, and never reads tool arguments/results/context.
+ *
+ * `agent_tool_end` is proof that the tool lifecycle reached the end hook, so it
+ * can establish EXECUTED evidence. The v1 adapter records outcome as UNKNOWN:
+ * framework end hooks alone are not treated as authoritative proof that an
+ * external side effect succeeded.
+ */
+export function createOpenAIAgentsExecutionObserver(agent) {
+    const rawTools = agentTools(agent);
+    const snapshot = safeAgentSnapshot(agent);
+    const byObject = new WeakMap();
+    for (const observation of snapshot.tools) {
+        const index = observation.origin.index;
+        const raw = rawTools[index];
+        if (raw && typeof raw === "object") {
+            byObject.set(raw, observation);
+        }
+    }
+    const pendingByCallId = new Map();
+    const pendingWithoutCallId = new WeakMap();
+    const collected = [];
+    let pendingWithoutIdCount = 0;
+    const onToolStart = (...args) => {
+        const match = findToolArgument(args, byObject);
+        if (!match)
+            return;
+        const callId = callIdFromArgs(args);
+        const pending = {
+            tool: match.observation,
+            startedAtMs: Date.now(),
+            ...(callId ? { callId } : {}),
+        };
+        if (callId) {
+            pendingByCallId.set(callId, pending);
+            return;
+        }
+        const queue = pendingWithoutCallId.get(match.raw) ?? [];
+        queue.push(pending);
+        pendingWithoutCallId.set(match.raw, queue);
+        pendingWithoutIdCount += 1;
+    };
+    const onToolEnd = (...args) => {
+        const match = findToolArgument(args, byObject);
+        if (!match)
+            return;
+        const callId = callIdFromArgs(args);
+        let pending;
+        if (callId) {
+            pending = pendingByCallId.get(callId);
+            pendingByCallId.delete(callId);
+        }
+        else {
+            const queue = pendingWithoutCallId.get(match.raw);
+            pending = queue?.shift();
+            if (pending)
+                pendingWithoutIdCount -= 1;
+            if (queue && queue.length === 0) {
+                pendingWithoutCallId.delete(match.raw);
+            }
+        }
+        const tool = pending?.tool ?? match.observation;
+        const now = Date.now();
+        const durationMs = pending
+            ? Math.max(0, now - pending.startedAtMs)
+            : undefined;
+        const result = observeToolExecution({
+            ...(callId ? { eventId: `openai-tool-call:${callId}` } : {}),
+            toolId: tool.toolId,
+            namespacedName: tool.namespacedName,
+            descriptorFingerprint: executionToolFingerprint(tool),
+            canonicalName: tool.canonicalName,
+            framework: tool.framework,
+            runtimeName: tool.origin.agentName,
+            source: "framework_callback",
+            status: "UNKNOWN",
+            observedAt: new Date(now).toISOString(),
+            ...(durationMs !== undefined ? { durationMs } : {}),
+        });
+        if (result.accepted) {
+            collected.push(result.event);
+        }
+    };
+    return Object.freeze({
+        snapshot,
+        onToolStart,
+        onToolEnd,
+        events: () => Object.freeze([...collected]),
+        drain: () => {
+            const drained = Object.freeze([...collected]);
+            collected.length = 0;
+            return drained;
+        },
+        pendingCount: () => pendingByCallId.size + pendingWithoutIdCount,
+    });
+}
+//# sourceMappingURL=openai-agents-execution-observer.js.map

package/dist/openai-agents-execution-observer.js.map

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

package/dist/otel-execution-observer.d.ts

@@ -0,0 +1,16 @@
+import { type ExecutionPromotableTool, type ToolExecutionObservation } from "./execution-observation.js";
+/**
+ * Ingest already-materialized OpenTelemetry GenAI tool-execution spans.
+ *
+ * Only spans with `gen_ai.operation.name=execute_tool` are considered. The
+ * implementation deliberately reads a tiny allowlist of low-risk attributes
+ * and never reads `gen_ai.tool.call.arguments`, `gen_ai.tool.call.result`,
+ * exception messages/stacks, prompts, provider/model metadata, results or
+ * other content-bearing fields.
+ *
+ * Generic OTel tool spans commonly identify tools by name. Therefore a name
+ * must resolve to exactly one caller-supplied Tool Graph observation; duplicate
+ * names fail closed instead of being correlated by array order.
+ */
+export declare function observeOtelGenAiToolExecutions(spans: readonly unknown[], tools: readonly ExecutionPromotableTool[]): readonly ToolExecutionObservation[];
+//# sourceMappingURL=otel-execution-observer.d.ts.map

package/dist/otel-execution-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-execution-observer.d.ts","sourceRoot":"","sources":["../src/otel-execution-observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAmGpC;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,KAAK,EAAE,SAAS,uBAAuB,EAAE,GACxC,SAAS,wBAAwB,EAAE,CAsCrC"}

package/dist/otel-execution-observer.js

@@ -0,0 +1,129 @@
+import { executionToolFingerprint, observeToolExecution, } from "./execution-observation.js";
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function ownDataValue(value, key) {
+    const record = asRecord(value);
+    if (!record)
+        return undefined;
+    const descriptor = Object.getOwnPropertyDescriptor(record, key);
+    return descriptor && "value" in descriptor
+        ? descriptor.value
+        : undefined;
+}
+function ownString(value, key) {
+    const raw = ownDataValue(value, key);
+    return typeof raw === "string" && raw.trim() !== ""
+        ? raw
+        : undefined;
+}
+function attributesOf(span) {
+    const raw = ownDataValue(span, "attributes");
+    return asRecord(raw);
+}
+function attrString(attributes, key) {
+    if (!attributes)
+        return undefined;
+    const descriptor = Object.getOwnPropertyDescriptor(attributes, key);
+    if (!descriptor || !("value" in descriptor))
+        return undefined;
+    return typeof descriptor.value === "string" && descriptor.value.trim() !== ""
+        ? descriptor.value
+        : undefined;
+}
+function toolIndex(tools) {
+    const map = new Map();
+    for (const tool of tools) {
+        const current = map.get(tool.canonicalName);
+        if (current === undefined) {
+            map.set(tool.canonicalName, tool);
+        }
+        else {
+            // Generic OTel spans commonly identify the tool by name only. If the
+            // caller supplies multiple same-named candidates, fail closed rather
+            // than choosing one by order.
+            map.set(tool.canonicalName, null);
+        }
+    }
+    return map;
+}
+function spanStatus(span, attributes) {
+    // Only presence matters; the value itself is intentionally not retained.
+    if (attrString(attributes, "error.type"))
+        return "FAILED";
+    const status = ownDataValue(span, "status");
+    const statusRecord = asRecord(status);
+    const rawCode = statusRecord
+        ? ownDataValue(statusRecord, "code")
+        : status;
+    if (rawCode === 2 || rawCode === "ERROR")
+        return "FAILED";
+    if (rawCode === 1 || rawCode === "OK")
+        return "SUCCEEDED";
+    return "UNKNOWN";
+}
+function spanEventId(span, attributes) {
+    const traceId = ownString(span, "traceId");
+    const spanId = ownString(span, "spanId");
+    if (traceId && spanId) {
+        return `otel-span:${traceId}:${spanId}`;
+    }
+    const callId = attrString(attributes, "gen_ai.tool.call.id");
+    return callId ? `otel-tool-call:${callId}` : undefined;
+}
+function durationMs(span) {
+    const raw = ownDataValue(span, "durationMs");
+    return typeof raw === "number" && Number.isFinite(raw) && raw >= 0
+        ? raw
+        : undefined;
+}
+/**
+ * Ingest already-materialized OpenTelemetry GenAI tool-execution spans.
+ *
+ * Only spans with `gen_ai.operation.name=execute_tool` are considered. The
+ * implementation deliberately reads a tiny allowlist of low-risk attributes
+ * and never reads `gen_ai.tool.call.arguments`, `gen_ai.tool.call.result`,
+ * exception messages/stacks, prompts, provider/model metadata, results or
+ * other content-bearing fields.
+ *
+ * Generic OTel tool spans commonly identify tools by name. Therefore a name
+ * must resolve to exactly one caller-supplied Tool Graph observation; duplicate
+ * names fail closed instead of being correlated by array order.
+ */
+export function observeOtelGenAiToolExecutions(spans, tools) {
+    const byName = toolIndex(tools);
+    const events = [];
+    for (const span of spans) {
+        const attributes = attributesOf(span);
+        if (attrString(attributes, "gen_ai.operation.name") !== "execute_tool") {
+            continue;
+        }
+        const toolName = attrString(attributes, "gen_ai.tool.name");
+        if (!toolName)
+            continue;
+        const tool = byName.get(toolName);
+        if (!tool)
+            continue;
+        const eventId = spanEventId(span, attributes);
+        const duration = durationMs(span);
+        const observedAt = ownString(span, "endTime") ?? new Date().toISOString();
+        const observed = observeToolExecution({
+            ...(eventId ? { eventId } : {}),
+            toolId: tool.toolId,
+            namespacedName: tool.namespacedName,
+            descriptorFingerprint: executionToolFingerprint(tool),
+            canonicalName: tool.canonicalName,
+            source: "otel",
+            status: spanStatus(span, attributes),
+            observedAt,
+            ...(duration !== undefined ? { durationMs: duration } : {}),
+        });
+        if (observed.accepted) {
+            events.push(observed.event);
+        }
+    }
+    return Object.freeze(events);
+}
+//# sourceMappingURL=otel-execution-observer.js.map

package/dist/otel-execution-observer.js.map

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

package/dist/runtime-tool-discovery.d.ts

@@ -0,0 +1,86 @@
+import { type ToolImportanceAssessment } from "./tool-importance.js";
+export type RuntimeToolFramework = "openai-agents" | "openai-responses" | "vercel-ai-sdk";
+export type RuntimeToolSource = "agent.tools" | "responses.tools" | "vercel.toolset" | "vercel.generation.tools";
+export type RuntimeToolObservation = {
+    toolId: string;
+    namespacedName: string;
+    canonicalName: string;
+    displayName: string;
+    description: string;
+    toolType: string;
+    framework: RuntimeToolFramework;
+    origin: {
+        kind: "runtime";
+        source: RuntimeToolSource;
+        agentName?: string;
+        runtimeName?: string;
+        index: number;
+    };
+    evidence: {
+        level: "RUNTIME_REGISTERED" | "MODEL_VISIBLE";
+        source: string;
+    };
+    visibility: {
+        configured: boolean;
+        runtimeRegistered: boolean;
+        modelVisible: boolean;
+        executed: false;
+    };
+    inputSchema?: unknown;
+    safeMetadata?: {
+        serverLabel?: string;
+        namespace?: string;
+        deferLoading?: boolean;
+        autoExecutable?: boolean;
+        schemaOpaque?: boolean;
+        providerDefined?: boolean;
+    };
+    once: ToolImportanceAssessment;
+};
+export type OpenAIAgentRuntimeSnapshot = {
+    framework: "openai-agents";
+    agentName?: string;
+    registeredToolCount: number;
+    configuredMcpServerCount: number;
+    includeServerInToolNames?: boolean;
+    tools: RuntimeToolObservation[];
+    externalCallsMade: false;
+    toolInvocationsMade: false;
+    secretValuesRetained: false;
+};
+export type OpenAIResponsesToolSnapshot = {
+    framework: "openai-responses";
+    modelVisibleToolCount: number;
+    tools: RuntimeToolObservation[];
+    externalCallsMade: false;
+    toolInvocationsMade: false;
+    secretValuesRetained: false;
+};
+export type VercelAiSdkRegisteredToolSnapshot = {
+    framework: "vercel-ai-sdk";
+    runtimeName?: string;
+    registeredToolCount: number;
+    tools: RuntimeToolObservation[];
+    externalCallsMade: false;
+    toolInvocationsMade: false;
+    secretValuesRetained: false;
+};
+export type VercelAiSdkModelVisibleToolSnapshot = {
+    framework: "vercel-ai-sdk";
+    runtimeName?: string;
+    modelVisibleToolCount: number;
+    activeToolFilterApplied: boolean;
+    tools: RuntimeToolObservation[];
+    externalCallsMade: false;
+    toolInvocationsMade: false;
+    secretValuesRetained: false;
+};
+export type MergedRuntimeToolSnapshot = {
+    tools: RuntimeToolObservation[];
+};
+export declare function discoverOpenAIAgentRuntime(agent: unknown): OpenAIAgentRuntimeSnapshot;
+export declare function discoverOpenAIResponsesModelVisibleTools(requestOrTools: unknown): OpenAIResponsesToolSnapshot;
+export declare function discoverVercelAiSdkRegisteredTools(toolSetOrRequest: unknown, runtimeName?: string): VercelAiSdkRegisteredToolSnapshot;
+export declare function discoverVercelAiSdkModelVisibleTools(requestOrTools: unknown, runtimeName?: string): VercelAiSdkModelVisibleToolSnapshot;
+export declare function mergeRuntimeToolEvidence(...snapshots: Array<OpenAIAgentRuntimeSnapshot | OpenAIResponsesToolSnapshot | VercelAiSdkRegisteredToolSnapshot | VercelAiSdkModelVisibleToolSnapshot | MergedRuntimeToolSnapshot>): MergedRuntimeToolSnapshot;
+//# sourceMappingURL=runtime-tool-discovery.d.ts.map

package/dist/runtime-tool-discovery.d.ts.map

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