@uns-kit/assistant-workflow 2.0.72

package/dist/tool-result-cache.js

@@ -0,0 +1,173 @@
+const TTL_LIVE_MS = 30_000;
+const TTL_RECENT_MS = 5 * 60_000;
+const TTL_DAY_MS = 30 * 60_000;
+const TTL_HISTORICAL_MS = 2 * 60 * 60_000;
+const TTL_NO_RANGE_MS = 15 * 60_000;
+export function chooseAssistantWorkflowToolResultCacheTtlMs(args, nowMs) {
+    const toMs = parseIsoMs(args["to"]);
+    if (toMs === null)
+        return TTL_NO_RANGE_MS;
+    const ageMs = nowMs - toMs;
+    if (ageMs < 5 * 60_000)
+        return TTL_LIVE_MS;
+    if (ageMs < 60 * 60_000)
+        return TTL_RECENT_MS;
+    if (ageMs < 24 * 60 * 60_000)
+        return TTL_DAY_MS;
+    return TTL_HISTORICAL_MS;
+}
+export function buildAssistantWorkflowToolResultCacheKey(scopeId, toolName, args, options = {}) {
+    const sortArrayArgKeys = new Set(options.sortArrayArgKeys ?? []);
+    const normalizedArgs = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (sortArrayArgKeys.has(key) && Array.isArray(value)) {
+            normalizedArgs[key] = [...value]
+                .filter((entry) => typeof entry === "string")
+                .sort();
+        }
+        else {
+            normalizedArgs[key] = value;
+        }
+    }
+    return JSON.stringify({
+        t: scopeId,
+        n: toolName,
+        a: normalizeToolResultCacheValue(normalizedArgs),
+    });
+}
+export function normalizeToolResultCacheValue(value) {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value === "string") {
+        const parsed = Date.parse(value);
+        if (Number.isFinite(parsed) && /\d{4}-\d{2}-\d{2}T/.test(value)) {
+            return { __ts: parsed };
+        }
+        return value;
+    }
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "boolean")
+        return value;
+    if (Array.isArray(value)) {
+        return value.map(normalizeToolResultCacheValue);
+    }
+    if (typeof value === "object") {
+        const record = value;
+        const out = {};
+        const keys = Object.keys(record).sort();
+        for (const key of keys) {
+            const normalized = normalizeToolResultCacheValue(record[key]);
+            if (normalized !== null)
+                out[key] = normalized;
+        }
+        return out;
+    }
+    return String(value);
+}
+export class AssistantWorkflowToolResultCache {
+    cache = new Map();
+    maxEntries;
+    cacheableToolNames;
+    isCacheableToolFn;
+    sortArrayArgKeys;
+    chooseTtlMsFn;
+    shouldCacheValueFn;
+    stats = {
+        hits: 0,
+        misses: 0,
+        evictions: 0,
+        expirations: 0,
+        size: 0,
+    };
+    constructor(options = {}) {
+        this.maxEntries = Math.max(1, options.maxEntries ?? 500);
+        this.cacheableToolNames = options.cacheableToolNames
+            ? new Set(options.cacheableToolNames)
+            : null;
+        this.isCacheableToolFn = options.isCacheableTool ?? null;
+        this.sortArrayArgKeys = [...(options.sortArrayArgKeys ?? [])];
+        this.chooseTtlMsFn = options.chooseTtlMs ?? chooseAssistantWorkflowToolResultCacheTtlMs;
+        this.shouldCacheValueFn = options.shouldCacheValue ?? defaultShouldCacheToolResultValue;
+    }
+    isCacheableTool(toolName) {
+        if (this.isCacheableToolFn)
+            return this.isCacheableToolFn(toolName);
+        if (!this.cacheableToolNames)
+            return true;
+        return this.cacheableToolNames.has(toolName);
+    }
+    get(scopeId, toolName, args, nowMs) {
+        if (!this.isCacheableTool(toolName))
+            return null;
+        const key = this.buildKey(scopeId, toolName, args);
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses += 1;
+            return null;
+        }
+        if (entry.expiresAt <= nowMs) {
+            this.cache.delete(key);
+            this.stats.expirations += 1;
+            this.stats.misses += 1;
+            this.stats.size = this.cache.size;
+            return null;
+        }
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        this.stats.hits += 1;
+        return entry.value;
+    }
+    set(scopeId, toolName, args, value, nowMs) {
+        if (!this.isCacheableTool(toolName))
+            return;
+        if (!this.shouldCacheValueFn(value))
+            return;
+        const key = this.buildKey(scopeId, toolName, args);
+        const ttlMs = this.chooseTtlMsFn(args, nowMs);
+        const expiresAt = nowMs + ttlMs;
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.maxEntries) {
+            const oldestKey = this.cache.keys().next().value;
+            if (typeof oldestKey === "string") {
+                this.cache.delete(oldestKey);
+                this.stats.evictions += 1;
+            }
+        }
+        this.cache.set(key, { value, expiresAt, key });
+        this.stats.size = this.cache.size;
+    }
+    clearScope(scopeId) {
+        const prefix = JSON.stringify({ t: scopeId }).slice(0, -1);
+        for (const [key] of this.cache) {
+            if (key.startsWith(prefix)) {
+                this.cache.delete(key);
+            }
+        }
+        this.stats.size = this.cache.size;
+    }
+    clear() {
+        this.cache.clear();
+        this.stats.size = 0;
+    }
+    getStats() {
+        return { ...this.stats };
+    }
+    buildKey(scopeId, toolName, args) {
+        return buildAssistantWorkflowToolResultCacheKey(scopeId, toolName, args, {
+            sortArrayArgKeys: this.sortArrayArgKeys,
+        });
+    }
+}
+function defaultShouldCacheToolResultValue(value) {
+    return typeof value === "string" && value.length > 0 && !value.startsWith("Error:");
+}
+function parseIsoMs(value) {
+    if (typeof value !== "string")
+        return null;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+//# sourceMappingURL=tool-result-cache.js.map

package/dist/tool-result-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-cache.js","sourceRoot":"","sources":["../src/tool-result-cache.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,aAAa,GAAG,CAAC,GAAG,MAAM,CAAC;AACjC,MAAM,UAAU,GAAG,EAAE,GAAG,MAAM,CAAC;AAC/B,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;AAC1C,MAAM,eAAe,GAAG,EAAE,GAAG,MAAM,CAAC;AAEpC,MAAM,UAAU,2CAA2C,CACzD,IAA6B,EAC7B,KAAa;IAEb,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,eAAe,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,GAAG,MAAM;QAAE,OAAO,WAAW,CAAC;IAC3C,IAAI,KAAK,GAAG,EAAE,GAAG,MAAM;QAAE,OAAO,aAAa,CAAC;IAC9C,IAAI,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM;QAAE,OAAO,UAAU,CAAC;IAChD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,OAAe,EACf,QAAgB,EAChB,IAA6B,EAC7B,UAA6E,EAAE;IAE/E,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,cAAc,GAA4B,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;iBAC7B,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;iBAC7D,IAAI,EAAE,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,CAAC,EAAE,OAAO;QACV,CAAC,EAAE,QAAQ;QACX,CAAC,EAAE,6BAA6B,CAAC,cAAc,CAAC;KACjD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAc;IAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,UAAU,GAAG,6BAA6B,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9D,IAAI,UAAU,KAAK,IAAI;gBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QACjD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,OAAO,gCAAgC;IAC1B,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,UAAU,CAAS;IACnB,kBAAkB,CAA6B;IAC/C,iBAAiB,CAAyC;IAC1D,gBAAgB,CAAoB;IACpC,aAAa,CAA2D;IACxE,kBAAkB,CAA6B;IACxD,KAAK,GAA0C;QACrD,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,CAAC;QACT,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;QACd,IAAI,EAAE,CAAC;KACR,CAAC;IAEF,YAAY,UAAmD,EAAE;QAC/D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB;YAClD,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC;YACrC,CAAC,CAAC,IAAI,CAAC;QACT,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;QACzD,IAAI,CAAC,gBAAgB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,WAAW,IAAI,2CAA2C,CAAC;QACxF,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,IAAI,iCAAiC,CAAC;IAC1F,CAAC;IAED,eAAe,CAAC,QAAgB;QAC9B,IAAI,IAAI,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,kBAAkB;YAAE,OAAO,IAAI,CAAC;QAC1C,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,GAAG,CACD,OAAe,EACf,QAAgB,EAChB,IAA6B,EAC7B,KAAa;QAEb,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,GAAG,CACD,OAAe,EACf,QAAgB,EAChB,IAA6B,EAC7B,KAAa,EACb,KAAa;QAEb,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;YAAE,OAAO;QAC5C,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC;YAAE,OAAO;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC7B,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,UAAU,CAAC,OAAe;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEO,QAAQ,CACd,OAAe,EACf,QAAgB,EAChB,IAA6B;QAE7B,OAAO,wCAAwC,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE;YACvE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,iCAAiC,CAAC,KAAa;IACtD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC","sourcesContent":["export type AssistantWorkflowToolResultCacheStats = {\n  hits: number;\n  misses: number;\n  evictions: number;\n  expirations: number;\n  size: number;\n};\n\nexport type AssistantWorkflowToolResultCacheOptions = {\n  maxEntries?: number;\n  cacheableToolNames?: ReadonlySet<string> | readonly string[] | null;\n  isCacheableTool?: (toolName: string) => boolean;\n  sortArrayArgKeys?: readonly string[];\n  chooseTtlMs?: (args: Record<string, unknown>, nowMs: number) => number;\n  shouldCacheValue?: (value: string) => boolean;\n};\n\ntype CacheEntry = {\n  value: string;\n  expiresAt: number;\n  key: string;\n};\n\nconst TTL_LIVE_MS = 30_000;\nconst TTL_RECENT_MS = 5 * 60_000;\nconst TTL_DAY_MS = 30 * 60_000;\nconst TTL_HISTORICAL_MS = 2 * 60 * 60_000;\nconst TTL_NO_RANGE_MS = 15 * 60_000;\n\nexport function chooseAssistantWorkflowToolResultCacheTtlMs(\n  args: Record<string, unknown>,\n  nowMs: number,\n): number {\n  const toMs = parseIsoMs(args[\"to\"]);\n  if (toMs === null) return TTL_NO_RANGE_MS;\n  const ageMs = nowMs - toMs;\n  if (ageMs < 5 * 60_000) return TTL_LIVE_MS;\n  if (ageMs < 60 * 60_000) return TTL_RECENT_MS;\n  if (ageMs < 24 * 60 * 60_000) return TTL_DAY_MS;\n  return TTL_HISTORICAL_MS;\n}\n\nexport function buildAssistantWorkflowToolResultCacheKey(\n  scopeId: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  options: Pick<AssistantWorkflowToolResultCacheOptions, \"sortArrayArgKeys\"> = {},\n): string {\n  const sortArrayArgKeys = new Set(options.sortArrayArgKeys ?? []);\n  const normalizedArgs: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(args)) {\n    if (sortArrayArgKeys.has(key) && Array.isArray(value)) {\n      normalizedArgs[key] = [...value]\n        .filter((entry): entry is string => typeof entry === \"string\")\n        .sort();\n    } else {\n      normalizedArgs[key] = value;\n    }\n  }\n  return JSON.stringify({\n    t: scopeId,\n    n: toolName,\n    a: normalizeToolResultCacheValue(normalizedArgs),\n  });\n}\n\nexport function normalizeToolResultCacheValue(value: unknown): unknown {\n  if (value === undefined || value === null) return null;\n  if (typeof value === \"string\") {\n    const parsed = Date.parse(value);\n    if (Number.isFinite(parsed) && /\\d{4}-\\d{2}-\\d{2}T/.test(value)) {\n      return { __ts: parsed };\n    }\n    return value;\n  }\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (typeof value === \"boolean\") return value;\n  if (Array.isArray(value)) {\n    return value.map(normalizeToolResultCacheValue);\n  }\n  if (typeof value === \"object\") {\n    const record = value as Record<string, unknown>;\n    const out: Record<string, unknown> = {};\n    const keys = Object.keys(record).sort();\n    for (const key of keys) {\n      const normalized = normalizeToolResultCacheValue(record[key]);\n      if (normalized !== null) out[key] = normalized;\n    }\n    return out;\n  }\n  return String(value);\n}\n\nexport class AssistantWorkflowToolResultCache {\n  private readonly cache = new Map<string, CacheEntry>();\n  private readonly maxEntries: number;\n  private readonly cacheableToolNames: ReadonlySet<string> | null;\n  private readonly isCacheableToolFn: ((toolName: string) => boolean) | null;\n  private readonly sortArrayArgKeys: readonly string[];\n  private readonly chooseTtlMsFn: (args: Record<string, unknown>, nowMs: number) => number;\n  private readonly shouldCacheValueFn: (value: string) => boolean;\n  private stats: AssistantWorkflowToolResultCacheStats = {\n    hits: 0,\n    misses: 0,\n    evictions: 0,\n    expirations: 0,\n    size: 0,\n  };\n\n  constructor(options: AssistantWorkflowToolResultCacheOptions = {}) {\n    this.maxEntries = Math.max(1, options.maxEntries ?? 500);\n    this.cacheableToolNames = options.cacheableToolNames\n      ? new Set(options.cacheableToolNames)\n      : null;\n    this.isCacheableToolFn = options.isCacheableTool ?? null;\n    this.sortArrayArgKeys = [...(options.sortArrayArgKeys ?? [])];\n    this.chooseTtlMsFn = options.chooseTtlMs ?? chooseAssistantWorkflowToolResultCacheTtlMs;\n    this.shouldCacheValueFn = options.shouldCacheValue ?? defaultShouldCacheToolResultValue;\n  }\n\n  isCacheableTool(toolName: string): boolean {\n    if (this.isCacheableToolFn) return this.isCacheableToolFn(toolName);\n    if (!this.cacheableToolNames) return true;\n    return this.cacheableToolNames.has(toolName);\n  }\n\n  get(\n    scopeId: string,\n    toolName: string,\n    args: Record<string, unknown>,\n    nowMs: number,\n  ): string | null {\n    if (!this.isCacheableTool(toolName)) return null;\n    const key = this.buildKey(scopeId, toolName, args);\n    const entry = this.cache.get(key);\n    if (!entry) {\n      this.stats.misses += 1;\n      return null;\n    }\n    if (entry.expiresAt <= nowMs) {\n      this.cache.delete(key);\n      this.stats.expirations += 1;\n      this.stats.misses += 1;\n      this.stats.size = this.cache.size;\n      return null;\n    }\n    this.cache.delete(key);\n    this.cache.set(key, entry);\n    this.stats.hits += 1;\n    return entry.value;\n  }\n\n  set(\n    scopeId: string,\n    toolName: string,\n    args: Record<string, unknown>,\n    value: string,\n    nowMs: number,\n  ): void {\n    if (!this.isCacheableTool(toolName)) return;\n    if (!this.shouldCacheValueFn(value)) return;\n    const key = this.buildKey(scopeId, toolName, args);\n    const ttlMs = this.chooseTtlMsFn(args, nowMs);\n    const expiresAt = nowMs + ttlMs;\n    if (this.cache.has(key)) {\n      this.cache.delete(key);\n    } else if (this.cache.size >= this.maxEntries) {\n      const oldestKey = this.cache.keys().next().value;\n      if (typeof oldestKey === \"string\") {\n        this.cache.delete(oldestKey);\n        this.stats.evictions += 1;\n      }\n    }\n    this.cache.set(key, { value, expiresAt, key });\n    this.stats.size = this.cache.size;\n  }\n\n  clearScope(scopeId: string): void {\n    const prefix = JSON.stringify({ t: scopeId }).slice(0, -1);\n    for (const [key] of this.cache) {\n      if (key.startsWith(prefix)) {\n        this.cache.delete(key);\n      }\n    }\n    this.stats.size = this.cache.size;\n  }\n\n  clear(): void {\n    this.cache.clear();\n    this.stats.size = 0;\n  }\n\n  getStats(): AssistantWorkflowToolResultCacheStats {\n    return { ...this.stats };\n  }\n\n  private buildKey(\n    scopeId: string,\n    toolName: string,\n    args: Record<string, unknown>,\n  ): string {\n    return buildAssistantWorkflowToolResultCacheKey(scopeId, toolName, args, {\n      sortArrayArgKeys: this.sortArrayArgKeys,\n    });\n  }\n}\n\nfunction defaultShouldCacheToolResultValue(value: string): boolean {\n  return typeof value === \"string\" && value.length > 0 && !value.startsWith(\"Error:\");\n}\n\nfunction parseIsoMs(value: unknown): number | null {\n  if (typeof value !== \"string\") return null;\n  const parsed = Date.parse(value);\n  return Number.isFinite(parsed) ? parsed : null;\n}\n"]}

package/dist/tool-results.d.ts

@@ -0,0 +1,41 @@
+import type { AssistantWorkflowToolProvider } from "./definition.js";
+import type { AssistantWorkflowToolInvocationQueue } from "./tool-invocations.js";
+export type AssistantWorkflowToolResultStatus = "success" | "error" | "skipped";
+export type AssistantWorkflowToolResult = {
+    invocationId: string;
+    toolName: string;
+    stepId: string;
+    provider: AssistantWorkflowToolProvider;
+    status: AssistantWorkflowToolResultStatus;
+    output?: unknown;
+    errorMessage?: string;
+    retryable?: boolean;
+    durationMs?: number;
+};
+export type AssistantWorkflowToolResultSummaryStatus = "complete" | "partial" | "failed" | "empty";
+export type AssistantWorkflowToolResultSummary = {
+    status: AssistantWorkflowToolResultSummaryStatus;
+    totalInvocations: number;
+    resultCount: number;
+    successCount: number;
+    errorCount: number;
+    skippedCount: number;
+    retryableErrorCount: number;
+    providerSummaries: AssistantWorkflowToolResultProviderSummary[];
+    missingResultInvocationIds: string[];
+    unexpectedResultInvocationIds: string[];
+};
+export type AssistantWorkflowToolResultProviderSummary = {
+    provider: AssistantWorkflowToolProvider;
+    resultCount: number;
+    successCount: number;
+    errorCount: number;
+    skippedCount: number;
+};
+export declare function assistantWorkflowToolSuccess(input: Omit<AssistantWorkflowToolResult, "status" | "errorMessage" | "retryable">): AssistantWorkflowToolResult;
+export declare function assistantWorkflowToolError(input: Omit<AssistantWorkflowToolResult, "status" | "output">): AssistantWorkflowToolResult;
+export declare function assistantWorkflowToolSkipped(input: Omit<AssistantWorkflowToolResult, "status" | "output" | "retryable">): AssistantWorkflowToolResult;
+export declare function summarizeAssistantWorkflowToolResults(queue: AssistantWorkflowToolInvocationQueue, results: readonly AssistantWorkflowToolResult[]): AssistantWorkflowToolResultSummary;
+export declare function buildAssistantWorkflowToolResultsTracePayload(queue: AssistantWorkflowToolInvocationQueue, results: readonly AssistantWorkflowToolResult[]): Record<string, unknown>;
+export declare function summarizeAssistantWorkflowToolResultProviders(results: readonly AssistantWorkflowToolResult[]): AssistantWorkflowToolResultProviderSummary[];
+//# sourceMappingURL=tool-results.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-results.d.ts","sourceRoot":"","sources":["../src/tool-results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,uBAAuB,CAAC;AAElF,MAAM,MAAM,iCAAiC,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhF,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,6BAA6B,CAAC;IACxC,MAAM,EAAE,iCAAiC,CAAC;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,wCAAwC,GAChD,UAAU,GACV,SAAS,GACT,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,MAAM,kCAAkC,GAAG;IAC/C,MAAM,EAAE,wCAAwC,CAAC;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,0CAA0C,EAAE,CAAC;IAChE,0BAA0B,EAAE,MAAM,EAAE,CAAC;IACrC,6BAA6B,EAAE,MAAM,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,0CAA0C,GAAG;IACvD,QAAQ,EAAE,6BAA6B,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,IAAI,CAAC,2BAA2B,EAAE,QAAQ,GAAG,cAAc,GAAG,WAAW,CAAC,GAChF,2BAA2B,CAY7B;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,CAAC,2BAA2B,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC5D,2BAA2B,CAa7B;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,IAAI,CAAC,2BAA2B,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC,GAC1E,2BAA2B,CAY7B;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,oCAAoC,EAC3C,OAAO,EAAE,SAAS,2BAA2B,EAAE,GAC9C,kCAAkC,CAgCpC;AAED,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,oCAAoC,EAC3C,OAAO,EAAE,SAAS,2BAA2B,EAAE,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAED,wBAAgB,6CAA6C,CAC3D,OAAO,EAAE,SAAS,2BAA2B,EAAE,GAC9C,0CAA0C,EAAE,CAiB9C"}

package/dist/tool-results.js

@@ -0,0 +1,137 @@
+export function assistantWorkflowToolSuccess(input) {
+    return {
+        invocationId: normalizeRequiredString(input.invocationId, "invocationId"),
+        toolName: normalizeRequiredString(input.toolName, "toolName"),
+        stepId: normalizeRequiredString(input.stepId, "stepId"),
+        provider: normalizeToolProvider(input.provider),
+        status: "success",
+        ...(input.output !== undefined ? { output: input.output } : {}),
+        ...(typeof input.durationMs === "number" && Number.isFinite(input.durationMs)
+            ? { durationMs: Math.max(0, Math.floor(input.durationMs)) }
+            : {}),
+    };
+}
+export function assistantWorkflowToolError(input) {
+    return {
+        invocationId: normalizeRequiredString(input.invocationId, "invocationId"),
+        toolName: normalizeRequiredString(input.toolName, "toolName"),
+        stepId: normalizeRequiredString(input.stepId, "stepId"),
+        provider: normalizeToolProvider(input.provider),
+        status: "error",
+        errorMessage: normalizeRequiredString(input.errorMessage ?? "", "errorMessage"),
+        ...(typeof input.retryable === "boolean" ? { retryable: input.retryable } : {}),
+        ...(typeof input.durationMs === "number" && Number.isFinite(input.durationMs)
+            ? { durationMs: Math.max(0, Math.floor(input.durationMs)) }
+            : {}),
+    };
+}
+export function assistantWorkflowToolSkipped(input) {
+    return {
+        invocationId: normalizeRequiredString(input.invocationId, "invocationId"),
+        toolName: normalizeRequiredString(input.toolName, "toolName"),
+        stepId: normalizeRequiredString(input.stepId, "stepId"),
+        provider: normalizeToolProvider(input.provider),
+        status: "skipped",
+        errorMessage: normalizeRequiredString(input.errorMessage ?? "", "errorMessage"),
+        ...(typeof input.durationMs === "number" && Number.isFinite(input.durationMs)
+            ? { durationMs: Math.max(0, Math.floor(input.durationMs)) }
+            : {}),
+    };
+}
+export function summarizeAssistantWorkflowToolResults(queue, results) {
+    const invocationIds = queue.invocations.map((invocation) => invocation.id);
+    const invocationIdSet = new Set(invocationIds);
+    const resultIdSet = new Set(results.map((result) => result.invocationId));
+    const missingResultInvocationIds = invocationIds.filter((id) => !resultIdSet.has(id));
+    const unexpectedResultInvocationIds = results
+        .map((result) => result.invocationId)
+        .filter((id) => !invocationIdSet.has(id));
+    const successCount = results.filter((result) => result.status === "success").length;
+    const errorCount = results.filter((result) => result.status === "error").length;
+    const skippedCount = results.filter((result) => result.status === "skipped").length;
+    const retryableErrorCount = results
+        .filter((result) => result.status === "error" && result.retryable === true)
+        .length;
+    return {
+        status: resolveToolResultSummaryStatus({
+            totalInvocations: queue.invocations.length,
+            errorCount,
+            missingResultInvocationIds,
+            unexpectedResultInvocationIds,
+        }),
+        totalInvocations: queue.invocations.length,
+        resultCount: results.length,
+        successCount,
+        errorCount,
+        skippedCount,
+        retryableErrorCount,
+        providerSummaries: summarizeAssistantWorkflowToolResultProviders(results),
+        missingResultInvocationIds,
+        unexpectedResultInvocationIds,
+    };
+}
+export function buildAssistantWorkflowToolResultsTracePayload(queue, results) {
+    return {
+        ...summarizeAssistantWorkflowToolResults(queue, results),
+        results: results.map((result) => ({
+            invocationId: result.invocationId,
+            toolName: result.toolName,
+            stepId: result.stepId,
+            provider: result.provider,
+            status: result.status,
+            hasOutput: result.output !== undefined,
+            errorMessage: result.errorMessage ?? null,
+            retryable: result.retryable ?? null,
+            durationMs: result.durationMs ?? null,
+        })),
+    };
+}
+export function summarizeAssistantWorkflowToolResultProviders(results) {
+    const summaries = new Map();
+    for (const result of results) {
+        const summary = summaries.get(result.provider) ?? {
+            provider: result.provider,
+            resultCount: 0,
+            successCount: 0,
+            errorCount: 0,
+            skippedCount: 0,
+        };
+        summary.resultCount += 1;
+        if (result.status === "success")
+            summary.successCount += 1;
+        if (result.status === "error")
+            summary.errorCount += 1;
+        if (result.status === "skipped")
+            summary.skippedCount += 1;
+        summaries.set(result.provider, summary);
+    }
+    return [...summaries.values()].sort((left, right) => left.provider.localeCompare(right.provider));
+}
+function resolveToolResultSummaryStatus(input) {
+    if (input.totalInvocations === 0)
+        return "empty";
+    if (input.errorCount > 0)
+        return "failed";
+    if (input.missingResultInvocationIds.length > 0 || input.unexpectedResultInvocationIds.length > 0) {
+        return "partial";
+    }
+    return "complete";
+}
+function normalizeRequiredString(value, fieldName) {
+    const trimmed = value.trim();
+    if (!trimmed.length) {
+        throw new Error(`Assistant workflow tool result ${fieldName} is required.`);
+    }
+    return trimmed;
+}
+function normalizeToolProvider(value) {
+    if (value === "local-function" ||
+        value === "http" ||
+        value === "mcp" ||
+        value === "openai-hosted" ||
+        value === "repl") {
+        return value;
+    }
+    throw new Error("Assistant workflow tool result provider is invalid.");
+}
+//# sourceMappingURL=tool-results.js.map

package/dist/tool-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-results.js","sourceRoot":"","sources":["../src/tool-results.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantWorkflowToolProvider } from \"./definition.js\";\nimport type { AssistantWorkflowToolInvocationQueue } from \"./tool-invocations.js\";\n\nexport type AssistantWorkflowToolResultStatus = \"success\" | \"error\" | \"skipped\";\n\nexport type AssistantWorkflowToolResult = {\n  invocationId: string;\n  toolName: string;\n  stepId: string;\n  provider: AssistantWorkflowToolProvider;\n  status: AssistantWorkflowToolResultStatus;\n  output?: unknown;\n  errorMessage?: string;\n  retryable?: boolean;\n  durationMs?: number;\n};\n\nexport type AssistantWorkflowToolResultSummaryStatus =\n  | \"complete\"\n  | \"partial\"\n  | \"failed\"\n  | \"empty\";\n\nexport type AssistantWorkflowToolResultSummary = {\n  status: AssistantWorkflowToolResultSummaryStatus;\n  totalInvocations: number;\n  resultCount: number;\n  successCount: number;\n  errorCount: number;\n  skippedCount: number;\n  retryableErrorCount: number;\n  providerSummaries: AssistantWorkflowToolResultProviderSummary[];\n  missingResultInvocationIds: string[];\n  unexpectedResultInvocationIds: string[];\n};\n\nexport type AssistantWorkflowToolResultProviderSummary = {\n  provider: AssistantWorkflowToolProvider;\n  resultCount: number;\n  successCount: number;\n  errorCount: number;\n  skippedCount: number;\n};\n\nexport function assistantWorkflowToolSuccess(\n  input: Omit<AssistantWorkflowToolResult, \"status\" | \"errorMessage\" | \"retryable\">,\n): AssistantWorkflowToolResult {\n  return {\n    invocationId: normalizeRequiredString(input.invocationId, \"invocationId\"),\n    toolName: normalizeRequiredString(input.toolName, \"toolName\"),\n    stepId: normalizeRequiredString(input.stepId, \"stepId\"),\n    provider: normalizeToolProvider(input.provider),\n    status: \"success\",\n    ...(input.output !== undefined ? { output: input.output } : {}),\n    ...(typeof input.durationMs === \"number\" && Number.isFinite(input.durationMs)\n      ? { durationMs: Math.max(0, Math.floor(input.durationMs)) }\n      : {}),\n  };\n}\n\nexport function assistantWorkflowToolError(\n  input: Omit<AssistantWorkflowToolResult, \"status\" | \"output\">,\n): AssistantWorkflowToolResult {\n  return {\n    invocationId: normalizeRequiredString(input.invocationId, \"invocationId\"),\n    toolName: normalizeRequiredString(input.toolName, \"toolName\"),\n    stepId: normalizeRequiredString(input.stepId, \"stepId\"),\n    provider: normalizeToolProvider(input.provider),\n    status: \"error\",\n    errorMessage: normalizeRequiredString(input.errorMessage ?? \"\", \"errorMessage\"),\n    ...(typeof input.retryable === \"boolean\" ? { retryable: input.retryable } : {}),\n    ...(typeof input.durationMs === \"number\" && Number.isFinite(input.durationMs)\n      ? { durationMs: Math.max(0, Math.floor(input.durationMs)) }\n      : {}),\n  };\n}\n\nexport function assistantWorkflowToolSkipped(\n  input: Omit<AssistantWorkflowToolResult, \"status\" | \"output\" | \"retryable\">,\n): AssistantWorkflowToolResult {\n  return {\n    invocationId: normalizeRequiredString(input.invocationId, \"invocationId\"),\n    toolName: normalizeRequiredString(input.toolName, \"toolName\"),\n    stepId: normalizeRequiredString(input.stepId, \"stepId\"),\n    provider: normalizeToolProvider(input.provider),\n    status: \"skipped\",\n    errorMessage: normalizeRequiredString(input.errorMessage ?? \"\", \"errorMessage\"),\n    ...(typeof input.durationMs === \"number\" && Number.isFinite(input.durationMs)\n      ? { durationMs: Math.max(0, Math.floor(input.durationMs)) }\n      : {}),\n  };\n}\n\nexport function summarizeAssistantWorkflowToolResults(\n  queue: AssistantWorkflowToolInvocationQueue,\n  results: readonly AssistantWorkflowToolResult[],\n): AssistantWorkflowToolResultSummary {\n  const invocationIds = queue.invocations.map((invocation) => invocation.id);\n  const invocationIdSet = new Set(invocationIds);\n  const resultIdSet = new Set(results.map((result) => result.invocationId));\n  const missingResultInvocationIds = invocationIds.filter((id) => !resultIdSet.has(id));\n  const unexpectedResultInvocationIds = results\n    .map((result) => result.invocationId)\n    .filter((id) => !invocationIdSet.has(id));\n  const successCount = results.filter((result) => result.status === \"success\").length;\n  const errorCount = results.filter((result) => result.status === \"error\").length;\n  const skippedCount = results.filter((result) => result.status === \"skipped\").length;\n  const retryableErrorCount = results\n    .filter((result) => result.status === \"error\" && result.retryable === true)\n    .length;\n\n  return {\n    status: resolveToolResultSummaryStatus({\n      totalInvocations: queue.invocations.length,\n      errorCount,\n      missingResultInvocationIds,\n      unexpectedResultInvocationIds,\n    }),\n    totalInvocations: queue.invocations.length,\n    resultCount: results.length,\n    successCount,\n    errorCount,\n    skippedCount,\n    retryableErrorCount,\n    providerSummaries: summarizeAssistantWorkflowToolResultProviders(results),\n    missingResultInvocationIds,\n    unexpectedResultInvocationIds,\n  };\n}\n\nexport function buildAssistantWorkflowToolResultsTracePayload(\n  queue: AssistantWorkflowToolInvocationQueue,\n  results: readonly AssistantWorkflowToolResult[],\n): Record<string, unknown> {\n  return {\n    ...summarizeAssistantWorkflowToolResults(queue, results),\n    results: results.map((result) => ({\n      invocationId: result.invocationId,\n      toolName: result.toolName,\n      stepId: result.stepId,\n      provider: result.provider,\n      status: result.status,\n      hasOutput: result.output !== undefined,\n      errorMessage: result.errorMessage ?? null,\n      retryable: result.retryable ?? null,\n      durationMs: result.durationMs ?? null,\n    })),\n  };\n}\n\nexport function summarizeAssistantWorkflowToolResultProviders(\n  results: readonly AssistantWorkflowToolResult[],\n): AssistantWorkflowToolResultProviderSummary[] {\n  const summaries = new Map<AssistantWorkflowToolProvider, AssistantWorkflowToolResultProviderSummary>();\n  for (const result of results) {\n    const summary = summaries.get(result.provider) ?? {\n      provider: result.provider,\n      resultCount: 0,\n      successCount: 0,\n      errorCount: 0,\n      skippedCount: 0,\n    };\n    summary.resultCount += 1;\n    if (result.status === \"success\") summary.successCount += 1;\n    if (result.status === \"error\") summary.errorCount += 1;\n    if (result.status === \"skipped\") summary.skippedCount += 1;\n    summaries.set(result.provider, summary);\n  }\n  return [...summaries.values()].sort((left, right) => left.provider.localeCompare(right.provider));\n}\n\nfunction resolveToolResultSummaryStatus(input: {\n  totalInvocations: number;\n  errorCount: number;\n  missingResultInvocationIds: readonly string[];\n  unexpectedResultInvocationIds: readonly string[];\n}): AssistantWorkflowToolResultSummaryStatus {\n  if (input.totalInvocations === 0) return \"empty\";\n  if (input.errorCount > 0) return \"failed\";\n  if (input.missingResultInvocationIds.length > 0 || input.unexpectedResultInvocationIds.length > 0) {\n    return \"partial\";\n  }\n  return \"complete\";\n}\n\nfunction normalizeRequiredString(value: string, fieldName: string): string {\n  const trimmed = value.trim();\n  if (!trimmed.length) {\n    throw new Error(`Assistant workflow tool result ${fieldName} is required.`);\n  }\n  return trimmed;\n}\n\nfunction normalizeToolProvider(value: AssistantWorkflowToolProvider): AssistantWorkflowToolProvider {\n  if (\n    value === \"local-function\" ||\n    value === \"http\" ||\n    value === \"mcp\" ||\n    value === \"openai-hosted\" ||\n    value === \"repl\"\n  ) {\n    return value;\n  }\n  throw new Error(\"Assistant workflow tool result provider is invalid.\");\n}\n"]}

