@geminixiang/mikan 1.0.0-beta.39 → 1.0.0-beta.40

package/dist/harness/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/harness/auth.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * File-backed credential store for the mikan harness.\n *\n * Implements pi-ai's `CredentialStore` over mikan's `auth.json`\n * (`~/.mikan/auth.json` by default). The file maps provider ids to\n * type-tagged credentials — the same shape pi-ai documents for auth.json.\n *\n * Writes are atomic (temp file + rename, mode 0600) and serialized per\n * provider within the process. mikan runs as a single process, so no\n * cross-process file lock is taken.\n */\nimport { existsSync, readFileSync } from \"fs\";\nimport { mkdirSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { dirname, join } from \"path\";\nimport type { Credential, CredentialInfo, CredentialStore } from \"@earendil-works/pi-ai\";\nimport { atomicWritePrivateFile } from \"../utils/fs-atomic.js\";\nimport * as log from \"../log.js\";\n\n/** Default location of mikan's credential file. */\nexport function defaultAuthPath(): string {\n  return join(homedir(), \".mikan\", \"auth.json\");\n}\n\nfunction isCredential(value: unknown): value is Credential {\n  if (!value || typeof value !== \"object\") return false;\n  const type = (value as { type?: unknown }).type;\n  return type === \"api_key\" || type === \"oauth\";\n}\n\nexport class FileCredentialStore implements CredentialStore {\n  private readonly authPath: string;\n  private chain = Promise.resolve();\n\n  constructor(authPath: string = defaultAuthPath()) {\n    this.authPath = authPath;\n  }\n\n  private load(): Record<string, Credential> {\n    if (!existsSync(this.authPath)) return {};\n    try {\n      const parsed: unknown = JSON.parse(readFileSync(this.authPath, \"utf-8\"));\n      if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) return {};\n      const data: Record<string, Credential> = {};\n      for (const [provider, credential] of Object.entries(parsed)) {\n        if (isCredential(credential)) data[provider] = credential;\n      }\n      return data;\n    } catch (err) {\n      log.logWarning(\n        `Failed to read credentials from ${this.authPath}`,\n        err instanceof Error ? err.message : String(err),\n      );\n      return {};\n    }\n  }\n\n  private save(data: Record<string, Credential>): void {\n    mkdirSync(dirname(this.authPath), { recursive: true });\n    atomicWritePrivateFile(this.authPath, `${JSON.stringify(data, null, 2)}\\n`);\n  }\n\n  /** Serialize read-modify-write cycles so concurrent refreshes cannot clobber each other. */\n  private enqueue<T>(task: () => Promise<T>): Promise<T> {\n    const result = this.chain.then(task);\n    this.chain = result.then(\n      () => undefined,\n      () => undefined,\n    );\n    return result;\n  }\n\n  read(providerId: string): Promise<Credential | undefined> {\n    return this.enqueue(async () => this.load()[providerId]);\n  }\n\n  list(): Promise<readonly CredentialInfo[]> {\n    return this.enqueue(async () =>\n      Object.entries(this.load()).map(([providerId, credential]) => ({\n        providerId,\n        type: credential.type,\n      })),\n    );\n  }\n\n  modify(\n    providerId: string,\n    fn: (current: Credential | undefined) => Promise<Credential | undefined>,\n  ): Promise<Credential | undefined> {\n    return this.enqueue(async () => {\n      const data = this.load();\n      const next = await fn(data[providerId]);\n      if (next === undefined) return data[providerId];\n      data[providerId] = next;\n      this.save(data);\n      return next;\n    });\n  }\n\n  delete(providerId: string): Promise<void> {\n    return this.enqueue(async () => {\n      const data = this.load();\n      if (!(providerId in data)) return;\n      delete data[providerId];\n      this.save(data);\n    });\n  }\n}\n"]}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/harness/auth.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * File-backed credential store for the mikan harness.\n *\n * Implements pi-ai's `CredentialStore` over mikan's `auth.json`\n * (`~/.mikan/auth.json` by default). The file maps provider ids to\n * type-tagged credentials — the same shape pi-ai documents for auth.json.\n *\n * Writes are atomic (temp file + rename, mode 0600) and serialized per\n * provider within the process. mikan runs as a single process, so no\n * cross-process file lock is taken.\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { mkdirSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport type { Credential, CredentialInfo, CredentialStore } from \"@earendil-works/pi-ai\";\nimport { atomicWritePrivateFile } from \"../utils/file-guards.js\";\nimport * as log from \"../log.js\";\n\n/** Default location of mikan's credential file. */\nexport function defaultAuthPath(): string {\n  return join(homedir(), \".mikan\", \"auth.json\");\n}\n\nfunction isCredential(value: unknown): value is Credential {\n  if (!value || typeof value !== \"object\") return false;\n  const type = (value as { type?: unknown }).type;\n  return type === \"api_key\" || type === \"oauth\";\n}\n\nexport class FileCredentialStore implements CredentialStore {\n  private readonly authPath: string;\n  private chain = Promise.resolve();\n\n  constructor(authPath: string = defaultAuthPath()) {\n    this.authPath = authPath;\n  }\n\n  private load(): Record<string, Credential> {\n    if (!existsSync(this.authPath)) return {};\n    try {\n      const parsed: unknown = JSON.parse(readFileSync(this.authPath, \"utf-8\"));\n      if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) return {};\n      const data: Record<string, Credential> = {};\n      for (const [provider, credential] of Object.entries(parsed)) {\n        if (isCredential(credential)) data[provider] = credential;\n      }\n      return data;\n    } catch (err) {\n      log.logWarning(\n        `Failed to read credentials from ${this.authPath}`,\n        err instanceof Error ? err.message : String(err),\n      );\n      return {};\n    }\n  }\n\n  private save(data: Record<string, Credential>): void {\n    mkdirSync(dirname(this.authPath), { recursive: true });\n    atomicWritePrivateFile(this.authPath, `${JSON.stringify(data, null, 2)}\\n`);\n  }\n\n  /** Serialize read-modify-write cycles so concurrent refreshes cannot clobber each other. */\n  private enqueue<T>(task: () => Promise<T>): Promise<T> {\n    const result = this.chain.then(task);\n    this.chain = result.then(\n      () => undefined,\n      () => undefined,\n    );\n    return result;\n  }\n\n  read(providerId: string): Promise<Credential | undefined> {\n    return this.enqueue(async () => this.load()[providerId]);\n  }\n\n  list(): Promise<readonly CredentialInfo[]> {\n    return this.enqueue(async () =>\n      Object.entries(this.load()).map(([providerId, credential]) => ({\n        providerId,\n        type: credential.type,\n      })),\n    );\n  }\n\n  modify(\n    providerId: string,\n    fn: (current: Credential | undefined) => Promise<Credential | undefined>,\n  ): Promise<Credential | undefined> {\n    return this.enqueue(async () => {\n      const data = this.load();\n      const next = await fn(data[providerId]);\n      if (next === undefined) return data[providerId];\n      data[providerId] = next;\n      this.save(data);\n      return next;\n    });\n  }\n\n  delete(providerId: string): Promise<void> {\n    return this.enqueue(async () => {\n      const data = this.load();\n      if (!(providerId in data)) return;\n      delete data[providerId];\n      this.save(data);\n    });\n  }\n}\n"]}

