open-multi-agent-kit 0.95.2 → 0.96.1

package/dist/core/durable-goal-store.js

@@ -0,0 +1,126 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import lockfile from "proper-lockfile";
+import { DurableGoalError } from "./durable-goal.js";
+import { parseDurableGoalSnapshot } from "./durable-goal-parse.js";
+import { applyDurableGoalCommand } from "./durable-goal-reducer.js";
+export const DURABLE_GOAL_JOURNAL_SCHEMA_VERSION = "omk.goal.journal.v1";
+export class DurableGoalStore {
+    filePath;
+    constructor(filePath) {
+        if (filePath.trim().length === 0)
+            throw new DurableGoalError("invalid-input", "goal file path must not be empty");
+        this.filePath = filePath;
+    }
+    async readJournal() {
+        return this.readUnlocked();
+    }
+    async current() {
+        const journal = await this.readUnlocked();
+        return journal?.revisions.at(-1) ?? null;
+    }
+    async create(goal) {
+        return this.withLock(async () => {
+            if ((await this.readUnlocked()) !== null) {
+                throw new DurableGoalError("store-exists", "durable goal already exists");
+            }
+            const initial = parseDurableGoalSnapshot(goal);
+            if (initial.ref.revision !== 1 ||
+                initial.status !== "active" ||
+                initial.completedRounds !== 0 ||
+                initial.evidence.length !== 0 ||
+                initial.checkpoint !== undefined ||
+                initial.createdAt !== initial.updatedAt ||
+                initial.createdAt !== initial.generationStartedAt) {
+                throw invalidStore();
+            }
+            await this.writeUnlocked({
+                schemaVersion: DURABLE_GOAL_JOURNAL_SCHEMA_VERSION,
+                goalId: initial.ref.id,
+                revisions: [initial],
+            });
+            return initial;
+        });
+    }
+    async transition(command, now) {
+        return this.withLock(async () => {
+            const journal = await this.readUnlocked();
+            const current = journal?.revisions.at(-1);
+            if (!journal || !current)
+                throw new DurableGoalError("store-missing", "durable goal does not exist");
+            const next = applyDurableGoalCommand(current, command, now);
+            await this.writeUnlocked({ ...journal, revisions: [...journal.revisions, next] });
+            return next;
+        });
+    }
+    async withLock(operation) {
+        const directory = dirname(this.filePath);
+        await mkdir(directory, { recursive: true });
+        const release = await lockfile.lock(this.filePath, {
+            realpath: false,
+            retries: { retries: 5, factor: 1, minTimeout: 5, maxTimeout: 25 },
+        });
+        try {
+            return await operation();
+        }
+        finally {
+            await release();
+        }
+    }
+    async readUnlocked() {
+        let raw;
+        try {
+            raw = await readFile(this.filePath, "utf8");
+        }
+        catch (error) {
+            if (isFileSystemError(error, "ENOENT"))
+                return null;
+            throw error;
+        }
+        try {
+            return parseJournal(JSON.parse(raw));
+        }
+        catch (error) {
+            if (error instanceof DurableGoalError && error.code === "invalid-store")
+                throw error;
+            throw new DurableGoalError("invalid-store", "durable goal journal is invalid");
+        }
+    }
+    async writeUnlocked(journal) {
+        const tempPath = join(dirname(this.filePath), `.goal-${randomUUID()}.tmp`);
+        try {
+            await writeFile(tempPath, `${JSON.stringify(journal, null, 2)}\n`, "utf8");
+            await rename(tempPath, this.filePath);
+        }
+        catch (error) {
+            await rm(tempPath, { force: true });
+            throw error;
+        }
+    }
+}
+function parseJournal(value) {
+    if (!isRecord(value) || value.schemaVersion !== DURABLE_GOAL_JOURNAL_SCHEMA_VERSION)
+        throw invalidStore();
+    if (typeof value.goalId !== "string" || value.goalId.length === 0 || !Array.isArray(value.revisions)) {
+        throw invalidStore();
+    }
+    const revisions = value.revisions.map(parseDurableGoalSnapshot);
+    if (revisions.length === 0)
+        throw invalidStore();
+    for (const [index, revision] of revisions.entries()) {
+        if (revision.ref.id !== value.goalId || revision.ref.revision !== index + 1)
+            throw invalidStore();
+    }
+    return { schemaVersion: DURABLE_GOAL_JOURNAL_SCHEMA_VERSION, goalId: value.goalId, revisions };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isFileSystemError(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+function invalidStore() {
+    return new DurableGoalError("invalid-store", "durable goal journal is invalid");
+}
+//# sourceMappingURL=durable-goal-store.js.map

package/dist/core/durable-goal-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-goal-store.js","sourceRoot":"","sources":["../../src/core/durable-goal-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, readFile, rename, rm, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport lockfile from \"proper-lockfile\";\nimport { type DurableGoalCommand, DurableGoalError, type DurableGoalSnapshot } from \"./durable-goal.ts\";\nimport { parseDurableGoalSnapshot } from \"./durable-goal-parse.ts\";\nimport { applyDurableGoalCommand } from \"./durable-goal-reducer.ts\";\n\nexport const DURABLE_GOAL_JOURNAL_SCHEMA_VERSION = \"omk.goal.journal.v1\" as const;\n\nexport interface DurableGoalJournal {\n\treadonly schemaVersion: typeof DURABLE_GOAL_JOURNAL_SCHEMA_VERSION;\n\treadonly goalId: string;\n\treadonly revisions: readonly DurableGoalSnapshot[];\n}\n\nexport class DurableGoalStore {\n\treadonly filePath: string;\n\n\tconstructor(filePath: string) {\n\t\tif (filePath.trim().length === 0) throw new DurableGoalError(\"invalid-input\", \"goal file path must not be empty\");\n\t\tthis.filePath = filePath;\n\t}\n\n\tasync readJournal(): Promise<DurableGoalJournal | null> {\n\t\treturn this.readUnlocked();\n\t}\n\n\tasync current(): Promise<DurableGoalSnapshot | null> {\n\t\tconst journal = await this.readUnlocked();\n\t\treturn journal?.revisions.at(-1) ?? null;\n\t}\n\n\tasync create(goal: DurableGoalSnapshot): Promise<DurableGoalSnapshot> {\n\t\treturn this.withLock(async () => {\n\t\t\tif ((await this.readUnlocked()) !== null) {\n\t\t\t\tthrow new DurableGoalError(\"store-exists\", \"durable goal already exists\");\n\t\t\t}\n\t\t\tconst initial = parseDurableGoalSnapshot(goal);\n\t\t\tif (\n\t\t\t\tinitial.ref.revision !== 1 ||\n\t\t\t\tinitial.status !== \"active\" ||\n\t\t\t\tinitial.completedRounds !== 0 ||\n\t\t\t\tinitial.evidence.length !== 0 ||\n\t\t\t\tinitial.checkpoint !== undefined ||\n\t\t\t\tinitial.createdAt !== initial.updatedAt ||\n\t\t\t\tinitial.createdAt !== initial.generationStartedAt\n\t\t\t) {\n\t\t\t\tthrow invalidStore();\n\t\t\t}\n\t\t\tawait this.writeUnlocked({\n\t\t\t\tschemaVersion: DURABLE_GOAL_JOURNAL_SCHEMA_VERSION,\n\t\t\t\tgoalId: initial.ref.id,\n\t\t\t\trevisions: [initial],\n\t\t\t});\n\t\t\treturn initial;\n\t\t});\n\t}\n\n\tasync transition(command: DurableGoalCommand, now: string): Promise<DurableGoalSnapshot> {\n\t\treturn this.withLock(async () => {\n\t\t\tconst journal = await this.readUnlocked();\n\t\t\tconst current = journal?.revisions.at(-1);\n\t\t\tif (!journal || !current) throw new DurableGoalError(\"store-missing\", \"durable goal does not exist\");\n\t\t\tconst next = applyDurableGoalCommand(current, command, now);\n\t\t\tawait this.writeUnlocked({ ...journal, revisions: [...journal.revisions, next] });\n\t\t\treturn next;\n\t\t});\n\t}\n\n\tprivate async withLock<T>(operation: () => Promise<T>): Promise<T> {\n\t\tconst directory = dirname(this.filePath);\n\t\tawait mkdir(directory, { recursive: true });\n\t\tconst release = await lockfile.lock(this.filePath, {\n\t\t\trealpath: false,\n\t\t\tretries: { retries: 5, factor: 1, minTimeout: 5, maxTimeout: 25 },\n\t\t});\n\t\ttry {\n\t\t\treturn await operation();\n\t\t} finally {\n\t\t\tawait release();\n\t\t}\n\t}\n\n\tprivate async readUnlocked(): Promise<DurableGoalJournal | null> {\n\t\tlet raw: string;\n\t\ttry {\n\t\t\traw = await readFile(this.filePath, \"utf8\");\n\t\t} catch (error) {\n\t\t\tif (isFileSystemError(error, \"ENOENT\")) return null;\n\t\t\tthrow error;\n\t\t}\n\t\ttry {\n\t\t\treturn parseJournal(JSON.parse(raw));\n\t\t} catch (error) {\n\t\t\tif (error instanceof DurableGoalError && error.code === \"invalid-store\") throw error;\n\t\t\tthrow new DurableGoalError(\"invalid-store\", \"durable goal journal is invalid\");\n\t\t}\n\t}\n\n\tprivate async writeUnlocked(journal: DurableGoalJournal): Promise<void> {\n\t\tconst tempPath = join(dirname(this.filePath), `.goal-${randomUUID()}.tmp`);\n\t\ttry {\n\t\t\tawait writeFile(tempPath, `${JSON.stringify(journal, null, 2)}\\n`, \"utf8\");\n\t\t\tawait rename(tempPath, this.filePath);\n\t\t} catch (error) {\n\t\t\tawait rm(tempPath, { force: true });\n\t\t\tthrow error;\n\t\t}\n\t}\n}\n\nfunction parseJournal(value: unknown): DurableGoalJournal {\n\tif (!isRecord(value) || value.schemaVersion !== DURABLE_GOAL_JOURNAL_SCHEMA_VERSION) throw invalidStore();\n\tif (typeof value.goalId !== \"string\" || value.goalId.length === 0 || !Array.isArray(value.revisions)) {\n\t\tthrow invalidStore();\n\t}\n\tconst revisions = value.revisions.map(parseDurableGoalSnapshot);\n\tif (revisions.length === 0) throw invalidStore();\n\tfor (const [index, revision] of revisions.entries()) {\n\t\tif (revision.ref.id !== value.goalId || revision.ref.revision !== index + 1) throw invalidStore();\n\t}\n\treturn { schemaVersion: DURABLE_GOAL_JOURNAL_SCHEMA_VERSION, goalId: value.goalId, revisions };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isFileSystemError(error: unknown, code: string): boolean {\n\treturn error instanceof Error && \"code\" in error && error.code === code;\n}\n\nfunction invalidStore(): DurableGoalError {\n\treturn new DurableGoalError(\"invalid-store\", \"durable goal journal is invalid\");\n}\n"]}

