@uns-kit/assistant-workflow 2.0.72

package/dist/tool-executor.js

@@ -0,0 +1,176 @@
+import { assistantWorkflowToolError, assistantWorkflowToolSkipped, assistantWorkflowToolSuccess, buildAssistantWorkflowToolResultsTracePayload, summarizeAssistantWorkflowToolResults, } from "./tool-results.js";
+/**
+ * Adapts provider-specific integrations to the generic invocation executor.
+ * Applications can add local, HTTP, hosted, MCP, or REPL executors without
+ * making queue execution depend on their transport SDKs.
+ */
+export function createAssistantWorkflowToolProviderExecutor(executors, options = {}) {
+    return async (invocation, context) => {
+        const providerExecutor = executors[invocation.provider];
+        if (providerExecutor) {
+            assertInvocationProviderConsistency(invocation);
+            return await providerExecutor(invocation, context);
+        }
+        if (options.fallback) {
+            return await options.fallback(invocation, context);
+        }
+        throw new Error(`No executor configured for assistant workflow tool provider: ${invocation.provider}.`);
+    };
+}
+export async function executeAssistantWorkflowToolInvocationQueue(queue, executor, options = {}) {
+    const results = [];
+    const continueOnError = options.continueOnError === true;
+    const now = options.now ?? (() => Date.now());
+    for (const [invocationIndex, invocation] of queue.invocations.entries()) {
+        const startedAt = now();
+        emitToolExecutionEvent(options.onEvent, createToolExecutionEvent({
+            phase: "started",
+            invocation,
+            invocationIndex,
+            queueStatus: queue.status,
+        }));
+        try {
+            const output = await executor(invocation, {
+                invocationIndex,
+                queueStatus: queue.status,
+                args: readInvocationArgs(options.argsByInvocationId, invocation.id),
+            });
+            const durationMs = now() - startedAt;
+            results.push(assistantWorkflowToolSuccess({
+                invocationId: invocation.id,
+                toolName: invocation.toolName,
+                stepId: invocation.stepId,
+                provider: invocation.provider,
+                output,
+                durationMs,
+            }));
+            emitToolExecutionEvent(options.onEvent, createToolExecutionEvent({
+                phase: "succeeded",
+                invocation,
+                invocationIndex,
+                queueStatus: queue.status,
+                durationMs,
+            }));
+        }
+        catch (error) {
+            const durationMs = now() - startedAt;
+            const errorMessage = getErrorMessage(error);
+            const retryable = options.retryableOnError === true;
+            results.push(assistantWorkflowToolError({
+                invocationId: invocation.id,
+                toolName: invocation.toolName,
+                stepId: invocation.stepId,
+                provider: invocation.provider,
+                errorMessage,
+                retryable,
+                durationMs,
+            }));
+            emitToolExecutionEvent(options.onEvent, createToolExecutionEvent({
+                phase: "failed",
+                invocation,
+                invocationIndex,
+                queueStatus: queue.status,
+                durationMs,
+                errorMessage,
+                retryable,
+            }));
+            if (!continueOnError) {
+                appendSkippedAfterFailure(results, queue.invocations.slice(invocationIndex + 1), invocation.id, invocationIndex + 1, queue.status, options.onEvent);
+                break;
+            }
+        }
+    }
+    return {
+        queue,
+        results,
+        summary: summarizeAssistantWorkflowToolResults(queue, results),
+    };
+}
+export function buildAssistantWorkflowToolExecutionTracePayload(report) {
+    return buildAssistantWorkflowToolResultsTracePayload(report.queue, report.results);
+}
+export function buildAssistantWorkflowToolExecutionEventTracePayload(event) {
+    return {
+        phase: event.phase,
+        invocationId: event.invocationId,
+        toolName: event.toolName,
+        stepId: event.stepId,
+        provider: event.provider,
+        invocationIndex: event.invocationIndex,
+        queueStatus: event.queueStatus,
+        durationMs: event.durationMs,
+        errorMessage: event.errorMessage,
+        retryable: event.retryable,
+    };
+}
+function appendSkippedAfterFailure(results, invocations, failedInvocationId, invocationIndex, queueStatus, onEvent) {
+    for (const [offset, invocation] of invocations.entries()) {
+        const errorMessage = `previous invocation failed: ${failedInvocationId}`;
+        results.push(assistantWorkflowToolSkipped({
+            invocationId: invocation.id,
+            toolName: invocation.toolName,
+            stepId: invocation.stepId,
+            provider: invocation.provider,
+            errorMessage,
+        }));
+        emitToolExecutionEvent(onEvent, createToolExecutionEvent({
+            phase: "skipped",
+            invocation,
+            invocationIndex: invocationIndex + offset,
+            queueStatus,
+            errorMessage,
+        }));
+    }
+}
+function createToolExecutionEvent(input) {
+    return {
+        phase: input.phase,
+        invocationId: input.invocation.id,
+        toolName: input.invocation.toolName,
+        stepId: input.invocation.stepId,
+        provider: input.invocation.provider,
+        invocationIndex: input.invocationIndex,
+        queueStatus: input.queueStatus,
+        durationMs: input.durationMs ?? null,
+        errorMessage: input.errorMessage ?? null,
+        retryable: input.retryable ?? null,
+    };
+}
+function emitToolExecutionEvent(observer, event) {
+    if (!observer)
+        return;
+    try {
+        observer(Object.freeze(event));
+    }
+    catch {
+        // Instrumentation must not alter the tool execution result.
+    }
+}
+function getErrorMessage(error) {
+    if (error instanceof Error && error.message.trim().length) {
+        return error.message.trim();
+    }
+    if (typeof error === "string" && error.trim().length) {
+        return error.trim();
+    }
+    return "tool invocation failed";
+}
+function readInvocationArgs(argsByInvocationId, invocationId) {
+    const rawArgs = argsByInvocationId?.[invocationId];
+    if (!isRecord(rawArgs))
+        return EMPTY_TOOL_INVOCATION_ARGS;
+    return Object.freeze({ ...rawArgs });
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function assertInvocationProviderConsistency(invocation) {
+    if (invocation.provider !== invocation.binding.provider) {
+        throw new Error(`Assistant workflow invocation provider ${invocation.provider} does not match binding provider ${invocation.binding.provider}.`);
+    }
+    if (invocation.provider !== invocation.capability.provider) {
+        throw new Error(`Assistant workflow invocation provider ${invocation.provider} does not match capability provider ${invocation.capability.provider}.`);
+    }
+}
+const EMPTY_TOOL_INVOCATION_ARGS = Object.freeze({});
+//# sourceMappingURL=tool-executor.js.map

package/dist/tool-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.js","sourceRoot":"","sources":["../src/tool-executor.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AssistantWorkflowToolBindingDefinition,\n  AssistantWorkflowToolCapabilityDefinition,\n  AssistantWorkflowToolProvider,\n} from \"./definition.js\";\nimport type {\n  AssistantWorkflowToolInvocation,\n  AssistantWorkflowToolInvocationQueue,\n} from \"./tool-invocations.js\";\n\nexport type {\n  AssistantWorkflowToolInvocation,\n  AssistantWorkflowToolInvocationQueue,\n} from \"./tool-invocations.js\";\nimport {\n  assistantWorkflowToolError,\n  assistantWorkflowToolSkipped,\n  assistantWorkflowToolSuccess,\n  buildAssistantWorkflowToolResultsTracePayload,\n  summarizeAssistantWorkflowToolResults,\n  type AssistantWorkflowToolResult,\n  type AssistantWorkflowToolResultSummary,\n} from \"./tool-results.js\";\n\nexport type AssistantWorkflowToolExecutorContext = {\n  invocationIndex: number;\n  queueStatus: AssistantWorkflowToolInvocationQueue[\"status\"];\n  args: AssistantWorkflowToolInvocationArgs;\n};\n\nexport type AssistantWorkflowToolInvocationArgs = Readonly<Record<string, unknown>>;\n\nexport type AssistantWorkflowToolInvocationArgsById = Readonly<\n  Record<string, AssistantWorkflowToolInvocationArgs>\n>;\n\nexport type AssistantWorkflowToolExecutor = (\n  invocation: AssistantWorkflowToolInvocation,\n  context: AssistantWorkflowToolExecutorContext,\n) => unknown | Promise<unknown>;\n\nexport type AssistantWorkflowToolInvocationForProvider<\n  TProvider extends AssistantWorkflowToolProvider = AssistantWorkflowToolProvider,\n> = Omit<AssistantWorkflowToolInvocation, \"provider\" | \"capability\" | \"binding\"> & {\n  provider: TProvider;\n  capability: AssistantWorkflowToolCapabilityDefinition & { provider: TProvider };\n  binding: Extract<AssistantWorkflowToolBindingDefinition, { provider: TProvider }>;\n};\n\nexport type AssistantWorkflowToolProviderExecutor<\n  TProvider extends AssistantWorkflowToolProvider = AssistantWorkflowToolProvider,\n> = (\n  invocation: AssistantWorkflowToolInvocationForProvider<TProvider>,\n  context: AssistantWorkflowToolExecutorContext,\n) => unknown | Promise<unknown>;\n\nexport type AssistantWorkflowToolProviderExecutors = {\n  [TProvider in AssistantWorkflowToolProvider]?: AssistantWorkflowToolProviderExecutor<TProvider>;\n};\n\nexport type AssistantWorkflowToolProviderExecutorOptions = {\n  fallback?: AssistantWorkflowToolExecutor;\n};\n\nexport type AssistantWorkflowToolExecutionEventPhase =\n  | \"started\"\n  | \"succeeded\"\n  | \"failed\"\n  | \"skipped\";\n\nexport type AssistantWorkflowToolExecutionEvent = {\n  phase: AssistantWorkflowToolExecutionEventPhase;\n  invocationId: string;\n  toolName: string;\n  stepId: string;\n  provider: AssistantWorkflowToolProvider;\n  invocationIndex: number;\n  queueStatus: AssistantWorkflowToolInvocationQueue[\"status\"];\n  durationMs: number | null;\n  errorMessage: string | null;\n  retryable: boolean | null;\n};\n\nexport type AssistantWorkflowToolExecutionOptions = {\n  continueOnError?: boolean;\n  retryableOnError?: boolean;\n  now?: () => number;\n  argsByInvocationId?: AssistantWorkflowToolInvocationArgsById;\n  onEvent?: (event: AssistantWorkflowToolExecutionEvent) => void;\n};\n\nexport type AssistantWorkflowToolExecutionReport = {\n  queue: AssistantWorkflowToolInvocationQueue;\n  results: AssistantWorkflowToolResult[];\n  summary: AssistantWorkflowToolResultSummary;\n};\n\n/**\n * Adapts provider-specific integrations to the generic invocation executor.\n * Applications can add local, HTTP, hosted, MCP, or REPL executors without\n * making queue execution depend on their transport SDKs.\n */\nexport function createAssistantWorkflowToolProviderExecutor(\n  executors: AssistantWorkflowToolProviderExecutors,\n  options: AssistantWorkflowToolProviderExecutorOptions = {},\n): AssistantWorkflowToolExecutor {\n  return async (invocation, context) => {\n    const providerExecutor = executors[invocation.provider] as\n      | AssistantWorkflowToolProviderExecutor\n      | undefined;\n    if (providerExecutor) {\n      assertInvocationProviderConsistency(invocation);\n      return await providerExecutor(\n        invocation as AssistantWorkflowToolInvocationForProvider,\n        context,\n      );\n    }\n    if (options.fallback) {\n      return await options.fallback(invocation, context);\n    }\n    throw new Error(`No executor configured for assistant workflow tool provider: ${invocation.provider}.`);\n  };\n}\n\nexport async function executeAssistantWorkflowToolInvocationQueue(\n  queue: AssistantWorkflowToolInvocationQueue,\n  executor: AssistantWorkflowToolExecutor,\n  options: AssistantWorkflowToolExecutionOptions = {},\n): Promise<AssistantWorkflowToolExecutionReport> {\n  const results: AssistantWorkflowToolResult[] = [];\n  const continueOnError = options.continueOnError === true;\n  const now = options.now ?? (() => Date.now());\n\n  for (const [invocationIndex, invocation] of queue.invocations.entries()) {\n    const startedAt = now();\n    emitToolExecutionEvent(options.onEvent, createToolExecutionEvent({\n      phase: \"started\",\n      invocation,\n      invocationIndex,\n      queueStatus: queue.status,\n    }));\n    try {\n      const output = await executor(invocation, {\n        invocationIndex,\n        queueStatus: queue.status,\n        args: readInvocationArgs(options.argsByInvocationId, invocation.id),\n      });\n      const durationMs = now() - startedAt;\n      results.push(\n        assistantWorkflowToolSuccess({\n          invocationId: invocation.id,\n          toolName: invocation.toolName,\n          stepId: invocation.stepId,\n          provider: invocation.provider,\n          output,\n          durationMs,\n        }),\n      );\n      emitToolExecutionEvent(options.onEvent, createToolExecutionEvent({\n        phase: \"succeeded\",\n        invocation,\n        invocationIndex,\n        queueStatus: queue.status,\n        durationMs,\n      }));\n    } catch (error) {\n      const durationMs = now() - startedAt;\n      const errorMessage = getErrorMessage(error);\n      const retryable = options.retryableOnError === true;\n      results.push(\n        assistantWorkflowToolError({\n          invocationId: invocation.id,\n          toolName: invocation.toolName,\n          stepId: invocation.stepId,\n          provider: invocation.provider,\n          errorMessage,\n          retryable,\n          durationMs,\n        }),\n      );\n      emitToolExecutionEvent(options.onEvent, createToolExecutionEvent({\n        phase: \"failed\",\n        invocation,\n        invocationIndex,\n        queueStatus: queue.status,\n        durationMs,\n        errorMessage,\n        retryable,\n      }));\n      if (!continueOnError) {\n        appendSkippedAfterFailure(\n          results,\n          queue.invocations.slice(invocationIndex + 1),\n          invocation.id,\n          invocationIndex + 1,\n          queue.status,\n          options.onEvent,\n        );\n        break;\n      }\n    }\n  }\n\n  return {\n    queue,\n    results,\n    summary: summarizeAssistantWorkflowToolResults(queue, results),\n  };\n}\n\nexport function buildAssistantWorkflowToolExecutionTracePayload(\n  report: AssistantWorkflowToolExecutionReport,\n): Record<string, unknown> {\n  return buildAssistantWorkflowToolResultsTracePayload(report.queue, report.results);\n}\n\nexport function buildAssistantWorkflowToolExecutionEventTracePayload(\n  event: AssistantWorkflowToolExecutionEvent,\n): Record<string, unknown> {\n  return {\n    phase: event.phase,\n    invocationId: event.invocationId,\n    toolName: event.toolName,\n    stepId: event.stepId,\n    provider: event.provider,\n    invocationIndex: event.invocationIndex,\n    queueStatus: event.queueStatus,\n    durationMs: event.durationMs,\n    errorMessage: event.errorMessage,\n    retryable: event.retryable,\n  };\n}\n\nfunction appendSkippedAfterFailure(\n  results: AssistantWorkflowToolResult[],\n  invocations: readonly AssistantWorkflowToolInvocation[],\n  failedInvocationId: string,\n  invocationIndex: number,\n  queueStatus: AssistantWorkflowToolInvocationQueue[\"status\"],\n  onEvent: AssistantWorkflowToolExecutionOptions[\"onEvent\"],\n): void {\n  for (const [offset, invocation] of invocations.entries()) {\n    const errorMessage = `previous invocation failed: ${failedInvocationId}`;\n    results.push(\n      assistantWorkflowToolSkipped({\n        invocationId: invocation.id,\n        toolName: invocation.toolName,\n        stepId: invocation.stepId,\n        provider: invocation.provider,\n        errorMessage,\n      }),\n    );\n    emitToolExecutionEvent(onEvent, createToolExecutionEvent({\n      phase: \"skipped\",\n      invocation,\n      invocationIndex: invocationIndex + offset,\n      queueStatus,\n      errorMessage,\n    }));\n  }\n}\n\nfunction createToolExecutionEvent(input: {\n  phase: AssistantWorkflowToolExecutionEventPhase;\n  invocation: AssistantWorkflowToolInvocation;\n  invocationIndex: number;\n  queueStatus: AssistantWorkflowToolInvocationQueue[\"status\"];\n  durationMs?: number;\n  errorMessage?: string;\n  retryable?: boolean;\n}): AssistantWorkflowToolExecutionEvent {\n  return {\n    phase: input.phase,\n    invocationId: input.invocation.id,\n    toolName: input.invocation.toolName,\n    stepId: input.invocation.stepId,\n    provider: input.invocation.provider,\n    invocationIndex: input.invocationIndex,\n    queueStatus: input.queueStatus,\n    durationMs: input.durationMs ?? null,\n    errorMessage: input.errorMessage ?? null,\n    retryable: input.retryable ?? null,\n  };\n}\n\nfunction emitToolExecutionEvent(\n  observer: AssistantWorkflowToolExecutionOptions[\"onEvent\"],\n  event: AssistantWorkflowToolExecutionEvent,\n): void {\n  if (!observer) return;\n  try {\n    observer(Object.freeze(event));\n  } catch {\n    // Instrumentation must not alter the tool execution result.\n  }\n}\n\nfunction getErrorMessage(error: unknown): string {\n  if (error instanceof Error && error.message.trim().length) {\n    return error.message.trim();\n  }\n  if (typeof error === \"string\" && error.trim().length) {\n    return error.trim();\n  }\n  return \"tool invocation failed\";\n}\n\nfunction readInvocationArgs(\n  argsByInvocationId: AssistantWorkflowToolInvocationArgsById | undefined,\n  invocationId: string,\n): AssistantWorkflowToolInvocationArgs {\n  const rawArgs = argsByInvocationId?.[invocationId];\n  if (!isRecord(rawArgs)) return EMPTY_TOOL_INVOCATION_ARGS;\n  return Object.freeze({ ...rawArgs });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction assertInvocationProviderConsistency(invocation: AssistantWorkflowToolInvocation): void {\n  if (invocation.provider !== invocation.binding.provider) {\n    throw new Error(\n      `Assistant workflow invocation provider ${invocation.provider} does not match binding provider ${invocation.binding.provider}.`,\n    );\n  }\n  if (invocation.provider !== invocation.capability.provider) {\n    throw new Error(\n      `Assistant workflow invocation provider ${invocation.provider} does not match capability provider ${invocation.capability.provider}.`,\n    );\n  }\n}\n\nconst EMPTY_TOOL_INVOCATION_ARGS: AssistantWorkflowToolInvocationArgs = Object.freeze({});\n"]}