package/dist/harness/event-format.d.ts

@@ -10,6 +10,8 @@ export type { EventConversationKind, EventFilePayload, EventPayloadInput, EventT
  */
 /** 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. */
+export declare function isValidIsoTimestampWithOffset(value: string): boolean;
 /**
  * Parse and validate one event file's content into the canonical payload.
  * `filename` appears in error messages. Throws on malformed JSON, wrong

package/dist/harness/event-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-format.d.ts","sourceRoot":"","sources":["../../src/harness/event-format.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEtE,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AAEH,qGAAqG;AACrG,eAAO,MAAM,eAAe,6LAI1B,CAAC;AA+EH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CA6CrF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CAgC5E"}
+{"version":3,"file":"event-format.d.ts","sourceRoot":"","sources":["../../src/harness/event-format.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEtE,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AAEH,qGAAqG;AACrG,eAAO,MAAM,eAAe,6LAI1B,CAAC;AAiCH,kFAAkF;AAClF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CA8BpE;AAgBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CA6CrF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CAgC5E"}

package/dist/harness/event-format.js

@@ -39,7 +39,8 @@ function daysInMonth(year, month) {
     }
     return month === 4 || month === 6 || month === 9 || month === 11 ? 30 : 31;
 }
-function isValidIsoTimestampWithOffset(value) {
+/** True for a complete ISO 8601 timestamp that carries an explicit UTC offset. */
+export function isValidIsoTimestampWithOffset(value) {
     const match = ISO_TIMESTAMP_WITH_OFFSET.exec(value);
     if (!match)
         return false;

package/dist/harness/event-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-format.js","sourceRoot":"","sources":["../../src/harness/event-format.ts"],"names":[],"mappings":"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","sourcesContent":["import { Type, type Static } from \"@sinclair/typebox\";\nimport { parseJsonSchemaValue } from \"../utils/file-guards.js\";\nimport type { EventFilePayload, EventPayloadInput } from \"./types.js\";\n\nexport type {\n  EventConversationKind,\n  EventFilePayload,\n  EventPayloadInput,\n  EventType,\n  ImmediateEventPayload,\n  OneShotEventPayload,\n  PeriodicEventPayload,\n} from \"./types.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, the agent `event` tool, and the extension schedule API — 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\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 * Resolve an event file's conversation id, honoring the legacy `channelId`\n * alias. Alias knowledge is private to the format module: consumers always\n * see `conversationId` on parsed payloads.\n */\nfunction resolveEventConversationId(data: {\n  conversationId?: unknown;\n  channelId?: unknown;\n}): string | undefined {\n  if (typeof data.conversationId === \"string\") return data.conversationId;\n  if (typeof data.channelId === \"string\") return data.channelId;\n  return undefined;\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  const conversationId = resolveEventConversationId(data);\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"]}
+{"version":3,"file":"event-format.js","sourceRoot":"","sources":["../../src/harness/event-format.ts"],"names":[],"mappings":"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","sourcesContent":["import { Type, type Static } from \"@sinclair/typebox\";\nimport { parseJsonSchemaValue } from \"../utils/file-guards.js\";\nimport type { EventFilePayload, EventPayloadInput } from \"./types.js\";\n\nexport type {\n  EventConversationKind,\n  EventFilePayload,\n  EventPayloadInput,\n  EventType,\n  ImmediateEventPayload,\n  OneShotEventPayload,\n  PeriodicEventPayload,\n} from \"./types.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, the agent `event` tool, and the extension schedule API — 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. */\nexport function 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 * Resolve an event file's conversation id, honoring the legacy `channelId`\n * alias. Alias knowledge is private to the format module: consumers always\n * see `conversationId` on parsed payloads.\n */\nfunction resolveEventConversationId(data: {\n  conversationId?: unknown;\n  channelId?: unknown;\n}): string | undefined {\n  if (typeof data.conversationId === \"string\") return data.conversationId;\n  if (typeof data.channelId === \"string\") return data.channelId;\n  return undefined;\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  const conversationId = resolveEventConversationId(data);\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"]}