package/dist/core/durable-goal.d.ts

@@ -0,0 +1,92 @@
+export declare const DURABLE_GOAL_SCHEMA_VERSION: "omk.goal.v1";
+export declare const DURABLE_GOAL_STATUS_VALUES: readonly ["active", "paused", "blocked", "completed", "cleared"];
+export type DurableGoalStatus = (typeof DURABLE_GOAL_STATUS_VALUES)[number];
+export type DurableGoalErrorCode = "evidence-required" | "illegal-transition" | "invalid-input" | "invalid-store" | "round-limit" | "stale-ref" | "store-exists" | "store-missing";
+export interface DurableGoalRef {
+    readonly id: string;
+    readonly revision: number;
+}
+export interface DurableGoalEvidence {
+    readonly id: string;
+    readonly digest: string;
+    readonly capturedAt: string;
+    readonly goalGeneration: string;
+}
+export declare const DURABLE_GOAL_CHECKPOINT_SCHEMA_VERSION: "omk.goal.checkpoint.v1";
+export interface DurableGoalCheckpointInput {
+    readonly core: readonly string[];
+    readonly verifiedEvidenceIds: readonly string[];
+    readonly open: readonly string[];
+    readonly next: string;
+    readonly capturedAt: string;
+}
+export interface DurableGoalCheckpoint extends DurableGoalCheckpointInput {
+    readonly schemaVersion: typeof DURABLE_GOAL_CHECKPOINT_SCHEMA_VERSION;
+    readonly goalGeneration: string;
+    readonly digest: string;
+}
+export interface DurableGoalSnapshot {
+    readonly schemaVersion: typeof DURABLE_GOAL_SCHEMA_VERSION;
+    readonly ref: DurableGoalRef;
+    readonly objective: string;
+    readonly status: DurableGoalStatus;
+    readonly maxRounds: number;
+    readonly completedRounds: number;
+    readonly evidence: readonly DurableGoalEvidence[];
+    readonly createdAt: string;
+    readonly generationStartedAt: string;
+    readonly updatedAt: string;
+    readonly checkpoint?: DurableGoalCheckpoint;
+    readonly blockedReason?: string;
+    readonly terminalAt?: string;
+}
+export type DurableGoalCommand = {
+    readonly kind: "edit";
+    readonly ref: DurableGoalRef;
+    readonly objective?: string;
+    readonly maxRounds?: number;
+} | {
+    readonly kind: "pause";
+    readonly ref: DurableGoalRef;
+} | {
+    readonly kind: "resume";
+    readonly ref: DurableGoalRef;
+} | {
+    readonly kind: "block";
+    readonly ref: DurableGoalRef;
+    readonly reason: string;
+} | {
+    readonly kind: "advance-round";
+    readonly ref: DurableGoalRef;
+} | {
+    readonly kind: "record-checkpoint";
+    readonly ref: DurableGoalRef;
+    readonly checkpoint: DurableGoalCheckpointInput;
+} | {
+    readonly kind: "attach-evidence";
+    readonly ref: DurableGoalRef;
+    readonly evidence: {
+        readonly id: string;
+        readonly digest: string;
+        readonly capturedAt: string;
+    };
+} | {
+    readonly kind: "complete";
+    readonly ref: DurableGoalRef;
+} | {
+    readonly kind: "clear";
+    readonly ref: DurableGoalRef;
+};
+export declare class DurableGoalError extends Error {
+    readonly code: DurableGoalErrorCode;
+    constructor(code: DurableGoalErrorCode, message: string);
+}
+export declare function createDurableGoal(input: {
+    readonly id: string;
+    readonly objective: string;
+    readonly maxRounds: number;
+    readonly now: string;
+}): DurableGoalSnapshot;
+export declare function computeDurableGoalGeneration(goal: DurableGoalSnapshot): string;
+export declare function freshDurableGoalEvidence(goal: DurableGoalSnapshot): readonly DurableGoalEvidence[];
+//# sourceMappingURL=durable-goal.d.ts.map

