@code-yeongyu/senpi 2026.9.4 → 2026.9.5

package/dist/core/extensions/builtin/loop/store.js

@@ -1,60 +1,79 @@
 /**
  * Atomic, versioned, per-session sidecar store for `/loop` state.
  *
- * Mirrors the goal store's persistence discipline (temp file + rename, per-file mutation
- * serialization, strict versioned parsing) because scheduler state must never be half
- * written or silently reset: a corrupt file arms nothing and surfaces a typed error so
- * the extension can end affected loops with `error` instead of guessing.
+ * Persistence (temp file + rename, per-file mutation serialization, envelope
+ * version/session checks) lives in the shared session sidecar primitive. This
+ * module supplies the loop domain parser and keeps the historical exported
+ * surface so callers continue to catch {@link InvalidLoopStoreError} /
+ * {@link UnsupportedLoopStoreVersionError} by name.
  *
  * Session custom entries are deliberately NOT the authoritative store: they are branch
  * nodes, so a globally scanned "latest" entry can come from an abandoned branch, while
  * loop schedules are session-scoped.
  */
-import { randomUUID } from "node:crypto";
-import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
+import { createSidecarStore, encodedSessionId as encodeSidecarSessionId, InvalidSidecarStoreError, sidecarFilePath, UnsupportedSidecarStoreVersionError, } from "../../../session-sidecar-store.js";
 import { EFFECTIVE_INTERVAL_UNITS, isRecord, LOOP_END_REASONS, LOOP_PHASES, LOOP_SENTINELS, LOOP_STATE_VERSION, LOOP_WAKE_SOURCE_KINDS, REQUESTED_INTERVAL_UNITS, } from "./types.js";
