@uns-kit/assistant-workflow 2.0.72

package/dist/memory-policy.js

@@ -0,0 +1,187 @@
+import { findAssistantWorkflowIntent, normalizeAssistantWorkflowId, } from "./definition.js";
+import { applyAssistantWorkflowMemoryPatches, buildAssistantWorkflowMemoryPatchTracePayload, } from "./memory-updates.js";
+export function findAssistantWorkflowMemorySlot(workflow, slotId) {
+    const normalized = normalizeAssistantWorkflowId(slotId);
+    if (!normalized)
+        return null;
+    return (workflow.memorySlots ?? []).find((slot) => slot.id === normalized) ?? null;
+}
+export function buildAssistantWorkflowMemoryPolicy(workflow, intentId) {
+    const intent = findAssistantWorkflowIntent(workflow, intentId);
+    const slotIds = new Set((workflow.memorySlots ?? []).map((slot) => slot.id));
+    const readSlots = filterMemorySlotIds(intent?.memoryPolicy?.read ?? [], slotIds);
+    const writeSlots = filterMemorySlotIds(intent?.memoryPolicy?.write ?? [], slotIds);
+    const injectSlots = filterMemorySlotIds(intent?.memoryPolicy?.inject ?? [], slotIds);
+    const missingMemorySlots = uniqueStrings([
+        ...missingMemorySlotIds(intent?.memoryPolicy?.read ?? [], slotIds),
+        ...missingMemorySlotIds(intent?.memoryPolicy?.write ?? [], slotIds),
+        ...missingMemorySlotIds(intent?.memoryPolicy?.inject ?? [], slotIds),
+    ]);
+    return {
+        readSlots,
+        writeSlots,
+        injectSlots,
+        missingMemorySlots,
+        operationsBySlot: buildOperationsBySlot({ readSlots, writeSlots, injectSlots }),
+    };
+}
+export function buildAssistantWorkflowMemoryInjectionPlan(input) {
+    const snapshot = input.snapshot ?? {};
+    const maxTotalChars = normalizePositiveInteger(input.maxTotalChars);
+    const entries = [];
+    const serializedValues = {};
+    const injectedSlots = [];
+    const missingSnapshotSlots = [];
+    const skippedSlots = [];
+    let totalChars = 0;
+    for (const slotId of input.policy.injectSlots) {
+        const slot = findAssistantWorkflowMemorySlot(input.workflow, slotId);
+        if (!slot)
+            continue;
+        if (!Object.prototype.hasOwnProperty.call(snapshot, slotId)) {
+            missingSnapshotSlots.push(slotId);
+            skippedSlots.push({ slotId, reason: "missing-value" });
+            continue;
+        }
+        const value = snapshot[slotId];
+        const serialized = serializeMemoryValue(value);
+        const slotMaxChars = normalizePositiveInteger(slot.maxChars);
+        const remainingTotalChars = maxTotalChars === null ? null : Math.max(0, maxTotalChars - totalChars);
+        if (remainingTotalChars === 0) {
+            skippedSlots.push({ slotId, reason: "total-char-budget-exceeded" });
+            continue;
+        }
+        const effectiveMaxChars = minPositiveInteger(slotMaxChars, remainingTotalChars);
+        const bounded = boundSerializedMemoryValue(serialized, effectiveMaxChars);
+        entries.push({
+            slotId,
+            storage: slot.storage,
+            profileField: slot.profileField ?? null,
+            value,
+            serializedValue: bounded.value,
+            charCount: bounded.value.length,
+            truncated: bounded.truncated,
+            maxChars: effectiveMaxChars,
+        });
+        serializedValues[slotId] = bounded.value;
+        injectedSlots.push(slotId);
+        totalChars += bounded.value.length;
+    }
+    return {
+        entries,
+        serializedValues,
+        injectedSlots,
+        missingSnapshotSlots,
+        skippedSlots,
+        totalChars,
+    };
+}
+export function buildAssistantWorkflowMemoryInjectionTracePayload(plan) {
+    return {
+        injectedSlots: plan.injectedSlots,
+        missingSnapshotSlots: plan.missingSnapshotSlots,
+        skippedSlots: plan.skippedSlots,
+        totalChars: plan.totalChars,
+        entries: plan.entries.map((entry) => ({
+            slotId: entry.slotId,
+            storage: entry.storage,
+            profileField: entry.profileField,
+            charCount: entry.charCount,
+            truncated: entry.truncated,
+            maxChars: entry.maxChars,
+        })),
+    };
+}
+export function applyAssistantWorkflowIntentMemoryPatches(input) {
+    const intentId = normalizeAssistantWorkflowId(input.intentId);
+    const policy = buildAssistantWorkflowMemoryPolicy(input.workflow, intentId);
+    const memoryResult = applyAssistantWorkflowMemoryPatches(input.snapshot, input.patches, input.workflow, { allowedSlotIds: policy.writeSlots });
+    return { intentId, policy, memoryResult };
+}
+export function buildAssistantWorkflowIntentMemoryPatchTracePayload(result) {
+    return {
+        intentId: result.intentId,
+        writeSlots: result.policy.writeSlots,
+        missingMemorySlots: result.policy.missingMemorySlots,
+        ...buildAssistantWorkflowMemoryPatchTracePayload(result.memoryResult),
+    };
+}
+function filterMemorySlotIds(rawSlots, availableSlots) {
+    const out = [];
+    const seen = new Set();
+    for (const rawSlot of rawSlots) {
+        const slot = normalizeAssistantWorkflowId(rawSlot);
+        if (!slot || seen.has(slot))
+            continue;
+        if (availableSlots.size > 0 && !availableSlots.has(slot))
+            continue;
+        seen.add(slot);
+        out.push(slot);
+    }
+    return out;
+}
+function serializeMemoryValue(value) {
+    if (typeof value === "string")
+        return value;
+    try {
+        return JSON.stringify(value) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function boundSerializedMemoryValue(value, maxChars) {
+    if (maxChars === null || value.length <= maxChars) {
+        return { value, truncated: false };
+    }
+    return { value: value.slice(0, maxChars), truncated: true };
+}
+function normalizePositiveInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : null;
+}
+function minPositiveInteger(left, right) {
+    if (left === null)
+        return right;
+    if (right === null)
+        return left;
+    return Math.min(left, right);
+}
+function missingMemorySlotIds(rawSlots, availableSlots) {
+    if (availableSlots.size === 0)
+        return [];
+    const out = [];
+    for (const rawSlot of rawSlots) {
+        const slot = normalizeAssistantWorkflowId(rawSlot);
+        if (slot && !availableSlots.has(slot))
+            out.push(slot);
+    }
+    return uniqueStrings(out);
+}
+function buildOperationsBySlot(policy) {
+    const out = {};
+    for (const slot of policy.readSlots)
+        addOperation(out, slot, "read");
+    for (const slot of policy.writeSlots)
+        addOperation(out, slot, "write");
+    for (const slot of policy.injectSlots)
+        addOperation(out, slot, "inject");
+    return out;
+}
+function addOperation(target, slot, operation) {
+    const current = target[slot] ?? [];
+    if (!current.includes(operation)) {
+        target[slot] = [...current, operation];
+    }
+}
+function uniqueStrings(values) {
+    const out = [];
+    const seen = new Set();
+    for (const value of values) {
+        if (seen.has(value))
+            continue;
+        seen.add(value);
+        out.push(value);
+    }
+    return out;
+}
+//# sourceMappingURL=memory-policy.js.map

package/dist/memory-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-policy.js","sourceRoot":"","sources":["../src/memory-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,GAI7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,mCAAmC,EACnC,6CAA6C,GAK9C,MAAM,qBAAqB,CAAC;AAuD7B,MAAM,UAAU,+BAA+B,CAC7C,QAAqE,EACrE,MAAe;IAEf,MAAM,UAAU,GAAG,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,IAAI,IAAI,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,QAAqE,EACrE,QAAiB;IAEjB,MAAM,MAAM,GAAG,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACjF,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACrF,MAAM,kBAAkB,GAAG,aAAa,CAAC;QACvC,GAAG,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC;QAClE,GAAG,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC;QACnE,GAAG,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC;KACrE,CAAC,CAAC;IAEH,OAAO;QACL,SAAS;QACT,UAAU;QACV,WAAW;QACX,kBAAkB;QAClB,gBAAgB,EAAE,qBAAqB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;KAChF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yCAAyC,CACvD,KAAgD;IAEhD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,aAAa,GAAG,wBAAwB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACpE,MAAM,OAAO,GAA4C,EAAE,CAAC;IAC5D,MAAM,gBAAgB,GAA2B,EAAE,CAAC;IACpD,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,oBAAoB,GAAa,EAAE,CAAC;IAC1C,MAAM,YAAY,GAA8C,EAAE,CAAC;IACnE,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,+BAA+B,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;YAC5D,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClC,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;YACvD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAiC,CAAC;QAC/D,MAAM,UAAU,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7D,MAAM,mBAAmB,GAAG,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC,CAAC;QACpG,IAAI,mBAAmB,KAAK,CAAC,EAAE,CAAC;YAC9B,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC,CAAC;YACpE,SAAS;QACX,CAAC;QACD,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;QAChF,MAAM,OAAO,GAAG,0BAA0B,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC;YACX,MAAM;YACN,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI;YACvC,KAAK;YACL,eAAe,EAAE,OAAO,CAAC,KAAK;YAC9B,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;YAC/B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,iBAAiB;SAC5B,CAAC,CAAC;QACH,gBAAgB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QACzC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3B,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;IACrC,CAAC;IAED,OAAO;QACL,OAAO;QACP,gBAAgB;QAChB,aAAa;QACb,oBAAoB;QACpB,YAAY;QACZ,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iDAAiD,CAC/D,IAA0C;IAE1C,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;QAC/C,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACpC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yCAAyC,CACvD,KAA8C;IAE9C,MAAM,QAAQ,GAAG,4BAA4B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,kCAAkC,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,mCAAmC,CACtD,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,QAAQ,EACd,EAAE,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,CACtC,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mDAAmD,CACjE,MAAgD;IAEhD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;QACpC,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB;QACpD,GAAG,6CAA6C,CAAC,MAAM,CAAC,YAAY,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,QAA2B,EAAE,cAAmC;IAC3F,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACtC,IAAI,cAAc,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACnE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAmC;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAa,EAAE,QAAuB;IACxE,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAyB;IACzD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1F,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAmB,EAAE,KAAoB;IACnE,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,oBAAoB,CAAC,QAA2B,EAAE,cAAmC;IAC5F,IAAI,cAAc,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,qBAAqB,CAAC,MAI9B;IACC,MAAM,GAAG,GAAuD,EAAE,CAAC;IACnE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,SAAS;QAAE,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU;QAAE,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW;QAAE,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CACnB,MAA0D,EAC1D,IAAY,EACZ,SAA2C;IAE3C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAyB;IAC9C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import {\n  findAssistantWorkflowIntent,\n  normalizeAssistantWorkflowId,\n  type AssistantWorkflowDefinition,\n  type AssistantWorkflowMemoryOperation,\n  type AssistantWorkflowMemorySlotDefinition,\n} from \"./definition.js\";\nimport {\n  applyAssistantWorkflowMemoryPatches,\n  buildAssistantWorkflowMemoryPatchTracePayload,\n  type AssistantWorkflowMemoryPatch,\n  type AssistantWorkflowMemoryPatchResult,\n  type AssistantWorkflowMemorySnapshot,\n  type AssistantWorkflowMemoryValue,\n} from \"./memory-updates.js\";\n\nexport type AssistantWorkflowResolvedMemoryPolicy = {\n  readSlots: string[];\n  writeSlots: string[];\n  injectSlots: string[];\n  missingMemorySlots: string[];\n  operationsBySlot: Record<string, AssistantWorkflowMemoryOperation[]>;\n};\n\nexport type AssistantWorkflowMemoryInjectionEntry = {\n  slotId: string;\n  storage: string;\n  profileField: string | null;\n  value: AssistantWorkflowMemoryValue;\n  serializedValue: string;\n  charCount: number;\n  truncated: boolean;\n  maxChars: number | null;\n};\n\nexport type AssistantWorkflowSkippedMemoryInjection = {\n  slotId: string;\n  reason: \"missing-value\" | \"total-char-budget-exceeded\";\n};\n\nexport type AssistantWorkflowMemoryInjectionPlan = {\n  entries: AssistantWorkflowMemoryInjectionEntry[];\n  serializedValues: Record<string, string>;\n  injectedSlots: string[];\n  missingSnapshotSlots: string[];\n  skippedSlots: AssistantWorkflowSkippedMemoryInjection[];\n  totalChars: number;\n};\n\nexport type AssistantWorkflowMemoryInjectionPlanInput = {\n  workflow: AssistantWorkflowDefinition<string, string, string, string>;\n  policy: AssistantWorkflowResolvedMemoryPolicy;\n  snapshot?: AssistantWorkflowMemorySnapshot | null;\n  maxTotalChars?: number;\n};\n\nexport type AssistantWorkflowIntentMemoryPatchInput = {\n  workflow: AssistantWorkflowDefinition<string, string, string, string>;\n  intentId: unknown;\n  snapshot?: AssistantWorkflowMemorySnapshot | null;\n  patches: readonly AssistantWorkflowMemoryPatch[];\n};\n\nexport type AssistantWorkflowIntentMemoryPatchResult = {\n  intentId: string | null;\n  policy: AssistantWorkflowResolvedMemoryPolicy;\n  memoryResult: AssistantWorkflowMemoryPatchResult;\n};\n\nexport function findAssistantWorkflowMemorySlot(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  slotId: unknown,\n): AssistantWorkflowMemorySlotDefinition | null {\n  const normalized = normalizeAssistantWorkflowId(slotId);\n  if (!normalized) return null;\n  return (workflow.memorySlots ?? []).find((slot) => slot.id === normalized) ?? null;\n}\n\nexport function buildAssistantWorkflowMemoryPolicy(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  intentId: unknown,\n): AssistantWorkflowResolvedMemoryPolicy {\n  const intent = findAssistantWorkflowIntent(workflow, intentId);\n  const slotIds = new Set((workflow.memorySlots ?? []).map((slot) => slot.id));\n  const readSlots = filterMemorySlotIds(intent?.memoryPolicy?.read ?? [], slotIds);\n  const writeSlots = filterMemorySlotIds(intent?.memoryPolicy?.write ?? [], slotIds);\n  const injectSlots = filterMemorySlotIds(intent?.memoryPolicy?.inject ?? [], slotIds);\n  const missingMemorySlots = uniqueStrings([\n    ...missingMemorySlotIds(intent?.memoryPolicy?.read ?? [], slotIds),\n    ...missingMemorySlotIds(intent?.memoryPolicy?.write ?? [], slotIds),\n    ...missingMemorySlotIds(intent?.memoryPolicy?.inject ?? [], slotIds),\n  ]);\n\n  return {\n    readSlots,\n    writeSlots,\n    injectSlots,\n    missingMemorySlots,\n    operationsBySlot: buildOperationsBySlot({ readSlots, writeSlots, injectSlots }),\n  };\n}\n\nexport function buildAssistantWorkflowMemoryInjectionPlan(\n  input: AssistantWorkflowMemoryInjectionPlanInput,\n): AssistantWorkflowMemoryInjectionPlan {\n  const snapshot = input.snapshot ?? {};\n  const maxTotalChars = normalizePositiveInteger(input.maxTotalChars);\n  const entries: AssistantWorkflowMemoryInjectionEntry[] = [];\n  const serializedValues: Record<string, string> = {};\n  const injectedSlots: string[] = [];\n  const missingSnapshotSlots: string[] = [];\n  const skippedSlots: AssistantWorkflowSkippedMemoryInjection[] = [];\n  let totalChars = 0;\n\n  for (const slotId of input.policy.injectSlots) {\n    const slot = findAssistantWorkflowMemorySlot(input.workflow, slotId);\n    if (!slot) continue;\n    if (!Object.prototype.hasOwnProperty.call(snapshot, slotId)) {\n      missingSnapshotSlots.push(slotId);\n      skippedSlots.push({ slotId, reason: \"missing-value\" });\n      continue;\n    }\n    const value = snapshot[slotId] as AssistantWorkflowMemoryValue;\n    const serialized = serializeMemoryValue(value);\n    const slotMaxChars = normalizePositiveInteger(slot.maxChars);\n    const remainingTotalChars = maxTotalChars === null ? null : Math.max(0, maxTotalChars - totalChars);\n    if (remainingTotalChars === 0) {\n      skippedSlots.push({ slotId, reason: \"total-char-budget-exceeded\" });\n      continue;\n    }\n    const effectiveMaxChars = minPositiveInteger(slotMaxChars, remainingTotalChars);\n    const bounded = boundSerializedMemoryValue(serialized, effectiveMaxChars);\n    entries.push({\n      slotId,\n      storage: slot.storage,\n      profileField: slot.profileField ?? null,\n      value,\n      serializedValue: bounded.value,\n      charCount: bounded.value.length,\n      truncated: bounded.truncated,\n      maxChars: effectiveMaxChars,\n    });\n    serializedValues[slotId] = bounded.value;\n    injectedSlots.push(slotId);\n    totalChars += bounded.value.length;\n  }\n\n  return {\n    entries,\n    serializedValues,\n    injectedSlots,\n    missingSnapshotSlots,\n    skippedSlots,\n    totalChars,\n  };\n}\n\nexport function buildAssistantWorkflowMemoryInjectionTracePayload(\n  plan: AssistantWorkflowMemoryInjectionPlan,\n): Record<string, unknown> {\n  return {\n    injectedSlots: plan.injectedSlots,\n    missingSnapshotSlots: plan.missingSnapshotSlots,\n    skippedSlots: plan.skippedSlots,\n    totalChars: plan.totalChars,\n    entries: plan.entries.map((entry) => ({\n      slotId: entry.slotId,\n      storage: entry.storage,\n      profileField: entry.profileField,\n      charCount: entry.charCount,\n      truncated: entry.truncated,\n      maxChars: entry.maxChars,\n    })),\n  };\n}\n\nexport function applyAssistantWorkflowIntentMemoryPatches(\n  input: AssistantWorkflowIntentMemoryPatchInput,\n): AssistantWorkflowIntentMemoryPatchResult {\n  const intentId = normalizeAssistantWorkflowId(input.intentId);\n  const policy = buildAssistantWorkflowMemoryPolicy(input.workflow, intentId);\n  const memoryResult = applyAssistantWorkflowMemoryPatches(\n    input.snapshot,\n    input.patches,\n    input.workflow,\n    { allowedSlotIds: policy.writeSlots },\n  );\n  return { intentId, policy, memoryResult };\n}\n\nexport function buildAssistantWorkflowIntentMemoryPatchTracePayload(\n  result: AssistantWorkflowIntentMemoryPatchResult,\n): Record<string, unknown> {\n  return {\n    intentId: result.intentId,\n    writeSlots: result.policy.writeSlots,\n    missingMemorySlots: result.policy.missingMemorySlots,\n    ...buildAssistantWorkflowMemoryPatchTracePayload(result.memoryResult),\n  };\n}\n\nfunction filterMemorySlotIds(rawSlots: readonly string[], availableSlots: ReadonlySet<string>): string[] {\n  const out: string[] = [];\n  const seen = new Set<string>();\n  for (const rawSlot of rawSlots) {\n    const slot = normalizeAssistantWorkflowId(rawSlot);\n    if (!slot || seen.has(slot)) continue;\n    if (availableSlots.size > 0 && !availableSlots.has(slot)) continue;\n    seen.add(slot);\n    out.push(slot);\n  }\n  return out;\n}\n\nfunction serializeMemoryValue(value: AssistantWorkflowMemoryValue): string {\n  if (typeof value === \"string\") return value;\n  try {\n    return JSON.stringify(value) ?? String(value);\n  } catch {\n    return String(value);\n  }\n}\n\nfunction boundSerializedMemoryValue(value: string, maxChars: number | null): { value: string; truncated: boolean } {\n  if (maxChars === null || value.length <= maxChars) {\n    return { value, truncated: false };\n  }\n  return { value: value.slice(0, maxChars), truncated: true };\n}\n\nfunction normalizePositiveInteger(value: number | undefined): number | null {\n  return typeof value === \"number\" && Number.isInteger(value) && value > 0 ? value : null;\n}\n\nfunction minPositiveInteger(left: number | null, right: number | null): number | null {\n  if (left === null) return right;\n  if (right === null) return left;\n  return Math.min(left, right);\n}\n\nfunction missingMemorySlotIds(rawSlots: readonly string[], availableSlots: ReadonlySet<string>): string[] {\n  if (availableSlots.size === 0) return [];\n  const out: string[] = [];\n  for (const rawSlot of rawSlots) {\n    const slot = normalizeAssistantWorkflowId(rawSlot);\n    if (slot && !availableSlots.has(slot)) out.push(slot);\n  }\n  return uniqueStrings(out);\n}\n\nfunction buildOperationsBySlot(policy: {\n  readSlots: readonly string[];\n  writeSlots: readonly string[];\n  injectSlots: readonly string[];\n}): Record<string, AssistantWorkflowMemoryOperation[]> {\n  const out: Record<string, AssistantWorkflowMemoryOperation[]> = {};\n  for (const slot of policy.readSlots) addOperation(out, slot, \"read\");\n  for (const slot of policy.writeSlots) addOperation(out, slot, \"write\");\n  for (const slot of policy.injectSlots) addOperation(out, slot, \"inject\");\n  return out;\n}\n\nfunction addOperation(\n  target: Record<string, AssistantWorkflowMemoryOperation[]>,\n  slot: string,\n  operation: AssistantWorkflowMemoryOperation,\n): void {\n  const current = target[slot] ?? [];\n  if (!current.includes(operation)) {\n    target[slot] = [...current, operation];\n  }\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    if (seen.has(value)) continue;\n    seen.add(value);\n    out.push(value);\n  }\n  return out;\n}\n"]}