package/dist/core/durable-goal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-goal.d.ts","sourceRoot":"","sources":["../../src/core/durable-goal.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nexport const DURABLE_GOAL_SCHEMA_VERSION = \"omk.goal.v1\" as const;\nexport const DURABLE_GOAL_STATUS_VALUES = [\"active\", \"paused\", \"blocked\", \"completed\", \"cleared\"] as const;\n\nexport type DurableGoalStatus = (typeof DURABLE_GOAL_STATUS_VALUES)[number];\nexport type DurableGoalErrorCode =\n\t| \"evidence-required\"\n\t| \"illegal-transition\"\n\t| \"invalid-input\"\n\t| \"invalid-store\"\n\t| \"round-limit\"\n\t| \"stale-ref\"\n\t| \"store-exists\"\n\t| \"store-missing\";\n\nexport interface DurableGoalRef {\n\treadonly id: string;\n\treadonly revision: number;\n}\n\nexport interface DurableGoalEvidence {\n\treadonly id: string;\n\treadonly digest: string;\n\treadonly capturedAt: string;\n\treadonly goalGeneration: string;\n}\n\nexport const DURABLE_GOAL_CHECKPOINT_SCHEMA_VERSION = \"omk.goal.checkpoint.v1\" as const;\n\nexport interface DurableGoalCheckpointInput {\n\treadonly core: readonly string[];\n\treadonly verifiedEvidenceIds: readonly string[];\n\treadonly open: readonly string[];\n\treadonly next: string;\n\treadonly capturedAt: string;\n}\n\nexport interface DurableGoalCheckpoint extends DurableGoalCheckpointInput {\n\treadonly schemaVersion: typeof DURABLE_GOAL_CHECKPOINT_SCHEMA_VERSION;\n\treadonly goalGeneration: string;\n\treadonly digest: string;\n}\n\nexport interface DurableGoalSnapshot {\n\treadonly schemaVersion: typeof DURABLE_GOAL_SCHEMA_VERSION;\n\treadonly ref: DurableGoalRef;\n\treadonly objective: string;\n\treadonly status: DurableGoalStatus;\n\treadonly maxRounds: number;\n\treadonly completedRounds: number;\n\treadonly evidence: readonly DurableGoalEvidence[];\n\treadonly createdAt: string;\n\treadonly generationStartedAt: string;\n\treadonly updatedAt: string;\n\treadonly checkpoint?: DurableGoalCheckpoint;\n\treadonly blockedReason?: string;\n\treadonly terminalAt?: string;\n}\n\nexport type DurableGoalCommand =\n\t| { readonly kind: \"edit\"; readonly ref: DurableGoalRef; readonly objective?: string; readonly maxRounds?: number }\n\t| { readonly kind: \"pause\"; readonly ref: DurableGoalRef }\n\t| { readonly kind: \"resume\"; readonly ref: DurableGoalRef }\n\t| { readonly kind: \"block\"; readonly ref: DurableGoalRef; readonly reason: string }\n\t| { readonly kind: \"advance-round\"; readonly ref: DurableGoalRef }\n\t| {\n\t\t\treadonly kind: \"record-checkpoint\";\n\t\t\treadonly ref: DurableGoalRef;\n\t\t\treadonly checkpoint: DurableGoalCheckpointInput;\n\t  }\n\t| {\n\t\t\treadonly kind: \"attach-evidence\";\n\t\t\treadonly ref: DurableGoalRef;\n\t\t\treadonly evidence: { readonly id: string; readonly digest: string; readonly capturedAt: string };\n\t  }\n\t| { readonly kind: \"complete\"; readonly ref: DurableGoalRef }\n\t| { readonly kind: \"clear\"; readonly ref: DurableGoalRef };\n\nexport class DurableGoalError extends Error {\n\treadonly code: DurableGoalErrorCode;\n\n\tconstructor(code: DurableGoalErrorCode, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"DurableGoalError\";\n\t\tthis.code = code;\n\t}\n}\n\nexport function createDurableGoal(input: {\n\treadonly id: string;\n\treadonly objective: string;\n\treadonly maxRounds: number;\n\treadonly now: string;\n}): DurableGoalSnapshot {\n\treturn {\n\t\tschemaVersion: DURABLE_GOAL_SCHEMA_VERSION,\n\t\tref: { id: requireText(input.id, \"goal id\"), revision: 1 },\n\t\tobjective: requireText(input.objective, \"goal objective\"),\n\t\tstatus: \"active\",\n\t\tmaxRounds: requirePositiveInteger(input.maxRounds, \"maxRounds\"),\n\t\tcompletedRounds: 0,\n\t\tevidence: [],\n\t\tcreatedAt: requireTimestamp(input.now, \"now\"),\n\t\tgenerationStartedAt: input.now,\n\t\tupdatedAt: input.now,\n\t};\n}\n\nexport function computeDurableGoalGeneration(goal: DurableGoalSnapshot): string {\n\treturn createHash(\"sha256\")\n\t\t.update(\n\t\t\tJSON.stringify([goal.ref.id, goal.objective, goal.maxRounds, goal.completedRounds, goal.generationStartedAt]),\n\t\t)\n\t\t.digest(\"hex\");\n}\n\nexport function freshDurableGoalEvidence(goal: DurableGoalSnapshot): readonly DurableGoalEvidence[] {\n\tconst generation = computeDurableGoalGeneration(goal);\n\tconst legacyInitialGeneration =\n\t\tgoal.generationStartedAt === goal.createdAt ? computeLegacyDurableGoalGeneration(goal) : undefined;\n\treturn goal.evidence.filter(\n\t\t(evidence) =>\n\t\t\t(evidence.goalGeneration === generation || evidence.goalGeneration === legacyInitialGeneration) &&\n\t\t\tDate.parse(evidence.capturedAt) >= Date.parse(goal.generationStartedAt) &&\n\t\t\tDate.parse(evidence.capturedAt) <= Date.parse(goal.updatedAt),\n\t);\n}\n\nfunction computeLegacyDurableGoalGeneration(goal: DurableGoalSnapshot): string {\n\treturn createHash(\"sha256\")\n\t\t.update(JSON.stringify([goal.ref.id, goal.objective, goal.maxRounds, goal.completedRounds]))\n\t\t.digest(\"hex\");\n}\n\nfunction requireText(value: string, label: string): string {\n\tconst normalized = value.trim();\n\tif (normalized.length === 0) throw new DurableGoalError(\"invalid-input\", `${label} must not be empty`);\n\treturn normalized;\n}\n\nfunction requirePositiveInteger(value: number, label: string): number {\n\tif (!Number.isSafeInteger(value) || value < 1) {\n\t\tthrow new DurableGoalError(\"invalid-input\", `${label} must be a positive integer`);\n\t}\n\treturn value;\n}\n\nfunction requireTimestamp(value: string, label: string): string {\n\tif (value.length === 0 || Number.isNaN(Date.parse(value))) {\n\t\tthrow new DurableGoalError(\"invalid-input\", `${label} must be an ISO timestamp`);\n\t}\n\treturn value;\n}\n"]}

package/dist/core/durable-goal.js

@@ -0,0 +1,62 @@
+import { createHash } from "node:crypto";
+export const DURABLE_GOAL_SCHEMA_VERSION = "omk.goal.v1";
+export const DURABLE_GOAL_STATUS_VALUES = ["active", "paused", "blocked", "completed", "cleared"];
+export const DURABLE_GOAL_CHECKPOINT_SCHEMA_VERSION = "omk.goal.checkpoint.v1";
+export class DurableGoalError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "DurableGoalError";
+        this.code = code;
+    }
+}
+export function createDurableGoal(input) {
+    return {
+        schemaVersion: DURABLE_GOAL_SCHEMA_VERSION,
+        ref: { id: requireText(input.id, "goal id"), revision: 1 },
+        objective: requireText(input.objective, "goal objective"),
+        status: "active",
+        maxRounds: requirePositiveInteger(input.maxRounds, "maxRounds"),
+        completedRounds: 0,
+        evidence: [],
+        createdAt: requireTimestamp(input.now, "now"),
+        generationStartedAt: input.now,
+        updatedAt: input.now,
+    };
+}
+export function computeDurableGoalGeneration(goal) {
+    return createHash("sha256")
+        .update(JSON.stringify([goal.ref.id, goal.objective, goal.maxRounds, goal.completedRounds, goal.generationStartedAt]))
+        .digest("hex");
+}
+export function freshDurableGoalEvidence(goal) {
+    const generation = computeDurableGoalGeneration(goal);
+    const legacyInitialGeneration = goal.generationStartedAt === goal.createdAt ? computeLegacyDurableGoalGeneration(goal) : undefined;
+    return goal.evidence.filter((evidence) => (evidence.goalGeneration === generation || evidence.goalGeneration === legacyInitialGeneration) &&
+        Date.parse(evidence.capturedAt) >= Date.parse(goal.generationStartedAt) &&
+        Date.parse(evidence.capturedAt) <= Date.parse(goal.updatedAt));
+}
+function computeLegacyDurableGoalGeneration(goal) {
+    return createHash("sha256")
+        .update(JSON.stringify([goal.ref.id, goal.objective, goal.maxRounds, goal.completedRounds]))
+        .digest("hex");
+}
+function requireText(value, label) {
+    const normalized = value.trim();
+    if (normalized.length === 0)
+        throw new DurableGoalError("invalid-input", `${label} must not be empty`);
+    return normalized;
+}
+function requirePositiveInteger(value, label) {
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new DurableGoalError("invalid-input", `${label} must be a positive integer`);
+    }
+    return value;
+}
+function requireTimestamp(value, label) {
+    if (value.length === 0 || Number.isNaN(Date.parse(value))) {
+        throw new DurableGoalError("invalid-input", `${label} must be an ISO timestamp`);
+    }
+    return value;
+}
+//# sourceMappingURL=durable-goal.js.map

