@uns-kit/assistant-workflow 2.0.72

package/dist/tool-selection-trace-export.js

@@ -0,0 +1,324 @@
+import { readAssistantWorkflowTraceBoolean as readBoolean, readAssistantWorkflowTraceNumber as readNumber, readAssistantWorkflowTracePayloadRecord as readRecord, readAssistantWorkflowTraceString as readString, readAssistantWorkflowTraceStringArray as readStringArray, readAssistantWorkflowTraceUserMessagePreview, } from "./trace-events.js";
+import { ASSISTANT_WORKFLOW_TRACE_STAGE } from "./trace-stages.js";
+import { buildAssistantWorkflowToolSelectionDecision, } from "./tool-selection-policy.js";
+import { buildAssistantWorkflowEvalCaseFromSerializedToolSelectionDecision, } from "./eval-case.js";
+import { parseAssistantWorkflowSerializedToolSelectionDecision, serializeAssistantWorkflowToolSelectionDecision, } from "./tool-selection-json.js";
+export function buildAssistantWorkflowSerializedToolSelectionDecisionFromTraceEvent(event) {
+    if (event.stage !== ASSISTANT_WORKFLOW_TRACE_STAGE.toolSelectionWorkflowComparison)
+        return null;
+    const payload = readRecord(event.payload);
+    if (!payload)
+        return null;
+    const authority = readRecord(payload["authority"]);
+    const inferredWorkflowAuthorityReason = authority
+        ? null
+        : inferWorkflowAuthorityReason(payload);
+    const selectedToolNames = authority
+        ? readStringArray(authority["selectedToolNames"])
+        : inferredWorkflowAuthorityReason
+            ? inferWorkflowAuthoritySelectedToolNames(payload)
+            : inferSelectedToolNames(payload);
+    const workflowSuggestedToolNames = authority
+        ? readStringArray(authority["workflowSuggestedToolNames"])
+        : readStringArray(payload["workflowSuggestedTools"]);
+    const comparisonPayload = toJsonRecordOrNull(payload);
+    if (!comparisonPayload)
+        return null;
+    return parseAssistantWorkflowSerializedToolSelectionDecision({
+        schemaVersion: 1,
+        authority: {
+            source: authority?.["source"] ?? (inferredWorkflowAuthorityReason ? "workflow" : "legacy-pruner"),
+            reason: authority?.["reason"] ?? inferredWorkflowAuthorityReason ??
+                inferLegacyAuthorityReason(payload, selectedToolNames),
+            selectedToolNames,
+            workflowSuggestedToolNames: workflowSuggestedToolNames.length
+                ? workflowSuggestedToolNames
+                : readStringArray(payload["workflowSuggestedTools"]),
+            workflowStatus: typeof authority?.["workflowStatus"] === "string"
+                ? authority["workflowStatus"]
+                : readWorkflowStatus(payload),
+        },
+        effectiveToolNames: readStringArray(payload["effectiveToolNames"]).length
+            ? readStringArray(payload["effectiveToolNames"])
+            : selectedToolNames,
+        effectiveReason: typeof payload["selectedReason"] === "string" ? payload["selectedReason"] : null,
+        comparisonPayload,
+    });
+}
+export function buildAssistantWorkflowSerializedToolSelectionDecisionsFromTraceEvents(events) {
+    const decisions = [];
+    let candidateEventCount = 0;
+    let skippedCandidateEventCount = 0;
+    for (const event of events) {
+        if (event.stage !== ASSISTANT_WORKFLOW_TRACE_STAGE.toolSelectionWorkflowComparison)
+            continue;
+        candidateEventCount += 1;
+        const decision = buildAssistantWorkflowSerializedToolSelectionDecisionFromTraceEvent(event);
+        if (decision) {
+            decisions.push(decision);
+        }
+        else {
+            skippedCandidateEventCount += 1;
+        }
+    }
+    return {
+        traceEventCount: events.length,
+        candidateEventCount,
+        decisionCount: decisions.length,
+        skippedCandidateEventCount,
+        decisions,
+    };
+}
+export function buildAssistantWorkflowCurrentSerializedToolSelectionDecisionsFromTraceEvents(events, options) {
+    const decisions = [];
+    let candidateEventCount = 0;
+    let skippedCandidateEventCount = 0;
+    let latestClassifierPayload = null;
+    for (const event of events) {
+        if (event.stage === ASSISTANT_WORKFLOW_TRACE_STAGE.plannerClassifierDone) {
+            latestClassifierPayload = readRecord(event.payload);
+            continue;
+        }
+        if (event.stage !== ASSISTANT_WORKFLOW_TRACE_STAGE.toolSelectionWorkflowComparison)
+            continue;
+        candidateEventCount += 1;
+        const decision = buildAssistantWorkflowCurrentSerializedToolSelectionDecisionFromTraceEvent(event, latestClassifierPayload, options);
+        if (decision) {
+            decisions.push(decision);
+        }
+        else {
+            skippedCandidateEventCount += 1;
+        }
+    }
+    return {
+        traceEventCount: events.length,
+        candidateEventCount,
+        decisionCount: decisions.length,
+        skippedCandidateEventCount,
+        decisions,
+    };
+}
+export function buildAssistantWorkflowCurrentSerializedToolSelectionDecisionFromTraceEvent(event, classifierPayload, options) {
+    const payload = readRecord(event.payload);
+    if (!payload)
+        return null;
+    const historicalDecision = buildAssistantWorkflowSerializedToolSelectionDecisionFromTraceEvent(event);
+    if (!historicalDecision)
+        return null;
+    const selectedToolNames = historicalDecision.authority.selectedToolNames;
+    const availableToolNames = buildCurrentReplayAvailableToolNames(options, selectedToolNames, historicalDecision.authority.workflowSuggestedToolNames, payload, classifierPayload);
+    const currentDecision = buildAssistantWorkflowToolSelectionDecision({
+        workflow: options.workflow,
+        classification: {
+            intent: readString(classifierPayload?.["intent"]) ?? readString(payload["intent"]),
+            presentation: readString(classifierPayload?.["presentation"]) ??
+                readString(payload["effectivePresentation"]) ??
+                readString(payload["defaultPresentation"]),
+            toolsToExpose: firstNonEmptyStringArray(classifierPayload?.["tools"], classifierPayload?.["toolsToExpose"], payload["classifierTools"]),
+            ...(typeof classifierPayload?.["confidence"] === "number"
+                ? { confidence: classifierPayload["confidence"] }
+                : {}),
+            ...(readString(classifierPayload?.["timeWindowHint"])
+                ? { timeWindowHint: readString(classifierPayload?.["timeWindowHint"]) }
+                : {}),
+            entities: {
+                containers: firstNonEmptyStringArray(classifierPayload?.["containers"], payload["containers"]),
+                attributes: firstNonEmptyStringArray(classifierPayload?.["attributes"], payload["attributes"]),
+                fullTopicPaths: firstNonEmptyStringArray(classifierPayload?.["fullTopicPaths"], payload["fullTopicPaths"]),
+            },
+        },
+        availableToolNames,
+        selectedToolNames,
+        selectedMode: readString(payload["selectedMode"]),
+        selectedReason: readString(payload["selectedReason"]),
+        hop: readNumber(payload["hop"]),
+        pruningEnabled: readBoolean(payload["pruningEnabled"]),
+        availableContext: options.availableContext ?? null,
+        workflowAuthorityIntentIds: options.workflowAuthorityIntentIds ?? null,
+        workflowAuthoritySegmentKeys: options.workflowAuthoritySegmentKeys ?? null,
+    });
+    return serializeAssistantWorkflowToolSelectionDecision(currentDecision);
+}
+export function buildAssistantWorkflowToolSelectionEvalCasesFromTraceEvents(events, options = {}) {
+    const exportResult = buildAssistantWorkflowSerializedToolSelectionDecisionsFromTraceEvents(events);
+    const prompt = normalizeOptionalString(options.prompt) ?? readPromptPreview(events);
+    const cases = prompt
+        ? exportResult.decisions.map((decision, index) => buildAssistantWorkflowEvalCaseFromSerializedToolSelectionDecision(decision, {
+            prompt,
+            ...(options.id !== undefined && exportResult.decisions.length === 1 ? { id: options.id } : {}),
+            ...(options.required !== undefined ? { required: options.required } : {}),
+            ...(options.tags !== undefined ? { tags: options.tags } : {}),
+            ...(options.source !== undefined ? { source: options.source } : {}),
+            ...(options.notes !== undefined ? { notes: options.notes } : {}),
+            metadata: {
+                ...(options.metadata ?? {}),
+                traceDecisionIndex: index,
+            },
+        }))
+        : [];
+    return {
+        ...exportResult,
+        prompt,
+        evalCaseCount: cases.length,
+        missingPromptCount: prompt ? 0 : exportResult.decisionCount,
+        cases,
+    };
+}
+export function buildAssistantWorkflowToolSelectionTraceExportPayload(result) {
+    return {
+        traceEventCount: result.traceEventCount,
+        candidateEventCount: result.candidateEventCount,
+        decisionCount: result.decisionCount,
+        skippedCandidateEventCount: result.skippedCandidateEventCount,
+    };
+}
+export function buildAssistantWorkflowToolSelectionTraceEvalCaseExportPayload(result) {
+    return {
+        ...buildAssistantWorkflowToolSelectionTraceExportPayload(result),
+        prompt: result.prompt,
+        evalCaseCount: result.evalCaseCount,
+        missingPromptCount: result.missingPromptCount,
+    };
+}
+function firstNonEmptyStringArray(...values) {
+    for (const value of values) {
+        const strings = readStringArray(value);
+        if (strings.length > 0)
+            return strings;
+    }
+    return [];
+}
+function buildCurrentReplayAvailableToolNames(options, selectedToolNames, workflowSuggestedToolNames, payload, classifierPayload) {
+    if (options.availableToolNames !== undefined && options.availableToolNames !== null) {
+        return uniqueStrings(readStringArray(options.availableToolNames));
+    }
+    return uniqueStrings([
+        ...selectedToolNames,
+        ...workflowSuggestedToolNames,
+        ...(options.includeWorkflowToolCapabilities === false
+            ? []
+            : (options.workflow.tools ?? []).map((tool) => tool.name)),
+        ...readStringArray(payload["workflowSuggestedTools"]),
+        ...readStringArray(payload["toolHints"]),
+        ...readStringArray(payload["requiredToolHints"]),
+        ...readStringArray(payload["classifierTools"]),
+        ...readStringArray(classifierPayload?.["tools"]),
+        ...readStringArray(classifierPayload?.["toolsToExpose"]),
+    ]);
+}
+function readPromptPreview(events) {
+    for (const event of events) {
+        const payload = readRecord(event.payload);
+        if (!payload)
+            continue;
+        const candidate = readAssistantWorkflowTraceUserMessagePreview(event.stage, payload);
+        if (candidate)
+            return candidate;
+    }
+    return null;
+}
+function inferSelectedToolNames(payload) {
+    const explicit = readStringArray(payload["effectiveToolNames"]);
+    if (explicit.length)
+        return explicit;
+    const selected = readStringArray(payload["selectedToolNames"]);
+    if (selected.length)
+        return selected;
+    const candidateTools = readStringArray(payload["workflowSelectionCandidateTools"]);
+    const workflowSuggestedTools = readStringArray(payload["workflowSuggestedTools"]);
+    const comparableTools = candidateTools.length ? candidateTools : workflowSuggestedTools;
+    const missingTools = candidateTools.length
+        ? readStringArray(payload["missingWorkflowSelectionCandidateTools"])
+        : readStringArray(payload["missingWorkflowSuggestedTools"]);
+    const outsideTools = candidateTools.length
+        ? readStringArray(payload["selectedOutsideWorkflowSelectionCandidate"])
+        : readStringArray(payload["selectedOutsideWorkflowSuggestions"]);
+    const missingSet = new Set(missingTools);
+    return uniqueStrings([
+        ...comparableTools.filter((toolName) => !missingSet.has(toolName)),
+        ...outsideTools,
+    ]);
+}
+function inferWorkflowAuthoritySelectedToolNames(payload) {
+    const explicit = readStringArray(payload["effectiveToolNames"]);
+    if (explicit.length)
+        return explicit;
+    const selected = readStringArray(payload["selectedToolNames"]);
+    if (selected.length)
+        return selected;
+    const candidateTools = readStringArray(payload["workflowSelectionCandidateTools"]);
+    if (candidateTools.length)
+        return candidateTools;
+    return readStringArray(payload["workflowSuggestedTools"]);
+}
+function inferWorkflowAuthorityReason(payload) {
+    const selectedReason = readString(payload["selectedReason"]);
+    return selectedReason === "workflow_equivalent" || selectedReason === "workflow_authority_enabled"
+        ? selectedReason
+        : null;
+}
+function inferLegacyAuthorityReason(payload, selectedToolNames) {
+    const workflowStatus = readWorkflowStatus(payload);
+    if (workflowStatus === "blocked" || workflowStatus === "needs-clarification") {
+        return "workflow_blocked";
+    }
+    const hasWorkflowTools = readStringArray(payload["workflowSelectionCandidateTools"]).length > 0 ||
+        readStringArray(payload["workflowSuggestedTools"]).length > 0;
+    const hasDiffSignals = readStringArray(payload["missingWorkflowSelectionCandidateTools"]).length > 0 ||
+        readStringArray(payload["missingWorkflowSuggestedTools"]).length > 0 ||
+        readStringArray(payload["selectedOutsideWorkflowSelectionCandidate"]).length > 0 ||
+        readStringArray(payload["selectedOutsideWorkflowSuggestions"]).length > 0;
+    return hasWorkflowTools || selectedToolNames.length > 0 || hasDiffSignals
+        ? "workflow_differs"
+        : "workflow_unavailable";
+}
+function readWorkflowStatus(payload) {
+    const workflowRun = readRecord(payload["workflowRun"]);
+    if (typeof workflowRun?.["status"] === "string")
+        return workflowRun["status"];
+    const executionPlan = readRecord(payload["executionPlan"]);
+    if (typeof executionPlan?.["status"] === "string")
+        return executionPlan["status"];
+    return null;
+}
+function uniqueStrings(values) {
+    const out = [];
+    const seen = new Set();
+    for (const value of values) {
+        const trimmed = value.trim();
+        if (!trimmed.length || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    return out;
+}
+function normalizeOptionalString(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length ? trimmed : null;
+}
+function toJsonRecordOrNull(value) {
+    if (!isJsonRecord(value))
+        return null;
+    return value;
+}
+function isJsonRecord(value) {
+    const record = readRecord(value);
+    if (!record)
+        return false;
+    return Object.values(record).every(isJsonValue);
+}
+function isJsonValue(value) {
+    if (value === null)
+        return true;
+    if (typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(isJsonValue);
+    return isJsonRecord(value);
+}
+//# sourceMappingURL=tool-selection-trace-export.js.map

package/dist/tool-selection-trace-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-selection-trace-export.js","sourceRoot":"","sources":["../src/tool-selection-trace-export.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantWorkflowJsonValue } from \"./run-report-json.js\";\nimport {\n  readAssistantWorkflowTraceBoolean as readBoolean,\n  readAssistantWorkflowTraceNumber as readNumber,\n  readAssistantWorkflowTracePayloadRecord as readRecord,\n  readAssistantWorkflowTraceString as readString,\n  readAssistantWorkflowTraceStringArray as readStringArray,\n  readAssistantWorkflowTraceUserMessagePreview,\n  type AssistantWorkflowTraceEvent,\n} from \"./trace-events.js\";\nimport { ASSISTANT_WORKFLOW_TRACE_STAGE } from \"./trace-stages.js\";\nimport type {\n  AssistantWorkflowDefinition,\n  AssistantWorkflowToolContextRequirement,\n} from \"./definition.js\";\nimport {\n  buildAssistantWorkflowToolSelectionDecision,\n} from \"./tool-selection-policy.js\";\nimport {\n  buildAssistantWorkflowEvalCaseFromSerializedToolSelectionDecision,\n  type AssistantWorkflowEvalCase,\n  type AssistantWorkflowToolSelectionEvalCaseOptions,\n} from \"./eval-case.js\";\nimport {\n  parseAssistantWorkflowSerializedToolSelectionDecision,\n  serializeAssistantWorkflowToolSelectionDecision,\n  type AssistantWorkflowSerializedToolSelectionDecision,\n} from \"./tool-selection-json.js\";\n\nexport type AssistantWorkflowToolSelectionTraceExportResult = {\n  traceEventCount: number;\n  candidateEventCount: number;\n  decisionCount: number;\n  skippedCandidateEventCount: number;\n  decisions: AssistantWorkflowSerializedToolSelectionDecision[];\n};\n\nexport type AssistantWorkflowToolSelectionTraceEvalCaseOptions =\n  Omit<AssistantWorkflowToolSelectionEvalCaseOptions, \"prompt\"> & {\n    prompt?: string | null;\n  };\n\nexport type AssistantWorkflowToolSelectionTraceEvalCaseExportResult =\n  AssistantWorkflowToolSelectionTraceExportResult & {\n    prompt: string | null;\n    evalCaseCount: number;\n    missingPromptCount: number;\n    cases: AssistantWorkflowEvalCase[];\n  };\n\nexport type AssistantWorkflowToolSelectionTraceCurrentReplayOptions = {\n  workflow: AssistantWorkflowDefinition<string, string, string, string>;\n  availableToolNames?: readonly string[] | null;\n  availableContext?: readonly AssistantWorkflowToolContextRequirement[] | null;\n  workflowAuthorityIntentIds?: readonly string[] | null;\n  workflowAuthoritySegmentKeys?: readonly string[] | null;\n  includeWorkflowToolCapabilities?: boolean;\n};\n\nexport function buildAssistantWorkflowSerializedToolSelectionDecisionFromTraceEvent(\n  event: AssistantWorkflowTraceEvent,\n): AssistantWorkflowSerializedToolSelectionDecision | null {\n  if (event.stage !== ASSISTANT_WORKFLOW_TRACE_STAGE.toolSelectionWorkflowComparison) return null;\n  const payload = readRecord(event.payload);\n  if (!payload) return null;\n  const authority = readRecord(payload[\"authority\"]);\n  const inferredWorkflowAuthorityReason = authority\n    ? null\n    : inferWorkflowAuthorityReason(payload);\n  const selectedToolNames = authority\n    ? readStringArray(authority[\"selectedToolNames\"])\n    : inferredWorkflowAuthorityReason\n      ? inferWorkflowAuthoritySelectedToolNames(payload)\n    : inferSelectedToolNames(payload);\n  const workflowSuggestedToolNames = authority\n    ? readStringArray(authority[\"workflowSuggestedToolNames\"])\n    : readStringArray(payload[\"workflowSuggestedTools\"]);\n  const comparisonPayload = toJsonRecordOrNull(payload);\n  if (!comparisonPayload) return null;\n\n  return parseAssistantWorkflowSerializedToolSelectionDecision({\n    schemaVersion: 1,\n    authority: {\n      source: authority?.[\"source\"] ?? (inferredWorkflowAuthorityReason ? \"workflow\" : \"legacy-pruner\"),\n      reason: authority?.[\"reason\"] ?? inferredWorkflowAuthorityReason ??\n        inferLegacyAuthorityReason(payload, selectedToolNames),\n      selectedToolNames,\n      workflowSuggestedToolNames: workflowSuggestedToolNames.length\n        ? workflowSuggestedToolNames\n        : readStringArray(payload[\"workflowSuggestedTools\"]),\n      workflowStatus: typeof authority?.[\"workflowStatus\"] === \"string\"\n        ? authority[\"workflowStatus\"]\n        : readWorkflowStatus(payload),\n    },\n    effectiveToolNames: readStringArray(payload[\"effectiveToolNames\"]).length\n      ? readStringArray(payload[\"effectiveToolNames\"])\n      : selectedToolNames,\n    effectiveReason: typeof payload[\"selectedReason\"] === \"string\" ? payload[\"selectedReason\"] : null,\n    comparisonPayload,\n  });\n}\n\nexport function buildAssistantWorkflowSerializedToolSelectionDecisionsFromTraceEvents(\n  events: readonly AssistantWorkflowTraceEvent[],\n): AssistantWorkflowToolSelectionTraceExportResult {\n  const decisions: AssistantWorkflowSerializedToolSelectionDecision[] = [];\n  let candidateEventCount = 0;\n  let skippedCandidateEventCount = 0;\n\n  for (const event of events) {\n    if (event.stage !== ASSISTANT_WORKFLOW_TRACE_STAGE.toolSelectionWorkflowComparison) continue;\n    candidateEventCount += 1;\n    const decision = buildAssistantWorkflowSerializedToolSelectionDecisionFromTraceEvent(event);\n    if (decision) {\n      decisions.push(decision);\n    } else {\n      skippedCandidateEventCount += 1;\n    }\n  }\n\n  return {\n    traceEventCount: events.length,\n    candidateEventCount,\n    decisionCount: decisions.length,\n    skippedCandidateEventCount,\n    decisions,\n  };\n}\n\nexport function buildAssistantWorkflowCurrentSerializedToolSelectionDecisionsFromTraceEvents(\n  events: readonly AssistantWorkflowTraceEvent[],\n  options: AssistantWorkflowToolSelectionTraceCurrentReplayOptions,\n): AssistantWorkflowToolSelectionTraceExportResult {\n  const decisions: AssistantWorkflowSerializedToolSelectionDecision[] = [];\n  let candidateEventCount = 0;\n  let skippedCandidateEventCount = 0;\n  let latestClassifierPayload: Record<string, unknown> | null = null;\n\n  for (const event of events) {\n    if (event.stage === ASSISTANT_WORKFLOW_TRACE_STAGE.plannerClassifierDone) {\n      latestClassifierPayload = readRecord(event.payload);\n      continue;\n    }\n    if (event.stage !== ASSISTANT_WORKFLOW_TRACE_STAGE.toolSelectionWorkflowComparison) continue;\n\n    candidateEventCount += 1;\n    const decision = buildAssistantWorkflowCurrentSerializedToolSelectionDecisionFromTraceEvent(\n      event,\n      latestClassifierPayload,\n      options,\n    );\n    if (decision) {\n      decisions.push(decision);\n    } else {\n      skippedCandidateEventCount += 1;\n    }\n  }\n\n  return {\n    traceEventCount: events.length,\n    candidateEventCount,\n    decisionCount: decisions.length,\n    skippedCandidateEventCount,\n    decisions,\n  };\n}\n\nexport function buildAssistantWorkflowCurrentSerializedToolSelectionDecisionFromTraceEvent(\n  event: AssistantWorkflowTraceEvent,\n  classifierPayload: Record<string, unknown> | null,\n  options: AssistantWorkflowToolSelectionTraceCurrentReplayOptions,\n): AssistantWorkflowSerializedToolSelectionDecision | null {\n  const payload = readRecord(event.payload);\n  if (!payload) return null;\n  const historicalDecision = buildAssistantWorkflowSerializedToolSelectionDecisionFromTraceEvent(event);\n  if (!historicalDecision) return null;\n  const selectedToolNames = historicalDecision.authority.selectedToolNames;\n  const availableToolNames = buildCurrentReplayAvailableToolNames(\n    options,\n    selectedToolNames,\n    historicalDecision.authority.workflowSuggestedToolNames,\n    payload,\n    classifierPayload,\n  );\n  const currentDecision = buildAssistantWorkflowToolSelectionDecision({\n    workflow: options.workflow,\n    classification: {\n      intent: readString(classifierPayload?.[\"intent\"]) ?? readString(payload[\"intent\"]),\n      presentation:\n        readString(classifierPayload?.[\"presentation\"]) ??\n        readString(payload[\"effectivePresentation\"]) ??\n        readString(payload[\"defaultPresentation\"]),\n      toolsToExpose: firstNonEmptyStringArray(\n        classifierPayload?.[\"tools\"],\n        classifierPayload?.[\"toolsToExpose\"],\n        payload[\"classifierTools\"],\n      ),\n      ...(typeof classifierPayload?.[\"confidence\"] === \"number\"\n        ? { confidence: classifierPayload[\"confidence\"] }\n        : {}),\n      ...(readString(classifierPayload?.[\"timeWindowHint\"])\n        ? { timeWindowHint: readString(classifierPayload?.[\"timeWindowHint\"]) }\n        : {}),\n      entities: {\n        containers: firstNonEmptyStringArray(classifierPayload?.[\"containers\"], payload[\"containers\"]),\n        attributes: firstNonEmptyStringArray(classifierPayload?.[\"attributes\"], payload[\"attributes\"]),\n        fullTopicPaths: firstNonEmptyStringArray(classifierPayload?.[\"fullTopicPaths\"], payload[\"fullTopicPaths\"]),\n      },\n    },\n    availableToolNames,\n    selectedToolNames,\n    selectedMode: readString(payload[\"selectedMode\"]),\n    selectedReason: readString(payload[\"selectedReason\"]),\n    hop: readNumber(payload[\"hop\"]),\n    pruningEnabled: readBoolean(payload[\"pruningEnabled\"]),\n    availableContext: options.availableContext ?? null,\n    workflowAuthorityIntentIds: options.workflowAuthorityIntentIds ?? null,\n    workflowAuthoritySegmentKeys: options.workflowAuthoritySegmentKeys ?? null,\n  });\n\n  return serializeAssistantWorkflowToolSelectionDecision(currentDecision);\n}\n\nexport function buildAssistantWorkflowToolSelectionEvalCasesFromTraceEvents(\n  events: readonly AssistantWorkflowTraceEvent[],\n  options: AssistantWorkflowToolSelectionTraceEvalCaseOptions = {},\n): AssistantWorkflowToolSelectionTraceEvalCaseExportResult {\n  const exportResult = buildAssistantWorkflowSerializedToolSelectionDecisionsFromTraceEvents(events);\n  const prompt = normalizeOptionalString(options.prompt) ?? readPromptPreview(events);\n  const cases = prompt\n    ? exportResult.decisions.map((decision, index) =>\n        buildAssistantWorkflowEvalCaseFromSerializedToolSelectionDecision(decision, {\n          prompt,\n          ...(options.id !== undefined && exportResult.decisions.length === 1 ? { id: options.id } : {}),\n          ...(options.required !== undefined ? { required: options.required } : {}),\n          ...(options.tags !== undefined ? { tags: options.tags } : {}),\n          ...(options.source !== undefined ? { source: options.source } : {}),\n          ...(options.notes !== undefined ? { notes: options.notes } : {}),\n          metadata: {\n            ...(options.metadata ?? {}),\n            traceDecisionIndex: index,\n          },\n        })\n      )\n    : [];\n\n  return {\n    ...exportResult,\n    prompt,\n    evalCaseCount: cases.length,\n    missingPromptCount: prompt ? 0 : exportResult.decisionCount,\n    cases,\n  };\n}\n\nexport function buildAssistantWorkflowToolSelectionTraceExportPayload(\n  result: AssistantWorkflowToolSelectionTraceExportResult,\n): Record<string, AssistantWorkflowJsonValue> {\n  return {\n    traceEventCount: result.traceEventCount,\n    candidateEventCount: result.candidateEventCount,\n    decisionCount: result.decisionCount,\n    skippedCandidateEventCount: result.skippedCandidateEventCount,\n  };\n}\n\nexport function buildAssistantWorkflowToolSelectionTraceEvalCaseExportPayload(\n  result: AssistantWorkflowToolSelectionTraceEvalCaseExportResult,\n): Record<string, AssistantWorkflowJsonValue> {\n  return {\n    ...buildAssistantWorkflowToolSelectionTraceExportPayload(result),\n    prompt: result.prompt,\n    evalCaseCount: result.evalCaseCount,\n    missingPromptCount: result.missingPromptCount,\n  };\n}\n\nfunction firstNonEmptyStringArray(...values: unknown[]): string[] {\n  for (const value of values) {\n    const strings = readStringArray(value);\n    if (strings.length > 0) return strings;\n  }\n  return [];\n}\n\nfunction buildCurrentReplayAvailableToolNames(\n  options: AssistantWorkflowToolSelectionTraceCurrentReplayOptions,\n  selectedToolNames: readonly string[],\n  workflowSuggestedToolNames: readonly string[],\n  payload: Record<string, unknown>,\n  classifierPayload: Record<string, unknown> | null,\n): string[] {\n  if (options.availableToolNames !== undefined && options.availableToolNames !== null) {\n    return uniqueStrings(readStringArray(options.availableToolNames));\n  }\n  return uniqueStrings([\n    ...selectedToolNames,\n    ...workflowSuggestedToolNames,\n    ...(options.includeWorkflowToolCapabilities === false\n      ? []\n      : (options.workflow.tools ?? []).map((tool) => tool.name)),\n    ...readStringArray(payload[\"workflowSuggestedTools\"]),\n    ...readStringArray(payload[\"toolHints\"]),\n    ...readStringArray(payload[\"requiredToolHints\"]),\n    ...readStringArray(payload[\"classifierTools\"]),\n    ...readStringArray(classifierPayload?.[\"tools\"]),\n    ...readStringArray(classifierPayload?.[\"toolsToExpose\"]),\n  ]);\n}\n\nfunction readPromptPreview(events: readonly AssistantWorkflowTraceEvent[]): string | null {\n  for (const event of events) {\n    const payload = readRecord(event.payload);\n    if (!payload) continue;\n    const candidate = readAssistantWorkflowTraceUserMessagePreview(event.stage, payload);\n    if (candidate) return candidate;\n  }\n  return null;\n}\n\nfunction inferSelectedToolNames(payload: Record<string, unknown>): string[] {\n  const explicit = readStringArray(payload[\"effectiveToolNames\"]);\n  if (explicit.length) return explicit;\n  const selected = readStringArray(payload[\"selectedToolNames\"]);\n  if (selected.length) return selected;\n\n  const candidateTools = readStringArray(payload[\"workflowSelectionCandidateTools\"]);\n  const workflowSuggestedTools = readStringArray(payload[\"workflowSuggestedTools\"]);\n  const comparableTools = candidateTools.length ? candidateTools : workflowSuggestedTools;\n  const missingTools = candidateTools.length\n    ? readStringArray(payload[\"missingWorkflowSelectionCandidateTools\"])\n    : readStringArray(payload[\"missingWorkflowSuggestedTools\"]);\n  const outsideTools = candidateTools.length\n    ? readStringArray(payload[\"selectedOutsideWorkflowSelectionCandidate\"])\n    : readStringArray(payload[\"selectedOutsideWorkflowSuggestions\"]);\n  const missingSet = new Set(missingTools);\n  return uniqueStrings([\n    ...comparableTools.filter((toolName) => !missingSet.has(toolName)),\n    ...outsideTools,\n  ]);\n}\n\nfunction inferWorkflowAuthoritySelectedToolNames(payload: Record<string, unknown>): string[] {\n  const explicit = readStringArray(payload[\"effectiveToolNames\"]);\n  if (explicit.length) return explicit;\n  const selected = readStringArray(payload[\"selectedToolNames\"]);\n  if (selected.length) return selected;\n  const candidateTools = readStringArray(payload[\"workflowSelectionCandidateTools\"]);\n  if (candidateTools.length) return candidateTools;\n  return readStringArray(payload[\"workflowSuggestedTools\"]);\n}\n\nfunction inferWorkflowAuthorityReason(payload: Record<string, unknown>): string | null {\n  const selectedReason = readString(payload[\"selectedReason\"]);\n  return selectedReason === \"workflow_equivalent\" || selectedReason === \"workflow_authority_enabled\"\n    ? selectedReason\n    : null;\n}\n\nfunction inferLegacyAuthorityReason(\n  payload: Record<string, unknown>,\n  selectedToolNames: readonly string[],\n): string {\n  const workflowStatus = readWorkflowStatus(payload);\n  if (workflowStatus === \"blocked\" || workflowStatus === \"needs-clarification\") {\n    return \"workflow_blocked\";\n  }\n  const hasWorkflowTools = readStringArray(payload[\"workflowSelectionCandidateTools\"]).length > 0 ||\n    readStringArray(payload[\"workflowSuggestedTools\"]).length > 0;\n  const hasDiffSignals = readStringArray(payload[\"missingWorkflowSelectionCandidateTools\"]).length > 0 ||\n    readStringArray(payload[\"missingWorkflowSuggestedTools\"]).length > 0 ||\n    readStringArray(payload[\"selectedOutsideWorkflowSelectionCandidate\"]).length > 0 ||\n    readStringArray(payload[\"selectedOutsideWorkflowSuggestions\"]).length > 0;\n  return hasWorkflowTools || selectedToolNames.length > 0 || hasDiffSignals\n    ? \"workflow_differs\"\n    : \"workflow_unavailable\";\n}\n\nfunction readWorkflowStatus(payload: Record<string, unknown>): string | null {\n  const workflowRun = readRecord(payload[\"workflowRun\"]);\n  if (typeof workflowRun?.[\"status\"] === \"string\") return workflowRun[\"status\"];\n  const executionPlan = readRecord(payload[\"executionPlan\"]);\n  if (typeof executionPlan?.[\"status\"] === \"string\") return executionPlan[\"status\"];\n  return null;\n}\n\nfunction uniqueStrings(values: readonly string[]): string[] {\n  const out: string[] = [];\n  const seen = new Set<string>();\n  for (const value of values) {\n    const trimmed = value.trim();\n    if (!trimmed.length || seen.has(trimmed)) continue;\n    seen.add(trimmed);\n    out.push(trimmed);\n  }\n  return out;\n}\n\nfunction normalizeOptionalString(value: string | null | undefined): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  return trimmed.length ? trimmed : null;\n}\n\nfunction toJsonRecordOrNull(value: unknown): Record<string, AssistantWorkflowJsonValue> | null {\n  if (!isJsonRecord(value)) return null;\n  return value;\n}\n\nfunction isJsonRecord(value: unknown): value is Record<string, AssistantWorkflowJsonValue> {\n  const record = readRecord(value);\n  if (!record) return false;\n  return Object.values(record).every(isJsonValue);\n}\n\nfunction isJsonValue(value: unknown): value is AssistantWorkflowJsonValue {\n  if (value === null) return true;\n  if (typeof value === \"string\" || typeof value === \"boolean\") return true;\n  if (typeof value === \"number\") return Number.isFinite(value);\n  if (Array.isArray(value)) return value.every(isJsonValue);\n  return isJsonRecord(value);\n}\n"]}