package/dist/memory-updates.d.ts

@@ -0,0 +1,39 @@
+import { type AssistantWorkflowDefinition } from "./definition.js";
+export type AssistantWorkflowMemoryValue = null | string | number | boolean | readonly AssistantWorkflowMemoryValue[] | {
+    readonly [key: string]: AssistantWorkflowMemoryValue;
+};
+export type AssistantWorkflowMemorySnapshot = Record<string, AssistantWorkflowMemoryValue>;
+export type AssistantWorkflowMemoryPatchOperation = "set" | "append" | "clear";
+export type AssistantWorkflowMemoryPatchSource = "planner" | "tool" | "runtime" | "user" | "system";
+export type AssistantWorkflowMemoryPatch = {
+    slotId: string;
+    operation: AssistantWorkflowMemoryPatchOperation;
+    value?: AssistantWorkflowMemoryValue;
+    source?: AssistantWorkflowMemoryPatchSource;
+    reason?: string;
+    maxItems?: number;
+};
+export type AssistantWorkflowAppliedMemoryPatch = {
+    slotId: string;
+    operation: AssistantWorkflowMemoryPatchOperation;
+    changed: boolean;
+};
+export type AssistantWorkflowSkippedMemoryPatchReason = "invalid-slot" | "unknown-slot" | "missing-value" | "write-not-allowed";
+export type AssistantWorkflowSkippedMemoryPatch = {
+    slotId: string | null;
+    operation: AssistantWorkflowMemoryPatchOperation | null;
+    reason: AssistantWorkflowSkippedMemoryPatchReason;
+};
+export type AssistantWorkflowMemoryPatchResult = {
+    snapshot: AssistantWorkflowMemorySnapshot;
+    appliedPatches: AssistantWorkflowAppliedMemoryPatch[];
+    skippedPatches: AssistantWorkflowSkippedMemoryPatch[];
+    changedSlots: string[];
+};
+export type AssistantWorkflowMemoryPatchApplyOptions = {
+    allowedSlotIds?: readonly string[] | null;
+};
+export declare function buildAssistantWorkflowMemoryPatch(slotId: string, operation: AssistantWorkflowMemoryPatchOperation, options?: Omit<AssistantWorkflowMemoryPatch, "slotId" | "operation">): AssistantWorkflowMemoryPatch;
+export declare function applyAssistantWorkflowMemoryPatches(snapshot: AssistantWorkflowMemorySnapshot | null | undefined, patches: readonly AssistantWorkflowMemoryPatch[], workflow?: AssistantWorkflowDefinition<string, string, string, string>, options?: AssistantWorkflowMemoryPatchApplyOptions): AssistantWorkflowMemoryPatchResult;
+export declare function buildAssistantWorkflowMemoryPatchTracePayload(result: AssistantWorkflowMemoryPatchResult): Record<string, unknown>;
+//# sourceMappingURL=memory-updates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-updates.d.ts","sourceRoot":"","sources":["../src/memory-updates.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,4BAA4B,GACpC,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,4BAA4B,EAAE,GACvC;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,4BAA4B,CAAA;CAAE,CAAC;AAE7D,MAAM,MAAM,+BAA+B,GAAG,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;AAE3F,MAAM,MAAM,qCAAqC,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/E,MAAM,MAAM,kCAAkC,GAC1C,SAAS,GACT,MAAM,GACN,SAAS,GACT,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,qCAAqC,CAAC;IACjD,KAAK,CAAC,EAAE,4BAA4B,CAAC;IACrC,MAAM,CAAC,EAAE,kCAAkC,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,qCAAqC,CAAC;IACjD,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,yCAAyC,GACjD,cAAc,GACd,cAAc,GACd,eAAe,GACf,mBAAmB,CAAC;AAExB,MAAM,MAAM,mCAAmC,GAAG;IAChD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,qCAAqC,GAAG,IAAI,CAAC;IACxD,MAAM,EAAE,yCAAyC,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,cAAc,EAAE,mCAAmC,EAAE,CAAC;IACtD,cAAc,EAAE,mCAAmC,EAAE,CAAC;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wCAAwC,GAAG;IACrD,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CAC3C,CAAC;AAEF,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,qCAAqC,EAChD,OAAO,GAAE,IAAI,CAAC,4BAA4B,EAAE,QAAQ,GAAG,WAAW,CAAM,GACvE,4BAA4B,CAa9B;AAED,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,+BAA+B,GAAG,IAAI,GAAG,SAAS,EAC5D,OAAO,EAAE,SAAS,4BAA4B,EAAE,EAChD,QAAQ,CAAC,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACtE,OAAO,GAAE,wCAA6C,GACrD,kCAAkC,CA8CpC;AAED,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,kCAAkC,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}