package/dist/core/durable-goal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-goal.js","sourceRoot":"","sources":["../../src/core/durable-goal.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nexport const DURABLE_GOAL_SCHEMA_VERSION = \"omk.goal.v1\" as const;\nexport const DURABLE_GOAL_STATUS_VALUES = [\"active\", \"paused\", \"blocked\", \"completed\", \"cleared\"] as const;\n\nexport type DurableGoalStatus = (typeof DURABLE_GOAL_STATUS_VALUES)[number];\nexport type DurableGoalErrorCode =\n\t| \"evidence-required\"\n\t| \"illegal-transition\"\n\t| \"invalid-input\"\n\t| \"invalid-store\"\n\t| \"round-limit\"\n\t| \"stale-ref\"\n\t| \"store-exists\"\n\t| \"store-missing\";\n\nexport interface DurableGoalRef {\n\treadonly id: string;\n\treadonly revision: number;\n}\n\nexport interface DurableGoalEvidence {\n\treadonly id: string;\n\treadonly digest: string;\n\treadonly capturedAt: string;\n\treadonly goalGeneration: string;\n}\n\nexport const DURABLE_GOAL_CHECKPOINT_SCHEMA_VERSION = \"omk.goal.checkpoint.v1\" as const;\n\nexport interface DurableGoalCheckpointInput {\n\treadonly core: readonly string[];\n\treadonly verifiedEvidenceIds: readonly string[];\n\treadonly open: readonly string[];\n\treadonly next: string;\n\treadonly capturedAt: string;\n}\n\nexport interface DurableGoalCheckpoint extends DurableGoalCheckpointInput {\n\treadonly schemaVersion: typeof DURABLE_GOAL_CHECKPOINT_SCHEMA_VERSION;\n\treadonly goalGeneration: string;\n\treadonly digest: string;\n}\n\nexport interface DurableGoalSnapshot {\n\treadonly schemaVersion: typeof DURABLE_GOAL_SCHEMA_VERSION;\n\treadonly ref: DurableGoalRef;\n\treadonly objective: string;\n\treadonly status: DurableGoalStatus;\n\treadonly maxRounds: number;\n\treadonly completedRounds: number;\n\treadonly evidence: readonly DurableGoalEvidence[];\n\treadonly createdAt: string;\n\treadonly generationStartedAt: string;\n\treadonly updatedAt: string;\n\treadonly checkpoint?: DurableGoalCheckpoint;\n\treadonly blockedReason?: string;\n\treadonly terminalAt?: string;\n}\n\nexport type DurableGoalCommand =\n\t| { readonly kind: \"edit\"; readonly ref: DurableGoalRef; readonly objective?: string; readonly maxRounds?: number }\n\t| { readonly kind: \"pause\"; readonly ref: DurableGoalRef }\n\t| { readonly kind: \"resume\"; readonly ref: DurableGoalRef }\n\t| { readonly kind: \"block\"; readonly ref: DurableGoalRef; readonly reason: string }\n\t| { readonly kind: \"advance-round\"; readonly ref: DurableGoalRef }\n\t| {\n\t\t\treadonly kind: \"record-checkpoint\";\n\t\t\treadonly ref: DurableGoalRef;\n\t\t\treadonly checkpoint: DurableGoalCheckpointInput;\n\t  }\n\t| {\n\t\t\treadonly kind: \"attach-evidence\";\n\t\t\treadonly ref: DurableGoalRef;\n\t\t\treadonly evidence: { readonly id: string; readonly digest: string; readonly capturedAt: string };\n\t  }\n\t| { readonly kind: \"complete\"; readonly ref: DurableGoalRef }\n\t| { readonly kind: \"clear\"; readonly ref: DurableGoalRef };\n\nexport class DurableGoalError extends Error {\n\treadonly code: DurableGoalErrorCode;\n\n\tconstructor(code: DurableGoalErrorCode, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"DurableGoalError\";\n\t\tthis.code = code;\n\t}\n}\n\nexport function createDurableGoal(input: {\n\treadonly id: string;\n\treadonly objective: string;\n\treadonly maxRounds: number;\n\treadonly now: string;\n}): DurableGoalSnapshot {\n\treturn {\n\t\tschemaVersion: DURABLE_GOAL_SCHEMA_VERSION,\n\t\tref: { id: requireText(input.id, \"goal id\"), revision: 1 },\n\t\tobjective: requireText(input.objective, \"goal objective\"),\n\t\tstatus: \"active\",\n\t\tmaxRounds: requirePositiveInteger(input.maxRounds, \"maxRounds\"),\n\t\tcompletedRounds: 0,\n\t\tevidence: [],\n\t\tcreatedAt: requireTimestamp(input.now, \"now\"),\n\t\tgenerationStartedAt: input.now,\n\t\tupdatedAt: input.now,\n\t};\n}\n\nexport function computeDurableGoalGeneration(goal: DurableGoalSnapshot): string {\n\treturn createHash(\"sha256\")\n\t\t.update(\n\t\t\tJSON.stringify([goal.ref.id, goal.objective, goal.maxRounds, goal.completedRounds, goal.generationStartedAt]),\n\t\t)\n\t\t.digest(\"hex\");\n}\n\nexport function freshDurableGoalEvidence(goal: DurableGoalSnapshot): readonly DurableGoalEvidence[] {\n\tconst generation = computeDurableGoalGeneration(goal);\n\tconst legacyInitialGeneration =\n\t\tgoal.generationStartedAt === goal.createdAt ? computeLegacyDurableGoalGeneration(goal) : undefined;\n\treturn goal.evidence.filter(\n\t\t(evidence) =>\n\t\t\t(evidence.goalGeneration === generation || evidence.goalGeneration === legacyInitialGeneration) &&\n\t\t\tDate.parse(evidence.capturedAt) >= Date.parse(goal.generationStartedAt) &&\n\t\t\tDate.parse(evidence.capturedAt) <= Date.parse(goal.updatedAt),\n\t);\n}\n\nfunction computeLegacyDurableGoalGeneration(goal: DurableGoalSnapshot): string {\n\treturn createHash(\"sha256\")\n\t\t.update(JSON.stringify([goal.ref.id, goal.objective, goal.maxRounds, goal.completedRounds]))\n\t\t.digest(\"hex\");\n}\n\nfunction requireText(value: string, label: string): string {\n\tconst normalized = value.trim();\n\tif (normalized.length === 0) throw new DurableGoalError(\"invalid-input\", `${label} must not be empty`);\n\treturn normalized;\n}\n\nfunction requirePositiveInteger(value: number, label: string): number {\n\tif (!Number.isSafeInteger(value) || value < 1) {\n\t\tthrow new DurableGoalError(\"invalid-input\", `${label} must be a positive integer`);\n\t}\n\treturn value;\n}\n\nfunction requireTimestamp(value: string, label: string): string {\n\tif (value.length === 0 || Number.isNaN(Date.parse(value))) {\n\t\tthrow new DurableGoalError(\"invalid-input\", `${label} must be an ISO timestamp`);\n\t}\n\treturn value;\n}\n"]}