package/dist/trace-events.d.ts

@@ -0,0 +1,14 @@
+export { readAssistantWorkflowBoolean as readAssistantWorkflowTraceBoolean, readAssistantWorkflowBooleanRecord as readAssistantWorkflowTraceBooleanRecord, readAssistantWorkflowNumber as readAssistantWorkflowTraceNumber, readAssistantWorkflowRecord as readAssistantWorkflowTracePayloadRecord, readAssistantWorkflowString as readAssistantWorkflowTraceString, readAssistantWorkflowStringArray as readAssistantWorkflowTraceStringArray, } from "./value-readers.js";
+export type AssistantWorkflowTraceEvent = {
+    stage: string;
+    timestamp?: string | null;
+    payload?: Record<string, unknown> | null;
+};
+export type AssistantWorkflowTraceUserMessagePreviewOptions = {
+    limit?: number;
+    omission?: string;
+};
+export declare function parseAssistantWorkflowTraceEvents(raw: unknown): AssistantWorkflowTraceEvent[];
+export declare function readAssistantWorkflowTraceUserMessagePreview(stage: string, payload: Record<string, unknown>, options?: AssistantWorkflowTraceUserMessagePreviewOptions): string | null;
+export declare function isAssistantWorkflowErrorTraceStage(stage: string): boolean;
+//# sourceMappingURL=trace-events.d.ts.map

