@cats-inc/cats-platform 0.1.0

package/build/server/products/chat/state/companion-box/operations.js

@@ -0,0 +1,216 @@
+import { buildCompanionSessionContext } from '../../companion/hydration.js';
+import { buildCompanionSourceStorageKey } from '../../companion/layout.js';
+import { applyCompanionResponseProfileUpdate, applyCompanionSourceUpdate, createCompanionBox, createCompanionMemoryRecord, createCompanionSourceRecord, createDerivedRecordsForSource, } from '../../companion/sourceIngestion.js';
+import { buildStorageLayout } from './snapshot.js';
+function sortNewestFirst(records) {
+    return [...records].sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+}
+export function ensureCompanionBox(snapshot, catId, nowIso) {
+    const existing = snapshot.boxes.find((box) => box.catId === catId);
+    if (existing) {
+        return {
+            box: existing,
+            created: false,
+        };
+    }
+    const box = createCompanionBox(catId, nowIso);
+    snapshot.boxes.push(box);
+    snapshot.updatedAt = nowIso;
+    return {
+        box,
+        created: true,
+    };
+}
+export function listCompanionBoxSources(snapshot, box) {
+    return sortNewestFirst(snapshot.sources.filter((record) => record.boxId === box.id));
+}
+export function listCompanionBoxDerived(snapshot, box) {
+    return sortNewestFirst(snapshot.derived.filter((record) => record.boxId === box.id));
+}
+export function listCompanionBoxMemory(snapshot, box) {
+    return sortNewestFirst(snapshot.memory.filter((record) => record.boxId === box.id));
+}
+function requireSourceRecord(snapshot, box, sourceId) {
+    const source = snapshot.sources.find((record) => record.boxId === box.id && record.id === sourceId);
+    if (!source) {
+        throw new Error(`Companion source not found: ${sourceId}`);
+    }
+    return source;
+}
+function collectDerivedIdsForSource(snapshot, box, sourceId) {
+    return snapshot.derived
+        .filter((record) => record.boxId === box.id && record.sourceIds.includes(sourceId))
+        .map((record) => record.id);
+}
+function replaceDerivedForSource(snapshot, box, sourceId, nextDerived) {
+    const removedDerivedIds = collectDerivedIdsForSource(snapshot, box, sourceId);
+    snapshot.derived = [
+        ...nextDerived,
+        ...snapshot.derived.filter((record) => !(record.boxId === box.id && record.sourceIds.includes(sourceId))),
+    ];
+    box.derivedIds = [
+        ...nextDerived.map((record) => record.id),
+        ...box.derivedIds.filter((id) => !removedDerivedIds.includes(id)),
+    ];
+    return removedDerivedIds;
+}
+function pruneMemorySourceRefs(snapshot, box, sourceId, nowIso) {
+    const prunedMemoryIds = [];
+    snapshot.memory = snapshot.memory.map((record) => {
+        if (record.boxId !== box.id || !record.sourceIds.includes(sourceId)) {
+            return record;
+        }
+        const nextSourceIds = record.sourceIds.filter((candidate) => candidate !== sourceId);
+        prunedMemoryIds.push(record.id);
+        return {
+            ...record,
+            sourceIds: nextSourceIds,
+            updatedAt: nowIso,
+        };
+    });
+    return prunedMemoryIds;
+}
+export function summarizeCompanionBox(box, snapshot, snapshotPath) {
+    const sourceCount = snapshot.sources.filter((record) => record.boxId === box.id).length;
+    const derivedCount = snapshot.derived.filter((record) => record.boxId === box.id).length;
+    const memoryCount = snapshot.memory.filter((record) => record.boxId === box.id).length;
+    return {
+        box: structuredClone(box),
+        sourceCount,
+        derivedCount,
+        memoryCount,
+        storage: buildStorageLayout(box.catId, snapshotPath),
+        hasHydrationContext: sourceCount > 0
+            || derivedCount > 0
+            || memoryCount > 0
+            || Boolean(box.responseProfile.notes),
+    };
+}
+export function ingestCompanionSource(snapshot, box, catId, input, nowIso) {
+    const source = createCompanionSourceRecord(box, input, nowIso, null);
+    if (input.storageMode !== 'linked_path') {
+        source.storedPath = buildCompanionSourceStorageKey(catId, source.id, 'json');
+    }
+    const derivedRecords = createDerivedRecordsForSource(box, source, nowIso);
+    snapshot.sources.unshift(source);
+    snapshot.derived.unshift(...derivedRecords);
+    box.sourceIds.unshift(source.id);
+    box.derivedIds.unshift(...derivedRecords.map((record) => record.id));
+    box.updatedAt = nowIso;
+    box.lastIngestedAt = nowIso;
+    snapshot.updatedAt = nowIso;
+    return {
+        box,
+        source,
+        derivedRecords,
+    };
+}
+export function updateCompanionSource(snapshot, box, sourceId, update, nowIso) {
+    const source = requireSourceRecord(snapshot, box, sourceId);
+    const nextSource = applyCompanionSourceUpdate(source, update, nowIso);
+    const nextDerived = createDerivedRecordsForSource(box, nextSource, nowIso);
+    const sourceIndex = snapshot.sources.findIndex((record) => record.id === sourceId && record.boxId === box.id);
+    snapshot.sources[sourceIndex] = nextSource;
+    replaceDerivedForSource(snapshot, box, sourceId, nextDerived);
+    box.updatedAt = nowIso;
+    snapshot.updatedAt = nowIso;
+    return {
+        box,
+        previousSource: source,
+        source: nextSource,
+        derivedRecords: nextDerived,
+    };
+}
+export function deleteCompanionSource(snapshot, box, sourceId, nowIso) {
+    const source = requireSourceRecord(snapshot, box, sourceId);
+    const removedDerivedIds = collectDerivedIdsForSource(snapshot, box, sourceId);
+    const prunedMemoryIds = pruneMemorySourceRefs(snapshot, box, sourceId, nowIso);
+    snapshot.sources = snapshot.sources.filter((record) => !(record.boxId === box.id && record.id === sourceId));
+    box.sourceIds = box.sourceIds.filter((id) => id !== sourceId);
+    box.derivedIds = box.derivedIds.filter((id) => !removedDerivedIds.includes(id));
+    snapshot.derived = snapshot.derived.filter((record) => !(record.boxId === box.id && record.sourceIds.includes(sourceId)));
+    box.updatedAt = nowIso;
+    snapshot.updatedAt = nowIso;
+    return {
+        box,
+        source,
+        sourceId,
+        removedDerivedIds,
+        prunedMemoryIds,
+    };
+}
+export function appendCompanionBoxMemory(snapshot, box, input, nowIso) {
+    const record = createCompanionMemoryRecord(box, input, nowIso);
+    snapshot.memory.unshift(record);
+    box.memoryIds.unshift(record.id);
+    box.updatedAt = nowIso;
+    snapshot.updatedAt = nowIso;
+    return record;
+}
+/**
+ * PLAN-077 Phase 2 promote-to-post landing point. Inserts a new
+ * derived record or replaces an existing one matched by `id`. The
+ * companion-box `derivedIds` list is kept newest-first, mirroring
+ * the behaviour of the source-ingest derived-record append.
+ */
+export function upsertCompanionBoxDerived(snapshot, box, record, nowIso) {
+    if (record.boxId !== box.id) {
+        throw new Error(`Companion derived record boxId ${record.boxId} does not match target box ${box.id}.`);
+    }
+    const stored = { ...record, updatedAt: nowIso };
+    const existingIndex = snapshot.derived.findIndex((entry) => entry.id === stored.id);
+    if (existingIndex >= 0) {
+        snapshot.derived[existingIndex] = stored;
+    }
+    else {
+        snapshot.derived.unshift(stored);
+    }
+    if (!box.derivedIds.includes(stored.id)) {
+        box.derivedIds.unshift(stored.id);
+    }
+    box.updatedAt = nowIso;
+    snapshot.updatedAt = nowIso;
+    return stored;
+}
+export function deleteCompanionBoxMemory(snapshot, box, memoryId, nowIso) {
+    const index = snapshot.memory.findIndex((record) => record.boxId === box.id && record.id === memoryId);
+    if (index === -1) {
+        return { deleted: false };
+    }
+    snapshot.memory.splice(index, 1);
+    box.memoryIds = box.memoryIds.filter((id) => id !== memoryId);
+    box.updatedAt = nowIso;
+    snapshot.updatedAt = nowIso;
+    return { deleted: true };
+}
+export function updateCompanionBoxMemoryStatus(snapshot, box, memoryId, status, nowIso) {
+    const record = snapshot.memory.find((candidate) => candidate.boxId === box.id && candidate.id === memoryId);
+    if (!record) {
+        throw new Error(`Companion memory not found: ${memoryId}`);
+    }
+    record.status = status;
+    record.updatedAt = nowIso;
+    box.updatedAt = nowIso;
+    snapshot.updatedAt = nowIso;
+    return record;
+}
+export function updateCompanionBoxResponseProfile(snapshot, box, update, nowIso) {
+    box.responseProfile = applyCompanionResponseProfileUpdate(box.responseProfile, update, nowIso);
+    box.updatedAt = nowIso;
+    snapshot.updatedAt = nowIso;
+    return box.responseProfile;
+}
+export function buildCompanionBoxSessionContext(snapshot, box, input) {
+    return buildCompanionSessionContext({
+        cat: input.cat,
+        box,
+        sources: listCompanionBoxSources(snapshot, box),
+        derived: listCompanionBoxDerived(snapshot, box),
+        memory: listCompanionBoxMemory(snapshot, box),
+        requestedSkills: input.requestedSkills,
+        channel: input.channel,
+        transport: input.transport,
+        hydratedAt: input.hydratedAt,
+    });
+}
+//# sourceMappingURL=operations.js.map

