@agent-relay/factory 0.1.60 → 0.1.63

package/dist/state/document-store.d.ts

@@ -0,0 +1,32 @@
+import type { BabysitterGenerationRecord, BabysitterSessionState, ConversationSessionState, DiscoverySweepState, DispatchLifecycle, GithubIssueCommentWatchState, WaitingClarification } from '../ports/state.js';
+export type PersistedWorkspaceState = {
+    githubIssueCommentWatches: Record<string, GithubIssueCommentWatchState>;
+    waitingClarifications: Record<string, WaitingClarification>;
+    babysitterSessions: Record<string, BabysitterSessionState>;
+    babysitterGenerations: Record<string, BabysitterGenerationRecord>;
+    conversationSessions: Record<string, ConversationSessionState>;
+    dispatchLifecycles: Record<string, DispatchLifecycle>;
+    discoverySweep: DiscoverySweepState;
+};
+export type WatchStateDocument = {
+    version: 3;
+    workspaces: Record<string, PersistedWorkspaceState>;
+};
+/**
+ * Persistence seam for the document-backed StateStore behavior.
+ *
+ * Implementations must make each runMutation callback serializable with every
+ * other writer. A local file implementation can hold a filesystem lock; a
+ * remote implementation can use revisioned compare-and-set and retry the pure
+ * callback after a conflict.
+ */
+export interface WatchStateDocumentStore {
+    read(): Promise<WatchStateDocument>;
+    write(document: WatchStateDocument): Promise<void>;
+    runMutation<T>(operation: () => Promise<T>): Promise<T>;
+    assertReady(): Promise<void>;
+}
+export declare class WatchStateDocumentConflictError extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=document-store.d.ts.map

package/dist/state/document-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-store.d.ts","sourceRoot":"","sources":["../../src/state/document-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,MAAM,uBAAuB,GAAG;IACpC,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAA;IACvE,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IAC3D,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IAC1D,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAA;IACjE,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;IAC9D,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IACrD,cAAc,EAAE,mBAAmB,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,CAAC,CAAA;IACV,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;CACpD,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACnC,KAAK,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACvD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,qBAAa,+BAAgC,SAAQ,KAAK;gBAC5C,OAAO,SAAgD;CAIpE"}

package/dist/state/document-store.js

@@ -0,0 +1,7 @@
+export class WatchStateDocumentConflictError extends Error {
+    constructor(message = 'Factory state document changed concurrently') {
+        super(message);
+        this.name = 'WatchStateDocumentConflictError';
+    }
+}
+//# sourceMappingURL=document-store.js.map

package/dist/state/document-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-store.js","sourceRoot":"","sources":["../../src/state/document-store.ts"],"names":[],"mappings":"AAwCA,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IACxD,YAAY,OAAO,GAAG,6CAA6C;QACjE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAA;IAC/C,CAAC;CACF"}

package/dist/state/file-state-store.d.ts

@@ -1,7 +1,17 @@
-import type { BabysitterGenerationRecord, BabysitterSessionState, ClarificationReply, DispatchLifecycle, DispatchLifecycleClaim, GithubIssueCommentWatchState, ConversationMessage, ConversationSessionState, DiscoveryCheckpoint, DiscoverySweepClaim, WaitingClarification } from '../ports/state.js';
+import type { BabysitterGenerationRecord, BabysitterSessionState, ClarificationReply, DispatchLifecycle, DispatchLifecycleClaim, GithubIssueCommentWatchState, ConversationMessage, ConversationSessionState, DiscoveryCheckpoint, DiscoverySweepClaim, DiscoverySweepRenewal, WaitingClarification } from '../ports/state.js';
 import { InMemoryStateStore, type InMemoryStateStoreOptions } from './in-memory-state-store.js';
