@once-agent/sdk 0.1.10 → 0.1.12

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

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

package/dist-cjs/connect/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIAgentsConnectError = exports.connectOpenAIAgentsFunctionToolsAuto = exports.connectLocalAgentToolsetAuto = exports.AgentToolConnectionError = exports.connectLocalAgentToolAuto = exports.resolveConnectToolEffectPayload = exports.resolveConnectToolOperationIdentity = exports.planConnectToolManifest = exports.CONNECT_MANIFEST_VERSION = exports.classifyConnectTools = exports.classifyConnectTool = exports.CONNECT_TOOL_DECISION = exports.classifyConnectOperation = exports.CONNECT_DECISION = void 0;
+var classifier_js_1 = require("./classifier.js");
+Object.defineProperty(exports, "CONNECT_DECISION", { enumerable: true, get: function () { return classifier_js_1.CONNECT_DECISION; } });
+Object.defineProperty(exports, "classifyConnectOperation", { enumerable: true, get: function () { return classifier_js_1.classifyConnectOperation; } });
+var tool_classifier_js_1 = require("./tool-classifier.js");
+Object.defineProperty(exports, "CONNECT_TOOL_DECISION", { enumerable: true, get: function () { return tool_classifier_js_1.CONNECT_TOOL_DECISION; } });
+Object.defineProperty(exports, "classifyConnectTool", { enumerable: true, get: function () { return tool_classifier_js_1.classifyConnectTool; } });
+Object.defineProperty(exports, "classifyConnectTools", { enumerable: true, get: function () { return tool_classifier_js_1.classifyConnectTools; } });
+var manifest_js_1 = require("./manifest.js");
+Object.defineProperty(exports, "CONNECT_MANIFEST_VERSION", { enumerable: true, get: function () { return manifest_js_1.CONNECT_MANIFEST_VERSION; } });
+Object.defineProperty(exports, "planConnectToolManifest", { enumerable: true, get: function () { return manifest_js_1.planConnectToolManifest; } });
+var identity_js_1 = require("./identity.js");
+Object.defineProperty(exports, "resolveConnectToolOperationIdentity", { enumerable: true, get: function () { return identity_js_1.resolveConnectToolOperationIdentity; } });
+var payload_js_1 = require("./payload.js");
+Object.defineProperty(exports, "resolveConnectToolEffectPayload", { enumerable: true, get: function () { return payload_js_1.resolveConnectToolEffectPayload; } });
+var local_agent_tool_js_1 = require("./local-agent-tool.js");
+Object.defineProperty(exports, "connectLocalAgentToolAuto", { enumerable: true, get: function () { return local_agent_tool_js_1.connectLocalAgentToolAuto; } });
+Object.defineProperty(exports, "AgentToolConnectionError", { enumerable: true, get: function () { return local_agent_tool_js_1.AgentToolConnectionError; } });
+var toolset_js_1 = require("./toolset.js");
+Object.defineProperty(exports, "connectLocalAgentToolsetAuto", { enumerable: true, get: function () { return toolset_js_1.connectLocalAgentToolsetAuto; } });
+var openai_function_tools_js_1 = require("./openai-function-tools.js");
+Object.defineProperty(exports, "connectOpenAIAgentsFunctionToolsAuto", { enumerable: true, get: function () { return openai_function_tools_js_1.connectOpenAIAgentsFunctionToolsAuto; } });
+Object.defineProperty(exports, "OpenAIAgentsConnectError", { enumerable: true, get: function () { return openai_function_tools_js_1.OpenAIAgentsConnectError; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connect/index.ts"],"names":[],"mappings":";;;AAAA,iDAGyB;AAFvB,iHAAA,gBAAgB,OAAA;AAChB,yHAAA,wBAAwB,OAAA;AAS1B,2DAI8B;AAH5B,2HAAA,qBAAqB,OAAA;AACrB,yHAAA,mBAAmB,OAAA;AACnB,0HAAA,oBAAoB,OAAA;AAWtB,6CAGuB;AAFrB,uHAAA,wBAAwB,OAAA;AACxB,sHAAA,uBAAuB,OAAA;AAUzB,6CAEuB;AADrB,kIAAA,mCAAmC,OAAA;AASrC,2CAEsB;AADpB,6HAAA,+BAA+B,OAAA;AASjC,6DAG+B;AAF7B,gIAAA,yBAAyB,OAAA;AACzB,+HAAA,wBAAwB,OAAA;AAQ1B,2CAEsB;AADpB,0HAAA,4BAA4B,OAAA;AAW9B,uEAGoC;AAFlC,gJAAA,oCAAoC,OAAA;AACpC,oIAAA,wBAAwB,OAAA"}

package/dist-cjs/connect/local-agent-tool.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentToolConnectionError = void 0;
+exports.connectLocalAgentTool = connectLocalAgentTool;
+exports.connectLocalAgentToolAuto = connectLocalAgentToolAuto;
+const classifier_js_1 = require("./classifier.js");
+const tool_classifier_js_1 = require("./tool-classifier.js");
+const identity_js_1 = require("./identity.js");
+const payload_js_1 = require("./payload.js");
+const local_js_1 = require("../local.js");
+class AgentToolConnectionError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "AgentToolConnectionError";
+    }
+}
+exports.AgentToolConnectionError = AgentToolConnectionError;
+function connectLocalAgentTool(tool, contract) {
+    if (!tool || typeof tool.execute !== "function") {
+        throw new AgentToolConnectionError("INVALID_TOOL", "Once needs a tool with an execute(input) function.");
+    }
+    if (!contract ||
+        typeof contract.name !== "string" ||
+        !/^[A-Za-z0-9_-]{1,100}$/.test(contract.name)) {
+        throw new AgentToolConnectionError("INVALID_TOOL_NAME", "A stable registered tool name is required.");
+    }
+    const classification = (0, classifier_js_1.classifyConnectOperation)(contract.safety);
+    if (classification.decision === classifier_js_1.CONNECT_DECISION.REJECT) {
+        throw new AgentToolConnectionError("INVALID_SAFETY_DECLARATION", "Review all four safety conditions before connecting an agent tool.");
+    }
+    if (classification.decision === classifier_js_1.CONNECT_DECISION.BYPASS) {
+        return {
+            execute: (input) => tool.execute.call(tool, input),
+        };
+    }
+    if (typeof contract.id !== "function" || typeof contract.payload !== "function") {
+        throw new AgentToolConnectionError("PROTECTION_REQUIRED", "A consequential tool requires stable intent identity and complete effect payload before it can be connected.");
+    }
+    const id = contract.id;
+    const payload = contract.payload;
+    const name = contract.name;
+    const protectedExecute = (0, local_js_1.protectLocal)(async (input) => tool.execute.call(tool, input), {
+        id: (input) => {
+            const intent = id(input);
+            return typeof intent === "string" && intent.trim() !== ""
+                ? `${name}:${intent}`
+                : "";
+        },
+        payload: (input) => ({ tool: name, effect: payload(input) }),
+        statePath: contract.statePath,
+        reconcile: contract.reconcile,
+    });
+    return {
+        execute: (input) => protectedExecute(input),
+    };
+}
+const AUTO_PROTECTED_SAFETY = Object.freeze({
+    changesExternalState: true,
+    retryPossible: true,
+    ambiguousOutcomePossible: true,
+    duplicateUndesirable: true,
+});
+const AUTO_BYPASS_SAFETY = Object.freeze({
+    changesExternalState: false,
+    retryPossible: false,
+    ambiguousOutcomePossible: false,
+    duplicateUndesirable: false,
+});
+/**
+ * Connect a local agent tool using its descriptor instead of hand-authored
+ * routing declarations.
+ *
+ * Automatic routing is intentionally conservative:
+ * - PROTECT -> delegate to the existing protected local connector;
+ * - BYPASS -> delegate to the existing bypass path;
+ * - UNKNOWN -> refuse connection until the tool is clarified.
+ *
+ * For protected tools, stable identity may be supplied by `id()` or resolved
+ * from trustworthy operation/idempotency/intent carriers. Effect payload may
+ * be supplied by `payload()` or conservatively bound from the full plain-object
+ * input. `_meta.once.effectFields` can explicitly narrow that binding.
+ * Missing/invalid identity or payload fails before the side effect.
+ */
+function connectLocalAgentToolAuto(tool, contract) {
+    if (!contract || !contract.descriptor) {
+        throw new AgentToolConnectionError("UNKNOWN_TOOL_SAFETY", "Once Connect needs a tool descriptor before automatic routing can be established.");
+    }
+    const classification = (0, tool_classifier_js_1.classifyConnectTool)(contract.descriptor);
+    if (classification.decision === tool_classifier_js_1.CONNECT_TOOL_DECISION.UNKNOWN) {
+        throw new AgentToolConnectionError("UNKNOWN_TOOL_SAFETY", `Once Connect cannot safely auto-route ${contract.descriptor.name || "this tool"}: ${classification.reason}.`);
+    }
+    if (classification.decision === tool_classifier_js_1.CONNECT_TOOL_DECISION.BYPASS) {
+        return connectLocalAgentTool(tool, {
+            name: contract.descriptor.name,
+            safety: AUTO_BYPASS_SAFETY,
+            statePath: contract.statePath,
+        });
+    }
+    const identity = typeof contract.id === "function"
+        ? contract.id
+        : (input) => {
+            const result = (0, identity_js_1.resolveConnectToolOperationIdentity)({
+                tool: contract.descriptor,
+                input,
+            });
+            if (result.status === "FOUND") {
+                return result.operationId;
+            }
+            if (result.status === "CONFLICT") {
+                throw new AgentToolConnectionError("IDENTITY_CONFLICT", result.reason);
+            }
+            throw new AgentToolConnectionError("IDENTITY_REQUIRED", result.reason);
+        };
+    const payload = typeof contract.payload === "function"
+        ? contract.payload
+        : (input) => {
+            const result = (0, payload_js_1.resolveConnectToolEffectPayload)({
+                tool: contract.descriptor,
+                input,
+            });
+            if (result.status === "FOUND") {
+                return { ...result.payload };
+            }
+            throw new AgentToolConnectionError("PAYLOAD_REQUIRED", result.reason);
+        };
+    return connectLocalAgentTool(tool, {
+        name: contract.descriptor.name,
+        safety: AUTO_PROTECTED_SAFETY,
+        id: identity,
+        payload,
+        statePath: contract.statePath,
+        reconcile: contract.reconcile,
+    });
+}
+//# sourceMappingURL=local-agent-tool.js.map

package/dist-cjs/connect/local-agent-tool.js.map

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

package/dist-cjs/connect/manifest.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONNECT_MANIFEST_VERSION = void 0;
+exports.normalizeConnectToolManifest = normalizeConnectToolManifest;
+exports.planConnectToolManifest = planConnectToolManifest;
+const tool_classifier_js_1 = require("./tool-classifier.js");
+exports.CONNECT_MANIFEST_VERSION = "connect-tool-plan-v1";
+function isRecord(value) {
+    return Boolean(value) &&
+        typeof value === "object" &&
+        !Array.isArray(value);
+}
+function normalizeManifestInput(manifest) {
+    if (Array.isArray(manifest)) {
+        return manifest;
+    }
+    if (isRecord(manifest) && Array.isArray(manifest.tools)) {
+        return manifest.tools;
+    }
+    return null;
+}
+function normalizedAnnotations(value) {
+    return isRecord(value)
+        ? value
+        : undefined;
+}
+function normalizedMeta(value) {
+    return isRecord(value)
+        ? value
+        : undefined;
+}
+function normalizeTool(tool) {
+    if (!isRecord(tool)) {
+        return {
+            descriptor: tool,
+            name: null,
+            source: "invalid",
+        };
+    }
+    if (typeof tool.name === "string" &&
+        tool.name.trim().length > 0) {
+        return {
+            descriptor: tool,
+            name: tool.name,
+            source: "native",
+        };
+    }
+    if (tool.type === "function" &&
+        isRecord(tool.function) &&
+        typeof tool.function.name === "string" &&
+        tool.function.name.trim().length > 0) {
+        const fn = tool.function;
+        const name = tool.function.name;
+        const annotations = normalizedAnnotations(tool.annotations);
+        const meta = normalizedMeta(tool._meta) ?? normalizedMeta(fn._meta);
+        const descriptor = {
+            name,
+            ...(typeof fn.description === "string"
+                ? { description: fn.description }
+                : {}),
+            ...(fn.parameters !== undefined
+                ? { inputSchema: fn.parameters }
+                : {}),
+            ...(annotations !== undefined
+                ? { annotations }
+                : {}),
+            ...(meta !== undefined
+                ? { _meta: meta }
+                : {}),
+        };
+        return {
+            descriptor,
+            name,
+            source: "openai_function",
+        };
+    }
+    return {
+        descriptor: tool,
+        name: null,
+        source: "invalid",
+    };
+}
+/**
+ * Normalize the same manifest shapes accepted by planConnectToolManifest().
+ *
+ * This is exported for internal Connect modules so classification and wiring
+ * cannot silently disagree about the descriptor being inspected. It is not
+ * re-exported from the public @once-agent/sdk/connect entry point.
+ */
+function normalizeConnectToolManifest(manifest) {
+    const tools = normalizeManifestInput(manifest);
+    if (!tools) {
+        return null;
+    }
+    return Object.freeze(tools.map(tool => Object.freeze(normalizeTool(tool))));
+}
+function freezeEntry(entry) {
+    return Object.freeze({
+        ...entry,
+        signals: Object.freeze([...entry.signals]),
+    });
+}
+function invalidPlan() {
+    const entries = Object.freeze([]);
+    const summary = Object.freeze({
+        total: 0,
+        protect: 0,
+        bypass: 0,
+        unknown: 0,
+    });
+    return Object.freeze({
+        version: exports.CONNECT_MANIFEST_VERSION,
+        valid: false,
+        ready: false,
+        reason: "INVALID_MANIFEST",
+        entries,
+        protect: entries,
+        bypass: entries,
+        unknown: entries,
+        summary,
+    });
+}
+/**
+ * Inspect a complete tool manifest and produce an ordered Once protection plan.
+ *
+ * Accepted inputs:
+ * - an array of native/MCP-style tool descriptors;
+ * - an MCP-style `{ tools: [...] }` result;
+ * - OpenAI-style `{ type: "function", function: { ... } }` entries.
+ *
+ * `ready` is true only when every entry has a deterministic PROTECT/BYPASS
+ * decision. UNKNOWN never becomes implicit permission.
+ */
+function planConnectToolManifest(manifest) {
+    const tools = normalizeConnectToolManifest(manifest);
+    if (!tools) {
+        return invalidPlan();
+    }
+    const entries = tools.map((tool, index) => {
+        const classification = (0, tool_classifier_js_1.classifyConnectTool)(tool.descriptor);
+        return freezeEntry({
+            index,
+            name: tool.name,
+            source: tool.source,
+            decision: classification.decision,
+            reason: classification.reason,
+            signals: classification.signals,
+        });
+    });
+    const protect = entries.filter(entry => entry.decision === tool_classifier_js_1.CONNECT_TOOL_DECISION.PROTECT);
+    const bypass = entries.filter(entry => entry.decision === tool_classifier_js_1.CONNECT_TOOL_DECISION.BYPASS);
+    const unknown = entries.filter(entry => entry.decision === tool_classifier_js_1.CONNECT_TOOL_DECISION.UNKNOWN);
+    const summary = Object.freeze({
+        total: entries.length,
+        protect: protect.length,
+        bypass: bypass.length,
+        unknown: unknown.length,
+    });
+    return Object.freeze({
+        version: exports.CONNECT_MANIFEST_VERSION,
+        valid: true,
+        ready: unknown.length === 0,
+        reason: "CLASSIFIED",
+        entries: Object.freeze(entries),
+        protect: Object.freeze(protect),
+        bypass: Object.freeze(bypass),
+        unknown: Object.freeze(unknown),
+        summary,
+    });
+}
+//# sourceMappingURL=manifest.js.map

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

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

package/dist-cjs/connect/openai-function-tools.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIAgentsConnectError = void 0;
+exports.connectOpenAIAgentsFunctionToolsAuto = connectOpenAIAgentsFunctionToolsAuto;
+const tool_classifier_js_1 = require("./tool-classifier.js");
+const identity_js_1 = require("./identity.js");
+const payload_js_1 = require("./payload.js");
+const toolset_js_1 = require("./toolset.js");
+const local_agent_tool_js_1 = require("./local-agent-tool.js");
+const openai_agents_js_1 = require("./openai-agents.js");
+var openai_agents_js_2 = require("./openai-agents.js");
+Object.defineProperty(exports, "OpenAIAgentsConnectError", { enumerable: true, get: function () { return openai_agents_js_2.OpenAIAgentsConnectError; } });
+function isObject(value) {
+    return value !== null &&
+        typeof value === "object" &&
+        !Array.isArray(value);
+}
+function isFunctionToolLike(value) {
+    return isObject(value) &&
+        value.type === "function" &&
+        typeof value.name === "string" &&
+        value.name.trim() !== "" &&
+        typeof value.description === "string" &&
+        Object.prototype.hasOwnProperty.call(value, "parameters") &&
+        typeof value.invoke === "function";
+}
+function parseProtectedInput(toolName, rawInput) {
+    if (typeof rawInput !== "string") {
+        throw new openai_agents_js_1.OpenAIAgentsConnectError(`Once Connect expected OpenAI Agents function tool "${toolName}" to receive JSON text input.`, "INVALID_OPENAI_TOOL_INPUT");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(rawInput);
+    }
+    catch {
+        throw new openai_agents_js_1.OpenAIAgentsConnectError(`Once Connect could not parse protected OpenAI Agents tool input for "${toolName}".`, "INVALID_OPENAI_TOOL_INPUT");
+    }
+    if (!isObject(parsed)) {
+        throw new openai_agents_js_1.OpenAIAgentsConnectError(`Once Connect requires protected OpenAI Agents tool input for "${toolName}" to be a JSON object.`, "INVALID_OPENAI_TOOL_INPUT");
+    }
+    return parsed;
+}
+function requireParsedInput(toolName, envelope) {
+    if (!envelope.parsedInput) {
+        throw new openai_agents_js_1.OpenAIAgentsConnectError(`Once Connect did not receive parsed protected input for "${toolName}".`, "INVALID_OPENAI_TOOL_INPUT");
+    }
+    return envelope.parsedInput;
+}
+function descriptorFor(tool, override) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.parameters,
+        ...(override?.annotations !== undefined
+            ? { annotations: override.annotations }
+            : {}),
+        ...(override?._meta !== undefined
+            ? { _meta: override._meta }
+            : {}),
+    };
+}
+function resolveIdentityForEnvelope(descriptor, envelope, override) {
+    const input = requireParsedInput(descriptor.name, envelope);
+    if (typeof override?.id === "function") {
+        return override.id(input);
+    }
+    const result = (0, identity_js_1.resolveConnectToolOperationIdentity)({
+        tool: descriptor,
+        input,
+    });
+    if (result.status === "FOUND") {
+        return result.operationId;
+    }
+    if (result.status === "CONFLICT") {
+        throw new local_agent_tool_js_1.AgentToolConnectionError("IDENTITY_CONFLICT", result.reason);
+    }
+    throw new local_agent_tool_js_1.AgentToolConnectionError("IDENTITY_REQUIRED", result.reason);
+}
+function resolvePayloadForEnvelope(descriptor, envelope, override) {
+    const input = requireParsedInput(descriptor.name, envelope);
+    if (typeof override?.payload === "function") {
+        return override.payload(input);
+    }
+    const result = (0, payload_js_1.resolveConnectToolEffectPayload)({
+        tool: descriptor,
+        input,
+    });
+    if (result.status === "FOUND") {
+        return { ...result.payload };
+    }
+    throw new local_agent_tool_js_1.AgentToolConnectionError("PAYLOAD_REQUIRED", result.reason);
+}
+function cloneFunctionToolWithInvoke(tool, invoke) {
+    const descriptors = Object.getOwnPropertyDescriptors(tool);
+    const originalInvoke = Object.getOwnPropertyDescriptor(tool, "invoke");
+    Reflect.deleteProperty(descriptors, "invoke");
+    const clone = Object.create(Object.getPrototypeOf(tool), descriptors);
+    Object.defineProperty(clone, "invoke", {
+        value: invoke,
+        enumerable: originalInvoke?.enumerable ?? true,
+        configurable: originalInvoke?.configurable ?? true,
+        writable: originalInvoke?.writable ?? true,
+    });
+    return clone;
+}
+/**
+ * Connect a complete array of OpenAI Agents SDK FunctionTool objects to Once.
+ *
+ * The returned FunctionTools preserve the original framework object shape and
+ * replace only `invoke`. Tool-call IDs/details are never used as logical Once
+ * identity. Protected calls derive identity/effect from the parsed JSON tool
+ * arguments and execute the original `invoke` with the original raw input,
+ * run context and call details.
+ *
+ * This v1 adapter is deliberately FunctionTool-only. Passing hosted, shell,
+ * computer, apply-patch, MCP or other tool types fails closed rather than
+ * returning a partially protected agent tool list.
+ */
+function connectOpenAIAgentsFunctionToolsAuto(tools, options = {}) {
+    if (!Array.isArray(tools)) {
+        throw new openai_agents_js_1.OpenAIAgentsConnectError("Once Connect needs an array of OpenAI Agents FunctionTool objects.", "INVALID_OPENAI_TOOLSET");
+    }
+    const registry = Object.create(null);
+    const manifest = [];
+    const internalOverrides = Object.create(null);
+    const originals = new Map();
+    for (const candidate of tools) {
+        if (!isFunctionToolLike(candidate)) {
+            throw new openai_agents_js_1.OpenAIAgentsConnectError("Once Connect v1 supports only OpenAI Agents FunctionTool objects with name, description, parameters and invoke.", "UNSUPPORTED_OPENAI_TOOL_TYPE");
+        }
+        const override = options.overrides?.[candidate.name];
+        const descriptor = descriptorFor(candidate, override);
+        manifest.push(descriptor);
+        originals.set(candidate.name, candidate);
+        registry[candidate.name] = {
+            execute: async (envelope) => await candidate.invoke(envelope.runContext, envelope.rawInput, envelope.details),
+        };
+        internalOverrides[candidate.name] = {
+            statePath: override?.statePath ?? options.statePath,
+            id: (envelope) => resolveIdentityForEnvelope(descriptor, envelope, override),
+            payload: (envelope) => resolvePayloadForEnvelope(descriptor, envelope, override),
+            reconcile: override?.reconcile,
+        };
+    }
+    if (options.overrides) {
+        for (const name of Object.keys(options.overrides)) {
+            if (!originals.has(name)) {
+                internalOverrides[name] = {};
+            }
+        }
+    }
+    const connected = (0, toolset_js_1.connectLocalAgentToolsetAuto)(registry, {
+        manifest,
+        statePath: options.statePath,
+        overrides: internalOverrides,
+    });
+    const decisions = new Map(connected.plan.entries.map(entry => [
+        entry.name,
+        entry.decision,
+    ]));
+    const wrappedTools = tools.map((tool) => {
+        const decision = decisions.get(tool.name);
+        const connectedTool = connected.tools[tool.name];
+        if (!connectedTool) {
+            throw new openai_agents_js_1.OpenAIAgentsConnectError(`Once Connect did not produce a connected implementation for "${tool.name}".`, "INVALID_OPENAI_TOOLSET");
+        }
+        const wrappedInvoke = async (runContext, rawInput, details) => {
+            const envelope = {
+                runContext,
+                rawInput,
+                details,
+                ...(decision === tool_classifier_js_1.CONNECT_TOOL_DECISION.PROTECT
+                    ? {
+                        parsedInput: parseProtectedInput(tool.name, rawInput),
+                    }
+                    : {}),
+            };
+            return await connectedTool.execute(envelope);
+        };
+        return cloneFunctionToolWithInvoke(tool, wrappedInvoke);
+    });
+    return Object.freeze({
+        plan: connected.plan,
+        tools: Object.freeze(wrappedTools),
+    });
+}
+//# sourceMappingURL=openai-function-tools.js.map

package/dist-cjs/connect/openai-function-tools.js.map

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