package/build/server/products/chat/state/companion-box/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../../../../src/products/chat/state/companion-box/operations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EACL,mCAAmC,EACnC,0BAA0B,EAC1B,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,oCAAoC,CAAC;AAkB5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,SAAS,eAAe,CAAkC,OAAY;IACpE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAA2B,EAC3B,KAAa,EACb,MAAc;IAEd,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACnE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAC5B,OAAO;QACL,GAAG;QACH,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAA2B,EAC3B,GAAiB;IAEjB,OAAO,eAAe,CACpB,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAA2B,EAC3B,GAAiB;IAEjB,OAAO,eAAe,CACpB,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAA2B,EAC3B,GAAiB;IAEjB,OAAO,eAAe,CACpB,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,QAA2B,EAC3B,GAAiB,EACjB,QAAgB;IAEhB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IACpG,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,0BAA0B,CACjC,QAA2B,EAC3B,GAAiB,EACjB,QAAgB;IAEhB,OAAO,QAAQ,CAAC,OAAO;SACpB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAClF,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,uBAAuB,CAC9B,QAA2B,EAC3B,GAAiB,EACjB,QAAgB,EAChB,WAAqC;IAErC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC9E,QAAQ,CAAC,OAAO,GAAG;QACjB,GAAG,WAAW;QACd,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CACpC,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAClE;KACF,CAAC;IACF,GAAG,CAAC,UAAU,GAAG;QACf,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;KAClE,CAAC;IACF,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,SAAS,qBAAqB,CAC5B,QAA2B,EAC3B,GAAiB,EACjB,QAAgB,EAChB,MAAc;IAEd,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC/C,IAAI,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpE,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC;QACrF,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChC,OAAO;YACL,GAAG,MAAM;YACT,SAAS,EAAE,aAAa;YACxB,SAAS,EAAE,MAAM;SAClB,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,GAAiB,EACjB,QAA2B,EAC3B,YAAoB;IAEpB,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IACxF,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IACzF,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IAEvF,OAAO;QACL,GAAG,EAAE,eAAe,CAAC,GAAG,CAAC;QACzB,WAAW;QACX,YAAY;QACZ,WAAW;QACX,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,CAAC;QACpD,mBAAmB,EACjB,WAAW,GAAG,CAAC;eACZ,YAAY,GAAG,CAAC;eAChB,WAAW,GAAG,CAAC;eACf,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,GAAiB,EACjB,KAAa,EACb,KAAiC,EACjC,MAAc;IAEd,MAAM,MAAM,GAAG,2BAA2B,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACrE,IAAI,KAAK,CAAC,WAAW,KAAK,aAAa,EAAE,CAAC;QACxC,MAAM,CAAC,UAAU,GAAG,8BAA8B,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,cAAc,GAAG,6BAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1E,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,CAAC;IAC5C,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACrE,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAE5B,OAAO;QACL,GAAG;QACH,MAAM;QACN,cAAc;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,GAAiB,EACjB,QAAgB,EAChB,MAAkC,EAClC,MAAc;IAEd,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,6BAA6B,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE3E,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9G,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,UAAU,CAAC;IAC3C,uBAAuB,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC9D,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAE5B,OAAO;QACL,GAAG;QACH,cAAc,EAAE,MAAM;QACtB,MAAM,EAAE,UAAU;QAClB,cAAc,EAAE,WAAW;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,GAAiB,EACjB,QAAgB,EAChB,MAAc;IAEd,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,qBAAqB,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE/E,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC;IAC7G,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC9D,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAChF,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CACpD,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAClE,CAAC;IACF,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAE5B,OAAO;QACL,GAAG;QACH,MAAM;QACN,QAAQ;QACR,iBAAiB;QACjB,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAA2B,EAC3B,GAAiB,EACjB,KAAiC,EACjC,MAAc;IAEd,MAAM,MAAM,GAAG,2BAA2B,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/D,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAA2B,EAC3B,GAAiB,EACjB,MAA8B,EAC9B,MAAc;IAEd,IAAI,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,kCAAkC,MAAM,CAAC,KAAK,8BAA8B,GAAG,CAAC,EAAE,GAAG,CACtF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAA2B,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACxE,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;IACpF,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACvB,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACxC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAA2B,EAC3B,GAAiB,EACjB,QAAgB,EAChB,MAAc;IAEd,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CACrC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,KAAK,QAAQ,CAC9D,CAAC;IACF,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IACD,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjC,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC9D,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAA2B,EAC3B,GAAiB,EACjB,QAAgB,EAChB,MAA6B,EAC7B,MAAc;IAEd,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CACjC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,IAAI,SAAS,CAAC,EAAE,KAAK,QAAQ,CACvE,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC;IAC1B,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,QAA2B,EAC3B,GAAiB,EACjB,MAA2C,EAC3C,MAAc;IAEd,GAAG,CAAC,eAAe,GAAG,mCAAmC,CACvD,GAAG,CAAC,eAAe,EACnB,MAAM,EACN,MAAM,CACP,CAAC;IACF,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAC5B,OAAO,GAAG,CAAC,eAAe,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,QAA2B,EAC3B,GAAiB,EACjB,KAYC;IAED,OAAO,4BAA4B,CAAC;QAClC,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,GAAG;QACH,OAAO,EAAE,uBAAuB,CAAC,QAAQ,EAAE,GAAG,CAAC;QAC/C,OAAO,EAAE,uBAAuB,CAAC,QAAQ,EAAE,GAAG,CAAC;QAC/C,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE,GAAG,CAAC;QAC7C,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;AACL,CAAC"}