+import type { WatchStateDocumentStore } from './document-store.js';
 export type FileStateStoreOptions = InMemoryStateStoreOptions & {
     watchStatePath: string;
+    /** Injectable for deterministic stale-process lease recovery tests. */
+    isProcessAlive?: (pid: number) => boolean;
+};
+export type DocumentStateStoreOptions = InMemoryStateStoreOptions & {
+    /** Optional host-defined identifier surfaced by embedded CLI status. */
+    backend?: string;
+    documentStore: WatchStateDocumentStore;
+    /** Injectable for deterministic stale-process lease recovery tests. */
+    isProcessAlive?: (pid: number) => boolean;
 };
 export declare const githubWatchStatePath: (registryPath: string) => string;
 /**
@@ -12,11 +22,14 @@ export declare const githubWatchStatePath: (registryPath: string) => string;
  * Mutations reload under an advisory lock so independent processes merge
  * updates instead of publishing divergent cached documents.
  */
-export declare class FileStateStore extends InMemoryStateStore {
+export declare class DocumentStateStore extends InMemoryStateStore {
     #private;
-    constructor(options: FileStateStoreOptions);
+    readonly backend?: string;
+    constructor(options: DocumentStateStoreOptions);
+    assertReady(): Promise<void>;
     claimDiscoverySweep(workspaceId: string, owner: string, nowMs: number, leaseMs: number): Promise<DiscoverySweepClaim>;
     renewDiscoverySweep(workspaceId: string, owner: string, epoch: number, nowMs: number, leaseMs: number): Promise<boolean>;
+    renewDiscoverySweepWithDetails(workspaceId: string, owner: string, epoch: number, nowMs: number, leaseMs: number): Promise<DiscoverySweepRenewal>;
     completeDiscoverySweep(workspaceId: string, owner: string, epoch: number, checkpoint?: DiscoveryCheckpoint): Promise<boolean>;
     deferDiscoverySweep(workspaceId: string, owner: string, epoch: number, backoffUntilMs: number, consecutiveOverloads: number): Promise<boolean>;
     releaseDiscoverySweep(workspaceId: string, owner: string, epoch: number): Promise<void>;
@@ -77,4 +90,8 @@ export declare class FileStateStore extends InMemoryStateStore {
     clearConversationSession(workspaceId: string, conversationId: string): Promise<void>;
     rebindConversationSession(workspaceId: string, conversationId: string, agent: ConversationSessionState['agent']): Promise<boolean>;
 }
+/** Node/file-backed state with the exact persistence and locking semantics used before the document seam. */
+export declare class FileStateStore extends DocumentStateStore {
+    constructor(options: FileStateStoreOptions);
+}
 //# sourceMappingURL=file-state-store.d.ts.map

package/dist/state/file-state-store.d.ts.map

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

package/dist/state/file-state-store.js

@@ -5,6 +5,7 @@ import lockfile from 'proper-lockfile';
 import { githubRepositoriesMatch } from '../github/repo-identity.js';
 import { InMemoryStateStore } from './in-memory-state-store.js';
 import { matchingGithubLifecycleEntry } from './github-lifecycle-identity.js';
+import { emptyDiscoverySweepState, parseWatchStateDocument } from './watch-state-document.js';
 export const githubWatchStatePath = (registryPath) => join(dirname(registryPath), 'github-issue-comment-watches.json');
 // proper-lockfile refreshes a live writer's lease at half this interval. If a
 // process crashes, the next writer can reclaim its lock after this TTL. The
@@ -20,14 +21,21 @@ const WATCH_STATE_LOCK_STALE_MS = 60_000;
  * Mutations reload under an advisory lock so independent processes merge
  * updates instead of publishing divergent cached documents.
  */
-export class FileStateStore extends InMemoryStateStore {
-    #watchStatePath;
+export class DocumentStateStore extends InMemoryStateStore {
+    backend;
+    #documentStore;
     #batchSize;
+    #isProcessAlive;
     #operation = Promise.resolve();
     constructor(options) {
         super(options);
-        this.#watchStatePath = options.watchStatePath;
+        this.backend = options.backend;
+        this.#documentStore = options.documentStore;
         this.#batchSize = options.batchSize;
+        this.#isProcessAlive = options.isProcessAlive ?? processIsAlive;
+    }
+    async assertReady() {
+        await this.#exclusive(async () => this.#documentStore.assertReady());
     }
     async claimDiscoverySweep(workspaceId, owner, nowMs, leaseMs) {
         return await this.#exclusive(async () => this.#withMutationLock(async () => {
@@ -37,7 +45,12 @@ export class FileStateStore extends InMemoryStateStore {
             if (state.backoffUntilMs > nowMs) {
                 return { acquired: false, reason: 'backoff', state: cloneDiscoverySweepState(state) };
             }
-            if (state.lease && state.lease.leaseUntilMs > nowMs) {
+            const reclaimedLease = state.lease &&
+                state.lease.leaseUntilMs > nowMs &&
+                discoveryLeaseOwnerIsOrphaned(state.lease.owner, owner, this.#isProcessAlive)
+                ? { ...state.lease }
+                : undefined;
+            if (state.lease && state.lease.leaseUntilMs > nowMs && !reclaimedLease) {
                 return { acquired: false, reason: 'in-flight', state: cloneDiscoverySweepState(state) };
             }
             const epoch = state.lastEpoch + 1;
@@ -48,18 +61,28 @@ export class FileStateStore extends InMemoryStateStore {
                 acquired: true,
                 state: cloneDiscoverySweepState(state),
                 lease: { ...state.lease },
+                ...(reclaimedLease ? { reclaimedLease } : {}),
             };
         }));
     }
     async renewDiscoverySweep(workspaceId, owner, epoch, nowMs, leaseMs) {
+        return (await this.renewDiscoverySweepWithDetails(workspaceId, owner, epoch, nowMs, leaseMs)).renewed;
+    }
+    async renewDiscoverySweepWithDetails(workspaceId, owner, epoch, nowMs, leaseMs) {
         return await this.#exclusive(async () => this.#withMutationLock(async () => {
             const document = await this.#loadFromDisk();
             const state = document.workspaces[workspaceId]?.discoverySweep;
-            if (!state || !discoveryLeaseMatches(state, owner, epoch) || state.lease.leaseUntilMs <= nowMs)
-                return false;
+            if (!state?.lease)
+                return { renewed: false, reason: 'missing' };
+            if (!discoveryLeaseMatches(state, owner, epoch)) {
+                return { renewed: false, reason: 'contended', observedLease: { ...state.lease } };
+            }
+            if (state.lease.leaseUntilMs <= nowMs) {
+                return { renewed: false, reason: 'expired', observedLease: { ...state.lease } };
+            }
             state.lease.leaseUntilMs = nowMs + leaseMs;
             await this.#persist(document);
-            return true;
+            return { renewed: true, lease: { ...state.lease } };
         }));
     }
     async completeDiscoverySweep(workspaceId, owner, epoch, checkpoint) {
@@ -746,9 +769,40 @@ export class FileStateStore extends InMemoryStateStore {
         }));
     }
     async #loadFromDisk() {