package/dist/tool-fixtures.d.ts

@@ -0,0 +1,18 @@
+import type { AssistantWorkflowToolExecutor, AssistantWorkflowToolExecutorContext } from "./tool-executor.js";
+import type { AssistantWorkflowToolInvocation } from "./tool-invocations.js";
+export type AssistantWorkflowToolFixture = {
+    status: "success";
+    output?: unknown;
+} | {
+    status: "error";
+    errorMessage: string;
+};
+export type AssistantWorkflowToolFixtureInput = AssistantWorkflowToolFixture | unknown;
+export type AssistantWorkflowToolFixtureMap = Record<string, AssistantWorkflowToolFixtureInput>;
+export type AssistantWorkflowFixtureToolExecutorOptions = {
+    defaultOutput?: unknown;
+    missingFixture?: "error" | "default-output";
+};
+export declare function buildAssistantWorkflowFixtureToolExecutor(fixtures: AssistantWorkflowToolFixtureMap, options?: AssistantWorkflowFixtureToolExecutorOptions): AssistantWorkflowToolExecutor;
+export declare function executeAssistantWorkflowFixtureToolInvocation(fixtures: AssistantWorkflowToolFixtureMap, invocation: AssistantWorkflowToolInvocation, context: AssistantWorkflowToolExecutorContext, options?: AssistantWorkflowFixtureToolExecutorOptions): unknown;
+//# sourceMappingURL=tool-fixtures.d.ts.map