package/dist/memory-updates.js

@@ -0,0 +1,110 @@
+import { normalizeAssistantWorkflowId, } from "./definition.js";
+export function buildAssistantWorkflowMemoryPatch(slotId, operation, options = {}) {
+    const normalizedSlotId = normalizeAssistantWorkflowId(slotId);
+    if (!normalizedSlotId) {
+        throw new Error("Assistant workflow memory patch slotId is required.");
+    }
+    if ((operation === "set" || operation === "append") && !("value" in options)) {
+        throw new Error(`Assistant workflow memory patch ${operation} requires a value.`);
+    }
+    return {
+        slotId: normalizedSlotId,
+        operation,
+        ...options,
+    };
+}
+export function applyAssistantWorkflowMemoryPatches(snapshot, patches, workflow, options = {}) {
+    let next = { ...(snapshot ?? {}) };
+    const appliedPatches = [];
+    const skippedPatches = [];
+    const changedSlots = [];
+    const knownSlots = workflow ? new Set((workflow.memorySlots ?? []).map((slot) => slot.id)) : null;
+    const allowedSlots = normalizeAllowedSlotIds(options.allowedSlotIds);
+    for (const patch of patches) {
+        const slotId = normalizeAssistantWorkflowId(patch.slotId);
+        if (!slotId) {
+            skippedPatches.push({
+                slotId: null,
+                operation: patch.operation ?? null,
+                reason: "invalid-slot",
+            });
+            continue;
+        }
+        if (knownSlots && knownSlots.size > 0 && !knownSlots.has(slotId)) {
+            skippedPatches.push({ slotId, operation: patch.operation, reason: "unknown-slot" });
+            continue;
+        }
+        if (allowedSlots && !allowedSlots.has(slotId)) {
+            skippedPatches.push({ slotId, operation: patch.operation, reason: "write-not-allowed" });
+            continue;
+        }
+        if ((patch.operation === "set" || patch.operation === "append") && !("value" in patch)) {
+            skippedPatches.push({ slotId, operation: patch.operation, reason: "missing-value" });
+            continue;
+        }
+        const before = next[slotId];
+        next = applyMemoryPatch(next, slotId, patch);
+        const changed = !memoryValuesEqual(before, next[slotId]);
+        appliedPatches.push({ slotId, operation: patch.operation, changed });
+        if (changed && !changedSlots.includes(slotId)) {
+            changedSlots.push(slotId);
+        }
+    }
+    return {
+        snapshot: next,
+        appliedPatches,
+        skippedPatches,
+        changedSlots,
+    };
+}
+export function buildAssistantWorkflowMemoryPatchTracePayload(result) {
+    return {
+        changedSlots: result.changedSlots,
+        appliedPatchCount: result.appliedPatches.length,
+        skippedPatchCount: result.skippedPatches.length,
+        appliedPatches: result.appliedPatches,
+        skippedPatches: result.skippedPatches,
+    };
+}
+function applyMemoryPatch(snapshot, slotId, patch) {
+    switch (patch.operation) {
+        case "set":
+            return { ...snapshot, [slotId]: patch.value };
+        case "append":
+            return {
+                ...snapshot,
+                [slotId]: appendMemoryValue(snapshot[slotId], patch.value, patch.maxItems),
+            };
+        case "clear": {
+            const { [slotId]: _removed, ...rest } = snapshot;
+            return rest;
+        }
+    }
+}
+function appendMemoryValue(existing, value, maxItems) {
+    const current = Array.isArray(existing)
+        ? [...existing]
+        : existing === undefined || existing === null
+            ? []
+            : [existing];
+    const next = [...current, value];
+    if (typeof maxItems === "number" && Number.isInteger(maxItems) && maxItems > 0) {
+        return next.slice(-maxItems);
+    }
+    return next;
+}
+function memoryValuesEqual(left, right) {
+    return JSON.stringify(left ?? null) === JSON.stringify(right ?? null);
+}
+function normalizeAllowedSlotIds(value) {
+    if (value === null || value === undefined)
+        return null;
+    const allowed = new Set();
+    for (const rawSlotId of value) {
+        const slotId = normalizeAssistantWorkflowId(rawSlotId);
+        if (slotId)
+            allowed.add(slotId);
+    }
+    return allowed;
+}
+//# sourceMappingURL=memory-updates.js.map