package/dist/harness/extensions/loader.d.ts

@@ -4,9 +4,9 @@ export type { ExtensionValidation, InstalledExtensionInfo, LoadExtensionsOptions
 /**
  * Canonical host-only extension code directories for a conversation, in load
  * order: `<stateDir>/global/extensions` (all conversations) then
- * `<stateDir>/conversations/<conversationId>/extensions` (that conversation
+ * `<stateDir>/conversations/<office key>/extensions` (that conversation
  * only). `global` and `conversations` are the two sibling scopes; see
- * `LAYOUT.md`. Conversation ids are used verbatim (see LAYOUT.md § Casing).
+ * `LAYOUT.md`.
  */
 export declare function defaultExtensionDirs(address: OfficeAddress, stateDir?: string): string[];
 /**

package/dist/harness/extensions/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/harness/extensions/loader.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EASV,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EAKrB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAiBpB;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,QAAQ,GAAE,MAAkC,GAC3C,MAAM,EAAE,CAKV;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAkBhF;AA+HD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrD;AA8QD,uEAAuE;AACvE,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAgD/B;AA2DD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsDxF"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/harness/extensions/loader.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAWV,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EAKrB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAiBpB;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,QAAQ,GAAE,MAAkC,GAC3C,MAAM,EAAE,CAKV;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAmBhF;AAkJD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrD;AA4WD,uEAAuE;AACvE,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAoE/B;AA2DD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuDxF"}

package/dist/harness/extensions/loader.js

@@ -22,15 +22,14 @@
  * Modules are imported with a fresh jiti instance (no cache) so edited
  * extensions are picked up when a new harness instance is created.
  */
-import { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from "fs";
-import { homedir } from "os";
-import { basename, join } from "path";
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
 import { createJiti } from "jiti";
 import * as log from "../../log.js";
 import { buildEventPayload } from "../event-format.js";
 import { loadSkillsFromDir } from "../skills.js";
-import { namespaceActionIds } from "./blockkit.js";
-import { ExtensionRegistry } from "./registry.js";
+import { ExtensionRegistry, namespaceActionIds } from "./registry.js";
 import { officeStateDir } from "../../office/index.js";
 const EXTENSION_FILE_PATTERN = /\.(mjs|js|ts|mts)$/;
 const INDEX_FILE_PATTERN = /^index\.(mjs|js|ts|mts)$/;
@@ -48,9 +47,9 @@ async function importExtensionModule(entrypoint) {
 /**
  * Canonical host-only extension code directories for a conversation, in load
  * order: `<stateDir>/global/extensions` (all conversations) then
- * `<stateDir>/conversations/<conversationId>/extensions` (that conversation
+ * `<stateDir>/conversations/<office key>/extensions` (that conversation
  * only). `global` and `conversations` are the two sibling scopes; see
- * `LAYOUT.md`. Conversation ids are used verbatim (see LAYOUT.md § Casing).
+ * `LAYOUT.md`.
  */
 export function defaultExtensionDirs(address, stateDir = join(homedir(), ".mikan")) {
     return [
@@ -77,6 +76,7 @@ export function listInstalledExtensions(dirs) {
                 version: manifest.version,
                 description: manifest.description,
                 skillNames: loadExtensionSkills(rootDir, slug).map((skill) => skill.name),
+                secrets: manifest.secrets ?? [],
             });
         }
     }
@@ -141,6 +141,20 @@ function resolveDirectoryEntrypoint(dir) {
     }
     return undefined;
 }
+const SECRET_KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Shape one `mikan.secrets` entry defensively; undefined when unusable. */
+function readSecretDeclaration(entry) {
+    if (!entry || typeof entry !== "object")
+        return undefined;
+    const record = entry;
+    if (typeof record.key !== "string" || !SECRET_KEY_PATTERN.test(record.key))
+        return undefined;
+    return {
+        key: record.key,
+        ...(typeof record.description === "string" ? { description: record.description } : {}),
+        ...(typeof record.required === "boolean" ? { required: record.required } : {}),
+    };
+}
 /** Read and shape a directory's package.json; undefined when absent/malformed. */
 function readPackageJson(dir) {
     const packageJsonPath = join(dir, "package.json");
@@ -161,6 +175,9 @@ function readPackageJson(dir) {
                     ? mikanRaw.extensions.filter((entry) => typeof entry === "string")
                     : undefined,
                 displayName: typeof mikanRaw?.displayName === "string" ? mikanRaw.displayName : undefined,
+                secrets: Array.isArray(mikanRaw?.secrets)
+                    ? mikanRaw.secrets.flatMap((entry) => readSecretDeclaration(entry) ?? [])
+                    : undefined,
             },
         };
     }