package/dist/tool-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-fixtures.d.ts","sourceRoot":"","sources":["../src/tool-fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,oCAAoC,EACrC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAE7E,MAAM,MAAM,4BAA4B,GACpC;IACA,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACC;IACA,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEJ,MAAM,MAAM,iCAAiC,GAAG,4BAA4B,GAAG,OAAO,CAAC;AAEvF,MAAM,MAAM,+BAA+B,GAAG,MAAM,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;AAEhG,MAAM,MAAM,2CAA2C,GAAG;IACxD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAC7C,CAAC;AAEF,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,+BAA+B,EACzC,OAAO,GAAE,2CAAgD,GACxD,6BAA6B,CAO/B;AAED,wBAAgB,6CAA6C,CAC3D,QAAQ,EAAE,+BAA+B,EACzC,UAAU,EAAE,+BAA+B,EAC3C,OAAO,EAAE,oCAAoC,EAC7C,OAAO,GAAE,2CAAgD,GACxD,OAAO,CAiBT"}

package/dist/tool-fixtures.js

@@ -0,0 +1,52 @@
+export function buildAssistantWorkflowFixtureToolExecutor(fixtures, options = {}) {
+    return (invocation, context) => executeAssistantWorkflowFixtureToolInvocation(fixtures, invocation, context, options);
+}
+export function executeAssistantWorkflowFixtureToolInvocation(fixtures, invocation, context, options = {}) {
+    const fixture = findFixture(fixtures, invocation, context);
+    if (fixture === undefined) {
+        if (options.missingFixture === "default-output") {
+            return options.defaultOutput ?? {
+                invocationId: invocation.id,
+                toolName: invocation.toolName,
+            };
+        }
+        throw new Error(`No fixture output configured for ${invocation.id}.`);
+    }
+    const normalized = normalizeFixture(fixture);
+    if (normalized.status === "error") {
+        throw new Error(normalized.errorMessage);
+    }
+    return normalized.output;
+}
+function findFixture(fixtures, invocation, context) {
+    const indexKey = String(context.invocationIndex);
+    return fixtures[invocation.id]
+        ?? fixtures[invocation.toolName]
+        ?? fixtures[indexKey];
+}
+function normalizeFixture(value) {
+    if (isFixtureRecord(value)) {
+        if (value["status"] === "error") {
+            return {
+                status: "error",
+                errorMessage: typeof value["errorMessage"] === "string" && value["errorMessage"].trim().length
+                    ? value["errorMessage"].trim()
+                    : "fixture tool invocation failed",
+            };
+        }
+        if (value["status"] === "success") {
+            return {
+                status: "success",
+                ...("output" in value ? { output: value["output"] } : {}),
+            };
+        }
+    }
+    return {
+        status: "success",
+        output: value,
+    };
+}
+function isFixtureRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=tool-fixtures.js.map