package/dist/trace-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-events.d.ts","sourceRoot":"","sources":["../src/trace-events.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,4BAA4B,IAAI,iCAAiC,EACjE,kCAAkC,IAAI,uCAAuC,EAC7E,2BAA2B,IAAI,gCAAgC,EAC/D,2BAA2B,IAAI,uCAAuC,EACtE,2BAA2B,IAAI,gCAAgC,EAC/D,gCAAgC,IAAI,qCAAqC,GAC1E,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,+CAA+C,GAAG;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAUF,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,OAAO,GAAG,2BAA2B,EAAE,CAe7F;AAaD,wBAAgB,4CAA4C,CAC1D,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,+CAAoD,GAC5D,MAAM,GAAG,IAAI,CAUf;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGzE"}

package/dist/trace-events.js

@@ -0,0 +1,65 @@
+import { ASSISTANT_WORKFLOW_TRACE_STAGE } from "./trace-stages.js";
+import { readAssistantWorkflowRecord, readAssistantWorkflowString, } from "./value-readers.js";
+export { readAssistantWorkflowBoolean as readAssistantWorkflowTraceBoolean, readAssistantWorkflowBooleanRecord as readAssistantWorkflowTraceBooleanRecord, readAssistantWorkflowNumber as readAssistantWorkflowTraceNumber, readAssistantWorkflowRecord as readAssistantWorkflowTracePayloadRecord, readAssistantWorkflowString as readAssistantWorkflowTraceString, readAssistantWorkflowStringArray as readAssistantWorkflowTraceStringArray, } from "./value-readers.js";
+const ERROR_STAGE_EXACT = new Set([
+    ASSISTANT_WORKFLOW_TRACE_STAGE.responseGuardrailHit,
+    ASSISTANT_WORKFLOW_TRACE_STAGE.toolGuardrailHit,
+    ASSISTANT_WORKFLOW_TRACE_STAGE.toolCallError,
+]);
+const ERROR_STAGE_SUFFIXES = [".error", ".timeout.fallback", ".invalid"];
+export function parseAssistantWorkflowTraceEvents(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const entry of raw) {
+        const record = readAssistantWorkflowRecord(entry);
+        if (!record)
+            continue;
+        const stage = readAssistantWorkflowString(record["stage"]);
+        if (!stage)
+            continue;
+        out.push({
+            stage,
+            timestamp: readAssistantWorkflowString(record["timestamp"]),
+            payload: readTraceEventPayload(record["payload"]),
+        });
+    }
+    return out;
+}
+function readTraceEventPayload(value) {
+    const record = readAssistantWorkflowRecord(value);
+    if (record)
+        return record;
+    if (typeof value !== "string" || !value.trim().length)
+        return null;
+    try {
+        return readAssistantWorkflowRecord(JSON.parse(value));
+    }
+    catch {
+        return null;
+    }
+}
+export function readAssistantWorkflowTraceUserMessagePreview(stage, payload, options = {}) {
+    const candidate = stage === ASSISTANT_WORKFLOW_TRACE_STAGE.chatRequestStart || stage === ASSISTANT_WORKFLOW_TRACE_STAGE.userMessage
+        ? readAssistantWorkflowString(payload["message"]) ?? readAssistantWorkflowString(payload["content"])
+        : stage === ASSISTANT_WORKFLOW_TRACE_STAGE.schemaAdvisoryRequest
+            ? readAssistantWorkflowString(payload["message"]) ??
+                readAssistantWorkflowString(payload["prompt"]) ??
+                readAssistantWorkflowString(payload["key"])
+            : null;
+    return candidate ? truncateTracePreview(candidate, options.limit, options.omission) : null;
+}
+export function isAssistantWorkflowErrorTraceStage(stage) {
+    if (ERROR_STAGE_EXACT.has(stage))
+        return true;
+    return ERROR_STAGE_SUFFIXES.some((suffix) => stage.endsWith(suffix));
+}
+function truncateTracePreview(value, limit = 240, omission = "...") {
+    const trimmed = value.replace(/\s+/g, " ").trim();
+    if (trimmed.length <= limit)
+        return trimmed;
+    if (limit <= omission.length)
+        return omission.slice(0, Math.max(limit, 0));
+    return `${trimmed.slice(0, limit - omission.length)}${omission}`;
+}
+//# sourceMappingURL=trace-events.js.map