package/dist/tool-runtime.d.ts

@@ -0,0 +1,46 @@
+import { type AssistantWorkflowDefinition, type AssistantWorkflowToolBindingDefinition, type AssistantWorkflowToolCapabilityDefinition } from "./definition.js";
+import { type AssistantWorkflowToolPolicyRecommendation } from "./tool-capabilities.js";
+import { type AssistantWorkflowToolResolutionStatus } from "./tool-bindings.js";
+export type AssistantWorkflowToolRuntimeRegistration = {
+    name: string;
+    enabled: boolean;
+    assistantVisible: boolean;
+    schemaAssistantVisible: boolean;
+    explicitCallAllowed: boolean;
+    supportsAssistantVisibility?: boolean;
+    supportsSchemaAssistantVisibility?: boolean;
+    supportsExplicitCall?: boolean;
+    adapterId?: string | null;
+};
+export type AssistantWorkflowToolRuntimePolicyField = "enabled" | "assistantVisible" | "schemaAssistantVisible" | "explicitCallAllowed";
+export type AssistantWorkflowToolRuntimePolicyMismatch = {
+    field: AssistantWorkflowToolRuntimePolicyField;
+    expected: boolean;
+    actual: boolean;
+};
+export type AssistantWorkflowToolRuntimeResolutionStatus = AssistantWorkflowToolResolutionStatus | "missing-runtime-registration" | "policy-drift";
+export type AssistantWorkflowToolRuntimeResolution = {
+    toolName: string;
+    status: AssistantWorkflowToolRuntimeResolutionStatus;
+    capability: AssistantWorkflowToolCapabilityDefinition | null;
+    binding: AssistantWorkflowToolBindingDefinition | null;
+    registration: AssistantWorkflowToolRuntimeRegistration | null;
+    recommendation: AssistantWorkflowToolPolicyRecommendation | null;
+    policyMismatches: AssistantWorkflowToolRuntimePolicyMismatch[];
+};
+export type AssistantWorkflowToolRuntimeAudit = {
+    resolutions: AssistantWorkflowToolRuntimeResolution[];
+    registeredToolNames: string[];
+    readyToolNames: string[];
+    policyDriftToolNames: string[];
+    missingRuntimeRegistrationNames: string[];
+    runtimeToolWithoutCapabilityNames: string[];
+    missingBindingNames: string[];
+    providerMismatchNames: string[];
+    duplicateRuntimeRegistrationNames: string[];
+};
+export declare function resolveAssistantWorkflowToolRuntime(workflow: AssistantWorkflowDefinition<string, string, string, string>, registrations: readonly AssistantWorkflowToolRuntimeRegistration[], toolName: unknown): AssistantWorkflowToolRuntimeResolution;
+export declare function buildAssistantWorkflowToolRuntimeAudit(workflow: AssistantWorkflowDefinition<string, string, string, string>, registrations: readonly AssistantWorkflowToolRuntimeRegistration[]): AssistantWorkflowToolRuntimeAudit;
+export declare function buildAssistantWorkflowToolRuntimeResolutionTracePayload(resolution: AssistantWorkflowToolRuntimeResolution): Record<string, unknown>;
+export declare function buildAssistantWorkflowToolRuntimeAuditTracePayload(audit: AssistantWorkflowToolRuntimeAudit): Record<string, unknown>;
+//# sourceMappingURL=tool-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-runtime.d.ts","sourceRoot":"","sources":["../src/tool-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,sCAAsC,EAC3C,KAAK,yCAAyC,EAC/C,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,yCAAyC,EAC/C,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,qCAAqC,EAC3C,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,sBAAsB,EAAE,OAAO,CAAC;IAChC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,uCAAuC,GAC/C,SAAS,GACT,kBAAkB,GAClB,wBAAwB,GACxB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,0CAA0C,GAAG;IACvD,KAAK,EAAE,uCAAuC,CAAC;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4CAA4C,GACpD,qCAAqC,GACrC,8BAA8B,GAC9B,cAAc,CAAC;AAEnB,MAAM,MAAM,sCAAsC,GAAG;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,4CAA4C,CAAC;IACrD,UAAU,EAAE,yCAAyC,GAAG,IAAI,CAAC;IAC7D,OAAO,EAAE,sCAAsC,GAAG,IAAI,CAAC;IACvD,YAAY,EAAE,wCAAwC,GAAG,IAAI,CAAC;IAC9D,cAAc,EAAE,yCAAyC,GAAG,IAAI,CAAC;IACjE,gBAAgB,EAAE,0CAA0C,EAAE,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,WAAW,EAAE,sCAAsC,EAAE,CAAC;IACtD,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,+BAA+B,EAAE,MAAM,EAAE,CAAC;IAC1C,iCAAiC,EAAE,MAAM,EAAE,CAAC;IAC5C,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iCAAiC,EAAE,MAAM,EAAE,CAAC;CAC7C,CAAC;AAEF,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,aAAa,EAAE,SAAS,wCAAwC,EAAE,EAClE,QAAQ,EAAE,OAAO,GAChB,sCAAsC,CAwDxC;AAED,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,aAAa,EAAE,SAAS,wCAAwC,EAAE,GACjE,iCAAiC,CA+BnC;AAED,wBAAgB,uDAAuD,CACrE,UAAU,EAAE,sCAAsC,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,kDAAkD,CAChE,KAAK,EAAE,iCAAiC,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB"}