package/dist/tool-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-fixtures.js","sourceRoot":"","sources":["../src/tool-fixtures.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,yCAAyC,CACvD,QAAyC,EACzC,UAAuD,EAAE;IAEzD,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,6CAA6C,CAC3E,QAAQ,EACR,UAAU,EACV,OAAO,EACP,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6CAA6C,CAC3D,QAAyC,EACzC,UAA2C,EAC3C,OAA6C,EAC7C,UAAuD,EAAE;IAEzD,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,OAAO,CAAC,cAAc,KAAK,gBAAgB,EAAE,CAAC;YAChD,OAAO,OAAO,CAAC,aAAa,IAAI;gBAC9B,YAAY,EAAE,UAAU,CAAC,EAAE;gBAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;aAC9B,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,CAAC;AAC3B,CAAC;AAED,SAAS,WAAW,CAClB,QAAyC,EACzC,UAA2C,EAC3C,OAA6C;IAE7C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;WACzB,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC;WAC7B,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAwC;IAChE,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,YAAY,EAAE,OAAO,KAAK,CAAC,cAAc,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM;oBAC5F,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE;oBAC9B,CAAC,CAAC,gCAAgC;aACrC,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["import type {\n  AssistantWorkflowToolExecutor,\n  AssistantWorkflowToolExecutorContext,\n} from \"./tool-executor.js\";\nimport type { AssistantWorkflowToolInvocation } from \"./tool-invocations.js\";\n\nexport type AssistantWorkflowToolFixture =\n  | {\n    status: \"success\";\n    output?: unknown;\n  }\n  | {\n    status: \"error\";\n    errorMessage: string;\n  };\n\nexport type AssistantWorkflowToolFixtureInput = AssistantWorkflowToolFixture | unknown;\n\nexport type AssistantWorkflowToolFixtureMap = Record<string, AssistantWorkflowToolFixtureInput>;\n\nexport type AssistantWorkflowFixtureToolExecutorOptions = {\n  defaultOutput?: unknown;\n  missingFixture?: \"error\" | \"default-output\";\n};\n\nexport function buildAssistantWorkflowFixtureToolExecutor(\n  fixtures: AssistantWorkflowToolFixtureMap,\n  options: AssistantWorkflowFixtureToolExecutorOptions = {},\n): AssistantWorkflowToolExecutor {\n  return (invocation, context) => executeAssistantWorkflowFixtureToolInvocation(\n    fixtures,\n    invocation,\n    context,\n    options,\n  );\n}\n\nexport function executeAssistantWorkflowFixtureToolInvocation(\n  fixtures: AssistantWorkflowToolFixtureMap,\n  invocation: AssistantWorkflowToolInvocation,\n  context: AssistantWorkflowToolExecutorContext,\n  options: AssistantWorkflowFixtureToolExecutorOptions = {},\n): unknown {\n  const fixture = findFixture(fixtures, invocation, context);\n  if (fixture === undefined) {\n    if (options.missingFixture === \"default-output\") {\n      return options.defaultOutput ?? {\n        invocationId: invocation.id,\n        toolName: invocation.toolName,\n      };\n    }\n    throw new Error(`No fixture output configured for ${invocation.id}.`);\n  }\n\n  const normalized = normalizeFixture(fixture);\n  if (normalized.status === \"error\") {\n    throw new Error(normalized.errorMessage);\n  }\n  return normalized.output;\n}\n\nfunction findFixture(\n  fixtures: AssistantWorkflowToolFixtureMap,\n  invocation: AssistantWorkflowToolInvocation,\n  context: AssistantWorkflowToolExecutorContext,\n): AssistantWorkflowToolFixtureInput | undefined {\n  const indexKey = String(context.invocationIndex);\n  return fixtures[invocation.id]\n    ?? fixtures[invocation.toolName]\n    ?? fixtures[indexKey];\n}\n\nfunction normalizeFixture(value: AssistantWorkflowToolFixtureInput): AssistantWorkflowToolFixture {\n  if (isFixtureRecord(value)) {\n    if (value[\"status\"] === \"error\") {\n      return {\n        status: \"error\",\n        errorMessage: typeof value[\"errorMessage\"] === \"string\" && value[\"errorMessage\"].trim().length\n          ? value[\"errorMessage\"].trim()\n          : \"fixture tool invocation failed\",\n      };\n    }\n    if (value[\"status\"] === \"success\") {\n      return {\n        status: \"success\",\n        ...(\"output\" in value ? { output: value[\"output\"] } : {}),\n      };\n    }\n  }\n  return {\n    status: \"success\",\n    output: value,\n  };\n}\n\nfunction isFixtureRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/tool-invocations.d.ts

@@ -0,0 +1,31 @@
+import type { AssistantWorkflowDefinition, AssistantWorkflowPlanningStepKind, AssistantWorkflowToolBindingDefinition, AssistantWorkflowToolCapabilityDefinition, AssistantWorkflowToolProvider } from "./definition.js";
+import type { AssistantWorkflowExecutionPlan, AssistantWorkflowExecutionPlanStatus } from "./execution-plan.js";
+export type AssistantWorkflowToolInvocationQueueStatus = "ready" | "partial" | "blocked" | "empty";
+export type AssistantWorkflowToolInvocation = {
+    id: string;
+    stepId: string;
+    stepKind: AssistantWorkflowPlanningStepKind;
+    toolName: string;
+    required: boolean;
+    provider: AssistantWorkflowToolProvider;
+    capability: AssistantWorkflowToolCapabilityDefinition;
+    binding: AssistantWorkflowToolBindingDefinition;
+};
+export type AssistantWorkflowToolInvocationQueue = {
+    status: AssistantWorkflowToolInvocationQueueStatus;
+    invocations: AssistantWorkflowToolInvocation[];
+    skippedStepIds: string[];
+    blockingReasons: string[];
+    warnings: string[];
+};
+export type AssistantWorkflowToolInvocationQueueOptions = {
+    includeOptional?: boolean;
+    allowWhenBlocked?: boolean;
+};
+export type AssistantWorkflowToolInvocationRun = {
+    status: AssistantWorkflowExecutionPlanStatus;
+    executionPlan: AssistantWorkflowExecutionPlan;
+};
+export declare function buildAssistantWorkflowToolInvocationQueue(workflow: AssistantWorkflowDefinition<string, string, string, string>, run: AssistantWorkflowToolInvocationRun, options?: AssistantWorkflowToolInvocationQueueOptions): AssistantWorkflowToolInvocationQueue;
+export declare function buildAssistantWorkflowToolInvocationQueueTracePayload(queue: AssistantWorkflowToolInvocationQueue): Record<string, unknown>;
+//# sourceMappingURL=tool-invocations.d.ts.map

package/dist/tool-invocations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-invocations.d.ts","sourceRoot":"","sources":["../src/tool-invocations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,iCAAiC,EACjC,sCAAsC,EACtC,yCAAyC,EACzC,6BAA6B,EAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,8BAA8B,EAAE,oCAAoC,EAAE,MAAM,qBAAqB,CAAC;AAMhH,MAAM,MAAM,0CAA0C,GAClD,OAAO,GACP,SAAS,GACT,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,MAAM,+BAA+B,GAAG;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iCAAiC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,6BAA6B,CAAC;IACxC,UAAU,EAAE,yCAAyC,CAAC;IACtD,OAAO,EAAE,sCAAsC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,MAAM,EAAE,0CAA0C,CAAC;IACnD,WAAW,EAAE,+BAA+B,EAAE,CAAC;IAC/C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,MAAM,EAAE,oCAAoC,CAAC;IAC7C,aAAa,EAAE,8BAA8B,CAAC;CAC/C,CAAC;AAEF,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,GAAG,EAAE,kCAAkC,EACvC,OAAO,GAAE,2CAAgD,GACxD,oCAAoC,CA4CtC;AAED,wBAAgB,qDAAqD,CACnE,KAAK,EAAE,oCAAoC,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB"}

package/dist/tool-invocations.js

@@ -0,0 +1,79 @@
+import { resolveAssistantWorkflowTools, } from "./tool-bindings.js";
+export function buildAssistantWorkflowToolInvocationQueue(workflow, run, options = {}) {
+    const includeOptional = options.includeOptional !== false;
+    const blocked = run.status === "blocked" || run.status === "needs-clarification";
+    if (blocked && options.allowWhenBlocked !== true) {
+        return {
+            status: "blocked",
+            invocations: [],
+            skippedStepIds: run.executionPlan.steps.map((step) => step.id),
+            blockingReasons: [...run.executionPlan.blockingReasons],
+            warnings: [...run.executionPlan.warnings],
+        };
+    }
+    const invocations = [];
+    const skippedStepIds = [];
+    for (const step of run.executionPlan.steps) {
+        if (step.status === "blocked" || step.status === "optional-skipped") {
+            skippedStepIds.push(step.id);
+            continue;
+        }
+        const readyToolNames = includeOptional
+            ? step.readyToolNames
+            : step.readyToolNames.filter((toolName) => step.requiredToolNames.includes(toolName));
+        const resolutions = resolveAssistantWorkflowTools(workflow, readyToolNames).resolutions;
+        for (const resolution of resolutions) {
+            const invocation = buildInvocation(step.id, step.kind, step.requiredToolNames.includes(resolution.toolName), resolution);
+            if (invocation) {
+                invocations.push(invocation);
+            }
+        }
+    }
+    return {
+        status: invocations.length === 0
+            ? "empty"
+            : run.status === "partial"
+                ? "partial"
+                : "ready",
+        invocations,
+        skippedStepIds,
+        blockingReasons: [...run.executionPlan.blockingReasons],
+        warnings: [...run.executionPlan.warnings],
+    };
+}
+export function buildAssistantWorkflowToolInvocationQueueTracePayload(queue) {
+    return {
+        status: queue.status,
+        invocationCount: queue.invocations.length,
+        invocations: queue.invocations.map((invocation) => ({
+            id: invocation.id,
+            stepId: invocation.stepId,
+            stepKind: invocation.stepKind,
+            toolName: invocation.toolName,
+            required: invocation.required,
+            provider: invocation.provider,
+            effect: invocation.capability.effect,
+            outputKinds: invocation.capability.outputKinds,
+            bindingProvider: invocation.binding.provider,
+        })),
+        skippedStepIds: queue.skippedStepIds,
+        blockingReasons: queue.blockingReasons,
+        warnings: queue.warnings,
+    };
+}
+function buildInvocation(stepId, stepKind, required, resolution) {
+    if (resolution.status !== "ready" || !resolution.capability || !resolution.binding || !resolution.provider) {
+        return null;
+    }
+    return {
+        id: `${stepId}:${resolution.toolName}`,
+        stepId,
+        stepKind,
+        toolName: resolution.toolName,
+        required,
+        provider: resolution.provider,
+        capability: resolution.capability,
+        binding: resolution.binding,
+    };
+}
+//# sourceMappingURL=tool-invocations.js.map

package/dist/tool-invocations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-invocations.js","sourceRoot":"","sources":["../src/tool-invocations.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AssistantWorkflowDefinition,\n  AssistantWorkflowPlanningStepKind,\n  AssistantWorkflowToolBindingDefinition,\n  AssistantWorkflowToolCapabilityDefinition,\n  AssistantWorkflowToolProvider,\n} from \"./definition.js\";\nimport type { AssistantWorkflowExecutionPlan, AssistantWorkflowExecutionPlanStatus } from \"./execution-plan.js\";\nimport {\n  resolveAssistantWorkflowTools,\n  type AssistantWorkflowToolResolution,\n} from \"./tool-bindings.js\";\n\nexport type AssistantWorkflowToolInvocationQueueStatus =\n  | \"ready\"\n  | \"partial\"\n  | \"blocked\"\n  | \"empty\";\n\nexport type AssistantWorkflowToolInvocation = {\n  id: string;\n  stepId: string;\n  stepKind: AssistantWorkflowPlanningStepKind;\n  toolName: string;\n  required: boolean;\n  provider: AssistantWorkflowToolProvider;\n  capability: AssistantWorkflowToolCapabilityDefinition;\n  binding: AssistantWorkflowToolBindingDefinition;\n};\n\nexport type AssistantWorkflowToolInvocationQueue = {\n  status: AssistantWorkflowToolInvocationQueueStatus;\n  invocations: AssistantWorkflowToolInvocation[];\n  skippedStepIds: string[];\n  blockingReasons: string[];\n  warnings: string[];\n};\n\nexport type AssistantWorkflowToolInvocationQueueOptions = {\n  includeOptional?: boolean;\n  allowWhenBlocked?: boolean;\n};\n\nexport type AssistantWorkflowToolInvocationRun = {\n  status: AssistantWorkflowExecutionPlanStatus;\n  executionPlan: AssistantWorkflowExecutionPlan;\n};\n\nexport function buildAssistantWorkflowToolInvocationQueue(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  run: AssistantWorkflowToolInvocationRun,\n  options: AssistantWorkflowToolInvocationQueueOptions = {},\n): AssistantWorkflowToolInvocationQueue {\n  const includeOptional = options.includeOptional !== false;\n  const blocked = run.status === \"blocked\" || run.status === \"needs-clarification\";\n  if (blocked && options.allowWhenBlocked !== true) {\n    return {\n      status: \"blocked\",\n      invocations: [],\n      skippedStepIds: run.executionPlan.steps.map((step) => step.id),\n      blockingReasons: [...run.executionPlan.blockingReasons],\n      warnings: [...run.executionPlan.warnings],\n    };\n  }\n\n  const invocations: AssistantWorkflowToolInvocation[] = [];\n  const skippedStepIds: string[] = [];\n  for (const step of run.executionPlan.steps) {\n    if (step.status === \"blocked\" || step.status === \"optional-skipped\") {\n      skippedStepIds.push(step.id);\n      continue;\n    }\n    const readyToolNames = includeOptional\n      ? step.readyToolNames\n      : step.readyToolNames.filter((toolName) => step.requiredToolNames.includes(toolName));\n    const resolutions = resolveAssistantWorkflowTools(workflow, readyToolNames).resolutions;\n    for (const resolution of resolutions) {\n      const invocation = buildInvocation(step.id, step.kind, step.requiredToolNames.includes(resolution.toolName), resolution);\n      if (invocation) {\n        invocations.push(invocation);\n      }\n    }\n  }\n\n  return {\n    status:\n      invocations.length === 0\n        ? \"empty\"\n        : run.status === \"partial\"\n        ? \"partial\"\n        : \"ready\",\n    invocations,\n    skippedStepIds,\n    blockingReasons: [...run.executionPlan.blockingReasons],\n    warnings: [...run.executionPlan.warnings],\n  };\n}\n\nexport function buildAssistantWorkflowToolInvocationQueueTracePayload(\n  queue: AssistantWorkflowToolInvocationQueue,\n): Record<string, unknown> {\n  return {\n    status: queue.status,\n    invocationCount: queue.invocations.length,\n    invocations: queue.invocations.map((invocation) => ({\n      id: invocation.id,\n      stepId: invocation.stepId,\n      stepKind: invocation.stepKind,\n      toolName: invocation.toolName,\n      required: invocation.required,\n      provider: invocation.provider,\n      effect: invocation.capability.effect,\n      outputKinds: invocation.capability.outputKinds,\n      bindingProvider: invocation.binding.provider,\n    })),\n    skippedStepIds: queue.skippedStepIds,\n    blockingReasons: queue.blockingReasons,\n    warnings: queue.warnings,\n  };\n}\n\nfunction buildInvocation(\n  stepId: string,\n  stepKind: AssistantWorkflowPlanningStepKind,\n  required: boolean,\n  resolution: AssistantWorkflowToolResolution,\n): AssistantWorkflowToolInvocation | null {\n  if (resolution.status !== \"ready\" || !resolution.capability || !resolution.binding || !resolution.provider) {\n    return null;\n  }\n  return {\n    id: `${stepId}:${resolution.toolName}`,\n    stepId,\n    stepKind,\n    toolName: resolution.toolName,\n    required,\n    provider: resolution.provider,\n    capability: resolution.capability,\n    binding: resolution.binding,\n  };\n}\n"]}