package/build/server/products/chat/state/companion-box/snapshot.d.ts

@@ -0,0 +1,10 @@
+import type { CompanionSnapshot, CompanionStorageLayout } from '../../companion/contracts.js';
+export declare function cloneSnapshot(snapshot: CompanionSnapshot): CompanionSnapshot;
+export declare function isoAt(now: Date): string;
+export declare function describeError(error: unknown): string;
+export declare function deriveCompanionBoxStatePath(chatStatePath: string): string;
+export declare function resolveCompanionStorageRoot(snapshotPath: string): string;
+export declare function createEmptySnapshot(nowIso: string): CompanionSnapshot;
+export declare function normalizeSnapshot(rawSnapshot: unknown, nowIso?: string): CompanionSnapshot;
+export declare function buildStorageLayout(catId: string, snapshotPath: string): CompanionStorageLayout;
+//# sourceMappingURL=snapshot.d.ts.map

package/build/server/products/chat/state/companion-box/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../../../src/products/chat/state/companion-box/snapshot.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAKV,iBAAiB,EAEjB,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AAkCtC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,iBAAiB,CAE5E;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAEvC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMpD;AAED,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CASrE;AAqLD,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,OAAO,EACpB,MAAM,GAAE,MAAiC,GACxC,iBAAiB,CA8BnB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,sBAAsB,CAM9F"}

