@rpamis/comet 0.4.0-beta.1 → 0.4.0-beta.11

package/dist/domains/engine/protected-run-file.d.ts

@@ -0,0 +1,15 @@
+import type { RaceSafeReadOptions } from '../../platform/fs/race-safe-read.js';
+export interface EngineRunReadOptions {
+    hooks?: RaceSafeReadOptions['hooks'];
+}
+export interface EngineRunWriteOptions {
+    beforeCommit?: () => void | Promise<void>;
+}
+export interface EngineRunRemoveOptions {
+    beforeRemove?: () => void | Promise<void>;
+}
+export declare function readOptionalEngineRunText(changeDir: string, relativePath: string, maxBytes: number, label: string, options?: EngineRunReadOptions): Promise<string | null>;
+export declare function writeEngineRunText(changeDir: string, relativePath: string, content: string, maxBytes: number, label: string, options?: EngineRunWriteOptions): Promise<void>;
+export declare function appendEngineRunText(changeDir: string, relativePath: string, addition: string, maxBytes: number, label: string, options?: EngineRunWriteOptions): Promise<void>;
+export declare function removeEngineRunFile(changeDir: string, relativePath: string, label: string, options?: EngineRunRemoveOptions): Promise<boolean>;
+//# sourceMappingURL=protected-run-file.d.ts.map

package/dist/domains/engine/protected-run-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protected-run-file.d.ts","sourceRoot":"","sources":["../../../domains/engine/protected-run-file.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,qCAAqC,CAAC;AAEnG,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAuCD,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/domains/engine/protected-run-file.js

@@ -0,0 +1,76 @@
+import { TextDecoder } from 'util';
+import { atomicWriteContainedText, inspectProtectedProjectPath, readProtectedProjectFile, removeContainedFile, } from '../workflow-contract/index.js';
+import { sameFileObject } from '../../platform/fs/file-identity.js';
+function identityOf(stat) {
+    return { dev: stat.dev, ino: stat.ino, birthtime: stat.birthtimeMs };
+}
+function decodeRunText(result, label) {
+    try {
+        return new TextDecoder('utf-8', { fatal: true }).decode(result.bytes);
+    }
+    catch (error) {
+        throw new Error(`${label} is not valid UTF-8`, { cause: error });
+    }
+}
+async function readSnapshot(changeDir, relativePath, maxBytes, label, options = {}) {
+    try {
+        const result = await readProtectedProjectFile(changeDir, relativePath, maxBytes, {
+            label,
+            hooks: options.hooks,
+        });
+        return { result, text: decodeRunText(result, label) };
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT' || code === 'ENOTDIR')
+            return null;
+        throw error;
+    }
+}
+export async function readOptionalEngineRunText(changeDir, relativePath, maxBytes, label, options = {}) {
+    return (await readSnapshot(changeDir, relativePath, maxBytes, label, options))?.text ?? null;
+}
+export async function writeEngineRunText(changeDir, relativePath, content, maxBytes, label, options = {}) {
+    if (Buffer.byteLength(content, 'utf8') > maxBytes) {
+        throw new Error(`${label} exceeds ${maxBytes} bytes`);
+    }
+    const expected = await readSnapshot(changeDir, relativePath, maxBytes, label);
+    const inspection = await inspectProtectedProjectPath(changeDir, relativePath, {
+        label,
+        expected: 'file',
+    });
+    await atomicWriteContainedText(inspection.target, content, {
+        containedRoot: inspection.projectRoot,
+        beforeCommit: async () => {
+            await options.beforeCommit?.();
+            const current = await readSnapshot(changeDir, relativePath, maxBytes, label);
+            if (!expected && !current)
+                return;
+            if (!expected || !current) {
+                throw new Error(`${label} changed before commit`);
+            }
+            if (expected.result.realPath !== current.result.realPath ||
+                !sameFileObject(identityOf(expected.result.stat), identityOf(current.result.stat)) ||
+                expected.text !== current.text) {
+                throw new Error(`${label} changed before commit`);
+            }
+        },
+    });
+}
+export async function appendEngineRunText(changeDir, relativePath, addition, maxBytes, label, options = {}) {
+    const existing = await readOptionalEngineRunText(changeDir, relativePath, maxBytes, label);
+    await writeEngineRunText(changeDir, relativePath, `${existing ?? ''}${addition}`, maxBytes, label, options);
+}
+export async function removeEngineRunFile(changeDir, relativePath, label, options = {}) {
+    const inspection = await inspectProtectedProjectPath(changeDir, relativePath, {
+        label,
+        expected: 'file',
+    });
+    if (!inspection.exists)
+        return false;
+    return removeContainedFile(inspection.target, {
+        containedRoot: inspection.projectRoot,
+        beforeRemove: options.beforeRemove,
+    });
+}
+//# sourceMappingURL=protected-run-file.js.map