package/dist/memory-updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-updates.js","sourceRoot":"","sources":["../src/memory-updates.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  normalizeAssistantWorkflowId,\n  type AssistantWorkflowDefinition,\n} from \"./definition.js\";\n\nexport type AssistantWorkflowMemoryValue =\n  | null\n  | string\n  | number\n  | boolean\n  | readonly AssistantWorkflowMemoryValue[]\n  | { readonly [key: string]: AssistantWorkflowMemoryValue };\n\nexport type AssistantWorkflowMemorySnapshot = Record<string, AssistantWorkflowMemoryValue>;\n\nexport type AssistantWorkflowMemoryPatchOperation = \"set\" | \"append\" | \"clear\";\n\nexport type AssistantWorkflowMemoryPatchSource =\n  | \"planner\"\n  | \"tool\"\n  | \"runtime\"\n  | \"user\"\n  | \"system\";\n\nexport type AssistantWorkflowMemoryPatch = {\n  slotId: string;\n  operation: AssistantWorkflowMemoryPatchOperation;\n  value?: AssistantWorkflowMemoryValue;\n  source?: AssistantWorkflowMemoryPatchSource;\n  reason?: string;\n  maxItems?: number;\n};\n\nexport type AssistantWorkflowAppliedMemoryPatch = {\n  slotId: string;\n  operation: AssistantWorkflowMemoryPatchOperation;\n  changed: boolean;\n};\n\nexport type AssistantWorkflowSkippedMemoryPatchReason =\n  | \"invalid-slot\"\n  | \"unknown-slot\"\n  | \"missing-value\"\n  | \"write-not-allowed\";\n\nexport type AssistantWorkflowSkippedMemoryPatch = {\n  slotId: string | null;\n  operation: AssistantWorkflowMemoryPatchOperation | null;\n  reason: AssistantWorkflowSkippedMemoryPatchReason;\n};\n\nexport type AssistantWorkflowMemoryPatchResult = {\n  snapshot: AssistantWorkflowMemorySnapshot;\n  appliedPatches: AssistantWorkflowAppliedMemoryPatch[];\n  skippedPatches: AssistantWorkflowSkippedMemoryPatch[];\n  changedSlots: string[];\n};\n\nexport type AssistantWorkflowMemoryPatchApplyOptions = {\n  allowedSlotIds?: readonly string[] | null;\n};\n\nexport function buildAssistantWorkflowMemoryPatch(\n  slotId: string,\n  operation: AssistantWorkflowMemoryPatchOperation,\n  options: Omit<AssistantWorkflowMemoryPatch, \"slotId\" | \"operation\"> = {},\n): AssistantWorkflowMemoryPatch {\n  const normalizedSlotId = normalizeAssistantWorkflowId(slotId);\n  if (!normalizedSlotId) {\n    throw new Error(\"Assistant workflow memory patch slotId is required.\");\n  }\n  if ((operation === \"set\" || operation === \"append\") && !(\"value\" in options)) {\n    throw new Error(`Assistant workflow memory patch ${operation} requires a value.`);\n  }\n  return {\n    slotId: normalizedSlotId,\n    operation,\n    ...options,\n  };\n}\n\nexport function applyAssistantWorkflowMemoryPatches(\n  snapshot: AssistantWorkflowMemorySnapshot | null | undefined,\n  patches: readonly AssistantWorkflowMemoryPatch[],\n  workflow?: AssistantWorkflowDefinition<string, string, string, string>,\n  options: AssistantWorkflowMemoryPatchApplyOptions = {},\n): AssistantWorkflowMemoryPatchResult {\n  let next: AssistantWorkflowMemorySnapshot = { ...(snapshot ?? {}) };\n  const appliedPatches: AssistantWorkflowAppliedMemoryPatch[] = [];\n  const skippedPatches: AssistantWorkflowSkippedMemoryPatch[] = [];\n  const changedSlots: string[] = [];\n  const knownSlots = workflow ? new Set((workflow.memorySlots ?? []).map((slot) => slot.id)) : null;\n  const allowedSlots = normalizeAllowedSlotIds(options.allowedSlotIds);\n\n  for (const patch of patches) {\n    const slotId = normalizeAssistantWorkflowId(patch.slotId);\n    if (!slotId) {\n      skippedPatches.push({\n        slotId: null,\n        operation: patch.operation ?? null,\n        reason: \"invalid-slot\",\n      });\n      continue;\n    }\n    if (knownSlots && knownSlots.size > 0 && !knownSlots.has(slotId)) {\n      skippedPatches.push({ slotId, operation: patch.operation, reason: \"unknown-slot\" });\n      continue;\n    }\n    if (allowedSlots && !allowedSlots.has(slotId)) {\n      skippedPatches.push({ slotId, operation: patch.operation, reason: \"write-not-allowed\" });\n      continue;\n    }\n    if ((patch.operation === \"set\" || patch.operation === \"append\") && !(\"value\" in patch)) {\n      skippedPatches.push({ slotId, operation: patch.operation, reason: \"missing-value\" });\n      continue;\n    }\n\n    const before = next[slotId];\n    next = applyMemoryPatch(next, slotId, patch);\n    const changed = !memoryValuesEqual(before, next[slotId]);\n    appliedPatches.push({ slotId, operation: patch.operation, changed });\n    if (changed && !changedSlots.includes(slotId)) {\n      changedSlots.push(slotId);\n    }\n  }\n\n  return {\n    snapshot: next,\n    appliedPatches,\n    skippedPatches,\n    changedSlots,\n  };\n}\n\nexport function buildAssistantWorkflowMemoryPatchTracePayload(\n  result: AssistantWorkflowMemoryPatchResult,\n): Record<string, unknown> {\n  return {\n    changedSlots: result.changedSlots,\n    appliedPatchCount: result.appliedPatches.length,\n    skippedPatchCount: result.skippedPatches.length,\n    appliedPatches: result.appliedPatches,\n    skippedPatches: result.skippedPatches,\n  };\n}\n\nfunction applyMemoryPatch(\n  snapshot: AssistantWorkflowMemorySnapshot,\n  slotId: string,\n  patch: AssistantWorkflowMemoryPatch,\n): AssistantWorkflowMemorySnapshot {\n  switch (patch.operation) {\n    case \"set\":\n      return { ...snapshot, [slotId]: patch.value as AssistantWorkflowMemoryValue };\n    case \"append\":\n      return {\n        ...snapshot,\n        [slotId]: appendMemoryValue(snapshot[slotId], patch.value as AssistantWorkflowMemoryValue, patch.maxItems),\n      };\n    case \"clear\": {\n      const { [slotId]: _removed, ...rest } = snapshot;\n      return rest;\n    }\n  }\n}\n\nfunction appendMemoryValue(\n  existing: AssistantWorkflowMemoryValue | undefined,\n  value: AssistantWorkflowMemoryValue,\n  maxItems: number | undefined,\n): AssistantWorkflowMemoryValue[] {\n  const current = Array.isArray(existing)\n    ? [...existing]\n    : existing === undefined || existing === null\n      ? []\n      : [existing];\n  const next = [...current, value];\n  if (typeof maxItems === \"number\" && Number.isInteger(maxItems) && maxItems > 0) {\n    return next.slice(-maxItems);\n  }\n  return next;\n}\n\nfunction memoryValuesEqual(\n  left: AssistantWorkflowMemoryValue | undefined,\n  right: AssistantWorkflowMemoryValue | undefined,\n): boolean {\n  return JSON.stringify(left ?? null) === JSON.stringify(right ?? null);\n}\n\nfunction normalizeAllowedSlotIds(value: readonly string[] | null | undefined): Set<string> | null {\n  if (value === null || value === undefined) return null;\n  const allowed = new Set<string>();\n  for (const rawSlotId of value) {\n    const slotId = normalizeAssistantWorkflowId(rawSlotId);\n    if (slotId) allowed.add(slotId);\n  }\n  return allowed;\n}\n"]}