package/dist/core/extensions/builtin/goal-controller.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "../types.ts";
+export default function goalController(omk: ExtensionAPI): void;
+//# sourceMappingURL=goal-controller.d.ts.map

package/dist/core/extensions/builtin/goal-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-controller.d.ts","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/goal-controller.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA8BhD,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CA+F9D","sourcesContent":["import { rm } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { createDurableGoal, DurableGoalError, type DurableGoalSnapshot } from \"../../durable-goal.ts\";\nimport { formatDurableGoalCheckpoint, parseDurableGoalCheckpointCommand } from \"../../durable-goal-checkpoint.ts\";\nimport { DurableGoalStore } from \"../../durable-goal-store.ts\";\nimport { decideGoalContinuation } from \"../../goal-continuation.ts\";\nimport type { ExtensionAPI } from \"../types.ts\";\n\nfunction goalPath(cwd: string): string {\n\treturn join(cwd, \".omk\", \"goals\", \"current.json\");\n}\n\nfunction renderGoal(goal: DurableGoalSnapshot): string {\n\treturn `goal ${goal.ref.id} r${goal.ref.revision} ${goal.status} ${goal.completedRounds}/${goal.maxRounds}\\n${formatDurableGoalCheckpoint(goal)}`;\n}\n\nfunction checkpointPayload(text: string): string | null {\n\tif (text === \"checkpoint\") return \"\";\n\treturn text.startsWith(\"checkpoint \") ? text.slice(\"checkpoint \".length).trim() : null;\n}\n\nfunction unavailableWorkspaceCode(error: unknown): \"ENODEV\" | \"ESTALE\" | \"ENOTCONN\" | undefined {\n\tif (typeof error !== \"object\" || error === null || !(\"code\" in error)) return undefined;\n\tconst code = error.code;\n\treturn code === \"ENODEV\" || code === \"ESTALE\" || code === \"ENOTCONN\" ? code : undefined;\n}\n\nfunction continuationSeam(goal: DurableGoalSnapshot, trustedDigests: ReadonlySet<string>): string {\n\tconst checkpoint = goal.checkpoint;\n\tif (!checkpoint) return \"\";\n\tif (trustedDigests.has(checkpoint.digest)) {\n\t\treturn `\\n\\nSeam checkpoint (explicit user continuity context, not current-round proof):\\n${formatDurableGoalCheckpoint(goal)}`;\n\t}\n\treturn `\\n\\nAn untrusted workspace checkpoint exists at digest ${checkpoint.digest}; its prose was not loaded as user authority.`;\n}\n\nexport default function goalController(omk: ExtensionAPI): void {\n\tconst trustedCheckpointDigests = new Set<string>();\n\tomk.registerCommand(\"goal\", {\n\t\tdescription: \"Show, set, checkpoint, pause, resume, complete, or clear the durable session goal\",\n\t\thandler: async (args, ctx) => {\n\t\t\tconst store = new DurableGoalStore(goalPath(ctx.cwd));\n\t\t\tconst text = args.trim();\n\t\t\ttry {\n\t\t\t\tif (text.length === 0) {\n\t\t\t\t\tconst current = await store.current();\n\t\t\t\t\tctx.ui.notify(current ? renderGoal(current) : \"no durable goal\", \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst existing = await store.current();\n\t\t\t\tif (text === \"pause\" || text === \"resume\" || text === \"complete\" || text === \"clear\") {\n\t\t\t\t\tif (!existing) throw new DurableGoalError(\"store-missing\", \"durable goal does not exist\");\n\t\t\t\t\tconst next = await store.transition({ kind: text, ref: existing.ref }, new Date().toISOString());\n\t\t\t\t\tif (text === \"clear\") trustedCheckpointDigests.clear();\n\t\t\t\t\tctx.ui.notify(renderGoal(next), \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst payload = checkpointPayload(text);\n\t\t\t\tif (payload !== null) {\n\t\t\t\t\tif (!existing) throw new DurableGoalError(\"store-missing\", \"durable goal does not exist\");\n\t\t\t\t\tif (payload.length === 0) {\n\t\t\t\t\t\tthrow new DurableGoalError(\n\t\t\t\t\t\t\t\"invalid-input\",\n\t\t\t\t\t\t\t'usage: /goal checkpoint {\"core\":[],\"verified\":[],\"open\":[],\"next\":\"...\"}',\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tconst now = new Date().toISOString();\n\t\t\t\t\tconst next = await store.transition(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tkind: \"record-checkpoint\",\n\t\t\t\t\t\t\tref: existing.ref,\n\t\t\t\t\t\t\tcheckpoint: parseDurableGoalCheckpointCommand(payload, now),\n\t\t\t\t\t\t},\n\t\t\t\t\t\tnow,\n\t\t\t\t\t);\n\t\t\t\t\tconst checkpoint = next.checkpoint;\n\t\t\t\t\tif (!checkpoint) throw new DurableGoalError(\"invalid-store\", \"durable goal journal is invalid\");\n\t\t\t\t\tomk.appendEntry(\"goal_checkpoint\", {\n\t\t\t\t\t\tgoalId: next.ref.id,\n\t\t\t\t\t\tgoalRevision: next.ref.revision,\n\t\t\t\t\t\tcheckpointDigest: checkpoint.digest,\n\t\t\t\t\t});\n\t\t\t\t\ttrustedCheckpointDigests.add(checkpoint.digest);\n\t\t\t\t\tctx.ui.notify(renderGoal(next), \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (existing && existing.status !== \"cleared\" && existing.status !== \"completed\") {\n\t\t\t\t\tconst next = await store.transition(\n\t\t\t\t\t\t{ kind: \"edit\", ref: existing.ref, objective: text },\n\t\t\t\t\t\tnew Date().toISOString(),\n\t\t\t\t\t);\n\t\t\t\t\tctx.ui.notify(renderGoal(next), \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (existing) await rm(goalPath(ctx.cwd), { force: true });\n\t\t\t\tconst created = await store.create(\n\t\t\t\t\tcreateDurableGoal({ id: \"session\", objective: text, maxRounds: 8, now: new Date().toISOString() }),\n\t\t\t\t);\n\t\t\t\tctx.ui.notify(renderGoal(created), \"info\");\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof DurableGoalError ? error.message : \"goal command failed\";\n\t\t\t\tctx.ui.notify(message, \"error\");\n\t\t\t}\n\t\t},\n\t});\n\n\tomk.on(\"agent_end\", async (_event, ctx) => {\n\t\tconst store = new DurableGoalStore(goalPath(ctx.cwd));\n\t\tlet current: DurableGoalSnapshot | null;\n\t\ttry {\n\t\t\tcurrent = await store.current();\n\t\t} catch (error) {\n\t\t\tconst code = unavailableWorkspaceCode(error);\n\t\t\tif (!code) throw error;\n\t\t\tomk.appendEntry(\"goal_workspace_unavailable\", { code });\n\t\t\treturn;\n\t\t}\n\t\tif (!current) return;\n\t\tconst decision = decideGoalContinuation({\n\t\t\tstatus: current.status,\n\t\t\tcompletedRounds: current.completedRounds,\n\t\t\tmaxRounds: current.maxRounds,\n\t\t\thasQueuedMessages: ctx.hasPendingMessages(),\n\t\t});\n\t\tif (decision.reason === \"queued\" || !decision.continue) return;\n\t\tconst advanced = await store.transition({ kind: \"advance-round\", ref: current.ref }, new Date().toISOString());\n\t\tconst seam = continuationSeam(advanced, trustedCheckpointDigests);\n\t\tomk.sendUserMessage(\n\t\t\t`Continue the active goal (${advanced.completedRounds}/${advanced.maxRounds}): ${advanced.objective}${seam}`,\n\t\t);\n\t});\n}\n"]}

