qlogicagent 0.1.0

package/dist/orchestration/tool-choice-policy.d.ts

@@ -0,0 +1,55 @@
+import type { RuntimeToolEligibilityContract } from "qlogicagent-runtime-contracts";
+export type ToolChoiceLike = "auto" | "none" | "required" | {
+    type: "function";
+    function?: {
+        name?: string;
+    };
+} | Record<string, unknown> | undefined;
+export interface ToolChoiceToolLike {
+    type?: string;
+    function?: {
+        name?: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+    };
+    name?: string;
+    description?: string;
+    requiresApproval?: boolean;
+}
+export type ToolEligibilityLike = RuntimeToolEligibilityContract;
+export interface ToolChoiceCompatibilityPolicy {
+    allowNamedToolChoice?: boolean;
+    allowRequiredToolChoice?: boolean;
+    requiredFallback?: "required" | "auto" | "none";
+    namedFallback?: "required" | "auto" | "none";
+    requireAutoWhenThinking?: boolean;
+}
+export interface ApplyToolChoicePolicyInput<TTool extends ToolChoiceToolLike> {
+    tools: readonly TTool[];
+    toolChoice: ToolChoiceLike;
+    eligibility?: readonly ToolEligibilityLike[];
+    thinkingEnabled?: boolean;
+    compatibility?: ToolChoiceCompatibilityPolicy;
+}
+export interface ApplyToolChoicePolicyResult<TTool extends ToolChoiceToolLike> {
+    tools: TTool[];
+    normalizedToolChoice?: ToolChoiceLike;
+    extraSystemPrompt?: string;
+    warnings: string[];
+}
+export declare function filterEligibleTools<TTool extends ToolChoiceToolLike>(params: {
+    tools: readonly TTool[];
+    eligibility?: readonly ToolEligibilityLike[];
+}): TTool[];
+export declare function normalizeAnthropicFunctionToolDefinition(tool: unknown): Record<string, unknown> | undefined;
+export declare function normalizeAnthropicToolChoice(toolChoice: unknown): unknown;
+export declare function applyToolChoiceCompatibility(params: {
+    toolChoice: ToolChoiceLike;
+    thinkingEnabled?: boolean;
+    compatibility?: ToolChoiceCompatibilityPolicy;
+}): {
+    normalizedToolChoice?: ToolChoiceLike;
+    warnings: string[];
+};
+export declare function applyToolChoicePolicy<TTool extends ToolChoiceToolLike>(params: ApplyToolChoicePolicyInput<TTool>): ApplyToolChoicePolicyResult<TTool>;
+//# sourceMappingURL=tool-choice-policy.d.ts.map

package/dist/orchestration/tool-choice-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-choice-policy.d.ts","sourceRoot":"","sources":["../../src/orchestration/tool-choice-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAEpF,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,UAAU,GACV;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAClD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,SAAS,CAAC;AAEd,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAEjE,MAAM,WAAW,6BAA6B;IAC5C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,gBAAgB,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAChD,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7C,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,0BAA0B,CAAC,KAAK,SAAS,kBAAkB;IAC1E,KAAK,EAAE,SAAS,KAAK,EAAE,CAAC;IACxB,UAAU,EAAE,cAAc,CAAC;IAC3B,WAAW,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,6BAA6B,CAAC;CAC/C;AAED,MAAM,WAAW,2BAA2B,CAAC,KAAK,SAAS,kBAAkB;IAC3E,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,oBAAoB,CAAC,EAAE,cAAc,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAsBD,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,kBAAkB,EAAE,MAAM,EAAE;IAC5E,KAAK,EAAE,SAAS,KAAK,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC9C,GAAG,KAAK,EAAE,CAcV;AAED,wBAAgB,wCAAwC,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAoC3G;AAED,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAuBzE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,UAAU,EAAE,cAAc,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,6BAA6B,CAAC;CAC/C,GAAG;IAAE,oBAAoB,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAkChE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,kBAAkB,EACpE,MAAM,EAAE,0BAA0B,CAAC,KAAK,CAAC,GACxC,2BAA2B,CAAC,KAAK,CAAC,CAyDpC"}

