@animalabs/agent-framework 0.6.6 → 0.6.8

package/dist/src/recovery/discord-awareness-outbox.js

@@ -0,0 +1,334 @@
+import { mkdirSync, readFileSync, renameSync, writeFileSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+export const DEFAULT_DISCORD_AWARENESS_EMOJI = '💤';
+export function defaultDiscordAwarenessOutboxPath(storePath) {
+    return join(storePath, 'recovery', 'discord-awareness-outbox.json');
+}
+/** Extract Discord addressing metadata without reading message content. */
+export function extractDiscordAwarenessRefs(messages, forcedServerId) {
+    const refs = new Map();
+    for (const message of messages) {
+        const metadata = message.metadata ?? {};
+        const channelId = typeof metadata.channelId === 'string' ? metadata.channelId : '';
+        const messageId = typeof metadata.messageId === 'string' ? metadata.messageId : '';
+        const metadataServerId = typeof metadata.serverId === 'string' ? metadata.serverId : '';
+        const serverId = forcedServerId ?? metadataServerId;
+        if (!channelId || !messageId || !serverId)
+            continue;
+        const isDiscord = serverId.toLowerCase().includes('discord') || channelId.startsWith('discord:');
+        if (!isDiscord)
+            continue;
+        const ref = { serverId, channelId, messageId };
+        refs.set(refKey(ref), ref);
+    }
+    return [...refs.values()];
+}
+/**
+ * A branch-independent, durable operation ledger for Discord awareness marks.
+ *
+ * Completed entries are retained. Reconciliation derives whether their emoji
+ * should currently exist from Chronicle branch ancestry, queuing `remove`
+ * after switching away from a recovery branch and `add` when returning to it.
+ */
+export class DiscordAwarenessOutbox {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    prepare(input) {
+        const refs = dedupeRefs(input.refs);
+        if (refs.length === 0 && !input.suppressionIntervals?.length)
+            return null;
+        const document = this.read();
+        const batch = {
+            id: randomUUID(),
+            status: 'prepared',
+            agentName: input.agentName,
+            sourceBranch: input.sourceBranch,
+            targetBranch: input.targetBranch,
+            emoji: input.emoji ?? DEFAULT_DISCORD_AWARENESS_EMOJI,
+            createdAt: Date.now(),
+            refs: refs.map((ref) => ({
+                ...ref,
+                desired: false,
+                markerPresent: false,
+                deliveryStatus: 'applied',
+                attempts: 0,
+            })),
+            activationPolicy: input.activationPolicy ?? 'target-branch',
+            suppressionIntervals: input.suppressionIntervals?.map((interval) => ({ ...interval })),
+        };
+        document.batches.push(batch);
+        this.write(document);
+        return structuredClone(batch);
+    }
+    /** Activate after Chronicle has safely switched to the target branch. */
+    activate(batchId) {
+        const document = this.read();
+        const batch = document.batches.find((candidate) => candidate.id === batchId);
+        if (!batch)
+            throw new Error(`Discord awareness outbox batch not found: ${batchId}`);
+        batch.status = 'active';
+        for (const ref of batch.refs)
+            setDesired(ref, true);
+        this.write(document);
+    }
+    /**
+     * Reconcile every retained ledger entry against the active branch. A marker
+     * is desired when any active batch for the same ref+emoji has a target branch
+     * in the active branch's ancestry.
+     */
+    reconcileForBranch(branchName, branches = []) {
+        const document = this.read();
+        let activated = 0;
+        for (const batch of document.batches) {
+            if (batch.status === 'prepared'
+                && (batch.activationPolicy ?? 'target-branch') === 'target-branch'
+                && isTargetActive(branchName, batch.targetBranch, branches)) {
+                batch.status = 'active';
+                activated++;
+            }
+        }
+        const desiredKeys = new Set();
+        for (const batch of document.batches) {
+            if (batch.status !== 'active')
+                continue;
+            if (!isTargetActive(branchName, batch.targetBranch, branches))
+                continue;
+            for (const ref of batch.refs)
+                desiredKeys.add(markerKey(batch.emoji, ref));
+        }
+        let queued = 0;
+        for (const batch of document.batches) {
+            if (batch.status !== 'active')
+                continue;
+            for (const ref of batch.refs) {
+                setDesired(ref, desiredKeys.has(markerKey(batch.emoji, ref)));
+                if (ref.deliveryStatus === 'pending')
+                    queued++;
+            }
+        }
+        this.write(document);
+        return { activated, queued };
+    }
+    /** Backward-compatible startup helper. */
+    activatePreparedForBranch(branchName, branches = []) {
+        return this.reconcileForBranch(branchName, branches).activated;
+    }
+    pending(serverId) {
+        const operations = [];
+        for (const batch of this.read().batches) {
+            if (batch.status !== 'active')
+                continue;
+            for (const ref of batch.refs) {
+                if (ref.deliveryStatus !== 'pending')
+                    continue;
+                if (serverId !== undefined && ref.serverId !== serverId)
+                    continue;
+                operations.push({
+                    batchId: batch.id,
+                    emoji: batch.emoji,
+                    action: ref.desired ? 'add' : 'remove',
+                    ref: { ...ref },
+                });
+            }
+        }
+        return operations;
+    }
+    recordSuccess(batchId, ref, action) {
+        const document = this.read();
+        const entry = findEntry(document, batchId, ref);
+        if (!entry)
+            return;
+        entry.markerPresent = action === 'add';
+        entry.deliveryStatus = entry.markerPresent === entry.desired ? 'applied' : 'pending';
+        entry.attempts++;
+        entry.lastAction = action;
+        entry.lastAttemptAt = Date.now();
+        delete entry.lastError;
+        this.write(document);
+    }
+    recordFailure(batchId, ref, action, error, permanent) {
+        const document = this.read();
+        const entry = findEntry(document, batchId, ref);
+        if (!entry)
+            return;
+        entry.deliveryStatus = permanent ? 'permanent-failure' : 'pending';
+        entry.attempts++;
+        entry.lastAction = action;
+        entry.lastAttemptAt = Date.now();
+        entry.lastError = error;
+        this.write(document);
+    }
+    /** Compatibility alias for older callers that only acknowledged adds. */
+    acknowledge(batchId, ref) {
+        this.recordSuccess(batchId, ref, 'add');
+    }
+    batches() {
+        return structuredClone(this.read().batches);
+    }
+    preparedSuppressionsForBranch(branchName, branches = []) {
+        return structuredClone(this.read().batches.filter((batch) => batch.status === 'prepared'
+            && batch.activationPolicy === 'explicit'
+            && !!batch.suppressionIntervals?.length
+            && isTargetActive(branchName, batch.targetBranch, branches)));
+    }
+    read() {
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(this.path, 'utf8'));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return { version: 2, batches: [] };
+            }
+            throw new Error(`Could not read Discord awareness outbox ${this.path}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (isDocumentV2(parsed))
+            return parsed;
+        if (isDocumentV1(parsed))
+            return migrateV1(parsed);
+        throw new Error(`Invalid Discord awareness outbox document: ${this.path}`);
+    }
+    write(document) {
+        mkdirSync(dirname(this.path), { recursive: true });
+        const temporary = `${this.path}.${process.pid}.${randomUUID()}.tmp`;
+        writeFileSync(temporary, `${JSON.stringify(document, null, 2)}\n`, { mode: 0o600 });
+        renameSync(temporary, this.path);
+    }
+}
+function setDesired(ref, desired) {
+    const changed = ref.desired !== desired;
+    ref.desired = desired;
+    if (ref.markerPresent === desired) {
+        ref.deliveryStatus = 'applied';
+        return;
+    }
+    const action = desired ? 'add' : 'remove';
+    if (changed || ref.lastAction !== action || ref.deliveryStatus !== 'permanent-failure') {
+        ref.deliveryStatus = 'pending';
+    }
+}
+function isTargetActive(activeName, targetName, branches) {
+    if (activeName === targetName)
+        return true;
+    const byName = new Map(branches.map((branch) => [branch.name, branch]));
+    const byId = new Map(branches.map((branch) => [branch.id, branch]));
+    let cursor = byName.get(activeName);
+    const visited = new Set();
+    while (cursor?.parentId && !visited.has(cursor.id)) {
+        visited.add(cursor.id);
+        cursor = byId.get(cursor.parentId);
+        if (cursor?.name === targetName)
+            return true;
+    }
+    return false;
+}
+function findEntry(document, batchId, ref) {
+    return document.batches
+        .find((batch) => batch.id === batchId)
+        ?.refs.find((candidate) => refKey(candidate) === refKey(ref));
+}
+function dedupeRefs(refs) {
+    const deduped = new Map();
+    for (const ref of refs) {
+        if (!ref.serverId || !ref.channelId || !ref.messageId)
+            continue;
+        deduped.set(refKey(ref), { ...ref });
+    }
+    return [...deduped.values()];
+}
+function refKey(ref) {
+    return `${ref.serverId}\0${ref.channelId}\0${ref.messageId}`;
+}
+function markerKey(emoji, ref) {
+    return `${emoji}\0${refKey(ref)}`;
+}
+function isEntry(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const entry = value;
+    return typeof entry.serverId === 'string'
+        && typeof entry.channelId === 'string'
+        && typeof entry.messageId === 'string'
+        && typeof entry.desired === 'boolean'
+        && typeof entry.markerPresent === 'boolean'
+        && (entry.deliveryStatus === 'pending'
+            || entry.deliveryStatus === 'applied'
+            || entry.deliveryStatus === 'permanent-failure')
+        && typeof entry.attempts === 'number'
+        && (entry.lastAction === undefined || entry.lastAction === 'add' || entry.lastAction === 'remove')
+        && (entry.lastAttemptAt === undefined || typeof entry.lastAttemptAt === 'number')
+        && (entry.lastError === undefined || typeof entry.lastError === 'string');
+}
+function isDocumentV2(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const document = value;
+    if (document.version !== 2 || !Array.isArray(document.batches))
+        return false;
+    return document.batches.every((batch) => {
+        if (!batch || typeof batch !== 'object')
+            return false;
+        const candidate = batch;
+        return typeof candidate.id === 'string'
+            && (candidate.status === 'prepared' || candidate.status === 'active')
+            && typeof candidate.agentName === 'string'
+            && typeof candidate.sourceBranch === 'string'
+            && typeof candidate.targetBranch === 'string'
+            && typeof candidate.emoji === 'string'
+            && typeof candidate.createdAt === 'number'
+            && Array.isArray(candidate.refs)
+            && (candidate.activationPolicy === undefined
+                || candidate.activationPolicy === 'target-branch'
+                || candidate.activationPolicy === 'explicit')
+            && (candidate.suppressionIntervals === undefined
+                || (Array.isArray(candidate.suppressionIntervals)
+                    && candidate.suppressionIntervals.every((interval) => !!interval
+                        && typeof interval.fromId === 'string'
+                        && typeof interval.toId === 'string')))
+            && candidate.refs.every(isEntry);
+    });
+}
+function isDocumentV1(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const document = value;
+    if (document.version !== 1 || !Array.isArray(document.batches))
+        return false;
+    return document.batches.every((batch) => {
+        if (!batch || typeof batch !== 'object')
+            return false;
+        const candidate = batch;
+        return typeof candidate.id === 'string'
+            && (candidate.status === 'prepared' || candidate.status === 'pending')
+            && typeof candidate.agentName === 'string'
+            && typeof candidate.sourceBranch === 'string'
+            && typeof candidate.targetBranch === 'string'
+            && typeof candidate.emoji === 'string'
+            && typeof candidate.createdAt === 'number'
+            && Array.isArray(candidate.refs)
+            && candidate.refs.every((ref) => !!ref
+                && typeof ref.serverId === 'string'
+                && typeof ref.channelId === 'string'
+                && typeof ref.messageId === 'string');
+    });
+}
+function migrateV1(document) {
+    return {
+        version: 2,
+        batches: document.batches.map((batch) => ({
+            ...batch,
+            status: batch.status === 'pending' ? 'active' : 'prepared',
+            refs: batch.refs.map((ref) => ({
+                ...ref,
+                desired: batch.status === 'pending',
+                markerPresent: false,
+                deliveryStatus: batch.status === 'pending' ? 'pending' : 'applied',
+                attempts: 0,
+            })),
+        })),
+    };
+}
+//# sourceMappingURL=discord-awareness-outbox.js.map

package/dist/src/recovery/discord-awareness-outbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-awareness-outbox.js","sourceRoot":"","sources":["../../../src/recovery/discord-awareness-outbox.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAEpD,MAAM,UAAU,iCAAiC,CAAC,SAAiB;IACjE,OAAO,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,+BAA+B,CAAC,CAAC;AACtE,CAAC;AAkED,2EAA2E;AAC3E,MAAM,UAAU,2BAA2B,CACzC,QAAyC,EACzC,cAAuB;IAEvB,MAAM,IAAI,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEpD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,MAAM,SAAS,GAAG,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,MAAM,gBAAgB,GAAG,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,MAAM,QAAQ,GAAG,cAAc,IAAI,gBAAgB,CAAC;QACpD,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ;YAAE,SAAS;QAEpD,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACjG,IAAI,CAAC,SAAS;YAAE,SAAS;QAEzB,MAAM,GAAG,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,sBAAsB;IACZ;IAArB,YAAqB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAErC,OAAO,CAAC,KAQP;QACC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,MAAM;YAAE,OAAO,IAAI,CAAC;QAE1E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,KAAK,GAA0B;YACnC,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,+BAA+B;YACrD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACvB,GAAG,GAAG;gBACN,OAAO,EAAE,KAAK;gBACd,aAAa,EAAE,KAAK;gBACpB,cAAc,EAAE,SAAS;gBACzB,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC;YACH,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,eAAe;YAC3D,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;SACvF,CAAC;QACF,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,yEAAyE;IACzE,QAAQ,CAAC,OAAe;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;QAC7E,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,EAAE,CAAC,CAAC;QACpF,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI;YAAE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAChB,UAAkB,EAClB,WAA+B,EAAE;QAEjC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,IACE,KAAK,CAAC,MAAM,KAAK,UAAU;mBACxB,CAAC,KAAK,CAAC,gBAAgB,IAAI,eAAe,CAAC,KAAK,eAAe;mBAC/D,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,EAC3D,CAAC;gBACD,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;gBACxB,SAAS,EAAE,CAAC;YACd,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAS;YACxC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC;gBAAE,SAAS;YACxE,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI;gBAAE,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAS;YACxC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC7B,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC9D,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS;oBAAE,MAAM,EAAE,CAAC;YACjD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED,0CAA0C;IAC1C,yBAAyB,CAAC,UAAkB,EAAE,WAA+B,EAAE;QAC7E,OAAO,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC;IAED,OAAO,CAAC,QAAiB;QACvB,MAAM,UAAU,GAAgC,EAAE,CAAC;QACnD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAS;YACxC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC7B,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS;oBAAE,SAAS;gBAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;oBAAE,SAAS;gBAClE,UAAU,CAAC,IAAI,CAAC;oBACd,OAAO,EAAE,KAAK,CAAC,EAAE;oBACjB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ;oBACtC,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,aAAa,CAAC,OAAe,EAAE,GAAwB,EAAE,MAA8B;QACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,KAAK,CAAC,aAAa,GAAG,MAAM,KAAK,KAAK,CAAC;QACvC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,aAAa,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACrF,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjB,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC;QAC1B,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,SAAS,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED,aAAa,CACX,OAAe,EACf,GAAwB,EACxB,MAA8B,EAC9B,KAAa,EACb,SAAkB;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,KAAK,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjB,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC;QAC1B,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED,yEAAyE;IACzE,WAAW,CAAC,OAAe,EAAE,GAAwB;QACnD,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO;QACL,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,6BAA6B,CAC3B,UAAkB,EAClB,WAA+B,EAAE;QAEjC,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1D,KAAK,CAAC,MAAM,KAAK,UAAU;eACxB,KAAK,CAAC,gBAAgB,KAAK,UAAU;eACrC,CAAC,CAAC,KAAK,CAAC,oBAAoB,EAAE,MAAM;eACpC,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAEO,IAAI;QACV,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACrC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,2CAA2C,IAAI,CAAC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClH,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACxC,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAEO,KAAK,CAAC,QAAwC;QACpD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,MAAM,CAAC;QACpE,aAAa,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpF,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF;AAED,SAAS,UAAU,CAAC,GAA0B,EAAE,OAAgB;IAC9D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC;IACxC,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,IAAI,GAAG,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;QAClC,GAAG,CAAC,cAAc,GAAG,SAAS,CAAC;QAC/B,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAA2B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClE,IAAI,OAAO,IAAI,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,GAAG,CAAC,cAAc,KAAK,mBAAmB,EAAE,CAAC;QACvF,GAAG,CAAC,cAAc,GAAG,SAAS,CAAC;IACjC,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,UAAkB,EAClB,UAAkB,EAClB,QAA4B;IAE5B,IAAI,UAAU,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,OAAO,MAAM,EAAE,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvB,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,MAAM,EAAE,IAAI,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAChB,QAAwC,EACxC,OAAe,EACf,GAAwB;IAExB,OAAO,QAAQ,CAAC,OAAO;SACpB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC;QACtC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,UAAU,CAAC,IAA2B;IAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;IACvD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,SAAS;YAAE,SAAS;QAChE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,MAAM,CAAC,GAAwB;IACtC,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,GAAwB;IACxD,OAAO,GAAG,KAAK,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,KAAK,GAAG,KAAuC,CAAC;IACtD,OAAO,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;WACpC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;WACnC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;WACnC,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;WAClC,OAAO,KAAK,CAAC,aAAa,KAAK,SAAS;WACxC,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS;eACjC,KAAK,CAAC,cAAc,KAAK,SAAS;eAClC,KAAK,CAAC,cAAc,KAAK,mBAAmB,CAAC;WAC/C,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;WAClC,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC;WAC/F,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC;WAC9E,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,QAAQ,GAAG,KAAiD,CAAC;IACnE,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7E,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACtD,MAAM,SAAS,GAAG,KAAuC,CAAC;QAC1D,OAAO,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ;eAClC,CAAC,SAAS,CAAC,MAAM,KAAK,UAAU,IAAI,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC;eAClE,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ;eACvC,OAAO,SAAS,CAAC,YAAY,KAAK,QAAQ;eAC1C,OAAO,SAAS,CAAC,YAAY,KAAK,QAAQ;eAC1C,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ;eACnC,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ;eACvC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;eAC7B,CAAC,SAAS,CAAC,gBAAgB,KAAK,SAAS;mBACvC,SAAS,CAAC,gBAAgB,KAAK,eAAe;mBAC9C,SAAS,CAAC,gBAAgB,KAAK,UAAU,CAAC;eAC5C,CAAC,SAAS,CAAC,oBAAoB,KAAK,SAAS;mBAC3C,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC;uBAC5C,SAAS,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,CACnD,CAAC,CAAC,QAAQ;2BACP,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ;2BACnC,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC;eAC1C,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC;AAiBD,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,QAAQ,GAAG,KAAiD,CAAC;IACnE,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7E,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACtD,MAAM,SAAS,GAAG,KAA0C,CAAC;QAC7D,OAAO,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ;eAClC,CAAC,SAAS,CAAC,MAAM,KAAK,UAAU,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC;eACnE,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ;eACvC,OAAO,SAAS,CAAC,YAAY,KAAK,QAAQ;eAC1C,OAAO,SAAS,CAAC,YAAY,KAAK,QAAQ;eAC1C,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ;eACnC,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ;eACvC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;eAC7B,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG;mBACjC,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ;mBAChC,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;mBACjC,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,QAAwB;IACzC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxC,GAAG,KAAK;YACR,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;YAC1D,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC7B,GAAG,GAAG;gBACN,OAAO,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS;gBACnC,aAAa,EAAE,KAAK;gBACpB,cAAc,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gBAClE,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/src/recovery/offline-branch.d.ts

@@ -0,0 +1,45 @@
+import { type DiscordAwarenessRef } from './discord-awareness-outbox.js';
+export interface OfflineRecoveryBranchOptions {
+    storePath: string;
+    agentName: string;
+    /** Preferred: Discord message that remains as the last visible anchor. */
+    messageId?: string;
+    /** Exact internal ContextManager message ID that remains as the anchor. */
+    contextId?: string;
+    /** Backward-compatible alternative: remove the newest N context entries. */
+    messages?: number;
+    /** Exact Discord messages to suppress on the new branch. */
+    suppressMessageIds?: string[];
+    /** Inclusive context-order ranges between Discord message endpoints. */
+    suppressRanges?: Array<{
+        fromMessageId: string;
+        toMessageId: string;
+    }>;
+    branchName?: string;
+    /** Defaults to the primary-agent namespace `agents/{agentName}`. */
+    namespace?: string;
+    /** Use for old message records that do not carry metadata.serverId. */
+    discordServerId?: string;
+    outboxPath?: string;
+    emoji?: string;
+    dryRun?: boolean;
+}
+export interface OfflineRecoveryBranchResult {
+    dryRun: boolean;
+    sourceBranch: string;
+    targetBranch: string;
+    messagesRemoved: number;
+    messagesSuppressed: number;
+    discordMarkersQueued: number;
+    refs: DiscordAwarenessRef[];
+    outboxPath: string;
+}
+/**
+ * Create a safe Chronicle branch while the normal agent host is stopped.
+ *
+ * History is scanned in bounded windows and blobs are not re-inlined. The
+ * affected messages are never compiled and their content is never written to
+ * the recovery outbox; only Discord addressing metadata leaves Chronicle.
+ */
+export declare function createOfflineRecoveryBranch(options: OfflineRecoveryBranchOptions): Promise<OfflineRecoveryBranchResult>;
+//# sourceMappingURL=offline-branch.d.ts.map

package/dist/src/recovery/offline-branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-branch.d.ts","sourceRoot":"","sources":["../../../src/recovery/offline-branch.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,mBAAmB,EACzB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,wEAAwE;IACxE,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CA6KtC"}