package/dist/tool-provider-executors.d.ts

@@ -0,0 +1,43 @@
+import type { AssistantWorkflowHttpMethod } from "./definition.js";
+import type { AssistantWorkflowToolExecutorContext, AssistantWorkflowToolInvocationArgs, AssistantWorkflowToolInvocationForProvider, AssistantWorkflowToolProviderExecutor } from "./tool-executor.js";
+export type AssistantWorkflowLocalFunctionToolExecutionRequest = {
+    invocation: AssistantWorkflowToolInvocationForProvider<"local-function">;
+    handlerId: string;
+    args: AssistantWorkflowToolInvocationArgs;
+};
+export type AssistantWorkflowHttpToolExecutionRequest = {
+    invocation: AssistantWorkflowToolInvocationForProvider<"http">;
+    method: AssistantWorkflowHttpMethod;
+    path: string;
+    baseUrlRef: string | null;
+    operationId: string | null;
+    args: AssistantWorkflowToolInvocationArgs;
+};
+export type AssistantWorkflowMcpToolExecutionRequest = {
+    invocation: AssistantWorkflowToolInvocationForProvider<"mcp">;
+    serverId: string;
+    toolName: string;
+    args: AssistantWorkflowToolInvocationArgs;
+};
+export type AssistantWorkflowHostedToolExecutionRequest = {
+    invocation: AssistantWorkflowToolInvocationForProvider<"openai-hosted">;
+    hostedToolType: string;
+    toolName: string | null;
+    args: AssistantWorkflowToolInvocationArgs;
+};
+export type AssistantWorkflowReplToolExecutionRequest = {
+    invocation: AssistantWorkflowToolInvocationForProvider<"repl">;
+    runtimeId: string;
+    functionName: string | null;
+    commandTemplate: string | null;
+    allowFilesystem: boolean;
+    allowNetwork: boolean;
+    args: AssistantWorkflowToolInvocationArgs;
+};
+export declare function createAssistantWorkflowLocalFunctionToolProviderExecutor(execute: (request: AssistantWorkflowLocalFunctionToolExecutionRequest) => unknown | Promise<unknown>): AssistantWorkflowToolProviderExecutor<"local-function">;
+export declare function createAssistantWorkflowHttpToolProviderExecutor(execute: (request: AssistantWorkflowHttpToolExecutionRequest) => unknown | Promise<unknown>): AssistantWorkflowToolProviderExecutor<"http">;
+export declare function createAssistantWorkflowMcpToolProviderExecutor(execute: (request: AssistantWorkflowMcpToolExecutionRequest) => unknown | Promise<unknown>): AssistantWorkflowToolProviderExecutor<"mcp">;
+export declare function createAssistantWorkflowHostedToolProviderExecutor(execute: (request: AssistantWorkflowHostedToolExecutionRequest) => unknown | Promise<unknown>): AssistantWorkflowToolProviderExecutor<"openai-hosted">;
+export declare function createAssistantWorkflowReplToolProviderExecutor(execute: (request: AssistantWorkflowReplToolExecutionRequest) => unknown | Promise<unknown>): AssistantWorkflowToolProviderExecutor<"repl">;
+export declare function buildAssistantWorkflowToolProviderExecutionTracePayload(invocation: AssistantWorkflowToolInvocationForProvider, context: AssistantWorkflowToolExecutorContext): Record<string, unknown>;
+//# sourceMappingURL=tool-provider-executors.d.ts.map