package/dist/outcome-trace.d.ts

@@ -0,0 +1,79 @@
+import { type AssistantWorkflowDirectRouteOutcomeRouteSource, type AssistantWorkflowOutcome, type AssistantWorkflowOutcomeDelivery } from "./outcome.js";
+export type AssistantWorkflowFinalTextOutcomeTraceInput = {
+    content: string;
+    delivery?: AssistantWorkflowOutcomeDelivery;
+    source?: string;
+    layer?: string;
+    mode?: string;
+    streamed?: boolean;
+};
+export type AssistantWorkflowStructuredArtifactOutcomeTraceInput = {
+    content: string;
+    artifactKind: string;
+    source?: string;
+    layer?: string;
+    mode?: string;
+    submode?: string;
+    tool?: string;
+    streamed?: boolean;
+};
+export type AssistantWorkflowUnavailableOutcomeTraceInput = {
+    artifactKind: string;
+    reason: string;
+    /** Artifact kinds that cannot be produced because this prerequisite is unavailable. */
+    blockedArtifactKinds?: readonly string[];
+    content?: string;
+    source?: string;
+    layer?: string;
+    mode?: string;
+    tool?: string;
+};
+export type AssistantWorkflowClarificationOutcomeTraceInput = {
+    content: string;
+    ruleId?: string;
+    source?: string;
+    layer?: string;
+    mode?: string;
+    streamed?: boolean;
+};
+export type AssistantWorkflowDegradedOutcomeTraceInput = {
+    content: string;
+    reason: string;
+    source?: string;
+    layer?: string;
+    mode?: string;
+    hasToolResults?: boolean;
+    toolCount?: number;
+    structuredBlockKinds?: string[];
+    streamed?: boolean;
+};
+/**
+ * The host's minimal direct-route identity. The core deliberately accepts
+ * legacy trace metadata so applications can migrate outcome reporting before
+ * their route registry is fully workflow-authored.
+ */
+export type AssistantWorkflowDirectRouteOutcomeTraceEntry = {
+    layer: string;
+    skipEvent?: string | null;
+    traceRoute?: string | null;
+    workflowInvocation?: AssistantWorkflowDirectRouteOutcomeRouteSource | null;
+};
+export type AssistantWorkflowDirectRouteOutcomeInput = {
+    handled: boolean;
+    content?: string;
+    artifactKind?: string;
+    payload?: unknown;
+    reason?: string;
+    delivery?: AssistantWorkflowOutcomeDelivery;
+};
+export declare function buildAssistantWorkflowFinalTextOutcomeTracePayload(input: AssistantWorkflowFinalTextOutcomeTraceInput): Record<string, unknown>;
+export declare function buildAssistantWorkflowStructuredArtifactOutcomeTracePayload(input: AssistantWorkflowStructuredArtifactOutcomeTraceInput): Record<string, unknown>;
+export declare function buildAssistantWorkflowUnavailableOutcomeTracePayload(input: AssistantWorkflowUnavailableOutcomeTraceInput): Record<string, unknown>;
+export declare function buildAssistantWorkflowClarificationOutcomeTracePayload(input: AssistantWorkflowClarificationOutcomeTraceInput): Record<string, unknown>;
+export declare function buildAssistantWorkflowDegradedOutcomeTracePayload(input: AssistantWorkflowDegradedOutcomeTraceInput): Record<string, unknown>;
+export declare function getAssistantWorkflowDirectRouteOutcomeTraceRoute(entry: AssistantWorkflowDirectRouteOutcomeTraceEntry): string;
+export declare function buildAssistantWorkflowDirectRouteOutcome(entry: AssistantWorkflowDirectRouteOutcomeTraceEntry, input: AssistantWorkflowDirectRouteOutcomeInput): AssistantWorkflowOutcome;
+export declare function buildAssistantWorkflowDirectRouteOutcomeTracePayload(entry: AssistantWorkflowDirectRouteOutcomeTraceEntry, input: AssistantWorkflowDirectRouteOutcomeInput & {
+    source?: string;
+}): Record<string, unknown>;
+//# sourceMappingURL=outcome-trace.d.ts.map

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

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