package/dist/tool-runtime.js

@@ -0,0 +1,163 @@
+import { normalizeAssistantWorkflowId, } from "./definition.js";
+import { buildAssistantWorkflowToolPolicyRecommendation, } from "./tool-capabilities.js";
+import { resolveAssistantWorkflowTools, } from "./tool-bindings.js";
+export function resolveAssistantWorkflowToolRuntime(workflow, registrations, toolName) {
+    const normalizedToolName = normalizeAssistantWorkflowId(toolName) ?? "";
+    const staticResolution = resolveAssistantWorkflowTools(workflow, [normalizedToolName]).resolutions[0] ?? null;
+    const registration = findAssistantWorkflowToolRuntimeRegistration(registrations, normalizedToolName);
+    const capability = staticResolution?.capability ?? null;
+    const binding = staticResolution?.binding ?? null;
+    const recommendation = capability
+        ? buildAssistantWorkflowToolPolicyRecommendation(capability)
+        : null;
+    if (!staticResolution) {
+        return {
+            toolName: normalizedToolName,
+            status: "missing-capability",
+            capability,
+            binding,
+            registration,
+            recommendation,
+            policyMismatches: [],
+        };
+    }
+    if (staticResolution.status !== "ready") {
+        return {
+            toolName: normalizedToolName,
+            status: staticResolution.status,
+            capability,
+            binding,
+            registration,
+            recommendation,
+            policyMismatches: [],
+        };
+    }
+    if (!registration) {
+        return {
+            toolName: normalizedToolName,
+            status: "missing-runtime-registration",
+            capability,
+            binding,
+            registration: null,
+            recommendation,
+            policyMismatches: [],
+        };
+    }
+    const policyMismatches = recommendation
+        ? buildPolicyMismatches(recommendation, registration)
+        : [];
+    return {
+        toolName: normalizedToolName,
+        status: policyMismatches.length ? "policy-drift" : "ready",
+        capability,
+        binding,
+        registration,
+        recommendation,
+        policyMismatches,
+    };
+}
+export function buildAssistantWorkflowToolRuntimeAudit(workflow, registrations) {
+    const normalizedRegistrations = normalizeRuntimeRegistrations(registrations);
+    const resolutions = (workflow.tools ?? []).map((tool) => resolveAssistantWorkflowToolRuntime(workflow, normalizedRegistrations.registrations, tool.name));
+    const workflowToolNames = new Set((workflow.tools ?? []).map((tool) => tool.name));
+    const runtimeToolWithoutCapabilityNames = normalizedRegistrations.registrations
+        .map((registration) => registration.name)
+        .filter((toolName) => !workflowToolNames.has(toolName));
+    return {
+        resolutions,
+        registeredToolNames: normalizedRegistrations.registrations.map((registration) => registration.name),
+        readyToolNames: resolutions
+            .filter((resolution) => resolution.status === "ready")
+            .map((resolution) => resolution.toolName),
+        policyDriftToolNames: resolutions
+            .filter((resolution) => resolution.status === "policy-drift")
+            .map((resolution) => resolution.toolName),
+        missingRuntimeRegistrationNames: (workflow.tools ?? [])
+            .map((tool) => tool.name)
+            .filter((toolName) => !normalizedRegistrations.registrations.some((registration) => registration.name === toolName)),
+        runtimeToolWithoutCapabilityNames,
+        missingBindingNames: resolutions
+            .filter((resolution) => resolution.status === "missing-binding")
+            .map((resolution) => resolution.toolName),
+        providerMismatchNames: resolutions
+            .filter((resolution) => resolution.status === "provider-mismatch")
+            .map((resolution) => resolution.toolName),
+        duplicateRuntimeRegistrationNames: normalizedRegistrations.duplicateNames,
+    };
+}
+export function buildAssistantWorkflowToolRuntimeResolutionTracePayload(resolution) {
+    return {
+        toolName: resolution.toolName,
+        status: resolution.status,
+        capabilityProvider: resolution.capability?.provider ?? null,
+        bindingProvider: resolution.binding?.provider ?? null,
+        runtimeAdapterId: resolution.registration?.adapterId ?? null,
+        policyMismatches: resolution.policyMismatches,
+    };
+}
+export function buildAssistantWorkflowToolRuntimeAuditTracePayload(audit) {
+    return {
+        registeredToolCount: audit.registeredToolNames.length,
+        readyToolNames: audit.readyToolNames,
+        policyDriftToolNames: audit.policyDriftToolNames,
+        missingRuntimeRegistrationNames: audit.missingRuntimeRegistrationNames,
+        runtimeToolWithoutCapabilityNames: audit.runtimeToolWithoutCapabilityNames,
+        missingBindingNames: audit.missingBindingNames,
+        providerMismatchNames: audit.providerMismatchNames,
+        duplicateRuntimeRegistrationNames: audit.duplicateRuntimeRegistrationNames,
+    };
+}
+function findAssistantWorkflowToolRuntimeRegistration(registrations, toolName) {
+    if (!toolName)
+        return null;
+    return normalizeRuntimeRegistrations(registrations).registrations
+        .find((registration) => registration.name === toolName) ?? null;
+}
+function normalizeRuntimeRegistrations(registrations) {
+    const normalized = [];
+    const seen = new Set();
+    const duplicateNames = [];
+    for (const registration of registrations) {
+        const name = normalizeAssistantWorkflowId(registration.name);
+        if (!name)
+            continue;
+        if (seen.has(name)) {
+            duplicateNames.push(name);
+            continue;
+        }
+        seen.add(name);
+        normalized.push({
+            name,
+            enabled: registration.enabled === true,
+            assistantVisible: registration.assistantVisible === true,
+            schemaAssistantVisible: registration.schemaAssistantVisible === true,
+            explicitCallAllowed: registration.explicitCallAllowed === true,
+            supportsAssistantVisibility: registration.supportsAssistantVisibility !== false,
+            supportsSchemaAssistantVisibility: registration.supportsSchemaAssistantVisibility !== false,
+            supportsExplicitCall: registration.supportsExplicitCall !== false,
+            adapterId: normalizeNullableString(registration.adapterId),
+        });
+    }
+    return { registrations: normalized, duplicateNames };
+}
+function buildPolicyMismatches(recommendation, registration) {
+    const expected = {
+        enabled: recommendation.enabledByDefault,
+        assistantVisible: recommendation.assistantVisibleByDefault && registration.supportsAssistantVisibility !== false,
+        schemaAssistantVisible: recommendation.schemaAssistantVisibleByDefault && registration.supportsSchemaAssistantVisibility !== false,
+        explicitCallAllowed: recommendation.explicitCallAllowedByDefault && registration.supportsExplicitCall !== false,
+    };
+    const actual = {
+        enabled: registration.enabled,
+        assistantVisible: registration.assistantVisible,
+        schemaAssistantVisible: registration.schemaAssistantVisible,
+        explicitCallAllowed: registration.explicitCallAllowed,
+    };
+    return Object.keys(expected)
+        .filter((field) => expected[field] !== actual[field])
+        .map((field) => ({ field, expected: expected[field], actual: actual[field] }));
+}
+function normalizeNullableString(value) {
+    return typeof value === "string" && value.trim().length ? value.trim() : null;
+}
+//# sourceMappingURL=tool-runtime.js.map