package/dist/orchestration/tool-choice-policy.js

@@ -0,0 +1,165 @@
+function resolveToolName(tool) {
+    if (tool.function && typeof tool.function === "object" && typeof tool.function.name === "string") {
+        return tool.function.name.trim();
+    }
+    if (typeof tool.name === "string") {
+        return tool.name.trim();
+    }
+    return "";
+}
+function isEligibleStatus(status) {
+    return status === "enabled-eligible" || status === "installed-awaiting-approval";
+}
+function buildEligibilityMap(eligibility) {
+    return new Map((eligibility ?? []).map((entry) => [entry.toolName, entry]));
+}
+export function filterEligibleTools(params) {
+    if (!params.eligibility?.length) {
+        return [...params.tools];
+    }
+    const eligibilityMap = buildEligibilityMap(params.eligibility);
+    return params.tools.filter((tool) => {
+        const name = resolveToolName(tool);
+        if (!name) {
+            return false;
+        }
+        const eligibility = eligibilityMap.get(name);
+        return !eligibility || isEligibleStatus(eligibility.status);
+    });
+}
+export function normalizeAnthropicFunctionToolDefinition(tool) {
+    if (!tool || typeof tool !== "object" || Array.isArray(tool)) {
+        return undefined;
+    }
+    const toolRecord = tool;
+    if (toolRecord.function && typeof toolRecord.function === "object") {
+        return toolRecord;
+    }
+    const name = typeof toolRecord.name === "string" ? toolRecord.name.trim() : "";
+    if (!name) {
+        return toolRecord;
+    }
+    const functionSpec = {
+        name,
+        parameters: toolRecord.input_schema && typeof toolRecord.input_schema === "object"
+            ? toolRecord.input_schema
+            : toolRecord.parameters && typeof toolRecord.parameters === "object"
+                ? toolRecord.parameters
+                : { type: "object", properties: {} },
+    };
+    if (typeof toolRecord.description === "string" && toolRecord.description.trim()) {
+        functionSpec.description = toolRecord.description;
+    }
+    if (typeof toolRecord.strict === "boolean") {
+        functionSpec.strict = toolRecord.strict;
+    }
+    return {
+        type: "function",
+        function: functionSpec,
+    };
+}
+export function normalizeAnthropicToolChoice(toolChoice) {
+    if (!toolChoice || typeof toolChoice !== "object" || Array.isArray(toolChoice)) {
+        return toolChoice;
+    }
+    const choice = toolChoice;
+    if (choice.type === "auto") {
+        return "auto";
+    }
+    if (choice.type === "none") {
+        return "none";
+    }
+    if (choice.type === "required" || choice.type === "any") {
+        return "required";
+    }
+    if (choice.type === "tool" && typeof choice.name === "string" && choice.name.trim()) {
+        return {
+            type: "function",
+            function: { name: choice.name.trim() },
+        };
+    }
+    return toolChoice;
+}
+export function applyToolChoiceCompatibility(params) {
+    const warnings = [];
+    const compatibility = params.compatibility ?? {};
+    let normalizedToolChoice = params.toolChoice;
+    if (params.thinkingEnabled && compatibility.requireAutoWhenThinking) {
+        const type = typeof normalizedToolChoice === "object" && normalizedToolChoice && !Array.isArray(normalizedToolChoice)
+            ? String(normalizedToolChoice.type ?? "")
+            : normalizedToolChoice;
+        if (type && type !== "auto" && type !== "none") {
+            warnings.push("tool_choice downgraded to auto because thinking mode requires auto/none compatibility.");
+            normalizedToolChoice = "auto";
+        }
+    }
+    if (normalizedToolChoice === "required" && compatibility.allowRequiredToolChoice === false) {
+        const fallback = compatibility.requiredFallback ?? "auto";
+        warnings.push(`tool_choice=required is not supported by this provider; downgraded to ${fallback}.`);
+        normalizedToolChoice = fallback;
+    }
+    if (normalizedToolChoice
+        && typeof normalizedToolChoice === "object"
+        && !Array.isArray(normalizedToolChoice)
+        && normalizedToolChoice.type === "function"
+        && compatibility.allowNamedToolChoice === false) {
+        const fallback = compatibility.namedFallback ?? "required";
+        warnings.push(`named tool_choice is not supported by this provider; downgraded to ${fallback}.`);
+        normalizedToolChoice = fallback;
+    }
+    return { normalizedToolChoice, warnings };
+}
+export function applyToolChoicePolicy(params) {
+    const compatibilityResult = applyToolChoiceCompatibility({
+        toolChoice: params.toolChoice,
+        thinkingEnabled: params.thinkingEnabled,
+        compatibility: params.compatibility,
+    });
+    const toolChoice = compatibilityResult.normalizedToolChoice;
+    const warnings = [...compatibilityResult.warnings];
+    const tools = filterEligibleTools({
+        tools: params.tools,
+        eligibility: params.eligibility,
+    });
+    if (!toolChoice || toolChoice === "auto") {
+        return { tools, normalizedToolChoice: toolChoice, warnings };
+    }
+    if (toolChoice === "none") {
+        return { tools: [], normalizedToolChoice: "none", warnings };
+    }
+    if (toolChoice === "required") {
+        if (tools.length === 0) {
+            throw new Error("tool_choice=required but no tools were provided");
+        }
+        return {
+            tools,
+            normalizedToolChoice: "required",
+            extraSystemPrompt: "You must call one of the available tools before responding.",
+            warnings,
+        };
+    }
+    if (typeof toolChoice === "object" && !Array.isArray(toolChoice) && toolChoice.type === "function") {
+        const functionChoice = (toolChoice.function ?? undefined);
+        const targetName = typeof functionChoice?.name === "string"
+            ? functionChoice.name.trim()
+            : "";
+        if (!targetName) {
+            throw new Error("tool_choice.function.name is required");
+        }
+        const matchedTools = tools.filter((tool) => resolveToolName(tool) === targetName);
+        if (matchedTools.length === 0) {
+            throw new Error(`tool_choice requested unknown tool: ${targetName}`);
+        }
+        return {
+            tools: matchedTools,
+            normalizedToolChoice: {
+                type: "function",
+                function: { name: targetName },
+            },
+            extraSystemPrompt: `You must call the ${targetName} tool before responding.`,
+            warnings,
+        };
+    }
+    return { tools, normalizedToolChoice: toolChoice, warnings };
+}
+//# sourceMappingURL=tool-choice-policy.js.map