package/dist/trace-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-events.js","sourceRoot":"","sources":["../src/trace-events.ts"],"names":[],"mappings":"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","sourcesContent":["import { ASSISTANT_WORKFLOW_TRACE_STAGE } from \"./trace-stages.js\";\nimport {\n  readAssistantWorkflowBoolean,\n  readAssistantWorkflowBooleanRecord,\n  readAssistantWorkflowNumber,\n  readAssistantWorkflowRecord,\n  readAssistantWorkflowString,\n  readAssistantWorkflowStringArray,\n} from \"./value-readers.js\";\n\nexport {\n  readAssistantWorkflowBoolean as readAssistantWorkflowTraceBoolean,\n  readAssistantWorkflowBooleanRecord as readAssistantWorkflowTraceBooleanRecord,\n  readAssistantWorkflowNumber as readAssistantWorkflowTraceNumber,\n  readAssistantWorkflowRecord as readAssistantWorkflowTracePayloadRecord,\n  readAssistantWorkflowString as readAssistantWorkflowTraceString,\n  readAssistantWorkflowStringArray as readAssistantWorkflowTraceStringArray,\n} from \"./value-readers.js\";\n\nexport type AssistantWorkflowTraceEvent = {\n  stage: string;\n  timestamp?: string | null;\n  payload?: Record<string, unknown> | null;\n};\n\nexport type AssistantWorkflowTraceUserMessagePreviewOptions = {\n  limit?: number;\n  omission?: string;\n};\n\nconst ERROR_STAGE_EXACT = new Set<string>([\n  ASSISTANT_WORKFLOW_TRACE_STAGE.responseGuardrailHit,\n  ASSISTANT_WORKFLOW_TRACE_STAGE.toolGuardrailHit,\n  ASSISTANT_WORKFLOW_TRACE_STAGE.toolCallError,\n]);\n\nconst ERROR_STAGE_SUFFIXES = [\".error\", \".timeout.fallback\", \".invalid\"];\n\nexport function parseAssistantWorkflowTraceEvents(raw: unknown): AssistantWorkflowTraceEvent[] {\n  if (!Array.isArray(raw)) return [];\n  const out: AssistantWorkflowTraceEvent[] = [];\n  for (const entry of raw) {\n    const record = readAssistantWorkflowRecord(entry);\n    if (!record) continue;\n    const stage = readAssistantWorkflowString(record[\"stage\"]);\n    if (!stage) continue;\n    out.push({\n      stage,\n      timestamp: readAssistantWorkflowString(record[\"timestamp\"]),\n      payload: readTraceEventPayload(record[\"payload\"]),\n    });\n  }\n  return out;\n}\n\nfunction readTraceEventPayload(value: unknown): Record<string, unknown> | null {\n  const record = readAssistantWorkflowRecord(value);\n  if (record) return record;\n  if (typeof value !== \"string\" || !value.trim().length) return null;\n  try {\n    return readAssistantWorkflowRecord(JSON.parse(value) as unknown);\n  } catch {\n    return null;\n  }\n}\n\nexport function readAssistantWorkflowTraceUserMessagePreview(\n  stage: string,\n  payload: Record<string, unknown>,\n  options: AssistantWorkflowTraceUserMessagePreviewOptions = {},\n): string | null {\n  const candidate =\n    stage === ASSISTANT_WORKFLOW_TRACE_STAGE.chatRequestStart || stage === ASSISTANT_WORKFLOW_TRACE_STAGE.userMessage\n      ? readAssistantWorkflowString(payload[\"message\"]) ?? readAssistantWorkflowString(payload[\"content\"])\n      : stage === ASSISTANT_WORKFLOW_TRACE_STAGE.schemaAdvisoryRequest\n        ? readAssistantWorkflowString(payload[\"message\"]) ??\n          readAssistantWorkflowString(payload[\"prompt\"]) ??\n          readAssistantWorkflowString(payload[\"key\"])\n        : null;\n  return candidate ? truncateTracePreview(candidate, options.limit, options.omission) : null;\n}\n\nexport function isAssistantWorkflowErrorTraceStage(stage: string): boolean {\n  if (ERROR_STAGE_EXACT.has(stage)) return true;\n  return ERROR_STAGE_SUFFIXES.some((suffix) => stage.endsWith(suffix));\n}\n\nfunction truncateTracePreview(value: string, limit = 240, omission = \"...\"): string {\n  const trimmed = value.replace(/\\s+/g, \" \").trim();\n  if (trimmed.length <= limit) return trimmed;\n  if (limit <= omission.length) return omission.slice(0, Math.max(limit, 0));\n  return `${trimmed.slice(0, limit - omission.length)}${omission}`;\n}\n"]}