-export class InvalidLoopStoreError extends Error {
+export class InvalidLoopStoreError extends InvalidSidecarStoreError {
     constructor(message, options) {
         super(message, options);
         this.name = "InvalidLoopStoreError";
     }
 }
-export class UnsupportedLoopStoreVersionError extends Error {
+export class UnsupportedLoopStoreVersionError extends UnsupportedSidecarStoreVersionError {
     constructor(message) {
         super(message);
         this.name = "UnsupportedLoopStoreVersionError";
     }
 }
-const mutationTails = new Map();
-const snapshots = new Map();
+const stores = new Map();
 export function encodedSessionId(ref) {
-    return encodeURIComponent(ref.sessionId);
+    return encodeSidecarSessionId(ref.sessionId);
 }
 export function loopStateFilePath(ref) {
-    return join(ref.baseDir, `${encodedSessionId(ref)}.json`);
+    return sidecarFilePath(ref);
 }
 export function emptyLoopState(sessionId) {
     return { version: LOOP_STATE_VERSION, sessionId, entries: {}, activeDynamicId: null, updatedAt: 0 };
 }
+function storeFor(ref) {
+    const filePath = loopStateFilePath(ref);
+    const existing = stores.get(filePath);
+    if (existing !== undefined)
+        return existing;
+    const store = createSidecarStore({
+        baseDir: ref.baseDir,
+        sessionId: ref.sessionId,
+        version: LOOP_STATE_VERSION,
+        tempPrefix: "loop",
+        parse: parseLoopPayload,
+    });
+    stores.set(filePath, store);
+    return store;
+}
+function remapLoopStoreError(error) {
+    if (error instanceof InvalidLoopStoreError || error instanceof UnsupportedLoopStoreVersionError) {
+        throw error;
+    }
+    if (error instanceof UnsupportedSidecarStoreVersionError) {
+        throw new UnsupportedLoopStoreVersionError(error.message.replaceAll("sidecar store", "loop store"));
+    }
+    if (error instanceof InvalidSidecarStoreError) {
+        throw new InvalidLoopStoreError(error.message.replaceAll("sidecar store", "loop store"), { cause: error });
+    }
+    throw error;
+}
 /**
  * Reads persisted state, or null when this session has never persisted any loop.
  * Throws {@link InvalidLoopStoreError} / {@link UnsupportedLoopStoreVersionError} on
  * unusable state so callers fail closed rather than resetting a user's schedule.
  */
 export async function readLoopState(ref) {
-    let raw;
     try {
-        raw = await readFile(loopStateFilePath(ref), "utf8");
+        return await storeFor(ref).read();
     }
     catch (error) {
-        if (isFileSystemError(error, "ENOENT"))
-            return null;
-        throw error;
+        remapLoopStoreError(error);
     }
-    const state = parseLoopState(raw, ref);
-    snapshots.set(loopStateFilePath(ref), state);
-    return state;
 }
 /** Like {@link readLoopState}, but returns an empty state when nothing is persisted. */
 export async function loadLoopState(ref) {
@@ -65,88 +84,38 @@ export async function loadLoopState(ref) {
  * (status line, tick attribution). Undefined until the store has been touched.
  */
 export function snapshotLoopState(ref) {
-    return snapshots.get(loopStateFilePath(ref));
+    return storeFor(ref).snapshot();
 }
 /**
  * Serializes read-modify-write cycles through a per-file promise tail so command,
  * timer, tool, and lifecycle writes cannot interleave and lose an update.
  */
 export function mutateLoopState(ref, mutation) {
-    return enqueue(ref, async () => {
-        const current = await loadLoopState(ref);
-        const next = await mutation(current);
-        await writeLoopState(ref, next);
-        return next;
-    });
+    return storeFor(ref)
+        .mutate((current) => mutation(current ?? emptyLoopState(ref.sessionId)))
+        .catch((error) => remapLoopStoreError(error));
 }
 /** Persists a complete state atomically. Prefer {@link mutateLoopState} for updates. */
 export async function writeLoopState(ref, state) {
-    const filePath = loopStateFilePath(ref);
-    await mkdir(dirname(filePath), { recursive: true });
-    await writeAtomic(filePath, `${JSON.stringify(state, null, 2)}\n`);
-    snapshots.set(filePath, state);
+    await storeFor(ref).write(state);
 }
 /** Drops cached snapshots; used when a session ends or tests reset global state. */
 export function clearLoopStateSnapshot(ref) {
-    snapshots.delete(loopStateFilePath(ref));
-}
-function enqueue(ref, operation) {
-    const key = loopStateFilePath(ref);
-    const previous = mutationTails.get(key) ?? Promise.resolve();
-    const run = previous.then(operation);
-    const tail = run.then(() => undefined, () => undefined);
-    mutationTails.set(key, tail);
-    void tail.then(() => {
-        if (mutationTails.get(key) === tail)
-            mutationTails.delete(key);
-    });
-    return run;
+    storeFor(ref).clear();
 }
-async function writeAtomic(filePath, contents) {
-    const tempPath = join(dirname(filePath), `.loop-${randomUUID()}.tmp`);
-    try {
-        await writeFile(tempPath, contents, { encoding: "utf8", mode: 0o600 });
-        await rename(tempPath, filePath);
-    }
-    catch (error) {
-        try {
-            await rm(tempPath, { force: true });
-        }
-        catch (cleanupError) {
-            throw new AggregateError([error, cleanupError], "loop store write failed and its temporary file could not be removed");
-        }
-        throw error;
-    }
-}
-function parseLoopState(raw, ref) {
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch (error) {
-        throw new InvalidLoopStoreError("loop store contains unparseable JSON", { cause: error });
-    }
-    if (!isRecord(parsed))
+function parseLoopPayload(raw, ref) {
+    if (!isRecord(raw))
         throw new InvalidLoopStoreError("loop store must be a JSON object");
-    if (parsed.version !== LOOP_STATE_VERSION) {
-        throw new UnsupportedLoopStoreVersionError(`unsupported loop store version: ${JSON.stringify(parsed.version)} (expected ${LOOP_STATE_VERSION})`);
-    }
-    if (typeof parsed.sessionId !== "string" || parsed.sessionId.length === 0) {
-        throw new InvalidLoopStoreError("loop store is missing a sessionId");
-    }
-    if (parsed.sessionId !== ref.sessionId) {
-        throw new InvalidLoopStoreError(`loop store sessionId ${parsed.sessionId} does not match the session it was loaded for`);
-    }
-    if (!isEpochMs(parsed.updatedAt))
+    if (!isEpochMs(raw.updatedAt))
         throw new InvalidLoopStoreError("loop store has an invalid updatedAt");
-    if (!isRecord(parsed.entries))
+    if (!isRecord(raw.entries))
         throw new InvalidLoopStoreError("loop store entries must be an object");
     const entries = {};
-    for (const [id, value] of Object.entries(parsed.entries)) {
+    for (const [id, value] of Object.entries(raw.entries)) {
         const entry = parseEntry(id, value);
         entries[id] = entry;
     }
-    const activeDynamicId = parsed.activeDynamicId;
+    const activeDynamicId = raw.activeDynamicId;
     if (activeDynamicId !== null) {
         if (typeof activeDynamicId !== "string") {
             throw new InvalidLoopStoreError("loop store activeDynamicId must be a string or null");
@@ -158,10 +127,10 @@ function parseLoopState(raw, ref) {
     }
     return {
         version: LOOP_STATE_VERSION,
-        sessionId: parsed.sessionId,
+        sessionId: ref.sessionId,
         entries,
         activeDynamicId,
-        updatedAt: parsed.updatedAt,
+        updatedAt: raw.updatedAt,
     };
 }
 function parseEntry(id, value) {
@@ -418,7 +387,4 @@ function isRequestedIntervalUnit(value) {
 function isEffectiveIntervalUnit(value) {
     return EFFECTIVE_INTERVAL_UNITS.includes(value);
 }
-function isFileSystemError(error, code) {
-    return error instanceof Error && "code" in error && error.code === code;
-}
 //# sourceMappingURL=store.js.map

package/dist/core/extensions/builtin/loop/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Atomic, versioned, per-session sidecar store for `/loop` state.\n *\n * Mirrors the goal store's persistence discipline (temp file + rename, per-file mutation\n * serialization, strict versioned parsing) because scheduler state must never be half\n * written or silently reset: a corrupt file arms nothing and surfaces a typed error so\n * the extension can end affected loops with `error` instead of guessing.\n *\n * Session custom entries are deliberately NOT the authoritative store: they are branch\n * nodes, so a globally scanned \"latest\" entry can come from an abandoned branch, while\n * loop schedules are session-scoped.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { mkdir, readFile, rename, rm, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport {\n\ttype CronEntry,\n\ttype DynamicCronEntry,\n\tEFFECTIVE_INTERVAL_UNITS,\n\ttype EffectiveInterval,\n\ttype EffectiveIntervalUnit,\n\ttype EpochMs,\n\ttype FixedCronEntry,\n\tisRecord,\n\tLOOP_END_REASONS,\n\tLOOP_PHASES,\n\tLOOP_SENTINELS,\n\tLOOP_STATE_VERSION,\n\tLOOP_WAKE_SOURCE_KINDS,\n\ttype LoopEndReason,\n\ttype LoopEntryFields,\n\ttype LoopFileFingerprint,\n\ttype LoopLifecycle,\n\ttype LoopPayload,\n\ttype LoopPhase,\n\ttype LoopSentinel,\n\ttype LoopState,\n\ttype LoopStoreRef,\n\ttype LoopWakeSource,\n\ttype LoopWakeSourceKind,\n\ttype PendingWakeup,\n\tREQUESTED_INTERVAL_UNITS,\n\ttype RequestedInterval,\n\ttype RequestedIntervalUnit,\n\ttype SentinelDeliveryState,\n} from \"./types.ts\";\n\nexport class InvalidLoopStoreError extends Error {\n\tconstructor(message: string, options?: { cause?: unknown }) {\n\t\tsuper(message, options);\n\t\tthis.name = \"InvalidLoopStoreError\";\n\t}\n}\n\nexport class UnsupportedLoopStoreVersionError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"UnsupportedLoopStoreVersionError\";\n\t}\n}\n\n/** Mutation callback. May be async; its result becomes the next persisted state. */\nexport type LoopStateMutation = (current: LoopState) => LoopState | Promise<LoopState>;\n\nconst mutationTails = new Map<string, Promise<void>>();\nconst snapshots = new Map<string, LoopState>();\n\nexport function encodedSessionId(ref: LoopStoreRef): string {\n\treturn encodeURIComponent(ref.sessionId);\n}\n\nexport function loopStateFilePath(ref: LoopStoreRef): string {\n\treturn join(ref.baseDir, `${encodedSessionId(ref)}.json`);\n}\n\nexport function emptyLoopState(sessionId: string): LoopState {\n\treturn { version: LOOP_STATE_VERSION, sessionId, entries: {}, activeDynamicId: null, updatedAt: 0 };\n}\n\n/**\n * Reads persisted state, or null when this session has never persisted any loop.\n * Throws {@link InvalidLoopStoreError} / {@link UnsupportedLoopStoreVersionError} on\n * unusable state so callers fail closed rather than resetting a user's schedule.\n */\nexport async function readLoopState(ref: LoopStoreRef): Promise<LoopState | null> {\n\tlet raw: string;\n\ttry {\n\t\traw = await readFile(loopStateFilePath(ref), \"utf8\");\n\t} catch (error) {\n\t\tif (isFileSystemError(error, \"ENOENT\")) return null;\n\t\tthrow error;\n\t}\n\tconst state = parseLoopState(raw, ref);\n\tsnapshots.set(loopStateFilePath(ref), state);\n\treturn state;\n}\n\n/** Like {@link readLoopState}, but returns an empty state when nothing is persisted. */\nexport async function loadLoopState(ref: LoopStoreRef): Promise<LoopState> {\n\treturn (await readLoopState(ref)) ?? emptyLoopState(ref.sessionId);\n}\n\n/**\n * Last successfully loaded or written state for this ref, for synchronous consumers\n * (status line, tick attribution). Undefined until the store has been touched.\n */\nexport function snapshotLoopState(ref: LoopStoreRef): LoopState | undefined {\n\treturn snapshots.get(loopStateFilePath(ref));\n}\n\n/**\n * Serializes read-modify-write cycles through a per-file promise tail so command,\n * timer, tool, and lifecycle writes cannot interleave and lose an update.\n */\nexport function mutateLoopState(ref: LoopStoreRef, mutation: LoopStateMutation): Promise<LoopState> {\n\treturn enqueue(ref, async () => {\n\t\tconst current = await loadLoopState(ref);\n\t\tconst next = await mutation(current);\n\t\tawait writeLoopState(ref, next);\n\t\treturn next;\n\t});\n}\n\n/** Persists a complete state atomically. Prefer {@link mutateLoopState} for updates. */\nexport async function writeLoopState(ref: LoopStoreRef, state: LoopState): Promise<void> {\n\tconst filePath = loopStateFilePath(ref);\n\tawait mkdir(dirname(filePath), { recursive: true });\n\tawait writeAtomic(filePath, `${JSON.stringify(state, null, 2)}\\n`);\n\tsnapshots.set(filePath, state);\n}\n\n/** Drops cached snapshots; used when a session ends or tests reset global state. */\nexport function clearLoopStateSnapshot(ref: LoopStoreRef): void {\n\tsnapshots.delete(loopStateFilePath(ref));\n}\n\nfunction enqueue<T>(ref: LoopStoreRef, operation: () => Promise<T>): Promise<T> {\n\tconst key = loopStateFilePath(ref);\n\tconst previous = mutationTails.get(key) ?? Promise.resolve();\n\tconst run = previous.then(operation);\n\tconst tail = run.then(\n\t\t() => undefined,\n\t\t() => undefined,\n\t);\n\tmutationTails.set(key, tail);\n\tvoid tail.then(() => {\n\t\tif (mutationTails.get(key) === tail) mutationTails.delete(key);\n\t});\n\treturn run;\n}\n\nasync function writeAtomic(filePath: string, contents: string): Promise<void> {\n\tconst tempPath = join(dirname(filePath), `.loop-${randomUUID()}.tmp`);\n\ttry {\n\t\tawait writeFile(tempPath, contents, { encoding: \"utf8\", mode: 0o600 });\n\t\tawait rename(tempPath, filePath);\n\t} catch (error) {\n\t\ttry {\n\t\t\tawait rm(tempPath, { force: true });\n\t\t} catch (cleanupError) {\n\t\t\tthrow new AggregateError(\n\t\t\t\t[error, cleanupError],\n\t\t\t\t\"loop store write failed and its temporary file could not be removed\",\n\t\t\t);\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nfunction parseLoopState(raw: string, ref: LoopStoreRef): LoopState {\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(raw);\n\t} catch (error) {\n\t\tthrow new InvalidLoopStoreError(\"loop store contains unparseable JSON\", { cause: error });\n\t}\n\tif (!isRecord(parsed)) throw new InvalidLoopStoreError(\"loop store must be a JSON object\");\n\tif (parsed.version !== LOOP_STATE_VERSION) {\n\t\tthrow new UnsupportedLoopStoreVersionError(\n\t\t\t`unsupported loop store version: ${JSON.stringify(parsed.version)} (expected ${LOOP_STATE_VERSION})`,\n\t\t);\n\t}\n\tif (typeof parsed.sessionId !== \"string\" || parsed.sessionId.length === 0) {\n\t\tthrow new InvalidLoopStoreError(\"loop store is missing a sessionId\");\n\t}\n\tif (parsed.sessionId !== ref.sessionId) {\n\t\tthrow new InvalidLoopStoreError(\n\t\t\t`loop store sessionId ${parsed.sessionId} does not match the session it was loaded for`,\n\t\t);\n\t}\n\tif (!isEpochMs(parsed.updatedAt)) throw new InvalidLoopStoreError(\"loop store has an invalid updatedAt\");\n\tif (!isRecord(parsed.entries)) throw new InvalidLoopStoreError(\"loop store entries must be an object\");\n\n\tconst entries: Record<string, CronEntry> = {};\n\tfor (const [id, value] of Object.entries(parsed.entries)) {\n\t\tconst entry = parseEntry(id, value);\n\t\tentries[id] = entry;\n\t}\n\n\tconst activeDynamicId = parsed.activeDynamicId;\n\tif (activeDynamicId !== null) {\n\t\tif (typeof activeDynamicId !== \"string\") {\n\t\t\tthrow new InvalidLoopStoreError(\"loop store activeDynamicId must be a string or null\");\n\t\t}\n\t\tconst active = entries[activeDynamicId];\n\t\tif (active === undefined || active.kind !== \"dynamic\") {\n\t\t\tthrow new InvalidLoopStoreError(`loop store activeDynamicId ${activeDynamicId} does not name a dynamic loop`);\n\t\t}\n\t}\n\n\treturn {\n\t\tversion: LOOP_STATE_VERSION,\n\t\tsessionId: parsed.sessionId,\n\t\tentries,\n\t\tactiveDynamicId,\n\t\tupdatedAt: parsed.updatedAt,\n\t};\n}\n\nfunction parseEntry(id: string, value: unknown): CronEntry {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} is not an object`);\n\tif (value.id !== id) throw new InvalidLoopStoreError(`loop entry ${id} carries a mismatched id`);\n\tconst kind = value.kind;\n\tif (kind !== \"fixed\" && kind !== \"dynamic\") throw new InvalidLoopStoreError(`loop entry ${id} has an unknown kind`);\n\n\tconst base = parseEntryFields(id, value);\n\tif (kind === \"fixed\") {\n\t\tconst fixed: FixedCronEntry = {\n\t\t\t...base,\n\t\t\tkind: \"fixed\",\n\t\t\trequestedInterval: parseRequestedInterval(id, value.requestedInterval),\n\t\t\teffectiveInterval: parseEffectiveInterval(id, value.effectiveInterval),\n\t\t\tcronExpression: requireString(id, \"cronExpression\", value.cronExpression),\n\t\t\tnextFireAt: requireEpochMs(id, \"nextFireAt\", value.nextFireAt),\n\t\t\tintervalMs: requirePositiveInteger(id, \"intervalMs\", value.intervalMs),\n\t\t};\n\t\treturn fixed;\n\t}\n\n\tconst keepaliveCredit = value.keepaliveCredit;\n\tif (keepaliveCredit !== 0 && keepaliveCredit !== 1) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid keepaliveCredit`);\n\t}\n\tconst dynamic: DynamicCronEntry = {\n\t\t...base,\n\t\tkind: \"dynamic\",\n\t\tpendingWakeup: parsePendingWakeup(id, value.pendingWakeup),\n\t\tkeepaliveCredit,\n\t};\n\treturn dynamic;\n}\n\nfunction parseEntryFields(id: string, value: Record<string, unknown>): LoopEntryFields & LoopLifecycle {\n\tconst fields = {\n\t\tid,\n\t\toriginalArgs: requireString(id, \"originalArgs\", value.originalArgs, { allowEmpty: true }),\n\t\treentryPrompt: requireString(id, \"reentryPrompt\", value.reentryPrompt),\n\t\tpayload: parsePayload(id, value.payload),\n\t\tcreatedAt: requireEpochMs(id, \"createdAt\", value.createdAt),\n\t\tlastFiredAt: parseNullableEpochMs(id, \"lastFiredAt\", value.lastFiredAt),\n\t\texpiresAt: requireEpochMs(id, \"expiresAt\", value.expiresAt),\n\t\tlastScheduledForAt: parseNullableEpochMs(id, \"lastScheduledForAt\", value.lastScheduledForAt),\n\t\tcoalescedFirePending: requireBoolean(id, \"coalescedFirePending\", value.coalescedFirePending),\n\t\tqueuedForAt: parseNullableEpochMs(id, \"queuedForAt\", value.queuedForAt),\n\t\tnoopStreak: requireNonNegativeInteger(id, \"noopStreak\", value.noopStreak),\n\t\ttickCount: requireNonNegativeInteger(id, \"tickCount\", value.tickCount),\n\t\tsentinelDelivery: parseSentinelDelivery(id, value.sentinelDelivery),\n\t\twakeSources: parseWakeSources(id, value.wakeSources),\n\t};\n\treturn { ...fields, ...parseLifecycle(id, value) };\n}\n\ntype ParsedLifecycle =\n\t| { phase: Exclude<LoopPhase, \"ended\"> }\n\t| { phase: \"ended\"; endedAt: EpochMs; endReason: LoopEndReason; endDetail?: string };\n\nfunction parseLifecycle(id: string, value: Record<string, unknown>): ParsedLifecycle {\n\tconst phase = value.phase;\n\tif (typeof phase !== \"string\" || !isLoopPhase(phase)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid phase`);\n\t}\n\tif (phase !== \"ended\") {\n\t\tif (value.endedAt !== undefined || value.endReason !== undefined || value.endDetail !== undefined) {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} carries terminal fields while not ended`);\n\t\t}\n\t\treturn { phase };\n\t}\n\tconst endReason = value.endReason;\n\tif (typeof endReason !== \"string\" || !isLoopEndReason(endReason)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid endReason`);\n\t}\n\tconst endDetail = value.endDetail;\n\tif (endDetail !== undefined && typeof endDetail !== \"string\") {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid endDetail`);\n\t}\n\treturn {\n\t\tphase: \"ended\",\n\t\tendedAt: requireEpochMs(id, \"endedAt\", value.endedAt),\n\t\tendReason,\n\t\t...(endDetail === undefined ? {} : { endDetail }),\n\t};\n}\n\nfunction parsePayload(id: string, value: unknown): LoopPayload {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid payload`);\n\tif (value.type === \"prompt\") {\n\t\treturn { type: \"prompt\", prompt: requireString(id, \"payload.prompt\", value.prompt) };\n\t}\n\tif (value.type === \"sentinel\") {\n\t\tconst sentinel = value.sentinel;\n\t\tif (typeof sentinel !== \"string\" || !isLoopSentinel(sentinel)) {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an unknown payload sentinel`);\n\t\t}\n\t\treturn { type: \"sentinel\", sentinel };\n\t}\n\tthrow new InvalidLoopStoreError(`loop entry ${id} has an unknown payload type`);\n}\n\nfunction parseSentinelDelivery(id: string, value: unknown): SentinelDeliveryState {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid sentinelDelivery`);\n\treturn {\n\t\tautonomousPreambleDelivered: requireBoolean(\n\t\t\tid,\n\t\t\t\"sentinelDelivery.autonomousPreambleDelivered\",\n\t\t\tvalue.autonomousPreambleDelivered,\n\t\t),\n\t\tlastLoopFileDelivered: parseFingerprint(id, value.lastLoopFileDelivered),\n\t\tforceFullDelivery: requireBoolean(id, \"sentinelDelivery.forceFullDelivery\", value.forceFullDelivery),\n\t};\n}\n\nfunction parseFingerprint(id: string, value: unknown): LoopFileFingerprint | null {\n\tif (value === null) return null;\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid loop-file fingerprint`);\n\treturn {\n\t\tpath: requireString(id, \"fingerprint.path\", value.path),\n\t\tmtimeMs: requireFiniteNumber(id, \"fingerprint.mtimeMs\", value.mtimeMs),\n\t\tsize: requireNonNegativeInteger(id, \"fingerprint.size\", value.size),\n\t\tcontentHash: requireString(id, \"fingerprint.contentHash\", value.contentHash),\n\t\tanchorDeliveryId: requireString(id, \"fingerprint.anchorDeliveryId\", value.anchorDeliveryId),\n\t};\n}\n\nfunction parseWakeSources(id: string, value: unknown): readonly LoopWakeSource[] {\n\tif (!Array.isArray(value)) throw new InvalidLoopStoreError(`loop entry ${id} has invalid wakeSources`);\n\treturn value.map((candidate): LoopWakeSource => {\n\t\tif (!isRecord(candidate)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid wake source`);\n\t\tconst source = candidate.source;\n\t\tif (typeof source !== \"string\" || !isWakeSourceKind(source)) {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an unknown wake source kind`);\n\t\t}\n\t\tconst description = candidate.description;\n\t\tif (description !== undefined && typeof description !== \"string\") {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid wake source description`);\n\t\t}\n\t\treturn {\n\t\t\tsource,\n\t\t\tid: requireString(id, \"wakeSource.id\", candidate.id),\n\t\t\tcreatedAt: requireEpochMs(id, \"wakeSource.createdAt\", candidate.createdAt),\n\t\t\t...(description === undefined ? {} : { description }),\n\t\t};\n\t});\n}\n\nfunction parsePendingWakeup(id: string, value: unknown): PendingWakeup | null {\n\tif (value === null || value === undefined) return null;\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup`);\n\tconst source = value.source;\n\tif (source !== \"model\" && source !== \"keepalive\") {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup source`);\n\t}\n\tif (value.kind !== \"dynamic\") throw new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup kind`);\n\treturn {\n\t\tid: requireString(id, \"pendingWakeup.id\", value.id),\n\t\tloopId: requireString(id, \"pendingWakeup.loopId\", value.loopId),\n\t\tkind: \"dynamic\",\n\t\tsource,\n\t\trequestedDelaySeconds: requireFiniteNumber(\n\t\t\tid,\n\t\t\t\"pendingWakeup.requestedDelaySeconds\",\n\t\t\tvalue.requestedDelaySeconds,\n\t\t),\n\t\tdelaySeconds: requirePositiveInteger(id, \"pendingWakeup.delaySeconds\", value.delaySeconds),\n\t\tdueAt: requireEpochMs(id, \"pendingWakeup.dueAt\", value.dueAt),\n\t\treason: requireString(id, \"pendingWakeup.reason\", value.reason),\n\t\tprompt: requireString(id, \"pendingWakeup.prompt\", value.prompt),\n\t\tnoop: requireBoolean(id, \"pendingWakeup.noop\", value.noop),\n\t\tcreatedAt: requireEpochMs(id, \"pendingWakeup.createdAt\", value.createdAt),\n\t};\n}\n\nfunction parseRequestedInterval(id: string, value: unknown): RequestedInterval {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid requestedInterval`);\n\tconst unit = value.unit;\n\tif (typeof unit !== \"string\" || !isRequestedIntervalUnit(unit)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid requestedInterval unit`);\n\t}\n\treturn {\n\t\tvalue: requirePositiveInteger(id, \"requestedInterval.value\", value.value),\n\t\tunit,\n\t\traw: requireString(id, \"requestedInterval.raw\", value.raw),\n\t};\n}\n\nfunction parseEffectiveInterval(id: string, value: unknown): EffectiveInterval {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval`);\n\tconst unit = value.unit;\n\tif (typeof unit !== \"string\" || !isEffectiveIntervalUnit(unit)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval unit`);\n\t}\n\tconst roundingNotice = value.roundingNotice;\n\tif (roundingNotice !== undefined && typeof roundingNotice !== \"string\") {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval roundingNotice`);\n\t}\n\treturn {\n\t\tvalue: requirePositiveInteger(id, \"effectiveInterval.value\", value.value),\n\t\tunit,\n\t\thuman: requireString(id, \"effectiveInterval.human\", value.human),\n\t\trounded: requireBoolean(id, \"effectiveInterval.rounded\", value.rounded),\n\t\t...(roundingNotice === undefined ? {} : { roundingNotice }),\n\t};\n}\n\nfunction requireString(id: string, field: string, value: unknown, options?: { allowEmpty?: boolean }): string {\n\tif (typeof value !== \"string\" || (options?.allowEmpty !== true && value.length === 0)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value;\n}\n\nfunction requireBoolean(id: string, field: string, value: unknown): boolean {\n\tif (typeof value !== \"boolean\") throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\treturn value;\n}\n\nfunction requireFiniteNumber(id: string, field: string, value: unknown): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value;\n}\n\nfunction requireNonNegativeInteger(id: string, field: string, value: unknown): number {\n\tif (!Number.isSafeInteger(value) || (value as number) < 0) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value as number;\n}\n\nfunction requirePositiveInteger(id: string, field: string, value: unknown): number {\n\tif (!Number.isSafeInteger(value) || (value as number) <= 0) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value as number;\n}\n\nfunction requireEpochMs(id: string, field: string, value: unknown): EpochMs {\n\tif (!isEpochMs(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\treturn value;\n}\n\nfunction parseNullableEpochMs(id: string, field: string, value: unknown): EpochMs | null {\n\tif (value === null || value === undefined) return null;\n\treturn requireEpochMs(id, field, value);\n}\n\nfunction isEpochMs(value: unknown): value is EpochMs {\n\treturn Number.isSafeInteger(value) && (value as number) >= 0;\n}\n\nfunction isLoopPhase(value: string): value is LoopPhase {\n\treturn (LOOP_PHASES as readonly string[]).includes(value);\n}\n\nfunction isLoopEndReason(value: string): value is LoopEndReason {\n\treturn (LOOP_END_REASONS as readonly string[]).includes(value);\n}\n\nfunction isLoopSentinel(value: string): value is LoopSentinel {\n\treturn (LOOP_SENTINELS as readonly string[]).includes(value);\n}\n\nfunction isWakeSourceKind(value: string): value is LoopWakeSourceKind {\n\treturn (LOOP_WAKE_SOURCE_KINDS as readonly string[]).includes(value);\n}\n\nfunction isRequestedIntervalUnit(value: string): value is RequestedIntervalUnit {\n\treturn (REQUESTED_INTERVAL_UNITS as readonly string[]).includes(value);\n}\n\nfunction isEffectiveIntervalUnit(value: string): value is EffectiveIntervalUnit {\n\treturn (EFFECTIVE_INTERVAL_UNITS as readonly string[]).includes(value);\n}\n\nfunction isFileSystemError(error: unknown, code: string): boolean {\n\treturn error instanceof Error && \"code\" in error && error.code === code;\n}\n"]}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Atomic, versioned, per-session sidecar store for `/loop` state.\n *\n * Persistence (temp file + rename, per-file mutation serialization, envelope\n * version/session checks) lives in the shared session sidecar primitive. This\n * module supplies the loop domain parser and keeps the historical exported\n * surface so callers continue to catch {@link InvalidLoopStoreError} /\n * {@link UnsupportedLoopStoreVersionError} by name.\n *\n * Session custom entries are deliberately NOT the authoritative store: they are branch\n * nodes, so a globally scanned \"latest\" entry can come from an abandoned branch, while\n * loop schedules are session-scoped.\n */\n\nimport {\n\tcreateSidecarStore,\n\tencodedSessionId as encodeSidecarSessionId,\n\tInvalidSidecarStoreError,\n\ttype SidecarStore,\n\ttype SidecarStoreRef,\n\tsidecarFilePath,\n\tUnsupportedSidecarStoreVersionError,\n} from \"../../../session-sidecar-store.ts\";\nimport {\n\ttype CronEntry,\n\ttype DynamicCronEntry,\n\tEFFECTIVE_INTERVAL_UNITS,\n\ttype EffectiveInterval,\n\ttype EffectiveIntervalUnit,\n\ttype EpochMs,\n\ttype FixedCronEntry,\n\tisRecord,\n\tLOOP_END_REASONS,\n\tLOOP_PHASES,\n\tLOOP_SENTINELS,\n\tLOOP_STATE_VERSION,\n\tLOOP_WAKE_SOURCE_KINDS,\n\ttype LoopEndReason,\n\ttype LoopEntryFields,\n\ttype LoopFileFingerprint,\n\ttype LoopLifecycle,\n\ttype LoopPayload,\n\ttype LoopPhase,\n\ttype LoopSentinel,\n\ttype LoopState,\n\ttype LoopStoreRef,\n\ttype LoopWakeSource,\n\ttype LoopWakeSourceKind,\n\ttype PendingWakeup,\n\tREQUESTED_INTERVAL_UNITS,\n\ttype RequestedInterval,\n\ttype RequestedIntervalUnit,\n\ttype SentinelDeliveryState,\n} from \"./types.ts\";\n\nexport class InvalidLoopStoreError extends InvalidSidecarStoreError {\n\tconstructor(message: string, options?: { cause?: unknown }) {\n\t\tsuper(message, options);\n\t\tthis.name = \"InvalidLoopStoreError\";\n\t}\n}\n\nexport class UnsupportedLoopStoreVersionError extends UnsupportedSidecarStoreVersionError {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"UnsupportedLoopStoreVersionError\";\n\t}\n}\n\n/** Mutation callback. May be async; its result becomes the next persisted state. */\nexport type LoopStateMutation = (current: LoopState) => LoopState | Promise<LoopState>;\n\nconst stores = new Map<string, SidecarStore<LoopState>>();\n\nexport function encodedSessionId(ref: LoopStoreRef): string {\n\treturn encodeSidecarSessionId(ref.sessionId);\n}\n\nexport function loopStateFilePath(ref: LoopStoreRef): string {\n\treturn sidecarFilePath(ref);\n}\n\nexport function emptyLoopState(sessionId: string): LoopState {\n\treturn { version: LOOP_STATE_VERSION, sessionId, entries: {}, activeDynamicId: null, updatedAt: 0 };\n}\n\nfunction storeFor(ref: LoopStoreRef): SidecarStore<LoopState> {\n\tconst filePath = loopStateFilePath(ref);\n\tconst existing = stores.get(filePath);\n\tif (existing !== undefined) return existing;\n\tconst store = createSidecarStore<LoopState>({\n\t\tbaseDir: ref.baseDir,\n\t\tsessionId: ref.sessionId,\n\t\tversion: LOOP_STATE_VERSION,\n\t\ttempPrefix: \"loop\",\n\t\tparse: parseLoopPayload,\n\t});\n\tstores.set(filePath, store);\n\treturn store;\n}\n\nfunction remapLoopStoreError(error: unknown): never {\n\tif (error instanceof InvalidLoopStoreError || error instanceof UnsupportedLoopStoreVersionError) {\n\t\tthrow error;\n\t}\n\tif (error instanceof UnsupportedSidecarStoreVersionError) {\n\t\tthrow new UnsupportedLoopStoreVersionError(error.message.replaceAll(\"sidecar store\", \"loop store\"));\n\t}\n\tif (error instanceof InvalidSidecarStoreError) {\n\t\tthrow new InvalidLoopStoreError(error.message.replaceAll(\"sidecar store\", \"loop store\"), { cause: error });\n\t}\n\tthrow error;\n}\n\n/**\n * Reads persisted state, or null when this session has never persisted any loop.\n * Throws {@link InvalidLoopStoreError} / {@link UnsupportedLoopStoreVersionError} on\n * unusable state so callers fail closed rather than resetting a user's schedule.\n */\nexport async function readLoopState(ref: LoopStoreRef): Promise<LoopState | null> {\n\ttry {\n\t\treturn await storeFor(ref).read();\n\t} catch (error) {\n\t\tremapLoopStoreError(error);\n\t}\n}\n\n/** Like {@link readLoopState}, but returns an empty state when nothing is persisted. */\nexport async function loadLoopState(ref: LoopStoreRef): Promise<LoopState> {\n\treturn (await readLoopState(ref)) ?? emptyLoopState(ref.sessionId);\n}\n\n/**\n * Last successfully loaded or written state for this ref, for synchronous consumers\n * (status line, tick attribution). Undefined until the store has been touched.\n */\nexport function snapshotLoopState(ref: LoopStoreRef): LoopState | undefined {\n\treturn storeFor(ref).snapshot();\n}\n\n/**\n * Serializes read-modify-write cycles through a per-file promise tail so command,\n * timer, tool, and lifecycle writes cannot interleave and lose an update.\n */\nexport function mutateLoopState(ref: LoopStoreRef, mutation: LoopStateMutation): Promise<LoopState> {\n\treturn storeFor(ref)\n\t\t.mutate((current) => mutation(current ?? emptyLoopState(ref.sessionId)))\n\t\t.catch((error: unknown) => remapLoopStoreError(error));\n}\n\n/** Persists a complete state atomically. Prefer {@link mutateLoopState} for updates. */\nexport async function writeLoopState(ref: LoopStoreRef, state: LoopState): Promise<void> {\n\tawait storeFor(ref).write(state);\n}\n\n/** Drops cached snapshots; used when a session ends or tests reset global state. */\nexport function clearLoopStateSnapshot(ref: LoopStoreRef): void {\n\tstoreFor(ref).clear();\n}\n\nfunction parseLoopPayload(raw: unknown, ref: SidecarStoreRef): LoopState {\n\tif (!isRecord(raw)) throw new InvalidLoopStoreError(\"loop store must be a JSON object\");\n\tif (!isEpochMs(raw.updatedAt)) throw new InvalidLoopStoreError(\"loop store has an invalid updatedAt\");\n\tif (!isRecord(raw.entries)) throw new InvalidLoopStoreError(\"loop store entries must be an object\");\n\n\tconst entries: Record<string, CronEntry> = {};\n\tfor (const [id, value] of Object.entries(raw.entries)) {\n\t\tconst entry = parseEntry(id, value);\n\t\tentries[id] = entry;\n\t}\n\n\tconst activeDynamicId = raw.activeDynamicId;\n\tif (activeDynamicId !== null) {\n\t\tif (typeof activeDynamicId !== \"string\") {\n\t\t\tthrow new InvalidLoopStoreError(\"loop store activeDynamicId must be a string or null\");\n\t\t}\n\t\tconst active = entries[activeDynamicId];\n\t\tif (active === undefined || active.kind !== \"dynamic\") {\n\t\t\tthrow new InvalidLoopStoreError(`loop store activeDynamicId ${activeDynamicId} does not name a dynamic loop`);\n\t\t}\n\t}\n\n\treturn {\n\t\tversion: LOOP_STATE_VERSION,\n\t\tsessionId: ref.sessionId,\n\t\tentries,\n\t\tactiveDynamicId,\n\t\tupdatedAt: raw.updatedAt,\n\t};\n}\n\nfunction parseEntry(id: string, value: unknown): CronEntry {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} is not an object`);\n\tif (value.id !== id) throw new InvalidLoopStoreError(`loop entry ${id} carries a mismatched id`);\n\tconst kind = value.kind;\n\tif (kind !== \"fixed\" && kind !== \"dynamic\") throw new InvalidLoopStoreError(`loop entry ${id} has an unknown kind`);\n\n\tconst base = parseEntryFields(id, value);\n\tif (kind === \"fixed\") {\n\t\tconst fixed: FixedCronEntry = {\n\t\t\t...base,\n\t\t\tkind: \"fixed\",\n\t\t\trequestedInterval: parseRequestedInterval(id, value.requestedInterval),\n\t\t\teffectiveInterval: parseEffectiveInterval(id, value.effectiveInterval),\n\t\t\tcronExpression: requireString(id, \"cronExpression\", value.cronExpression),\n\t\t\tnextFireAt: requireEpochMs(id, \"nextFireAt\", value.nextFireAt),\n\t\t\tintervalMs: requirePositiveInteger(id, \"intervalMs\", value.intervalMs),\n\t\t};\n\t\treturn fixed;\n\t}\n\n\tconst keepaliveCredit = value.keepaliveCredit;\n\tif (keepaliveCredit !== 0 && keepaliveCredit !== 1) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid keepaliveCredit`);\n\t}\n\tconst dynamic: DynamicCronEntry = {\n\t\t...base,\n\t\tkind: \"dynamic\",\n\t\tpendingWakeup: parsePendingWakeup(id, value.pendingWakeup),\n\t\tkeepaliveCredit,\n\t};\n\treturn dynamic;\n}\n\nfunction parseEntryFields(id: string, value: Record<string, unknown>): LoopEntryFields & LoopLifecycle {\n\tconst fields = {\n\t\tid,\n\t\toriginalArgs: requireString(id, \"originalArgs\", value.originalArgs, { allowEmpty: true }),\n\t\treentryPrompt: requireString(id, \"reentryPrompt\", value.reentryPrompt),\n\t\tpayload: parsePayload(id, value.payload),\n\t\tcreatedAt: requireEpochMs(id, \"createdAt\", value.createdAt),\n\t\tlastFiredAt: parseNullableEpochMs(id, \"lastFiredAt\", value.lastFiredAt),\n\t\texpiresAt: requireEpochMs(id, \"expiresAt\", value.expiresAt),\n\t\tlastScheduledForAt: parseNullableEpochMs(id, \"lastScheduledForAt\", value.lastScheduledForAt),\n\t\tcoalescedFirePending: requireBoolean(id, \"coalescedFirePending\", value.coalescedFirePending),\n\t\tqueuedForAt: parseNullableEpochMs(id, \"queuedForAt\", value.queuedForAt),\n\t\tnoopStreak: requireNonNegativeInteger(id, \"noopStreak\", value.noopStreak),\n\t\ttickCount: requireNonNegativeInteger(id, \"tickCount\", value.tickCount),\n\t\tsentinelDelivery: parseSentinelDelivery(id, value.sentinelDelivery),\n\t\twakeSources: parseWakeSources(id, value.wakeSources),\n\t};\n\treturn { ...fields, ...parseLifecycle(id, value) };\n}\n\ntype ParsedLifecycle =\n\t| { phase: Exclude<LoopPhase, \"ended\"> }\n\t| { phase: \"ended\"; endedAt: EpochMs; endReason: LoopEndReason; endDetail?: string };\n\nfunction parseLifecycle(id: string, value: Record<string, unknown>): ParsedLifecycle {\n\tconst phase = value.phase;\n\tif (typeof phase !== \"string\" || !isLoopPhase(phase)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid phase`);\n\t}\n\tif (phase !== \"ended\") {\n\t\tif (value.endedAt !== undefined || value.endReason !== undefined || value.endDetail !== undefined) {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} carries terminal fields while not ended`);\n\t\t}\n\t\treturn { phase };\n\t}\n\tconst endReason = value.endReason;\n\tif (typeof endReason !== \"string\" || !isLoopEndReason(endReason)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid endReason`);\n\t}\n\tconst endDetail = value.endDetail;\n\tif (endDetail !== undefined && typeof endDetail !== \"string\") {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid endDetail`);\n\t}\n\treturn {\n\t\tphase: \"ended\",\n\t\tendedAt: requireEpochMs(id, \"endedAt\", value.endedAt),\n\t\tendReason,\n\t\t...(endDetail === undefined ? {} : { endDetail }),\n\t};\n}\n\nfunction parsePayload(id: string, value: unknown): LoopPayload {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid payload`);\n\tif (value.type === \"prompt\") {\n\t\treturn { type: \"prompt\", prompt: requireString(id, \"payload.prompt\", value.prompt) };\n\t}\n\tif (value.type === \"sentinel\") {\n\t\tconst sentinel = value.sentinel;\n\t\tif (typeof sentinel !== \"string\" || !isLoopSentinel(sentinel)) {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an unknown payload sentinel`);\n\t\t}\n\t\treturn { type: \"sentinel\", sentinel };\n\t}\n\tthrow new InvalidLoopStoreError(`loop entry ${id} has an unknown payload type`);\n}\n\nfunction parseSentinelDelivery(id: string, value: unknown): SentinelDeliveryState {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid sentinelDelivery`);\n\treturn {\n\t\tautonomousPreambleDelivered: requireBoolean(\n\t\t\tid,\n\t\t\t\"sentinelDelivery.autonomousPreambleDelivered\",\n\t\t\tvalue.autonomousPreambleDelivered,\n\t\t),\n\t\tlastLoopFileDelivered: parseFingerprint(id, value.lastLoopFileDelivered),\n\t\tforceFullDelivery: requireBoolean(id, \"sentinelDelivery.forceFullDelivery\", value.forceFullDelivery),\n\t};\n}\n\nfunction parseFingerprint(id: string, value: unknown): LoopFileFingerprint | null {\n\tif (value === null) return null;\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid loop-file fingerprint`);\n\treturn {\n\t\tpath: requireString(id, \"fingerprint.path\", value.path),\n\t\tmtimeMs: requireFiniteNumber(id, \"fingerprint.mtimeMs\", value.mtimeMs),\n\t\tsize: requireNonNegativeInteger(id, \"fingerprint.size\", value.size),\n\t\tcontentHash: requireString(id, \"fingerprint.contentHash\", value.contentHash),\n\t\tanchorDeliveryId: requireString(id, \"fingerprint.anchorDeliveryId\", value.anchorDeliveryId),\n\t};\n}\n\nfunction parseWakeSources(id: string, value: unknown): readonly LoopWakeSource[] {\n\tif (!Array.isArray(value)) throw new InvalidLoopStoreError(`loop entry ${id} has invalid wakeSources`);\n\treturn value.map((candidate): LoopWakeSource => {\n\t\tif (!isRecord(candidate)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid wake source`);\n\t\tconst source = candidate.source;\n\t\tif (typeof source !== \"string\" || !isWakeSourceKind(source)) {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an unknown wake source kind`);\n\t\t}\n\t\tconst description = candidate.description;\n\t\tif (description !== undefined && typeof description !== \"string\") {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid wake source description`);\n\t\t}\n\t\treturn {\n\t\t\tsource,\n\t\t\tid: requireString(id, \"wakeSource.id\", candidate.id),\n\t\t\tcreatedAt: requireEpochMs(id, \"wakeSource.createdAt\", candidate.createdAt),\n\t\t\t...(description === undefined ? {} : { description }),\n\t\t};\n\t});\n}\n\nfunction parsePendingWakeup(id: string, value: unknown): PendingWakeup | null {\n\tif (value === null || value === undefined) return null;\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup`);\n\tconst source = value.source;\n\tif (source !== \"model\" && source !== \"keepalive\") {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup source`);\n\t}\n\tif (value.kind !== \"dynamic\") throw new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup kind`);\n\treturn {\n\t\tid: requireString(id, \"pendingWakeup.id\", value.id),\n\t\tloopId: requireString(id, \"pendingWakeup.loopId\", value.loopId),\n\t\tkind: \"dynamic\",\n\t\tsource,\n\t\trequestedDelaySeconds: requireFiniteNumber(\n\t\t\tid,\n\t\t\t\"pendingWakeup.requestedDelaySeconds\",\n\t\t\tvalue.requestedDelaySeconds,\n\t\t),\n\t\tdelaySeconds: requirePositiveInteger(id, \"pendingWakeup.delaySeconds\", value.delaySeconds),\n\t\tdueAt: requireEpochMs(id, \"pendingWakeup.dueAt\", value.dueAt),\n\t\treason: requireString(id, \"pendingWakeup.reason\", value.reason),\n\t\tprompt: requireString(id, \"pendingWakeup.prompt\", value.prompt),\n\t\tnoop: requireBoolean(id, \"pendingWakeup.noop\", value.noop),\n\t\tcreatedAt: requireEpochMs(id, \"pendingWakeup.createdAt\", value.createdAt),\n\t};\n}\n\nfunction parseRequestedInterval(id: string, value: unknown): RequestedInterval {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid requestedInterval`);\n\tconst unit = value.unit;\n\tif (typeof unit !== \"string\" || !isRequestedIntervalUnit(unit)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid requestedInterval unit`);\n\t}\n\treturn {\n\t\tvalue: requirePositiveInteger(id, \"requestedInterval.value\", value.value),\n\t\tunit,\n\t\traw: requireString(id, \"requestedInterval.raw\", value.raw),\n\t};\n}\n\nfunction parseEffectiveInterval(id: string, value: unknown): EffectiveInterval {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval`);\n\tconst unit = value.unit;\n\tif (typeof unit !== \"string\" || !isEffectiveIntervalUnit(unit)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval unit`);\n\t}\n\tconst roundingNotice = value.roundingNotice;\n\tif (roundingNotice !== undefined && typeof roundingNotice !== \"string\") {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval roundingNotice`);\n\t}\n\treturn {\n\t\tvalue: requirePositiveInteger(id, \"effectiveInterval.value\", value.value),\n\t\tunit,\n\t\thuman: requireString(id, \"effectiveInterval.human\", value.human),\n\t\trounded: requireBoolean(id, \"effectiveInterval.rounded\", value.rounded),\n\t\t...(roundingNotice === undefined ? {} : { roundingNotice }),\n\t};\n}\n\nfunction requireString(id: string, field: string, value: unknown, options?: { allowEmpty?: boolean }): string {\n\tif (typeof value !== \"string\" || (options?.allowEmpty !== true && value.length === 0)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value;\n}\n\nfunction requireBoolean(id: string, field: string, value: unknown): boolean {\n\tif (typeof value !== \"boolean\") throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\treturn value;\n}\n\nfunction requireFiniteNumber(id: string, field: string, value: unknown): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value;\n}\n\nfunction requireNonNegativeInteger(id: string, field: string, value: unknown): number {\n\tif (!Number.isSafeInteger(value) || (value as number) < 0) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value as number;\n}\n\nfunction requirePositiveInteger(id: string, field: string, value: unknown): number {\n\tif (!Number.isSafeInteger(value) || (value as number) <= 0) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value as number;\n}\n\nfunction requireEpochMs(id: string, field: string, value: unknown): EpochMs {\n\tif (!isEpochMs(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\treturn value;\n}\n\nfunction parseNullableEpochMs(id: string, field: string, value: unknown): EpochMs | null {\n\tif (value === null || value === undefined) return null;\n\treturn requireEpochMs(id, field, value);\n}\n\nfunction isEpochMs(value: unknown): value is EpochMs {\n\treturn Number.isSafeInteger(value) && (value as number) >= 0;\n}\n\nfunction isLoopPhase(value: string): value is LoopPhase {\n\treturn (LOOP_PHASES as readonly string[]).includes(value);\n}\n\nfunction isLoopEndReason(value: string): value is LoopEndReason {\n\treturn (LOOP_END_REASONS as readonly string[]).includes(value);\n}\n\nfunction isLoopSentinel(value: string): value is LoopSentinel {\n\treturn (LOOP_SENTINELS as readonly string[]).includes(value);\n}\n\nfunction isWakeSourceKind(value: string): value is LoopWakeSourceKind {\n\treturn (LOOP_WAKE_SOURCE_KINDS as readonly string[]).includes(value);\n}\n\nfunction isRequestedIntervalUnit(value: string): value is RequestedIntervalUnit {\n\treturn (REQUESTED_INTERVAL_UNITS as readonly string[]).includes(value);\n}\n\nfunction isEffectiveIntervalUnit(value: string): value is EffectiveIntervalUnit {\n\treturn (EFFECTIVE_INTERVAL_UNITS as readonly string[]).includes(value);\n}\n"]}

package/dist/core/extensions/builtin/loop/tools.d.ts

@@ -2,6 +2,11 @@
  * The `schedule_wakeup` model tool: the ONLY model-callable surface of the `/loop`
  * extension. It lets a dynamic (self-paced) loop pick its own next delay, or end itself.
  *
+ * Exposure: the tool is registered `exposure: "search"` with lazy activation disabled, so it is
+ * absent from the resident tool list (and from `tool_search`) until the loop extension activates it
+ * for a live dynamic loop and retires it when that loop ends. Outside a dynamic loop every call is
+ * an error, so a resident registration only cost prompt tokens.
+ *
  * Two deliberate shape decisions:
  * - The TypeBox schema is a FLAT object with no root union. Several provider payload
  *   conversions rebuild tool schemas from top-level `properties` only, so a root
@@ -22,7 +27,7 @@ export declare const SCHEDULE_WAKEUP_TOOL = "schedule_wakeup";
 /** Inclusive bounds the executor clamps `delaySeconds` into. */
 export declare const MIN_WAKEUP_DELAY_SECONDS = 60;
 export declare const MAX_WAKEUP_DELAY_SECONDS = 3600;
-export declare const SCHEDULE_WAKEUP_DESCRIPTION = "Schedule when to resume work in /loop dynamic mode. Always pass the `prompt` argument unless stopping. Call this as the last action before ending a dynamic loop iteration so the loop remains alive; call with `stop: true` to end the active dynamic loop immediately.\n\n`delaySeconds` is clamped to 60-3600 seconds. For idle polling, normally use 1200-1800 seconds. Avoid choosing 300 seconds merely to poll: short polling repeatedly loses prompt-cache value on many API paths. When work is gated on observable terminal state, use `monitor` instead of sleeping or polling; inspect it with `bash_output` and stop the watcher with `kill_bash`. For delegated work, use the available `task` output and control tools and let task completion notifications wake the session. When a monitor or task notification is the primary wake source, the scheduled delay is only a fallback heartbeat.\n\nFor normal dynamic re-entry, set `prompt` to the complete original command, for example `/loop check the deploy`, preserving the user's text verbatim. Set `noop: true` only when this iteration found no actionable change; consecutive noop iterations are folded in the terminal view. Omit `noop` when stopping. Notify the user only when state changes in a way worth acting on, not once per tick.";
+export declare const SCHEDULE_WAKEUP_DESCRIPTION = "Schedule when to resume work in /loop dynamic mode. Always pass the `prompt` argument unless stopping. Call this as the last action before ending a dynamic loop iteration so the loop remains alive; call with `stop: true` to end the active dynamic loop immediately.\n\n`delaySeconds` is clamped to 60-3600 seconds; 1200-1800 is the normal idle range, and a short delay chosen merely to poll loses prompt-cache value on many API paths. When a monitor or task notification is the primary wake source, the scheduled delay is only a fallback heartbeat.\n\nFor normal dynamic re-entry, set `prompt` to the complete original command, for example `/loop check the deploy`, preserving the user's text verbatim. Set `noop: true` only when this iteration found no actionable change; consecutive noop iterations are folded in the terminal view. Omit `noop` when stopping. Notify the user only when state changes in a way worth acting on, not once per tick.";
 export declare const scheduleWakeupSchema: Type.TObject<{
     delaySeconds: Type.TOptional<Type.TInteger>;
     reason: Type.TString;

package/dist/core/extensions/builtin/loop/tools.d.ts.map

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

package/dist/core/extensions/builtin/loop/tools.js

@@ -2,6 +2,11 @@
  * The `schedule_wakeup` model tool: the ONLY model-callable surface of the `/loop`
  * extension. It lets a dynamic (self-paced) loop pick its own next delay, or end itself.
  *
+ * Exposure: the tool is registered `exposure: "search"` with lazy activation disabled, so it is
+ * absent from the resident tool list (and from `tool_search`) until the loop extension activates it
+ * for a live dynamic loop and retires it when that loop ends. Outside a dynamic loop every call is
+ * an error, so a resident registration only cost prompt tokens.
+ *
  * Two deliberate shape decisions:
  * - The TypeBox schema is a FLAT object with no root union. Several provider payload
  *   conversions rebuild tool schemas from top-level `properties` only, so a root
@@ -22,7 +27,7 @@ export const MIN_WAKEUP_DELAY_SECONDS = 60;
 export const MAX_WAKEUP_DELAY_SECONDS = 3600;
 export const SCHEDULE_WAKEUP_DESCRIPTION = `Schedule when to resume work in /loop dynamic mode. Always pass the \`prompt\` argument unless stopping. Call this as the last action before ending a dynamic loop iteration so the loop remains alive; call with \`stop: true\` to end the active dynamic loop immediately.
 
-\`delaySeconds\` is clamped to ${MIN_WAKEUP_DELAY_SECONDS}-${MAX_WAKEUP_DELAY_SECONDS} seconds. For idle polling, normally use 1200-1800 seconds. Avoid choosing 300 seconds merely to poll: short polling repeatedly loses prompt-cache value on many API paths. When work is gated on observable terminal state, use \`monitor\` instead of sleeping or polling; inspect it with \`bash_output\` and stop the watcher with \`kill_bash\`. For delegated work, use the available \`task\` output and control tools and let task completion notifications wake the session. When a monitor or task notification is the primary wake source, the scheduled delay is only a fallback heartbeat.
+\`delaySeconds\` is clamped to ${MIN_WAKEUP_DELAY_SECONDS}-${MAX_WAKEUP_DELAY_SECONDS} seconds; 1200-1800 is the normal idle range, and a short delay chosen merely to poll loses prompt-cache value on many API paths. When a monitor or task notification is the primary wake source, the scheduled delay is only a fallback heartbeat.
 
 For normal dynamic re-entry, set \`prompt\` to the complete original command, for example \`/loop check the deploy\`, preserving the user's text verbatim. Set \`noop: true\` only when this iteration found no actionable change; consecutive noop iterations are folded in the terminal view. Omit \`noop\` when stopping. Notify the user only when state changes in a way worth acting on, not once per tick.`;
 export const scheduleWakeupSchema = Type.Object({
@@ -145,6 +150,8 @@ export function registerLoopTools(pi, deps) {
         label: "Schedule Wakeup",
         description: SCHEDULE_WAKEUP_DESCRIPTION,
         parameters: scheduleWakeupSchema,
+        exposure: "search",
+        allowLazyActivation: false,
         // Sequential so two concurrent model tool calls cannot race scheduler state.
         executionMode: "sequential",
         async execute(_toolCallId, params) {

package/dist/core/extensions/builtin/loop/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The `schedule_wakeup` model tool: the ONLY model-callable surface of the `/loop`\n * extension. It lets a dynamic (self-paced) loop pick its own next delay, or end itself.\n *\n * Two deliberate shape decisions:\n * - The TypeBox schema is a FLAT object with no root union. Several provider payload\n *   conversions rebuild tool schemas from top-level `properties` only, so a root\n *   `anyOf` would reach the model as an empty schema (same reasoning as\n *   `terminal/tools/monitor.ts`). Branch requirements are enforced in `execute`.\n * - `delaySeconds` carries NO schema `minimum`/`maximum`. The contract clamps\n *   out-of-range integers instead of rejecting them, and schema bounds would make the\n *   clamp unreachable.\n *\n * Scheduler state is never mutated here: every effect goes through the injected\n * `ScheduleWakeupSchedulerPort`.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ExtensionAPI } from \"../../types.ts\";\nimport type { EpochMs, LoopId, WakeupId } from \"./types.ts\";\n\n/** Model-visible tool name. */\nexport const SCHEDULE_WAKEUP_TOOL = \"schedule_wakeup\";\n\n/** Inclusive bounds the executor clamps `delaySeconds` into. */\nexport const MIN_WAKEUP_DELAY_SECONDS = 60;\nexport const MAX_WAKEUP_DELAY_SECONDS = 3600;\n\nexport const SCHEDULE_WAKEUP_DESCRIPTION = `Schedule when to resume work in /loop dynamic mode. Always pass the \\`prompt\\` argument unless stopping. Call this as the last action before ending a dynamic loop iteration so the loop remains alive; call with \\`stop: true\\` to end the active dynamic loop immediately.\n\n\\`delaySeconds\\` is clamped to ${MIN_WAKEUP_DELAY_SECONDS}-${MAX_WAKEUP_DELAY_SECONDS} seconds. For idle polling, normally use 1200-1800 seconds. Avoid choosing 300 seconds merely to poll: short polling repeatedly loses prompt-cache value on many API paths. When work is gated on observable terminal state, use \\`monitor\\` instead of sleeping or polling; inspect it with \\`bash_output\\` and stop the watcher with \\`kill_bash\\`. For delegated work, use the available \\`task\\` output and control tools and let task completion notifications wake the session. When a monitor or task notification is the primary wake source, the scheduled delay is only a fallback heartbeat.\n\nFor normal dynamic re-entry, set \\`prompt\\` to the complete original command, for example \\`/loop check the deploy\\`, preserving the user's text verbatim. Set \\`noop: true\\` only when this iteration found no actionable change; consecutive noop iterations are folded in the terminal view. Omit \\`noop\\` when stopping. Notify the user only when state changes in a way worth acting on, not once per tick.`;\n\nexport const scheduleWakeupSchema = Type.Object(\n\t{\n\t\tdelaySeconds: Type.Optional(\n\t\t\tType.Integer({\n\t\t\t\tdescription: `Dynamic loop delay in seconds. Values are clamped to ${MIN_WAKEUP_DELAY_SECONDS}-${MAX_WAKEUP_DELAY_SECONDS}.`,\n\t\t\t}),\n\t\t),\n\t\treason: Type.String({\n\t\t\tminLength: 1,\n\t\t\tdescription: \"Why this wakeup or stop is appropriate. Must not be blank.\",\n\t\t}),\n\t\tprompt: Type.Optional(\n\t\t\tType.String({\n\t\t\t\tdescription:\n\t\t\t\t\t\"Prompt to dispatch when the wakeup fires. Required unless stop is true; preserve the original /loop command verbatim for normal dynamic re-entry.\",\n\t\t\t}),\n\t\t),\n\t\tstop: Type.Optional(\n\t\t\tType.Boolean({\n\t\t\t\tdescription: \"End the active dynamic loop immediately instead of scheduling another wakeup.\",\n\t\t\t}),\n\t\t),\n\t\tnoop: Type.Optional(\n\t\t\tType.Boolean({\n\t\t\t\tdescription:\n\t\t\t\t\t\"True when this iteration observed no actionable change. Consecutive noop iterations are folded in the terminal view. Omit when stopping.\",\n\t\t\t}),\n\t\t),\n\t},\n\t{ additionalProperties: false },\n);\n\n/** Runtime-validated parameter shape; the schema itself stays flat and permissive. */\nexport interface ScheduleWakeupParams {\n\treadonly delaySeconds?: number;\n\treadonly reason: string;\n\treadonly prompt?: string;\n\treadonly stop?: boolean;\n\treadonly noop?: boolean;\n}\n\nexport interface ScheduleWakeupScheduledDetails {\n\treadonly ok: true;\n\treadonly action: \"scheduled\";\n\treadonly loopId: LoopId;\n\treadonly wakeupId: WakeupId;\n\treadonly replacedWakeupId?: WakeupId;\n\n\t/** Integer the model asked for, before the clamp. */\n\treadonly requestedDelaySeconds: number;\n\t/** Effective delay after clamping to `[60, 3600]`. */\n\treadonly delaySeconds: number;\n\treadonly clamped: boolean;\n\treadonly dueAt: EpochMs;\n\n\treadonly reason: string;\n\t/** Preserved verbatim after the non-blank check. */\n\treadonly prompt: string;\n\treadonly noop: boolean;\n\treadonly noopStreak: number;\n}\n\nexport interface ScheduleWakeupStoppedDetails {\n\treadonly ok: true;\n\treadonly action: \"stopped\";\n\treadonly loopId: LoopId;\n\treadonly terminalReason: \"stopped\";\n\treadonly reason: string;\n\treadonly endedAt: EpochMs;\n\t/** Fields accepted for model compatibility but not applied. */\n\treadonly ignoredFields: readonly ScheduleWakeupIgnorableField[];\n}\n\nexport type ScheduleWakeupIgnorableField = \"delaySeconds\" | \"prompt\";\n\nexport type ScheduleWakeupDetails = ScheduleWakeupScheduledDetails | ScheduleWakeupStoppedDetails;\n\n/**\n * Which loop, if any, this tool call belongs to. `null` means no loop context at all;\n * a `fixed` target means the call came from a fixed tick, whose schedule re-arms itself.\n */\nexport type ScheduleWakeupTarget = { readonly kind: \"dynamic\" | \"fixed\"; readonly loopId: LoopId } | null;\n\nexport interface ScheduleWakeupRequest {\n\treadonly loopId: LoopId;\n\treadonly requestedDelaySeconds: number;\n\treadonly delaySeconds: number;\n\treadonly reason: string;\n\treadonly prompt: string;\n\treadonly noop: boolean;\n}\n\nexport interface ScheduleWakeupOutcome {\n\treadonly wakeupId: WakeupId;\n\t/** Set when this schedule replaced a still-pending wakeup for the same loop. */\n\treadonly replacedWakeupId?: WakeupId;\n\treadonly dueAt: EpochMs;\n\treadonly noopStreak: number;\n}\n\nexport interface StopDynamicLoopRequest {\n\treadonly loopId: LoopId;\n\treadonly reason: string;\n}\n\nexport interface StopDynamicLoopOutcome {\n\treadonly endedAt: EpochMs;\n}\n\n/**\n * Minimal scheduler surface this tool needs. Declared locally so the tool module stays\n * independent of the scheduler implementation and testable with a fake.\n */\nexport interface ScheduleWakeupSchedulerPort {\n\t/** Loop the current turn is attributed to, resolved at call time. */\n\tgetWakeupTarget(): ScheduleWakeupTarget;\n\tscheduleWakeup(request: ScheduleWakeupRequest): Promise<ScheduleWakeupOutcome>;\n\tstopDynamicLoop(request: StopDynamicLoopRequest): Promise<StopDynamicLoopOutcome>;\n}\n\nexport interface LoopToolRegistrationDeps {\n\treadonly scheduler: ScheduleWakeupSchedulerPort;\n}\n\nexport const NO_ACTIVE_DYNAMIC_LOOP_ERROR = `${SCHEDULE_WAKEUP_TOOL} can only be used while a dynamic /loop is active.`;\nexport const FIXED_TICK_ERROR = `This is a fixed /loop tick; the recurring schedule re-arms automatically. Do not call ${SCHEDULE_WAKEUP_TOOL}.`;\nexport const MISSING_PROMPT_ERROR = \"prompt is required and must be non-empty unless stop is true.\";\nexport const MISSING_DELAY_ERROR = \"delaySeconds is required unless stop is true.\";\nexport const NON_INTEGER_DELAY_ERROR = \"delaySeconds must be a finite integer number of seconds.\";\nexport const BLANK_REASON_ERROR = \"reason is required and must be non-empty.\";\nexport const NOOP_WITH_STOP_ERROR = \"noop must be omitted when stop is true.\";\n\nfunction clampDelaySeconds(requested: number): number {\n\treturn Math.min(MAX_WAKEUP_DELAY_SECONDS, Math.max(MIN_WAKEUP_DELAY_SECONDS, requested));\n}\n\nfunction resolveDynamicLoopId(scheduler: ScheduleWakeupSchedulerPort): LoopId {\n\tconst target = scheduler.getWakeupTarget();\n\tif (target === null) throw new Error(NO_ACTIVE_DYNAMIC_LOOP_ERROR);\n\tif (target.kind === \"fixed\") throw new Error(FIXED_TICK_ERROR);\n\treturn target.loopId;\n}\n\nfunction requireReason(reason: string): string {\n\tconst trimmed = typeof reason === \"string\" ? reason.trim() : \"\";\n\tif (trimmed.length === 0) throw new Error(BLANK_REASON_ERROR);\n\treturn trimmed;\n}\n\nfunction collectIgnoredFields(params: ScheduleWakeupParams): ScheduleWakeupIgnorableField[] {\n\tconst ignored: ScheduleWakeupIgnorableField[] = [];\n\tif (params.delaySeconds !== undefined) ignored.push(\"delaySeconds\");\n\tif (params.prompt !== undefined) ignored.push(\"prompt\");\n\treturn ignored;\n}\n\nasync function executeStop(\n\tscheduler: ScheduleWakeupSchedulerPort,\n\tparams: ScheduleWakeupParams,\n): Promise<AgentToolResult<ScheduleWakeupDetails>> {\n\tif (params.noop !== undefined) throw new Error(NOOP_WITH_STOP_ERROR);\n\tconst reason = requireReason(params.reason);\n\tconst loopId = resolveDynamicLoopId(scheduler);\n\tconst ignoredFields = collectIgnoredFields(params);\n\tconst { endedAt } = await scheduler.stopDynamicLoop({ loopId, reason });\n\treturn {\n\t\tcontent: [{ type: \"text\" as const, text: `Stopped dynamic loop ${loopId}.` }],\n\t\tdetails: {\n\t\t\tok: true,\n\t\t\taction: \"stopped\",\n\t\t\tloopId,\n\t\t\tterminalReason: \"stopped\",\n\t\t\treason,\n\t\t\tendedAt,\n\t\t\tignoredFields,\n\t\t},\n\t};\n}\n\nasync function executeSchedule(\n\tscheduler: ScheduleWakeupSchedulerPort,\n\tparams: ScheduleWakeupParams,\n): Promise<AgentToolResult<ScheduleWakeupDetails>> {\n\tconst reason = requireReason(params.reason);\n\tconst requestedDelaySeconds = params.delaySeconds;\n\tif (requestedDelaySeconds === undefined) throw new Error(MISSING_DELAY_ERROR);\n\tif (!Number.isInteger(requestedDelaySeconds)) throw new Error(NON_INTEGER_DELAY_ERROR);\n\tconst prompt = params.prompt;\n\tif (prompt === undefined || prompt.trim().length === 0) throw new Error(MISSING_PROMPT_ERROR);\n\n\tconst loopId = resolveDynamicLoopId(scheduler);\n\tconst delaySeconds = clampDelaySeconds(requestedDelaySeconds);\n\tconst clamped = delaySeconds !== requestedDelaySeconds;\n\tconst noop = params.noop === true;\n\n\tconst outcome = await scheduler.scheduleWakeup({\n\t\tloopId,\n\t\trequestedDelaySeconds,\n\t\tdelaySeconds,\n\t\treason,\n\t\tprompt,\n\t\tnoop,\n\t});\n\n\tconst text = clamped\n\t\t? `Scheduled loop ${loopId} in ${delaySeconds}s; requested ${requestedDelaySeconds}s was clamped to the supported ${MIN_WAKEUP_DELAY_SECONDS}-${MAX_WAKEUP_DELAY_SECONDS}s range.`\n\t\t: `Scheduled loop ${loopId} in ${delaySeconds}s.`;\n\n\treturn {\n\t\tcontent: [{ type: \"text\" as const, text }],\n\t\tdetails: {\n\t\t\tok: true,\n\t\t\taction: \"scheduled\",\n\t\t\tloopId,\n\t\t\twakeupId: outcome.wakeupId,\n\t\t\t...(outcome.replacedWakeupId === undefined ? {} : { replacedWakeupId: outcome.replacedWakeupId }),\n\t\t\trequestedDelaySeconds,\n\t\t\tdelaySeconds,\n\t\t\tclamped,\n\t\t\tdueAt: outcome.dueAt,\n\t\t\treason,\n\t\t\tprompt,\n\t\t\tnoop,\n\t\t\tnoopStreak: outcome.noopStreak,\n\t\t},\n\t};\n}\n\nexport function registerLoopTools(pi: ExtensionAPI, deps: LoopToolRegistrationDeps): void {\n\tpi.registerTool({\n\t\tname: SCHEDULE_WAKEUP_TOOL,\n\t\tlabel: \"Schedule Wakeup\",\n\t\tdescription: SCHEDULE_WAKEUP_DESCRIPTION,\n\t\tparameters: scheduleWakeupSchema,\n\t\t// Sequential so two concurrent model tool calls cannot race scheduler state.\n\t\texecutionMode: \"sequential\",\n\t\tasync execute(_toolCallId, params): Promise<AgentToolResult<ScheduleWakeupDetails>> {\n\t\t\treturn params.stop === true ? executeStop(deps.scheduler, params) : executeSchedule(deps.scheduler, params);\n\t\t},\n\t});\n}\n"]}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The `schedule_wakeup` model tool: the ONLY model-callable surface of the `/loop`\n * extension. It lets a dynamic (self-paced) loop pick its own next delay, or end itself.\n *\n * Exposure: the tool is registered `exposure: \"search\"` with lazy activation disabled, so it is\n * absent from the resident tool list (and from `tool_search`) until the loop extension activates it\n * for a live dynamic loop and retires it when that loop ends. Outside a dynamic loop every call is\n * an error, so a resident registration only cost prompt tokens.\n *\n * Two deliberate shape decisions:\n * - The TypeBox schema is a FLAT object with no root union. Several provider payload\n *   conversions rebuild tool schemas from top-level `properties` only, so a root\n *   `anyOf` would reach the model as an empty schema (same reasoning as\n *   `terminal/tools/monitor.ts`). Branch requirements are enforced in `execute`.\n * - `delaySeconds` carries NO schema `minimum`/`maximum`. The contract clamps\n *   out-of-range integers instead of rejecting them, and schema bounds would make the\n *   clamp unreachable.\n *\n * Scheduler state is never mutated here: every effect goes through the injected\n * `ScheduleWakeupSchedulerPort`.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ExtensionAPI } from \"../../types.ts\";\nimport type { EpochMs, LoopId, WakeupId } from \"./types.ts\";\n\n/** Model-visible tool name. */\nexport const SCHEDULE_WAKEUP_TOOL = \"schedule_wakeup\";\n\n/** Inclusive bounds the executor clamps `delaySeconds` into. */\nexport const MIN_WAKEUP_DELAY_SECONDS = 60;\nexport const MAX_WAKEUP_DELAY_SECONDS = 3600;\n\nexport const SCHEDULE_WAKEUP_DESCRIPTION = `Schedule when to resume work in /loop dynamic mode. Always pass the \\`prompt\\` argument unless stopping. Call this as the last action before ending a dynamic loop iteration so the loop remains alive; call with \\`stop: true\\` to end the active dynamic loop immediately.\n\n\\`delaySeconds\\` is clamped to ${MIN_WAKEUP_DELAY_SECONDS}-${MAX_WAKEUP_DELAY_SECONDS} seconds; 1200-1800 is the normal idle range, and a short delay chosen merely to poll loses prompt-cache value on many API paths. When a monitor or task notification is the primary wake source, the scheduled delay is only a fallback heartbeat.\n\nFor normal dynamic re-entry, set \\`prompt\\` to the complete original command, for example \\`/loop check the deploy\\`, preserving the user's text verbatim. Set \\`noop: true\\` only when this iteration found no actionable change; consecutive noop iterations are folded in the terminal view. Omit \\`noop\\` when stopping. Notify the user only when state changes in a way worth acting on, not once per tick.`;\n\nexport const scheduleWakeupSchema = Type.Object(\n\t{\n\t\tdelaySeconds: Type.Optional(\n\t\t\tType.Integer({\n\t\t\t\tdescription: `Dynamic loop delay in seconds. Values are clamped to ${MIN_WAKEUP_DELAY_SECONDS}-${MAX_WAKEUP_DELAY_SECONDS}.`,\n\t\t\t}),\n\t\t),\n\t\treason: Type.String({\n\t\t\tminLength: 1,\n\t\t\tdescription: \"Why this wakeup or stop is appropriate. Must not be blank.\",\n\t\t}),\n\t\tprompt: Type.Optional(\n\t\t\tType.String({\n\t\t\t\tdescription:\n\t\t\t\t\t\"Prompt to dispatch when the wakeup fires. Required unless stop is true; preserve the original /loop command verbatim for normal dynamic re-entry.\",\n\t\t\t}),\n\t\t),\n\t\tstop: Type.Optional(\n\t\t\tType.Boolean({\n\t\t\t\tdescription: \"End the active dynamic loop immediately instead of scheduling another wakeup.\",\n\t\t\t}),\n\t\t),\n\t\tnoop: Type.Optional(\n\t\t\tType.Boolean({\n\t\t\t\tdescription:\n\t\t\t\t\t\"True when this iteration observed no actionable change. Consecutive noop iterations are folded in the terminal view. Omit when stopping.\",\n\t\t\t}),\n\t\t),\n\t},\n\t{ additionalProperties: false },\n);\n\n/** Runtime-validated parameter shape; the schema itself stays flat and permissive. */\nexport interface ScheduleWakeupParams {\n\treadonly delaySeconds?: number;\n\treadonly reason: string;\n\treadonly prompt?: string;\n\treadonly stop?: boolean;\n\treadonly noop?: boolean;\n}\n\nexport interface ScheduleWakeupScheduledDetails {\n\treadonly ok: true;\n\treadonly action: \"scheduled\";\n\treadonly loopId: LoopId;\n\treadonly wakeupId: WakeupId;\n\treadonly replacedWakeupId?: WakeupId;\n\n\t/** Integer the model asked for, before the clamp. */\n\treadonly requestedDelaySeconds: number;\n\t/** Effective delay after clamping to `[60, 3600]`. */\n\treadonly delaySeconds: number;\n\treadonly clamped: boolean;\n\treadonly dueAt: EpochMs;\n\n\treadonly reason: string;\n\t/** Preserved verbatim after the non-blank check. */\n\treadonly prompt: string;\n\treadonly noop: boolean;\n\treadonly noopStreak: number;\n}\n\nexport interface ScheduleWakeupStoppedDetails {\n\treadonly ok: true;\n\treadonly action: \"stopped\";\n\treadonly loopId: LoopId;\n\treadonly terminalReason: \"stopped\";\n\treadonly reason: string;\n\treadonly endedAt: EpochMs;\n\t/** Fields accepted for model compatibility but not applied. */\n\treadonly ignoredFields: readonly ScheduleWakeupIgnorableField[];\n}\n\nexport type ScheduleWakeupIgnorableField = \"delaySeconds\" | \"prompt\";\n\nexport type ScheduleWakeupDetails = ScheduleWakeupScheduledDetails | ScheduleWakeupStoppedDetails;\n\n/**\n * Which loop, if any, this tool call belongs to. `null` means no loop context at all;\n * a `fixed` target means the call came from a fixed tick, whose schedule re-arms itself.\n */\nexport type ScheduleWakeupTarget = { readonly kind: \"dynamic\" | \"fixed\"; readonly loopId: LoopId } | null;\n\nexport interface ScheduleWakeupRequest {\n\treadonly loopId: LoopId;\n\treadonly requestedDelaySeconds: number;\n\treadonly delaySeconds: number;\n\treadonly reason: string;\n\treadonly prompt: string;\n\treadonly noop: boolean;\n}\n\nexport interface ScheduleWakeupOutcome {\n\treadonly wakeupId: WakeupId;\n\t/** Set when this schedule replaced a still-pending wakeup for the same loop. */\n\treadonly replacedWakeupId?: WakeupId;\n\treadonly dueAt: EpochMs;\n\treadonly noopStreak: number;\n}\n\nexport interface StopDynamicLoopRequest {\n\treadonly loopId: LoopId;\n\treadonly reason: string;\n}\n\nexport interface StopDynamicLoopOutcome {\n\treadonly endedAt: EpochMs;\n}\n\n/**\n * Minimal scheduler surface this tool needs. Declared locally so the tool module stays\n * independent of the scheduler implementation and testable with a fake.\n */\nexport interface ScheduleWakeupSchedulerPort {\n\t/** Loop the current turn is attributed to, resolved at call time. */\n\tgetWakeupTarget(): ScheduleWakeupTarget;\n\tscheduleWakeup(request: ScheduleWakeupRequest): Promise<ScheduleWakeupOutcome>;\n\tstopDynamicLoop(request: StopDynamicLoopRequest): Promise<StopDynamicLoopOutcome>;\n}\n\nexport interface LoopToolRegistrationDeps {\n\treadonly scheduler: ScheduleWakeupSchedulerPort;\n}\n\nexport const NO_ACTIVE_DYNAMIC_LOOP_ERROR = `${SCHEDULE_WAKEUP_TOOL} can only be used while a dynamic /loop is active.`;\nexport const FIXED_TICK_ERROR = `This is a fixed /loop tick; the recurring schedule re-arms automatically. Do not call ${SCHEDULE_WAKEUP_TOOL}.`;\nexport const MISSING_PROMPT_ERROR = \"prompt is required and must be non-empty unless stop is true.\";\nexport const MISSING_DELAY_ERROR = \"delaySeconds is required unless stop is true.\";\nexport const NON_INTEGER_DELAY_ERROR = \"delaySeconds must be a finite integer number of seconds.\";\nexport const BLANK_REASON_ERROR = \"reason is required and must be non-empty.\";\nexport const NOOP_WITH_STOP_ERROR = \"noop must be omitted when stop is true.\";\n\nfunction clampDelaySeconds(requested: number): number {\n\treturn Math.min(MAX_WAKEUP_DELAY_SECONDS, Math.max(MIN_WAKEUP_DELAY_SECONDS, requested));\n}\n\nfunction resolveDynamicLoopId(scheduler: ScheduleWakeupSchedulerPort): LoopId {\n\tconst target = scheduler.getWakeupTarget();\n\tif (target === null) throw new Error(NO_ACTIVE_DYNAMIC_LOOP_ERROR);\n\tif (target.kind === \"fixed\") throw new Error(FIXED_TICK_ERROR);\n\treturn target.loopId;\n}\n\nfunction requireReason(reason: string): string {\n\tconst trimmed = typeof reason === \"string\" ? reason.trim() : \"\";\n\tif (trimmed.length === 0) throw new Error(BLANK_REASON_ERROR);\n\treturn trimmed;\n}\n\nfunction collectIgnoredFields(params: ScheduleWakeupParams): ScheduleWakeupIgnorableField[] {\n\tconst ignored: ScheduleWakeupIgnorableField[] = [];\n\tif (params.delaySeconds !== undefined) ignored.push(\"delaySeconds\");\n\tif (params.prompt !== undefined) ignored.push(\"prompt\");\n\treturn ignored;\n}\n\nasync function executeStop(\n\tscheduler: ScheduleWakeupSchedulerPort,\n\tparams: ScheduleWakeupParams,\n): Promise<AgentToolResult<ScheduleWakeupDetails>> {\n\tif (params.noop !== undefined) throw new Error(NOOP_WITH_STOP_ERROR);\n\tconst reason = requireReason(params.reason);\n\tconst loopId = resolveDynamicLoopId(scheduler);\n\tconst ignoredFields = collectIgnoredFields(params);\n\tconst { endedAt } = await scheduler.stopDynamicLoop({ loopId, reason });\n\treturn {\n\t\tcontent: [{ type: \"text\" as const, text: `Stopped dynamic loop ${loopId}.` }],\n\t\tdetails: {\n\t\t\tok: true,\n\t\t\taction: \"stopped\",\n\t\t\tloopId,\n\t\t\tterminalReason: \"stopped\",\n\t\t\treason,\n\t\t\tendedAt,\n\t\t\tignoredFields,\n\t\t},\n\t};\n}\n\nasync function executeSchedule(\n\tscheduler: ScheduleWakeupSchedulerPort,\n\tparams: ScheduleWakeupParams,\n): Promise<AgentToolResult<ScheduleWakeupDetails>> {\n\tconst reason = requireReason(params.reason);\n\tconst requestedDelaySeconds = params.delaySeconds;\n\tif (requestedDelaySeconds === undefined) throw new Error(MISSING_DELAY_ERROR);\n\tif (!Number.isInteger(requestedDelaySeconds)) throw new Error(NON_INTEGER_DELAY_ERROR);\n\tconst prompt = params.prompt;\n\tif (prompt === undefined || prompt.trim().length === 0) throw new Error(MISSING_PROMPT_ERROR);\n\n\tconst loopId = resolveDynamicLoopId(scheduler);\n\tconst delaySeconds = clampDelaySeconds(requestedDelaySeconds);\n\tconst clamped = delaySeconds !== requestedDelaySeconds;\n\tconst noop = params.noop === true;\n\n\tconst outcome = await scheduler.scheduleWakeup({\n\t\tloopId,\n\t\trequestedDelaySeconds,\n\t\tdelaySeconds,\n\t\treason,\n\t\tprompt,\n\t\tnoop,\n\t});\n\n\tconst text = clamped\n\t\t? `Scheduled loop ${loopId} in ${delaySeconds}s; requested ${requestedDelaySeconds}s was clamped to the supported ${MIN_WAKEUP_DELAY_SECONDS}-${MAX_WAKEUP_DELAY_SECONDS}s range.`\n\t\t: `Scheduled loop ${loopId} in ${delaySeconds}s.`;\n\n\treturn {\n\t\tcontent: [{ type: \"text\" as const, text }],\n\t\tdetails: {\n\t\t\tok: true,\n\t\t\taction: \"scheduled\",\n\t\t\tloopId,\n\t\t\twakeupId: outcome.wakeupId,\n\t\t\t...(outcome.replacedWakeupId === undefined ? {} : { replacedWakeupId: outcome.replacedWakeupId }),\n\t\t\trequestedDelaySeconds,\n\t\t\tdelaySeconds,\n\t\t\tclamped,\n\t\t\tdueAt: outcome.dueAt,\n\t\t\treason,\n\t\t\tprompt,\n\t\t\tnoop,\n\t\t\tnoopStreak: outcome.noopStreak,\n\t\t},\n\t};\n}\n\nexport function registerLoopTools(pi: ExtensionAPI, deps: LoopToolRegistrationDeps): void {\n\tpi.registerTool({\n\t\tname: SCHEDULE_WAKEUP_TOOL,\n\t\tlabel: \"Schedule Wakeup\",\n\t\tdescription: SCHEDULE_WAKEUP_DESCRIPTION,\n\t\tparameters: scheduleWakeupSchema,\n\t\texposure: \"search\",\n\t\tallowLazyActivation: false,\n\t\t// Sequential so two concurrent model tool calls cannot race scheduler state.\n\t\texecutionMode: \"sequential\",\n\t\tasync execute(_toolCallId, params): Promise<AgentToolResult<ScheduleWakeupDetails>> {\n\t\t\treturn params.stop === true ? executeStop(deps.scheduler, params) : executeSchedule(deps.scheduler, params);\n\t\t},\n\t});\n}\n"]}

package/dist/core/extensions/builtin/monitor-state-event.d.ts

@@ -24,6 +24,8 @@ export declare function isContinuationHoldStateEvent(data: unknown): data is Con
 /** One live watch as broadcast on the monitor state event; mirrors MonitorSnapshotEntry. */
 export interface TerminalMonitorStateMonitorEntry {
     readonly id: string;
+    /** Stable "mon_" identity surviving runtime id churn; absent in pre-enrichment payloads. */
+    readonly monitorId?: string;
     readonly description: string;
     readonly paused: boolean;
     /** Epoch milliseconds when the watch registered; lets consumers render their own elapsed labels. */

package/dist/core/extensions/builtin/monitor-state-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"monitor-state-event.d.ts","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/monitor-state-event.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AACrE,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAC3D,eAAO,MAAM,6BAA6B,4BAA4B,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,oBAAoB,CAWlF;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,0BAA0B,CAU9F;AAED,4FAA4F;AAC5F,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,oGAAoG;IACpG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uGAAuG;IACvG,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;CAChE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,yBAAyB,CAS5F"}
+{"version":3,"file":"monitor-state-event.d.ts","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/monitor-state-event.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AACrE,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAC3D,eAAO,MAAM,6BAA6B,4BAA4B,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,oBAAoB,CAWlF;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,0BAA0B,CAU9F;AAED,4FAA4F;AAC5F,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,oGAAoG;IACpG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uGAAuG;IACvG,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;CAChE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,yBAAyB,CAS5F"}

package/dist/core/extensions/builtin/monitor-state-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"monitor-state-event.js","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/monitor-state-event.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAC3D,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAC;AAmBvE;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAa;IACnD,OAAO,CACN,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,QAAQ,IAAI,IAAI;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACtB,aAAa,IAAI,IAAI;QACrB,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;QACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CACjC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAa;IACzD,OAAO,CACN,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,QAAQ,IAAI,IAAI;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACtB,QAAQ,IAAI,IAAI;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAChC,CAAC;AACH,CAAC;AAiBD,MAAM,UAAU,2BAA2B,CAAC,IAAa;IACxD,OAAO,CACN,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,aAAa,IAAI,IAAI;QACrB,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;QACpC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC;QAClC,IAAI,CAAC,WAAW,IAAI,CAAC,CACrB,CAAC;AACH,CAAC","sourcesContent":["export const TERMINAL_MONITOR_STATE_EVENT = \"terminal_monitor_state\";\nexport const WAKE_SOURCE_STATE_EVENT = \"wake_source_state\";\nexport const CONTINUATION_HOLD_STATE_EVENT = \"continuation_hold_state\";\n\nexport interface WakeSourceStateItem {\n\treadonly id: string;\n\treadonly description?: string;\n\treadonly startedAtMs?: number;\n}\n\nexport interface WakeSourceStateEvent {\n\treadonly source: string;\n\treadonly activeCount: number;\n\treadonly items?: readonly WakeSourceStateItem[];\n}\n\nexport interface ContinuationHoldStateEvent {\n\treadonly source: string;\n\treadonly active: boolean;\n}\n\n/**\n * Deliberately validates only the shared cross-package fields. Emitters may add\n * source-specific details such as `channels` or `monitors`.\n */\nexport function isWakeSourceStateEvent(data: unknown): data is WakeSourceStateEvent {\n\treturn (\n\t\ttypeof data === \"object\" &&\n\t\tdata !== null &&\n\t\t\"source\" in data &&\n\t\ttypeof data.source === \"string\" &&\n\t\tdata.source.length > 0 &&\n\t\t\"activeCount\" in data &&\n\t\ttypeof data.activeCount === \"number\" &&\n\t\tNumber.isFinite(data.activeCount)\n\t);\n}\n\nexport function isContinuationHoldStateEvent(data: unknown): data is ContinuationHoldStateEvent {\n\treturn (\n\t\ttypeof data === \"object\" &&\n\t\tdata !== null &&\n\t\t\"source\" in data &&\n\t\ttypeof data.source === \"string\" &&\n\t\tdata.source.length > 0 &&\n\t\t\"active\" in data &&\n\t\ttypeof data.active === \"boolean\"\n\t);\n}\n\n/** One live watch as broadcast on the monitor state event; mirrors MonitorSnapshotEntry. */\nexport interface TerminalMonitorStateMonitorEntry {\n\treadonly id: string;\n\treadonly description: string;\n\treadonly paused: boolean;\n\t/** Epoch milliseconds when the watch registered; lets consumers render their own elapsed labels. */\n\treadonly startedAtMs: number;\n}\n\nexport interface TerminalMonitorStateEvent {\n\treadonly activeCount: number;\n\t/** Per-watch detail for consumers that need more than the count; absent in pre-enrichment payloads. */\n\treadonly monitors?: readonly TerminalMonitorStateMonitorEntry[];\n}\n\nexport function isTerminalMonitorStateEvent(data: unknown): data is TerminalMonitorStateEvent {\n\treturn (\n\t\ttypeof data === \"object\" &&\n\t\tdata !== null &&\n\t\t\"activeCount\" in data &&\n\t\ttypeof data.activeCount === \"number\" &&\n\t\tNumber.isInteger(data.activeCount) &&\n\t\tdata.activeCount >= 0\n\t);\n}\n"]}
+{"version":3,"file":"monitor-state-event.js","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/monitor-state-event.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAC3D,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAC;AAmBvE;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAa;IACnD,OAAO,CACN,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,QAAQ,IAAI,IAAI;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACtB,aAAa,IAAI,IAAI;QACrB,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;QACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CACjC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAa;IACzD,OAAO,CACN,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,QAAQ,IAAI,IAAI;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACtB,QAAQ,IAAI,IAAI;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAChC,CAAC;AACH,CAAC;AAmBD,MAAM,UAAU,2BAA2B,CAAC,IAAa;IACxD,OAAO,CACN,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,aAAa,IAAI,IAAI;QACrB,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;QACpC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC;QAClC,IAAI,CAAC,WAAW,IAAI,CAAC,CACrB,CAAC;AACH,CAAC","sourcesContent":["export const TERMINAL_MONITOR_STATE_EVENT = \"terminal_monitor_state\";\nexport const WAKE_SOURCE_STATE_EVENT = \"wake_source_state\";\nexport const CONTINUATION_HOLD_STATE_EVENT = \"continuation_hold_state\";\n\nexport interface WakeSourceStateItem {\n\treadonly id: string;\n\treadonly description?: string;\n\treadonly startedAtMs?: number;\n}\n\nexport interface WakeSourceStateEvent {\n\treadonly source: string;\n\treadonly activeCount: number;\n\treadonly items?: readonly WakeSourceStateItem[];\n}\n\nexport interface ContinuationHoldStateEvent {\n\treadonly source: string;\n\treadonly active: boolean;\n}\n\n/**\n * Deliberately validates only the shared cross-package fields. Emitters may add\n * source-specific details such as `channels` or `monitors`.\n */\nexport function isWakeSourceStateEvent(data: unknown): data is WakeSourceStateEvent {\n\treturn (\n\t\ttypeof data === \"object\" &&\n\t\tdata !== null &&\n\t\t\"source\" in data &&\n\t\ttypeof data.source === \"string\" &&\n\t\tdata.source.length > 0 &&\n\t\t\"activeCount\" in data &&\n\t\ttypeof data.activeCount === \"number\" &&\n\t\tNumber.isFinite(data.activeCount)\n\t);\n}\n\nexport function isContinuationHoldStateEvent(data: unknown): data is ContinuationHoldStateEvent {\n\treturn (\n\t\ttypeof data === \"object\" &&\n\t\tdata !== null &&\n\t\t\"source\" in data &&\n\t\ttypeof data.source === \"string\" &&\n\t\tdata.source.length > 0 &&\n\t\t\"active\" in data &&\n\t\ttypeof data.active === \"boolean\"\n\t);\n}\n\n/** One live watch as broadcast on the monitor state event; mirrors MonitorSnapshotEntry. */\nexport interface TerminalMonitorStateMonitorEntry {\n\treadonly id: string;\n\t/** Stable \"mon_\" identity surviving runtime id churn; absent in pre-enrichment payloads. */\n\treadonly monitorId?: string;\n\treadonly description: string;\n\treadonly paused: boolean;\n\t/** Epoch milliseconds when the watch registered; lets consumers render their own elapsed labels. */\n\treadonly startedAtMs: number;\n}\n\nexport interface TerminalMonitorStateEvent {\n\treadonly activeCount: number;\n\t/** Per-watch detail for consumers that need more than the count; absent in pre-enrichment payloads. */\n\treadonly monitors?: readonly TerminalMonitorStateMonitorEntry[];\n}\n\nexport function isTerminalMonitorStateEvent(data: unknown): data is TerminalMonitorStateEvent {\n\treturn (\n\t\ttypeof data === \"object\" &&\n\t\tdata !== null &&\n\t\t\"activeCount\" in data &&\n\t\ttypeof data.activeCount === \"number\" &&\n\t\tNumber.isInteger(data.activeCount) &&\n\t\tdata.activeCount >= 0\n\t);\n}\n"]}