package/dist/orchestration/tool-choice-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-choice-policy.js","sourceRoot":"","sources":["../../src/orchestration/tool-choice-policy.ts"],"names":[],"mappings":"AA+CA,SAAS,eAAe,CAAC,IAAwB;IAC/C,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjG,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,OAAO,MAAM,KAAK,kBAAkB,IAAI,MAAM,KAAK,6BAA6B,CAAC;AACnF,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAAuD;IAEvD,OAAO,IAAI,GAAG,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAU,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAmC,MAGrE;IACC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,CAAC,WAAW,IAAI,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wCAAwC,CAAC,IAAa;IACpE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,IAA+B,CAAC;IACnD,IAAI,UAAU,CAAC,QAAQ,IAAI,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACnE,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,YAAY,GAA4B;QAC5C,IAAI;QACJ,UAAU,EACR,UAAU,CAAC,YAAY,IAAI,OAAO,UAAU,CAAC,YAAY,KAAK,QAAQ;YACpE,CAAC,CAAC,UAAU,CAAC,YAAY;YACzB,CAAC,CAAC,UAAU,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ;gBAClE,CAAC,CAAC,UAAU,CAAC,UAAU;gBACvB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAC3C,CAAC;IAEF,IAAI,OAAO,UAAU,CAAC,WAAW,KAAK,QAAQ,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QAChF,YAAY,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC3C,YAAY,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAC1C,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,YAAY;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,UAAmB;IAC9D,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/E,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,UAAqC,CAAC;IACrD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACpF,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE;SACvC,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAI5C;IACC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;IACjD,IAAI,oBAAoB,GAAG,MAAM,CAAC,UAAU,CAAC;IAE7C,IAAI,MAAM,CAAC,eAAe,IAAI,aAAa,CAAC,uBAAuB,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,OAAO,oBAAoB,KAAK,QAAQ,IAAI,oBAAoB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;YACnH,CAAC,CAAC,MAAM,CAAE,oBAAgD,CAAC,IAAI,IAAI,EAAE,CAAC;YACtE,CAAC,CAAC,oBAAoB,CAAC;QACzB,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,wFAAwF,CAAC,CAAC;YACxG,oBAAoB,GAAG,MAAM,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,oBAAoB,KAAK,UAAU,IAAI,aAAa,CAAC,uBAAuB,KAAK,KAAK,EAAE,CAAC;QAC3F,MAAM,QAAQ,GAAG,aAAa,CAAC,gBAAgB,IAAI,MAAM,CAAC;QAC1D,QAAQ,CAAC,IAAI,CAAC,yEAAyE,QAAQ,GAAG,CAAC,CAAC;QACpG,oBAAoB,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,IACE,oBAAoB;WACjB,OAAO,oBAAoB,KAAK,QAAQ;WACxC,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;WACnC,oBAAgD,CAAC,IAAI,KAAK,UAAU;WACrE,aAAa,CAAC,oBAAoB,KAAK,KAAK,EAC/C,CAAC;QACD,MAAM,QAAQ,GAAG,aAAa,CAAC,aAAa,IAAI,UAAU,CAAC;QAC3D,QAAQ,CAAC,IAAI,CAAC,sEAAsE,QAAQ,GAAG,CAAC,CAAC;QACjG,oBAAoB,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAyC;IAEzC,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;QACvD,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,mBAAmB,CAAC,oBAAoB,CAAC;IAC5D,MAAM,QAAQ,GAAG,CAAC,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,mBAAmB,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IAEH,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/D,CAAC;IAED,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC/D,CAAC;IAED,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,OAAO;YACL,KAAK;YACL,oBAAoB,EAAE,UAAU;YAChC,iBAAiB,EAAE,6DAA6D;YAChF,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACnG,MAAM,cAAc,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,SAAS,CAAmC,CAAC;QAC5F,MAAM,UAAU,GAAG,OAAO,cAAc,EAAE,IAAI,KAAK,QAAQ;YACzD,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE;YAC5B,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC;QAClF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,uCAAuC,UAAU,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,oBAAoB,EAAE;gBACpB,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;aAC/B;YACD,iBAAiB,EAAE,qBAAqB,UAAU,0BAA0B;YAC5E,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAC/D,CAAC"}