+        return await this.#documentStore.read();
+    }
+    async #persist(document) {
+        await this.#documentStore.write(document);
+    }
+    async #withMutationLock(operation) {
+        return await this.#documentStore.runMutation(operation);
+    }
+    async #exclusive(operation) {
+        const result = this.#operation.then(operation, operation);
+        this.#operation = result.then(() => undefined, () => undefined);
+        return await result;
+    }
+}
+/** Node/file-backed state with the exact persistence and locking semantics used before the document seam. */
+export class FileStateStore extends DocumentStateStore {
+    constructor(options) {
+        super({
+            batchSize: options.batchSize,
+            agentQuestionDedupeLimit: options.agentQuestionDedupeLimit,
+            isProcessAlive: options.isProcessAlive,
+            documentStore: new FileWatchStateDocumentStore(options.watchStatePath),
+        });
+    }
+}
+class FileWatchStateDocumentStore {
+    #watchStatePath;
+    constructor(watchStatePath) {
+        this.#watchStatePath = watchStatePath;
+    }
+    async read() {
         try {
             const parsed = JSON.parse(await readFile(this.#watchStatePath, 'utf8'));
-            return parseDocument(parsed);
+            return parseWatchStateDocument(parsed);
         }
         catch (error) {
             if (!isMissingFileError(error))
@@ -756,7 +810,7 @@ export class FileStateStore extends InMemoryStateStore {
             return { version: 3, workspaces: {} };
         }
     }
-    async #persist(document) {
+    async write(document) {
         const temporaryPath = `${this.#watchStatePath}.${process.pid}.${randomUUID()}.tmp`;
         try {
             const handle = await open(temporaryPath, 'wx', 0o600);
@@ -774,7 +828,7 @@ export class FileStateStore extends InMemoryStateStore {
             await rm(temporaryPath, { force: true });
         }
     }
-    async #withMutationLock(operation) {
+    async runMutation(operation) {
         await mkdir(dirname(this.#watchStatePath), { recursive: true });
         const release = await lockfile.lock(this.#watchStatePath, {
             realpath: false,
@@ -795,92 +849,10 @@ export class FileStateStore extends InMemoryStateStore {
             await release();
         }
     }
-    async #exclusive(operation) {
-        const result = this.#operation.then(operation, operation);
-        this.#operation = result.then(() => undefined, () => undefined);
-        return await result;
+    async assertReady() {
+        await this.read();
     }
 }
-const parseDocument = (value) => {
-    if (!isRecord(value) || !isRecord(value.workspaces)) {
-        throw new Error('Factory GitHub watch state file is invalid');
-    }
-    if (value.version === 3) {
-        const workspaces = {};
-        for (const [workspaceId, rawWorkspace] of Object.entries(value.workspaces)) {
-            if (!isRecord(rawWorkspace))
-                throw new Error('Factory GitHub watch state file is invalid');
-            const watches = rawWorkspace.githubIssueCommentWatches;
-            const clarifications = rawWorkspace.waitingClarifications;
-            const babysitters = rawWorkspace.babysitterSessions;
-            const generations = rawWorkspace.babysitterGenerations;
-            const conversations = rawWorkspace.conversationSessions;
-            const lifecycles = rawWorkspace.dispatchLifecycles;
-            const discoverySweep = rawWorkspace.discoverySweep;
-            if (!isRecord(watches) ||
-                !isRecord(clarifications) ||
-                (babysitters !== undefined && !isRecord(babysitters)) ||
-                (generations !== undefined && !isRecord(generations)) ||
-                (conversations !== undefined && !isRecord(conversations)) ||
-                (lifecycles !== undefined && !isRecord(lifecycles)) ||
-                (discoverySweep !== undefined && !isRecord(discoverySweep))) {
-                throw new Error('Factory GitHub watch state file is invalid');
-            }
-            workspaces[workspaceId] = {
-                githubIssueCommentWatches: watches,
-                waitingClarifications: clarifications,
-                babysitterSessions: parseBabysitterSessions(babysitters ?? {}),
-                babysitterGenerations: parseBabysitterGenerations(generations ?? {}),
-                conversationSessions: parseConversationSessions(conversations ?? {}),
-                dispatchLifecycles: (lifecycles ?? {}),
-                discoverySweep: parseDiscoverySweepState(discoverySweep),
-            };
-        }
-        return { version: 3, workspaces };
-    }
-    if (value.version === 2) {
-        const workspaces = {};
-        for (const [workspaceId, rawWorkspace] of Object.entries(value.workspaces)) {
-            if (!isRecord(rawWorkspace))
-                throw new Error('Factory GitHub watch state file is invalid');
-            const watches = rawWorkspace.githubIssueCommentWatches;
-            const clarifications = rawWorkspace.waitingClarifications;
-            const babysitters = rawWorkspace.babysitterSessions;
-            if (!isRecord(watches) || !isRecord(clarifications) || (babysitters !== undefined && !isRecord(babysitters))) {
-                throw new Error('Factory GitHub watch state file is invalid');
-            }
-            workspaces[workspaceId] = {
-                githubIssueCommentWatches: watches,
-                waitingClarifications: clarifications,
-                babysitterSessions: parseBabysitterSessions(babysitters ?? {}),
-                babysitterGenerations: {},
-                conversationSessions: {},
-                dispatchLifecycles: {},
-                discoverySweep: emptyDiscoverySweepState(),
-            };
-        }
-        return { version: 3, workspaces };
-    }
-    if (value.version === 1) {
-        const workspaces = {};
-        for (const [workspaceId, watches] of Object.entries(value.workspaces)) {
-            if (!isRecord(watches)) {
-                throw new Error('Factory GitHub watch state file is invalid');
-            }
-            workspaces[workspaceId] = {
-                githubIssueCommentWatches: watches,
-                waitingClarifications: {},
-                babysitterSessions: {},
-                babysitterGenerations: {},
-                conversationSessions: {},
-                dispatchLifecycles: {},
-                discoverySweep: emptyDiscoverySweepState(),
-            };
-        }
-        return { version: 3, workspaces };
-    }
-    throw new Error('Factory GitHub watch state file is invalid');
-};
 const cloneWatch = (watch) => structuredClone(watch);
 const cloneClarification = (record) => structuredClone(record);
 const cloneBabysitterSession = (session) => structuredClone(session);
@@ -889,30 +861,29 @@ const cloneConversationSession = (session) => structuredClone(session);
 const cloneDiscoveryCheckpoint = (checkpoint) => structuredClone(checkpoint);
 const cloneDiscoverySweepState = (state) => structuredClone(state);
 const discoveryLeaseMatches = (state, owner, epoch) => state.lease?.owner === owner && state.lease.epoch === epoch;
-const emptyDiscoverySweepState = () => ({
-    consecutiveOverloads: 0,
-    backoffUntilMs: 0,
-    lastEpoch: 0,
-});
-const parseDiscoverySweepState = (value) => {
-    if (value === undefined)
-        return emptyDiscoverySweepState();
-    if (!isRecord(value))
-        throw new Error('Factory GitHub watch state file is invalid');
-    const checkpoint = value.checkpoint;
-    const lease = value.lease;
-    const lastEpoch = value.lastEpoch ?? (isRecord(lease) ? lease.epoch : 0);
-    if (!Number.isSafeInteger(value.consecutiveOverloads) || value.consecutiveOverloads < 0 ||
-        !Number.isSafeInteger(value.backoffUntilMs) ||
-        !Number.isSafeInteger(lastEpoch) || lastEpoch < 0 ||
-        (lease !== undefined && (!isRecord(lease) || typeof lease.owner !== 'string' ||
-            !Number.isSafeInteger(lease.epoch) || !Number.isSafeInteger(lease.leaseUntilMs))) ||
-        (checkpoint !== undefined && (!isRecord(checkpoint) || !isRecord(checkpoint.trees) ||
-            !Number.isSafeInteger(checkpoint.updatedAtMs) ||
-            (checkpoint.highWatermark !== undefined && typeof checkpoint.highWatermark !== 'string') ||
-            !Object.values(checkpoint.trees).every((paths) => Array.isArray(paths) && paths.every((path) => typeof path === 'string')))))
-        throw new Error('Factory GitHub watch state file is invalid');
-    return structuredClone({ ...value, lastEpoch });
+const discoveryLeaseOwnerIsOrphaned = (incumbentOwner, claimantOwner, isProcessAlive) => {
+    if (incumbentOwner === claimantOwner)
+        return false;
+    const incumbentPid = discoveryLeaseOwnerPid(incumbentOwner);
+    if (incumbentPid === undefined)
+        return false;
+    return !isProcessAlive(incumbentPid);
+};
+const discoveryLeaseOwnerPid = (owner) => {
+    const match = /^(\d+):/u.exec(owner);
+    if (!match)
+        return undefined;
+    const pid = Number(match[1]);
+    return Number.isSafeInteger(pid) && pid > 0 ? pid : undefined;
+};
+const processIsAlive = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code !== 'ESRCH';
+    }
 };
 const CONVERSATION_HISTORY_LIMIT = 50;
 const conversationHasMessage = (session, id) => session.processedMessageIds.includes(id) ||
@@ -921,133 +892,6 @@ const conversationHasMessage = (session, id) => session.processedMessageIds.incl
     Boolean(session.delivery?.messages.some((message) => message.id === id));
 const compareConversationMessages = (left, right) => left.receivedAtMs - right.receivedAtMs ||
     (left.providerSequence ?? left.id).localeCompare(right.providerSequence ?? right.id, undefined, { numeric: true });
-const parseConversationSessions = (value) => {
-    const sessions = {};
-    for (const [conversationId, candidate] of Object.entries(value)) {
-        if (!isRecord(candidate) || !isRecord(candidate.issue) || !isRecord(candidate.agent) || !isRecord(candidate.context)) {
-            throw new Error('Factory GitHub watch state file is invalid');
-        }
-        const issue = candidate.issue;
-        const agent = candidate.agent;
-        const delivery = candidate.delivery;
-        if (typeof issue.uuid !== 'string' || typeof issue.key !== 'string' || typeof issue.path !== 'string' ||
-            typeof candidate.provider !== 'string' || typeof candidate.externalId !== 'string' ||
-            !Object.values(candidate.context).every((value) => typeof value === 'string') ||
-            typeof agent.name !== 'string' || typeof agent.sessionRef !== 'string' ||
-            !validConversationMessages(candidate.history) || !validConversationMessages(candidate.pending) ||
-            (candidate.processedMessageIds !== undefined && !validConversationMessageIds(candidate.processedMessageIds)) ||
-            (delivery !== undefined && !validConversationDelivery(delivery) && !validLegacyConversationDelivery(delivery))) {
-            throw new Error('Factory GitHub watch state file is invalid');
-        }
-        const session = structuredClone(candidate);
-        if (delivery !== undefined && validLegacyConversationDelivery(delivery)) {
-            session.pending = [...structuredClone(delivery.messages), ...session.pending];
-            delete session.delivery;
-        }
-        session.processedMessageIds = candidate.processedMessageIds === undefined
-            ? [...new Set([
-                    ...session.history,
-                    ...session.pending,
-                    ...(session.delivery?.messages ?? []),
-                ].map((message) => message.id))]
-            : [...candidate.processedMessageIds];
-        sessions[conversationId] = session;
-    }
-    return sessions;
-};
-const validConversationMessages = (value) => Array.isArray(value) && value.every((message) => isRecord(message) &&
-    typeof message.id === 'string' && typeof message.text === 'string' &&
-    typeof message.receivedAtMs === 'number' &&
-    (message.providerSequence === undefined || typeof message.providerSequence === 'string') &&
-    (message.author === undefined || typeof message.author === 'string'));
-const validConversationDelivery = (value) => isRecord(value) &&
-    typeof value.claimId === 'string' && typeof value.owner === 'string' &&
-    typeof value.claimedAtMs === 'number' && typeof value.attempts === 'number' &&
-    validConversationMessages(value.messages) && isRecord(value.agent) &&
-    typeof value.agent.name === 'string' && typeof value.agent.sessionRef === 'string';
-const validLegacyConversationDelivery = (value) => isRecord(value) && value.claimId === undefined && value.agent === undefined &&
-    typeof value.owner === 'string' && typeof value.claimedAtMs === 'number' &&
-    typeof value.attempts === 'number' && validConversationMessages(value.messages);
-const validConversationMessageIds = (value) => Array.isArray(value) && value.every((id) => typeof id === 'string');
-const parseBabysitterSessions = (value) => {
-    const sessions = {};
-    for (const [key, candidate] of Object.entries(value)) {
-        if (!isRecord(candidate) || !isRecord(candidate.issue)) {
-            throw new Error('Factory GitHub watch state file is invalid');
-        }
-        const issue = candidate.issue;
-        if (typeof issue.uuid !== 'string' ||
-            typeof issue.key !== 'string' ||
-            typeof issue.path !== 'string' ||
-            typeof candidate.repo !== 'string' ||
-            !Number.isSafeInteger(candidate.prNumber) ||
-            candidate.prNumber < 1 ||
-            typeof candidate.agentName !== 'string' ||
-            (candidate.path !== undefined && typeof candidate.path !== 'string') ||
-            typeof candidate.critical !== 'boolean' ||
-            !Array.isArray(candidate.pendingKinds) ||
-            !candidate.pendingKinds.every((kind) => typeof kind === 'string') ||
-            (candidate.pendingDeliveryClaims !== undefined && (!Array.isArray(candidate.pendingDeliveryClaims) ||
-                !candidate.pendingDeliveryClaims.every((claim) => isRecord(claim) && typeof claim.deliveryId === 'string' && typeof claim.claimToken === 'string'))) ||
-            (candidate.resourceSubscription !== undefined && (!isRecord(candidate.resourceSubscription) ||
-                typeof candidate.resourceSubscription.subscriptionId !== 'string' ||
-                typeof candidate.resourceSubscription.provider !== 'string' ||
-                typeof candidate.resourceSubscription.resourceRef !== 'string' ||
-                typeof candidate.resourceSubscription.subscriberId !== 'string' ||
-                typeof candidate.resourceSubscription.ownerId !== 'string' ||
-                typeof candidate.resourceSubscription.expiresAt !== 'string' ||
-                (candidate.resourceSubscription.terminal !== undefined && typeof candidate.resourceSubscription.terminal !== 'boolean')))) {
-            throw new Error('Factory GitHub watch state file is invalid');
-        }
-        sessions[key] = {
-            issue: { uuid: issue.uuid, key: issue.key, path: issue.path },
-            repo: candidate.repo,
-            prNumber: candidate.prNumber,
-            agentName: candidate.agentName,
-            ...(candidate.path === undefined ? {} : { path: candidate.path }),
-            critical: candidate.critical,
-            pendingKinds: [...candidate.pendingKinds],
-            ...(candidate.resourceSubscription === undefined ? {} : {
-                resourceSubscription: {
-                    subscriptionId: candidate.resourceSubscription.subscriptionId,
-                    provider: candidate.resourceSubscription.provider,
-                    resourceRef: candidate.resourceSubscription.resourceRef,
-                    subscriberId: candidate.resourceSubscription.subscriberId,
-                    ownerId: candidate.resourceSubscription.ownerId,
-                    expiresAt: candidate.resourceSubscription.expiresAt,
-                    ...(candidate.resourceSubscription.terminal === undefined ? {} : { terminal: candidate.resourceSubscription.terminal }),
-                },
-            }),
-            ...(candidate.pendingDeliveryClaims === undefined ? {} : {
-                pendingDeliveryClaims: candidate.pendingDeliveryClaims.map((claim) => ({
-                    deliveryId: claim.deliveryId,
-                    claimToken: claim.claimToken,
-                })),
-            }),
-        };
-    }
-    return sessions;
-};
-const parseBabysitterGenerations = (value) => {
-    const generations = {};
-    for (const [key, candidate] of Object.entries(value)) {
-        if (!isRecord(candidate) ||
-            typeof candidate.generationId !== 'string' ||
-            typeof candidate.agentName !== 'string' ||
-            !Number.isSafeInteger(candidate.claimedAtMs) ||
-            !Number.isSafeInteger(candidate.leaseUntilMs) ||
-            (candidate.phase !== 'claimed' && candidate.phase !== 'completed'))
-            throw new Error('Factory GitHub watch state file is invalid');
-        generations[key] = {
-            generationId: candidate.generationId,
-            agentName: candidate.agentName,
-            claimedAtMs: candidate.claimedAtMs,
-            leaseUntilMs: candidate.leaseUntilMs,
-            phase: candidate.phase,
-        };
-    }
-    return generations;
-};
 const cloneLifecycle = (record) => structuredClone(record);
 const dispatchLifecycleLeaseMatches = (current, expected) => current === undefined
     ? expected === undefined