@once-agent/sdk 0.1.10 → 0.1.12

package/dist/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/connect/manifest.d.ts

@@ -0,0 +1,55 @@
+import { type ConnectToolClassificationReason, type ConnectToolDecision } from "./tool-classifier.js";
+export declare const CONNECT_MANIFEST_VERSION: "connect-tool-plan-v1";
+export type ConnectManifestToolSource = "native" | "openai_function" | "invalid";
+export interface ConnectManifestPlanEntry {
+    index: number;
+    name: string | null;
+    source: ConnectManifestToolSource;
+    decision: ConnectToolDecision;
+    reason: ConnectToolClassificationReason;
+    signals: readonly string[];
+}
+export interface ConnectManifestPlanSummary {
+    total: number;
+    protect: number;
+    bypass: number;
+    unknown: number;
+}
+export interface ConnectManifestPlan {
+    version: typeof CONNECT_MANIFEST_VERSION;
+    valid: boolean;
+    ready: boolean;
+    reason: "CLASSIFIED" | "INVALID_MANIFEST";
+    entries: readonly Readonly<ConnectManifestPlanEntry>[];
+    protect: readonly Readonly<ConnectManifestPlanEntry>[];
+    bypass: readonly Readonly<ConnectManifestPlanEntry>[];
+    unknown: readonly Readonly<ConnectManifestPlanEntry>[];
+    summary: Readonly<ConnectManifestPlanSummary>;
+}
+/** Internal normalized representation shared by manifest planning and toolset wiring. */
+export interface NormalizedConnectManifestTool {
+    descriptor: unknown;
+    name: string | null;
+    source: ConnectManifestToolSource;
+}
+/**
+ * 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.
+ */
+export declare function normalizeConnectToolManifest(manifest: unknown): readonly NormalizedConnectManifestTool[] | null;
+/**
+ * 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.
+ */
+export declare function planConnectToolManifest(manifest: unknown): Readonly<ConnectManifestPlan>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/connect/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/connect/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,+BAA+B,EACpC,KAAK,mBAAmB,EAEzB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,wBAAwB,EAAG,sBAA+B,CAAC;AAExE,MAAM,MAAM,yBAAyB,GACjC,QAAQ,GACR,iBAAiB,GACjB,SAAS,CAAC;AAEd,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,yBAAyB,CAAC;IAClC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,+BAA+B,CAAC;IACxC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,wBAAwB,CAAC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAAC;IAC1C,OAAO,EAAE,SAAS,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;IACvD,OAAO,EAAE,SAAS,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;IACvD,MAAM,EAAE,SAAS,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;IACtD,OAAO,EAAE,SAAS,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;IACvD,OAAO,EAAE,QAAQ,CAAC,0BAA0B,CAAC,CAAC;CAC/C;AAED,yFAAyF;AACzF,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,yBAAyB,CAAC;CACnC;AAiGD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,OAAO,GAChB,SAAS,6BAA6B,EAAE,GAAG,IAAI,CAUjD;AAiCD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,OAAO,GAChB,QAAQ,CAAC,mBAAmB,CAAC,CAkD/B"}

package/dist/connect/manifest.js