package/dist/tool-provider-executors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-provider-executors.d.ts","sourceRoot":"","sources":["../src/tool-provider-executors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,oCAAoC,EACpC,mCAAmC,EACnC,0CAA0C,EAC1C,qCAAqC,EACtC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,kDAAkD,GAAG;IAC/D,UAAU,EAAE,0CAA0C,CAAC,gBAAgB,CAAC,CAAC;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,mCAAmC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,yCAAyC,GAAG;IACtD,UAAU,EAAE,0CAA0C,CAAC,MAAM,CAAC,CAAC;IAC/D,MAAM,EAAE,2BAA2B,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,mCAAmC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,wCAAwC,GAAG;IACrD,UAAU,EAAE,0CAA0C,CAAC,KAAK,CAAC,CAAC;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,mCAAmC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,UAAU,EAAE,0CAA0C,CAAC,eAAe,CAAC,CAAC;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,mCAAmC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,yCAAyC,GAAG;IACtD,UAAU,EAAE,0CAA0C,CAAC,MAAM,CAAC,CAAC;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,mCAAmC,CAAC;CAC3C,CAAC;AAEF,wBAAgB,wDAAwD,CACtE,OAAO,EAAE,CAAC,OAAO,EAAE,kDAAkD,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GACnG,qCAAqC,CAAC,gBAAgB,CAAC,CAOzD;AAED,wBAAgB,+CAA+C,CAC7D,OAAO,EAAE,CAAC,OAAO,EAAE,yCAAyC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC1F,qCAAqC,CAAC,MAAM,CAAC,CAU/C;AAED,wBAAgB,8CAA8C,CAC5D,OAAO,EAAE,CAAC,OAAO,EAAE,wCAAwC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GACzF,qCAAqC,CAAC,KAAK,CAAC,CAQ9C;AAED,wBAAgB,iDAAiD,CAC/D,OAAO,EAAE,CAAC,OAAO,EAAE,2CAA2C,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC5F,qCAAqC,CAAC,eAAe,CAAC,CAQxD;AAED,wBAAgB,+CAA+C,CAC7D,OAAO,EAAE,CAAC,OAAO,EAAE,yCAAyC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC1F,qCAAqC,CAAC,MAAM,CAAC,CAW/C;AAED,wBAAgB,uDAAuD,CACrE,UAAU,EAAE,0CAA0C,EACtD,OAAO,EAAE,oCAAoC,GAC5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB"}

