@uns-kit/assistant-workflow 2.0.72

package/dist/hosted-tool-policy.js

@@ -0,0 +1,228 @@
+const DEFAULT_ASSISTANT_WORKFLOW_HOSTED_TOOL_POLICY = {
+    enabled: false,
+    allowlist: [],
+};
+export function parseAssistantWorkflowHostedToolPolicy(value, options = {}) {
+    if (!isRecord(value)) {
+        return {
+            enabled: DEFAULT_ASSISTANT_WORKFLOW_HOSTED_TOOL_POLICY.enabled,
+            allowlist: [],
+        };
+    }
+    const rawAllowlist = Array.isArray(value["allowlist"])
+        ? value["allowlist"]
+        : Array.isArray(value["allowedTools"])
+            ? value["allowedTools"]
+            : [];
+    const allowlist = rawAllowlist
+        .map((entry) => parseHostedToolAllowlistEntry(entry, options))
+        .filter((entry) => entry !== null);
+    return {
+        enabled: value["enabled"] === true,
+        allowlist,
+    };
+}
+export function selectAssistantWorkflowHostedToolsForRequest(policy, input) {
+    const transport = normalizeHostedToolTransport(input.transport);
+    const externalRequest = input.externalRequest === true;
+    const tools = [];
+    const allowedTypes = [];
+    const blocked = [];
+    const seen = new Set();
+    for (const entry of policy.allowlist) {
+        if (!policy.enabled) {
+            blocked.push({ type: entry.type, reason: "policy_disabled" });
+            continue;
+        }
+        if (!entry.enabled) {
+            blocked.push({ type: entry.type, reason: "entry_disabled" });
+            continue;
+        }
+        if (transport !== "responses") {
+            blocked.push({ type: entry.type, reason: "responses_transport_required" });
+            continue;
+        }
+        if (!entry.lanes.includes(input.lane)) {
+            blocked.push({ type: entry.type, reason: "lane_not_allowed" });
+            continue;
+        }
+        if (entry.externalOnly && !externalRequest) {
+            blocked.push({ type: entry.type, reason: "external_intent_required" });
+            continue;
+        }
+        const signature = JSON.stringify(entry.definition);
+        if (seen.has(signature)) {
+            blocked.push({ type: entry.type, reason: "duplicate" });
+            continue;
+        }
+        seen.add(signature);
+        tools.push(entry.definition);
+        allowedTypes.push(entry.type);
+    }
+    return {
+        enabled: policy.enabled,
+        configuredCount: policy.allowlist.length,
+        tools,
+        allowedTypes,
+        blocked,
+    };
+}
+export function isAssistantWorkflowExternalWebSearchClassification(classification) {
+    return classification?.intent === "external_web_search";
+}
+export function assistantWorkflowRequestHasHostedTool(tools, type) {
+    return (tools ?? []).some((tool) => tool.type === type);
+}
+export function buildAssistantWorkflowHostedToolDirectiveForRequest(input) {
+    if (!input.externalWebSearchRequest ||
+        !assistantWorkflowRequestHasHostedTool(input.hostedTools, "web_search")) {
+        return null;
+    }
+    return {
+        localTools: "exclude",
+        toolChoice: "required",
+        reason: "external_web_search",
+    };
+}
+export function normalizeAssistantWorkflowHostedToolType(value) {
+    if (typeof value !== "string")
+        return null;
+    const normalized = value.trim().toLowerCase().replace(/-/g, "_");
+    if (normalized === "web_search" || normalized === "web_search_preview")
+        return "web_search";
+    if (normalized === "file_search")
+        return "file_search";
+    if (normalized === "mcp" || normalized === "remote_mcp")
+        return "mcp";
+    if (normalized === "tool_search")
+        return "tool_search";
+    return null;
+}
+export function normalizeAssistantWorkflowHostedToolLane(value) {
+    const normalized = value.trim().toLowerCase().replace(/_/g, "-");
+    return normalized.length ? normalized : null;
+}
+function parseHostedToolAllowlistEntry(value, options) {
+    const raw = typeof value === "string" ? { type: value } : value;
+    if (!isRecord(raw))
+        return null;
+    const type = normalizeAssistantWorkflowHostedToolType(raw["type"]);
+    if (!type)
+        return null;
+    const definition = buildHostedToolDefinition(type, raw);
+    if (!definition)
+        return null;
+    return {
+        type,
+        enabled: raw["enabled"] !== false,
+        lanes: parseHostedToolLanes(raw["lanes"], options),
+        externalOnly: typeof raw["externalOnly"] === "boolean" ? raw["externalOnly"] : type === "web_search",
+        definition,
+    };
+}
+function buildHostedToolDefinition(type, raw) {
+    if (type === "web_search" || type === "tool_search") {
+        return { type };
+    }
+    if (type === "file_search") {
+        const vectorStoreIds = toStringArray(raw["vectorStoreIds"] ?? raw["vector_store_ids"]);
+        if (!vectorStoreIds.length)
+            return null;
+        return {
+            type,
+            vector_store_ids: vectorStoreIds,
+        };
+    }
+    const serverLabel = toTrimmedString(raw["serverLabel"] ?? raw["server_label"]);
+    const serverUrl = toTrimmedString(raw["serverUrl"] ?? raw["server_url"]);
+    const connectorId = toTrimmedString(raw["connectorId"] ?? raw["connector_id"]);
+    if (!serverLabel || (!serverUrl && !connectorId))
+        return null;
+    const serverDescription = toTrimmedString(raw["serverDescription"] ?? raw["server_description"]);
+    const allowedTools = parseMcpAllowedTools(raw);
+    const requireApproval = normalizeMcpApproval(raw["requireApproval"] ?? raw["require_approval"]);
+    return {
+        type: "mcp",
+        server_label: serverLabel,
+        ...(serverUrl ? { server_url: serverUrl } : {}),
+        ...(connectorId ? { connector_id: connectorId } : {}),
+        ...(serverDescription ? { server_description: serverDescription } : {}),
+        ...(allowedTools ? { allowed_tools: allowedTools } : {}),
+        ...(requireApproval ? { require_approval: requireApproval } : {}),
+    };
+}
+function parseHostedToolLanes(value, options) {
+    const rawValues = Array.isArray(value) ? value : typeof value === "string" ? [value] : [];
+    const lanes = new Set();
+    const normalizeLane = options.normalizeLane ?? ((raw) => normalizeAssistantWorkflowHostedToolLane(raw));
+    for (const raw of rawValues) {
+        if (typeof raw !== "string")
+            continue;
+        const lane = normalizeLane(raw);
+        if (lane)
+            lanes.add(lane);
+    }
+    return lanes.size ? [...lanes] : [...(options.defaultLanes ?? ["assistant"])];
+}
+function normalizeHostedToolTransport(value) {
+    if (typeof value !== "string")
+        return "chat_completions";
+    const normalized = value.trim().toLowerCase().replace(/[.-]/g, "_");
+    if (normalized === "responses" || normalized === "response")
+        return "responses";
+    return "chat_completions";
+}
+function parseMcpAllowedTools(raw) {
+    const arrayValue = toStringArray(raw["allowedTools"] ?? raw["allowed_tools"]);
+    if (arrayValue.length)
+        return arrayValue;
+    const filter = raw["allowedToolFilter"] ?? raw["allowed_tool_filter"];
+    if (!isRecord(filter))
+        return null;
+    const readOnly = typeof filter["readOnly"] === "boolean"
+        ? filter["readOnly"]
+        : typeof filter["read_only"] === "boolean"
+            ? filter["read_only"]
+            : undefined;
+    const toolNames = toStringArray(filter["toolNames"] ?? filter["tool_names"]);
+    if (readOnly === undefined && !toolNames.length)
+        return null;
+    return {
+        ...(readOnly !== undefined ? { read_only: readOnly } : {}),
+        ...(toolNames.length ? { tool_names: toolNames } : {}),
+    };
+}
+function normalizeMcpApproval(value) {
+    if (value === true)
+        return "always";
+    if (value === false)
+        return "never";
+    if (typeof value !== "string")
+        return null;
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "always" || normalized === "never")
+        return normalized;
+    return null;
+}
+function toStringArray(value) {
+    const rawValues = Array.isArray(value) ? value : typeof value === "string" ? [value] : [];
+    const result = [];
+    const seen = new Set();
+    for (const raw of rawValues) {
+        if (typeof raw !== "string")
+            continue;
+        const trimmed = raw.trim();
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        result.push(trimmed);
+    }
+    return result;
+}
+function toTrimmedString(value) {
+    return typeof value === "string" && value.trim().length ? value.trim() : null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=hosted-tool-policy.js.map

package/dist/hosted-tool-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-tool-policy.js","sourceRoot":"","sources":["../src/hosted-tool-policy.ts"],"names":[],"mappings":"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","sourcesContent":["export type AssistantWorkflowHostedToolType = \"web_search\" | \"file_search\" | \"mcp\" | \"tool_search\";\n\nexport type AssistantWorkflowHostedToolDefinition =\n  | { type: \"web_search\" }\n  | { type: \"file_search\"; vector_store_ids: string[] }\n  | {\n      type: \"mcp\";\n      server_label: string;\n      server_url?: string;\n      connector_id?: string;\n      server_description?: string;\n      allowed_tools?: string[] | { read_only?: boolean; tool_names?: string[] };\n      require_approval?: \"always\" | \"never\";\n    }\n  | { type: \"tool_search\" };\n\nexport type AssistantWorkflowHostedToolAllowlistEntry<TLane extends string = string> = {\n  type: AssistantWorkflowHostedToolType;\n  enabled: boolean;\n  lanes: TLane[];\n  externalOnly: boolean;\n  definition: AssistantWorkflowHostedToolDefinition;\n};\n\nexport type AssistantWorkflowHostedToolPolicy<TLane extends string = string> = {\n  enabled: boolean;\n  allowlist: AssistantWorkflowHostedToolAllowlistEntry<TLane>[];\n};\n\nexport type AssistantWorkflowHostedToolBlockedReason =\n  | \"policy_disabled\"\n  | \"entry_disabled\"\n  | \"responses_transport_required\"\n  | \"lane_not_allowed\"\n  | \"external_intent_required\"\n  | \"duplicate\";\n\nexport type AssistantWorkflowHostedToolBlockedEntry = {\n  type: AssistantWorkflowHostedToolType;\n  reason: AssistantWorkflowHostedToolBlockedReason;\n};\n\nexport type AssistantWorkflowHostedToolSelection = {\n  enabled: boolean;\n  configuredCount: number;\n  tools: AssistantWorkflowHostedToolDefinition[];\n  allowedTypes: AssistantWorkflowHostedToolType[];\n  blocked: AssistantWorkflowHostedToolBlockedEntry[];\n};\n\nexport type AssistantWorkflowHostedToolDirective = {\n  localTools: \"include\" | \"exclude\";\n  toolChoice: \"auto\" | \"required\";\n  reason: string;\n};\n\nexport type AssistantWorkflowHostedToolIntentClassification = {\n  intent?: string | null;\n} | null | undefined;\n\nexport type AssistantWorkflowHostedToolPolicyParseOptions<TLane extends string = string> = {\n  normalizeLane?: (value: string) => TLane | null;\n  defaultLanes?: readonly TLane[];\n};\n\nconst DEFAULT_ASSISTANT_WORKFLOW_HOSTED_TOOL_POLICY: AssistantWorkflowHostedToolPolicy<string> = {\n  enabled: false,\n  allowlist: [],\n};\n\nexport function parseAssistantWorkflowHostedToolPolicy<TLane extends string = string>(\n  value: unknown,\n  options: AssistantWorkflowHostedToolPolicyParseOptions<TLane> = {},\n): AssistantWorkflowHostedToolPolicy<TLane> {\n  if (!isRecord(value)) {\n    return {\n      enabled: DEFAULT_ASSISTANT_WORKFLOW_HOSTED_TOOL_POLICY.enabled,\n      allowlist: [],\n    };\n  }\n  const rawAllowlist = Array.isArray(value[\"allowlist\"])\n    ? value[\"allowlist\"]\n    : Array.isArray(value[\"allowedTools\"])\n      ? value[\"allowedTools\"]\n      : [];\n  const allowlist = rawAllowlist\n    .map((entry) => parseHostedToolAllowlistEntry(entry, options))\n    .filter((entry): entry is AssistantWorkflowHostedToolAllowlistEntry<TLane> => entry !== null);\n  return {\n    enabled: value[\"enabled\"] === true,\n    allowlist,\n  };\n}\n\nexport function selectAssistantWorkflowHostedToolsForRequest<TLane extends string = string>(\n  policy: AssistantWorkflowHostedToolPolicy<TLane>,\n  input: {\n    lane: TLane;\n    transport: string | null | undefined;\n    externalRequest?: boolean | null;\n  },\n): AssistantWorkflowHostedToolSelection {\n  const transport = normalizeHostedToolTransport(input.transport);\n  const externalRequest = input.externalRequest === true;\n  const tools: AssistantWorkflowHostedToolDefinition[] = [];\n  const allowedTypes: AssistantWorkflowHostedToolType[] = [];\n  const blocked: AssistantWorkflowHostedToolBlockedEntry[] = [];\n  const seen = new Set<string>();\n\n  for (const entry of policy.allowlist) {\n    if (!policy.enabled) {\n      blocked.push({ type: entry.type, reason: \"policy_disabled\" });\n      continue;\n    }\n    if (!entry.enabled) {\n      blocked.push({ type: entry.type, reason: \"entry_disabled\" });\n      continue;\n    }\n    if (transport !== \"responses\") {\n      blocked.push({ type: entry.type, reason: \"responses_transport_required\" });\n      continue;\n    }\n    if (!entry.lanes.includes(input.lane)) {\n      blocked.push({ type: entry.type, reason: \"lane_not_allowed\" });\n      continue;\n    }\n    if (entry.externalOnly && !externalRequest) {\n      blocked.push({ type: entry.type, reason: \"external_intent_required\" });\n      continue;\n    }\n    const signature = JSON.stringify(entry.definition);\n    if (seen.has(signature)) {\n      blocked.push({ type: entry.type, reason: \"duplicate\" });\n      continue;\n    }\n    seen.add(signature);\n    tools.push(entry.definition);\n    allowedTypes.push(entry.type);\n  }\n\n  return {\n    enabled: policy.enabled,\n    configuredCount: policy.allowlist.length,\n    tools,\n    allowedTypes,\n    blocked,\n  };\n}\n\nexport function isAssistantWorkflowExternalWebSearchClassification(\n  classification: AssistantWorkflowHostedToolIntentClassification,\n): boolean {\n  return classification?.intent === \"external_web_search\";\n}\n\nexport function assistantWorkflowRequestHasHostedTool(\n  tools: readonly AssistantWorkflowHostedToolDefinition[] | null | undefined,\n  type: AssistantWorkflowHostedToolType,\n): boolean {\n  return (tools ?? []).some((tool) => tool.type === type);\n}\n\nexport function buildAssistantWorkflowHostedToolDirectiveForRequest(input: {\n  externalWebSearchRequest: boolean;\n  hostedTools: readonly AssistantWorkflowHostedToolDefinition[] | null | undefined;\n}): AssistantWorkflowHostedToolDirective | null {\n  if (\n    !input.externalWebSearchRequest ||\n    !assistantWorkflowRequestHasHostedTool(input.hostedTools, \"web_search\")\n  ) {\n    return null;\n  }\n  return {\n    localTools: \"exclude\",\n    toolChoice: \"required\",\n    reason: \"external_web_search\",\n  };\n}\n\nexport function normalizeAssistantWorkflowHostedToolType(\n  value: unknown,\n): AssistantWorkflowHostedToolType | null {\n  if (typeof value !== \"string\") return null;\n  const normalized = value.trim().toLowerCase().replace(/-/g, \"_\");\n  if (normalized === \"web_search\" || normalized === \"web_search_preview\") return \"web_search\";\n  if (normalized === \"file_search\") return \"file_search\";\n  if (normalized === \"mcp\" || normalized === \"remote_mcp\") return \"mcp\";\n  if (normalized === \"tool_search\") return \"tool_search\";\n  return null;\n}\n\nexport function normalizeAssistantWorkflowHostedToolLane(value: string): string | null {\n  const normalized = value.trim().toLowerCase().replace(/_/g, \"-\");\n  return normalized.length ? normalized : null;\n}\n\nfunction parseHostedToolAllowlistEntry<TLane extends string>(\n  value: unknown,\n  options: AssistantWorkflowHostedToolPolicyParseOptions<TLane>,\n): AssistantWorkflowHostedToolAllowlistEntry<TLane> | null {\n  const raw = typeof value === \"string\" ? { type: value } : value;\n  if (!isRecord(raw)) return null;\n  const type = normalizeAssistantWorkflowHostedToolType(raw[\"type\"]);\n  if (!type) return null;\n  const definition = buildHostedToolDefinition(type, raw);\n  if (!definition) return null;\n  return {\n    type,\n    enabled: raw[\"enabled\"] !== false,\n    lanes: parseHostedToolLanes(raw[\"lanes\"], options),\n    externalOnly: typeof raw[\"externalOnly\"] === \"boolean\" ? raw[\"externalOnly\"] : type === \"web_search\",\n    definition,\n  };\n}\n\nfunction buildHostedToolDefinition(\n  type: AssistantWorkflowHostedToolType,\n  raw: Record<string, unknown>,\n): AssistantWorkflowHostedToolDefinition | null {\n  if (type === \"web_search\" || type === \"tool_search\") {\n    return { type };\n  }\n  if (type === \"file_search\") {\n    const vectorStoreIds = toStringArray(raw[\"vectorStoreIds\"] ?? raw[\"vector_store_ids\"]);\n    if (!vectorStoreIds.length) return null;\n    return {\n      type,\n      vector_store_ids: vectorStoreIds,\n    };\n  }\n  const serverLabel = toTrimmedString(raw[\"serverLabel\"] ?? raw[\"server_label\"]);\n  const serverUrl = toTrimmedString(raw[\"serverUrl\"] ?? raw[\"server_url\"]);\n  const connectorId = toTrimmedString(raw[\"connectorId\"] ?? raw[\"connector_id\"]);\n  if (!serverLabel || (!serverUrl && !connectorId)) return null;\n  const serverDescription = toTrimmedString(raw[\"serverDescription\"] ?? raw[\"server_description\"]);\n  const allowedTools = parseMcpAllowedTools(raw);\n  const requireApproval = normalizeMcpApproval(raw[\"requireApproval\"] ?? raw[\"require_approval\"]);\n  return {\n    type: \"mcp\",\n    server_label: serverLabel,\n    ...(serverUrl ? { server_url: serverUrl } : {}),\n    ...(connectorId ? { connector_id: connectorId } : {}),\n    ...(serverDescription ? { server_description: serverDescription } : {}),\n    ...(allowedTools ? { allowed_tools: allowedTools } : {}),\n    ...(requireApproval ? { require_approval: requireApproval } : {}),\n  };\n}\n\nfunction parseHostedToolLanes<TLane extends string>(\n  value: unknown,\n  options: AssistantWorkflowHostedToolPolicyParseOptions<TLane>,\n): TLane[] {\n  const rawValues = Array.isArray(value) ? value : typeof value === \"string\" ? [value] : [];\n  const lanes = new Set<TLane>();\n  const normalizeLane = options.normalizeLane ?? ((raw: string) => normalizeAssistantWorkflowHostedToolLane(raw) as TLane | null);\n  for (const raw of rawValues) {\n    if (typeof raw !== \"string\") continue;\n    const lane = normalizeLane(raw);\n    if (lane) lanes.add(lane);\n  }\n  return lanes.size ? [...lanes] : [...(options.defaultLanes ?? ([\"assistant\"] as TLane[]))];\n}\n\nfunction normalizeHostedToolTransport(value: unknown): \"chat_completions\" | \"responses\" {\n  if (typeof value !== \"string\") return \"chat_completions\";\n  const normalized = value.trim().toLowerCase().replace(/[.-]/g, \"_\");\n  if (normalized === \"responses\" || normalized === \"response\") return \"responses\";\n  return \"chat_completions\";\n}\n\nfunction parseMcpAllowedTools(raw: Record<string, unknown>): string[] | { read_only?: boolean; tool_names?: string[] } | null {\n  const arrayValue = toStringArray(raw[\"allowedTools\"] ?? raw[\"allowed_tools\"]);\n  if (arrayValue.length) return arrayValue;\n  const filter = raw[\"allowedToolFilter\"] ?? raw[\"allowed_tool_filter\"];\n  if (!isRecord(filter)) return null;\n  const readOnly = typeof filter[\"readOnly\"] === \"boolean\"\n    ? filter[\"readOnly\"]\n    : typeof filter[\"read_only\"] === \"boolean\"\n      ? filter[\"read_only\"]\n      : undefined;\n  const toolNames = toStringArray(filter[\"toolNames\"] ?? filter[\"tool_names\"]);\n  if (readOnly === undefined && !toolNames.length) return null;\n  return {\n    ...(readOnly !== undefined ? { read_only: readOnly } : {}),\n    ...(toolNames.length ? { tool_names: toolNames } : {}),\n  };\n}\n\nfunction normalizeMcpApproval(value: unknown): \"always\" | \"never\" | null {\n  if (value === true) return \"always\";\n  if (value === false) return \"never\";\n  if (typeof value !== \"string\") return null;\n  const normalized = value.trim().toLowerCase();\n  if (normalized === \"always\" || normalized === \"never\") return normalized;\n  return null;\n}\n\nfunction toStringArray(value: unknown): string[] {\n  const rawValues = Array.isArray(value) ? value : typeof value === \"string\" ? [value] : [];\n  const result: string[] = [];\n  const seen = new Set<string>();\n  for (const raw of rawValues) {\n    if (typeof raw !== \"string\") continue;\n    const trimmed = raw.trim();\n    if (!trimmed || seen.has(trimmed)) continue;\n    seen.add(trimmed);\n    result.push(trimmed);\n  }\n  return result;\n}\n\nfunction toTrimmedString(value: unknown): string | null {\n  return typeof value === \"string\" && value.trim().length ? value.trim() : null;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+export * from "./clarification-policy.js";
+export * from "./decision.js";
+export * from "./definition.js";
+export * from "./definition-catalog.js";
+export * from "./definition-catalog-replay.js";
+export * from "./definition-diagnostics.js";
+export * from "./definition-diff.js";
+export * from "./definition-json.js";
+export * from "./definition-manifest.js";
+export * from "./definition-package.js";
+export * from "./definition-package-executor.js";
+export * from "./definition-package-execution-json.js";
+export * from "./definition-package-execution-replay.js";
+export * from "./definition-package-loader.js";
+export * from "./definition-package-resolver.js";
+export * from "./definition-package-review.js";
+export * from "./definition-package-replay.js";
+export * from "./definition-package-run.js";
+export * from "./definition-package-run-report.js";
+export * from "./definition-package-selection.js";
+export * from "./definition-package-smoke.js";
+export * from "./definition-tuning.js";
+export * from "./definition-tuning-approval.js";
+export * from "./definition-tuning-json.js";
+export * from "./definition-tuning-promotion.js";
+export * from "./definition-tuning-replay.js";
+export * from "./definition-tuning-review.js";
+export * from "./definition-tuning-review-artifact.js";
+export * from "./definition-tuning-source-patch.js";
+export * from "./direct-route-invocation.js";
+export * from "./direct-route-policy.js";
+export * from "./eval-case.js";
+export * from "./eval-replay.js";
+export * from "./eval-result.js";
+export * from "./eval-runner.js";
+export * from "./eval-suite.js";
+export * from "./execution-plan.js";
+export * from "./hosted-tool-policy.js";
+export * from "./memory-policy.js";
+export * from "./memory-updates.js";
+export * from "./outcome.js";
+export * from "./outcome-trace.js";
+export * from "./policy-resolution.js";
+export * from "./planner-compiler.js";
+export * from "./planning.js";
+export * from "./run.js";
+export * from "./run-parity.js";
+export * from "./run-evaluation.js";
+export * from "./run-report.js";
+export * from "./run-report-batch.js";
+export * from "./run-report-json.js";
+export * from "./tool-invocations.js";
+export * from "./tool-provider-executors.js";
+export * from "./tool-result-cache.js";
+export * from "./tool-runtime.js";
+export * from "./tool-selection-evaluation.js";
+export * from "./tool-selection-json.js";
+export * from "./tool-selection-policy.js";
+export * from "./tool-selection-rules.js";
+export * from "./tool-selection-replay.js";
+export * from "./tool-selection-trace-export.js";
+export * from "./tool-results.js";
+export * from "./trace-events.js";
+export * from "./trace-payload.js";
+export * from "./trace-stages.js";
+export * from "./trace-report.js";
+export * from "./trace-replay.js";
+export * from "./tool-bindings.js";
+export * from "./tool-capabilities.js";
+export * from "./tool-executor.js";
+export * from "./tool-fixtures.js";
+export * from "./value-readers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,73 @@
+export * from "./clarification-policy.js";
+export * from "./decision.js";
+export * from "./definition.js";
+export * from "./definition-catalog.js";
+export * from "./definition-catalog-replay.js";
+export * from "./definition-diagnostics.js";
+export * from "./definition-diff.js";
+export * from "./definition-json.js";
+export * from "./definition-manifest.js";
+export * from "./definition-package.js";
+export * from "./definition-package-executor.js";
+export * from "./definition-package-execution-json.js";
+export * from "./definition-package-execution-replay.js";
+export * from "./definition-package-loader.js";
+export * from "./definition-package-resolver.js";
+export * from "./definition-package-review.js";
+export * from "./definition-package-replay.js";
+export * from "./definition-package-run.js";
+export * from "./definition-package-run-report.js";
+export * from "./definition-package-selection.js";
+export * from "./definition-package-smoke.js";
+export * from "./definition-tuning.js";
+export * from "./definition-tuning-approval.js";
+export * from "./definition-tuning-json.js";
+export * from "./definition-tuning-promotion.js";
+export * from "./definition-tuning-replay.js";
+export * from "./definition-tuning-review.js";
+export * from "./definition-tuning-review-artifact.js";
+export * from "./definition-tuning-source-patch.js";
+export * from "./direct-route-invocation.js";
+export * from "./direct-route-policy.js";
+export * from "./eval-case.js";
+export * from "./eval-replay.js";
+export * from "./eval-result.js";
+export * from "./eval-runner.js";
+export * from "./eval-suite.js";
+export * from "./execution-plan.js";
+export * from "./hosted-tool-policy.js";
+export * from "./memory-policy.js";
+export * from "./memory-updates.js";
+export * from "./outcome.js";
+export * from "./outcome-trace.js";
+export * from "./policy-resolution.js";
+export * from "./planner-compiler.js";
+export * from "./planning.js";
+export * from "./run.js";
+export * from "./run-parity.js";
+export * from "./run-evaluation.js";
+export * from "./run-report.js";
+export * from "./run-report-batch.js";
+export * from "./run-report-json.js";
+export * from "./tool-invocations.js";
+export * from "./tool-provider-executors.js";
+export * from "./tool-result-cache.js";
+export * from "./tool-runtime.js";
+export * from "./tool-selection-evaluation.js";
+export * from "./tool-selection-json.js";
+export * from "./tool-selection-policy.js";
+export * from "./tool-selection-rules.js";
+export * from "./tool-selection-replay.js";
+export * from "./tool-selection-trace-export.js";
+export * from "./tool-results.js";
+export * from "./trace-events.js";
+export * from "./trace-payload.js";
+export * from "./trace-stages.js";
+export * from "./trace-report.js";
+export * from "./trace-replay.js";
+export * from "./tool-bindings.js";
+export * from "./tool-capabilities.js";
+export * from "./tool-executor.js";
+export * from "./tool-fixtures.js";
+export * from "./value-readers.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC","sourcesContent":["export * from \"./clarification-policy.js\";\nexport * from \"./decision.js\";\nexport * from \"./definition.js\";\nexport * from \"./definition-catalog.js\";\nexport * from \"./definition-catalog-replay.js\";\nexport * from \"./definition-diagnostics.js\";\nexport * from \"./definition-diff.js\";\nexport * from \"./definition-json.js\";\nexport * from \"./definition-manifest.js\";\nexport * from \"./definition-package.js\";\nexport * from \"./definition-package-executor.js\";\nexport * from \"./definition-package-execution-json.js\";\nexport * from \"./definition-package-execution-replay.js\";\nexport * from \"./definition-package-loader.js\";\nexport * from \"./definition-package-resolver.js\";\nexport * from \"./definition-package-review.js\";\nexport * from \"./definition-package-replay.js\";\nexport * from \"./definition-package-run.js\";\nexport * from \"./definition-package-run-report.js\";\nexport * from \"./definition-package-selection.js\";\nexport * from \"./definition-package-smoke.js\";\nexport * from \"./definition-tuning.js\";\nexport * from \"./definition-tuning-approval.js\";\nexport * from \"./definition-tuning-json.js\";\nexport * from \"./definition-tuning-promotion.js\";\nexport * from \"./definition-tuning-replay.js\";\nexport * from \"./definition-tuning-review.js\";\nexport * from \"./definition-tuning-review-artifact.js\";\nexport * from \"./definition-tuning-source-patch.js\";\nexport * from \"./direct-route-invocation.js\";\nexport * from \"./direct-route-policy.js\";\nexport * from \"./eval-case.js\";\nexport * from \"./eval-replay.js\";\nexport * from \"./eval-result.js\";\nexport * from \"./eval-runner.js\";\nexport * from \"./eval-suite.js\";\nexport * from \"./execution-plan.js\";\nexport * from \"./hosted-tool-policy.js\";\nexport * from \"./memory-policy.js\";\nexport * from \"./memory-updates.js\";\nexport * from \"./outcome.js\";\nexport * from \"./outcome-trace.js\";\nexport * from \"./policy-resolution.js\";\nexport * from \"./planner-compiler.js\";\nexport * from \"./planning.js\";\nexport * from \"./run.js\";\nexport * from \"./run-parity.js\";\nexport * from \"./run-evaluation.js\";\nexport * from \"./run-report.js\";\nexport * from \"./run-report-batch.js\";\nexport * from \"./run-report-json.js\";\nexport * from \"./tool-invocations.js\";\nexport * from \"./tool-provider-executors.js\";\nexport * from \"./tool-result-cache.js\";\nexport * from \"./tool-runtime.js\";\nexport * from \"./tool-selection-evaluation.js\";\nexport * from \"./tool-selection-json.js\";\nexport * from \"./tool-selection-policy.js\";\nexport * from \"./tool-selection-rules.js\";\nexport * from \"./tool-selection-replay.js\";\nexport * from \"./tool-selection-trace-export.js\";\nexport * from \"./tool-results.js\";\nexport * from \"./trace-events.js\";\nexport * from \"./trace-payload.js\";\nexport * from \"./trace-stages.js\";\nexport * from \"./trace-report.js\";\nexport * from \"./trace-replay.js\";\nexport * from \"./tool-bindings.js\";\nexport * from \"./tool-capabilities.js\";\nexport * from \"./tool-executor.js\";\nexport * from \"./tool-fixtures.js\";\nexport * from \"./value-readers.js\";\n"]}