@@ -0,0 +1,166 @@
+import { CONNECT_TOOL_DECISION, classifyConnectTool, } from "./tool-classifier.js";
+export const 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.
+ */
+export 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: 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.
+ */
+export function planConnectToolManifest(manifest) {
+    const tools = normalizeConnectToolManifest(manifest);
+    if (!tools) {
+        return invalidPlan();
+    }
+    const entries = tools.map((tool, index) => {
+        const classification = 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 === CONNECT_TOOL_DECISION.PROTECT);
+    const bypass = entries.filter(entry => entry.decision === CONNECT_TOOL_DECISION.BYPASS);
+    const unknown = entries.filter(entry => entry.decision === CONNECT_TOOL_DECISION.UNKNOWN);
+    const summary = Object.freeze({
+        total: entries.length,
+        protect: protect.length,
+        bypass: bypass.length,
+        unknown: unknown.length,
+    });
+    return Object.freeze({
+        version: 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/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/connect/openai-function-tools.d.ts

@@ -0,0 +1,66 @@
+import { type ConnectToolAnnotations } from "./tool-classifier.js";
+import type { ConnectManifestPlan } from "./manifest.js";
+import type { LocalObservation } from "../local.js";
+export { OpenAIAgentsConnectError, } from "./openai-agents.js";
+export type OpenAIAgentsParsedToolInput = Record<string, unknown>;
+/**
+ * Structural subset of the current @openai/agents FunctionTool contract.
+ *
+ * Once intentionally does not depend on @openai/agents at runtime. Keeping the
+ * adapter structural avoids forcing an Agents SDK version onto applications
+ * that already own that dependency.
+ */
+export interface OpenAIAgentsFunctionToolLike {
+    type: "function";
+    name: string;
+    description: string;
+    parameters: unknown;
+    invoke(runContext: unknown, input: string, details?: unknown): Promise<unknown>;
+    [key: string]: unknown;
+}
+export interface OpenAIAgentsFunctionToolOverride {
+    /** Optional explicit Connect safety annotations for ambiguous tool names/descriptions. */
+    annotations?: ConnectToolAnnotations;
+    /** Optional Once metadata such as identityFields/effectFields. */
+    _meta?: Record<string, unknown>;
+    /** Optional explicit stable identity selector over parsed tool arguments. */
+    id?: (input: OpenAIAgentsParsedToolInput) => string;
+    /** Optional explicit consequential payload selector over parsed tool arguments. */
+    payload?: (input: OpenAIAgentsParsedToolInput) => Record<string, unknown>;
+    /** Optional per-tool state path override. */
+    statePath?: string;
+    /** Optional provider reconciliation hook. */
+    reconcile?: (context: {
+        id: string;
+        payload: Record<string, unknown>;
+    }) => Promise<LocalObservation<unknown>> | LocalObservation<unknown>;
+}
+export interface ConnectOpenAIAgentsFunctionToolsOptions {
+    /** Shared default SQLite state path for protected local function tools. */
+    statePath?: string;
+    /** Optional per-tool metadata and escape hatches. */
+    overrides?: Readonly<Record<string, OpenAIAgentsFunctionToolOverride | undefined>>;
+}
+export interface ConnectedOpenAIAgentsFunctionTools<T extends readonly OpenAIAgentsFunctionToolLike[]> {
+    /** The exact Connect protection plan used to wrap the tools. */
+    plan: Readonly<ConnectManifestPlan>;
+    /** New FunctionTool objects. The input array and originals are not mutated. */
+    tools: Readonly<{
+        [K in keyof T]: T[K];
+    }>;
+}
+/**
+ * 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.
+ */
+export declare function connectOpenAIAgentsFunctionToolsAuto<T extends readonly OpenAIAgentsFunctionToolLike[]>(tools: T, options?: ConnectOpenAIAgentsFunctionToolsOptions): Readonly<ConnectedOpenAIAgentsFunctionTools<T>>;
+//# sourceMappingURL=openai-function-tools.d.ts.map

package/dist/connect/openai-function-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-function-tools.d.ts","sourceRoot":"","sources":["../../src/connect/openai-function-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAkB9B,OAAO,KAAK,EACV,mBAAmB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,2BAA2B,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CACJ,UAAU,EAAE,OAAO,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gCAAgC;IAC/C,0FAA0F;IAC1F,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,6EAA6E;IAC7E,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,MAAM,CAAC;IACpD,mFAAmF;IACnF,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,2BAA2B,KAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,KACG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAClC,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,uCAAuC;IACtD,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,QAAQ,CAClB,MAAM,CACJ,MAAM,EACN,gCAAgC,GAAG,SAAS,CAC7C,CACF,CAAC;CACH;AAED,MAAM,WAAW,kCAAkC,CACjD,CAAC,SAAS,SAAS,4BAA4B,EAAE;IAEjD,gEAAgE;IAChE,IAAI,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACpC,+EAA+E;IAC/E,KAAK,EAAE,QAAQ,CAAC;SACb,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KACrB,CAAC,CAAC;CACJ;AAoLD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oCAAoC,CAClD,CAAC,SAAS,SAAS,4BAA4B,EAAE,EAEjD,KAAK,EAAE,CAAC,EACR,OAAO,GAAE,uCAA4C,GACpD,QAAQ,CAAC,kCAAkC,CAAC,CAAC,CAAC,CAAC,CA8HjD"}

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

@@ -0,0 +1,182 @@
+import { CONNECT_TOOL_DECISION, } from "./tool-classifier.js";
+import { resolveConnectToolOperationIdentity, } from "./identity.js";
+import { resolveConnectToolEffectPayload, } from "./payload.js";
+import { connectLocalAgentToolsetAuto, } from "./toolset.js";
+import { AgentToolConnectionError, } from "./local-agent-tool.js";
+import { OpenAIAgentsConnectError, } from "./openai-agents.js";
+export { OpenAIAgentsConnectError, } from "./openai-agents.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 parseProtectedInput(toolName, rawInput) {
+    if (typeof rawInput !== "string") {
+        throw new 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 OpenAIAgentsConnectError(`Once Connect could not parse protected OpenAI Agents tool input for "${toolName}".`, "INVALID_OPENAI_TOOL_INPUT");
+    }
+    if (!isObject(parsed)) {
+        throw new 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 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 = resolveConnectToolOperationIdentity({
+        tool: 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);
+}
+function resolvePayloadForEnvelope(descriptor, envelope, override) {
+    const input = requireParsedInput(descriptor.name, envelope);
+    if (typeof override?.payload === "function") {
+        return override.payload(input);
+    }
+    const result = resolveConnectToolEffectPayload({
+        tool: descriptor,
+        input,
+    });
+    if (result.status === "FOUND") {
+        return { ...result.payload };
+    }
+    throw new 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.
+ */
+export function connectOpenAIAgentsFunctionToolsAuto(tools, options = {}) {
+    if (!Array.isArray(tools)) {
+        throw new 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 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 = 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 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 === 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/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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"}

package/dist/connect/payload.d.ts

@@ -0,0 +1,30 @@
+import type { ConnectToolDescriptor } from "./tool-classifier.js";
+export type ConnectPayloadSource = "full_input" | "meta:effect_fields";
+export type ConnectEffectPayloadResult = Readonly<{
+    status: "FOUND";
+    payload: Readonly<Record<string, unknown>>;
+    source: ConnectPayloadSource;
+    reason: string;
+}> | Readonly<{
+    status: "REQUIRED";
+    reason: string;
+}>;
+export interface ResolveConnectEffectPayloadInput {
+    tool: Pick<ConnectToolDescriptor, "name" | "_meta">;
+    input: unknown;
+}
+/**
+ * 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.
+ */
+export declare function resolveConnectToolEffectPayload(request: ResolveConnectEffectPayloadInput): ConnectEffectPayloadResult;
+//# sourceMappingURL=payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/connect/payload.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,oBAAoB,GAC5B,YAAY,GACZ,oBAAoB,CAAC;AAEzB,MAAM,MAAM,0BAA0B,GAClC,QAAQ,CAAC;IACP,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,GACF,QAAQ,CAAC;IACP,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEP,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACpD,KAAK,EAAE,OAAO,CAAC;CAChB;AAkED;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,0BAA0B,CA6E5B"}