package/dist/domains/engine/protected-run-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protected-run-file.js","sourceRoot":"","sources":["../../../domains/engine/protected-run-file.ts"],"names":[],"mappings":"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"}

package/dist/domains/engine/run-store.d.ts

@@ -1,13 +1,14 @@
+import { type EngineRunReadOptions, type EngineRunRemoveOptions, type EngineRunWriteOptions } from './protected-run-file.js';
 import type { Checkpoint, EngineAction, TrajectoryEvent } from './types.js';
-export declare function appendTrajectory(changeDir: string, relativePath: string, event: TrajectoryEvent): Promise<void>;
-export declare function readTrajectory(changeDir: string, relativePath: string): Promise<TrajectoryEvent[]>;
-export declare function readArtifacts(changeDir: string, relativePath: string): Promise<Record<string, string>>;
-export declare function writeArtifacts(changeDir: string, relativePath: string, artifacts: Record<string, string>): Promise<void>;
-export declare function writeContext(changeDir: string, relativePath: string, context: string): Promise<void>;
-export declare function readContext(changeDir: string, relativePath: string): Promise<string | null>;
-export declare function writePendingAction(changeDir: string, relativePath: string, action: EngineAction): Promise<void>;
-export declare function readPendingAction(changeDir: string, relativePath: string): Promise<EngineAction | null>;
-export declare function clearPendingAction(changeDir: string, relativePath: string): Promise<void>;
-export declare function writeCheckpoint(changeDir: string, relativePath: string, checkpoint: Checkpoint): Promise<void>;
-export declare function readCheckpoint(changeDir: string, relativePath: string): Promise<Checkpoint | null>;
+export declare function appendTrajectory(changeDir: string, relativePath: string, event: TrajectoryEvent, options?: EngineRunWriteOptions): Promise<void>;
+export declare function readTrajectory(changeDir: string, relativePath: string, options?: EngineRunReadOptions): Promise<TrajectoryEvent[]>;
+export declare function readArtifacts(changeDir: string, relativePath: string, options?: EngineRunReadOptions): Promise<Record<string, string>>;
+export declare function writeArtifacts(changeDir: string, relativePath: string, artifacts: Record<string, string>, options?: EngineRunWriteOptions): Promise<void>;
+export declare function writeContext(changeDir: string, relativePath: string, context: string, options?: EngineRunWriteOptions): Promise<void>;
+export declare function readContext(changeDir: string, relativePath: string, options?: EngineRunReadOptions): Promise<string | null>;
+export declare function writePendingAction(changeDir: string, relativePath: string, action: EngineAction, options?: EngineRunWriteOptions): Promise<void>;
+export declare function readPendingAction(changeDir: string, relativePath: string, options?: EngineRunReadOptions): Promise<EngineAction | null>;
+export declare function clearPendingAction(changeDir: string, relativePath: string, options?: EngineRunRemoveOptions): Promise<void>;
+export declare function writeCheckpoint(changeDir: string, relativePath: string, checkpoint: Checkpoint, options?: EngineRunWriteOptions): Promise<void>;
+export declare function readCheckpoint(changeDir: string, relativePath: string, options?: EngineRunReadOptions): Promise<Checkpoint | null>;
 //# sourceMappingURL=run-store.d.ts.map