@@ -219,11 +236,17 @@ function readManifest(rootDir) {
     if (EXTENSION_FILE_PATTERN.test(basename(rootDir)))
         return {};
     const pkg = readPackageJson(rootDir);
-    if (pkg && (pkg.mikan?.displayName ?? pkg.name ?? pkg.version ?? pkg.description)) {
+    if (pkg &&
+        (pkg.mikan?.displayName ??
+            pkg.name ??
+            pkg.version ??
+            pkg.description ??
+            pkg.mikan?.secrets?.length)) {
         return {
             name: pkg.mikan?.displayName ?? pkg.name,
             version: pkg.version,
             description: pkg.description,
+            ...(pkg.mikan?.secrets?.length ? { secrets: pkg.mikan.secrets } : {}),
         };
     }
     const manifestPath = join(rootDir, "manifest.json");
@@ -269,14 +292,14 @@ const SCHEDULE_FILE_SUFFIX = ".json";
 function schedulePrefix(slug, conversationId) {
     return `ext.${slug}.${scheduleNameSegment(conversationId)}.`;
 }
-function payloadFromSpec(spec, conversationId) {
+function payloadFromSpec(spec, conversationId, defaultPlatform) {
     // Per-type validation (schedule/timezone for periodic, at for one-shot)
     // is owned by the event-format builder.
     return buildEventPayload({
         type: spec.type,
         conversationId,
         text: spec.text,
-        ...(spec.platform ? { platform: spec.platform } : {}),
+        platform: spec.platform ?? defaultPlatform,
         ...(spec.type === "periodic"
             ? { schedule: spec.schedule, timezone: spec.timezone }
             : { at: spec.at }),
@@ -308,12 +331,23 @@ function buildExtensionApi(params) {
     const stateDir = services.stateDir ?? join(homedir(), ".mikan");
     const conversationId = context.conversationId;
     const conversationStateDir = officeStateDir(stateDir, context.address);
+    // Default platform for proactive messaging and schedules: the platform this
+    // conversation lives on. Extensions only name a platform explicitly when
+    // targeting a conversation on a different one.
+    const ownPlatform = context.address.platform;
     const requireScheduleStore = () => {
         if (!services.scheduleStore) {
             throw new Error("api.schedules is unavailable: this context provides no schedule store");
         }
         return services.scheduleStore;
     };
+    const requireCallbackScheduleStore = () => {
+        if (!services.callbackScheduleStore) {
+            throw new Error("api.schedules callback specs are unavailable: this context provides no callback-schedule store");
+        }
+        return services.callbackScheduleStore;
+    };
+    const scheduleFilename = (scheduleName) => `${schedulePrefix(slug, conversationId)}${scheduleNameSegment(scheduleName)}${SCHEDULE_FILE_SUFFIX}`;
     return {
         on: (hook, handler) => registry.register(name, hook, handler),
         registerTool: (tool) => registry.registerTool(tool),
@@ -342,31 +376,49 @@ function buildExtensionApi(params) {
         },
         schedules: {
             upsert: async (scheduleName, spec) => {
+                const nameSegment = scheduleNameSegment(scheduleName);
+                // One name namespace across both action kinds: an upsert switches the
+                // schedule's kind by also dropping its counterpart in the other store.
+                if (spec.callback !== undefined) {
+                    await requireCallbackScheduleStore().upsert(slug, nameSegment, spec);
+                    await services.scheduleStore?.delete(scheduleFilename(scheduleName));
+                    return;
+                }
                 const store = requireScheduleStore();
-                const filename = `${schedulePrefix(slug, conversationId)}${scheduleNameSegment(scheduleName)}${SCHEDULE_FILE_SUFFIX}`;
-                await store.write(filename, payloadFromSpec(spec, conversationId));
+                await store.write(scheduleFilename(scheduleName), payloadFromSpec(spec, conversationId, ownPlatform));
+                await services.callbackScheduleStore?.delete(slug, nameSegment);
             },
             delete: async (scheduleName) => {
-                const store = requireScheduleStore();
-                const filename = `${schedulePrefix(slug, conversationId)}${scheduleNameSegment(scheduleName)}${SCHEDULE_FILE_SUFFIX}`;
-                return store.delete(filename);
+                if (!services.scheduleStore && !services.callbackScheduleStore)
+                    requireScheduleStore();
+                const deletedCallback = (await services.callbackScheduleStore?.delete(slug, scheduleNameSegment(scheduleName))) ??
+                    false;
+                const deletedText = (await services.scheduleStore?.delete(scheduleFilename(scheduleName))) ?? false;
+                return deletedCallback || deletedText;
             },
             list: async () => {
-                const store = requireScheduleStore();
-                const prefix = schedulePrefix(slug, conversationId);
+                if (!services.scheduleStore && !services.callbackScheduleStore)
+                    requireScheduleStore();
                 const infos = [];
-                for (const entry of await store.list()) {
-                    if (!entry.filename.startsWith(prefix))
-                        continue;
-                    if (!entry.filename.endsWith(SCHEDULE_FILE_SUFFIX))
-                        continue;
-                    infos.push({
-                        name: entry.filename.slice(prefix.length, -SCHEDULE_FILE_SUFFIX.length),
-                        spec: specFromPayload(entry.payload),
-                    });
+                if (services.scheduleStore) {
+                    const prefix = schedulePrefix(slug, conversationId);
+                    for (const entry of await services.scheduleStore.list()) {
+                        if (!entry.filename.startsWith(prefix))
+                            continue;
+                        if (!entry.filename.endsWith(SCHEDULE_FILE_SUFFIX))
+                            continue;
+                        infos.push({
+                            name: entry.filename.slice(prefix.length, -SCHEDULE_FILE_SUFFIX.length),
+                            spec: specFromPayload(entry.payload),
+                        });
+                    }
+                }
+                if (services.callbackScheduleStore) {
+                    infos.push(...(await services.callbackScheduleStore.list(slug)));
                 }
                 return infos;
             },
+            onCallback: (callbackName, handler) => registry.registerScheduleCallback(slug, callbackName, handler),
         },
         subagent: {
             run: async (request) => {
@@ -380,7 +432,32 @@ function buildExtensionApi(params) {
             if (!services.postMessage) {
                 throw new Error("api.notify is unavailable: this context provides no platform messaging");
             }
-            await services.postMessage(options?.conversationId ?? conversationId, text);
+            return services.postMessage(options?.conversationId ?? conversationId, text, {
+                platform: options?.platform ?? ownPlatform,
+                ...(options?.threadTs ? { threadTs: options.threadTs } : {}),
+            });
+        },
+        openDm: async (userId) => {
+            if (!services.openDirectConversation) {
+                throw new Error("api.openDm is unavailable: this context provides no DM resolution");
+            }
+            return services.openDirectConversation(userId, ownPlatform);
+        },
+        fetchHistory: async (options) => {
+            if (!services.fetchHistory) {
+                throw new Error("api.fetchHistory is unavailable: this context provides no history reads");
+            }
+            const { conversationId: target, ...historyOptions } = options ?? {};
+            return services.fetchHistory(target ?? conversationId, {
+                ...historyOptions,
+                platform: ownPlatform,
+            });
+        },
+        listUsers: async () => {
+            if (!services.listUsers) {
+                throw new Error("api.listUsers is unavailable: this context provides no user listings");
+            }
+            return services.listUsers(ownPlatform);
         },
         blockkit: {
             post: async (message) => {
@@ -391,7 +468,7 @@ function buildExtensionApi(params) {
                     text: message.text,
                     blocks: namespaceActionIds(message.blocks, slug),
                     threadTs: message.threadTs,
-                });
+                }, ownPlatform);
             },
             update: async (messageTs, message) => {
                 if (!services.updateBlocks) {
@@ -400,7 +477,7 @@ function buildExtensionApi(params) {
                 await services.updateBlocks(conversationId, messageTs, {
                     text: message.text,
                     blocks: namespaceActionIds(message.blocks, slug),
-                });
+                }, ownPlatform);
             },
             onAction: (actionId, handler) => registry.registerAction(slug, actionId, handler),
         },
@@ -408,13 +485,13 @@ function buildExtensionApi(params) {
             if (!services.addReaction) {
                 throw new Error("api.react is unavailable: this context provides no reaction support");
             }
-            await services.addReaction(conversationId, messageTs, emoji);
+            await services.addReaction(conversationId, messageTs, emoji, ownPlatform);
         },
         uploadFile: async (filePath, title) => {
             if (!services.uploadFile) {
                 throw new Error("api.uploadFile is unavailable: this context provides no file uploads");
             }
-            await services.uploadFile(conversationId, filePath, title);
+            await services.uploadFile(conversationId, filePath, title, ownPlatform);
         },
         triggerRun: async (text) => {
             const store = requireScheduleStore();
@@ -422,7 +499,12 @@ function buildExtensionApi(params) {
             // api.schedules.list(), whose ownership filter is the "ext." prefix.
             // The embedder's watcher fires and deletes the file immediately.
             const filename = `extrun.${slug}.${scheduleNameSegment(conversationId)}.${Date.now()}-${runCounter++}${SCHEDULE_FILE_SUFFIX}`;
-            await store.write(filename, { type: "immediate", conversationId, text });
+            await store.write(filename, {
+                type: "immediate",
+                platform: ownPlatform,
+                conversationId,
+                text,
+            });
         },
     };
 }
@@ -459,6 +541,26 @@ export async function loadExtensions(options) {
     const services = options.services ?? {};
     for (const { entrypoint, rootDir, slug } of collectExtensions(options)) {
         try {
+            const manifest = readManifest(rootDir);
+            // Enforce declared-required secrets before importing: a clear
+            // provisioning hint beats whatever error the extension would throw at
+            // first `api.secrets.get` miss. Only enforceable when this context
+            // resolves secrets at all (`mikan ext dev` and secret-less embedders
+            // still activate; `api.secrets.get` returns undefined there).
+            if (services.resolveSecrets) {
+                const provisioned = services.resolveSecrets(slug);
+                const missing = (manifest.secrets ?? [])
+                    .filter((secret) => secret.required && !(secret.key in provisioned))
+                    .map((secret) => secret.key);
+                if (missing.length > 0) {
+                    errors.push({
+                        path: entrypoint,
+                        error: `missing required secrets: ${missing.join(", ")} — provision them in the admin ` +
+                            `portal or in <stateDir>/vaults/extensions/${slug}/env`,
+                    });
+                    continue;
+                }
+            }
             const moduleExports = await importExtensionModule(entrypoint);
             const extension = resolveActivate(moduleExports);
             if (!extension) {
@@ -468,7 +570,6 @@ export async function loadExtensions(options) {
                 });
                 continue;
             }
-            const manifest = readManifest(rootDir);
             const name = manifest.name ?? extension.name ?? slug;
             const api = buildExtensionApi({
                 name,
@@ -604,6 +705,7 @@ export async function validateExtension(sourcePath) {
         description: manifest.description,
         entrypoint,
         skillNames,
+        secrets: manifest.secrets ?? [],
         errors,
         warnings,
     };