package/dist/orchestration/tool-loop-state.d.ts

@@ -0,0 +1,51 @@
+import { type ConversationRepairOptions, type OpenAiChatMessageLike, type OpenAiResponsesItemLike } from "./conversation-repair.js";
+export interface ToolLoopState<TMessage = unknown> {
+    round: number;
+    maxRounds: number;
+    pendingToolCallIds: string[];
+    completedToolCallIds: string[];
+    lastStopReason?: string;
+    replayMessages: TMessage[];
+}
+export interface ToolLoopRepairAction {
+    kind: "strip-forced-stop-tool-metadata" | "inject-placeholder-tool-result" | "drop-orphan-tool-result" | "rewrite-openai-function-call-pair" | "drop-trailing-reasoning";
+    detail?: string;
+}
+export interface RepairToolLoopStateResult<TMessage> {
+    state: ToolLoopState<TMessage>;
+    recoveryActions: ToolLoopRepairAction[];
+}
+export declare function createToolLoopState<TMessage>(params: {
+    maxRounds: number;
+    replayMessages?: readonly TMessage[];
+    round?: number;
+    pendingToolCallIds?: readonly string[];
+    completedToolCallIds?: readonly string[];
+    lastStopReason?: string;
+}): ToolLoopState<TMessage>;
+export declare function advanceToolLoopState<TMessage>(state: ToolLoopState<TMessage>, params: {
+    replayMessages?: readonly TMessage[];
+    pendingToolCallIds?: readonly string[];
+    completedToolCallIds?: readonly string[];
+    lastStopReason?: string;
+}): ToolLoopState<TMessage>;
+export declare function settleToolLoopState<TMessage>(state: ToolLoopState<TMessage>, params: {
+    replayMessages?: readonly TMessage[];
+    completedToolCallIds?: readonly string[];
+    lastStopReason?: string;
+}): ToolLoopState<TMessage>;
+export declare function recoverToolLoopStateFromChatConversation<TMessage extends OpenAiChatMessageLike>(params: {
+    maxRounds: number;
+    replayMessages: readonly TMessage[];
+    round?: number;
+    lastStopReason?: string;
+    options?: ConversationRepairOptions;
+}): RepairToolLoopStateResult<TMessage>;
+export declare function recoverToolLoopStateFromResponsesItems<TItem extends OpenAiResponsesItemLike>(params: {
+    maxRounds: number;
+    replayItems: readonly TItem[];
+    round?: number;
+    lastStopReason?: string;
+    options?: ConversationRepairOptions;
+}): RepairToolLoopStateResult<TItem>;
+//# sourceMappingURL=tool-loop-state.d.ts.map

