@geminixiang/mikan 1.0.0-beta.76 → 1.0.0-beta.78

package/dist/events/index.d.ts

@@ -6,23 +6,12 @@ export interface EventRecord {
     size: number;
     mtimeMs: number;
 }
-/**
- * One office's admitted scheduled work. Every method is confined to that
- * office: filenames of other offices read as "not found", and payloads must
- * address the store's own office.
- */
 export interface EventStore {
     readonly address: OfficeAddress;
-    /** Create a new record; an existing filename is an error, never overwritten. */
     create(filename: string, payload: EventFilePayload): Promise<{
         path: string;
         size: number;
     }>;
-    /**
-     * List this office's records. Entries whose JSON cannot be parsed or fail
-     * format validation are kept with a `null` payload so operators can still
-     * surface and delete them; files that disappear mid-listing are skipped.
-     */
     list(): Promise<Array<Omit<EventRecord, "payload"> & {
         payload: EventFilePayload | null;
     }>>;
@@ -35,7 +24,6 @@ export interface EventStore {
         deleted: boolean;
     }>;
 }
-/** Scheduler hooks the store calls after each admitted mutation. */
 export interface EventScheduleSink {
     scheduleRecord(address: OfficeAddress, record: EventRecord): void;
     cancelRecord(address: OfficeAddress, filename: string): void;
@@ -43,12 +31,10 @@ export interface EventScheduleSink {
 export type EventConversationKind = "direct" | "shared";
 export type EventType = "immediate" | "one-shot" | "periodic";
 interface EventPayloadBase {
-    /** Target platform; may be omitted when only one platform is running. */
     platform?: string;
     conversationId: string;
     conversationKind?: EventConversationKind;
     userId?: string;
-    /** Self-contained task text; event runs do not inherit conversation history. */
     text: string;
 }
 export interface ImmediateEventPayload extends EventPayloadBase {
@@ -56,17 +42,13 @@ export interface ImmediateEventPayload extends EventPayloadBase {
 }
 export interface OneShotEventPayload extends EventPayloadBase {
     type: "one-shot";
-    /** ISO 8601 timestamp with offset. */
     at: string;
 }
 export interface PeriodicEventPayload extends EventPayloadBase {
     type: "periodic";
-    /** Cron expression (croner syntax). */
     schedule: string;
-    /** IANA timezone, e.g. "Asia/Taipei". */
     timezone: string;
 }
-/** Wire shape of one event file. */
 export type EventFilePayload = ImmediateEventPayload | OneShotEventPayload | PeriodicEventPayload;
 export interface EventPayloadInput {
     type: EventType;
@@ -94,38 +76,11 @@ export interface PeriodicEventInfo {
     timezone: string;
     nextRun: string | null;
 }
-/**
- * Single home for the scheduled-event file format (`events/*.json`, the
- * workspace scheduling bus). Every reader and writer — the EventsWatcher
- * scheduler and the agent `event` tool — must go
- * through this module: one schema, one payload union, one parser, one
- * builder. Per-type field rules (`at` for one-shot, `schedule` + `timezone`
- * for periodic) live here and nowhere else.
- */
-/** Typebox union for the `type` field, shared by the file schema and the event tool's parameters. */
 export declare const EventTypeSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"immediate">, import("@sinclair/typebox").TLiteral<"one-shot">, import("@sinclair/typebox").TLiteral<"periodic">]>;
-/** True for a complete ISO 8601 timestamp that carries an explicit UTC offset. */
-/**
- * Validate an untrusted event filename: a bare `*.json` basename with no
- * path traversal. Every surface that touches the events bus by filename
- * (the event tool's store, the admin portal's file endpoints) validates
- * through this single rule.
- */
 export declare function validateEventFilename(filename: string): string;
-/**
- * Parse and validate one event file's content into the canonical payload.
- * `filename` appears in error messages. Throws on malformed JSON, wrong
- * field types, and missing required fields (common and per-type).
- */
 export declare function parseEventPayload(content: string, filename: string): EventFilePayload;
-/**
- * Validate and assemble a new event payload for writing. Owns the per-type
- * field rules; write-side *policy* beyond the format (e.g. the event tool's
- * requirement that `at` lies in the future) stays with the writer.
- */
 export declare function buildEventPayload(input: EventPayloadInput): EventFilePayload;
 import type { Office, Workspace } from "../office/index.js";
-/** Host-only per-office events directory: `<office state dir>/events`. */
 export declare function officeEventsDir(office: Office): string;
 export declare class OfficeEventStore implements EventStore {
     private readonly office;
@@ -161,12 +116,6 @@ export interface LegacyEventMigrationReport {
         reason: string;
     }[];
 }
-/**
- * One-time move of legacy `<workspace>/events/*.json` records into the owning
- * office's host-only state. Only records with an explicit platform matching a
- * registered office move; everything else stays for an operator to inspect.
- * Run with the daemon stopped.
- */
 export declare function migrateLegacyWorkspaceEvents(workspace: Workspace): LegacyEventMigrationReport;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

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

package/dist/events/index.js

@@ -1,24 +1,10 @@
 import { Type } from "@sinclair/typebox";
 import { parseJsonSchemaValue } from "../file-guards.js";
-/**
- * Single home for the scheduled-event file format (`events/*.json`, the
- * workspace scheduling bus). Every reader and writer — the EventsWatcher
- * scheduler and the agent `event` tool — must go
- * through this module: one schema, one payload union, one parser, one
- * builder. Per-type field rules (`at` for one-shot, `schedule` + `timezone`
- * for periodic) live here and nowhere else.
- */
-/** Typebox union for the `type` field, shared by the file schema and the event tool's parameters. */
 export const EventTypeSchema = Type.Union([
     Type.Literal("immediate"),
     Type.Literal("one-shot"),
     Type.Literal("periodic"),
 ]);
-/**
- * Lenient file-reading schema: every field optional so shape problems surface
- * as the specific missing-field messages below rather than typebox noise.
- * `channelId` is the legacy alias for `conversationId`.
- */
 const EventFileSchema = Type.Object({
     type: Type.Optional(EventTypeSchema),
     platform: Type.Optional(Type.String()),
@@ -39,13 +25,6 @@ function daysInMonth(year, month) {
     }
     return month === 4 || month === 6 || month === 9 || month === 11 ? 30 : 31;
 }
-/** True for a complete ISO 8601 timestamp that carries an explicit UTC offset. */
-/**
- * Validate an untrusted event filename: a bare `*.json` basename with no
- * path traversal. Every surface that touches the events bus by filename
- * (the event tool's store, the admin portal's file endpoints) validates
- * through this single rule.
- */
 export function validateEventFilename(filename) {
     const trimmed = filename.trim();
     if (!trimmed ||
@@ -85,17 +64,10 @@ function isValidIsoTimestampWithOffset(value) {
         offsetMinute <= 59 &&
         Number.isFinite(Date.parse(value)));
 }
-/**
- * Parse and validate one event file's content into the canonical payload.
- * `filename` appears in error messages. Throws on malformed JSON, wrong
- * field types, and missing required fields (common and per-type).
- */
 export function parseEventPayload(content, filename) {
     const data = parseJsonSchemaValue(content, EventFileSchema, (detail) => detail === "unexpected JSON shape"
         ? `Expected top-level JSON object in ${filename}`
         : `Malformed event file ${filename}: ${detail}`);
-    // `channelId` is the legacy alias; parsed payloads expose only the
-    // canonical `conversationId` field.
     const conversationId = typeof data.conversationId === "string"
         ? data.conversationId
         : typeof data.channelId === "string"
@@ -133,11 +105,6 @@ export function parseEventPayload(content, filename) {
             return { type, ...base, schedule: data.schedule, timezone: data.timezone };
     }
 }
-/**
- * Validate and assemble a new event payload for writing. Owns the per-type
- * field rules; write-side *policy* beyond the format (e.g. the event tool's
- * requirement that `at` lies in the future) stays with the writer.
- */
 export function buildEventPayload(input) {
     const base = {
         ...(input.platform !== undefined ? { platform: input.platform } : {}),
@@ -173,7 +140,6 @@ import { mkdir, readdir, readFile, rm, stat } from "node:fs/promises";
 import { join } from "node:path";
 import { atomicWritePrivateFile } from "../file-guards.js";
 import { createOfficeAddress, listRegisteredOffices, officeKey } from "../office/index.js";
-/** Host-only per-office events directory: `<office state dir>/events`. */
 export function officeEventsDir(office) {
     return join(office.stateDir, "events");
 }
@@ -250,7 +216,6 @@ export class OfficeEventStore {
         if (!existsSync(filePath)) {
             throw new Error(`Event ${safeFilename} not found in the current office`);
         }
-        // Cancel before removing so no timer can fire for a record being deleted.
         this.scheduler?.cancelRecord(this.address, safeFilename);
         await rm(filePath, { force: true });
         return { deleted: true };
@@ -275,12 +240,6 @@ export class OfficeEventStore {
         return { path: filePath, size: fileStat.size };
     }
 }
-/**
- * One-time move of legacy `<workspace>/events/*.json` records into the owning
- * office's host-only state. Only records with an explicit platform matching a
- * registered office move; everything else stays for an operator to inspect.
- * Run with the daemon stopped.
- */
 export function migrateLegacyWorkspaceEvents(workspace) {
     const report = { migrated: [], skipped: [] };
     const legacyDir = join(workspace.root, "events");
@@ -330,7 +289,6 @@ export function migrateLegacyWorkspaceEvents(workspace) {
             report.skipped.push({ filename, reason: `already exists in ${key}` });
             continue;
         }
-        // Rewrite instead of rename so the record gets host-private permissions.
         atomicWritePrivateFile(target, JSON.stringify(payload) + "\n");
         rmSync(source);
         report.migrated.push({ filename, key });

package/dist/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { OfficeAddress, OfficeKey } from \"../types.js\";\n\nexport type EventPayload = EventFilePayload;\n\nexport interface EventRecord {\n  filename: string;\n  payload: EventFilePayload;\n  size: number;\n  mtimeMs: number;\n}\n\n/**\n * One office's admitted scheduled work. Every method is confined to that\n * office: filenames of other offices read as \"not found\", and payloads must\n * address the store's own office.\n */\nexport interface EventStore {\n  readonly address: OfficeAddress;\n  /** Create a new record; an existing filename is an error, never overwritten. */\n  create(filename: string, payload: EventFilePayload): Promise<{ path: string; size: number }>;\n  /**\n   * List this office's records. Entries whose JSON cannot be parsed or fail\n   * format validation are kept with a `null` payload so operators can still\n   * surface and delete them; files that disappear mid-listing are skipped.\n   */\n  list(): Promise<Array<Omit<EventRecord, \"payload\"> & { payload: EventFilePayload | null }>>;\n  read(filename: string): Promise<EventRecord>;\n  update(filename: string, payload: EventFilePayload): Promise<{ path: string; size: number }>;\n  delete(filename: string): Promise<{ deleted: boolean }>;\n}\n\n/** Scheduler hooks the store calls after each admitted mutation. */\nexport interface EventScheduleSink {\n  scheduleRecord(address: OfficeAddress, record: EventRecord): void;\n  cancelRecord(address: OfficeAddress, filename: string): void;\n}\n\nexport type EventConversationKind = \"direct\" | \"shared\";\n\nexport type EventType = \"immediate\" | \"one-shot\" | \"periodic\";\n\ninterface EventPayloadBase {\n  /** Target platform; may be omitted when only one platform is running. */\n  platform?: string;\n  conversationId: string;\n  conversationKind?: EventConversationKind;\n  userId?: string;\n  /** Self-contained task text; event runs do not inherit conversation history. */\n  text: string;\n}\n\nexport interface ImmediateEventPayload extends EventPayloadBase {\n  type: \"immediate\";\n}\n\nexport interface OneShotEventPayload extends EventPayloadBase {\n  type: \"one-shot\";\n  /** ISO 8601 timestamp with offset. */\n  at: string;\n}\n\nexport interface PeriodicEventPayload extends EventPayloadBase {\n  type: \"periodic\";\n  /** Cron expression (croner syntax). */\n  schedule: string;\n  /** IANA timezone, e.g. \"Asia/Taipei\". */\n  timezone: string;\n}\n\n/** Wire shape of one event file. */\nexport type EventFilePayload = ImmediateEventPayload | OneShotEventPayload | PeriodicEventPayload;\n\nexport interface EventPayloadInput {\n  type: EventType;\n  platform?: string;\n  conversationId: string;\n  conversationKind?: EventConversationKind;\n  userId?: string;\n  text: string;\n  at?: string;\n  schedule?: string;\n  timezone?: string;\n}\n\n// Resolved runtime shapes: the watcher fills in the platform default and\n// infers the conversation kind before an event reaches a bot.\ninterface ResolvedEventFields {\n  platform: string;\n  conversationKind: EventConversationKind;\n}\n\nexport type MikanEvent =\n  | (ImmediateEventPayload & ResolvedEventFields)\n  | (OneShotEventPayload & ResolvedEventFields)\n  | (PeriodicEventPayload & ResolvedEventFields);\n\nexport interface PeriodicEventInfo {\n  filename: string;\n  platform: string;\n  conversationId: string;\n  conversationKind: EventConversationKind;\n  text: string;\n  schedule: string;\n  timezone: string;\n  nextRun: string | null;\n}\n\nimport { type Static, Type } from \"@sinclair/typebox\";\nimport { parseJsonSchemaValue } from \"../file-guards.js\";\n\n/**\n * Single home for the scheduled-event file format (`events/*.json`, the\n * workspace scheduling bus). Every reader and writer — the EventsWatcher\n * scheduler and the agent `event` tool — must go\n * through this module: one schema, one payload union, one parser, one\n * builder. Per-type field rules (`at` for one-shot, `schedule` + `timezone`\n * for periodic) live here and nowhere else.\n */\n\n/** Typebox union for the `type` field, shared by the file schema and the event tool's parameters. */\nexport const EventTypeSchema = Type.Union([\n  Type.Literal(\"immediate\"),\n  Type.Literal(\"one-shot\"),\n  Type.Literal(\"periodic\"),\n]);\n\n/**\n * Lenient file-reading schema: every field optional so shape problems surface\n * as the specific missing-field messages below rather than typebox noise.\n * `channelId` is the legacy alias for `conversationId`.\n */\nconst EventFileSchema = Type.Object({\n  type: Type.Optional(EventTypeSchema),\n  platform: Type.Optional(Type.String()),\n  conversationId: Type.Optional(Type.String()),\n  channelId: Type.Optional(Type.String()),\n  conversationKind: Type.Optional(Type.Union([Type.Literal(\"direct\"), Type.Literal(\"shared\")])),\n  userId: Type.Optional(Type.String()),\n  text: Type.Optional(Type.String()),\n  at: Type.Optional(Type.String()),\n  schedule: Type.Optional(Type.String()),\n  timezone: Type.Optional(Type.String()),\n});\n\ntype EventFileData = Static<typeof EventFileSchema>;\n\nconst ISO_TIMESTAMP_WITH_OFFSET =\n  /^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d+)?)?(Z|[+-](\\d{2}):(\\d{2}))$/;\n\nfunction daysInMonth(year: number, month: number): number {\n  if (month === 2) {\n    const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);\n    return leapYear ? 29 : 28;\n  }\n  return month === 4 || month === 6 || month === 9 || month === 11 ? 30 : 31;\n}\n\n/** True for a complete ISO 8601 timestamp that carries an explicit UTC offset. */\n/**\n * Validate an untrusted event filename: a bare `*.json` basename with no\n * path traversal. Every surface that touches the events bus by filename\n * (the event tool's store, the admin portal's file endpoints) validates\n * through this single rule.\n */\nexport function validateEventFilename(filename: string): string {\n  const trimmed = filename.trim();\n  if (\n    !trimmed ||\n    trimmed.includes(\"/\") ||\n    trimmed.includes(\"\\\\\") ||\n    trimmed.includes(\"..\") ||\n    !trimmed.endsWith(\".json\")\n  ) {\n    throw new Error(\"Invalid event filename\");\n  }\n  return trimmed;\n}\n\nfunction isValidIsoTimestampWithOffset(value: string): boolean {\n  const match = ISO_TIMESTAMP_WITH_OFFSET.exec(value);\n  if (!match) return false;\n\n  const year = Number(match[1]);\n  const month = Number(match[2]);\n  const day = Number(match[3]);\n  const hour = Number(match[4]);\n  const minute = Number(match[5]);\n  const second = match[6] === undefined ? 0 : Number(match[6]);\n  const offsetHour = match[8] === undefined ? 0 : Number(match[8]);\n  const offsetMinute = match[9] === undefined ? 0 : Number(match[9]);\n\n  return (\n    month >= 1 &&\n    month <= 12 &&\n    day >= 1 &&\n    day <= daysInMonth(year, month) &&\n    hour >= 0 &&\n    hour <= 23 &&\n    minute >= 0 &&\n    minute <= 59 &&\n    second >= 0 &&\n    second <= 59 &&\n    offsetHour >= 0 &&\n    offsetHour <= 23 &&\n    offsetMinute >= 0 &&\n    offsetMinute <= 59 &&\n    Number.isFinite(Date.parse(value))\n  );\n}\n\n/**\n * Parse and validate one event file's content into the canonical payload.\n * `filename` appears in error messages. Throws on malformed JSON, wrong\n * field types, and missing required fields (common and per-type).\n */\nexport function parseEventPayload(content: string, filename: string): EventFilePayload {\n  const data: EventFileData = parseJsonSchemaValue(content, EventFileSchema, (detail) =>\n    detail === \"unexpected JSON shape\"\n      ? `Expected top-level JSON object in ${filename}`\n      : `Malformed event file ${filename}: ${detail}`,\n  );\n  // `channelId` is the legacy alias; parsed payloads expose only the\n  // canonical `conversationId` field.\n  const conversationId =\n    typeof data.conversationId === \"string\"\n      ? data.conversationId\n      : typeof data.channelId === \"string\"\n        ? data.channelId\n        : undefined;\n  const { type, text } = data;\n\n  if (!type || !conversationId || !text) {\n    throw new Error(`Missing required fields (type, conversationId, text) in ${filename}`);\n  }\n\n  const base = {\n    ...(data.platform !== undefined ? { platform: data.platform } : {}),\n    conversationId,\n    ...(data.conversationKind !== undefined ? { conversationKind: data.conversationKind } : {}),\n    ...(data.userId !== undefined ? { userId: data.userId } : {}),\n    text,\n  };\n\n  switch (type) {\n    case \"immediate\":\n      return { type, ...base };\n\n    case \"one-shot\":\n      if (typeof data.at !== \"string\" || data.at.length === 0) {\n        throw new Error(`Missing 'at' field for one-shot event in ${filename}`);\n      }\n      if (!isValidIsoTimestampWithOffset(data.at)) {\n        throw new Error(\n          `Invalid 'at' field for one-shot event in ${filename}: expected a valid ISO 8601 timestamp with UTC offset`,\n        );\n      }\n      return { type, ...base, at: data.at };\n\n    case \"periodic\":\n      if (typeof data.schedule !== \"string\" || data.schedule.length === 0) {\n        throw new Error(`Missing 'schedule' field for periodic event in ${filename}`);\n      }\n      if (typeof data.timezone !== \"string\" || data.timezone.length === 0) {\n        throw new Error(`Missing 'timezone' field for periodic event in ${filename}`);\n      }\n      return { type, ...base, schedule: data.schedule, timezone: data.timezone };\n  }\n}\n\n/**\n * Validate and assemble a new event payload for writing. Owns the per-type\n * field rules; write-side *policy* beyond the format (e.g. the event tool's\n * requirement that `at` lies in the future) stays with the writer.\n */\nexport function buildEventPayload(input: EventPayloadInput): EventFilePayload {\n  const base = {\n    ...(input.platform !== undefined ? { platform: input.platform } : {}),\n    conversationId: input.conversationId,\n    ...(input.conversationKind !== undefined ? { conversationKind: input.conversationKind } : {}),\n    ...(input.userId !== undefined ? { userId: input.userId } : {}),\n    text: input.text,\n  };\n\n  switch (input.type) {\n    case \"immediate\":\n      return { type: \"immediate\", ...base };\n\n    case \"one-shot\": {\n      if (!input.at) {\n        throw new Error(\"`at` is required for one-shot events\");\n      }\n      if (!isValidIsoTimestampWithOffset(input.at)) {\n        throw new Error(\"`at` must be a valid ISO 8601 timestamp with UTC offset\");\n      }\n      return { type: \"one-shot\", ...base, at: input.at };\n    }\n\n    case \"periodic\":\n      if (!input.schedule) {\n        throw new Error(\"`schedule` is required for periodic events\");\n      }\n      if (!input.timezone) {\n        throw new Error(\"`timezone` is required for periodic events\");\n      }\n      return { type: \"periodic\", ...base, schedule: input.schedule, timezone: input.timezone };\n  }\n}\n\nimport { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync } from \"node:fs\";\nimport { mkdir, readdir, readFile, rm, stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { atomicWritePrivateFile } from \"../file-guards.js\";\nimport type { Office, Workspace } from \"../office/index.js\";\nimport { createOfficeAddress, listRegisteredOffices, officeKey } from \"../office/index.js\";\n\n/** Host-only per-office events directory: `<office state dir>/events`. */\nexport function officeEventsDir(office: Office): string {\n  return join(office.stateDir, \"events\");\n}\n\nexport class OfficeEventStore implements EventStore {\n  readonly address: OfficeAddress;\n  private readonly eventsDir: string;\n\n  constructor(\n    private readonly office: Office,\n    private readonly scheduler?: EventScheduleSink,\n  ) {\n    this.address = office.address;\n    this.eventsDir = officeEventsDir(office);\n  }\n\n  async create(filename: string, payload: EventPayload): Promise<{ path: string; size: number }> {\n    const safeFilename = validateEventFilename(filename);\n    this.assertOwnPayload(payload);\n    const filePath = join(this.eventsDir, safeFilename);\n    if (existsSync(filePath)) {\n      throw new Error(`Event ${safeFilename} already exists`);\n    }\n    return this.writeRecord(safeFilename, payload);\n  }\n\n  async list(): Promise<Array<Omit<EventRecord, \"payload\"> & { payload: EventPayload | null }>> {\n    if (!existsSync(this.eventsDir)) return [];\n    const entries = await readdir(this.eventsDir, { withFileTypes: true });\n    const events = await Promise.all(\n      entries\n        .filter((entry) => entry.isFile() && entry.name.endsWith(\".json\"))\n        .map(async (entry) => {\n          try {\n            return await this.read(entry.name);\n          } catch {\n            try {\n              const fileStat = await stat(join(this.eventsDir, entry.name));\n              return {\n                filename: entry.name,\n                payload: null,\n                size: fileStat.size,\n                mtimeMs: fileStat.mtimeMs,\n              };\n            } catch {\n              return null;\n            }\n          }\n        }),\n    );\n    return events\n      .filter((event) => event !== null)\n      .toSorted((a, b) => a.filename.localeCompare(b.filename));\n  }\n\n  async read(filename: string): Promise<EventRecord> {\n    const safeFilename = validateEventFilename(filename);\n    const filePath = join(this.eventsDir, safeFilename);\n    if (!existsSync(filePath)) {\n      throw new Error(`Event ${safeFilename} not found in the current office`);\n    }\n    const [raw, fileStat] = await Promise.all([readFile(filePath, \"utf-8\"), stat(filePath)]);\n    return {\n      filename: safeFilename,\n      payload: parseEventPayload(raw, safeFilename),\n      size: fileStat.size,\n      mtimeMs: fileStat.mtimeMs,\n    };\n  }\n\n  async update(filename: string, payload: EventPayload): Promise<{ path: string; size: number }> {\n    const safeFilename = validateEventFilename(filename);\n    this.assertOwnPayload(payload);\n    if (!existsSync(join(this.eventsDir, safeFilename))) {\n      throw new Error(`Event ${safeFilename} not found in the current office`);\n    }\n    return this.writeRecord(safeFilename, payload);\n  }\n\n  async delete(filename: string): Promise<{ deleted: boolean }> {\n    const safeFilename = validateEventFilename(filename);\n    const filePath = join(this.eventsDir, safeFilename);\n    if (!existsSync(filePath)) {\n      throw new Error(`Event ${safeFilename} not found in the current office`);\n    }\n    // Cancel before removing so no timer can fire for a record being deleted.\n    this.scheduler?.cancelRecord(this.address, safeFilename);\n    await rm(filePath, { force: true });\n    return { deleted: true };\n  }\n\n  private assertOwnPayload(payload: EventPayload): void {\n    if (\n      payload.platform !== this.address.platform ||\n      payload.conversationId !== this.address.conversationId\n    ) {\n      throw new Error(\"Event payload must address the current office\");\n    }\n  }\n\n  private async writeRecord(\n    safeFilename: string,\n    payload: EventPayload,\n  ): Promise<{ path: string; size: number }> {\n    await mkdir(this.eventsDir, { recursive: true });\n    const filePath = join(this.eventsDir, safeFilename);\n    atomicWritePrivateFile(filePath, JSON.stringify(payload) + \"\\n\");\n    const fileStat = await stat(filePath);\n    this.scheduler?.scheduleRecord(this.address, {\n      filename: safeFilename,\n      payload,\n      size: fileStat.size,\n      mtimeMs: fileStat.mtimeMs,\n    });\n    return { path: filePath, size: fileStat.size };\n  }\n}\n\nexport interface LegacyEventMigrationReport {\n  migrated: { filename: string; key: OfficeKey }[];\n  skipped: { filename: string; reason: string }[];\n}\n\n/**\n * One-time move of legacy `<workspace>/events/*.json` records into the owning\n * office's host-only state. Only records with an explicit platform matching a\n * registered office move; everything else stays for an operator to inspect.\n * Run with the daemon stopped.\n */\nexport function migrateLegacyWorkspaceEvents(workspace: Workspace): LegacyEventMigrationReport {\n  const report: LegacyEventMigrationReport = { migrated: [], skipped: [] };\n  const legacyDir = join(workspace.root, \"events\");\n  if (!existsSync(legacyDir)) return report;\n  const registered = new Set(\n    listRegisteredOffices(workspace.stateDir).map((record) => officeKey(record)),\n  );\n  for (const filename of readdirSync(legacyDir).filter((name) => name.endsWith(\".json\"))) {\n    const source = join(legacyDir, filename);\n    if (!statSync(source).isFile()) continue;\n    let payload: EventFilePayload;\n    try {\n      payload = parseEventPayload(readFileSync(source, \"utf-8\"), filename);\n    } catch (error) {\n      report.skipped.push({\n        filename,\n        reason: error instanceof Error ? error.message : String(error),\n      });\n      continue;\n    }\n    if (!payload.platform) {\n      report.skipped.push({ filename, reason: \"no platform; owner cannot be attributed\" });\n      continue;\n    }\n    let address: OfficeAddress;\n    try {\n      address = createOfficeAddress(\n        payload.platform as OfficeAddress[\"platform\"],\n        payload.conversationId,\n      );\n    } catch (error) {\n      report.skipped.push({\n        filename,\n        reason: error instanceof Error ? error.message : String(error),\n      });\n      continue;\n    }\n    const key = officeKey(address);\n    if (!registered.has(key)) {\n      report.skipped.push({ filename, reason: `office ${key} is not registered` });\n      continue;\n    }\n    const office = workspace.office(address);\n    const targetDir = officeEventsDir(office);\n    mkdirSync(targetDir, { recursive: true });\n    const target = join(targetDir, filename);\n    if (existsSync(target)) {\n      report.skipped.push({ filename, reason: `already exists in ${key}` });\n      continue;\n    }\n    // Rewrite instead of rename so the record gets host-private permissions.\n    atomicWritePrivateFile(target, JSON.stringify(payload) + \"\\n\");\n    rmSync(source);\n    report.migrated.push({ filename, key });\n  }\n  return report;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { OfficeAddress, OfficeKey } from \"../types.js\";\n\nexport type EventPayload = EventFilePayload;\n\nexport interface EventRecord {\n  filename: string;\n  payload: EventFilePayload;\n  size: number;\n  mtimeMs: number;\n}\n\nexport interface EventStore {\n  readonly address: OfficeAddress;\n  create(filename: string, payload: EventFilePayload): Promise<{ path: string; size: number }>;\n  list(): Promise<Array<Omit<EventRecord, \"payload\"> & { payload: EventFilePayload | null }>>;\n  read(filename: string): Promise<EventRecord>;\n  update(filename: string, payload: EventFilePayload): Promise<{ path: string; size: number }>;\n  delete(filename: string): Promise<{ deleted: boolean }>;\n}\n\nexport interface EventScheduleSink {\n  scheduleRecord(address: OfficeAddress, record: EventRecord): void;\n  cancelRecord(address: OfficeAddress, filename: string): void;\n}\n\nexport type EventConversationKind = \"direct\" | \"shared\";\n\nexport type EventType = \"immediate\" | \"one-shot\" | \"periodic\";\n\ninterface EventPayloadBase {\n  platform?: string;\n  conversationId: string;\n  conversationKind?: EventConversationKind;\n  userId?: string;\n  text: string;\n}\n\nexport interface ImmediateEventPayload extends EventPayloadBase {\n  type: \"immediate\";\n}\n\nexport interface OneShotEventPayload extends EventPayloadBase {\n  type: \"one-shot\";\n  at: string;\n}\n\nexport interface PeriodicEventPayload extends EventPayloadBase {\n  type: \"periodic\";\n  schedule: string;\n  timezone: string;\n}\n\nexport type EventFilePayload = ImmediateEventPayload | OneShotEventPayload | PeriodicEventPayload;\n\nexport interface EventPayloadInput {\n  type: EventType;\n  platform?: string;\n  conversationId: string;\n  conversationKind?: EventConversationKind;\n  userId?: string;\n  text: string;\n  at?: string;\n  schedule?: string;\n  timezone?: string;\n}\n\ninterface ResolvedEventFields {\n  platform: string;\n  conversationKind: EventConversationKind;\n}\n\nexport type MikanEvent =\n  | (ImmediateEventPayload & ResolvedEventFields)\n  | (OneShotEventPayload & ResolvedEventFields)\n  | (PeriodicEventPayload & ResolvedEventFields);\n\nexport interface PeriodicEventInfo {\n  filename: string;\n  platform: string;\n  conversationId: string;\n  conversationKind: EventConversationKind;\n  text: string;\n  schedule: string;\n  timezone: string;\n  nextRun: string | null;\n}\n\nimport { type Static, Type } from \"@sinclair/typebox\";\nimport { parseJsonSchemaValue } from \"../file-guards.js\";\n\nexport const EventTypeSchema = Type.Union([\n  Type.Literal(\"immediate\"),\n  Type.Literal(\"one-shot\"),\n  Type.Literal(\"periodic\"),\n]);\n\nconst EventFileSchema = Type.Object({\n  type: Type.Optional(EventTypeSchema),\n  platform: Type.Optional(Type.String()),\n  conversationId: Type.Optional(Type.String()),\n  channelId: Type.Optional(Type.String()),\n  conversationKind: Type.Optional(Type.Union([Type.Literal(\"direct\"), Type.Literal(\"shared\")])),\n  userId: Type.Optional(Type.String()),\n  text: Type.Optional(Type.String()),\n  at: Type.Optional(Type.String()),\n  schedule: Type.Optional(Type.String()),\n  timezone: Type.Optional(Type.String()),\n});\n\ntype EventFileData = Static<typeof EventFileSchema>;\n\nconst ISO_TIMESTAMP_WITH_OFFSET =\n  /^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d+)?)?(Z|[+-](\\d{2}):(\\d{2}))$/;\n\nfunction daysInMonth(year: number, month: number): number {\n  if (month === 2) {\n    const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);\n    return leapYear ? 29 : 28;\n  }\n  return month === 4 || month === 6 || month === 9 || month === 11 ? 30 : 31;\n}\n\nexport function validateEventFilename(filename: string): string {\n  const trimmed = filename.trim();\n  if (\n    !trimmed ||\n    trimmed.includes(\"/\") ||\n    trimmed.includes(\"\\\\\") ||\n    trimmed.includes(\"..\") ||\n    !trimmed.endsWith(\".json\")\n  ) {\n    throw new Error(\"Invalid event filename\");\n  }\n  return trimmed;\n}\n\nfunction isValidIsoTimestampWithOffset(value: string): boolean {\n  const match = ISO_TIMESTAMP_WITH_OFFSET.exec(value);\n  if (!match) return false;\n\n  const year = Number(match[1]);\n  const month = Number(match[2]);\n  const day = Number(match[3]);\n  const hour = Number(match[4]);\n  const minute = Number(match[5]);\n  const second = match[6] === undefined ? 0 : Number(match[6]);\n  const offsetHour = match[8] === undefined ? 0 : Number(match[8]);\n  const offsetMinute = match[9] === undefined ? 0 : Number(match[9]);\n\n  return (\n    month >= 1 &&\n    month <= 12 &&\n    day >= 1 &&\n    day <= daysInMonth(year, month) &&\n    hour >= 0 &&\n    hour <= 23 &&\n    minute >= 0 &&\n    minute <= 59 &&\n    second >= 0 &&\n    second <= 59 &&\n    offsetHour >= 0 &&\n    offsetHour <= 23 &&\n    offsetMinute >= 0 &&\n    offsetMinute <= 59 &&\n    Number.isFinite(Date.parse(value))\n  );\n}\n\nexport function parseEventPayload(content: string, filename: string): EventFilePayload {\n  const data: EventFileData = parseJsonSchemaValue(content, EventFileSchema, (detail) =>\n    detail === \"unexpected JSON shape\"\n      ? `Expected top-level JSON object in ${filename}`\n      : `Malformed event file ${filename}: ${detail}`,\n  );\n  const conversationId =\n    typeof data.conversationId === \"string\"\n      ? data.conversationId\n      : typeof data.channelId === \"string\"\n        ? data.channelId\n        : undefined;\n  const { type, text } = data;\n\n  if (!type || !conversationId || !text) {\n    throw new Error(`Missing required fields (type, conversationId, text) in ${filename}`);\n  }\n\n  const base = {\n    ...(data.platform !== undefined ? { platform: data.platform } : {}),\n    conversationId,\n    ...(data.conversationKind !== undefined ? { conversationKind: data.conversationKind } : {}),\n    ...(data.userId !== undefined ? { userId: data.userId } : {}),\n    text,\n  };\n\n  switch (type) {\n    case \"immediate\":\n      return { type, ...base };\n\n    case \"one-shot\":\n      if (typeof data.at !== \"string\" || data.at.length === 0) {\n        throw new Error(`Missing 'at' field for one-shot event in ${filename}`);\n      }\n      if (!isValidIsoTimestampWithOffset(data.at)) {\n        throw new Error(\n          `Invalid 'at' field for one-shot event in ${filename}: expected a valid ISO 8601 timestamp with UTC offset`,\n        );\n      }\n      return { type, ...base, at: data.at };\n\n    case \"periodic\":\n      if (typeof data.schedule !== \"string\" || data.schedule.length === 0) {\n        throw new Error(`Missing 'schedule' field for periodic event in ${filename}`);\n      }\n      if (typeof data.timezone !== \"string\" || data.timezone.length === 0) {\n        throw new Error(`Missing 'timezone' field for periodic event in ${filename}`);\n      }\n      return { type, ...base, schedule: data.schedule, timezone: data.timezone };\n  }\n}\n\nexport function buildEventPayload(input: EventPayloadInput): EventFilePayload {\n  const base = {\n    ...(input.platform !== undefined ? { platform: input.platform } : {}),\n    conversationId: input.conversationId,\n    ...(input.conversationKind !== undefined ? { conversationKind: input.conversationKind } : {}),\n    ...(input.userId !== undefined ? { userId: input.userId } : {}),\n    text: input.text,\n  };\n\n  switch (input.type) {\n    case \"immediate\":\n      return { type: \"immediate\", ...base };\n\n    case \"one-shot\": {\n      if (!input.at) {\n        throw new Error(\"`at` is required for one-shot events\");\n      }\n      if (!isValidIsoTimestampWithOffset(input.at)) {\n        throw new Error(\"`at` must be a valid ISO 8601 timestamp with UTC offset\");\n      }\n      return { type: \"one-shot\", ...base, at: input.at };\n    }\n\n    case \"periodic\":\n      if (!input.schedule) {\n        throw new Error(\"`schedule` is required for periodic events\");\n      }\n      if (!input.timezone) {\n        throw new Error(\"`timezone` is required for periodic events\");\n      }\n      return { type: \"periodic\", ...base, schedule: input.schedule, timezone: input.timezone };\n  }\n}\n\nimport { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync } from \"node:fs\";\nimport { mkdir, readdir, readFile, rm, stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { atomicWritePrivateFile } from \"../file-guards.js\";\nimport type { Office, Workspace } from \"../office/index.js\";\nimport { createOfficeAddress, listRegisteredOffices, officeKey } from \"../office/index.js\";\n\nexport function officeEventsDir(office: Office): string {\n  return join(office.stateDir, \"events\");\n}\n\nexport class OfficeEventStore implements EventStore {\n  readonly address: OfficeAddress;\n  private readonly eventsDir: string;\n\n  constructor(\n    private readonly office: Office,\n    private readonly scheduler?: EventScheduleSink,\n  ) {\n    this.address = office.address;\n    this.eventsDir = officeEventsDir(office);\n  }\n\n  async create(filename: string, payload: EventPayload): Promise<{ path: string; size: number }> {\n    const safeFilename = validateEventFilename(filename);\n    this.assertOwnPayload(payload);\n    const filePath = join(this.eventsDir, safeFilename);\n    if (existsSync(filePath)) {\n      throw new Error(`Event ${safeFilename} already exists`);\n    }\n    return this.writeRecord(safeFilename, payload);\n  }\n\n  async list(): Promise<Array<Omit<EventRecord, \"payload\"> & { payload: EventPayload | null }>> {\n    if (!existsSync(this.eventsDir)) return [];\n    const entries = await readdir(this.eventsDir, { withFileTypes: true });\n    const events = await Promise.all(\n      entries\n        .filter((entry) => entry.isFile() && entry.name.endsWith(\".json\"))\n        .map(async (entry) => {\n          try {\n            return await this.read(entry.name);\n          } catch {\n            try {\n              const fileStat = await stat(join(this.eventsDir, entry.name));\n              return {\n                filename: entry.name,\n                payload: null,\n                size: fileStat.size,\n                mtimeMs: fileStat.mtimeMs,\n              };\n            } catch {\n              return null;\n            }\n          }\n        }),\n    );\n    return events\n      .filter((event) => event !== null)\n      .toSorted((a, b) => a.filename.localeCompare(b.filename));\n  }\n\n  async read(filename: string): Promise<EventRecord> {\n    const safeFilename = validateEventFilename(filename);\n    const filePath = join(this.eventsDir, safeFilename);\n    if (!existsSync(filePath)) {\n      throw new Error(`Event ${safeFilename} not found in the current office`);\n    }\n    const [raw, fileStat] = await Promise.all([readFile(filePath, \"utf-8\"), stat(filePath)]);\n    return {\n      filename: safeFilename,\n      payload: parseEventPayload(raw, safeFilename),\n      size: fileStat.size,\n      mtimeMs: fileStat.mtimeMs,\n    };\n  }\n\n  async update(filename: string, payload: EventPayload): Promise<{ path: string; size: number }> {\n    const safeFilename = validateEventFilename(filename);\n    this.assertOwnPayload(payload);\n    if (!existsSync(join(this.eventsDir, safeFilename))) {\n      throw new Error(`Event ${safeFilename} not found in the current office`);\n    }\n    return this.writeRecord(safeFilename, payload);\n  }\n\n  async delete(filename: string): Promise<{ deleted: boolean }> {\n    const safeFilename = validateEventFilename(filename);\n    const filePath = join(this.eventsDir, safeFilename);\n    if (!existsSync(filePath)) {\n      throw new Error(`Event ${safeFilename} not found in the current office`);\n    }\n    this.scheduler?.cancelRecord(this.address, safeFilename);\n    await rm(filePath, { force: true });\n    return { deleted: true };\n  }\n\n  private assertOwnPayload(payload: EventPayload): void {\n    if (\n      payload.platform !== this.address.platform ||\n      payload.conversationId !== this.address.conversationId\n    ) {\n      throw new Error(\"Event payload must address the current office\");\n    }\n  }\n\n  private async writeRecord(\n    safeFilename: string,\n    payload: EventPayload,\n  ): Promise<{ path: string; size: number }> {\n    await mkdir(this.eventsDir, { recursive: true });\n    const filePath = join(this.eventsDir, safeFilename);\n    atomicWritePrivateFile(filePath, JSON.stringify(payload) + \"\\n\");\n    const fileStat = await stat(filePath);\n    this.scheduler?.scheduleRecord(this.address, {\n      filename: safeFilename,\n      payload,\n      size: fileStat.size,\n      mtimeMs: fileStat.mtimeMs,\n    });\n    return { path: filePath, size: fileStat.size };\n  }\n}\n\nexport interface LegacyEventMigrationReport {\n  migrated: { filename: string; key: OfficeKey }[];\n  skipped: { filename: string; reason: string }[];\n}\n\nexport function migrateLegacyWorkspaceEvents(workspace: Workspace): LegacyEventMigrationReport {\n  const report: LegacyEventMigrationReport = { migrated: [], skipped: [] };\n  const legacyDir = join(workspace.root, \"events\");\n  if (!existsSync(legacyDir)) return report;\n  const registered = new Set(\n    listRegisteredOffices(workspace.stateDir).map((record) => officeKey(record)),\n  );\n  for (const filename of readdirSync(legacyDir).filter((name) => name.endsWith(\".json\"))) {\n    const source = join(legacyDir, filename);\n    if (!statSync(source).isFile()) continue;\n    let payload: EventFilePayload;\n    try {\n      payload = parseEventPayload(readFileSync(source, \"utf-8\"), filename);\n    } catch (error) {\n      report.skipped.push({\n        filename,\n        reason: error instanceof Error ? error.message : String(error),\n      });\n      continue;\n    }\n    if (!payload.platform) {\n      report.skipped.push({ filename, reason: \"no platform; owner cannot be attributed\" });\n      continue;\n    }\n    let address: OfficeAddress;\n    try {\n      address = createOfficeAddress(\n        payload.platform as OfficeAddress[\"platform\"],\n        payload.conversationId,\n      );\n    } catch (error) {\n      report.skipped.push({\n        filename,\n        reason: error instanceof Error ? error.message : String(error),\n      });\n      continue;\n    }\n    const key = officeKey(address);\n    if (!registered.has(key)) {\n      report.skipped.push({ filename, reason: `office ${key} is not registered` });\n      continue;\n    }\n    const office = workspace.office(address);\n    const targetDir = officeEventsDir(office);\n    mkdirSync(targetDir, { recursive: true });\n    const target = join(targetDir, filename);\n    if (existsSync(target)) {\n      report.skipped.push({ filename, reason: `already exists in ${key}` });\n      continue;\n    }\n    atomicWritePrivateFile(target, JSON.stringify(payload) + \"\\n\");\n    rmSync(source);\n    report.migrated.push({ filename, key });\n  }\n  return report;\n}\n"]}

package/dist/events/scheduler.d.ts

@@ -3,13 +3,6 @@ import { type Workspace } from "../office/index.js";
 import type { OfficeAddress } from "../types.js";
 import { type EventRecord, type EventScheduleSink, type MikanEvent, type PeriodicEventInfo } from "./index.js";
 export type { MikanEvent, PeriodicEventInfo } from "./index.js";
-/**
- * In-memory timer/cron owner for every office's admitted events. Records are
- * loaded once from each registered office's host-only events directory at
- * start; afterwards the only inputs are {@link OfficeEventStore} mutations
- * through {@link EventScheduleSink}. There is no filesystem watcher: files
- * edited by hand take effect on the next start.
- */
 export declare class EventScheduler implements EventScheduleSink {
     private readonly workspace;
     private readonly botsByPlatform;
@@ -19,7 +12,6 @@ export declare class EventScheduler implements EventScheduleSink {
     start(): void;
     stop(): void;
     scheduledCount(): number;
-    /** Active periodic events of one office with their next run. */
     periodicEvents(address: OfficeAddress): PeriodicEventInfo[];
     scheduleRecord(address: OfficeAddress, record: EventRecord): void;
     cancelRecord(address: OfficeAddress, filename: string): void;

package/dist/events/scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/events/scheduler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,YAAY,EAAgB,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAUhE;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IAKpD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,SAAS,CAAc;IAE/B,YACmB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC3D;IAEJ,KAAK,IAAI,IAAI,CAuBZ;IAED,IAAI,IAAI,IAAI,CAOX;IAED,cAAc,IAAI,MAAM,CAEvB;IAED,gEAAgE;IAChE,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,EAAE,CAiB1D;IAED,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CA6ChE;IAED,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE3D;IAED,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,UAAU;CAUnB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAwB1D"}
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/events/scheduler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,YAAY,EAAgB,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAUhE,qBAAa,cAAe,YAAW,iBAAiB;IAKpD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,SAAS,CAAc;IAE/B,YACmB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC3D;IAEJ,KAAK,IAAI,IAAI,CAuBZ;IAED,IAAI,IAAI,IAAI,CAOX;IAED,cAAc,IAAI,MAAM,CAEvB;IAED,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,EAAE,CAiB1D;IAED,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CA6ChE;IAED,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE3D;IAED,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,UAAU;CAUnB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAwB1D"}

package/dist/events/scheduler.js

@@ -7,13 +7,6 @@ import { listRegisteredOffices, officeKey } from "../office/index.js";
 import { reportUserFacingError } from "../observability/index.js";
 import { inferConversationKind } from "../sessions/session-key.js";
 import { officeEventsDir, parseEventPayload, } from "./index.js";
-/**
- * In-memory timer/cron owner for every office's admitted events. Records are
- * loaded once from each registered office's host-only events directory at
- * start; afterwards the only inputs are {@link OfficeEventStore} mutations
- * through {@link EventScheduleSink}. There is no filesystem watcher: files
- * edited by hand take effect on the next start.
- */
 export class EventScheduler {
     constructor(workspace, botsByPlatform) {
         this.workspace = workspace;
@@ -56,7 +49,6 @@ export class EventScheduler {
     scheduledCount() {
         return this.scheduled.size;
     }
-    /** Active periodic events of one office with their next run. */
     periodicEvents(address) {
         const prefix = `${officeKey(address)}/`;
         const results = [];

package/dist/events/scheduler.js.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/events/scheduler.ts"],"names":[],"mappings":"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","sourcesContent":["import { Cron } from \"croner\";\nimport { existsSync, readdirSync, readFileSync, unlinkSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { createConversationEvent } from \"../adapters/index.js\";\nimport type { ConversationKind, MessagingBot, PlatformName } from \"../types.js\";\nimport * as log from \"../log.js\";\nimport { listRegisteredOffices, officeKey, type Workspace } from \"../office/index.js\";\nimport { reportUserFacingError } from \"../observability/index.js\";\nimport { inferConversationKind } from \"../sessions/session-key.js\";\nimport type { OfficeAddress } from \"../types.js\";\nimport {\n  officeEventsDir,\n  parseEventPayload,\n  type EventRecord,\n  type EventScheduleSink,\n  type MikanEvent,\n  type PeriodicEventInfo,\n} from \"./index.js\";\n\nexport type { MikanEvent, PeriodicEventInfo } from \"./index.js\";\n\ninterface Scheduled {\n  address: OfficeAddress;\n  filename: string;\n  event: MikanEvent;\n  timer?: NodeJS.Timeout;\n  cron?: Cron;\n}\n\n/**\n * In-memory timer/cron owner for every office's admitted events. Records are\n * loaded once from each registered office's host-only events directory at\n * start; afterwards the only inputs are {@link OfficeEventStore} mutations\n * through {@link EventScheduleSink}. There is no filesystem watcher: files\n * edited by hand take effect on the next start.\n */\nexport class EventScheduler implements EventScheduleSink {\n  private readonly scheduled = new Map<string, Scheduled>();\n  private startTime = Date.now();\n\n  constructor(\n    private readonly workspace: Workspace,\n    private readonly botsByPlatform: Record<string, MessagingBot>,\n  ) {}\n\n  start(): void {\n    this.startTime = Date.now();\n    let loaded = 0;\n    for (const record of listRegisteredOffices(this.workspace.stateDir)) {\n      const office = this.workspace.office(record);\n      const dir = officeEventsDir(office);\n      if (!existsSync(dir)) continue;\n      for (const filename of readdirSync(dir).filter((name) => name.endsWith(\".json\"))) {\n        const path = join(dir, filename);\n        try {\n          const payload = parseEventPayload(readFileSync(path, \"utf-8\"), filename);\n          this.scheduleRecord(office.address, { filename, payload, size: 0, mtimeMs: 0 });\n          loaded++;\n        } catch (error) {\n          log.logWarning(\n            `Removing unparseable event file ${filename} for ${office.key}`,\n            error instanceof Error ? error.message : String(error),\n          );\n          this.removeFile(office.address, filename);\n        }\n      }\n    }\n    log.logInfo(`Event scheduler started, tracking ${loaded} records`);\n  }\n\n  stop(): void {\n    for (const entry of this.scheduled.values()) {\n      if (entry.timer) clearTimeout(entry.timer);\n      entry.cron?.stop();\n    }\n    this.scheduled.clear();\n    log.logInfo(\"Event scheduler stopped\");\n  }\n\n  scheduledCount(): number {\n    return this.scheduled.size;\n  }\n\n  /** Active periodic events of one office with their next run. */\n  periodicEvents(address: OfficeAddress): PeriodicEventInfo[] {\n    const prefix = `${officeKey(address)}/`;\n    const results: PeriodicEventInfo[] = [];\n    for (const [key, entry] of this.scheduled) {\n      if (!key.startsWith(prefix) || entry.event.type !== \"periodic\" || !entry.cron) continue;\n      results.push({\n        filename: entry.filename,\n        platform: entry.event.platform,\n        conversationId: entry.event.conversationId,\n        conversationKind: entry.event.conversationKind,\n        text: entry.event.text,\n        schedule: entry.event.schedule,\n        timezone: entry.event.timezone,\n        nextRun: entry.cron.nextRun()?.toISOString() ?? null,\n      });\n    }\n    return results;\n  }\n\n  scheduleRecord(address: OfficeAddress, record: EventRecord): void {\n    const key = this.key(address, record.filename);\n    this.cancelKey(key);\n    let event: MikanEvent;\n    try {\n      event = this.resolve(record, address);\n    } catch (error) {\n      log.logWarning(\n        `Rejecting event ${record.filename}`,\n        error instanceof Error ? error.message : String(error),\n      );\n      this.removeFile(address, record.filename);\n      return;\n    }\n    const entry: Scheduled = { address, filename: record.filename, event };\n    switch (event.type) {\n      case \"immediate\":\n        this.execute(entry);\n        return;\n      case \"one-shot\": {\n        const delay = new Date(event.at).getTime() - Date.now();\n        if (delay <= 0) {\n          log.logInfo(`One-shot event in the past, deleting: ${record.filename}`);\n          this.removeFile(address, record.filename);\n          return;\n        }\n        entry.timer = setTimeout(() => {\n          this.scheduled.delete(key);\n          this.execute(entry);\n        }, delay);\n        this.scheduled.set(key, entry);\n        return;\n      }\n      case \"periodic\":\n        try {\n          entry.cron = new Cron(event.schedule, { timezone: event.timezone }, () =>\n            this.execute(entry, false),\n          );\n        } catch (error) {\n          log.logWarning(`Invalid cron schedule for ${record.filename}`, String(error));\n          this.removeFile(address, record.filename);\n          return;\n        }\n        this.scheduled.set(key, entry);\n    }\n  }\n\n  cancelRecord(address: OfficeAddress, filename: string): void {\n    this.cancelKey(this.key(address, filename));\n  }\n\n  private key(address: OfficeAddress, filename: string): string {\n    return `${officeKey(address)}/${filename}`;\n  }\n\n  private cancelKey(key: string): void {\n    const entry = this.scheduled.get(key);\n    if (!entry) return;\n    if (entry.timer) clearTimeout(entry.timer);\n    entry.cron?.stop();\n    this.scheduled.delete(key);\n  }\n\n  private resolve(record: EventRecord, address: OfficeAddress): MikanEvent {\n    const { payload } = record;\n    const platform = (payload.platform ?? address.platform).toLowerCase();\n    if (platform !== address.platform || payload.conversationId !== address.conversationId) {\n      throw new Error(\"event payload does not address its owning office\");\n    }\n    if (!this.botsByPlatform[platform]) {\n      throw new Error(`no bot configured for platform '${platform}'`);\n    }\n    const conversationKind: ConversationKind =\n      payload.conversationKind ?? inferConversationKind(platform, payload.conversationId);\n    return { ...payload, platform, conversationKind };\n  }\n\n  private execute(entry: Scheduled, deleteAfter = true): void {\n    const { event, filename, address } = entry;\n    const bot = this.botsByPlatform[event.platform];\n    if (!bot) {\n      this.reportFailure(entry, deleteAfter, \"missing_bot\");\n      if (deleteAfter) this.removeFile(address, filename);\n      return;\n    }\n    const enqueued = bot.enqueueEvent(\n      createConversationEvent({\n        platform: event.platform as PlatformName,\n        type: \"mention\",\n        conversationId: event.conversationId,\n        conversationKind: event.conversationKind,\n        user: event.userId ?? \"EVENT\",\n        text: buildEventPrompt(event),\n        ts: `event:${filename.replace(/\\.json$/i, \"\")}`,\n      }),\n    );\n    if (!enqueued) {\n      log.logWarning(`Event queue full, discarded: ${filename}`);\n      this.reportFailure(entry, deleteAfter, \"queue_full\");\n    }\n    if (deleteAfter) this.removeFile(address, filename);\n  }\n\n  private reportFailure(\n    entry: Scheduled,\n    deleteAfter: boolean,\n    failure: \"missing_bot\" | \"queue_full\",\n  ): void {\n    const reason = failure === \"missing_bot\" ? \"missing bot\" : \"queue full\";\n    reportUserFacingError(new Error(`Scheduled event delivery failed: ${reason}`), {\n      domain: \"events\",\n      surface: \"event_delivery\",\n      operation: \"event_execute\",\n      severity: \"error\",\n      platform: entry.event.platform,\n      context: {\n        failure,\n        filename: entry.filename,\n        eventType: entry.event.type,\n        conversationId: entry.event.conversationId,\n        conversationKind: entry.event.conversationKind,\n        deleteAfter,\n        triggeredByEventFile: true,\n        textLength: entry.event.text.length,\n      },\n    });\n  }\n\n  private removeFile(address: OfficeAddress, filename: string): void {\n    const path = join(officeEventsDir(this.workspace.office(address)), filename);\n    try {\n      unlinkSync(path);\n    } catch (error) {\n      if (error instanceof Error && \"code\" in error && error.code !== \"ENOENT\") {\n        log.logWarning(`Failed to delete event file: ${filename}`, String(error));\n      }\n    }\n  }\n}\n\nexport function buildEventPrompt(event: MikanEvent): string {\n  switch (event.type) {\n    case \"one-shot\":\n      return [\n        \"Please deliver the following reminder to the user in a short, natural way.\",\n        \"Do not greet, do not introduce yourself, and do not ask generic follow-up questions.\",\n        \"\",\n        `Reminder: ${event.text}`,\n      ].join(\"\\n\");\n    case \"periodic\":\n      return [\n        \"Handle the following recurring task.\",\n        \"Respond concisely. If there is nothing actionable to report, reply with [SILENT].\",\n        \"\",\n        `Task: ${event.text}`,\n      ].join(\"\\n\");\n    case \"immediate\":\n      return [\n        \"Handle the following event/update in a concise, context-appropriate way.\",\n        \"If it reads like a reminder or follow-up, deliver it directly without greeting or generic offers to help.\",\n        \"\",\n        `Event: ${event.text}`,\n      ].join(\"\\n\");\n  }\n}\n"]}
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/events/scheduler.ts"],"names":[],"mappings":"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","sourcesContent":["import { Cron } from \"croner\";\nimport { existsSync, readdirSync, readFileSync, unlinkSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { createConversationEvent } from \"../adapters/index.js\";\nimport type { ConversationKind, MessagingBot, PlatformName } from \"../types.js\";\nimport * as log from \"../log.js\";\nimport { listRegisteredOffices, officeKey, type Workspace } from \"../office/index.js\";\nimport { reportUserFacingError } from \"../observability/index.js\";\nimport { inferConversationKind } from \"../sessions/session-key.js\";\nimport type { OfficeAddress } from \"../types.js\";\nimport {\n  officeEventsDir,\n  parseEventPayload,\n  type EventRecord,\n  type EventScheduleSink,\n  type MikanEvent,\n  type PeriodicEventInfo,\n} from \"./index.js\";\n\nexport type { MikanEvent, PeriodicEventInfo } from \"./index.js\";\n\ninterface Scheduled {\n  address: OfficeAddress;\n  filename: string;\n  event: MikanEvent;\n  timer?: NodeJS.Timeout;\n  cron?: Cron;\n}\n\nexport class EventScheduler implements EventScheduleSink {\n  private readonly scheduled = new Map<string, Scheduled>();\n  private startTime = Date.now();\n\n  constructor(\n    private readonly workspace: Workspace,\n    private readonly botsByPlatform: Record<string, MessagingBot>,\n  ) {}\n\n  start(): void {\n    this.startTime = Date.now();\n    let loaded = 0;\n    for (const record of listRegisteredOffices(this.workspace.stateDir)) {\n      const office = this.workspace.office(record);\n      const dir = officeEventsDir(office);\n      if (!existsSync(dir)) continue;\n      for (const filename of readdirSync(dir).filter((name) => name.endsWith(\".json\"))) {\n        const path = join(dir, filename);\n        try {\n          const payload = parseEventPayload(readFileSync(path, \"utf-8\"), filename);\n          this.scheduleRecord(office.address, { filename, payload, size: 0, mtimeMs: 0 });\n          loaded++;\n        } catch (error) {\n          log.logWarning(\n            `Removing unparseable event file ${filename} for ${office.key}`,\n            error instanceof Error ? error.message : String(error),\n          );\n          this.removeFile(office.address, filename);\n        }\n      }\n    }\n    log.logInfo(`Event scheduler started, tracking ${loaded} records`);\n  }\n\n  stop(): void {\n    for (const entry of this.scheduled.values()) {\n      if (entry.timer) clearTimeout(entry.timer);\n      entry.cron?.stop();\n    }\n    this.scheduled.clear();\n    log.logInfo(\"Event scheduler stopped\");\n  }\n\n  scheduledCount(): number {\n    return this.scheduled.size;\n  }\n\n  periodicEvents(address: OfficeAddress): PeriodicEventInfo[] {\n    const prefix = `${officeKey(address)}/`;\n    const results: PeriodicEventInfo[] = [];\n    for (const [key, entry] of this.scheduled) {\n      if (!key.startsWith(prefix) || entry.event.type !== \"periodic\" || !entry.cron) continue;\n      results.push({\n        filename: entry.filename,\n        platform: entry.event.platform,\n        conversationId: entry.event.conversationId,\n        conversationKind: entry.event.conversationKind,\n        text: entry.event.text,\n        schedule: entry.event.schedule,\n        timezone: entry.event.timezone,\n        nextRun: entry.cron.nextRun()?.toISOString() ?? null,\n      });\n    }\n    return results;\n  }\n\n  scheduleRecord(address: OfficeAddress, record: EventRecord): void {\n    const key = this.key(address, record.filename);\n    this.cancelKey(key);\n    let event: MikanEvent;\n    try {\n      event = this.resolve(record, address);\n    } catch (error) {\n      log.logWarning(\n        `Rejecting event ${record.filename}`,\n        error instanceof Error ? error.message : String(error),\n      );\n      this.removeFile(address, record.filename);\n      return;\n    }\n    const entry: Scheduled = { address, filename: record.filename, event };\n    switch (event.type) {\n      case \"immediate\":\n        this.execute(entry);\n        return;\n      case \"one-shot\": {\n        const delay = new Date(event.at).getTime() - Date.now();\n        if (delay <= 0) {\n          log.logInfo(`One-shot event in the past, deleting: ${record.filename}`);\n          this.removeFile(address, record.filename);\n          return;\n        }\n        entry.timer = setTimeout(() => {\n          this.scheduled.delete(key);\n          this.execute(entry);\n        }, delay);\n        this.scheduled.set(key, entry);\n        return;\n      }\n      case \"periodic\":\n        try {\n          entry.cron = new Cron(event.schedule, { timezone: event.timezone }, () =>\n            this.execute(entry, false),\n          );\n        } catch (error) {\n          log.logWarning(`Invalid cron schedule for ${record.filename}`, String(error));\n          this.removeFile(address, record.filename);\n          return;\n        }\n        this.scheduled.set(key, entry);\n    }\n  }\n\n  cancelRecord(address: OfficeAddress, filename: string): void {\n    this.cancelKey(this.key(address, filename));\n  }\n\n  private key(address: OfficeAddress, filename: string): string {\n    return `${officeKey(address)}/${filename}`;\n  }\n\n  private cancelKey(key: string): void {\n    const entry = this.scheduled.get(key);\n    if (!entry) return;\n    if (entry.timer) clearTimeout(entry.timer);\n    entry.cron?.stop();\n    this.scheduled.delete(key);\n  }\n\n  private resolve(record: EventRecord, address: OfficeAddress): MikanEvent {\n    const { payload } = record;\n    const platform = (payload.platform ?? address.platform).toLowerCase();\n    if (platform !== address.platform || payload.conversationId !== address.conversationId) {\n      throw new Error(\"event payload does not address its owning office\");\n    }\n    if (!this.botsByPlatform[platform]) {\n      throw new Error(`no bot configured for platform '${platform}'`);\n    }\n    const conversationKind: ConversationKind =\n      payload.conversationKind ?? inferConversationKind(platform, payload.conversationId);\n    return { ...payload, platform, conversationKind };\n  }\n\n  private execute(entry: Scheduled, deleteAfter = true): void {\n    const { event, filename, address } = entry;\n    const bot = this.botsByPlatform[event.platform];\n    if (!bot) {\n      this.reportFailure(entry, deleteAfter, \"missing_bot\");\n      if (deleteAfter) this.removeFile(address, filename);\n      return;\n    }\n    const enqueued = bot.enqueueEvent(\n      createConversationEvent({\n        platform: event.platform as PlatformName,\n        type: \"mention\",\n        conversationId: event.conversationId,\n        conversationKind: event.conversationKind,\n        user: event.userId ?? \"EVENT\",\n        text: buildEventPrompt(event),\n        ts: `event:${filename.replace(/\\.json$/i, \"\")}`,\n      }),\n    );\n    if (!enqueued) {\n      log.logWarning(`Event queue full, discarded: ${filename}`);\n      this.reportFailure(entry, deleteAfter, \"queue_full\");\n    }\n    if (deleteAfter) this.removeFile(address, filename);\n  }\n\n  private reportFailure(\n    entry: Scheduled,\n    deleteAfter: boolean,\n    failure: \"missing_bot\" | \"queue_full\",\n  ): void {\n    const reason = failure === \"missing_bot\" ? \"missing bot\" : \"queue full\";\n    reportUserFacingError(new Error(`Scheduled event delivery failed: ${reason}`), {\n      domain: \"events\",\n      surface: \"event_delivery\",\n      operation: \"event_execute\",\n      severity: \"error\",\n      platform: entry.event.platform,\n      context: {\n        failure,\n        filename: entry.filename,\n        eventType: entry.event.type,\n        conversationId: entry.event.conversationId,\n        conversationKind: entry.event.conversationKind,\n        deleteAfter,\n        triggeredByEventFile: true,\n        textLength: entry.event.text.length,\n      },\n    });\n  }\n\n  private removeFile(address: OfficeAddress, filename: string): void {\n    const path = join(officeEventsDir(this.workspace.office(address)), filename);\n    try {\n      unlinkSync(path);\n    } catch (error) {\n      if (error instanceof Error && \"code\" in error && error.code !== \"ENOENT\") {\n        log.logWarning(`Failed to delete event file: ${filename}`, String(error));\n      }\n    }\n  }\n}\n\nexport function buildEventPrompt(event: MikanEvent): string {\n  switch (event.type) {\n    case \"one-shot\":\n      return [\n        \"Please deliver the following reminder to the user in a short, natural way.\",\n        \"Do not greet, do not introduce yourself, and do not ask generic follow-up questions.\",\n        \"\",\n        `Reminder: ${event.text}`,\n      ].join(\"\\n\");\n    case \"periodic\":\n      return [\n        \"Handle the following recurring task.\",\n        \"Respond concisely. If there is nothing actionable to report, reply with [SILENT].\",\n        \"\",\n        `Task: ${event.text}`,\n      ].join(\"\\n\");\n    case \"immediate\":\n      return [\n        \"Handle the following event/update in a concise, context-appropriate way.\",\n        \"If it reads like a reminder or follow-up, deliver it directly without greeting or generic offers to help.\",\n        \"\",\n        `Event: ${event.text}`,\n      ].join(\"\\n\");\n  }\n}\n"]}

package/dist/file-guards.d.ts

@@ -6,21 +6,6 @@ export declare function readJsonSchemaFileIfExists<T extends TSchema>(path: stri
 export declare function parseJsonValue<T>(raw: string, validate: (value: unknown) => value is T, malformedMessage: (detail: string) => string): T;
 export declare function parseJsonSchemaValue<T extends TSchema>(raw: string, schema: T, malformedMessage: (detail: string) => string): Static<T>;
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
-/**
- * Write `content` to `targetPath` with mode 0600, even when `targetPath`
- * already exists. Uses O_CREAT|O_EXCL on a temp sibling (so the kernel
- * guarantees permissions at creation, not after a racy chmod) and then
- * rename(2) into place for atomicity. Readers never see a torn write,
- * and a crash mid-write leaves either the old file or a stray .tmp
- * (cleaned by the next attempt or manually) — never a half-written target.
- */
 export declare function atomicWritePrivateFile(targetPath: string, content: string): void;
-/**
- * The state dir (settings, office records, vaults) must never live inside
- * the working dir: conversation opt-in "full" mode mounts the entire working
- * dir read-write into sandbox containers, which would expose host-authoritative
- * state and credentials. Fatal under sandboxed modes; host mode has no mounts,
- * so only warn about the bad hygiene.
- */
 export declare function assertStateDirOutsideWorkspace(stateDir: string, workingDir: string, sandboxType: string): void;
 //# sourceMappingURL=file-guards.d.ts.map

package/dist/file-guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-guards.d.ts","sourceRoot":"","sources":["../src/file-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAiBzD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASrE;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACxC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAC3C,CAAC,GAAG,SAAS,CAGf;AAED,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,OAAO,EAC1D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,EACT,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAC3C,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAGvB;AAWD,wBAAgB,cAAc,CAAC,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACxC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAC3C,CAAC,CAMH;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,OAAO,EACpD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,EACT,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAC3C,MAAM,CAAC,CAAC,CAAC,CAeX;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAID;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAiChF;AAaD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,IAAI,CAWN"}
+{"version":3,"file":"file-guards.d.ts","sourceRoot":"","sources":["../src/file-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAiBzD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASrE;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACxC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAC3C,CAAC,GAAG,SAAS,CAGf;AAED,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,OAAO,EAC1D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,EACT,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAC3C,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAGvB;AAWD,wBAAgB,cAAc,CAAC,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACxC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAC3C,CAAC,CAMH;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,OAAO,EACpD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,EACT,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAC3C,MAAM,CAAC,CAAC,CAAC,CAeX;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAID,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA6BhF;AAQD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,IAAI,CAWN"}

package/dist/file-guards.js

@@ -61,14 +61,6 @@ export function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 const PRIVATE_FILE_MODE = 0o600;
-/**
- * Write `content` to `targetPath` with mode 0600, even when `targetPath`
- * already exists. Uses O_CREAT|O_EXCL on a temp sibling (so the kernel
- * guarantees permissions at creation, not after a racy chmod) and then
- * rename(2) into place for atomicity. Readers never see a torn write,
- * and a crash mid-write leaves either the old file or a stray .tmp
- * (cleaned by the next attempt or manually) — never a half-written target.
- */
 export function atomicWritePrivateFile(targetPath, content) {
     const dir = dirname(targetPath);
     const tmpPath = join(dir, `.${basename(targetPath)}.${process.pid}.${randomBytes(8).toString("hex")}.tmp`);
@@ -80,9 +72,7 @@ export function atomicWritePrivateFile(targetPath, content) {
         try {
             unlinkSync(tmpPath);
         }
-        catch {
-            // ignore — original error is more informative
-        }
+        catch { }
         throw err;
     }
     finally {
@@ -95,29 +85,15 @@ export function atomicWritePrivateFile(targetPath, content) {
         try {
             unlinkSync(tmpPath);
         }
-        catch {
-            // ignore
-        }
+        catch { }
         throw err;
     }
 }
-/**
- * True when `child` is `parent` or a path inside it. Purely lexical (no
- * symlink resolution) — used for configuration sanity checks, not as the
- * final security boundary.
- */
 function isPathInside(child, parent) {
     const parentPath = resolve(parent);
     const childPath = resolve(child);
     return childPath === parentPath || childPath.startsWith(parentPath + "/");
 }
-/**
- * The state dir (settings, office records, vaults) must never live inside
- * the working dir: conversation opt-in "full" mode mounts the entire working
- * dir read-write into sandbox containers, which would expose host-authoritative
- * state and credentials. Fatal under sandboxed modes; host mode has no mounts,
- * so only warn about the bad hygiene.
- */
 export function assertStateDirOutsideWorkspace(stateDir, workingDir, sandboxType) {
     if (!isPathInside(stateDir, workingDir))
         return;