stitchkit 0.101.3 → 0.103.0

package/dist/entrypoints/application/diagnostic-journal.js

@@ -1,13 +1,16 @@
 import {
+  DiagnosticJournalFrameSchema2,
+  createDiagnosticJournalReadResultSchema2,
+  DiagnosticJournalRecoveryStatusSchema2,
+  DiagnosticJournalRecoveryError2,
   DiagnosticJournalLimitsSchema2,
   DiagnosticJournalLockPolicySchema2,
   DiagnosticJournalStatusSchema2,
   DiagnosticJournalSubmitResultSchema2,
   DiagnosticJournalWaitResultSchema2,
   DiagnosticJournalCloseResultSchema2,
-  DiagnosticJournalFrameSchema2,
   parseDiagnosticJournalMode
-} from "../../index-h124epcf.js";
+} from "../../index-z94wht4y.js";
 import {
   createBoundedChannel2
 } from "../../index-w0eqdhyd.js";
@@ -22,12 +25,12 @@ import {
 import { randomUUID } from "node:crypto";
 
 // src/application/diagnostic-journal-manager.ts
-import { z } from "zod";
+import { z as z3 } from "zod";
 
 // src/application/diagnostic-journal-storage.ts
-import { constants } from "node:fs";
-import { lstat, open, readdir, realpath, rename, unlink } from "node:fs/promises";
-import { basename, dirname, isAbsolute, resolve } from "node:path";
+import { constants as constants2 } from "node:fs";
+import { lstat as lstat2, open as open2, readdir, realpath, rename, unlink } from "node:fs/promises";
+import { basename, dirname, isAbsolute as isAbsolute2, resolve as resolve2 } from "node:path";
 
 // src/application/diagnostic-journal-lock.ts
 async function acquireDiagnosticJournalLock(lockPath, mode, policy, declaredIdentity) {
@@ -46,6 +49,175 @@ async function acquireDiagnosticJournalLock(lockPath, mode, policy, declaredIden
   throw error;
 }
 
+// src/application/diagnostic-journal-recovery.ts
+import { z as z2 } from "zod";
+
+// src/application/diagnostic-journal-reader.ts
+import { constants } from "node:fs";
+import { lstat, open } from "node:fs/promises";
+import { isAbsolute, resolve } from "node:path";
+import { z } from "zod";
+function decodeLine(schema, location, body) {
+  const anomaly = (reason, skippedBytes = location.bytes) => schema.parse({
+    type: "anomaly",
+    anomaly: {
+      file: location.file,
+      offset: location.offset,
+      line: location.line,
+      reason,
+      position: location.position,
+      terminated: location.terminated,
+      skippedBytes
+    }
+  });
+  if (body === undefined)
+    return [anomaly("oversized-line")];
+  if (body.includes(0))
+    return [anomaly("nul-byte")];
+  let text;
+  try {
+    text = new TextDecoder("utf-8", { fatal: true }).decode(body);
+  } catch {
+    return [anomaly("invalid-utf8")];
+  }
+  let frame;
+  try {
+    frame = JSON.parse(text);
+  } catch {
+    return [anomaly(location.terminated ? "invalid-json" : "unterminated-line")];
+  }
+  const parsed = schema.safeParse({
+    type: "frame",
+    file: location.file,
+    offset: location.offset,
+    line: location.line,
+    bytes: location.bytes,
+    frame
+  });
+  if (!parsed.success) {
+    const frameInvalid = parsed.error.issues.some((issue) => issue.path[0] !== "frame" || issue.path[1] !== "event");
+    return [anomaly(frameInvalid ? "invalid-frame" : "invalid-event")];
+  }
+  return location.terminated ? [parsed.data] : [anomaly("unterminated-line", 0), parsed.data];
+}
+async function openRegularFile(path) {
+  const before = await lstat(path);
+  if (before.isSymbolicLink() || !before.isFile()) {
+    throw new TypeError("Diagnostic journal reader requires a regular file, never a symlink");
+  }
+  const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+  try {
+    const info = await handle.stat();
+    if (!info.isFile())
+      throw new TypeError("Diagnostic journal reader requires a regular file");
+    return { handle, size: z.number().int().nonnegative().parse(info.size) };
+  } catch (error) {
+    await handle.close();
+    throw error;
+  }
+}
+async function* readDiagnosticJournal(config) {
+  const maxLineBytes = z.number().int().positive().parse(config.maxLineBytes);
+  if (config.paths.length === 0)
+    throw new TypeError("Diagnostic journal reader needs at least one path");
+  for (const path of config.paths) {
+    if (!isAbsolute(path) || resolve(path) !== path) {
+      throw new TypeError("Diagnostic journal reader paths must be normalized and absolute");
+    }
+  }
+  const schema = createDiagnosticJournalReadResultSchema2(config.eventSchema);
+  for (const file of config.paths) {
+    config.signal?.throwIfAborted();
+    const { handle, size } = await openRegularFile(file);
+    try {
+      const chunk = Buffer.alloc(64 * 1024);
+      let offset = 0;
+      let lineOffset = 0;
+      let line = 1;
+      let lineBytes = 0;
+      let oversized = false;
+      let parts = [];
+      while (offset < size) {
+        config.signal?.throwIfAborted();
+        const { bytesRead } = await handle.read(chunk, 0, Math.min(chunk.length, size - offset), offset);
+        if (bytesRead === 0)
+          throw new Error(`Diagnostic journal file was truncated during read: ${file}`);
+        let start = 0;
+        while (start < bytesRead) {
+          config.signal?.throwIfAborted();
+          const found = chunk.indexOf(10, start);
+          const terminated = found >= start && found < bytesRead;
+          const end = terminated ? found : bytesRead;
+          lineBytes += end - start;
+          if (lineBytes > maxLineBytes) {
+            oversized = true;
+            parts = [];
+          } else if (!oversized && end > start) {
+            parts.push(Buffer.from(chunk.subarray(start, end)));
+          }
+          start = end + (terminated ? 1 : 0);
+          if (terminated) {
+            const nextOffset = offset + start;
+            yield* decodeLine(schema, {
+              file,
+              offset: lineOffset,
+              line,
+              bytes: lineBytes + 1,
+              terminated: true,
+              position: nextOffset === size ? "tail" : "interior"
+            }, oversized ? undefined : Buffer.concat(parts, lineBytes));
+            lineOffset = nextOffset;
+            line += 1;
+            lineBytes = 0;
+            oversized = false;
+            parts = [];
+          }
+        }
+        offset += bytesRead;
+      }
+      if (lineBytes > 0) {
+        yield* decodeLine(schema, {
+          file,
+          offset: lineOffset,
+          line,
+          bytes: lineBytes,
+          terminated: false,
+          position: "tail"
+        }, oversized ? undefined : Buffer.concat(parts, lineBytes));
+      }
+    } finally {
+      await handle.close();
+    }
+  }
+}
+
+// src/application/diagnostic-journal-recovery.ts
+async function inspectDiagnosticJournalRecovery(paths, maxLineBytes) {
+  let anomalies = 0;
+  let skippedBytes = 0;
+  let firstAnomaly;
+  let lastAnomaly;
+  for await (const result of readDiagnosticJournal({
+    paths,
+    maxLineBytes,
+    eventSchema: z2.json()
+  })) {
+    if (result.type !== "anomaly")
+      continue;
+    anomalies += 1;
+    skippedBytes += result.anomaly.skippedBytes;
+    firstAnomaly ??= result.anomaly;
+    lastAnomaly = result.anomaly;
+  }
+  return DiagnosticJournalRecoveryStatusSchema2.parse({
+    filesChecked: paths.length,
+    anomalies,
+    skippedBytes,
+    ...firstAnomaly && { firstAnomaly },
+    ...lastAnomaly && { lastAnomaly }
+  });
+}
+
 // src/application/diagnostic-journal-storage.ts
 class DiagnosticJournalStorageError extends Error {
   phase;
@@ -60,7 +232,7 @@ function isMissing(error) {
 }
 async function removeIfPresent(path) {
   try {
-    const info = await lstat(path);
+    const info = await lstat2(path);
     if (info.isSymbolicLink() || !info.isFile()) {
       throw new Error("Diagnostic journal generations must be regular files");
     }
@@ -72,7 +244,7 @@ async function removeIfPresent(path) {
 }
 async function moveIfPresent(from, to) {
   try {
-    const info = await lstat(from);
+    const info = await lstat2(from);
     if (info.isSymbolicLink() || !info.isFile()) {
       throw new Error("Diagnostic journal generations must be regular files");
     }
@@ -97,11 +269,11 @@ function generationIndex(name, prefix) {
   return Number.isSafeInteger(value) && value > 0 ? value : undefined;
 }
 async function createRotatingDiagnosticJournalStorage(config) {
-  if (!isAbsolute(config.path) || resolve(config.path) !== config.path) {
+  if (!isAbsolute2(config.path) || resolve2(config.path) !== config.path) {
     throw new TypeError("Diagnostic journal path must be normalized and absolute");
   }
   const parent = await realpath(dirname(config.path));
-  const journalPath = resolve(parent, basename(config.path));
+  const journalPath = resolve2(parent, basename(config.path));
   const lockPath = `${journalPath}.lock`;
   const { lock, reclaimedStale } = await acquireDiagnosticJournalLock(lockPath, config.mode, config.lock, config.machineIdentity);
   let handle;
@@ -109,9 +281,10 @@ async function createRotatingDiagnosticJournalStorage(config) {
   let retainedFiles = 1;
   let rotations = 0;
   let partialTails = 0;
+  let recovery;
   let closed = false;
   const openCurrent = async () => {
-    handle = await open(journalPath, constants.O_APPEND | constants.O_CREAT | constants.O_RDWR | constants.O_NOFOLLOW, config.mode);
+    handle = await open2(journalPath, constants2.O_APPEND | constants2.O_CREAT | constants2.O_RDWR | constants2.O_NOFOLLOW, config.mode);
     const info = await handle.stat();
     if (!info.isFile()) {
       await handle.close();
@@ -143,18 +316,20 @@ async function createRotatingDiagnosticJournalStorage(config) {
   try {
     const names = await readdir(parent);
     const prefix = `${basename(journalPath)}.`;
+    const expiredGenerations = [];
     let existingGenerations = 0;
     for (const name of names) {
       const index = generationIndex(name, prefix);
       if (index === undefined)
         continue;
+      const path = resolve2(parent, name);
+      const info = await lstat2(path);
+      if (info.isSymbolicLink() || !info.isFile()) {
+        throw new Error("Diagnostic journal generations must be regular files");
+      }
       if (index >= config.maxFiles) {
-        await removeIfPresent(resolve(parent, name));
+        expiredGenerations.push(path);
       } else {
-        const info = await lstat(resolve(parent, name));
-        if (info.isSymbolicLink() || !info.isFile()) {
-          throw new Error("Diagnostic journal generations must be regular files");
-        }
         existingGenerations += 1;
       }
     }
@@ -164,10 +339,26 @@ async function createRotatingDiagnosticJournalStorage(config) {
       const tail = new Uint8Array(1);
       const read = await handle?.read(tail, 0, 1, currentFileBytes - 1);
       if (read?.bytesRead === 1 && tail[0] !== 10) {
+        if (config.maxFiles === 1) {
+          throw new DiagnosticJournalRecoveryError2(await inspectDiagnosticJournalRecovery([journalPath], config.maxFileBytes));
+        }
         partialTails += 1;
         await rotate();
       }
     }
+    for (const path of expiredGenerations)
+      await removeIfPresent(path);
+    const paths = [];
+    for (const name of await readdir(parent)) {
+      const index = generationIndex(name, prefix);
+      if (index !== undefined && index < config.maxFiles) {
+        paths.push({ index, path: resolve2(parent, name) });
+      }
+    }
+    paths.sort((left, right) => right.index - left.index);
+    const inspected = await inspectDiagnosticJournalRecovery([...paths.map((file) => file.path), journalPath], config.maxFileBytes);
+    if (inspected.anomalies > 0)
+      recovery = inspected;
   } catch (error) {
     await handle?.close().catch(() => {
       return;
@@ -181,7 +372,8 @@ async function createRotatingDiagnosticJournalStorage(config) {
     currentFileBytes,
     retainedFiles,
     rotations,
-    partialTails
+    partialTails,
+    ...recovery && { recovery }
   });
   return {
     reclaimedStale,
@@ -389,6 +581,7 @@ function createDiagnosticJournalManager(config, storage) {
       partialTails: file.partialTails,
       currentFileBytes: file.currentFileBytes,
       retainedFiles: file.retainedFiles,
+      ...file.recovery && { recovery: file.recovery },
       ...lastAcceptedSequence > 0 && { lastAcceptedSequence },
       ...lastWrittenSequence > 0 && { lastWrittenSequence },
       ...lastSettledSequence > 0 && { lastSettledSequence },
@@ -405,7 +598,7 @@ function createDiagnosticJournalManager(config, storage) {
       const parsed = config.eventSchema.safeParse(event);
       if (!parsed.success)
         return refuse("invalid");
-      const json = z.json().safeParse(parsed.data);
+      const json = z3.json().safeParse(parsed.data);
       if (!json.success)
         return refuse("invalid");
       const payload = encoder.encode(JSON.stringify(json.data));
@@ -488,5 +681,6 @@ async function createDiagnosticJournal(config) {
   }, storage);
 }
 export {
-  createDiagnosticJournal
+  createDiagnosticJournal,
+  readDiagnosticJournal
 };

package/dist/entrypoints/application.d.ts

@@ -3,6 +3,7 @@ export { type BoundedAdmission, type BoundedAdmissionClock, type BoundedAdmissio
 export { type ChangeConnection, type ChangeReconciliation, type ChangeSubscriptionConfig, changeSubscriptionResource, } from '../application/change-subscription.js';
 export { createDecisionPipeline, type DecisionPipeline, type DecisionPipelineConfig, type DecisionPolicy, DecisionPolicyError, type DecisionResult, type DecisionTraceEntry, DecisionUndecidedError, type PolicyDecision, PolicyDecisionSchema, } from '../application/decisions.js';
 export { type DiagnosticJournal, type DiagnosticJournalCloseResult, DiagnosticJournalCloseResultSchema, type DiagnosticJournalConfig, type DiagnosticJournalFailure, type DiagnosticJournalFailurePhase, DiagnosticJournalFailurePhaseSchema, type DiagnosticJournalFrame, DiagnosticJournalFrameSchema, type DiagnosticJournalLimits, DiagnosticJournalLimitsSchema, type DiagnosticJournalLockDiagnosis, type DiagnosticJournalLockPolicy, DiagnosticJournalLockPolicySchema, type DiagnosticJournalRefusalReason, DiagnosticJournalRefusalReasonSchema, type DiagnosticJournalState, DiagnosticJournalStateSchema, type DiagnosticJournalStatus, DiagnosticJournalStatusSchema, type DiagnosticJournalSubmitResult, DiagnosticJournalSubmitResultSchema, type DiagnosticJournalWaitOptions, type DiagnosticJournalWaitResult, DiagnosticJournalWaitResultSchema, readDiagnosticJournalLockDiagnosis, } from '../application/diagnostic-journal-contract.js';
+export { createDiagnosticJournalReadResultSchema, type DiagnosticJournalAnomaly, DiagnosticJournalAnomalySchema, type DiagnosticJournalReadResult, DiagnosticJournalRecoveryError, type DiagnosticJournalRecoveryStatus, DiagnosticJournalRecoveryStatusSchema, } from '../application/diagnostic-journal-read-contract.js';
 export { type DirectoryInbox, type DirectoryInboxConfig, type DirectoryInboxDelivery, type DirectoryInboxRejection, type DirectoryInboxRejectionReason, DirectoryInboxRejectionReasonSchema, type DirectoryInboxResource, type DirectoryInboxState, DirectoryInboxStateSchema, } from '../application/directory-inbox-contract.js';
 export { type ApplicationEventSink, type ApplicationEventSinkConfig, type ApplicationLifecycleEvent, ApplicationLifecycleEventSchema, applicationLifecycleEvent, createApplicationEventSink, } from '../application/events.js';
 export { type ApplicationHealthHandlerOptions, ApplicationHealthHandlerOptionsSchema, type ApplicationOperationalHandlers, type ApplicationOperationalHandlersOptions, ApplicationOperationalHandlersOptionsSchema, createApplicationHealthHandler, createApplicationOperationalHandlers, } from '../application/health.js';

package/dist/entrypoints/application.d.ts.map

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

package/dist/entrypoints/application.js

@@ -31,6 +31,11 @@ import {
   createBackoff2
 } from "../index-g6a3na27.js";
 import {
+  DiagnosticJournalFrameSchema2,
+  DiagnosticJournalAnomalySchema2,
+  createDiagnosticJournalReadResultSchema2,
+  DiagnosticJournalRecoveryStatusSchema2,
+  DiagnosticJournalRecoveryError2,
   DiagnosticJournalLimitsSchema2,
   DiagnosticJournalLockPolicySchema2,
   DiagnosticJournalStateSchema2,
@@ -40,9 +45,8 @@ import {
   DiagnosticJournalSubmitResultSchema2,
   DiagnosticJournalWaitResultSchema2,
   DiagnosticJournalCloseResultSchema2,
-  DiagnosticJournalFrameSchema2,
   readDiagnosticJournalLockDiagnosis2
-} from "../index-h124epcf.js";
+} from "../index-z94wht4y.js";
 import {
   DirectoryInboxRejectionReasonSchema2,
   DirectoryInboxStateSchema2
@@ -2574,11 +2578,14 @@ export {
   CreditWindowSnapshotSchema2 as CreditWindowSnapshotSchema,
   DecisionPolicyError,
   DecisionUndecidedError,
+  DiagnosticJournalAnomalySchema2 as DiagnosticJournalAnomalySchema,
   DiagnosticJournalCloseResultSchema2 as DiagnosticJournalCloseResultSchema,
   DiagnosticJournalFailurePhaseSchema2 as DiagnosticJournalFailurePhaseSchema,
   DiagnosticJournalFrameSchema2 as DiagnosticJournalFrameSchema,
   DiagnosticJournalLimitsSchema2 as DiagnosticJournalLimitsSchema,
   DiagnosticJournalLockPolicySchema2 as DiagnosticJournalLockPolicySchema,
+  DiagnosticJournalRecoveryError2 as DiagnosticJournalRecoveryError,
+  DiagnosticJournalRecoveryStatusSchema2 as DiagnosticJournalRecoveryStatusSchema,
   DiagnosticJournalRefusalReasonSchema2 as DiagnosticJournalRefusalReasonSchema,
   DiagnosticJournalStateSchema2 as DiagnosticJournalStateSchema,
   DiagnosticJournalStatusSchema2 as DiagnosticJournalStatusSchema,
@@ -2616,6 +2623,7 @@ export {
   createBoundedChannel2 as createBoundedChannel,
   createCreditWindow2 as createCreditWindow,
   createDecisionPipeline,
+  createDiagnosticJournalReadResultSchema2 as createDiagnosticJournalReadResultSchema,
   createManagedSchedule2 as createManagedSchedule,
   createNotificationOutbox,
   createProcessLifecycleLedger,

package/dist/entrypoints/tools/contract.js

@@ -6,7 +6,7 @@ import {
   ViewFileErrorSchema2,
   ViewFileOutputSchema2,
   ViewFileInputSchema2
-} from "../../index-5107q189.js";
+} from "../../index-zax7resm.js";
 import {
   coerceJsonArgs2
 } from "../../index-9pw0a51a.js";

package/dist/entrypoints/tools.js

@@ -69,7 +69,7 @@ import {
   ViewFileErrorSchema2,
   ViewFileOutputSchema2,
   ViewFileInputSchema2
-} from "../index-5107q189.js";
+} from "../index-zax7resm.js";
 import {
   fetchGuarded,
   fetchPinnedDocument,
@@ -2632,7 +2632,8 @@ var EXT_MIME = {
   ".mov": "video/quicktime"
 };
 async function fetchSource(pathOrUrl, options, maxBytes) {
-  const extMime = EXT_MIME[extname2(pathOrUrl).toLowerCase()];
+  const extension = extname2(pathOrUrl);
+  const extMime = EXT_MIME[extension.toLowerCase()];
   if (pathOrUrl.startsWith("http://") || pathOrUrl.startsWith("https://")) {
     const url = new URL(pathOrUrl);
     const res = await fetchGuarded(url, options.allowPrivateHosts ?? false, {
@@ -2660,7 +2661,7 @@ async function fetchSource(pathOrUrl, options, maxBytes) {
   }
   options.signal?.throwIfAborted();
   if (!extMime) {
-    throw new AppError2("FILE_INSPECTION_REJECTED", "refusing to read a non-media file", 422);
+    throw new AppError2("FILE_INSPECTION_REJECTED", `refusing to read ${JSON.stringify(pathOrUrl)} — ${JSON.stringify(extension)} is not a media extension`, 422);
   }
   try {
     const source = await options.files.read(pathOrUrl, {

package/dist/index-z94wht4y.js

@@ -0,0 +1,156 @@
+import {
+  isRecord
+} from "./index-9jfdm5tg.js";
+
+// src/application/diagnostic-journal-frame.ts
+import { z } from "zod";
+var DiagnosticJournalFrameSchema2 = z.object({
+  schemaVersion: z.literal(1),
+  epoch: z.uuid(),
+  sequence: z.number().int().positive(),
+  event: z.json()
+}).strict().readonly();
+
+// src/application/diagnostic-journal-read-contract.ts
+import { z as z2 } from "zod";
+var ByteCountSchema = z2.number().int().nonnegative();
+var LocationSchema = z2.object({
+  file: z2.string(),
+  offset: ByteCountSchema,
+  line: z2.number().int().positive()
+});
+var DiagnosticJournalAnomalySchema2 = LocationSchema.extend({
+  reason: z2.enum([
+    "nul-byte",
+    "unterminated-line",
+    "invalid-utf8",
+    "invalid-json",
+    "invalid-frame",
+    "invalid-event",
+    "oversized-line"
+  ]),
+  position: z2.enum(["tail", "interior"]),
+  terminated: z2.boolean(),
+  skippedBytes: ByteCountSchema
+}).strict().readonly();
+function createDiagnosticJournalReadResultSchema2(eventSchema) {
+  return z2.discriminatedUnion("type", [
+    LocationSchema.extend({
+      type: z2.literal("frame"),
+      bytes: ByteCountSchema,
+      frame: DiagnosticJournalFrameSchema2.unwrap().extend({ event: eventSchema }).readonly()
+    }).strict().readonly(),
+    z2.object({ type: z2.literal("anomaly"), anomaly: DiagnosticJournalAnomalySchema2 }).strict().readonly()
+  ]);
+}
+var DiagnosticJournalRecoveryStatusSchema2 = z2.object({
+  filesChecked: ByteCountSchema,
+  anomalies: ByteCountSchema,
+  skippedBytes: ByteCountSchema,
+  firstAnomaly: DiagnosticJournalAnomalySchema2.optional(),
+  lastAnomaly: DiagnosticJournalAnomalySchema2.optional()
+}).strict().readonly();
+
+class DiagnosticJournalRecoveryError2 extends Error {
+  recovery;
+  constructor(recovery) {
+    super("Diagnostic journal tail recovery requires maxFiles >= 2; no data was removed");
+    this.recovery = recovery;
+    this.name = "DiagnosticJournalRecoveryError";
+  }
+}
+
+// src/application/diagnostic-journal-contract.ts
+import { z as z3 } from "zod";
+var PositiveSafeIntegerSchema = z3.number().int().positive();
+var FileModeSchema = z3.number().int().min(0).max(511);
+var DiagnosticJournalLimitsSchema2 = z3.object({
+  maxEventBytes: PositiveSafeIntegerSchema,
+  maxPendingItems: PositiveSafeIntegerSchema,
+  maxPendingBytes: PositiveSafeIntegerSchema,
+  maxFileBytes: PositiveSafeIntegerSchema,
+  maxFiles: PositiveSafeIntegerSchema
+}).strict().readonly();
+var DiagnosticJournalLockPolicySchema2 = z3.enum(["refuse", "reclaim-stale"]);
+var DiagnosticJournalStateSchema2 = z3.enum(["open", "draining", "closed", "failed"]);
+var DiagnosticJournalRefusalReasonSchema2 = z3.enum([
+  "closed",
+  "failed",
+  "invalid",
+  "oversized",
+  "item-capacity",
+  "byte-capacity"
+]);
+var DiagnosticJournalRefusalCountersSchema = z3.object({
+  closed: z3.number().int().nonnegative(),
+  failed: z3.number().int().nonnegative(),
+  invalid: z3.number().int().nonnegative(),
+  oversized: z3.number().int().nonnegative(),
+  "item-capacity": z3.number().int().nonnegative(),
+  "byte-capacity": z3.number().int().nonnegative()
+}).strict().readonly();
+var DiagnosticJournalFailurePhaseSchema2 = z3.enum(["write", "rotation", "close"]);
+var DiagnosticJournalStatusSchema2 = z3.object({
+  state: DiagnosticJournalStateSchema2,
+  epoch: z3.uuid(),
+  limits: DiagnosticJournalLimitsSchema2,
+  lock: z3.object({
+    policy: DiagnosticJournalLockPolicySchema2,
+    reclaimedStale: z3.boolean()
+  }).strict().readonly(),
+  received: z3.number().int().nonnegative(),
+  accepted: z3.number().int().nonnegative(),
+  refused: z3.number().int().nonnegative(),
+  refusals: DiagnosticJournalRefusalCountersSchema,
+  written: z3.number().int().nonnegative(),
+  failedRecords: z3.number().int().nonnegative(),
+  pendingItems: z3.number().int().nonnegative(),
+  pendingBytes: z3.number().int().nonnegative(),
+  inFlight: z3.boolean(),
+  rotations: z3.number().int().nonnegative(),
+  rotationFailures: z3.number().int().nonnegative(),
+  partialTails: z3.number().int().nonnegative(),
+  currentFileBytes: z3.number().int().nonnegative(),
+  retainedFiles: z3.number().int().nonnegative(),
+  recovery: DiagnosticJournalRecoveryStatusSchema2.optional(),
+  lastAcceptedSequence: z3.number().int().positive().optional(),
+  lastWrittenSequence: z3.number().int().positive().optional(),
+  lastSettledSequence: z3.number().int().positive().optional(),
+  lastFailure: z3.object({
+    phase: DiagnosticJournalFailurePhaseSchema2,
+    sequence: z3.number().int().positive().optional()
+  }).strict().readonly().optional()
+}).strict().readonly();
+var DiagnosticJournalSubmitResultSchema2 = z3.discriminatedUnion("outcome", [
+  z3.object({
+    outcome: z3.literal("accepted"),
+    epoch: z3.uuid(),
+    sequence: z3.number().int().positive()
+  }).strict().readonly(),
+  z3.object({
+    outcome: z3.literal("refused"),
+    reason: DiagnosticJournalRefusalReasonSchema2
+  }).strict().readonly()
+]);
+var DiagnosticJournalWaitResultSchema2 = z3.object({
+  outcome: z3.enum(["settled", "timed-out", "cancelled"]),
+  state: DiagnosticJournalStateSchema2,
+  throughSequence: z3.number().int().nonnegative(),
+  settledSequence: z3.number().int().nonnegative()
+}).strict().readonly();
+var DiagnosticJournalCloseResultSchema2 = z3.object({
+  outcome: z3.enum(["closed", "timed-out", "cancelled"]),
+  state: DiagnosticJournalStateSchema2,
+  pendingItems: z3.number().int().nonnegative()
+}).strict().readonly();
+function parseDiagnosticJournalMode(mode) {
+  return FileModeSchema.parse(mode ?? 384);
+}
+function readDiagnosticJournalLockDiagnosis2(error) {
+  if (!isRecord(error))
+    return;
+  const diagnosis = error.journalLock;
+  return isRecord(diagnosis) ? diagnosis : undefined;
+}
+
+export { DiagnosticJournalFrameSchema2, DiagnosticJournalAnomalySchema2, createDiagnosticJournalReadResultSchema2, DiagnosticJournalRecoveryStatusSchema2, DiagnosticJournalRecoveryError2, DiagnosticJournalLimitsSchema2, DiagnosticJournalLockPolicySchema2, DiagnosticJournalStateSchema2, DiagnosticJournalRefusalReasonSchema2, DiagnosticJournalFailurePhaseSchema2, DiagnosticJournalStatusSchema2, DiagnosticJournalSubmitResultSchema2, DiagnosticJournalWaitResultSchema2, DiagnosticJournalCloseResultSchema2, parseDiagnosticJournalMode, readDiagnosticJournalLockDiagnosis2 };

package/dist/{index-5107q189.js → index-zax7resm.js}

@@ -45,7 +45,19 @@ var ViewFileOutputSchema2 = z2.object({
   content: z2.array(McpMediaContentSchema2),
   errors: z2.array(ViewFileErrorSchema2)
 });
+function isTextList(value) {
+  if (!value.trimStart().startsWith("["))
+    return false;
+  try {
+    return Array.isArray(JSON.parse(value));
+  } catch {
+    return false;
+  }
+}
+var MediaPathSchema = z2.string().refine((value) => !isTextList(value), {
+  message: "paths is a list written as text — pass an array of paths or one path"
+});
 var ViewFileInputSchema2 = z2.object({
-  paths: z2.union([z2.string(), z2.array(z2.string()).max(MAX_VIEW_FILES)]).describe("Media URL(s) or file path(s) to view")
+  paths: z2.union([MediaPathSchema, z2.array(MediaPathSchema).max(MAX_VIEW_FILES)]).describe("One media URL or file path, or an array of them. Pass the array itself, not JSON written as text.")
 });
 export { AsyncOperationCancelResultSchema2, createAsyncOperationSnapshotSchema2, McpAnnotationsSchema2, McpMediaContentSchema2, ViewFileErrorSchema2, ViewFileOutputSchema2, ViewFileInputSchema2 };

package/dist/tools/transfer/view-file-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-file-contract.d.ts","sourceRoot":"","sources":["../../../src/tools/transfer/view-file-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qFAAqF;AACrF,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;iBAG/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;2BAchC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,mBAAmB;;iBAI9B,CAAC"}
+{"version":3,"file":"view-file-contract.d.ts","sourceRoot":"","sources":["../../../src/tools/transfer/view-file-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qFAAqF;AACrF,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;iBAG/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;2BAchC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAgBlE,eAAO,MAAM,mBAAmB;;iBAM9B,CAAC"}

package/dist/tools/transfer/view-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-file.d.ts","sourceRoot":"","sources":["../../../src/tools/transfer/view-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAwB,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,eAAe,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,KAAK,mBAAmB,EAAoB,MAAM,sBAAsB,CAAC;AAwBlF,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoKD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC,OAAO,CAAC,EACpD,OAAO,GAAE,eAAoB,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAuBzB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI,CAgBpF"}
+{"version":3,"file":"view-file.d.ts","sourceRoot":"","sources":["../../../src/tools/transfer/view-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAwB,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,eAAe,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,KAAK,mBAAmB,EAAoB,MAAM,sBAAsB,CAAC;AAwBlF,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAyKD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC,OAAO,CAAC,EACpD,OAAO,GAAE,eAAoB,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAuBzB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI,CAgBpF"}

package/llms/application-diagnostic-journal.txt

@@ -17,6 +17,8 @@ Also read:
 | Export | Kind | Summary |
 |--------|------|---------|
 | `createDiagnosticJournal` | function | the bounded local journal: a file lock, a spawn to diagnose a stale one, and framed writes |
+| `readDiagnosticJournal` | function | bounded async stream of validated frames and explicit anomalies from finite snapshots of caller-selected files; I/O failures throw |
+| `DiagnosticJournalReaderConfig` | _type_ | normalized absolute `paths`, owner `eventSchema`, positive safe-integer `maxLineBytes` and optional cancellation `signal` |
 
 Its own entrypoint because of what it reaches — `node:child_process`,
 `node:fs`, `node:os`, `node:util` — with `promisify(execFile)` evaluated while