package/dist/memory-policy.d.ts

@@ -0,0 +1,55 @@
+import { type AssistantWorkflowDefinition, type AssistantWorkflowMemoryOperation, type AssistantWorkflowMemorySlotDefinition } from "./definition.js";
+import { type AssistantWorkflowMemoryPatch, type AssistantWorkflowMemoryPatchResult, type AssistantWorkflowMemorySnapshot, type AssistantWorkflowMemoryValue } from "./memory-updates.js";
+export type AssistantWorkflowResolvedMemoryPolicy = {
+    readSlots: string[];
+    writeSlots: string[];
+    injectSlots: string[];
+    missingMemorySlots: string[];
+    operationsBySlot: Record<string, AssistantWorkflowMemoryOperation[]>;
+};
+export type AssistantWorkflowMemoryInjectionEntry = {
+    slotId: string;
+    storage: string;
+    profileField: string | null;
+    value: AssistantWorkflowMemoryValue;
+    serializedValue: string;
+    charCount: number;
+    truncated: boolean;
+    maxChars: number | null;
+};
+export type AssistantWorkflowSkippedMemoryInjection = {
+    slotId: string;
+    reason: "missing-value" | "total-char-budget-exceeded";
+};
+export type AssistantWorkflowMemoryInjectionPlan = {
+    entries: AssistantWorkflowMemoryInjectionEntry[];
+    serializedValues: Record<string, string>;
+    injectedSlots: string[];
+    missingSnapshotSlots: string[];
+    skippedSlots: AssistantWorkflowSkippedMemoryInjection[];
+    totalChars: number;
+};
+export type AssistantWorkflowMemoryInjectionPlanInput = {
+    workflow: AssistantWorkflowDefinition<string, string, string, string>;
+    policy: AssistantWorkflowResolvedMemoryPolicy;
+    snapshot?: AssistantWorkflowMemorySnapshot | null;
+    maxTotalChars?: number;
+};
+export type AssistantWorkflowIntentMemoryPatchInput = {
+    workflow: AssistantWorkflowDefinition<string, string, string, string>;
+    intentId: unknown;
+    snapshot?: AssistantWorkflowMemorySnapshot | null;
+    patches: readonly AssistantWorkflowMemoryPatch[];
+};
+export type AssistantWorkflowIntentMemoryPatchResult = {
+    intentId: string | null;
+    policy: AssistantWorkflowResolvedMemoryPolicy;
+    memoryResult: AssistantWorkflowMemoryPatchResult;
+};
+export declare function findAssistantWorkflowMemorySlot(workflow: AssistantWorkflowDefinition<string, string, string, string>, slotId: unknown): AssistantWorkflowMemorySlotDefinition | null;
+export declare function buildAssistantWorkflowMemoryPolicy(workflow: AssistantWorkflowDefinition<string, string, string, string>, intentId: unknown): AssistantWorkflowResolvedMemoryPolicy;
+export declare function buildAssistantWorkflowMemoryInjectionPlan(input: AssistantWorkflowMemoryInjectionPlanInput): AssistantWorkflowMemoryInjectionPlan;
+export declare function buildAssistantWorkflowMemoryInjectionTracePayload(plan: AssistantWorkflowMemoryInjectionPlan): Record<string, unknown>;
+export declare function applyAssistantWorkflowIntentMemoryPatches(input: AssistantWorkflowIntentMemoryPatchInput): AssistantWorkflowIntentMemoryPatchResult;
+export declare function buildAssistantWorkflowIntentMemoryPatchTracePayload(result: AssistantWorkflowIntentMemoryPatchResult): Record<string, unknown>;
+//# sourceMappingURL=memory-policy.d.ts.map

package/dist/memory-policy.d.ts.map

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