package/dist/outcome-trace.js

@@ -0,0 +1,117 @@
+import { assistantWorkflowDirectRouteFromInvocation, assistantWorkflowDirectRouteNotHandledFromInvocation, assistantWorkflowClarification, assistantWorkflowDegraded, assistantWorkflowFinalText, assistantWorkflowStructuredArtifact, assistantWorkflowUnavailable, buildAssistantWorkflowOutcomeTraceEventPayload, getAssistantWorkflowDirectRouteOutcomeRoute, } from "./outcome.js";
+import { parseAssistantWorkflowDirectRouteTraceStage } from "./trace-stages.js";
+export function buildAssistantWorkflowFinalTextOutcomeTracePayload(input) {
+    return buildAssistantWorkflowOutcomeTraceEventPayload({
+        outcome: assistantWorkflowFinalText(input.content, input.delivery),
+        source: input.source ?? "final_answer",
+        layer: input.layer ?? "final_answer",
+        metadata: {
+            mode: input.mode ?? null,
+            streamed: input.streamed ?? null,
+        },
+    });
+}
+export function buildAssistantWorkflowStructuredArtifactOutcomeTracePayload(input) {
+    return buildAssistantWorkflowOutcomeTraceEventPayload({
+        outcome: assistantWorkflowStructuredArtifact(input.artifactKind, {}, input.content),
+        source: input.source ?? "final_answer",
+        layer: input.layer ?? "final_answer.structured_fast_path",
+        metadata: {
+            mode: input.mode ?? null,
+            submode: input.submode ?? null,
+            tool: input.tool ?? null,
+            streamed: input.streamed ?? false,
+        },
+    });
+}
+export function buildAssistantWorkflowUnavailableOutcomeTracePayload(input) {
+    return buildAssistantWorkflowOutcomeTraceEventPayload({
+        outcome: assistantWorkflowUnavailable(input.artifactKind, input.reason, input.content),
+        source: input.source ?? "tool_execution",
+        layer: input.layer ?? "tool.unavailable",
+        metadata: {
+            mode: input.mode ?? null,
+            tool: input.tool ?? null,
+            blockedArtifactKinds: normalizeNonEmptyStrings(input.blockedArtifactKinds),
+        },
+    });
+}
+export function buildAssistantWorkflowClarificationOutcomeTracePayload(input) {
+    return buildAssistantWorkflowOutcomeTraceEventPayload({
+        outcome: assistantWorkflowClarification(input.content, input.ruleId),
+        source: input.source ?? "final_answer",
+        layer: input.layer ?? "final_answer.clarification",
+        metadata: {
+            mode: input.mode ?? null,
+            ruleId: input.ruleId ?? null,
+            streamed: input.streamed ?? false,
+        },
+    });
+}
+export function buildAssistantWorkflowDegradedOutcomeTracePayload(input) {
+    return buildAssistantWorkflowOutcomeTraceEventPayload({
+        outcome: assistantWorkflowDegraded(input.content, input.reason),
+        source: input.source ?? "final_answer",
+        layer: input.layer ?? "final_answer.degraded",
+        metadata: {
+            mode: input.mode ?? null,
+            hasToolResults: input.hasToolResults ?? null,
+            toolCount: input.toolCount ?? null,
+            structuredBlockKinds: input.structuredBlockKinds ?? [],
+            streamed: input.streamed ?? false,
+        },
+    });
+}
+export function getAssistantWorkflowDirectRouteOutcomeTraceRoute(entry) {
+    return getAssistantWorkflowDirectRouteOutcomeRoute(entry.workflowInvocation, getAssistantWorkflowLegacyDirectRouteOutcomeTraceRoute(entry));
+}
+export function buildAssistantWorkflowDirectRouteOutcome(entry, input) {
+    const fallbackRoute = getAssistantWorkflowLegacyDirectRouteOutcomeTraceRoute(entry);
+    if (!input.handled) {
+        return assistantWorkflowDirectRouteNotHandledFromInvocation(entry.workflowInvocation, {
+            ...(input.reason ? { reason: input.reason } : {}),
+            fallbackRoute,
+        });
+    }
+    const options = {};
+    if (input.content !== undefined)
+        options.content = input.content;
+    if (input.artifactKind !== undefined)
+        options.artifactKind = input.artifactKind;
+    if (input.payload !== undefined)
+        options.payload = input.payload;
+    if (input.reason !== undefined)
+        options.reason = input.reason;
+    if (input.delivery !== undefined)
+        options.delivery = input.delivery;
+    return assistantWorkflowDirectRouteFromInvocation(entry.workflowInvocation, {
+        ...options,
+        fallbackRoute,
+    });
+}
+export function buildAssistantWorkflowDirectRouteOutcomeTracePayload(entry, input) {
+    return buildAssistantWorkflowOutcomeTraceEventPayload({
+        outcome: buildAssistantWorkflowDirectRouteOutcome(entry, input),
+        ...(input.source !== undefined ? { source: input.source } : {}),
+        layer: entry.layer,
+        ...(entry.skipEvent !== undefined ? { skipEvent: entry.skipEvent } : {}),
+    });
+}
+function getAssistantWorkflowLegacyDirectRouteOutcomeTraceRoute(entry) {
+    const traceRoute = entry.traceRoute?.trim();
+    if (traceRoute)
+        return traceRoute;
+    const skipRoute = parseAssistantWorkflowDirectRouteTraceStage(entry.skipEvent);
+    if (skipRoute)
+        return skipRoute.route;
+    const directLayerRoute = /^direct_route\.(.+)$/.exec(entry.layer)?.[1];
+    if (directLayerRoute?.trim())
+        return directLayerRoute.trim();
+    return entry.layer.trim().replace(/[^a-zA-Z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "unknown";
+}
+function normalizeNonEmptyStrings(values) {
+    if (!values?.length)
+        return [];
+    return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
+}
+//# sourceMappingURL=outcome-trace.js.map

package/dist/outcome-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome-trace.js","sourceRoot":"","sources":["../src/outcome-trace.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  assistantWorkflowDirectRouteFromInvocation,\n  assistantWorkflowDirectRouteNotHandledFromInvocation,\n  assistantWorkflowClarification,\n  assistantWorkflowDegraded,\n  assistantWorkflowFinalText,\n  assistantWorkflowStructuredArtifact,\n  assistantWorkflowUnavailable,\n  buildAssistantWorkflowOutcomeTraceEventPayload,\n  getAssistantWorkflowDirectRouteOutcomeRoute,\n  type AssistantWorkflowDirectRouteOutcome,\n  type AssistantWorkflowDirectRouteOutcomeOptions,\n  type AssistantWorkflowDirectRouteOutcomeRouteSource,\n  type AssistantWorkflowOutcome,\n  type AssistantWorkflowOutcomeDelivery,\n} from \"./outcome.js\";\nimport { parseAssistantWorkflowDirectRouteTraceStage } from \"./trace-stages.js\";\n\nexport type AssistantWorkflowFinalTextOutcomeTraceInput = {\n  content: string;\n  delivery?: AssistantWorkflowOutcomeDelivery;\n  source?: string;\n  layer?: string;\n  mode?: string;\n  streamed?: boolean;\n};\n\nexport type AssistantWorkflowStructuredArtifactOutcomeTraceInput = {\n  content: string;\n  artifactKind: string;\n  source?: string;\n  layer?: string;\n  mode?: string;\n  submode?: string;\n  tool?: string;\n  streamed?: boolean;\n};\n\nexport type AssistantWorkflowUnavailableOutcomeTraceInput = {\n  artifactKind: string;\n  reason: string;\n  /** Artifact kinds that cannot be produced because this prerequisite is unavailable. */\n  blockedArtifactKinds?: readonly string[];\n  content?: string;\n  source?: string;\n  layer?: string;\n  mode?: string;\n  tool?: string;\n};\n\nexport type AssistantWorkflowClarificationOutcomeTraceInput = {\n  content: string;\n  ruleId?: string;\n  source?: string;\n  layer?: string;\n  mode?: string;\n  streamed?: boolean;\n};\n\nexport type AssistantWorkflowDegradedOutcomeTraceInput = {\n  content: string;\n  reason: string;\n  source?: string;\n  layer?: string;\n  mode?: string;\n  hasToolResults?: boolean;\n  toolCount?: number;\n  structuredBlockKinds?: string[];\n  streamed?: boolean;\n};\n\n/**\n * The host's minimal direct-route identity. The core deliberately accepts\n * legacy trace metadata so applications can migrate outcome reporting before\n * their route registry is fully workflow-authored.\n */\nexport type AssistantWorkflowDirectRouteOutcomeTraceEntry = {\n  layer: string;\n  skipEvent?: string | null;\n  traceRoute?: string | null;\n  workflowInvocation?: AssistantWorkflowDirectRouteOutcomeRouteSource | null;\n};\n\nexport type AssistantWorkflowDirectRouteOutcomeInput = {\n  handled: boolean;\n  content?: string;\n  artifactKind?: string;\n  payload?: unknown;\n  reason?: string;\n  delivery?: AssistantWorkflowOutcomeDelivery;\n};\n\nexport function buildAssistantWorkflowFinalTextOutcomeTracePayload(\n  input: AssistantWorkflowFinalTextOutcomeTraceInput,\n): Record<string, unknown> {\n  return buildAssistantWorkflowOutcomeTraceEventPayload({\n    outcome: assistantWorkflowFinalText(input.content, input.delivery),\n    source: input.source ?? \"final_answer\",\n    layer: input.layer ?? \"final_answer\",\n    metadata: {\n      mode: input.mode ?? null,\n      streamed: input.streamed ?? null,\n    },\n  });\n}\n\nexport function buildAssistantWorkflowStructuredArtifactOutcomeTracePayload(\n  input: AssistantWorkflowStructuredArtifactOutcomeTraceInput,\n): Record<string, unknown> {\n  return buildAssistantWorkflowOutcomeTraceEventPayload({\n    outcome: assistantWorkflowStructuredArtifact(input.artifactKind, {}, input.content),\n    source: input.source ?? \"final_answer\",\n    layer: input.layer ?? \"final_answer.structured_fast_path\",\n    metadata: {\n      mode: input.mode ?? null,\n      submode: input.submode ?? null,\n      tool: input.tool ?? null,\n      streamed: input.streamed ?? false,\n    },\n  });\n}\n\nexport function buildAssistantWorkflowUnavailableOutcomeTracePayload(\n  input: AssistantWorkflowUnavailableOutcomeTraceInput,\n): Record<string, unknown> {\n  return buildAssistantWorkflowOutcomeTraceEventPayload({\n    outcome: assistantWorkflowUnavailable(input.artifactKind, input.reason, input.content),\n    source: input.source ?? \"tool_execution\",\n    layer: input.layer ?? \"tool.unavailable\",\n    metadata: {\n      mode: input.mode ?? null,\n      tool: input.tool ?? null,\n      blockedArtifactKinds: normalizeNonEmptyStrings(input.blockedArtifactKinds),\n    },\n  });\n}\n\nexport function buildAssistantWorkflowClarificationOutcomeTracePayload(\n  input: AssistantWorkflowClarificationOutcomeTraceInput,\n): Record<string, unknown> {\n  return buildAssistantWorkflowOutcomeTraceEventPayload({\n    outcome: assistantWorkflowClarification(input.content, input.ruleId),\n    source: input.source ?? \"final_answer\",\n    layer: input.layer ?? \"final_answer.clarification\",\n    metadata: {\n      mode: input.mode ?? null,\n      ruleId: input.ruleId ?? null,\n      streamed: input.streamed ?? false,\n    },\n  });\n}\n\nexport function buildAssistantWorkflowDegradedOutcomeTracePayload(\n  input: AssistantWorkflowDegradedOutcomeTraceInput,\n): Record<string, unknown> {\n  return buildAssistantWorkflowOutcomeTraceEventPayload({\n    outcome: assistantWorkflowDegraded(input.content, input.reason),\n    source: input.source ?? \"final_answer\",\n    layer: input.layer ?? \"final_answer.degraded\",\n    metadata: {\n      mode: input.mode ?? null,\n      hasToolResults: input.hasToolResults ?? null,\n      toolCount: input.toolCount ?? null,\n      structuredBlockKinds: input.structuredBlockKinds ?? [],\n      streamed: input.streamed ?? false,\n    },\n  });\n}\n\nexport function getAssistantWorkflowDirectRouteOutcomeTraceRoute(\n  entry: AssistantWorkflowDirectRouteOutcomeTraceEntry,\n): string {\n  return getAssistantWorkflowDirectRouteOutcomeRoute(\n    entry.workflowInvocation,\n    getAssistantWorkflowLegacyDirectRouteOutcomeTraceRoute(entry),\n  );\n}\n\nexport function buildAssistantWorkflowDirectRouteOutcome(\n  entry: AssistantWorkflowDirectRouteOutcomeTraceEntry,\n  input: AssistantWorkflowDirectRouteOutcomeInput,\n): AssistantWorkflowOutcome {\n  const fallbackRoute = getAssistantWorkflowLegacyDirectRouteOutcomeTraceRoute(entry);\n  if (!input.handled) {\n    return assistantWorkflowDirectRouteNotHandledFromInvocation(entry.workflowInvocation, {\n      ...(input.reason ? { reason: input.reason } : {}),\n      fallbackRoute,\n    });\n  }\n  const options: AssistantWorkflowDirectRouteOutcomeOptions = {};\n  if (input.content !== undefined) options.content = input.content;\n  if (input.artifactKind !== undefined) options.artifactKind = input.artifactKind;\n  if (input.payload !== undefined) options.payload = input.payload;\n  if (input.reason !== undefined) options.reason = input.reason;\n  if (input.delivery !== undefined) options.delivery = input.delivery;\n  return assistantWorkflowDirectRouteFromInvocation(entry.workflowInvocation, {\n    ...options,\n    fallbackRoute,\n  });\n}\n\nexport function buildAssistantWorkflowDirectRouteOutcomeTracePayload(\n  entry: AssistantWorkflowDirectRouteOutcomeTraceEntry,\n  input: AssistantWorkflowDirectRouteOutcomeInput & {\n    source?: string;\n  },\n): Record<string, unknown> {\n  return buildAssistantWorkflowOutcomeTraceEventPayload({\n    outcome: buildAssistantWorkflowDirectRouteOutcome(entry, input),\n    ...(input.source !== undefined ? { source: input.source } : {}),\n    layer: entry.layer,\n    ...(entry.skipEvent !== undefined ? { skipEvent: entry.skipEvent } : {}),\n  });\n}\n\nfunction getAssistantWorkflowLegacyDirectRouteOutcomeTraceRoute(\n  entry: AssistantWorkflowDirectRouteOutcomeTraceEntry,\n): string {\n  const traceRoute = entry.traceRoute?.trim();\n  if (traceRoute) return traceRoute;\n  const skipRoute = parseAssistantWorkflowDirectRouteTraceStage(entry.skipEvent);\n  if (skipRoute) return skipRoute.route;\n  const directLayerRoute = /^direct_route\\.(.+)$/.exec(entry.layer)?.[1];\n  if (directLayerRoute?.trim()) return directLayerRoute.trim();\n  return entry.layer.trim().replace(/[^a-zA-Z0-9]+/g, \"_\").replace(/^_+|_+$/g, \"\") || \"unknown\";\n}\n\nfunction normalizeNonEmptyStrings(values: readonly string[] | undefined): string[] {\n  if (!values?.length) return [];\n  return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));\n}\n"]}