package/dist/core/extensions/builtin/goal-controller.js

@@ -0,0 +1,125 @@
+import { rm } from "node:fs/promises";
+import { join } from "node:path";
+import { createDurableGoal, DurableGoalError } from "../../durable-goal.js";
+import { formatDurableGoalCheckpoint, parseDurableGoalCheckpointCommand } from "../../durable-goal-checkpoint.js";
+import { DurableGoalStore } from "../../durable-goal-store.js";
+import { decideGoalContinuation } from "../../goal-continuation.js";
+function goalPath(cwd) {
+    return join(cwd, ".omk", "goals", "current.json");
+}
+function renderGoal(goal) {
+    return `goal ${goal.ref.id} r${goal.ref.revision} ${goal.status} ${goal.completedRounds}/${goal.maxRounds}\n${formatDurableGoalCheckpoint(goal)}`;
+}
+function checkpointPayload(text) {
+    if (text === "checkpoint")
+        return "";
+    return text.startsWith("checkpoint ") ? text.slice("checkpoint ".length).trim() : null;
+}
+function unavailableWorkspaceCode(error) {
+    if (typeof error !== "object" || error === null || !("code" in error))
+        return undefined;
+    const code = error.code;
+    return code === "ENODEV" || code === "ESTALE" || code === "ENOTCONN" ? code : undefined;
+}
+function continuationSeam(goal, trustedDigests) {
+    const checkpoint = goal.checkpoint;
+    if (!checkpoint)
+        return "";
+    if (trustedDigests.has(checkpoint.digest)) {
+        return `\n\nSeam checkpoint (explicit user continuity context, not current-round proof):\n${formatDurableGoalCheckpoint(goal)}`;
+    }
+    return `\n\nAn untrusted workspace checkpoint exists at digest ${checkpoint.digest}; its prose was not loaded as user authority.`;
+}
+export default function goalController(omk) {
+    const trustedCheckpointDigests = new Set();
+    omk.registerCommand("goal", {
+        description: "Show, set, checkpoint, pause, resume, complete, or clear the durable session goal",
+        handler: async (args, ctx) => {
+            const store = new DurableGoalStore(goalPath(ctx.cwd));
+            const text = args.trim();
+            try {
+                if (text.length === 0) {
+                    const current = await store.current();
+                    ctx.ui.notify(current ? renderGoal(current) : "no durable goal", "info");
+                    return;
+                }
+                const existing = await store.current();
+                if (text === "pause" || text === "resume" || text === "complete" || text === "clear") {
+                    if (!existing)
+                        throw new DurableGoalError("store-missing", "durable goal does not exist");
+                    const next = await store.transition({ kind: text, ref: existing.ref }, new Date().toISOString());
+                    if (text === "clear")
+                        trustedCheckpointDigests.clear();
+                    ctx.ui.notify(renderGoal(next), "info");
+                    return;
+                }
+                const payload = checkpointPayload(text);
+                if (payload !== null) {
+                    if (!existing)
+                        throw new DurableGoalError("store-missing", "durable goal does not exist");
+                    if (payload.length === 0) {
+                        throw new DurableGoalError("invalid-input", 'usage: /goal checkpoint {"core":[],"verified":[],"open":[],"next":"..."}');
+                    }
+                    const now = new Date().toISOString();
+                    const next = await store.transition({
+                        kind: "record-checkpoint",
+                        ref: existing.ref,
+                        checkpoint: parseDurableGoalCheckpointCommand(payload, now),
+                    }, now);
+                    const checkpoint = next.checkpoint;
+                    if (!checkpoint)
+                        throw new DurableGoalError("invalid-store", "durable goal journal is invalid");
+                    omk.appendEntry("goal_checkpoint", {
+                        goalId: next.ref.id,
+                        goalRevision: next.ref.revision,
+                        checkpointDigest: checkpoint.digest,
+                    });
+                    trustedCheckpointDigests.add(checkpoint.digest);
+                    ctx.ui.notify(renderGoal(next), "info");
+                    return;
+                }
+                if (existing && existing.status !== "cleared" && existing.status !== "completed") {
+                    const next = await store.transition({ kind: "edit", ref: existing.ref, objective: text }, new Date().toISOString());
+                    ctx.ui.notify(renderGoal(next), "info");
+                    return;
+                }
+                if (existing)
+                    await rm(goalPath(ctx.cwd), { force: true });
+                const created = await store.create(createDurableGoal({ id: "session", objective: text, maxRounds: 8, now: new Date().toISOString() }));
+                ctx.ui.notify(renderGoal(created), "info");
+            }
+            catch (error) {
+                const message = error instanceof DurableGoalError ? error.message : "goal command failed";
+                ctx.ui.notify(message, "error");
+            }
+        },
+    });
+    omk.on("agent_end", async (_event, ctx) => {
+        const store = new DurableGoalStore(goalPath(ctx.cwd));
+        let current;
+        try {
+            current = await store.current();
+        }
+        catch (error) {
+            const code = unavailableWorkspaceCode(error);
+            if (!code)
+                throw error;
+            omk.appendEntry("goal_workspace_unavailable", { code });
+            return;
+        }
+        if (!current)
+            return;
+        const decision = decideGoalContinuation({
+            status: current.status,
+            completedRounds: current.completedRounds,
+            maxRounds: current.maxRounds,
+            hasQueuedMessages: ctx.hasPendingMessages(),
+        });
+        if (decision.reason === "queued" || !decision.continue)
+            return;
+        const advanced = await store.transition({ kind: "advance-round", ref: current.ref }, new Date().toISOString());
+        const seam = continuationSeam(advanced, trustedCheckpointDigests);
+        omk.sendUserMessage(`Continue the active goal (${advanced.completedRounds}/${advanced.maxRounds}): ${advanced.objective}${seam}`);
+    });
+}
+//# sourceMappingURL=goal-controller.js.map