package/dist/orchestration/tool-loop-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loop-state.d.ts","sourceRoot":"","sources":["../../src/orchestration/tool-loop-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,aAAa,CAAC,QAAQ,GAAG,OAAO;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,QAAQ,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EACA,iCAAiC,GACjC,gCAAgC,GAChC,yBAAyB,GACzB,mCAAmC,GACnC,yBAAyB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB,CAAC,QAAQ;IACjD,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC/B,eAAe,EAAE,oBAAoB,EAAE,CAAC;CACzC;AA6DD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAS1B;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAC3C,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC9B,MAAM,EAAE;IACN,cAAc,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,aAAa,CAAC,QAAQ,CAAC,CASzB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAC1C,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC9B,MAAM,EAAE;IACN,cAAc,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,aAAa,CAAC,QAAQ,CAAC,CASzB;AAED,wBAAgB,wCAAwC,CAAC,QAAQ,SAAS,qBAAqB,EAAE,MAAM,EAAE;IACvG,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACrC,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAyBtC;AAED,wBAAgB,sCAAsC,CAAC,KAAK,SAAS,uBAAuB,EAAE,MAAM,EAAE;IACpG,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,SAAS,KAAK,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACrC,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAoBnC"}

package/dist/orchestration/tool-loop-state.js