package/dist/tool-provider-executors.js

@@ -0,0 +1,59 @@
+export function createAssistantWorkflowLocalFunctionToolProviderExecutor(execute) {
+    return async (invocation, context) => await execute({
+        invocation,
+        handlerId: invocation.binding.handlerId,
+        args: context.args,
+    });
+}
+export function createAssistantWorkflowHttpToolProviderExecutor(execute) {
+    return async (invocation, context) => await execute({
+        invocation,
+        method: invocation.binding.method ?? "GET",
+        path: invocation.binding.path,
+        baseUrlRef: normalizeNullableString(invocation.binding.baseUrlRef),
+        operationId: normalizeNullableString(invocation.binding.operationId),
+        args: context.args,
+    });
+}
+export function createAssistantWorkflowMcpToolProviderExecutor(execute) {
+    return async (invocation, context) => await execute({
+        invocation,
+        serverId: invocation.binding.serverId,
+        toolName: invocation.binding.toolName,
+        args: context.args,
+    });
+}
+export function createAssistantWorkflowHostedToolProviderExecutor(execute) {
+    return async (invocation, context) => await execute({
+        invocation,
+        hostedToolType: invocation.binding.hostedToolType,
+        toolName: normalizeNullableString(invocation.binding.toolName),
+        args: context.args,
+    });
+}
+export function createAssistantWorkflowReplToolProviderExecutor(execute) {
+    return async (invocation, context) => await execute({
+        invocation,
+        runtimeId: invocation.binding.runtimeId,
+        functionName: normalizeNullableString(invocation.binding.functionName),
+        commandTemplate: normalizeNullableString(invocation.binding.commandTemplate),
+        allowFilesystem: invocation.binding.allowFilesystem === true,
+        allowNetwork: invocation.binding.allowNetwork === true,
+        args: context.args,
+    });
+}
+export function buildAssistantWorkflowToolProviderExecutionTracePayload(invocation, context) {
+    return {
+        invocationId: invocation.id,
+        toolName: invocation.toolName,
+        provider: invocation.provider,
+        stepId: invocation.stepId,
+        invocationIndex: context.invocationIndex,
+        queueStatus: context.queueStatus,
+        argumentCount: Object.keys(context.args).length,
+    };
+}
+function normalizeNullableString(value) {
+    return typeof value === "string" && value.trim().length ? value.trim() : null;
+}
+//# sourceMappingURL=tool-provider-executors.js.map

