@sema-agent/core 2.13.0 → 4.0.0

package/dist/prompt-assembly/artifact-store.js

@@ -1,6 +1,9 @@
 import { mkdirSync, promises as fs } from "node:fs";
 import path from "node:path";
 import { verifyPromptArtifact, } from "./artifact.js";
+function normalizedEnvelope(parsed, artifact) {
+    return { ...parsed, artifact };
+}
 export class MemoryPromptArtifactStore {
     byDigest = new Map();
     async get(artifactDigest, opts) {
@@ -17,7 +20,7 @@ export class MemoryPromptArtifactStore {
         const v = verifyPromptArtifact(parsed, opts);
         if (!v.ok || v.artifact.artifactDigest !== artifactDigest)
             return undefined;
-        return parsed;
+        return normalizedEnvelope(parsed, v.artifact);
     }
     async put(envelope) {
         this.byDigest.set(envelope.artifact.artifactDigest, JSON.stringify(envelope));
@@ -54,7 +57,7 @@ export class FilePromptArtifactStore {
         const v = verifyPromptArtifact(parsed, opts);
         if (!v.ok || v.artifact.artifactDigest !== artifactDigest)
             return undefined;
-        return parsed;
+        return normalizedEnvelope(parsed, v.artifact);
     }
     async put(envelope) {
         const file = this.fileFor(envelope.artifact.artifactDigest);
@@ -113,6 +116,12 @@ export class CenterPromptSource {
     engineVersion;
     candidate;
     state = "unavailable";
+    tail = Promise.resolve();
+    exclusive(fn) {
+        const run = this.tail.then(fn, fn);
+        this.tail = run.then(() => undefined, () => undefined);
+        return run;
+    }
     constructor(opts) {
         this.store = opts.store;
         this.stateStore = opts.stateStore ?? new MemoryPromptSourceStateStore();
@@ -128,20 +137,22 @@ export class CenterPromptSource {
         return env?.artifact;
     }
     async restore() {
-        const state = await this.stateStore.load();
-        if (state?.state === "disabled") {
-            this.candidate = undefined;
-            this.state = "disabled";
-            return;
-        }
-        if (state?.state !== "active") {
-            this.candidate = undefined;
-            this.state = "unavailable";
-            return;
-        }
-        const env = await this.store.get(state.artifactDigest, { engineVersion: this.engineVersion });
-        this.candidate = env !== undefined ? { artifact: env.artifact, sourceRevision: state.sourceRevision } : undefined;
-        this.state = env !== undefined ? "active" : "unavailable";
+        return this.exclusive(async () => {
+            const state = await this.stateStore.load();
+            if (state?.state === "disabled") {
+                this.candidate = undefined;
+                this.state = "disabled";
+                return;
+            }
+            if (state?.state !== "active") {
+                this.candidate = undefined;
+                this.state = "unavailable";
+                return;
+            }
+            const env = await this.store.get(state.artifactDigest, { engineVersion: this.engineVersion });
+            this.candidate = env !== undefined ? { artifact: env.artifact, sourceRevision: state.sourceRevision } : undefined;
+            this.state = env !== undefined ? "active" : "unavailable";
+        });
     }
     sourceState() {
         return this.state;
@@ -151,15 +162,19 @@ export class CenterPromptSource {
         if (!v.ok)
             return v;
         const envelope = raw;
-        await this.store.put(envelope);
-        await this.stateStore.save({ state: "active", artifactDigest: v.artifact.artifactDigest, sourceRevision: envelope.sourceRevision });
-        this.candidate = { artifact: v.artifact, sourceRevision: envelope.sourceRevision };
-        this.state = "active";
-        return { ok: true, artifactDigest: v.artifact.artifactDigest };
+        return this.exclusive(async () => {
+            await this.store.put(envelope);
+            await this.stateStore.save({ state: "active", artifactDigest: v.artifact.artifactDigest, sourceRevision: envelope.sourceRevision });
+            this.candidate = { artifact: v.artifact, sourceRevision: envelope.sourceRevision };
+            this.state = "active";
+            return { ok: true, artifactDigest: v.artifact.artifactDigest };
+        });
     }
     async applyDisabled(sourceRevision) {
-        await this.stateStore.save({ state: "disabled", sourceRevision });
-        this.candidate = undefined;
-        this.state = "disabled";
+        return this.exclusive(async () => {
+            await this.stateStore.save({ state: "disabled", sourceRevision });
+            this.candidate = undefined;
+            this.state = "disabled";
+        });
     }
 }

package/dist/prompt-assembly/assemble.js

@@ -40,6 +40,7 @@ function mountDeclarations(basePack, decls, onWarn) {
     const counters = {};
     const extra = [];
     let replacesRoleBase = false;
+    let replacedRoleBaseBy;
     for (const d of decls) {
         if (!d.id || d.id.startsWith("core/") || d.id.length > 128 || !/^[a-z0-9][a-z0-9/._-]*$/.test(d.id)) {
             throw new Error(`prompt-provider stableBlocks: invalid section id ${JSON.stringify(d.id).slice(0, 140)} (must match ^[a-z0-9][a-z0-9/._-]*$, ≤128 chars, non-core/)`);
@@ -47,8 +48,10 @@ function mountDeclarations(basePack, decls, onWarn) {
         const base = SLOT_BASE[d.slot];
         if (base === undefined)
             throw new Error(`prompt-provider stableBlocks: unknown slot "${String(d.slot)}" ("${d.id}")`);
-        if (d.slot === "identity")
+        if (d.slot === "identity") {
             replacesRoleBase = true;
+            replacedRoleBaseBy ??= d.id;
+        }
         const n = (counters[d.slot] = (counters[d.slot] ?? 0) + 1);
         const declaredContentHash = verifyDeclaredContentHash(d, onWarn);
         extra.push({
@@ -68,10 +71,21 @@ function mountDeclarations(basePack, decls, onWarn) {
         });
     }
     return {
-        ...basePack,
-        sections: [...basePack.sections.filter((s) => !(replacesRoleBase && s.id === "core/role.base")), ...extra],
+        pack: {
+            ...basePack,
+            sections: [...basePack.sections.filter((s) => !(replacesRoleBase && s.id === "core/role.base")), ...extra],
+        },
+        ...(replacedRoleBaseBy !== undefined && basePack.sections.some((s) => s.id === "core/role.base")
+            ? { replacedRoleBaseBy }
+            : {}),
     };
 }
+function warnRoleBaseEviction(replacedRoleBaseBy, origin, onWarn) {
+    if (replacedRoleBaseBy === undefined || origin === "pack-default")
+        return;
+    const what = origin === "task-system-prompt" ? "the caller's per-task systemPrompt" : "the PromptProvider's own role text";
+    onWarn?.(`prompt-constitution: identity declaration "${replacedRoleBaseBy}" supplants the role base, so ${what} does NOT compose into this prompt (identity sections replace the role layer by design). Fold that text into the declaration, or use a scenario/behavior slot to keep the role base.`, "prompt-constitution");
+}
 export function assemblePrompt(inputs) {
     const { provider, facts } = inputs;
     const onWarn = inputs.onWarn
@@ -93,6 +107,7 @@ export function assemblePrompt(inputs) {
     };
     let pack = SEMA_DEFAULT_PACK;
     let roleBase = inputs.userSystemPrompt ?? DEFAULT_SYSTEM_PROMPT;
+    let roleBaseOrigin = inputs.userSystemPrompt !== undefined ? "task-system-prompt" : "pack-default";
     let constitution = "core";
     let mountedCenter = [];
     if (!inputs.isDefaultProvider && provider.stableBlocks) {
@@ -108,6 +123,10 @@ export function assemblePrompt(inputs) {
             if (inputs.centerDeclarations && inputs.centerDeclarations.length > 0) {
                 onWarn?.("prompt-constitution: a center prompt artifact is adopted but the provider's assembled-identity pass-through owns the prompt — the center sections cannot mount on this migration path.", "prompt-constitution");
             }
+            const droppedDecls = decls.filter((d) => d !== assembledIdentity);
+            if (droppedDecls.length > 0) {
+                onWarn?.(`prompt-provider stableBlocks: the assembled-identity pass-through owns the prompt — ${droppedDecls.length} other declaration(s) do NOT compose this run: ${droppedDecls.map((d) => `"${d.id}" (${d.slot})`).join(", ")}. Declare ONLY the role layer in the identity block to let them mount.`, "prompt-constitution");
+            }
             const renderInputsPT = (date) => ({
                 roleBase: assembledIdentity.text,
                 facts,
@@ -153,29 +172,41 @@ export function assemblePrompt(inputs) {
             return true;
         });
         mountedCenter = centerDecls;
-        pack = mountDeclarations(SEMA_DEFAULT_PACK, [...centerDecls, ...decls], onWarn);
+        const mountedSB = mountDeclarations(SEMA_DEFAULT_PACK, [...centerDecls, ...decls], onWarn);
+        pack = mountedSB.pack;
+        warnRoleBaseEviction(mountedSB.replacedRoleBaseBy, roleBaseOrigin, onWarn);
     }
     else if (!inputs.isDefaultProvider && provider.stableSystem) {
         const roleOut = provider.stableSystem(stableCtx);
         if (provider.replaceAll) {
             constitution = "replaced";
             roleBase = roleOut;
+            roleBaseOrigin = "provider";
             pack = subsetPack(SEMA_DEFAULT_PACK, { exclude: REPLACE_ALL_EXCLUDED, roleBaseLegacyId: "provider.replace_all" });
         }
         else if (roleOut.includes(CYBER_RISK) && roleOut.includes(URL_SAFETY) && roleOut.includes(HARNESS_SECTION_ANCHOR)) {
             constitution = "provider-assembled";
             roleBase = roleOut;
+            roleBaseOrigin = "provider";
             pack = subsetPack(SEMA_DEFAULT_PACK, { keep: OPAQUE_KEPT, roleBaseLegacyId: "provider.assembled" });
             onWarn?.("prompt-constitution: this PromptProvider returns an already-assembled prompt (constitution anchor found). Core now appends the constitution structurally — return ONLY the role base from stableSystem (or set replaceAll:true to own the whole base). Passed through un-doubled.", "prompt-constitution");
         }
         else {
             roleBase = roleOut;
+            roleBaseOrigin = "provider";
         }
     }
     if (inputs.centerDeclarations && inputs.centerDeclarations.length > 0 && !(!inputs.isDefaultProvider && provider.stableBlocks)) {
-        const composedCenter = inputs.centerDeclarations;
-        pack = mountDeclarations(pack, composedCenter, onWarn);
-        mountedCenter = composedCenter;
+        if (constitution === "provider-assembled") {
+            onWarn?.("prompt-constitution: a center prompt artifact is adopted but this PromptProvider returned an already-assembled prompt — the pass-through owns the prompt and the center sections cannot mount on this migration path (an identity section would evict the provider text that carries the constitution). Return ONLY the role base from stableSystem to let center sections compose.", "prompt-constitution");
+        }
+        else {
+            const composedCenter = inputs.centerDeclarations;
+            const mountedC = mountDeclarations(pack, composedCenter, onWarn);
+            pack = mountedC.pack;
+            warnRoleBaseEviction(mountedC.replacedRoleBaseBy, roleBaseOrigin, onWarn);
+            mountedCenter = composedCenter;
+        }
     }
     const renderInputs = (date) => ({
         roleBase,

package/dist/prompt-assembly/epoch.js

@@ -20,12 +20,29 @@ const PROBE_FACTS_OFF = {
     teammateEnabled: false,
     orchestrationDeferred: false,
     isSubagent: false,
+    promptProfile: "simple",
+    fableMitigations: false,
+};
+const PROBE_FACTS_ON = {
+    policyEnabled: true,
+    hooksEnabled: true,
+    isolationEnabled: true,
+    withinTaskCompactionEnabled: true,
+    supervisorEnabled: true,
+    orchestrationEnabled: true,
+    awarenessEnabled: true,
+    goalEnabled: true,
+    worktreeIsolated: true,
+    teammateEnabled: true,
+    orchestrationDeferred: true,
+    isSubagent: true,
+    promptProfile: "classic",
+    fableMitigations: true,
 };
-const PROBE_FACTS_ON = Object.fromEntries(Object.keys(PROBE_FACTS_OFF).map((k) => [k, true]));
 const PROBE_VECTORS = [
     PROBE_FACTS_OFF,
     PROBE_FACTS_ON,
-    ...Object.keys(PROBE_FACTS_OFF).map((k) => ({ ...PROBE_FACTS_OFF, [k]: true })),
+    ...Object.keys(PROBE_FACTS_OFF).map((k) => ({ ...PROBE_FACTS_OFF, [k]: PROBE_FACTS_ON[k] })),
 ];
 const PROBE_INPUTS_BASE = {
     roleBase: "\u0000probe-role\u0000",

package/dist/prompt-assembly/event-registry.js

@@ -4,7 +4,7 @@ export const EVENT_PROMPT_REGISTRY = new Map([
     { kind: "changed_files", carrier: "message.user-prefix", trust: "operator", dedupe: "replace-by-key", defaultPolicy: "off", rendererRef: "turn-attachments.ts#renderChangedFiles" },
     { kind: "plan_mode", carrier: "message.user-prefix", trust: "operator", dedupe: "replace-by-key", defaultPolicy: "off", rendererRef: "turn-attachments.ts#PLAN_MODE_FULL_BODY" },
     { kind: "date_change", carrier: "message.user-prefix", trust: "operator", dedupe: "replace-by-key", defaultPolicy: "always", rendererRef: "turn-attachments.ts#renderDateChange" },
-    { kind: "instructions_change", carrier: "message.user-prefix", trust: "operator", dedupe: "replace-by-key", maxBytes: 512, defaultPolicy: "always", rendererRef: "turn-attachments.ts#renderInstructionsChange" },
+    { kind: "instructions_change", carrier: "message.user-prefix", trust: "operator", dedupe: "replace-by-key", maxBytes: 512, defaultPolicy: "always", rendererRef: "turn-attachments.ts#collectInstructionsChange" },
     { kind: "budget_usd", carrier: "message.user-prefix", trust: "operator", dedupe: "replace-by-key", defaultPolicy: "off", rendererRef: "turn-attachments.ts#renderBudgetUsd" },
     { kind: "background_tasks", carrier: "message.user-prefix", trust: "operator", dedupe: "replace-by-key", defaultPolicy: "off", rendererRef: "turn-attachments.ts#renderBackgroundTasks" },
     { kind: "tools_delta", carrier: "message.user-prefix", trust: "external", dedupe: "replace-by-key", defaultPolicy: "off", rendererRef: "turn-attachments.ts#renderToolsDelta" },
@@ -12,8 +12,8 @@ export const EVENT_PROMPT_REGISTRY = new Map([
     { kind: "skills_listing", carrier: "message.user-prefix", trust: "operator", dedupe: "replace-by-key", defaultPolicy: "on", rendererRef: "turn-attachments.ts#renderSkillsListingDelta" },
     { kind: "mcp_instructions", carrier: "message.user-prefix", trust: "external", dedupe: "replace-by-key", defaultPolicy: "off", rendererRef: "turn-attachments.ts#renderMcpInstructionsDelta" },
     { kind: "mcp_dropped_tools", carrier: "message.user-prefix", trust: "external", dedupe: "replace-by-key", defaultPolicy: "off", rendererRef: "turn-attachments.ts#renderMcpDroppedTools" },
-    { kind: "deadline_converge", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#deadline-t1" },
-    { kind: "deadline_deliver_now", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#deadline-t2" },
+    { kind: "deadline_converge", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#nudgeSchedule" },
+    { kind: "deadline_deliver_now", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#nudgeSchedule" },
     { kind: "deadline_finalize", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#buildFinalizeText" },
     { kind: "final_verification", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#final-verification" },
 ].map((e) => [e.kind, e]));

package/dist/prompt-assembly/explain.js

@@ -30,7 +30,7 @@ export function describeDefaultPack() {
     return {
         packId: SEMA_DEFAULT_PACK.packId,
         roleBaseText: DEFAULT_SYSTEM_PROMPT,
-        sections: SEMA_DEFAULT_PACK.sections.map((s) => ({
+        sections: [...SEMA_DEFAULT_PACK.sections].sort((a, b) => a.rank - b.rank).map((s) => ({
             id: s.id,
             slot: s.slot,
             rank: s.rank,

package/dist/prompt-assembly/tool-catalog.d.ts

@@ -11,6 +11,15 @@ export interface ToolContractDescriptor {
     wireSchemaDigest: string;
     cardId: string;
 }
+export interface ToolManifestRow {
+    wireName: string;
+    aliases: string[];
+    contractId: string;
+    implementationRevision: string;
+    cardId: string;
+    shapeDigest: string;
+    wireSchemaDigest: string;
+}
 export declare function computeShapeDigest(schema: TSchema | undefined): string;
 export declare function computeWireSchemaDigest(schema: TSchema | undefined, description: string): string;
 export interface AttachContractInput {
@@ -22,15 +31,7 @@ export interface AttachContractInput {
 export declare function attachToolContract(tool: AgentTool, input: AttachContractInput): void;
 export declare function getToolContract(tool: AgentTool, fallbackOrigin?: ToolOrigin): ToolContractDescriptor;
 export declare function hasToolContract(tool: AgentTool): boolean;
-export declare function projectToolManifest(tools: AgentTool[], originOf?: (tool: AgentTool) => ToolOrigin): Array<{
-    wireName: string;
-    aliases: string[];
-    contractId: string;
-    implementationRevision: string;
-    cardId: string;
-    shapeDigest: string;
-    wireSchemaDigest: string;
-}>;
+export declare function projectToolManifest(tools: AgentTool[], originOf?: (tool: AgentTool) => ToolOrigin): ToolManifestRow[];
 export declare function auditToolCollisions(tools: AgentTool[]): {
     yields: Array<{
         name: string;

package/dist/prompt-assembly/tool-catalog.js

@@ -1,4 +1,12 @@
 import { createHash } from "node:crypto";
+const PRESENTATION_KEYWORDS = new Set(["description", "title", "examples", "$id"]);
+const SCHEMA_NAME_MAPS = new Set([
+    "properties",
+    "patternProperties",
+    "definitions",
+    "$defs",
+    "dependentSchemas",
+]);
 function stripPresentation(node) {
     if (Array.isArray(node))
         return node.map(stripPresentation);
@@ -6,8 +14,15 @@ function stripPresentation(node) {
         return node;
     const out = {};
     for (const [k, v] of Object.entries(node)) {
-        if (k === "description" || k === "title" || k === "examples" || k === "$id")
+        if (PRESENTATION_KEYWORDS.has(k))
             continue;
+        if (SCHEMA_NAME_MAPS.has(k) && v !== null && typeof v === "object" && !Array.isArray(v)) {
+            const named = {};
+            for (const [name, sub] of Object.entries(v))
+                named[name] = stripPresentation(sub);
+            out[k] = named;
+            continue;
+        }
         out[k] = k === "required" && Array.isArray(v) ? [...v].sort() : stripPresentation(v);
     }
     return out;

package/dist/prompt-assembly/turn-snapshot.d.ts

@@ -1,3 +1,4 @@
+import type { ToolFingerprintInput } from "../core/cache-break-detector.js";
 export interface RawPrefixInputs {
     provider: string;
     modelId: string;
@@ -9,11 +10,7 @@ export interface RawPrefixInputs {
         cacheControlBoundary: boolean;
     }>;
     stableSystemText: string;
-    toolWire: ReadonlyArray<{
-        name: string;
-        description: string;
-        parameters: unknown;
-    }>;
+    toolWire: ReadonlyArray<ToolFingerprintInput>;
     thinkingLevel: string;
     maxTokens: number | undefined;
     hasOutputSchema: boolean;

package/dist/prompt-assembly/turn-snapshot.js

@@ -61,7 +61,10 @@ export function buildTurnPromptSnapshot(raw, api, promptHasher) {
         loweringVersion: `${lowering.version}/${lowering.form}/${api}`,
     };
     const bump = () => {
-        snapshot.cacheIdentity = identityOf(elements);
+        const next = identityOf(elements);
+        if (next === snapshot.cacheIdentity)
+            return;
+        snapshot.cacheIdentity = next;
         snapshot.onChange?.(snapshot);
     };
     const snapshot = {

package/dist/stores/file/background-agent-store.d.ts

@@ -1,4 +1,4 @@
-import { type BackgroundAgentRecord, type BackgroundAgentRowSummary, type BackgroundAgentStore } from "../../core/background-agent-store.js";
+import { type BackgroundAgentReapOptions, type BackgroundAgentRecord, type BackgroundAgentRowSummary, type BackgroundAgentStore, type BackgroundAgentUpdateIfExpect } from "../../core/background-agent-store.js";
 export interface FileBackgroundAgentStoreOptions {
     fsync?: boolean;
     compactEvery?: number;
@@ -18,12 +18,7 @@ export declare class FileBackgroundAgentStore implements BackgroundAgentStore {
     update(handle: string, scope: string, record: BackgroundAgentRecord, expect: {
         rev: number;
     }): Promise<boolean>;
-    updateIf(handle: string, scope: string, record: BackgroundAgentRecord, expect: {
-        rev: number;
-        status?: BackgroundAgentRecord["status"];
-        parkedCheckpointToken?: string | null;
-        parkClaimId?: string | null;
-    }): Promise<boolean>;
+    updateIf(handle: string, scope: string, record: BackgroundAgentRecord, expect: BackgroundAgentUpdateIfExpect): Promise<boolean>;
     listBySession(scope: string, sessionId: string, opts?: {
         status?: BackgroundAgentRecord["status"];
         limit?: number;
@@ -36,11 +31,7 @@ export declare class FileBackgroundAgentStore implements BackgroundAgentStore {
     delete(handle: string, scope: string, expect?: {
         rev: number;
     }): Promise<boolean>;
-    reap(scope: string, now: number, opts?: {
-        maxAgeMs?: number;
-        keep?: number;
-        staleRunningMaxAgeMs?: number;
-    }): Promise<number>;
+    reap(scope: string, now: number, opts?: BackgroundAgentReapOptions): Promise<number>;
     compactNow(): void;
     get size(): number;
     close(): void;

package/dist/stores/file/background-agent-store.js

@@ -1,5 +1,5 @@
 import { join } from "node:path";
-import { BackgroundAgentStoreError, STALE_RUNNING_REAP_ATTRIBUTION, } from "../../core/background-agent-store.js";
+import { BackgroundAgentStoreError, STALE_RUNNING_REAP_ATTRIBUTION, queryBackgroundAgents, } from "../../core/background-agent-store.js";
 import { SharedLedgerTable } from "./shared-ledger.js";
 const agentLedgers = new SharedLedgerTable({
     keyOf: (r) => FileBackgroundAgentStore.key(r.handle, r.scope),
@@ -92,31 +92,10 @@ export class FileBackgroundAgentStore {
         });
     }
     async listBySession(scope, sessionId, opts) {
-        const out = [];
-        for (const r of this.rows.values()) {
-            if (r.scope !== scope)
-                continue;
-            const anchor = r.sessionScoped ? r.owner : r.parentSessionId;
-            if (anchor !== sessionId && r.rootSessionId !== sessionId)
-                continue;
-            if (opts?.status !== undefined && r.status !== opts.status)
-                continue;
-            out.push(toSummary(r));
-        }
-        out.sort((a, b) => b.spawnedAt - a.spawnedAt);
-        return opts?.limit !== undefined ? out.slice(0, Math.max(0, opts.limit)) : out;
+        return queryBackgroundAgents(this.rows.values(), { scope, sessionId, status: opts?.status, limit: opts?.limit });
     }
     async listByScope(scope, opts) {
-        const out = [];
-        for (const r of this.rows.values()) {
-            if (r.scope !== scope)
-                continue;
-            if (opts?.status !== undefined && r.status !== opts.status)
-                continue;
-            out.push(toSummary(r));
-        }
-        out.sort((a, b) => b.spawnedAt - a.spawnedAt);
-        return opts?.limit !== undefined ? out.slice(0, Math.max(0, opts.limit)) : out;
+        return queryBackgroundAgents(this.rows.values(), { scope, status: opts?.status, limit: opts?.limit });
     }
     async listScopes() {
         return [...new Set([...this.rows.values()].map((r) => r.scope))].sort();
@@ -205,20 +184,3 @@ export class FileBackgroundAgentStore {
         this.ledger.release();
     }
 }
-function toSummary(r) {
-    return {
-        handle: r.handle,
-        owner: r.owner,
-        sessionScoped: r.sessionScoped,
-        ...(r.sessionId !== undefined ? { sessionId: r.sessionId } : {}),
-        ...(r.parentSessionId !== undefined ? { parentSessionId: r.parentSessionId } : {}),
-        ...(r.rootSessionId !== undefined ? { rootSessionId: r.rootSessionId } : {}),
-        ...(r.name !== undefined ? { name: r.name } : {}),
-        ...(r.agentType !== undefined ? { agentType: r.agentType } : {}),
-        status: r.status,
-        spawnedAt: r.spawnedAt,
-        updatedAt: r.updatedAt,
-        ...(r.settledAt !== undefined ? { settledAt: r.settledAt } : {}),
-        ...(r.usage !== undefined ? { usage: structuredClone(r.usage) } : {}),
-    };
-}

package/dist/stores/file/checkpoint-store.js

@@ -1,5 +1,5 @@
 import { join } from "node:path";
-import { CheckpointError, summarizeCheckpoint, validatePendingSteer, winnerFromOutcome, } from "../../core/checkpoint-store.js";
+import { CheckpointError, checkpointOccMatches, checkpointRowMatches, summarizeCheckpoint, validatePendingSteer, winnerFromOutcome, } from "../../core/checkpoint-store.js";
 import { SharedLedgerTable } from "./shared-ledger.js";
 function applyCheckpointEvent(cps, ev) {
     if (ev.t === "put") {
@@ -80,10 +80,10 @@ export class FileCheckpointStore {
                 throw new Error("injected fault: resolve before commit");
             }
             const cp = this.cps.get(token);
-            if (!cp || cp.scope !== scope || cp.status !== "pending") {
+            if (!checkpointRowMatches(cp, scope, "pending")) {
                 return false;
             }
-            if (expect !== undefined && (cp.rev ?? 0) !== expect.rev) {
+            if (!checkpointOccMatches(cp, expect)) {
                 return false;
             }
             const winner = winnerFromOutcome(outcome);
@@ -99,7 +99,7 @@ export class FileCheckpointStore {
     async reopen(token, scope, reason) {
         return this.withLock(token, () => {
             const cp = this.cps.get(token);
-            if (!cp || cp.scope !== scope || cp.status !== "resolved") {
+            if (!checkpointRowMatches(cp, scope, "resolved")) {
                 return false;
             }
             const rev = (cp.rev ?? 0) + 1;
@@ -111,7 +111,7 @@ export class FileCheckpointStore {
         const clean = validatePendingSteer(steer);
         return this.withLock(token, () => {
             const cp = this.cps.get(token);
-            if (!cp || cp.scope !== scope || cp.status !== "pending") {
+            if (!checkpointRowMatches(cp, scope, "pending")) {
                 return false;
             }
             this.commit({ t: "steer", token, steer: clean }, this.fsyncEnabled);
@@ -121,7 +121,7 @@ export class FileCheckpointStore {
     async expire(token, scope) {
         return this.withLock(token, () => {
             const cp = this.cps.get(token);
-            if (!cp || cp.scope !== scope || cp.status !== "pending") {
+            if (!checkpointRowMatches(cp, scope, "pending")) {
                 return false;
             }
             this.commit({ t: "expire", token }, true);

package/dist/stores/file/fs-atomic.d.ts

@@ -10,7 +10,10 @@ export declare class AppendLog {
     private fd;
     private disposed;
     private readonly path;
+    private boundary;
     constructor(path: string);
+    private sizeOrUnknown;
+    private repairTornTail;
     append(record: unknown, fsync: boolean): void;
     close(): void;
     closeForSwap(): void;

package/dist/stores/file/fs-atomic.js

@@ -1,4 +1,4 @@
-import { closeSync, constants as FS, existsSync, linkSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, truncateSync, unlinkSync, writeFileSync, writeSync, fsyncSync, } from "node:fs";
+import { closeSync, constants as FS, existsSync, fstatSync, linkSync, mkdirSync, openSync, readFileSync, readSync, realpathSync, renameSync, truncateSync, unlinkSync, writeFileSync, writeSync, fsyncSync, } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, join, resolve as resolvePath } from "node:path";
 import { createHash, randomBytes } from "node:crypto";
@@ -148,30 +148,75 @@ export class AppendLog {
     fd;
     disposed = false;
     path;
+    boundary = -1;
     constructor(path) {
         this.path = path;
         ensureDir(dirnameOf(path));
         truncateTornTail(path);
-        this.fd = openSync(path, "a", 0o600);
+        this.fd = openSync(path, "a+", 0o600);
+        this.boundary = this.sizeOrUnknown();
+    }
+    sizeOrUnknown() {
+        try {
+            return fstatSync(this.fd).size;
+        }
+        catch {
+            return -1;
+        }
+    }
+    repairTornTail() {
+        const size = this.sizeOrUnknown();
+        if (size < 0) {
+            this.boundary = -1;
+            return;
+        }
+        if (size === this.boundary)
+            return;
+        if (size === 0) {
+            this.boundary = 0;
+            return;
+        }
+        const tail = Buffer.allocUnsafe(1);
+        try {
+            if (readSync(this.fd, tail, 0, 1, size - 1) === 1 && tail[0] === 0x0a) {
+                this.boundary = size;
+                return;
+            }
+        }
+        catch {
+            return;
+        }
+        truncateTornTail(this.path);
+        this.boundary = this.sizeOrUnknown();
     }
     append(record, fsync) {
         if (this.fd < 0 && !this.disposed) {
             truncateTornTail(this.path);
-            this.fd = openSync(this.path, "a", 0o600);
+            this.fd = openSync(this.path, "a+", 0o600);
+            this.boundary = this.sizeOrUnknown();
         }
         if (this.fd < 0) {
             const e = new Error("append: this log was closed (its session/box was deleted or replaced) — refusing to write through a released descriptor");
             e.code = "log_closed";
             throw e;
         }
+        this.repairTornTail();
         const buf = Buffer.from(`${JSON.stringify(record)}\n`, "utf8");
         let written = 0;
-        while (written < buf.length) {
-            const n = writeSync(this.fd, buf, written, buf.length - written);
-            if (n <= 0)
-                throw new Error(`append: write made no progress (${written}/${buf.length} bytes) — refusing to leave a torn record`);
-            written += n;
+        try {
+            while (written < buf.length) {
+                const n = writeSync(this.fd, buf, written, buf.length - written);
+                if (n <= 0)
+                    throw new Error(`append: write made no progress (${written}/${buf.length} bytes) — refusing to leave a torn record`);
+                written += n;
+            }
+        }
+        catch (err) {
+            this.boundary = -1;
+            throw err;
         }
+        if (this.boundary >= 0)
+            this.boundary += buf.length;
         if (fsync)
             fsyncSync(this.fd);
     }

package/dist/stores/file/index.d.ts

@@ -38,6 +38,7 @@ export declare class FileStorageBackend {
     private readonly fileCheckpoints;
     private readonly fileMemory;
     private readonly ttl;
+    private readonly fileSessions;
     private readonly fileWorkflowJournal;
     constructor(opts?: FileStorageBackendOptions);
     dispose(): Promise<void>;