@once-agent/sdk 0.1.11 → 0.1.12

package/dist-cjs/connect/payload.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConnectToolEffectPayload = resolveConnectToolEffectPayload;
+const binding_js_1 = require("./binding.js");
+function plainObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    const objectValue = value;
+    const prototype = Object.getPrototypeOf(objectValue);
+    if (prototype !== Object.prototype && prototype !== null) {
+        return null;
+    }
+    return objectValue;
+}
+function configuredEffectFields(tool) {
+    const meta = plainObject(tool._meta);
+    if (!meta) {
+        return null;
+    }
+    const once = plainObject(meta.once);
+    if (!once || once.effectFields === undefined) {
+        return null;
+    }
+    if (!Array.isArray(once.effectFields) || once.effectFields.length === 0) {
+        return "INVALID";
+    }
+    const fields = once.effectFields;
+    if (fields.some(field => typeof field !== "string" ||
+        field.trim().length === 0 ||
+        field.includes("."))) {
+        return "INVALID";
+    }
+    const normalized = fields.map(field => field.trim());
+    if (new Set(normalized).size !== normalized.length) {
+        return "INVALID";
+    }
+    return Object.freeze(normalized);
+}
+function jsonSafeSnapshot(value) {
+    try {
+        const canonical = (0, binding_js_1.canonicalizeConnectPayload)(value);
+        return Object.freeze(JSON.parse(canonical));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the effect-bearing payload to bind to a protected tool call.
+ *
+ * Safety policy:
+ * - tool-authored `_meta.once.effectFields` may explicitly narrow the bound
+ *   payload to complete, top-level effect fields;
+ * - otherwise the entire parsed plain-object input is bound.
+ *
+ * The full-input fallback is deliberately conservative. It may produce a
+ * conflict when unrelated retry metadata changes, but it cannot silently omit
+ * an input field that changes the external effect. Callers that need a narrower
+ * contract can keep using an explicit payload callback or declare effectFields.
+ */
+function resolveConnectToolEffectPayload(request) {
+    if (!request ||
+        !request.tool ||
+        typeof request.tool.name !== "string" ||
+        request.tool.name.trim().length === 0) {
+        return Object.freeze({
+            status: "REQUIRED",
+            reason: "A stable tool descriptor is required before an effect payload can be resolved.",
+        });
+    }
+    const input = plainObject(request.input);
+    if (!input) {
+        return Object.freeze({
+            status: "REQUIRED",
+            reason: "Automatic effect binding requires parsed plain-object tool input. Supply an explicit payload callback for other input shapes.",
+        });
+    }
+    const fields = configuredEffectFields(request.tool);
+    if (fields === "INVALID") {
+        return Object.freeze({
+            status: "REQUIRED",
+            reason: "Tool metadata contains an invalid once.effectFields declaration.",
+        });
+    }
+    if (fields) {
+        const selected = {};
+        for (const field of fields) {
+            if (!(field in input) || input[field] === undefined) {
+                return Object.freeze({
+                    status: "REQUIRED",
+                    reason: `Declared effect field "${field}" is missing from the tool input.`,
+                });
+            }
+            selected[field] = input[field];
+        }
+        const payload = jsonSafeSnapshot(selected);
+        if (!payload) {
+            return Object.freeze({
+                status: "REQUIRED",
+                reason: "Declared effect fields are not canonical JSON-safe data.",
+            });
+        }
+        return Object.freeze({
+            status: "FOUND",
+            payload,
+            source: "meta:effect_fields",
+            reason: "Tool metadata declared the complete top-level fields that define the external effect.",
+        });
+    }
+    const payload = jsonSafeSnapshot(input);
+    if (!payload) {
+        return Object.freeze({
+            status: "REQUIRED",
+            reason: "Automatic full-input effect binding requires canonical JSON-safe data. Supply an explicit payload callback to select safe effect-bearing values.",
+        });
+    }
+    return Object.freeze({
+        status: "FOUND",
+        payload,
+        source: "full_input",
+        reason: "The entire parsed tool input is conservatively bound as effect-bearing data.",
+    });
+}
+//# sourceMappingURL=payload.js.map

package/dist-cjs/connect/payload.js.map

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

package/dist-cjs/connect/tool-classifier.js

@@ -0,0 +1,276 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONNECT_TOOL_DECISION = void 0;
+exports.classifyConnectTool = classifyConnectTool;
+exports.classifyConnectTools = classifyConnectTools;
+exports.CONNECT_TOOL_DECISION = Object.freeze({
+    PROTECT: "PROTECT",
+    BYPASS: "BYPASS",
+    UNKNOWN: "UNKNOWN",
+});
+/*
+ * Keep this list action-oriented. Object nouns such as email, message,
+ * order, and post are intentionally excluded so names like search_messages
+ * and list_orders do not look mutating merely because of their subject.
+ */
+const MUTATION_NAME_TOKENS = new Set([
+    "activate",
+    "add",
+    "approve",
+    "archive",
+    "assign",
+    "book",
+    "buy",
+    "cancel",
+    "charge",
+    "close",
+    "comment",
+    "commit",
+    "create",
+    "deactivate",
+    "delete",
+    "deploy",
+    "disable",
+    "edit",
+    "enable",
+    "execute",
+    "follow",
+    "grant",
+    "invite",
+    "lock",
+    "mark",
+    "merge",
+    "modify",
+    "move",
+    "pay",
+    "place",
+    "provision",
+    "publish",
+    "purchase",
+    "refund",
+    "reject",
+    "remove",
+    "rename",
+    "reserve",
+    "reschedule",
+    "restart",
+    "restore",
+    "revoke",
+    "save",
+    "schedule",
+    "send",
+    "set",
+    "share",
+    "sign",
+    "start",
+    "stop",
+    "submit",
+    "subscribe",
+    "transfer",
+    "unlock",
+    "unfollow",
+    "unsubscribe",
+    "unschedule",
+    "update",
+    "upload",
+    "write",
+]);
+const READ_ONLY_NAME_TOKENS = new Set([
+    "analyze",
+    "calculate",
+    "check",
+    "compute",
+    "convert",
+    "describe",
+    "fetch",
+    "find",
+    "format",
+    "generate",
+    "get",
+    "history",
+    "inspect",
+    "list",
+    "lookup",
+    "metrics",
+    "parse",
+    "preview",
+    "read",
+    "render",
+    "retrieve",
+    "search",
+    "show",
+    "stats",
+    "status",
+    "summarize",
+    "translate",
+    "validate",
+    "view",
+]);
+const MUTATION_DESCRIPTION_PATTERNS = [
+    /\b(activates?|adds?|approves?|archives?|assigns?)\b/i,
+    /\b(books?|buys?|cancels?|charges?|closes?|commits?|creates?)\b/i,
+    /\b(deactivates?|deletes?|deploys?|disables?|edits?|enables?)\b/i,
+    /\b(follows?|grants?|invites?|locks?|marks?|merges?|modifies?|moves?)\b/i,
+    /\b(pays?|places?|provisions?|publishes?|purchases?|refunds?)\b/i,
+    /\b(rejects?|removes?|renames?|reserves?|reschedules?|restarts?)\b/i,
+    /\b(restores?|revokes?|saves?|schedules?|sends?|sets?|shares?|signs?)\b/i,
+    /\b(starts?|stops?|submits?|subscribes?|transfers?|unlocks?)\b/i,
+    /\b(unfollows?|unsubscribes?|unschedules?|updates?|uploads?|writes?)\b/i,
+    /\b(changes? external state|modifies? external state|side[- ]effecting)\b/i,
+];
+const READ_ONLY_DESCRIPTION_PATTERNS = [
+    /\bread[- ]only\b/i,
+    /\bno side effects?\b/i,
+    /\bdoes not (?:modify|change|write|mutate)\b/i,
+    /\bwithout (?:modifying|changing|writing|mutating|saving)\b/i,
+    /\b(searches?|reads?|retrieves?|fetches?|lists?|looks? up|inspects?)\b/i,
+    /\b(generates?|summarizes?|translates?|analyzes?|calculates?|computes?)\b/i,
+    /\b(converts?|formats?|parses?|renders?|validates?)\b/i,
+];
+function freezeResult(decision, reason, signals) {
+    return Object.freeze({
+        decision,
+        reason,
+        signals: Object.freeze([...signals]),
+    });
+}
+function normalizeName(name) {
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .toLowerCase()
+        .split(/[^a-z0-9]+/g)
+        .filter(Boolean);
+}
+function hasPattern(text, patterns) {
+    return patterns.some(pattern => pattern.test(text));
+}
+function validateAnnotations(value) {
+    if (value === undefined) {
+        return true;
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const candidate = value;
+    for (const key of [
+        "readOnlyHint",
+        "destructiveHint",
+        "idempotentHint",
+        "openWorldHint",
+    ]) {
+        if (candidate[key] !== undefined &&
+            typeof candidate[key] !== "boolean") {
+            return false;
+        }
+    }
+    if (candidate.title !== undefined &&
+        typeof candidate.title !== "string") {
+        return false;
+    }
+    return true;
+}
+/**
+ * Infer whether a tool should cross the Once Connect safety boundary.
+ *
+ * This is intentionally conservative. Explicit metadata and deterministic
+ * name/description semantics cross-check one another. Weak or contradictory
+ * evidence resolves to UNKNOWN rather than permission.
+ *
+ * UNKNOWN is not a bypass decision. Callers should require an explicit safety
+ * declaration, human/config policy, or another trusted classifier before
+ * executing a consequential operation outside Once.
+ */
+function classifyConnectTool(tool) {
+    if (!tool || typeof tool !== "object" || Array.isArray(tool)) {
+        return freezeResult(exports.CONNECT_TOOL_DECISION.UNKNOWN, "INVALID_TOOL_DESCRIPTOR", []);
+    }
+    const candidate = tool;
+    if (typeof candidate.name !== "string" ||
+        candidate.name.trim().length === 0) {
+        return freezeResult(exports.CONNECT_TOOL_DECISION.UNKNOWN, "INVALID_TOOL_DESCRIPTOR", []);
+    }
+    if (candidate.description !== undefined &&
+        typeof candidate.description !== "string") {
+        return freezeResult(exports.CONNECT_TOOL_DECISION.UNKNOWN, "INVALID_TOOL_DESCRIPTOR", []);
+    }
+    if (!validateAnnotations(candidate.annotations)) {
+        return freezeResult(exports.CONNECT_TOOL_DECISION.UNKNOWN, "INVALID_TOOL_ANNOTATIONS", []);
+    }
+    const annotations = candidate.annotations;
+    const nameTokens = normalizeName(candidate.name);
+    const description = typeof candidate.description === "string"
+        ? candidate.description
+        : "";
+    const mutationNameTokens = nameTokens.filter(token => MUTATION_NAME_TOKENS.has(token));
+    const readOnlyNameTokens = nameTokens.filter(token => READ_ONLY_NAME_TOKENS.has(token));
+    const mutationDescription = hasPattern(description, MUTATION_DESCRIPTION_PATTERNS);
+    const readOnlyDescription = hasPattern(description, READ_ONLY_DESCRIPTION_PATTERNS);
+    const mutationSignal = mutationNameTokens.length > 0 || mutationDescription;
+    const readOnlySignal = readOnlyNameTokens.length > 0 || readOnlyDescription;
+    const signals = [];
+    for (const token of mutationNameTokens) {
+        signals.push(`name:${token}`);
+    }
+    for (const token of readOnlyNameTokens) {
+        signals.push(`name:${token}`);
+    }
+    if (mutationDescription) {
+        signals.push("description:mutation");
+    }
+    if (readOnlyDescription) {
+        signals.push("description:read-only");
+    }
+    if (mutationSignal && readOnlySignal) {
+        return freezeResult(exports.CONNECT_TOOL_DECISION.UNKNOWN, "CONFLICTING_SIGNALS", signals);
+    }
+    if (annotations?.readOnlyHint === true) {
+        signals.push("annotations.readOnlyHint=true");
+        if (annotations.destructiveHint === true ||
+            mutationSignal) {
+            if (annotations.destructiveHint === true) {
+                signals.push("annotations.destructiveHint=true");
+            }
+            return freezeResult(exports.CONNECT_TOOL_DECISION.UNKNOWN, "CONFLICTING_SIGNALS", signals);
+        }
+        return freezeResult(exports.CONNECT_TOOL_DECISION.BYPASS, "EXPLICIT_READ_ONLY", signals);
+    }
+    if (annotations?.readOnlyHint === false) {
+        signals.push("annotations.readOnlyHint=false");
+        if (readOnlySignal && !mutationSignal) {
+            return freezeResult(exports.CONNECT_TOOL_DECISION.UNKNOWN, "CONFLICTING_SIGNALS", signals);
+        }
+        if (annotations.idempotentHint === true) {
+            signals.push("annotations.idempotentHint=true");
+            return freezeResult(exports.CONNECT_TOOL_DECISION.BYPASS, "EXPLICIT_IDEMPOTENT_WRITE", signals);
+        }
+        if (annotations.idempotentHint === false) {
+            signals.push("annotations.idempotentHint=false");
+        }
+        if (annotations.destructiveHint !== undefined) {
+            signals.push(`annotations.destructiveHint=${String(annotations.destructiveHint)}`);
+        }
+        return freezeResult(exports.CONNECT_TOOL_DECISION.PROTECT, "EXPLICIT_WRITE", signals);
+    }
+    if (annotations?.idempotentHint === true) {
+        signals.push("annotations.idempotentHint=true");
+        return freezeResult(exports.CONNECT_TOOL_DECISION.BYPASS, "EXPLICIT_IDEMPOTENT_WRITE", signals);
+    }
+    if (annotations?.destructiveHint === true) {
+        signals.push("annotations.destructiveHint=true");
+        if (readOnlySignal) {
+            return freezeResult(exports.CONNECT_TOOL_DECISION.UNKNOWN, "CONFLICTING_SIGNALS", signals);
+        }
+        return freezeResult(exports.CONNECT_TOOL_DECISION.PROTECT, "EXPLICIT_WRITE", signals);
+    }
+    if (mutationSignal) {
+        return freezeResult(exports.CONNECT_TOOL_DECISION.PROTECT, "MUTATION_SIGNAL", signals);
+    }
+    if (readOnlySignal) {
+        return freezeResult(exports.CONNECT_TOOL_DECISION.BYPASS, "READ_ONLY_SIGNAL", signals);
+    }
+    return freezeResult(exports.CONNECT_TOOL_DECISION.UNKNOWN, "INSUFFICIENT_EVIDENCE", signals);
+}
+function classifyConnectTools(tools) {
+    return Object.freeze(tools.map(tool => classifyConnectTool(tool)));
+}
+//# sourceMappingURL=tool-classifier.js.map

package/dist-cjs/connect/tool-classifier.js.map

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

package/dist-cjs/connect/toolset.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectLocalAgentToolsetAuto = connectLocalAgentToolsetAuto;
+const manifest_js_1 = require("./manifest.js");
+const local_agent_tool_js_1 = require("./local-agent-tool.js");
+function isRecord(value) {
+    if (value === null ||
+        typeof value !== "object" ||
+        Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+function formatUnknownTools(plan) {
+    return plan.unknown
+        .map(entry => `${entry.name ?? `#${entry.index}`}:${entry.reason}`)
+        .join(", ");
+}
+/**
+ * Connect an entire local agent tool registry in one fail-closed operation.
+ *
+ * Safety properties:
+ * - the manifest must fully classify with no UNKNOWN entries;
+ * - every declared tool must have exactly one same-named implementation;
+ * - undeclared executable registry entries are rejected;
+ * - duplicate or invalid tool names are rejected before wrappers are built;
+ * - the original registry is never mutated;
+ * - every returned tool delegates through connectLocalAgentToolAuto(), so the
+ *   existing routing, identity, payload and SQLite protection rules remain the
+ *   single source of execution behaviour.
+ *
+ * Per-call identity/payload can still fail closed at invocation time because
+ * those values depend on actual input. Only expose `result.tools` to the agent;
+ * retaining and using the original registry remains an intentional bypass.
+ */
+function connectLocalAgentToolsetAuto(tools, options) {
+    if (!isRecord(tools)) {
+        throw new local_agent_tool_js_1.AgentToolConnectionError("INVALID_TOOLSET", "Once Connect needs a plain-object registry of named agent tools.");
+    }
+    if (!options || !("manifest" in options)) {
+        throw new local_agent_tool_js_1.AgentToolConnectionError("INVALID_TOOL_MANIFEST", "Once Connect needs a complete tool manifest before toolset wiring.");
+    }
+    const normalized = (0, manifest_js_1.normalizeConnectToolManifest)(options.manifest);
+    const plan = (0, manifest_js_1.planConnectToolManifest)(options.manifest);
+    if (!normalized || !plan.valid) {
+        throw new local_agent_tool_js_1.AgentToolConnectionError("INVALID_TOOL_MANIFEST", "Once Connect could not parse the supplied tool manifest.");
+    }
+    if (!plan.ready) {
+        throw new local_agent_tool_js_1.AgentToolConnectionError("UNKNOWN_TOOLSET_SAFETY", `Once Connect refuses partial automatic wiring while tool safety is unresolved: ${formatUnknownTools(plan)}.`);
+    }
+    if (normalized.length !== plan.entries.length) {
+        throw new local_agent_tool_js_1.AgentToolConnectionError("INVALID_TOOL_MANIFEST", "Once Connect manifest normalization and classification disagree.");
+    }
+    const descriptors = new Map();
+    for (let index = 0; index < normalized.length; index += 1) {
+        const item = normalized[index];
+        const name = item.name;
+        if (typeof name !== "string" ||
+            !/^[A-Za-z0-9_-]{1,100}$/.test(name) ||
+            !isRecord(item.descriptor)) {
+            throw new local_agent_tool_js_1.AgentToolConnectionError("INVALID_TOOL_NAME", `Once Connect requires a stable registry-safe tool name at manifest index ${index}.`);
+        }
+        if (descriptors.has(name)) {
+            throw new local_agent_tool_js_1.AgentToolConnectionError("DUPLICATE_TOOL_NAME", `Once Connect cannot safely map duplicate manifest tool name "${name}" to one implementation.`);
+        }
+        descriptors.set(name, item.descriptor);
+    }
+    for (const name of descriptors.keys()) {
+        if (!hasOwn(tools, name)) {
+            throw new local_agent_tool_js_1.AgentToolConnectionError("MISSING_TOOL_IMPLEMENTATION", `The manifest declares "${name}" but the tool registry has no same-named implementation.`);
+        }
+        const implementation = tools[name];
+        if (!implementation ||
+            typeof implementation.execute !== "function") {
+            throw new local_agent_tool_js_1.AgentToolConnectionError("INVALID_TOOL_IMPLEMENTATION", `Tool "${name}" must expose execute(input).`);
+        }
+    }
+    for (const name of Object.keys(tools)) {
+        if (!descriptors.has(name)) {
+            throw new local_agent_tool_js_1.AgentToolConnectionError("UNDECLARED_TOOL_IMPLEMENTATION", `Tool registry entry "${name}" is executable but absent from the manifest. Once refuses to leave an undeclared bypass in the connected registry.`);
+        }
+    }
+    if (options.overrides !== undefined &&
+        !isRecord(options.overrides)) {
+        throw new local_agent_tool_js_1.AgentToolConnectionError("INVALID_TOOLSET_OVERRIDES", "Once Connect toolset overrides must be a plain object keyed by tool name.");
+    }
+    if (options.overrides) {
+        for (const name of Object.keys(options.overrides)) {
+            if (!descriptors.has(name)) {
+                throw new local_agent_tool_js_1.AgentToolConnectionError("UNDECLARED_TOOL_OVERRIDE", `Override "${name}" does not correspond to a declared tool.`);
+            }
+            const override = options.overrides[name];
+            if (override !== undefined && !isRecord(override)) {
+                throw new local_agent_tool_js_1.AgentToolConnectionError("INVALID_TOOLSET_OVERRIDES", `Override "${name}" must be a plain object when provided.`);
+            }
+        }
+    }
+    const connected = Object.create(null);
+    for (const [name, descriptor] of descriptors) {
+        const implementation = tools[name];
+        const override = options.overrides?.[name];
+        const wrapped = (0, local_agent_tool_js_1.connectLocalAgentToolAuto)(implementation, {
+            descriptor,
+            statePath: override?.statePath ?? options.statePath,
+            id: override?.id,
+            payload: override?.payload,
+            reconcile: override?.reconcile,
+        });
+        Object.defineProperty(connected, name, {
+            value: Object.freeze(wrapped),
+            enumerable: true,
+            configurable: false,
+            writable: false,
+        });
+    }
+    const frozenTools = Object.freeze(connected);
+    return Object.freeze({
+        plan,
+        tools: frozenTools,
+    });
+}
+//# sourceMappingURL=toolset.js.map

package/dist-cjs/connect/toolset.js.map

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

package/dist-cjs/discovery/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.observeOtelGenAiToolExecutions = exports.createLangChainExecutionObserver = exports.observeVercelAiSdkStepExecutions = exports.createOpenAIAgentsExecutionObserver = exports.promoteToolExecution = exports.executionToolFingerprint = exports.aggregateToolExecutions = exports.observeToolExecution = exports.discoverLangChainModelVisibleTools = exports.discoverLangChainRegisteredTools = exports.mergeRuntimeToolEvidence = exports.discoverVercelAiSdkModelVisibleTools = exports.discoverVercelAiSdkRegisteredTools = exports.discoverOpenAIResponsesModelVisibleTools = exports.discoverOpenAIAgentRuntime = void 0;
+var runtime_tool_discovery_js_1 = require("../runtime-tool-discovery.js");
+Object.defineProperty(exports, "discoverOpenAIAgentRuntime", { enumerable: true, get: function () { return runtime_tool_discovery_js_1.discoverOpenAIAgentRuntime; } });
+Object.defineProperty(exports, "discoverOpenAIResponsesModelVisibleTools", { enumerable: true, get: function () { return runtime_tool_discovery_js_1.discoverOpenAIResponsesModelVisibleTools; } });
+Object.defineProperty(exports, "discoverVercelAiSdkRegisteredTools", { enumerable: true, get: function () { return runtime_tool_discovery_js_1.discoverVercelAiSdkRegisteredTools; } });
+Object.defineProperty(exports, "discoverVercelAiSdkModelVisibleTools", { enumerable: true, get: function () { return runtime_tool_discovery_js_1.discoverVercelAiSdkModelVisibleTools; } });
+Object.defineProperty(exports, "mergeRuntimeToolEvidence", { enumerable: true, get: function () { return runtime_tool_discovery_js_1.mergeRuntimeToolEvidence; } });
+var langchain_runtime_discovery_js_1 = require("../langchain-runtime-discovery.js");
+Object.defineProperty(exports, "discoverLangChainRegisteredTools", { enumerable: true, get: function () { return langchain_runtime_discovery_js_1.discoverLangChainRegisteredTools; } });
+Object.defineProperty(exports, "discoverLangChainModelVisibleTools", { enumerable: true, get: function () { return langchain_runtime_discovery_js_1.discoverLangChainModelVisibleTools; } });
+var execution_observation_js_1 = require("../execution-observation.js");
+Object.defineProperty(exports, "observeToolExecution", { enumerable: true, get: function () { return execution_observation_js_1.observeToolExecution; } });
+Object.defineProperty(exports, "aggregateToolExecutions", { enumerable: true, get: function () { return execution_observation_js_1.aggregateToolExecutions; } });
+Object.defineProperty(exports, "executionToolFingerprint", { enumerable: true, get: function () { return execution_observation_js_1.executionToolFingerprint; } });
+Object.defineProperty(exports, "promoteToolExecution", { enumerable: true, get: function () { return execution_observation_js_1.promoteToolExecution; } });
+var openai_agents_execution_observer_js_1 = require("../openai-agents-execution-observer.js");
+Object.defineProperty(exports, "createOpenAIAgentsExecutionObserver", { enumerable: true, get: function () { return openai_agents_execution_observer_js_1.createOpenAIAgentsExecutionObserver; } });
+var vercel_execution_observer_js_1 = require("../vercel-execution-observer.js");
+Object.defineProperty(exports, "observeVercelAiSdkStepExecutions", { enumerable: true, get: function () { return vercel_execution_observer_js_1.observeVercelAiSdkStepExecutions; } });
+var langchain_execution_observer_js_1 = require("../langchain-execution-observer.js");
+Object.defineProperty(exports, "createLangChainExecutionObserver", { enumerable: true, get: function () { return langchain_execution_observer_js_1.createLangChainExecutionObserver; } });
+var otel_execution_observer_js_1 = require("../otel-execution-observer.js");
+Object.defineProperty(exports, "observeOtelGenAiToolExecutions", { enumerable: true, get: function () { return otel_execution_observer_js_1.observeOtelGenAiToolExecutions; } });
+//# sourceMappingURL=index.js.map

package/dist-cjs/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":";;;AAAA,0EAMsC;AALpC,uIAAA,0BAA0B,OAAA;AAC1B,qJAAA,wCAAwC,OAAA;AACxC,+IAAA,kCAAkC,OAAA;AAClC,iJAAA,oCAAoC,OAAA;AACpC,qIAAA,wBAAwB,OAAA;AAG1B,oFAG2C;AAFzC,kJAAA,gCAAgC,OAAA;AAChC,oJAAA,kCAAkC,OAAA;AAGpC,wEAKqC;AAJnC,gIAAA,oBAAoB,OAAA;AACpB,mIAAA,uBAAuB,OAAA;AACvB,oIAAA,wBAAwB,OAAA;AACxB,gIAAA,oBAAoB,OAAA;AAGtB,8FAEgD;AAD9C,0JAAA,mCAAmC,OAAA;AAGrC,gFAEyC;AADvC,gJAAA,gCAAgC,OAAA;AAGlC,sFAE4C;AAD1C,mJAAA,gCAAgC,OAAA;AAGlC,4EAEuC;AADrC,4IAAA,8BAA8B,OAAA"}