package/build/server/products/chat/state/companion-box/snapshot.js

@@ -0,0 +1,240 @@
+import path from 'node:path';
+import { buildCompanionBoxDirectoryKey, buildCompanionSnapshotKey, buildCompanionSourcesDirectoryKey, } from '../../companion/layout.js';
+import { COMPANION_EXPRESSION_MODES, COMPANION_MEMORY_CATEGORIES, COMPANION_OUTPUT_MODES, COMPANION_SOURCE_KINDS, COMPANION_SOURCE_STORAGE_MODES, } from '../../companion/validation.js';
+import { createDefaultCompanionResponseProfile } from '../../companion/sourceIngestion.js';
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function readString(value, fallback = '') {
+    return typeof value === 'string' ? value : fallback;
+}
+function readNullableString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value : null;
+}
+function readStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((item) => typeof item === 'string');
+}
+export function cloneSnapshot(snapshot) {
+    return structuredClone(snapshot);
+}
+export function isoAt(now) {
+    return now.toISOString();
+}
+export function describeError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+export function deriveCompanionBoxStatePath(chatStatePath) {
+    const directory = path.dirname(chatStatePath);
+    const parsed = path.parse(chatStatePath);
+    return path.join(directory, `${parsed.name}.companion-boxes.json`);
+}
+export function resolveCompanionStorageRoot(snapshotPath) {
+    return path.join(path.dirname(snapshotPath), 'companion-boxes');
+}
+export function createEmptySnapshot(nowIso) {
+    return {
+        version: 1,
+        updatedAt: nowIso,
+        boxes: [],
+        sources: [],
+        derived: [],
+        memory: [],
+    };
+}
+function normalizeResponseProfile(rawProfile, nowIso) {
+    const profileRecord = asRecord(rawProfile);
+    const fallback = createDefaultCompanionResponseProfile(nowIso);
+    const expressionMode = readString(profileRecord?.expressionMode, fallback.expressionMode);
+    const outputMode = readString(profileRecord?.outputMode, fallback.outputMode);
+    return {
+        expressionMode: COMPANION_EXPRESSION_MODES.includes(expressionMode)
+            ? expressionMode
+            : fallback.expressionMode,
+        outputMode: COMPANION_OUTPUT_MODES.includes(outputMode)
+            ? outputMode
+            : fallback.outputMode,
+        voiceProfileId: readNullableString(profileRecord?.voiceProfileId),
+        notes: readNullableString(profileRecord?.notes),
+        updatedAt: readString(profileRecord?.updatedAt, nowIso),
+    };
+}
+function normalizeBox(rawBox, nowIso) {
+    const boxRecord = asRecord(rawBox);
+    if (!boxRecord) {
+        return null;
+    }
+    const catId = readNullableString(boxRecord.catId);
+    const id = readNullableString(boxRecord.id);
+    if (!catId || !id) {
+        return null;
+    }
+    return {
+        id,
+        catId,
+        sourceIds: readStringArray(boxRecord.sourceIds),
+        derivedIds: readStringArray(boxRecord.derivedIds),
+        memoryIds: readStringArray(boxRecord.memoryIds),
+        responseProfile: normalizeResponseProfile(boxRecord.responseProfile, nowIso),
+        createdAt: readString(boxRecord.createdAt, nowIso),
+        updatedAt: readString(boxRecord.updatedAt, nowIso),
+        lastIngestedAt: readNullableString(boxRecord.lastIngestedAt),
+    };
+}
+function normalizeSource(rawSource, nowIso) {
+    const record = asRecord(rawSource);
+    if (!record) {
+        return null;
+    }
+    const id = readNullableString(record.id);
+    const boxId = readNullableString(record.boxId);
+    const catId = readNullableString(record.catId);
+    const kind = readString(record.kind);
+    const storageMode = readString(record.storageMode);
+    if (!id
+        || !boxId
+        || !catId
+        || !COMPANION_SOURCE_KINDS.includes(kind)
+        || !COMPANION_SOURCE_STORAGE_MODES.includes(storageMode)) {
+        return null;
+    }
+    return {
+        id,
+        boxId,
+        catId,
+        kind: kind,
+        storageMode: storageMode,
+        title: readNullableString(record.title),
+        ownerNote: readNullableString(record.ownerNote),
+        sourceText: readNullableString(record.sourceText),
+        textExcerpt: readNullableString(record.textExcerpt),
+        linkedPath: readNullableString(record.linkedPath),
+        storedPath: readNullableString(record.storedPath),
+        sourceUrl: readNullableString(record.sourceUrl),
+        mimeType: readNullableString(record.mimeType),
+        originalFileName: readNullableString(record.originalFileName),
+        metadata: asRecord(record.metadata) ?? {},
+        createdAt: readString(record.createdAt, nowIso),
+        updatedAt: readString(record.updatedAt, nowIso),
+    };
+}
+function normalizeDerived(rawRecord, nowIso) {
+    const record = asRecord(rawRecord);
+    if (!record) {
+        return null;
+    }
+    const id = readNullableString(record.id);
+    const boxId = readNullableString(record.boxId);
+    const catId = readNullableString(record.catId);
+    const kind = readString(record.kind);
+    if (!id
+        || !boxId
+        || !catId
+        || ![
+            'summary',
+            'transcript',
+            'caption',
+            'tags',
+            'traits',
+            'event',
+            'relationship_note',
+            'normalized_note',
+            'metadata',
+        ].includes(kind)) {
+        return null;
+    }
+    return {
+        id,
+        boxId,
+        catId,
+        kind: kind,
+        sourceIds: readStringArray(record.sourceIds),
+        title: readNullableString(record.title),
+        content: readString(record.content),
+        tags: readStringArray(record.tags),
+        metadata: asRecord(record.metadata) ?? {},
+        createdAt: readString(record.createdAt, nowIso),
+        updatedAt: readString(record.updatedAt, nowIso),
+    };
+}
+function normalizeMemory(rawRecord, nowIso) {
+    const record = asRecord(rawRecord);
+    if (!record) {
+        return null;
+    }
+    const id = readNullableString(record.id);
+    const boxId = readNullableString(record.boxId);
+    const catId = readNullableString(record.catId);
+    const category = readString(record.category);
+    const status = readString(record.status, 'active');
+    const curatedBy = readString(record.curatedBy, 'owner');
+    if (!id
+        || !boxId
+        || !catId
+        || !COMPANION_MEMORY_CATEGORIES.includes(category)
+        || !['active', 'superseded', 'archived'].includes(status)
+        || !['owner', 'system'].includes(curatedBy)) {
+        return null;
+    }
+    return {
+        id,
+        boxId,
+        catId,
+        category: category,
+        sourceIds: readStringArray(record.sourceIds),
+        content: readString(record.content),
+        summary: readNullableString(record.summary),
+        status: status,
+        curatedBy: curatedBy,
+        replacedById: readNullableString(record.replacedById),
+        metadata: asRecord(record.metadata) ?? {},
+        createdAt: readString(record.createdAt, nowIso),
+        updatedAt: readString(record.updatedAt, nowIso),
+    };
+}
+export function normalizeSnapshot(rawSnapshot, nowIso = new Date().toISOString()) {
+    const snapshotRecord = asRecord(rawSnapshot);
+    if (!snapshotRecord) {
+        return createEmptySnapshot(nowIso);
+    }
+    return {
+        version: 1,
+        updatedAt: readString(snapshotRecord.updatedAt, nowIso),
+        boxes: Array.isArray(snapshotRecord.boxes)
+            ? snapshotRecord.boxes
+                .map((box) => normalizeBox(box, nowIso))
+                .filter((box) => box !== null)
+            : [],
+        sources: Array.isArray(snapshotRecord.sources)
+            ? snapshotRecord.sources
+                .map((source) => normalizeSource(source, nowIso))
+                .filter((source) => source !== null)
+            : [],
+        derived: Array.isArray(snapshotRecord.derived)
+            ? snapshotRecord.derived
+                .map((record) => normalizeDerived(record, nowIso))
+                .filter((record) => record !== null)
+            : [],
+        memory: Array.isArray(snapshotRecord.memory)
+            ? snapshotRecord.memory
+                .map((record) => normalizeMemory(record, nowIso))
+                .filter((record) => record !== null)
+            : [],
+    };
+}
+export function buildStorageLayout(catId, snapshotPath) {
+    return {
+        snapshotKey: buildCompanionSnapshotKey(path.basename(snapshotPath)),
+        boxDirectoryKey: buildCompanionBoxDirectoryKey(catId),
+        sourcesDirectoryKey: buildCompanionSourcesDirectoryKey(catId),
+    };
+}
+//# sourceMappingURL=snapshot.js.map

