@once-agent/sdk 0.1.10 → 0.1.12

package/dist-cjs/execution-observation.js

@@ -0,0 +1,330 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executionToolFingerprint = executionToolFingerprint;
+exports.observeToolExecution = observeToolExecution;
+exports.aggregateToolExecutions = aggregateToolExecutions;
+exports.promoteToolExecution = promoteToolExecution;
+const node_crypto_1 = require("node:crypto");
+const tool_importance_js_1 = require("./tool-importance.js");
+const VALID_STATUS = new Set([
+    "SUCCEEDED",
+    "FAILED",
+    "UNKNOWN",
+]);
+const VALID_SOURCE = new Set([
+    "framework_callback",
+    "otel",
+    "adapter",
+]);
+function ownDataValue(value, key) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    return descriptor && "value" in descriptor
+        ? descriptor.value
+        : undefined;
+}
+function optionalString(value) {
+    return typeof value === "string" && value.trim() !== ""
+        ? value
+        : undefined;
+}
+function validTimestamp(value) {
+    if (value === undefined) {
+        return new Date().toISOString();
+    }
+    if (typeof value !== "string" || value.trim() === "") {
+        return undefined;
+    }
+    const time = Date.parse(value);
+    if (!Number.isFinite(time))
+        return undefined;
+    return new Date(time).toISOString();
+}
+function canonicalFingerprintValue(value, depth = 0, seen = new Set()) {
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? value : null;
+    }
+    if (typeof value !== "object" || depth > 12) {
+        return undefined;
+    }
+    const objectValue = value;
+    if (seen.has(objectValue))
+        return "<cycle>";
+    seen.add(objectValue);
+    try {
+        if (Array.isArray(value)) {
+            const output = [];
+            for (let index = 0; index < value.length; index++) {
+                const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+                output.push(descriptor && "value" in descriptor
+                    ? canonicalFingerprintValue(descriptor.value, depth + 1, seen)
+                    : "<opaque>");
+            }
+            return output;
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            return "<opaque>";
+        }
+        const output = {};
+        const descriptors = Object.getOwnPropertyDescriptors(value);
+        for (const key of Object.keys(descriptors).sort()) {
+            const descriptor = descriptors[key];
+            if (!("value" in descriptor))
+                continue;
+            const child = canonicalFingerprintValue(descriptor.value, depth + 1, seen);
+            if (child !== undefined)
+                output[key] = child;
+        }
+        return output;
+    }
+    finally {
+        seen.delete(objectValue);
+    }
+}
+/**
+ * Stable fingerprint of the safe descriptor already retained by discovery.
+ * This closes same-name/toolId collision risk without reading executable or
+ * getter-backed runtime state.
+ */
+function executionToolFingerprint(tool) {
+    const canonical = canonicalFingerprintValue({
+        namespacedName: tool.namespacedName,
+        canonicalName: tool.canonicalName,
+        description: tool.description ?? "",
+        toolType: tool.toolType ?? "",
+        inputSchema: tool.inputSchema,
+        safeMetadata: tool.safeMetadata,
+    });
+    return (0, node_crypto_1.createHash)("sha256")
+        .update(JSON.stringify(canonical))
+        .digest("hex");
+}
+/**
+ * Convert callback/telemetry metadata into a secret-minimal execution event.
+ *
+ * This function intentionally whitelists fields. Tool arguments, prompts,
+ * results, error messages, auth data, callbacks and runtime objects are never
+ * copied into the observation, even when present on the input object.
+ */
+function observeToolExecution(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        return Object.freeze({
+            accepted: false,
+            reason: "INVALID_EVENT",
+        });
+    }
+    const toolId = optionalString(ownDataValue(input, "toolId"));
+    const namespacedName = optionalString(ownDataValue(input, "namespacedName"));
+    if (!toolId && !namespacedName) {
+        return Object.freeze({
+            accepted: false,
+            reason: "IDENTITY_REQUIRED",
+        });
+    }
+    const status = ownDataValue(input, "status");
+    if (typeof status !== "string" || !VALID_STATUS.has(status)) {
+        return Object.freeze({
+            accepted: false,
+            reason: "INVALID_STATUS",
+        });
+    }
+    const source = ownDataValue(input, "source");
+    if (typeof source !== "string" || !VALID_SOURCE.has(source)) {
+        return Object.freeze({
+            accepted: false,
+            reason: "INVALID_SOURCE",
+        });
+    }
+    const observedAt = validTimestamp(ownDataValue(input, "observedAt"));
+    if (!observedAt) {
+        return Object.freeze({
+            accepted: false,
+            reason: "INVALID_TIMESTAMP",
+        });
+    }
+    const rawDuration = ownDataValue(input, "durationMs");
+    if (rawDuration !== undefined &&
+        (typeof rawDuration !== "number" ||
+            !Number.isFinite(rawDuration) ||
+            rawDuration < 0)) {
+        return Object.freeze({
+            accepted: false,
+            reason: "INVALID_DURATION",
+        });
+    }
+    const eventId = optionalString(ownDataValue(input, "eventId"));
+    const descriptorFingerprint = optionalString(ownDataValue(input, "descriptorFingerprint"));
+    const canonicalName = optionalString(ownDataValue(input, "canonicalName"));
+    const framework = optionalString(ownDataValue(input, "framework"));
+    const runtimeName = optionalString(ownDataValue(input, "runtimeName"));
+    const event = Object.freeze({
+        ...(eventId ? { eventId } : {}),
+        ...(toolId ? { toolId } : {}),
+        ...(namespacedName ? { namespacedName } : {}),
+        ...(descriptorFingerprint ? { descriptorFingerprint } : {}),
+        ...(canonicalName ? { canonicalName } : {}),
+        ...(framework ? { framework } : {}),
+        ...(runtimeName ? { runtimeName } : {}),
+        source: source,
+        status: status,
+        observedAt,
+        ...(typeof rawDuration === "number"
+            ? { durationMs: rawDuration }
+            : {}),
+    });
+    return Object.freeze({
+        accepted: true,
+        event,
+    });
+}
+function identityKey(event) {
+    const identity = event.toolId
+        ? `tool:${event.toolId}`
+        : `name:${event.namespacedName}`;
+    return event.descriptorFingerprint
+        ? `${identity}:descriptor:${event.descriptorFingerprint}`
+        : identity;
+}
+function compareTimestamp(left, right) {
+    return Date.parse(left) - Date.parse(right);
+}
+/**
+ * Aggregate already-observed execution metadata without retaining raw call data.
+ * Duplicate event IDs are ignored so replayed telemetry batches do not inflate
+ * observed execution counts.
+ */
+function aggregateToolExecutions(inputs) {
+    const accepted = [];
+    let rejectedEventCount = 0;
+    let duplicateEventCount = 0;
+    const seenEventIds = new Set();
+    for (const input of inputs) {
+        const result = observeToolExecution(input);
+        if (!result.accepted) {
+            rejectedEventCount += 1;
+            continue;
+        }
+        if (result.event.eventId) {
+            if (seenEventIds.has(result.event.eventId)) {
+                duplicateEventCount += 1;
+                continue;
+            }
+            seenEventIds.add(result.event.eventId);
+        }
+        accepted.push(result.event);
+    }
+    const groups = new Map();
+    for (const event of accepted) {
+        const key = identityKey(event);
+        const existing = groups.get(key);
+        if (existing) {
+            existing.push(event);
+        }
+        else {
+            groups.set(key, [event]);
+        }
+    }
+    const summaries = [];
+    for (const [key, events] of groups.entries()) {
+        const ordered = [...events].sort((left, right) => compareTimestamp(left.observedAt, right.observedAt));
+        const first = ordered[0];
+        const last = ordered[ordered.length - 1];
+        const durations = ordered
+            .map(event => event.durationMs)
+            .filter((value) => typeof value === "number");
+        const totalDurationMs = durations.reduce((sum, value) => sum + value, 0);
+        const sources = Object.freeze([
+            ...new Set(ordered.map(event => event.source)),
+        ]);
+        summaries.push(Object.freeze({
+            identityKey: key,
+            ...(last.toolId ? { toolId: last.toolId } : {}),
+            ...(last.namespacedName ? { namespacedName: last.namespacedName } : {}),
+            ...(last.descriptorFingerprint
+                ? { descriptorFingerprint: last.descriptorFingerprint }
+                : {}),
+            ...(last.canonicalName ? { canonicalName: last.canonicalName } : {}),
+            ...(last.framework ? { framework: last.framework } : {}),
+            ...(last.runtimeName ? { runtimeName: last.runtimeName } : {}),
+            callCount: ordered.length,
+            succeededCount: ordered.filter(event => event.status === "SUCCEEDED").length,
+            failedCount: ordered.filter(event => event.status === "FAILED").length,
+            unknownCount: ordered.filter(event => event.status === "UNKNOWN").length,
+            firstObservedAt: first.observedAt,
+            lastObservedAt: last.observedAt,
+            latestStatus: last.status,
+            ...(durations.length > 0
+                ? {
+                    totalDurationMs,
+                    averageDurationMs: totalDurationMs / durations.length,
+                }
+                : {}),
+            sources,
+        }));
+    }
+    summaries.sort((left, right) => left.identityKey.localeCompare(right.identityKey));
+    return Object.freeze({
+        summaries: Object.freeze(summaries),
+        acceptedEventCount: accepted.length,
+        rejectedEventCount,
+        duplicateEventCount,
+    });
+}
+function summaryMatchesTool(tool, summary) {
+    if (!summary.descriptorFingerprint)
+        return false;
+    if (summary.descriptorFingerprint !== executionToolFingerprint(tool)) {
+        return false;
+    }
+    if (summary.toolId && summary.toolId !== tool.toolId) {
+        return false;
+    }
+    if (summary.namespacedName &&
+        summary.namespacedName !== tool.namespacedName) {
+        return false;
+    }
+    return Boolean(summary.toolId || summary.namespacedName);
+}
+/**
+ * Promote a discovered tool to EXECUTED evidence only after exact identity
+ * correlation plus a safe-descriptor fingerprint match. Canonical/display
+ * names alone are never sufficient because same-named tools may exist in
+ * different agents, runtimes or servers and older discovery IDs may collide.
+ */
+function promoteToolExecution(tool, summary) {
+    if (!summaryMatchesTool(tool, summary)) {
+        return undefined;
+    }
+    const visibility = Object.freeze({
+        ...tool.visibility,
+        executed: true,
+    });
+    const once = (0, tool_importance_js_1.assessToolImportance)({
+        name: tool.canonicalName,
+        description: tool.description,
+        sourceCategory: tool.toolType,
+        evidence: "EXECUTED",
+        qualification: tool.once.qualification,
+        protection: tool.once.protection,
+        readOnlyHint: tool.once.effectClass === "READ_ONLY"
+            ? true
+            : undefined,
+    });
+    return Object.freeze({
+        ...tool,
+        evidence: Object.freeze({
+            level: "EXECUTED",
+            source: `execution:${summary.sources.join(",")}`,
+        }),
+        visibility,
+        execution: summary,
+        once,
+    });
+}
+//# sourceMappingURL=execution-observation.js.map