package/dist/core/extensions/builtin/goal-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-controller.js","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/goal-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { rm } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { createDurableGoal, DurableGoalError, type DurableGoalSnapshot } from \"../../durable-goal.ts\";\nimport { formatDurableGoalCheckpoint, parseDurableGoalCheckpointCommand } from \"../../durable-goal-checkpoint.ts\";\nimport { DurableGoalStore } from \"../../durable-goal-store.ts\";\nimport { decideGoalContinuation } from \"../../goal-continuation.ts\";\nimport type { ExtensionAPI } from \"../types.ts\";\n\nfunction goalPath(cwd: string): string {\n\treturn join(cwd, \".omk\", \"goals\", \"current.json\");\n}\n\nfunction renderGoal(goal: DurableGoalSnapshot): string {\n\treturn `goal ${goal.ref.id} r${goal.ref.revision} ${goal.status} ${goal.completedRounds}/${goal.maxRounds}\\n${formatDurableGoalCheckpoint(goal)}`;\n}\n\nfunction checkpointPayload(text: string): string | null {\n\tif (text === \"checkpoint\") return \"\";\n\treturn text.startsWith(\"checkpoint \") ? text.slice(\"checkpoint \".length).trim() : null;\n}\n\nfunction unavailableWorkspaceCode(error: unknown): \"ENODEV\" | \"ESTALE\" | \"ENOTCONN\" | undefined {\n\tif (typeof error !== \"object\" || error === null || !(\"code\" in error)) return undefined;\n\tconst code = error.code;\n\treturn code === \"ENODEV\" || code === \"ESTALE\" || code === \"ENOTCONN\" ? code : undefined;\n}\n\nfunction continuationSeam(goal: DurableGoalSnapshot, trustedDigests: ReadonlySet<string>): string {\n\tconst checkpoint = goal.checkpoint;\n\tif (!checkpoint) return \"\";\n\tif (trustedDigests.has(checkpoint.digest)) {\n\t\treturn `\\n\\nSeam checkpoint (explicit user continuity context, not current-round proof):\\n${formatDurableGoalCheckpoint(goal)}`;\n\t}\n\treturn `\\n\\nAn untrusted workspace checkpoint exists at digest ${checkpoint.digest}; its prose was not loaded as user authority.`;\n}\n\nexport default function goalController(omk: ExtensionAPI): void {\n\tconst trustedCheckpointDigests = new Set<string>();\n\tomk.registerCommand(\"goal\", {\n\t\tdescription: \"Show, set, checkpoint, pause, resume, complete, or clear the durable session goal\",\n\t\thandler: async (args, ctx) => {\n\t\t\tconst store = new DurableGoalStore(goalPath(ctx.cwd));\n\t\t\tconst text = args.trim();\n\t\t\ttry {\n\t\t\t\tif (text.length === 0) {\n\t\t\t\t\tconst current = await store.current();\n\t\t\t\t\tctx.ui.notify(current ? renderGoal(current) : \"no durable goal\", \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst existing = await store.current();\n\t\t\t\tif (text === \"pause\" || text === \"resume\" || text === \"complete\" || text === \"clear\") {\n\t\t\t\t\tif (!existing) throw new DurableGoalError(\"store-missing\", \"durable goal does not exist\");\n\t\t\t\t\tconst next = await store.transition({ kind: text, ref: existing.ref }, new Date().toISOString());\n\t\t\t\t\tif (text === \"clear\") trustedCheckpointDigests.clear();\n\t\t\t\t\tctx.ui.notify(renderGoal(next), \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst payload = checkpointPayload(text);\n\t\t\t\tif (payload !== null) {\n\t\t\t\t\tif (!existing) throw new DurableGoalError(\"store-missing\", \"durable goal does not exist\");\n\t\t\t\t\tif (payload.length === 0) {\n\t\t\t\t\t\tthrow new DurableGoalError(\n\t\t\t\t\t\t\t\"invalid-input\",\n\t\t\t\t\t\t\t'usage: /goal checkpoint {\"core\":[],\"verified\":[],\"open\":[],\"next\":\"...\"}',\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tconst now = new Date().toISOString();\n\t\t\t\t\tconst next = await store.transition(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tkind: \"record-checkpoint\",\n\t\t\t\t\t\t\tref: existing.ref,\n\t\t\t\t\t\t\tcheckpoint: parseDurableGoalCheckpointCommand(payload, now),\n\t\t\t\t\t\t},\n\t\t\t\t\t\tnow,\n\t\t\t\t\t);\n\t\t\t\t\tconst checkpoint = next.checkpoint;\n\t\t\t\t\tif (!checkpoint) throw new DurableGoalError(\"invalid-store\", \"durable goal journal is invalid\");\n\t\t\t\t\tomk.appendEntry(\"goal_checkpoint\", {\n\t\t\t\t\t\tgoalId: next.ref.id,\n\t\t\t\t\t\tgoalRevision: next.ref.revision,\n\t\t\t\t\t\tcheckpointDigest: checkpoint.digest,\n\t\t\t\t\t});\n\t\t\t\t\ttrustedCheckpointDigests.add(checkpoint.digest);\n\t\t\t\t\tctx.ui.notify(renderGoal(next), \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (existing && existing.status !== \"cleared\" && existing.status !== \"completed\") {\n\t\t\t\t\tconst next = await store.transition(\n\t\t\t\t\t\t{ kind: \"edit\", ref: existing.ref, objective: text },\n\t\t\t\t\t\tnew Date().toISOString(),\n\t\t\t\t\t);\n\t\t\t\t\tctx.ui.notify(renderGoal(next), \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (existing) await rm(goalPath(ctx.cwd), { force: true });\n\t\t\t\tconst created = await store.create(\n\t\t\t\t\tcreateDurableGoal({ id: \"session\", objective: text, maxRounds: 8, now: new Date().toISOString() }),\n\t\t\t\t);\n\t\t\t\tctx.ui.notify(renderGoal(created), \"info\");\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof DurableGoalError ? error.message : \"goal command failed\";\n\t\t\t\tctx.ui.notify(message, \"error\");\n\t\t\t}\n\t\t},\n\t});\n\n\tomk.on(\"agent_end\", async (_event, ctx) => {\n\t\tconst store = new DurableGoalStore(goalPath(ctx.cwd));\n\t\tlet current: DurableGoalSnapshot | null;\n\t\ttry {\n\t\t\tcurrent = await store.current();\n\t\t} catch (error) {\n\t\t\tconst code = unavailableWorkspaceCode(error);\n\t\t\tif (!code) throw error;\n\t\t\tomk.appendEntry(\"goal_workspace_unavailable\", { code });\n\t\t\treturn;\n\t\t}\n\t\tif (!current) return;\n\t\tconst decision = decideGoalContinuation({\n\t\t\tstatus: current.status,\n\t\t\tcompletedRounds: current.completedRounds,\n\t\t\tmaxRounds: current.maxRounds,\n\t\t\thasQueuedMessages: ctx.hasPendingMessages(),\n\t\t});\n\t\tif (decision.reason === \"queued\" || !decision.continue) return;\n\t\tconst advanced = await store.transition({ kind: \"advance-round\", ref: current.ref }, new Date().toISOString());\n\t\tconst seam = continuationSeam(advanced, trustedCheckpointDigests);\n\t\tomk.sendUserMessage(\n\t\t\t`Continue the active goal (${advanced.completedRounds}/${advanced.maxRounds}): ${advanced.objective}${seam}`,\n\t\t);\n\t});\n}\n"]}

package/dist/core/extensions/builtin/identical-loop.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "../types.ts";
+export default function identicalLoop(omk: ExtensionAPI): void;
+//# sourceMappingURL=identical-loop.d.ts.map

package/dist/core/extensions/builtin/identical-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identical-loop.d.ts","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/identical-loop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CA2B7D","sourcesContent":["import { detectIdenticalLoop, type LoopRecord } from \"../../identical-loop.ts\";\nimport type { ExtensionAPI } from \"../types.ts\";\n\nexport default function identicalLoop(omk: ExtensionAPI): void {\n\tconst records: LoopRecord[] = [];\n\n\tomk.on(\"session_start\", () => {\n\t\trecords.length = 0;\n\t});\n\tomk.on(\"input\", (event) => {\n\t\tif (event.source !== \"extension\") records.length = 0;\n\t});\n\tomk.on(\"tool_call\", (event) => {\n\t\trecords.push({ toolName: event.toolName, args: event.input });\n\t\tconst detection = detectIdenticalLoop(records, { warnAfter: 3, stopAfter: 6 });\n\t\tif (!detection) return;\n\t\tif (detection.kind === \"stop\") {\n\t\t\treturn {\n\t\t\t\tblock: true,\n\t\t\t\treason: `identical loop: ${detection.toolName} repeated ${detection.count} times with the same args`,\n\t\t\t};\n\t\t}\n\t\tomk.sendMessage({\n\t\t\tcustomType: \"identical-loop\",\n\t\t\tcontent: `Same ${detection.toolName} call repeated ${detection.count} times. Change the args or stop.`,\n\t\t\tdisplay: true,\n\t\t\tdetails: detection,\n\t\t});\n\t\treturn undefined;\n\t});\n}\n"]}

package/dist/core/extensions/builtin/identical-loop.js