package/build/server/products/chat/state/companion-box/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../../../../src/products/chat/state/companion-box/snapshot.ts"],"names":[],"mappings":"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"}

package/build/server/products/chat/state/companion-box/storeTypes.d.ts

@@ -0,0 +1,36 @@
+import type { ChatCat, ChatChannelView } from '../../api/contracts.js';
+import type { CompanionBox, CompanionBoxSummary, CompanionDerivedRecord, CompanionMemoryRecord, CompanionResponseProfile, CompanionSessionContext, CompanionSnapshot, CompanionSourceDeleteResult, CompanionSourceIngestResult, CompanionSourceRecord, CompanionSourceUpdateResult, CreateCompanionMemoryInput, CreateCompanionSourceInput, UpdateCompanionResponseProfileInput, UpdateCompanionSourceInput } from '../../companion/contracts.js';
+export interface CompanionSessionContextInput {
+    cat: ChatCat;
+    channel: {
+        id: string | null;
+        title: string;
+        topic: string;
+        workingMemory?: ChatChannelView['workingMemory'];
+        roomRouting?: ChatChannelView['roomRouting'];
+    };
+    requestedSkills: string[];
+    transport: 'telegram' | 'line' | 'web' | null;
+    now?: Date;
+}
+export interface CompanionBoxStore {
+    readSnapshot(): Promise<CompanionSnapshot>;
+    getBox(catId: string, now?: Date): Promise<CompanionBox>;
+    getBoxSummary(catId: string, now?: Date): Promise<CompanionBoxSummary>;
+    listSources(catId: string, now?: Date): Promise<CompanionSourceRecord[]>;
+    ingestSource(catId: string, input: CreateCompanionSourceInput, now?: Date): Promise<CompanionSourceIngestResult>;
+    updateSource(catId: string, sourceId: string, update: UpdateCompanionSourceInput, now?: Date): Promise<CompanionSourceUpdateResult>;
+    deleteSource(catId: string, sourceId: string, now?: Date): Promise<CompanionSourceDeleteResult>;
+    listDerived(catId: string, now?: Date): Promise<CompanionDerivedRecord[]>;
+    upsertDerived(catId: string, record: CompanionDerivedRecord, now?: Date): Promise<CompanionDerivedRecord>;
+    listMemory(catId: string, now?: Date): Promise<CompanionMemoryRecord[]>;
+    createMemory(catId: string, input: CreateCompanionMemoryInput, now?: Date): Promise<CompanionMemoryRecord>;
+    getResponseProfile(catId: string, now?: Date): Promise<CompanionResponseProfile>;
+    updateResponseProfile(catId: string, update: UpdateCompanionResponseProfileInput, now?: Date): Promise<CompanionResponseProfile>;
+    deleteMemory(catId: string, memoryId: string, now?: Date): Promise<{
+        deleted: boolean;
+    }>;
+    updateMemoryStatus(catId: string, memoryId: string, status: 'active' | 'archived', now?: Date): Promise<CompanionMemoryRecord>;
+    buildSessionContext(input: CompanionSessionContextInput): Promise<CompanionSessionContext>;
+}
+//# sourceMappingURL=storeTypes.d.ts.map