package/dist/tool-provider-executors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-provider-executors.js","sourceRoot":"","sources":["../src/tool-provider-executors.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AssistantWorkflowHttpMethod,\n} from \"./definition.js\";\nimport type {\n  AssistantWorkflowToolExecutorContext,\n  AssistantWorkflowToolInvocationArgs,\n  AssistantWorkflowToolInvocationForProvider,\n  AssistantWorkflowToolProviderExecutor,\n} from \"./tool-executor.js\";\n\nexport type AssistantWorkflowLocalFunctionToolExecutionRequest = {\n  invocation: AssistantWorkflowToolInvocationForProvider<\"local-function\">;\n  handlerId: string;\n  args: AssistantWorkflowToolInvocationArgs;\n};\n\nexport type AssistantWorkflowHttpToolExecutionRequest = {\n  invocation: AssistantWorkflowToolInvocationForProvider<\"http\">;\n  method: AssistantWorkflowHttpMethod;\n  path: string;\n  baseUrlRef: string | null;\n  operationId: string | null;\n  args: AssistantWorkflowToolInvocationArgs;\n};\n\nexport type AssistantWorkflowMcpToolExecutionRequest = {\n  invocation: AssistantWorkflowToolInvocationForProvider<\"mcp\">;\n  serverId: string;\n  toolName: string;\n  args: AssistantWorkflowToolInvocationArgs;\n};\n\nexport type AssistantWorkflowHostedToolExecutionRequest = {\n  invocation: AssistantWorkflowToolInvocationForProvider<\"openai-hosted\">;\n  hostedToolType: string;\n  toolName: string | null;\n  args: AssistantWorkflowToolInvocationArgs;\n};\n\nexport type AssistantWorkflowReplToolExecutionRequest = {\n  invocation: AssistantWorkflowToolInvocationForProvider<\"repl\">;\n  runtimeId: string;\n  functionName: string | null;\n  commandTemplate: string | null;\n  allowFilesystem: boolean;\n  allowNetwork: boolean;\n  args: AssistantWorkflowToolInvocationArgs;\n};\n\nexport function createAssistantWorkflowLocalFunctionToolProviderExecutor(\n  execute: (request: AssistantWorkflowLocalFunctionToolExecutionRequest) => unknown | Promise<unknown>,\n): AssistantWorkflowToolProviderExecutor<\"local-function\"> {\n  return async (invocation, context) =>\n    await execute({\n      invocation,\n      handlerId: invocation.binding.handlerId,\n      args: context.args,\n    });\n}\n\nexport function createAssistantWorkflowHttpToolProviderExecutor(\n  execute: (request: AssistantWorkflowHttpToolExecutionRequest) => unknown | Promise<unknown>,\n): AssistantWorkflowToolProviderExecutor<\"http\"> {\n  return async (invocation, context) =>\n    await execute({\n      invocation,\n      method: invocation.binding.method ?? \"GET\",\n      path: invocation.binding.path,\n      baseUrlRef: normalizeNullableString(invocation.binding.baseUrlRef),\n      operationId: normalizeNullableString(invocation.binding.operationId),\n      args: context.args,\n    });\n}\n\nexport function createAssistantWorkflowMcpToolProviderExecutor(\n  execute: (request: AssistantWorkflowMcpToolExecutionRequest) => unknown | Promise<unknown>,\n): AssistantWorkflowToolProviderExecutor<\"mcp\"> {\n  return async (invocation, context) =>\n    await execute({\n      invocation,\n      serverId: invocation.binding.serverId,\n      toolName: invocation.binding.toolName,\n      args: context.args,\n    });\n}\n\nexport function createAssistantWorkflowHostedToolProviderExecutor(\n  execute: (request: AssistantWorkflowHostedToolExecutionRequest) => unknown | Promise<unknown>,\n): AssistantWorkflowToolProviderExecutor<\"openai-hosted\"> {\n  return async (invocation, context) =>\n    await execute({\n      invocation,\n      hostedToolType: invocation.binding.hostedToolType,\n      toolName: normalizeNullableString(invocation.binding.toolName),\n      args: context.args,\n    });\n}\n\nexport function createAssistantWorkflowReplToolProviderExecutor(\n  execute: (request: AssistantWorkflowReplToolExecutionRequest) => unknown | Promise<unknown>,\n): AssistantWorkflowToolProviderExecutor<\"repl\"> {\n  return async (invocation, context) =>\n    await execute({\n      invocation,\n      runtimeId: invocation.binding.runtimeId,\n      functionName: normalizeNullableString(invocation.binding.functionName),\n      commandTemplate: normalizeNullableString(invocation.binding.commandTemplate),\n      allowFilesystem: invocation.binding.allowFilesystem === true,\n      allowNetwork: invocation.binding.allowNetwork === true,\n      args: context.args,\n    });\n}\n\nexport function buildAssistantWorkflowToolProviderExecutionTracePayload(\n  invocation: AssistantWorkflowToolInvocationForProvider,\n  context: AssistantWorkflowToolExecutorContext,\n): Record<string, unknown> {\n  return {\n    invocationId: invocation.id,\n    toolName: invocation.toolName,\n    provider: invocation.provider,\n    stepId: invocation.stepId,\n    invocationIndex: context.invocationIndex,\n    queueStatus: context.queueStatus,\n    argumentCount: Object.keys(context.args).length,\n  };\n}\n\nfunction normalizeNullableString(value: unknown): string | null {\n  return typeof value === \"string\" && value.trim().length ? value.trim() : null;\n}\n"]}

package/dist/tool-result-cache.d.ts

@@ -0,0 +1,37 @@
+export type AssistantWorkflowToolResultCacheStats = {
+    hits: number;
+    misses: number;
+    evictions: number;
+    expirations: number;
+    size: number;
+};
+export type AssistantWorkflowToolResultCacheOptions = {
+    maxEntries?: number;
+    cacheableToolNames?: ReadonlySet<string> | readonly string[] | null;
+    isCacheableTool?: (toolName: string) => boolean;
+    sortArrayArgKeys?: readonly string[];
+    chooseTtlMs?: (args: Record<string, unknown>, nowMs: number) => number;
+    shouldCacheValue?: (value: string) => boolean;
+};
+export declare function chooseAssistantWorkflowToolResultCacheTtlMs(args: Record<string, unknown>, nowMs: number): number;
+export declare function buildAssistantWorkflowToolResultCacheKey(scopeId: string, toolName: string, args: Record<string, unknown>, options?: Pick<AssistantWorkflowToolResultCacheOptions, "sortArrayArgKeys">): string;
+export declare function normalizeToolResultCacheValue(value: unknown): unknown;
+export declare class AssistantWorkflowToolResultCache {
+    private readonly cache;
+    private readonly maxEntries;
+    private readonly cacheableToolNames;
+    private readonly isCacheableToolFn;
+    private readonly sortArrayArgKeys;
+    private readonly chooseTtlMsFn;
+    private readonly shouldCacheValueFn;
+    private stats;
+    constructor(options?: AssistantWorkflowToolResultCacheOptions);
+    isCacheableTool(toolName: string): boolean;
+    get(scopeId: string, toolName: string, args: Record<string, unknown>, nowMs: number): string | null;
+    set(scopeId: string, toolName: string, args: Record<string, unknown>, value: string, nowMs: number): void;
+    clearScope(scopeId: string): void;
+    clear(): void;
+    getStats(): AssistantWorkflowToolResultCacheStats;
+    private buildKey;
+}
+//# sourceMappingURL=tool-result-cache.d.ts.map

package/dist/tool-result-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-cache.d.ts","sourceRoot":"","sources":["../src/tool-result-cache.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,uCAAuC,GAAG;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACpE,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvE,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/C,CAAC;AAcF,wBAAgB,2CAA2C,CACzD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR;AAED,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,IAAI,CAAC,uCAAuC,EAAE,kBAAkB,CAAM,GAC9E,MAAM,CAiBR;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAyBrE;AAED,qBAAa,gCAAgC;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAChE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyC;IAC3E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2D;IACzF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAChE,OAAO,CAAC,KAAK,CAMX;gBAEU,OAAO,GAAE,uCAA4C;IAWjE,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAM1C,GAAG,CACD,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI;IAqBhB,GAAG,CACD,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI;IAmBP,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUjC,KAAK,IAAI,IAAI;IAKb,QAAQ,IAAI,qCAAqC;IAIjD,OAAO,CAAC,QAAQ;CASjB"}