package/dist-cjs/execution-observation.js.map

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

package/dist-cjs/gateway/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectOpenAIAgentsFunctionToolsGatewayAuto = exports.bindGatewayPlanToToolGraph = exports.connectLocalGatewayToolsetAuto = exports.GatewayConnectionError = exports.planGatewayToolset = exports.gatewayDescriptorFingerprint = exports.GATEWAY_PLAN_VERSION = exports.GATEWAY_ROUTE = void 0;
+var planner_js_1 = require("./planner.js");
+Object.defineProperty(exports, "GATEWAY_ROUTE", { enumerable: true, get: function () { return planner_js_1.GATEWAY_ROUTE; } });
+Object.defineProperty(exports, "GATEWAY_PLAN_VERSION", { enumerable: true, get: function () { return planner_js_1.GATEWAY_PLAN_VERSION; } });
+Object.defineProperty(exports, "gatewayDescriptorFingerprint", { enumerable: true, get: function () { return planner_js_1.gatewayDescriptorFingerprint; } });
+Object.defineProperty(exports, "planGatewayToolset", { enumerable: true, get: function () { return planner_js_1.planGatewayToolset; } });
+var local_toolset_js_1 = require("./local-toolset.js");
+Object.defineProperty(exports, "GatewayConnectionError", { enumerable: true, get: function () { return local_toolset_js_1.GatewayConnectionError; } });
+Object.defineProperty(exports, "connectLocalGatewayToolsetAuto", { enumerable: true, get: function () { return local_toolset_js_1.connectLocalGatewayToolsetAuto; } });
+var tool_graph_binding_js_1 = require("./tool-graph-binding.js");
+Object.defineProperty(exports, "bindGatewayPlanToToolGraph", { enumerable: true, get: function () { return tool_graph_binding_js_1.bindGatewayPlanToToolGraph; } });
+var openai_function_tools_js_1 = require("./openai-function-tools.js");
+Object.defineProperty(exports, "connectOpenAIAgentsFunctionToolsGatewayAuto", { enumerable: true, get: function () { return openai_function_tools_js_1.connectOpenAIAgentsFunctionToolsGatewayAuto; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gateway/index.ts"],"names":[],"mappings":";;;AAAA,2CAKsB;AAJpB,2GAAA,aAAa,OAAA;AACb,kHAAA,oBAAoB,OAAA;AACpB,0HAAA,4BAA4B,OAAA;AAC5B,gHAAA,kBAAkB,OAAA;AAGpB,uDAG4B;AAF1B,0HAAA,sBAAsB,OAAA;AACtB,kIAAA,8BAA8B,OAAA;AAGhC,iEAEiC;AAD/B,mIAAA,0BAA0B,OAAA;AAG5B,uEAEoC;AADlC,uJAAA,2CAA2C,OAAA"}

package/dist-cjs/gateway/local-toolset.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GatewayConnectionError = void 0;
+exports.connectLocalGatewayToolsetAuto = connectLocalGatewayToolsetAuto;
+const toolset_js_1 = require("../connect/toolset.js");
+const planner_js_1 = require("./planner.js");
+const tool_graph_binding_js_1 = require("./tool-graph-binding.js");
+class GatewayConnectionError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "GatewayConnectionError";
+    }
+}
+exports.GatewayConnectionError = GatewayConnectionError;
+function blockedSummary(plan) {
+    return plan.blocked
+        .map(entry => `${entry.name ?? `#${entry.index}`}:${entry.connectReason}`)
+        .join(", ");
+}
+function bindingBlockedSummary(plan) {
+    return plan.blocked
+        .map(entry => `${entry.name ?? `#${entry.index}`}:${entry.bindingStatus}`)
+        .join(", ");
+}
+function verifyConnectAgreement(gatewayPlan, connectPlan) {
+    if (gatewayPlan.entries.length !== connectPlan.entries.length) {
+        throw new GatewayConnectionError("GATEWAY_PLAN_MISMATCH", "Gateway and Connect disagree about the selected toolset length.");
+    }
+    for (let index = 0; index < gatewayPlan.entries.length; index += 1) {
+        const gateway = gatewayPlan.entries[index];
+        const connect = connectPlan.entries[index];
+        const expected = gateway.route === planner_js_1.GATEWAY_ROUTE.DIRECT
+            ? "BYPASS"
+            : gateway.route === planner_js_1.GATEWAY_ROUTE.PROTECT
+                ? "PROTECT"
+                : "UNKNOWN";
+        if (connect.decision !== expected) {
+            throw new GatewayConnectionError("GATEWAY_PLAN_MISMATCH", `Gateway and Connect disagree about route index ${index}.`);
+        }
+    }
+}
+/**
+ * Wire a complete runtime-selected local tool subset through the Once Gateway.
+ *
+ * This function intentionally contains no execution engine. It performs a
+ * gateway preflight, optionally binds exact Tool Graph identity, then delegates
+ * registry validation and wrapper creation to the existing Connect toolset.
+ *
+ * A selected subset containing BLOCK cannot be partially wired. Returning a
+ * mixed registry would leave an unprotected bypass surface for unresolved
+ * tools, so v1 fails the whole selected subset closed.
+ */
+function connectLocalGatewayToolsetAuto(tools, options) {
+    if (!options || !("manifest" in options)) {
+        throw new GatewayConnectionError("INVALID_GATEWAY_MANIFEST", "Once Gateway needs the complete runtime-selected tool manifest before wiring.");
+    }
+    const plan = (0, planner_js_1.planGatewayToolset)(options.manifest);
+    if (!plan.valid) {
+        throw new GatewayConnectionError("INVALID_GATEWAY_MANIFEST", "Once Gateway could not parse the supplied runtime-selected tool manifest.");
+    }
+    if (!plan.ready) {
+        throw new GatewayConnectionError("GATEWAY_BLOCKED", `Once Gateway refuses partial wiring while selected-tool routing is unresolved: ${blockedSummary(plan)}.`);
+    }
+    let binding;
+    if (options.toolGraphBindings !== undefined) {
+        if (!Array.isArray(options.toolGraphBindings)) {
+            throw new GatewayConnectionError("INVALID_TOOL_GRAPH_BINDINGS", "Once Gateway Tool Graph bindings must be an array of safe identity records.");
+        }
+        binding = (0, tool_graph_binding_js_1.bindGatewayPlanToToolGraph)(plan, options.toolGraphBindings);
+        if (!binding.ready) {
+            throw new GatewayConnectionError("GATEWAY_TOOL_GRAPH_BLOCKED", `Once Gateway refuses wiring because selected tools do not match exact Tool Graph identity: ${bindingBlockedSummary(binding)}.`);
+        }
+    }
+    const connected = (0, toolset_js_1.connectLocalAgentToolsetAuto)(tools, options);
+    verifyConnectAgreement(plan, connected.plan);
+    return Object.freeze({
+        plan,
+        ...(binding ? { binding } : {}),
+        tools: connected.tools,
+    });
+}
+//# sourceMappingURL=local-toolset.js.map

package/dist-cjs/gateway/local-toolset.js.map

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

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

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectOpenAIAgentsFunctionToolsGatewayAuto = connectOpenAIAgentsFunctionToolsGatewayAuto;
+const openai_function_tools_js_1 = require("../connect/openai-function-tools.js");
+const local_toolset_js_1 = require("./local-toolset.js");
+const planner_js_1 = require("./planner.js");
+const tool_graph_binding_js_1 = require("./tool-graph-binding.js");
+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 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 blockedSummary(plan) {
+    return plan.blocked
+        .map(entry => `${entry.name ?? `#${entry.index}`}:${entry.connectReason}`)
+        .join(", ");
+}
+function bindingBlockedSummary(plan) {
+    return plan.blocked
+        .map(entry => `${entry.name ?? `#${entry.index}`}:${entry.bindingStatus}`)
+        .join(", ");
+}
+function verifyConnectAgreement(gatewayPlan, connectEntries) {
+    if (gatewayPlan.entries.length !== connectEntries.length) {
+        throw new local_toolset_js_1.GatewayConnectionError("GATEWAY_PLAN_MISMATCH", "OpenAI Gateway and Connect disagree about the FunctionTool subset length.");
+    }
+    for (let index = 0; index < gatewayPlan.entries.length; index += 1) {
+        const gateway = gatewayPlan.entries[index];
+        const expected = gateway.route === planner_js_1.GATEWAY_ROUTE.DIRECT
+            ? "BYPASS"
+            : gateway.route === planner_js_1.GATEWAY_ROUTE.PROTECT
+                ? "PROTECT"
+                : "UNKNOWN";
+        if (connectEntries[index]?.decision !== expected) {
+            throw new local_toolset_js_1.GatewayConnectionError("GATEWAY_PLAN_MISMATCH", `OpenAI Gateway and Connect disagree about FunctionTool route index ${index}.`);
+        }
+    }
+}
+/**
+ * Route an already-selected OpenAI Agents FunctionTool subset through Once.
+ *
+ * Gateway owns only preflight/routing identity. Actual FunctionTool wrapping,
+ * protected input parsing, logical-operation identity, payload binding,
+ * replay and reconciliation remain delegated to the existing proven Connect
+ * adapter. The supplied subset is never expanded with Tool Graph catalog
+ * entries.
+ */
+function connectOpenAIAgentsFunctionToolsGatewayAuto(tools, options = {}) {
+    if (!Array.isArray(tools)) {
+        throw new local_toolset_js_1.GatewayConnectionError("INVALID_OPENAI_GATEWAY_TOOLSET", "Once Gateway needs the runtime-selected OpenAI Agents FunctionTool array.");
+    }
+    const manifest = [];
+    const names = new Set();
+    for (const candidate of tools) {
+        if (!isFunctionToolLike(candidate)) {
+            throw new local_toolset_js_1.GatewayConnectionError("UNSUPPORTED_OPENAI_GATEWAY_TOOL_TYPE", "Once Gateway v1 supports only OpenAI Agents FunctionTool objects in this adapter.");
+        }
+        if (names.has(candidate.name)) {
+            throw new local_toolset_js_1.GatewayConnectionError("DUPLICATE_OPENAI_GATEWAY_TOOL_NAME", `Once Gateway cannot safely map duplicate OpenAI FunctionTool name "${candidate.name}".`);
+        }
+        names.add(candidate.name);
+        manifest.push(descriptorFor(candidate, options.overrides?.[candidate.name]));
+    }
+    if (options.overrides) {
+        for (const name of Object.keys(options.overrides)) {
+            if (!names.has(name)) {
+                throw new local_toolset_js_1.GatewayConnectionError("UNDECLARED_OPENAI_GATEWAY_OVERRIDE", `Gateway override "${name}" does not correspond to a supplied FunctionTool.`);
+            }
+        }
+    }
+    const plan = (0, planner_js_1.planGatewayToolset)(manifest);
+    if (!plan.valid) {
+        throw new local_toolset_js_1.GatewayConnectionError("INVALID_OPENAI_GATEWAY_TOOLSET", "Once Gateway could not plan the supplied OpenAI FunctionTool subset.");
+    }
+    if (!plan.ready) {
+        throw new local_toolset_js_1.GatewayConnectionError("GATEWAY_BLOCKED", `Once Gateway refuses unresolved OpenAI FunctionTool routing: ${blockedSummary(plan)}.`);
+    }
+    let binding;
+    if (options.toolGraphBindings !== undefined) {
+        if (!Array.isArray(options.toolGraphBindings)) {
+            throw new local_toolset_js_1.GatewayConnectionError("INVALID_TOOL_GRAPH_BINDINGS", "OpenAI Gateway Tool Graph bindings must be an array of safe identity records.");
+        }
+        binding = (0, tool_graph_binding_js_1.bindGatewayPlanToToolGraph)(plan, options.toolGraphBindings);
+        if (!binding.ready) {
+            throw new local_toolset_js_1.GatewayConnectionError("GATEWAY_TOOL_GRAPH_BLOCKED", `OpenAI Gateway refuses stale or ambiguous Tool Graph identity: ${bindingBlockedSummary(binding)}.`);
+        }
+    }
+    const { toolGraphBindings: _toolGraphBindings, ...connectOptions } = options;
+    const connected = (0, openai_function_tools_js_1.connectOpenAIAgentsFunctionToolsAuto)(tools, connectOptions);
+    verifyConnectAgreement(plan, connected.plan.entries);
+    if (connected.tools.length !== tools.length) {
+        throw new local_toolset_js_1.GatewayConnectionError("GATEWAY_SUBSET_MISMATCH", "OpenAI Gateway changed the size of the runtime-selected FunctionTool subset.");
+    }
+    return Object.freeze({
+        plan,
+        ...(binding ? { binding } : {}),
+        tools: connected.tools,
+    });
+}
+//# sourceMappingURL=openai-function-tools.js.map

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

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