package/build/server/products/chat/state/companion-box/storeTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeTypes.d.ts","sourceRoot":"","sources":["../../../../../../src/products/chat/state/companion-box/storeTypes.ts"],"names":[],"mappings":"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"}

package/build/server/products/chat/state/companion-box/storeTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storeTypes.js.map

package/build/server/products/chat/state/companion-box/storeTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeTypes.js","sourceRoot":"","sources":["../../../../../../src/products/chat/state/companion-box/storeTypes.ts"],"names":[],"mappings":""}

package/build/server/products/chat/state/companionMemoryAdapter.d.ts

@@ -0,0 +1,57 @@
+import type { CompanionBoxStore } from './companion-box/index.js';
+import type { CatsMemoryService } from '../../../platform/memory/index.js';
+import type { CoreStore } from '../../../core/store.js';
+import type { CanonicalMemorySyncResult } from '../../../platform/memory/maintenance.js';
+export type CompanionCanonicalSyncResult = CanonicalMemorySyncResult;
+export interface CanonicalSyncAwareCompanionBoxStore extends CompanionBoxStore {
+    consumePendingCanonicalSync(catId: string): CompanionCanonicalSyncResult | null;
+}
+export declare class MemoryAwareCompanionBoxStore implements CanonicalSyncAwareCompanionBoxStore {
+    private readonly delegate;
+    private readonly memoryService;
+    private readonly coreStore?;
+    private readonly pendingCanonicalSync;
+    constructor(delegate: CompanionBoxStore, memoryService: CatsMemoryService, coreStore?: CoreStore | undefined);
+    consumePendingCanonicalSync(catId: string): CompanionCanonicalSyncResult | null;
+    private syncCanonicalCompanionMemory;
+    readSnapshot(): Promise<import("../companion/contracts.js").CompanionSnapshot>;
+    getBox(catId: string, now?: Date): Promise<import("../companion/contracts.js").CompanionBox>;
+    getBoxSummary(catId: string, now?: Date): Promise<import("../companion/contracts.js").CompanionBoxSummary>;
+    listSources(catId: string, now?: Date): Promise<import("../companion/contracts.js").CompanionSourceRecord[]>;
+    ingestSource(catId: string, input: Parameters<CompanionBoxStore['ingestSource']>[1], now?: Date): Promise<import("../companion/contracts.js").CompanionSourceIngestResult>;
+    updateSource(catId: string, sourceId: string, update: Parameters<CompanionBoxStore['updateSource']>[2], now?: Date): Promise<import("../companion/contracts.js").CompanionSourceUpdateResult>;
+    deleteSource(catId: string, sourceId: string, now?: Date): Promise<import("../companion/contracts.js").CompanionSourceDeleteResult>;
+    listDerived(catId: string, now?: Date): Promise<import("../companion/contracts.js").CompanionDerivedRecord[]>;
+    upsertDerived(catId: string, record: Parameters<CompanionBoxStore['upsertDerived']>[1], now?: Date): Promise<import("../companion/contracts.js").CompanionDerivedRecord>;
+    listMemory(catId: string, now?: Date): Promise<import("../companion/contracts.js").CompanionMemoryRecord[]>;
+    createMemory(catId: string, input: Parameters<CompanionBoxStore['createMemory']>[1], now?: Date): Promise<import("../companion/contracts.js").CompanionMemoryRecord>;
+    deleteMemory(catId: string, memoryId: string, now?: Date): Promise<{
+        deleted: boolean;
+    }>;
+    updateMemoryStatus(catId: string, memoryId: string, status: 'active' | 'archived', now?: Date): Promise<import("../companion/contracts.js").CompanionMemoryRecord>;
+    getResponseProfile(catId: string, now?: Date): Promise<import("../companion/contracts.js").CompanionResponseProfile>;
+    updateResponseProfile(catId: string, update: Parameters<CompanionBoxStore['updateResponseProfile']>[1], now?: Date): Promise<import("../companion/contracts.js").CompanionResponseProfile>;
+    buildSessionContext(input: Parameters<CompanionBoxStore['buildSessionContext']>[0]): Promise<{
+        retrieval: import("../../../platform/memory/contracts.js").MemoryRetrievalContext;
+        catId: string;
+        boxId: string;
+        hydratedAt: string;
+        requestedSkills: string[];
+        sourceIds: string[];
+        derivedIds: string[];
+        memoryIds: string[];
+        responseProfile: import("../companion/contracts.js").CompanionResponseProfile;
+        sources: import("../companion/contracts.js").CompanionSessionSourceRef[];
+        derived: import("../companion/contracts.js").CompanionSessionDerivedRef[];
+        memory: import("../companion/contracts.js").CompanionSessionMemoryRef[];
+        ownerNotes: string[];
+        constraints: string[];
+        channelContext: {
+            channelId: string | null;
+            roomMode: "chat_channel" | "direct_message" | null;
+            transport: "telegram" | "line" | "web" | null;
+        };
+    }>;
+}
+export declare function createMemoryAwareCompanionBoxStore(delegate: CompanionBoxStore, memoryService: CatsMemoryService, coreStore?: CoreStore): CanonicalSyncAwareCompanionBoxStore;
+//# sourceMappingURL=companionMemoryAdapter.d.ts.map

package/build/server/products/chat/state/companionMemoryAdapter.d.ts.map

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