package/dist/trace-payload.d.ts

@@ -0,0 +1,24 @@
+export type AssistantWorkflowTraceEntry = {
+    stage: string;
+    timestamp: string;
+    payload?: Record<string, unknown>;
+};
+export type AssistantWorkflowTraceEntryLike = {
+    stage: string;
+    payload?: unknown;
+};
+export type AssistantWorkflowTracePayloadSanitizerOptions = {
+    /** Additional payload keys to redact alongside encrypted reasoning fields. */
+    redactedKeys?: readonly string[];
+};
+/**
+ * Projects arbitrary trace values onto a bounded JSON-serializable form. It
+ * truncates strings, limits collection breadth, collapses deeply nested data,
+ * and redacts encrypted reasoning fields before trace storage or transport.
+ */
+export declare function sanitizeAssistantWorkflowTraceValue(value: unknown, depth?: number, options?: AssistantWorkflowTracePayloadSanitizerOptions): unknown;
+export declare function sanitizeAssistantWorkflowTracePayload(payload: Record<string, unknown>, options?: AssistantWorkflowTracePayloadSanitizerOptions): Record<string, unknown>;
+export declare function buildAssistantWorkflowTraceEntry(stage: string, payload?: Record<string, unknown>, timestamp?: Date | string, options?: AssistantWorkflowTracePayloadSanitizerOptions): AssistantWorkflowTraceEntry;
+export declare function summarizeAssistantWorkflowToolArgsForTrace(args: Record<string, unknown>): Record<string, unknown>;
+export declare function findLatestAssistantWorkflowTracePayload(traceEvents: readonly AssistantWorkflowTraceEntryLike[] | null | undefined, stage: string): Record<string, unknown> | null;
+//# sourceMappingURL=trace-payload.d.ts.map