@@ -0,0 +1,134 @@
+import { injectDanglingToolCallPlaceholders, repairOpenAiResponsesItems, stripForcedStopAssistantToolMetadata, sanitizeOpenAiChatMessages, } from "./conversation-repair.js";
+function collectChatPendingToolCallIds(messages) {
+    const called = new Set();
+    const completed = new Set();
+    for (const message of messages) {
+        if (message.role === "assistant" && Array.isArray(message.tool_calls)) {
+            for (const toolCall of message.tool_calls) {
+                if (typeof toolCall.id === "string" && toolCall.id) {
+                    called.add(toolCall.id);
+                }
+            }
+        }
+        if (message.role === "tool" && typeof message.tool_call_id === "string" && message.tool_call_id) {
+            completed.add(message.tool_call_id);
+        }
+    }
+    return [...called].filter((callId) => !completed.has(callId));
+}
+function collectChatCompletedToolCallIds(messages) {
+    const completed = new Set();
+    for (const message of messages) {
+        if (message.role === "tool" && typeof message.tool_call_id === "string" && message.tool_call_id) {
+            completed.add(message.tool_call_id);
+        }
+    }
+    return [...completed];
+}
+function collectResponsesPendingToolCallIds(items) {
+    const called = new Set();
+    const completed = new Set();
+    for (const item of items) {
+        if (item.type === "function_call") {
+            const callId = typeof item.call_id === "string" && item.call_id
+                ? item.call_id
+                : typeof item.id === "string"
+                    ? item.id
+                    : "";
+            if (callId) {
+                called.add(callId);
+            }
+        }
+        if (item.type === "function_call_output" && typeof item.call_id === "string" && item.call_id) {
+            completed.add(item.call_id);
+        }
+    }
+    return [...called].filter((callId) => !completed.has(callId));
+}
+function collectResponsesCompletedToolCallIds(items) {
+    const completed = new Set();
+    for (const item of items) {
+        if (item.type === "function_call_output" && typeof item.call_id === "string" && item.call_id) {
+            completed.add(item.call_id);
+        }
+    }
+    return [...completed];
+}
+export function createToolLoopState(params) {
+    return {
+        round: params.round ?? 0,
+        maxRounds: params.maxRounds,
+        pendingToolCallIds: [...(params.pendingToolCallIds ?? [])],
+        completedToolCallIds: [...(params.completedToolCallIds ?? [])],
+        lastStopReason: params.lastStopReason,
+        replayMessages: [...(params.replayMessages ?? [])],
+    };
+}
+export function advanceToolLoopState(state, params) {
+    return {
+        round: state.round + 1,
+        maxRounds: state.maxRounds,
+        pendingToolCallIds: [...(params.pendingToolCallIds ?? state.pendingToolCallIds)],
+        completedToolCallIds: [...(params.completedToolCallIds ?? state.completedToolCallIds)],
+        lastStopReason: params.lastStopReason ?? state.lastStopReason,
+        replayMessages: [...(params.replayMessages ?? state.replayMessages)],
+    };
+}
+export function settleToolLoopState(state, params) {
+    return {
+        round: state.round,
+        maxRounds: state.maxRounds,
+        pendingToolCallIds: [],
+        completedToolCallIds: [...(params.completedToolCallIds ?? state.completedToolCallIds)],
+        lastStopReason: params.lastStopReason ?? state.lastStopReason,
+        replayMessages: [...(params.replayMessages ?? state.replayMessages)],
+    };
+}
+export function recoverToolLoopStateFromChatConversation(params) {
+    const recoveryActions = [];
+    const sanitizedMessages = sanitizeOpenAiChatMessages(params.replayMessages);
+    if (sanitizedMessages.length !== params.replayMessages.length) {
+        recoveryActions.push({ kind: "drop-orphan-tool-result", detail: "Removed orphan tool results or invalid assistant tool calls." });
+    }
+    const strippedMessages = stripForcedStopAssistantToolMetadata(sanitizedMessages, params.options);
+    if (strippedMessages.some((message, index) => message !== sanitizedMessages[index])) {
+        recoveryActions.push({ kind: "strip-forced-stop-tool-metadata", detail: "Removed assistant tool-call metadata after forced stop." });
+    }
+    const repairedMessages = injectDanglingToolCallPlaceholders(strippedMessages, params.options);
+    if (repairedMessages.length > strippedMessages.length) {
+        recoveryActions.push({ kind: "inject-placeholder-tool-result", detail: "Injected placeholder tool result for pending tool calls." });
+    }
+    return {
+        state: createToolLoopState({
+            maxRounds: params.maxRounds,
+            round: params.round,
+            lastStopReason: params.lastStopReason,
+            replayMessages: repairedMessages,
+            pendingToolCallIds: collectChatPendingToolCallIds(repairedMessages),
+            completedToolCallIds: collectChatCompletedToolCallIds(repairedMessages),
+        }),
+        recoveryActions,
+    };
+}
+export function recoverToolLoopStateFromResponsesItems(params) {
+    const repairedItems = repairOpenAiResponsesItems(params.replayItems, params.options);
+    const recoveryActions = [];
+    if (repairedItems.length !== params.replayItems.length) {
+        recoveryActions.push({ kind: "drop-trailing-reasoning", detail: "Dropped dangling reasoning blocks or injected missing function_call_output items." });
+    }
+    if (repairedItems.some((item, index) => item !== params.replayItems[index] && item.type === "function_call")) {
+        recoveryActions.push({ kind: "rewrite-openai-function-call-pair", detail: "Rewrote OpenAI function_call pairing ids for replay compatibility." });
+    }
+    return {
+        state: createToolLoopState({
+            maxRounds: params.maxRounds,
+            round: params.round,
+            lastStopReason: params.lastStopReason,
+            replayMessages: repairedItems,
+            pendingToolCallIds: collectResponsesPendingToolCallIds(repairedItems),
+            completedToolCallIds: collectResponsesCompletedToolCallIds(repairedItems),
+        }),
+        recoveryActions,
+    };
+}
+//# sourceMappingURL=tool-loop-state.js.map