@@ -0,0 +1,31 @@
+import { detectIdenticalLoop } from "../../identical-loop.js";
+export default function identicalLoop(omk) {
+    const records = [];
+    omk.on("session_start", () => {
+        records.length = 0;
+    });
+    omk.on("input", (event) => {
+        if (event.source !== "extension")
+            records.length = 0;
+    });
+    omk.on("tool_call", (event) => {
+        records.push({ toolName: event.toolName, args: event.input });
+        const detection = detectIdenticalLoop(records, { warnAfter: 3, stopAfter: 6 });
+        if (!detection)
+            return;
+        if (detection.kind === "stop") {
+            return {
+                block: true,
+                reason: `identical loop: ${detection.toolName} repeated ${detection.count} times with the same args`,
+            };
+        }
+        omk.sendMessage({
+            customType: "identical-loop",
+            content: `Same ${detection.toolName} call repeated ${detection.count} times. Change the args or stop.`,
+            display: true,
+            details: detection,
+        });
+        return undefined;
+    });
+}
+//# sourceMappingURL=identical-loop.js.map

package/dist/core/extensions/builtin/identical-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identical-loop.js","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/identical-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAmB,MAAM,yBAAyB,CAAC;AAG/E,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,GAAiB,EAAQ;IAC9D,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,GAAG,CAAC,EAAE,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC;QAC7B,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAAA,CACnB,CAAC,CAAC;IACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAAA,CACrD,CAAC,CAAC;IACH,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO;gBACN,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,mBAAmB,SAAS,CAAC,QAAQ,aAAa,SAAS,CAAC,KAAK,2BAA2B;aACpG,CAAC;QACH,CAAC;QACD,GAAG,CAAC,WAAW,CAAC;YACf,UAAU,EAAE,gBAAgB;YAC5B,OAAO,EAAE,QAAQ,SAAS,CAAC,QAAQ,kBAAkB,SAAS,CAAC,KAAK,kCAAkC;YACtG,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,SAAS;SAClB,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IAAA,CACjB,CAAC,CAAC;AAAA,CACH","sourcesContent":["import { detectIdenticalLoop, type LoopRecord } from \"../../identical-loop.ts\";\nimport type { ExtensionAPI } from \"../types.ts\";\n\nexport default function identicalLoop(omk: ExtensionAPI): void {\n\tconst records: LoopRecord[] = [];\n\n\tomk.on(\"session_start\", () => {\n\t\trecords.length = 0;\n\t});\n\tomk.on(\"input\", (event) => {\n\t\tif (event.source !== \"extension\") records.length = 0;\n\t});\n\tomk.on(\"tool_call\", (event) => {\n\t\trecords.push({ toolName: event.toolName, args: event.input });\n\t\tconst detection = detectIdenticalLoop(records, { warnAfter: 3, stopAfter: 6 });\n\t\tif (!detection) return;\n\t\tif (detection.kind === \"stop\") {\n\t\t\treturn {\n\t\t\t\tblock: true,\n\t\t\t\treason: `identical loop: ${detection.toolName} repeated ${detection.count} times with the same args`,\n\t\t\t};\n\t\t}\n\t\tomk.sendMessage({\n\t\t\tcustomType: \"identical-loop\",\n\t\t\tcontent: `Same ${detection.toolName} call repeated ${detection.count} times. Change the args or stop.`,\n\t\t\tdisplay: true,\n\t\t\tdetails: detection,\n\t\t});\n\t\treturn undefined;\n\t});\n}\n"]}

package/dist/core/extensions/builtin/prompt-preset.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "../types.ts";
+export default function promptPreset(omk: ExtensionAPI): void;
+//# sourceMappingURL=prompt-preset.d.ts.map

package/dist/core/extensions/builtin/prompt-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-preset.d.ts","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/prompt-preset.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAS5D","sourcesContent":["import { resolvePromptPreset } from \"../../prompt-preset.ts\";\nimport type { ExtensionAPI } from \"../types.ts\";\n\nexport default function promptPreset(omk: ExtensionAPI): void {\n\tomk.on(\"before_agent_start\", (_event, ctx) => {\n\t\tconst model = ctx.model;\n\t\tconst preset = resolvePromptPreset(model ? `${model.provider}/${model.id}` : undefined);\n\t\tif (!preset) return undefined;\n\t\treturn {\n\t\t\tsystemPrompt: `${_event.systemPrompt}\\n\\n<model_preset id=\"${preset.id}\">\\n${preset.guidelines.map((line) => `- ${line}`).join(\"\\n\")}\\n</model_preset>`,\n\t\t};\n\t});\n}\n"]}

package/dist/core/extensions/builtin/prompt-preset.js

@@ -0,0 +1,13 @@
+import { resolvePromptPreset } from "../../prompt-preset.js";
+export default function promptPreset(omk) {
+    omk.on("before_agent_start", (_event, ctx) => {
+        const model = ctx.model;
+        const preset = resolvePromptPreset(model ? `${model.provider}/${model.id}` : undefined);
+        if (!preset)
+            return undefined;
+        return {
+            systemPrompt: `${_event.systemPrompt}\n\n<model_preset id="${preset.id}">\n${preset.guidelines.map((line) => `- ${line}`).join("\n")}\n</model_preset>`,
+        };
+    });
+}
+//# sourceMappingURL=prompt-preset.js.map

package/dist/core/extensions/builtin/prompt-preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-preset.js","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/prompt-preset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,GAAiB,EAAQ;IAC7D,GAAG,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACxB,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACxF,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,OAAO;YACN,YAAY,EAAE,GAAG,MAAM,CAAC,YAAY,yBAAyB,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB;SACvJ,CAAC;IAAA,CACF,CAAC,CAAC;AAAA,CACH","sourcesContent":["import { resolvePromptPreset } from \"../../prompt-preset.ts\";\nimport type { ExtensionAPI } from \"../types.ts\";\n\nexport default function promptPreset(omk: ExtensionAPI): void {\n\tomk.on(\"before_agent_start\", (_event, ctx) => {\n\t\tconst model = ctx.model;\n\t\tconst preset = resolvePromptPreset(model ? `${model.provider}/${model.id}` : undefined);\n\t\tif (!preset) return undefined;\n\t\treturn {\n\t\t\tsystemPrompt: `${_event.systemPrompt}\\n\\n<model_preset id=\"${preset.id}\">\\n${preset.guidelines.map((line) => `- ${line}`).join(\"\\n\")}\\n</model_preset>`,\n\t\t};\n\t});\n}\n"]}

package/dist/core/extensions/builtin/tool-pair-repair.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "../types.ts";
+export default function toolPairRepair(omk: ExtensionAPI): void;
+//# sourceMappingURL=tool-pair-repair.d.ts.map

package/dist/core/extensions/builtin/tool-pair-repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pair-repair.d.ts","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/tool-pair-repair.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoC,YAAY,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAS9D","sourcesContent":["import { applyToolPairRepair } from \"../../tool-pair-repair.ts\";\nimport type { ContextEvent, ContextEventResult, ExtensionAPI } from \"../types.ts\";\n\nexport default function toolPairRepair(omk: ExtensionAPI): void {\n\tomk.on(\"context\", (event: ContextEvent): ContextEventResult | undefined => {\n\t\tconst repaired = applyToolPairRepair(event.messages);\n\t\tconst unchanged =\n\t\t\trepaired.length === event.messages.length &&\n\t\t\trepaired.every((message, index) => message === event.messages[index]);\n\t\tif (unchanged) return undefined;\n\t\treturn { messages: repaired };\n\t});\n}\n"]}

package/dist/core/extensions/builtin/tool-pair-repair.js

@@ -0,0 +1,12 @@
+import { applyToolPairRepair } from "../../tool-pair-repair.js";
+export default function toolPairRepair(omk) {
+    omk.on("context", (event) => {
+        const repaired = applyToolPairRepair(event.messages);
+        const unchanged = repaired.length === event.messages.length &&
+            repaired.every((message, index) => message === event.messages[index]);
+        if (unchanged)
+            return undefined;
+        return { messages: repaired };
+    });
+}
+//# sourceMappingURL=tool-pair-repair.js.map