package/dist/trace-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-payload.d.ts","sourceRoot":"","sources":["../src/trace-payload.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,6CAA6C,GAAG;IAC1D,8EAA8E;IAC9E,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AAqDF;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,OAAO,EACd,KAAK,SAAI,EACT,OAAO,CAAC,EAAE,6CAA6C,GACtD,OAAO,CAET;AAED,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,6CAA6C,GACtD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,GAAE,IAAI,GAAG,MAAmB,EACrC,OAAO,CAAC,EAAE,6CAA6C,GACtD,2BAA2B,CAO7B;AAED,wBAAgB,0CAA0C,CACxD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB;AAED,wBAAgB,uCAAuC,CACrD,WAAW,EAAE,SAAS,+BAA+B,EAAE,GAAG,IAAI,GAAG,SAAS,EAC1E,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQhC"}

package/dist/trace-payload.js

@@ -0,0 +1,113 @@
+import { readAssistantWorkflowRecord } from "./value-readers.js";
+const DEFAULT_REDACTED_KEYS = new Set([
+    "encrypted_content",
+    "encryptedContent",
+]);
+const TRACE_STRING_LIMIT = 240;
+const TOOL_ARGUMENT_STRING_LIMIT = 160;
+const TRACE_COLLAPSE_DEPTH = 2;
+const TRACE_NUMERIC_ARRAY_LIMIT = 64;
+const TRACE_ARRAY_LIMIT = 8;
+const TRACE_OBJECT_ENTRY_LIMIT = 12;
+const TRACE_PAYLOAD_ENTRY_LIMIT = 24;
+function truncateTraceString(value, maxChars) {
+    return value.length > maxChars ? `${value.slice(0, maxChars)}…` : value;
+}
+function buildSanitizerPolicy(options) {
+    if (!options?.redactedKeys?.length)
+        return { redactedKeys: DEFAULT_REDACTED_KEYS };
+    return {
+        redactedKeys: new Set([
+            ...DEFAULT_REDACTED_KEYS,
+            ...options.redactedKeys,
+        ]),
+    };
+}
+function sanitizeTraceValue(value, depth, policy) {
+    if (value === null || typeof value === "boolean" || typeof value === "number")
+        return value;
+    if (typeof value === "string")
+        return truncateTraceString(value, TRACE_STRING_LIMIT);
+    if (depth >= TRACE_COLLAPSE_DEPTH) {
+        if (Array.isArray(value))
+            return `array(${value.length})`;
+        const record = readAssistantWorkflowRecord(value);
+        if (record)
+            return `object(${Object.keys(record).length})`;
+        return typeof value;
+    }
+    if (Array.isArray(value)) {
+        const allNumeric = value.every((entry) => typeof entry === "number" && Number.isFinite(entry));
+        const limit = allNumeric ? TRACE_NUMERIC_ARRAY_LIMIT : TRACE_ARRAY_LIMIT;
+        return value.slice(0, limit).map((entry) => sanitizeTraceValue(entry, depth + 1, policy));
+    }
+    const record = readAssistantWorkflowRecord(value);
+    if (record) {
+        const nested = {};
+        for (const [key, nestedValue] of Object.entries(record).slice(0, TRACE_OBJECT_ENTRY_LIMIT)) {
+            nested[key] = policy.redactedKeys.has(key)
+                ? "[redacted]"
+                : sanitizeTraceValue(nestedValue, depth + 1, policy);
+        }
+        return nested;
+    }
+    return typeof value;
+}
+/**
+ * Projects arbitrary trace values onto a bounded JSON-serializable form. It
+ * truncates strings, limits collection breadth, collapses deeply nested data,
+ * and redacts encrypted reasoning fields before trace storage or transport.
+ */
+export function sanitizeAssistantWorkflowTraceValue(value, depth = 0, options) {
+    return sanitizeTraceValue(value, depth, buildSanitizerPolicy(options));
+}
+export function sanitizeAssistantWorkflowTracePayload(payload, options) {
+    const policy = buildSanitizerPolicy(options);
+    const sanitized = {};
+    for (const [key, value] of Object.entries(payload).slice(0, TRACE_PAYLOAD_ENTRY_LIMIT)) {
+        sanitized[key] = policy.redactedKeys.has(key)
+            ? "[redacted]"
+            : sanitizeTraceValue(value, 0, policy);
+    }
+    return sanitized;
+}
+export function buildAssistantWorkflowTraceEntry(stage, payload, timestamp = new Date(), options) {
+    const sanitizedPayload = payload ? sanitizeAssistantWorkflowTracePayload(payload, options) : undefined;
+    return {
+        stage,
+        timestamp: timestamp instanceof Date ? timestamp.toISOString() : timestamp,
+        ...(sanitizedPayload ? { payload: sanitizedPayload } : {}),
+    };
+}
+export function summarizeAssistantWorkflowToolArgsForTrace(args) {
+    const summary = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (typeof value === "string") {
+            summary[key] = truncateTraceString(value, TOOL_ARGUMENT_STRING_LIMIT);
+            continue;
+        }
+        if (typeof value === "number" || typeof value === "boolean" || value === null) {
+            summary[key] = value;
+            continue;
+        }
+        if (Array.isArray(value)) {
+            summary[key] = `array(${value.length})`;
+            continue;
+        }
+        const record = readAssistantWorkflowRecord(value);
+        summary[key] = record ? `object(${Object.keys(record).length})` : typeof value;
+    }
+    return summary;
+}
+export function findLatestAssistantWorkflowTracePayload(traceEvents, stage) {
+    for (let index = (traceEvents?.length ?? 0) - 1; index >= 0; index -= 1) {
+        const entry = traceEvents?.[index];
+        if (!entry || entry.stage !== stage)
+            continue;
+        const payload = readAssistantWorkflowRecord(entry.payload);
+        if (payload)
+            return payload;
+    }
+    return null;
+}
+//# sourceMappingURL=trace-payload.js.map