package/dist/domains/engine/run-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-store.d.ts","sourceRoot":"","sources":["../../../domains/engine/run-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA6B5E,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,EAAE,CAAC,CAc5B;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAOjC;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEjG;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAO9B;AAED,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/F;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAG5B"}
+{"version":3,"file":"run-store.d.ts","sourceRoot":"","sources":["../../../domains/engine/run-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAqB5E,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,eAAe,EAAE,CAAC,CAqB5B;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAUjC;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAU9B;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAU5B"}

package/dist/domains/engine/run-store.js

@@ -1,39 +1,29 @@
-import { randomUUID } from 'crypto';
-import { promises as fs } from 'fs';
 import path from 'path';
-function resolveRunPath(changeDir, relativePath) {
-    if (path.isAbsolute(relativePath))
+import { appendEngineRunText, readOptionalEngineRunText, removeEngineRunFile, writeEngineRunText, } from './protected-run-file.js';
+const RUN_FILE_LIMITS = {
+    trajectory: 8 * 1024 * 1024,
+    artifacts: 1024 * 1024,
+    context: 1024 * 1024,
+    pendingAction: 256 * 1024,
+    checkpoint: 256 * 1024,
+};
+function assertRunPath(changeDir, relativePath) {
+    if (path.isAbsolute(relativePath)) {
         throw new Error('Run path must stay inside the change directory');
+    }
     const root = path.resolve(changeDir);
     const target = path.resolve(root, relativePath);
     if (target !== root && !target.startsWith(root + path.sep)) {
         throw new Error('Run path must stay inside the change directory');
     }
-    return target;
-}
-async function atomicWrite(file, content) {
-    await fs.mkdir(path.dirname(file), { recursive: true });
-    const temporary = `${file}.${randomUUID()}.tmp`;
-    await fs.writeFile(temporary, content, 'utf8');
-    await fs.rename(temporary, file);
-}
-async function readOptionalText(file) {
-    try {
-        return await fs.readFile(file, 'utf8');
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return null;
-        throw error;
-    }
 }
-export async function appendTrajectory(changeDir, relativePath, event) {
-    const file = resolveRunPath(changeDir, relativePath);
-    await fs.mkdir(path.dirname(file), { recursive: true });
-    await fs.appendFile(file, JSON.stringify(event) + '\n', 'utf8');
+export async function appendTrajectory(changeDir, relativePath, event, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    await appendEngineRunText(changeDir, relativePath, `${JSON.stringify(event)}\n`, RUN_FILE_LIMITS.trajectory, 'Run trajectory', options);
 }
-export async function readTrajectory(changeDir, relativePath) {
-    const raw = await readOptionalText(resolveRunPath(changeDir, relativePath));
+export async function readTrajectory(changeDir, relativePath, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    const raw = await readOptionalEngineRunText(changeDir, relativePath, RUN_FILE_LIMITS.trajectory, 'Run trajectory', options);
     if (raw === null)
         return [];
     return raw
@@ -49,52 +39,43 @@ export async function readTrajectory(changeDir, relativePath) {
         }
     });
 }
-export async function readArtifacts(changeDir, relativePath) {
-    try {
-        return JSON.parse(await fs.readFile(resolveRunPath(changeDir, relativePath), 'utf8'));
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return {};
-        throw error;
-    }
+export async function readArtifacts(changeDir, relativePath, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    const raw = await readOptionalEngineRunText(changeDir, relativePath, RUN_FILE_LIMITS.artifacts, 'Run artifacts', options);
+    return raw === null ? {} : JSON.parse(raw);
 }
-export async function writeArtifacts(changeDir, relativePath, artifacts) {
-    await atomicWrite(resolveRunPath(changeDir, relativePath), JSON.stringify(artifacts, null, 2) + '\n');
+export async function writeArtifacts(changeDir, relativePath, artifacts, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    await writeEngineRunText(changeDir, relativePath, JSON.stringify(artifacts, null, 2) + '\n', RUN_FILE_LIMITS.artifacts, 'Run artifacts', options);
 }
-export async function writeContext(changeDir, relativePath, context) {
-    await atomicWrite(resolveRunPath(changeDir, relativePath), context);
+export async function writeContext(changeDir, relativePath, context, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    await writeEngineRunText(changeDir, relativePath, context, RUN_FILE_LIMITS.context, 'Run context', options);
 }
-export async function readContext(changeDir, relativePath) {
-    return readOptionalText(resolveRunPath(changeDir, relativePath));
+export async function readContext(changeDir, relativePath, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    return readOptionalEngineRunText(changeDir, relativePath, RUN_FILE_LIMITS.context, 'Run context', options);
 }
-export async function writePendingAction(changeDir, relativePath, action) {
-    await atomicWrite(resolveRunPath(changeDir, relativePath), JSON.stringify(action, null, 2) + '\n');
+export async function writePendingAction(changeDir, relativePath, action, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    await writeEngineRunText(changeDir, relativePath, JSON.stringify(action, null, 2) + '\n', RUN_FILE_LIMITS.pendingAction, 'Run pending action', options);
 }
-export async function readPendingAction(changeDir, relativePath) {
-    try {
-        return JSON.parse(await fs.readFile(resolveRunPath(changeDir, relativePath), 'utf8'));
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return null;
-        throw error;
-    }
+export async function readPendingAction(changeDir, relativePath, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    const raw = await readOptionalEngineRunText(changeDir, relativePath, RUN_FILE_LIMITS.pendingAction, 'Run pending action', options);
+    return raw === null ? null : JSON.parse(raw);
 }
-export async function clearPendingAction(changeDir, relativePath) {
-    try {
-        await fs.unlink(resolveRunPath(changeDir, relativePath));
-    }
-    catch (error) {
-        if (error.code !== 'ENOENT')
-            throw error;
-    }
+export async function clearPendingAction(changeDir, relativePath, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    await removeEngineRunFile(changeDir, relativePath, 'Run pending action', options);
 }
-export async function writeCheckpoint(changeDir, relativePath, checkpoint) {
-    await atomicWrite(resolveRunPath(changeDir, relativePath), JSON.stringify(checkpoint, null, 2) + '\n');
+export async function writeCheckpoint(changeDir, relativePath, checkpoint, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    await writeEngineRunText(changeDir, relativePath, JSON.stringify(checkpoint, null, 2) + '\n', RUN_FILE_LIMITS.checkpoint, 'Run checkpoint', options);
 }
-export async function readCheckpoint(changeDir, relativePath) {
-    const raw = await readOptionalText(resolveRunPath(changeDir, relativePath));
+export async function readCheckpoint(changeDir, relativePath, options = {}) {
+    assertRunPath(changeDir, relativePath);
+    const raw = await readOptionalEngineRunText(changeDir, relativePath, RUN_FILE_LIMITS.checkpoint, 'Run checkpoint', options);
     return raw === null ? null : JSON.parse(raw);
 }
 //# sourceMappingURL=run-store.js.map

package/dist/domains/engine/run-store.js.map

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

package/dist/domains/engine/state.d.ts

@@ -1,10 +1,11 @@
+import { type EngineRunReadOptions, type EngineRunRemoveOptions, type EngineRunWriteOptions } from './protected-run-file.js';
 import type { RunState } from './types.js';
 export type StateDocument = Record<string, unknown>;
 export declare function runStateFromDocument(doc: StateDocument): RunState | null;
 /** Write only run_id onto a yaml document (the rest of Run state lives in .comet/run-state.json). */
 export declare function applyRunStateToDocument(doc: StateDocument, state: RunState | null): void;
 export declare const RUN_STATE_FILE = ".comet/run-state.json";
-export declare function readRunState(changeDir: string): Promise<RunState | null>;
-export declare function writeRunState(changeDir: string, state: RunState): Promise<void>;
-export declare function removeRunState(changeDir: string): Promise<void>;
+export declare function readRunState(changeDir: string, options?: EngineRunReadOptions): Promise<RunState | null>;
+export declare function writeRunState(changeDir: string, state: RunState, options?: EngineRunWriteOptions): Promise<void>;
+export declare function removeRunState(changeDir: string, options?: EngineRunRemoveOptions): Promise<void>;
 //# sourceMappingURL=state.d.ts.map

package/dist/domains/engine/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../domains/engine/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA8CpD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,QAAQ,GAAG,IAAI,CA2CxE;AAED,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAMxF;AAED,eAAO,MAAM,cAAc,0BAA0B,CAAC;AA8DtD,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAW9E;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrF;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../domains/engine/state.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA8CpD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,QAAQ,GAAG,IAAI,CA2CxE;AAED,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAMxF;AAED,eAAO,MAAM,cAAc,0BAA0B,CAAC;AA+DtD,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAW1B;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,QAAQ,EACf,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/domains/engine/state.js

@@ -1,6 +1,5 @@
-import { randomUUID } from 'crypto';
-import { promises as fs } from 'fs';
 import path from 'path';
+import { readOptionalEngineRunText, removeEngineRunFile, writeEngineRunText, } from './protected-run-file.js';
 const field = (doc, key) => {
     const value = doc[key];
     return value === null || value === undefined ? null : String(value);
@@ -93,6 +92,7 @@ export function applyRunStateToDocument(doc, state) {
     }
 }
 export const RUN_STATE_FILE = '.comet/run-state.json';
+const RUN_STATE_MAX_BYTES = 256 * 1024;
 function runStateToJson(state) {
     return {
         runId: state.runId,
@@ -133,28 +133,17 @@ function runStateFromJson(json) {
     };
     return runStateFromDocument(doc);
 }
-export async function readRunState(changeDir) {
-    const file = path.join(changeDir, RUN_STATE_FILE);
-    let raw;
-    try {
-        raw = await fs.readFile(file, 'utf8');
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return null;
-        throw error;
-    }
+export async function readRunState(changeDir, options = {}) {
+    const raw = await readOptionalEngineRunText(changeDir, RUN_STATE_FILE, RUN_STATE_MAX_BYTES, 'Run state', options);
+    if (raw === null)
+        return null;
     const json = JSON.parse(raw);
     return runStateFromJson(json);
 }
-export async function writeRunState(changeDir, state) {
-    await fs.mkdir(path.join(changeDir, '.comet'), { recursive: true });
-    const file = path.join(changeDir, RUN_STATE_FILE);
-    const temporary = path.join(changeDir, '.comet', `run-state.${randomUUID()}.tmp`);
-    await fs.writeFile(temporary, JSON.stringify(runStateToJson(state), null, 2), 'utf8');
-    await fs.rename(temporary, file);
+export async function writeRunState(changeDir, state, options = {}) {
+    await writeEngineRunText(changeDir, RUN_STATE_FILE, JSON.stringify(runStateToJson(state), null, 2), RUN_STATE_MAX_BYTES, 'Run state', options);
 }
-export async function removeRunState(changeDir) {
-    await fs.rm(path.join(changeDir, RUN_STATE_FILE), { force: true });
+export async function removeRunState(changeDir, options = {}) {
+    await removeEngineRunFile(changeDir, RUN_STATE_FILE, 'Run state', options);
 }
 //# sourceMappingURL=state.js.map

package/dist/domains/engine/state.js.map

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

package/dist/domains/engine/storage-layout.d.ts

@@ -0,0 +1,14 @@
+export interface RunStorageLayout {
+    stateRef: string;
+    pendingRef: string;
+    trajectoryRef: string;
+    contextRef: string;
+    artifactsRef: string;
+    checkpointRef: string;
+    snapshotsRef: string;
+}
+export declare const CLASSIC_RUN_STORAGE: Readonly<RunStorageLayout>;
+export declare const NATIVE_RUN_STORAGE: Readonly<RunStorageLayout>;
+export declare function assertRunStorageRef(value: string): void;
+export declare function assertRunStorageLayout(storage: Readonly<RunStorageLayout>): void;
+//# sourceMappingURL=storage-layout.d.ts.map

package/dist/domains/engine/storage-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-layout.d.ts","sourceRoot":"","sources":["../../../domains/engine/storage-layout.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,gBAAgB,CAQzD,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,gBAAgB,CAQxD,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CASvD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAEhF"}

package/dist/domains/engine/storage-layout.js

@@ -0,0 +1,32 @@
+import path from 'path';
+export const CLASSIC_RUN_STORAGE = /* @__PURE__ */ Object.freeze({
+    stateRef: '.comet/run-state.json',
+    pendingRef: '.comet/pending-action.json',
+    trajectoryRef: '.comet/trajectory.jsonl',
+    contextRef: '.comet/context.md',
+    artifactsRef: '.comet/artifacts.json',
+    checkpointRef: '.comet/checkpoint.json',
+    snapshotsRef: '.comet/skill-snapshots',
+});
+export const NATIVE_RUN_STORAGE = /* @__PURE__ */ Object.freeze({
+    stateRef: 'runtime/run-state.json',
+    pendingRef: 'runtime/pending-action.json',
+    trajectoryRef: 'runtime/trajectory.jsonl',
+    contextRef: 'runtime/context.md',
+    artifactsRef: 'runtime/artifacts.json',
+    checkpointRef: 'runtime/checkpoints/latest.json',
+    snapshotsRef: 'runtime/skill-snapshots',
+});
+export function assertRunStorageRef(value) {
+    if (value.length === 0 ||
+        path.isAbsolute(value) ||
+        /^(?:[A-Za-z]:|[\\/]|~)/u.test(value) ||
+        value.split(/[\\/]/u).includes('..')) {
+        throw new Error('Run storage ref must stay inside the Run root');
+    }
+}
+export function assertRunStorageLayout(storage) {
+    for (const value of Object.values(storage))
+        assertRunStorageRef(value);
+}
+//# sourceMappingURL=storage-layout.js.map

package/dist/domains/engine/storage-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-layout.js","sourceRoot":"","sources":["../../../domains/engine/storage-layout.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAYxB,MAAM,CAAC,MAAM,mBAAmB,GAA+B,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3F,QAAQ,EAAE,uBAAuB;IACjC,UAAU,EAAE,4BAA4B;IACxC,aAAa,EAAE,yBAAyB;IACxC,UAAU,EAAE,mBAAmB;IAC/B,YAAY,EAAE,uBAAuB;IACrC,aAAa,EAAE,wBAAwB;IACvC,YAAY,EAAE,wBAAwB;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAA+B,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;IAC1F,QAAQ,EAAE,wBAAwB;IAClC,UAAU,EAAE,6BAA6B;IACzC,aAAa,EAAE,0BAA0B;IACzC,UAAU,EAAE,oBAAoB;IAChC,YAAY,EAAE,wBAAwB;IACtC,aAAa,EAAE,iCAAiC;IAChD,YAAY,EAAE,yBAAyB;CACxC,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IACE,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QACtB,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;QACrC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EACpC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAmC;IACxE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC"}

package/dist/domains/engine/storage-run.d.ts

@@ -0,0 +1,9 @@
+import type { SkillPackage } from '../skill/types.js';
+import { type RunStorageLayout } from './storage-layout.js';
+import type { RunState } from './types.js';
+export declare function parseStoredRunStateValue(value: unknown): RunState;
+export declare function startRunWithStorage(pkg: SkillPackage, runId: string, skillHash: string, storage: Readonly<RunStorageLayout>): RunState;
+export declare function readRunStateAt(changeDir: string, storage: Readonly<RunStorageLayout>): Promise<RunState | null>;
+export declare function writeRunStateAt(changeDir: string, state: RunState, storage: Readonly<RunStorageLayout>): Promise<void>;
+export declare function removeRunStateAt(changeDir: string, storage: Readonly<RunStorageLayout>): Promise<void>;
+//# sourceMappingURL=storage-run.d.ts.map

package/dist/domains/engine/storage-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-run.d.ts","sourceRoot":"","sources":["../../../domains/engine/storage-run.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAiE3C,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAsBjE;AAOD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAClC,QAAQ,CAmBV;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAClC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAS1B;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/domains/engine/storage-run.js

@@ -0,0 +1,116 @@
+import { randomUUID } from 'crypto';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { runStateFromDocument } from './state.js';
+import { assertRunStorageLayout } from './storage-layout.js';
+const STORED_RUN_STATE_KEYS = new Set([
+    'runId',
+    'skill',
+    'skillVersion',
+    'skillHash',
+    'orchestration',
+    'currentStep',
+    'iteration',
+    'pending',
+    'pendingRef',
+    'trajectoryRef',
+    'contextRef',
+    'artifactsRef',
+    'checkpointRef',
+    'status',
+    'retries',
+]);
+function toStoredState(state) {
+    return { ...state };
+}
+function fromStoredState(json) {
+    const document = {
+        run_id: json.runId,
+        skill: json.skill,
+        skill_version: json.skillVersion,
+        skill_hash: json.skillHash,
+        orchestration: json.orchestration,
+        current_step: json.currentStep,
+        iteration: json.iteration,
+        pending: json.pending,
+        pending_ref: json.pendingRef,
+        trajectory_ref: json.trajectoryRef,
+        context_ref: json.contextRef,
+        artifacts_ref: json.artifactsRef,
+        checkpoint_ref: json.checkpointRef,
+        run_status: json.status,
+        run_retries: JSON.stringify(json.retries),
+    };
+    const parsed = runStateFromDocument(document);
+    if (!parsed)
+        throw new Error('Invalid Run state: runId must be a non-empty string');
+    return parsed;
+}
+export function parseStoredRunStateValue(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Invalid Run state: stored value must be an object');
+    }
+    const json = value;
+    const unknown = Object.keys(json).find((key) => !STORED_RUN_STATE_KEYS.has(key));
+    if (unknown)
+        throw new Error(`Invalid Run state: unknown field ${unknown}`);
+    if (json.currentStep !== null &&
+        (typeof json.currentStep !== 'string' || json.currentStep.length === 0)) {
+        throw new Error('Invalid Run state: currentStep must be a non-empty string or null');
+    }
+    if (json.pending !== null && (typeof json.pending !== 'string' || json.pending.length === 0)) {
+        throw new Error('Invalid Run state: pending must be a non-empty string or null');
+    }
+    if (!json.retries || typeof json.retries !== 'object' || Array.isArray(json.retries)) {
+        throw new Error('Invalid Run state: retries must be an object');
+    }
+    return fromStoredState(json);
+}
+function stateFile(changeDir, storage) {
+    assertRunStorageLayout(storage);
+    return path.resolve(changeDir, ...storage.stateRef.split(/[\\/]/u));
+}
+export function startRunWithStorage(pkg, runId, skillHash, storage) {
+    assertRunStorageLayout(storage);
+    return {
+        runId,
+        skill: pkg.definition.metadata.name,
+        skillVersion: pkg.definition.metadata.version,
+        skillHash,
+        orchestration: pkg.definition.orchestration.mode,
+        currentStep: pkg.definition.orchestration.entry ?? null,
+        iteration: 0,
+        pending: null,
+        pendingRef: storage.pendingRef,
+        trajectoryRef: storage.trajectoryRef,
+        contextRef: storage.contextRef,
+        artifactsRef: storage.artifactsRef,
+        checkpointRef: storage.checkpointRef,
+        status: 'running',
+        retries: {},
+    };
+}
+export async function readRunStateAt(changeDir, storage) {
+    let raw;
+    try {
+        raw = await fs.readFile(stateFile(changeDir, storage), 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    return parseStoredRunStateValue(JSON.parse(raw));
+}
+export async function writeRunStateAt(changeDir, state, storage) {
+    const file = stateFile(changeDir, storage);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    const temporary = path.join(path.dirname(file), `run-state.${randomUUID()}.tmp`);
+    const validated = parseStoredRunStateValue(toStoredState(state));
+    await fs.writeFile(temporary, JSON.stringify(toStoredState(validated), null, 2), 'utf8');
+    await fs.rename(temporary, file);
+}
+export async function removeRunStateAt(changeDir, storage) {
+    await fs.rm(stateFile(changeDir, storage), { force: true });
+}
+//# sourceMappingURL=storage-run.js.map