package/dist/orchestration/tool-loop-state.js.map

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

package/dist/orchestration/tool-schema.d.ts

@@ -0,0 +1,40 @@
+import type { OpenAiToolCall } from "./conversation-repair.js";
+export type ToolSchemaProvider = {
+    modelProvider?: string;
+    modelId?: string;
+};
+export interface FunctionToolSource {
+    name: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+}
+export interface FunctionToolDefinition {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface CapabilityToolManifestLike {
+    name: string;
+    description?: string;
+    requiredParameters?: string[];
+}
+export declare function isXaiProvider(modelProvider?: string, modelId?: string): boolean;
+export declare function normalizeFunctionToolParameters(parameters: Record<string, unknown> | undefined, options?: ToolSchemaProvider): Record<string, unknown>;
+export declare function convertFunctionTools(tools: readonly FunctionToolSource[], options?: ToolSchemaProvider): FunctionToolDefinition[];
+export declare function convertCapabilityToolManifestsToFunctionTools(tools: readonly CapabilityToolManifestLike[]): FunctionToolDefinition[];
+export declare function normalizeMessageTextContent(content: unknown): string;
+export declare function parseOpenAiToolCallsFromChatResponse(responseBody: string): {
+    toolCalls: OpenAiToolCall[];
+    responseText: string;
+};
+export declare function buildAssistantToolCallMessage(toolCalls: OpenAiToolCall[]): Record<string, unknown>;
+export declare function buildToolResultMessage(callId: string, result: {
+    ok: boolean;
+    payload?: unknown;
+    error?: string;
+}): Record<string, unknown>;
+export declare function cleanToolSchemaForGemini(schema: Record<string, unknown>): unknown;
+//# sourceMappingURL=tool-schema.d.ts.map

package/dist/orchestration/tool-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema.d.ts","sourceRoot":"","sources":["../../src/orchestration/tool-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAwJD,wBAAgB,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAa/E;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC/C,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+EzB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,sBAAsB,EAAE,CASjI;AAED,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,SAAS,0BAA0B,EAAE,GAC3C,sBAAsB,EAAE,CAa1B;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAgBpE;AAED,wBAAgB,oCAAoC,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,cAAc,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAqBhI;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMlG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM1I;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEjF"}