@geminixiang/mikan 1.0.0-beta.20 → 1.0.0-beta.21

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

@@ -0,0 +1,66 @@
+/**
+ * Single home for the scheduled-event file format (`events/*.json`, the
+ * workspace scheduling bus). Every reader and writer — the EventsWatcher
+ * scheduler, the agent `event` tool, and the extension schedule API — 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.
+ */
+export type EventConversationKind = "direct" | "shared";
+export type EventType = "immediate" | "one-shot" | "periodic";
+/** 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">]>;
+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 {
+    type: "immediate";
+}
+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. Platform defaulting and conversation-kind
+ * inference happen at read time (EventsWatcher), so both stay optional here.
+ */
+export type EventFilePayload = ImmediateEventPayload | OneShotEventPayload | PeriodicEventPayload;
+/**
+ * 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;
+export interface EventPayloadInput {
+    type: EventType;
+    platform?: string;
+    conversationId: string;
+    conversationKind?: EventConversationKind;
+    userId?: string;
+    text: string;
+    at?: string;
+    schedule?: string;
+    timezone?: string;
+}
+/**
+ * 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;
+export {};
+//# sourceMappingURL=event-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-format.d.ts","sourceRoot":"","sources":["../../src/harness/event-format.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9D,qGAAqG;AACrG,eAAO,MAAM,eAAe,6LAI1B,CAAC;AAEH,UAAU,gBAAgB;IACxB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,IAAI,EAAE,UAAU,CAAC;IACjB,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,IAAI,EAAE,UAAU,CAAC;IACjB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;AAoClG;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAwCrF;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CAgC5E"}

package/dist/harness/event-format.js

@@ -0,0 +1,112 @@
+import { Type } from "@sinclair/typebox";
+import { parseJsonSchemaValue } from "../utils/file-guards.js";
+/** 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()),
+    conversationId: Type.Optional(Type.String()),
+    channelId: Type.Optional(Type.String()),
+    conversationKind: Type.Optional(Type.Union([Type.Literal("direct"), Type.Literal("shared")])),
+    userId: Type.Optional(Type.String()),
+    text: Type.Optional(Type.String()),
+    at: Type.Optional(Type.String()),
+    schedule: Type.Optional(Type.String()),
+    timezone: Type.Optional(Type.String()),
+});
+/**
+ * Resolve an event file's conversation id, honoring the legacy `channelId`
+ * alias. Alias knowledge is private to the format module: consumers always
+ * see `conversationId` on parsed payloads.
+ */
+function resolveEventConversationId(data) {
+    if (typeof data.conversationId === "string")
+        return data.conversationId;
+    if (typeof data.channelId === "string")
+        return data.channelId;
+    return undefined;
+}
+/**
+ * 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}`);
+    const conversationId = resolveEventConversationId(data);
+    const { type, text } = data;
+    if (!type || !conversationId || !text) {
+        throw new Error(`Missing required fields (type, conversationId, text) in ${filename}`);
+    }
+    const base = {
+        ...(data.platform !== undefined ? { platform: data.platform } : {}),
+        conversationId,
+        ...(data.conversationKind !== undefined ? { conversationKind: data.conversationKind } : {}),
+        ...(data.userId !== undefined ? { userId: data.userId } : {}),
+        text,
+    };
+    switch (type) {
+        case "immediate":
+            return { type, ...base };
+        case "one-shot":
+            if (typeof data.at !== "string" || data.at.length === 0) {
+                throw new Error(`Missing 'at' field for one-shot event in ${filename}`);
+            }
+            return { type, ...base, at: data.at };
+        case "periodic":
+            if (typeof data.schedule !== "string" || data.schedule.length === 0) {
+                throw new Error(`Missing 'schedule' field for periodic event in ${filename}`);
+            }
+            if (typeof data.timezone !== "string" || data.timezone.length === 0) {
+                throw new Error(`Missing 'timezone' field for periodic event in ${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 } : {}),
+        conversationId: input.conversationId,
+        ...(input.conversationKind !== undefined ? { conversationKind: input.conversationKind } : {}),
+        ...(input.userId !== undefined ? { userId: input.userId } : {}),
+        text: input.text,
+    };
+    switch (input.type) {
+        case "immediate":
+            return { type: "immediate", ...base };
+        case "one-shot": {
+            if (!input.at) {
+                throw new Error("`at` is required for one-shot events");
+            }
+            if (Number.isNaN(new Date(input.at).getTime())) {
+                throw new Error("`at` must be a valid ISO 8601 timestamp with UTC offset");
+            }
+            return { type: "one-shot", ...base, at: input.at };
+        }
+        case "periodic":
+            if (!input.schedule) {
+                throw new Error("`schedule` is required for periodic events");
+            }
+            if (!input.timezone) {
+                throw new Error("`timezone` is required for periodic events");
+            }
+            return { type: "periodic", ...base, schedule: input.schedule, timezone: input.timezone };
+    }
+}
+//# sourceMappingURL=event-format.js.map

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

@@ -0,0 +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\";\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\nexport type EventConversationKind = \"direct\" | \"shared\";\n\nexport type EventType = \"immediate\" | \"one-shot\" | \"periodic\";\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\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/**\n * Wire shape of one event file. Platform defaulting and conversation-kind\n * inference happen at read time (EventsWatcher), so both stay optional here.\n */\nexport type EventFilePayload = ImmediateEventPayload | OneShotEventPayload | PeriodicEventPayload;\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\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      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 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/**\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 (Number.isNaN(new Date(input.at).getTime())) {\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

@@ -56,13 +56,16 @@ export interface LoadExtensionsResult {
     dispose(): Promise<void>;
 }
 /**
- * Filesystem-safe identifier for an extension, derived from its install
- * location: the directory name for a directory-form extension, or the file
- * basename for a bare file. The slug keys the extension's data dir, secrets
- * vault, and schedule ownership — installing the same extension globally and
- * per-conversation shares one slug and therefore one shared data dir.
+ * Filesystem-safe identifier for an extension, derived from its root (the
+ * install directory, or the file path for a bare-file extension). The slug
+ * keys the extension's data dir, secrets vault, and schedule ownership —
+ * installing the same extension globally and per-conversation shares one
+ * slug and therefore one shared data dir. This is the only slug derivation:
+ * a second one keyed off a different input (e.g. the entrypoint, which for
+ * package.json-form extensions can live under dist/) would silently split an
+ * extension's identity.
  */
-export declare function extensionSlug(entrypoint: string): string;
+export declare function extensionSlug(rootDir: string): string;
 /** Load and activate all extensions found in the given directories. */
 export declare function loadExtensions(options: LoadExtensionsOptions): Promise<LoadExtensionsResult>;
 export interface ExtensionValidation {

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":"AA4BA,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAGV,qBAAqB,EACrB,kBAAkB,EAKlB,eAAe,EAIhB,MAAM,YAAY,CAAC;AAiBpB;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,MAAkC,GAC3C,MAAM,EAAE,CAKV;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAkBhF;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAClB,aAAa,EAAE,aAAa,CAAC;KAC9B,CAAC;IACF,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAuHD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQxD;AAqQD,uEAAuE;AACvE,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAmD/B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;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":"AA4BA,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAGV,qBAAqB,EACrB,kBAAkB,EAKlB,eAAe,EAIhB,MAAM,YAAY,CAAC;AAiBpB;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,MAAkC,GAC3C,MAAM,EAAE,CAKV;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAkBhF;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAClB,aAAa,EAAE,aAAa,CAAC;KAC9B,CAAC;IACF,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AA2HD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrD;AAmPD,uEAAuE;AACvE,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAmD/B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsDxF"}

package/dist/harness/extensions/loader.js

@@ -24,9 +24,10 @@
  */
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from "fs";
 import { homedir } from "os";
-import { basename, dirname, join } from "path";
+import { basename, join } from "path";
 import { createJiti } from "jiti";
 import * as log from "../../log.js";
+import { buildEventPayload } from "../event-format.js";
 import { loadSkillsFromDir } from "../skills.js";
 import { ExtensionRegistry } from "./registry.js";
 const EXTENSION_FILE_PATTERN = /\.(mjs|js|ts|mts)$/;
@@ -64,7 +65,7 @@ export function listInstalledExtensions(dirs) {
     const infos = [];
     for (const dir of dirs) {
         for (const { entrypoint, rootDir } of discoverExtensionEntrypoints(dir)) {
-            const slug = slugForRoot(rootDir);
+            const slug = extensionSlug(rootDir);
             const manifest = readManifest(rootDir);
             infos.push({
                 name: manifest.name ?? slug,
@@ -169,43 +170,35 @@ function readPackageJson(dir) {
 function readMikanManifestEntrypoints(dir) {
     return readPackageJson(dir)?.mikan?.extensions ?? [];
 }
-function sanitizeSlug(base) {
-    const slug = base
+/** The one filesystem-safe segment sanitizer for extension identity and schedule names. */
+function sanitizeSegment(value) {
+    return value
         .toLowerCase()
         .replace(/[^a-z0-9_-]+/g, "-")
         .replace(/^-+|-+$/g, "")
         .slice(0, 64);
-    return slug || "extension";
+}
+function sanitizeSlug(base) {
+    return sanitizeSegment(base) || "extension";
 }
 /**
- * Filesystem-safe identifier for an extension, derived from its install
- * location: the directory name for a directory-form extension, or the file
- * basename for a bare file. The slug keys the extension's data dir, secrets
- * vault, and schedule ownership — installing the same extension globally and
- * per-conversation shares one slug and therefore one shared data dir.
+ * Filesystem-safe identifier for an extension, derived from its root (the
+ * install directory, or the file path for a bare-file extension). The slug
+ * keys the extension's data dir, secrets vault, and schedule ownership —
+ * installing the same extension globally and per-conversation shares one
+ * slug and therefore one shared data dir. This is the only slug derivation:
+ * a second one keyed off a different input (e.g. the entrypoint, which for
+ * package.json-form extensions can live under dist/) would silently split an
+ * extension's identity.
  */
-export function extensionSlug(entrypoint) {
-    // Bare-file form (rootDir === entrypoint, a *.mjs/.ts file) → file basename.
-    // Directory form → directory name. Detect the directory form structurally:
-    // an entrypoint whose parent holds a package.json or is an index file.
-    if (INDEX_FILE_PATTERN.test(basename(entrypoint))) {
-        return sanitizeSlug(basename(dirname(entrypoint)));
-    }
-    return sanitizeSlug(basename(entrypoint).replace(EXTENSION_FILE_PATTERN, ""));
-}
-/** Slug from a discovered extension's root dir (directory or bare file path). */
-function slugForRoot(rootDir) {
+export function extensionSlug(rootDir) {
     return EXTENSION_FILE_PATTERN.test(basename(rootDir))
         ? sanitizeSlug(basename(rootDir).replace(EXTENSION_FILE_PATTERN, ""))
         : sanitizeSlug(basename(rootDir));
 }
 /** Sanitize an extension-chosen schedule name into a filename segment. */
 function scheduleNameSegment(name) {
-    const segment = name
-        .toLowerCase()
-        .replace(/[^a-z0-9_-]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 64);
+    const segment = sanitizeSegment(name);
     if (!segment)
         throw new Error(`Invalid schedule name: ${JSON.stringify(name)}`);
     return segment;
@@ -274,42 +267,34 @@ function schedulePrefix(slug, conversationId) {
     return `ext.${slug}.${scheduleNameSegment(conversationId)}.`;
 }
 function payloadFromSpec(spec, conversationId) {
-    if (spec.type === "periodic") {
-        if (!spec.schedule || !spec.timezone) {
-            throw new Error("periodic schedule requires schedule and timezone");
-        }
-        return {
-            type: "periodic",
-            conversationId,
-            text: spec.text,
-            schedule: spec.schedule,
-            timezone: spec.timezone,
-            ...(spec.platform ? { platform: spec.platform } : {}),
-        };
-    }
-    if (!spec.at)
-        throw new Error("one-shot schedule requires at");
-    return {
-        type: "one-shot",
+    // 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,
-        at: spec.at,
         ...(spec.platform ? { platform: spec.platform } : {}),
-    };
+        ...(spec.type === "periodic"
+            ? { schedule: spec.schedule, timezone: spec.timezone }
+            : { at: spec.at }),
+    });
 }
 function specFromPayload(payload) {
     if (payload.type === "periodic") {
         return {
             type: "periodic",
-            schedule: payload.schedule ?? "",
-            timezone: payload.timezone ?? "",
+            schedule: payload.schedule,
+            timezone: payload.timezone,
             text: payload.text,
             ...(payload.platform ? { platform: payload.platform } : {}),
         };
     }
+    // `immediate` payloads never appear under the schedules namespace (they
+    // live under "extrun."); tolerate them as an empty one-shot rather than
+    // widening the spec union.
     return {
         type: "one-shot",
-        at: payload.at ?? "",
+        at: payload.type === "one-shot" ? payload.at : "",
         text: payload.text,
         ...(payload.platform ? { platform: payload.platform } : {}),
     };
@@ -458,7 +443,7 @@ export async function loadExtensions(options) {
                     });
                     continue;
                 }
-                const slug = slugForRoot(rootDir);
+                const slug = extensionSlug(rootDir);
                 const manifest = readManifest(rootDir);
                 const name = manifest.name ?? extension.name ?? slug;
                 const api = buildExtensionApi({
@@ -524,7 +509,7 @@ export async function validateExtension(sourcePath) {
     else {
         errors.push(`Not an extension file (expected .mjs/.js/.ts/.mts): ${rootDir}`);
     }
-    const slug = slugForRoot(rootDir);
+    const slug = extensionSlug(rootDir);
     const manifest = readManifest(rootDir);
     const skillNames = loadExtensionSkills(rootDir, slug).map((skill) => skill.name);
     if (entrypoint) {

package/dist/harness/extensions/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/harness/extensions/loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Extension discovery and activation.\n *\n * Extension modules execute inside the mikan host process with its full\n * privileges (platform tokens, vault, host filesystem). They must therefore\n * only ever load from host-controlled directories: installing an extension\n * is an administrator action. In particular, extension directories must not\n * live under paths mounted into sandbox containers (workspace and\n * conversation dirs in image mode), or code written from inside the sandbox\n * would be imported into the host process — a sandbox escape.\n * {@link defaultExtensionDirs} returns the canonical host-only locations\n * under mikan's state dir.\n *\n * Directories are scanned in order; all discovered extensions activate.\n * Accepted layouts (entrypoint may be .mjs/.js/.ts/.mts — loaded via jiti):\n *\n * - `extensions/<name>.<ext>`                     (bare file)\n * - `extensions/<name>/index.<ext>`               (directory + index)\n * - `extensions/<name>/package.json`              (mikan.extensions entrypoint;\n *   may carry npm dependencies in node_modules)\n *\n * Modules are imported with a fresh jiti instance (no cache) so edited\n * extensions are picked up when a new harness instance is created.\n */\nimport { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { basename, dirname, join } from \"path\";\nimport { createJiti } from \"jiti\";\nimport type { AgentTool, ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport * as log from \"../../log.js\";\nimport { loadSkillsFromDir, type MikanSkill } from \"../skills.js\";\nimport { ExtensionRegistry } from \"./registry.js\";\nimport type {\n  ExtensionCommand,\n  ExtensionDisposer,\n  ExtensionHostServices,\n  ExtensionLoadError,\n  ExtensionManifest,\n  ExtensionSchedulePayload,\n  ExtensionScheduleInfo,\n  ExtensionScheduleSpec,\n  LoadedExtension,\n  MikanExtensionActivate,\n  MikanExtensionApi,\n  MikanExtensionModule,\n} from \"./types.js\";\n\nconst EXTENSION_FILE_PATTERN = /\\.(mjs|js|ts|mts)$/;\nconst INDEX_FILE_PATTERN = /^index\\.(mjs|js|ts|mts)$/;\nconst INDEX_CANDIDATES = [\"index.mjs\", \"index.js\", \"index.ts\", \"index.mts\"];\n\n/**\n * Import an extension entrypoint through jiti so it can be TypeScript and can\n * use node_modules dependencies, transparently compiling on the fly. A fresh\n * jiti instance with caching disabled is used per load so edited extensions\n * are picked up when a new harness instance is created for a conversation.\n */\nasync function importExtensionModule(entrypoint: string): Promise<unknown> {\n  const jiti = createJiti(import.meta.url, { moduleCache: false, fsCache: false });\n  return jiti.import(entrypoint);\n}\n\n/**\n * Canonical host-only extension code directories for a conversation, in load\n * order: `<stateDir>/global/extensions` (all conversations) then\n * `<stateDir>/conversations/<conversationId>/extensions` (that conversation\n * only). `global` and `conversations` are the two sibling scopes; see\n * `LAYOUT.md`. Conversation ids are used verbatim (see LAYOUT.md § Casing).\n */\nexport function defaultExtensionDirs(\n  conversationId: string,\n  stateDir: string = join(homedir(), \".mikan\"),\n): string[] {\n  return [\n    join(stateDir, \"global\", \"extensions\"),\n    join(stateDir, \"conversations\", conversationId, \"extensions\"),\n  ];\n}\n\n/** Discovery-only view of an installed extension (module is not imported). */\nexport interface InstalledExtensionInfo {\n  /** Display name: manifest name, falling back to the slug. */\n  name: string;\n  slug: string;\n  path: string;\n  /** Scan directory the extension was found in. */\n  dir: string;\n  version?: string;\n  description?: string;\n  /** Names of skills shipped in the extension's skills/ directory. */\n  skillNames: string[];\n}\n\n/**\n * List installed extensions without importing or activating them — safe for\n * inventory surfaces (commands, portal). Activation side effects (schedule\n * upserts, tool registration) only happen in {@link loadExtensions}.\n */\nexport function listInstalledExtensions(dirs: string[]): InstalledExtensionInfo[] {\n  const infos: InstalledExtensionInfo[] = [];\n  for (const dir of dirs) {\n    for (const { entrypoint, rootDir } of discoverExtensionEntrypoints(dir)) {\n      const slug = slugForRoot(rootDir);\n      const manifest = readManifest(rootDir);\n      infos.push({\n        name: manifest.name ?? slug,\n        slug,\n        path: entrypoint,\n        dir,\n        version: manifest.version,\n        description: manifest.description,\n        skillNames: loadExtensionSkills(rootDir, slug).map((skill) => skill.name),\n      });\n    }\n  }\n  return infos;\n}\n\nexport interface LoadExtensionsOptions {\n  /** Directories to scan for extensions. Missing directories are skipped. */\n  dirs: string[];\n  context: {\n    conversationId: string;\n    workspaceDir: string;\n    model: Model<Api>;\n    thinkingLevel: ThinkingLevel;\n  };\n  /** Embedder-provided services backing the v2 api surface. */\n  services?: ExtensionHostServices;\n}\n\nexport interface LoadExtensionsResult {\n  registry: ExtensionRegistry;\n  extensions: LoadedExtension[];\n  errors: ExtensionLoadError[];\n  /** Skills contributed by extensions (inline: bodies ride in the prompt). */\n  skills: MikanSkill[];\n  /**\n   * Run extension disposers (from `api.onDispose` and `activate` return\n   * values). Call when the harness instance owning these extensions is\n   * discarded. Idempotent; disposer errors are logged, never thrown.\n   */\n  dispose(): Promise<void>;\n}\n\n/**\n * A discovered extension: its entrypoint (module to import) and root dir\n * (used for slug, manifest.json, and skills/ — which sit at the extension\n * root, not necessarily next to a nested entrypoint).\n */\ninterface DiscoveredExtension {\n  entrypoint: string;\n  rootDir: string;\n}\n\nfunction discoverExtensionEntrypoints(dir: string): DiscoveredExtension[] {\n  if (!existsSync(dir)) return [];\n  const found: DiscoveredExtension[] = [];\n  for (const name of readdirSync(dir).toSorted()) {\n    if (name.startsWith(\".\")) continue;\n    if (INDEX_FILE_PATTERN.test(name)) {\n      // An index file at the scan root means the extension's contents were\n      // copied into the scope directory itself; the slug would degenerate to\n      // the scope name (e.g. the conversation id), mis-keying its data dir,\n      // secrets, and schedules. Require a named form instead.\n      log.logWarning(\n        `Ignoring extension index file at scope root: ${join(dir, name)}`,\n        \"install into a named subdirectory (e.g. extensions/<scope>/my-ext/index.mjs)\",\n      );\n      continue;\n    }\n    const fullPath = join(dir, name);\n    let stats;\n    try {\n      stats = statSync(fullPath);\n    } catch {\n      continue;\n    }\n    if (stats.isFile() && EXTENSION_FILE_PATTERN.test(name)) {\n      // Bare-file form: the file is both entrypoint and (its own) root.\n      found.push({ entrypoint: fullPath, rootDir: fullPath });\n      continue;\n    }\n    if (stats.isDirectory()) {\n      const entrypoint = resolveDirectoryEntrypoint(fullPath);\n      if (entrypoint) found.push({ entrypoint, rootDir: fullPath });\n    }\n  }\n  return found;\n}\n\n/**\n * Resolve a directory-form extension's entrypoint. A `package.json` with a\n * `mikan.extensions` array (first entry, relative to the dir) wins — this is\n * how an extension declares a TypeScript entry and pulls in npm dependencies.\n * Otherwise fall back to an `index.{mjs,js,ts,mts}` file. Returns undefined\n * when neither is present.\n */\nfunction resolveDirectoryEntrypoint(dir: string): string | undefined {\n  const declared = readMikanManifestEntrypoints(dir)[0];\n  if (declared) {\n    const resolved = join(dir, declared);\n    if (existsSync(resolved)) return resolved;\n    log.logWarning(\n      `Extension package.json declares a missing entrypoint: ${resolved}`,\n      \"falling back to an index file\",\n    );\n  }\n  for (const candidate of INDEX_CANDIDATES) {\n    const indexPath = join(dir, candidate);\n    if (existsSync(indexPath)) return indexPath;\n  }\n  return undefined;\n}\n\ninterface ExtensionPackageJson {\n  name?: string;\n  version?: string;\n  description?: string;\n  mikan?: { extensions?: string[]; displayName?: string };\n}\n\n/** Read and shape a directory's package.json; undefined when absent/malformed. */\nfunction readPackageJson(dir: string): ExtensionPackageJson | undefined {\n  const packageJsonPath = join(dir, \"package.json\");\n  if (!existsSync(packageJsonPath)) return undefined;\n  try {\n    const parsed = JSON.parse(readFileSync(packageJsonPath, \"utf-8\")) as unknown;\n    if (!parsed || typeof parsed !== \"object\") return undefined;\n    const record = parsed as Record<string, unknown>;\n    const mikanRaw = record.mikan as { extensions?: unknown; displayName?: unknown } | undefined;\n    return {\n      name: typeof record.name === \"string\" ? record.name : undefined,\n      version: typeof record.version === \"string\" ? record.version : undefined,\n      description: typeof record.description === \"string\" ? record.description : undefined,\n      mikan: {\n        extensions: Array.isArray(mikanRaw?.extensions)\n          ? mikanRaw.extensions.filter((entry): entry is string => typeof entry === \"string\")\n          : undefined,\n        displayName: typeof mikanRaw?.displayName === \"string\" ? mikanRaw.displayName : undefined,\n      },\n    };\n  } catch (err) {\n    log.logWarning(`Ignoring malformed package.json: ${packageJsonPath}`, String(err));\n    return undefined;\n  }\n}\n\n/** Read the `mikan.extensions` entrypoint list from a directory's package.json. */\nfunction readMikanManifestEntrypoints(dir: string): string[] {\n  return readPackageJson(dir)?.mikan?.extensions ?? [];\n}\n\nfunction sanitizeSlug(base: string): string {\n  const slug = base\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 64);\n  return slug || \"extension\";\n}\n\n/**\n * Filesystem-safe identifier for an extension, derived from its install\n * location: the directory name for a directory-form extension, or the file\n * basename for a bare file. The slug keys the extension's data dir, secrets\n * vault, and schedule ownership — installing the same extension globally and\n * per-conversation shares one slug and therefore one shared data dir.\n */\nexport function extensionSlug(entrypoint: string): string {\n  // Bare-file form (rootDir === entrypoint, a *.mjs/.ts file) → file basename.\n  // Directory form → directory name. Detect the directory form structurally:\n  // an entrypoint whose parent holds a package.json or is an index file.\n  if (INDEX_FILE_PATTERN.test(basename(entrypoint))) {\n    return sanitizeSlug(basename(dirname(entrypoint)));\n  }\n  return sanitizeSlug(basename(entrypoint).replace(EXTENSION_FILE_PATTERN, \"\"));\n}\n\n/** Slug from a discovered extension's root dir (directory or bare file path). */\nfunction slugForRoot(rootDir: string): string {\n  return EXTENSION_FILE_PATTERN.test(basename(rootDir))\n    ? sanitizeSlug(basename(rootDir).replace(EXTENSION_FILE_PATTERN, \"\"))\n    : sanitizeSlug(basename(rootDir));\n}\n\n/** Sanitize an extension-chosen schedule name into a filename segment. */\nfunction scheduleNameSegment(name: string): string {\n  const segment = name\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 64);\n  if (!segment) throw new Error(`Invalid schedule name: ${JSON.stringify(name)}`);\n  return segment;\n}\n\n/**\n * Read display metadata (name/version/description) for a directory-form\n * extension. `package.json` is the primary source — its standard `name`,\n * `version`, `description`, plus an optional `mikan.displayName` that\n * overrides the npm name for the user-facing label (npm names are\n * lowercase/scoped; display names can be arbitrary). A `manifest.json` is a\n * fallback for extensions that ship no package.json.\n */\nfunction readManifest(rootDir: string): ExtensionManifest {\n  // Bare-file extensions (rootDir is a *.mjs/.ts file) have no manifest.\n  if (EXTENSION_FILE_PATTERN.test(basename(rootDir))) return {};\n\n  const pkg = readPackageJson(rootDir);\n  if (pkg && (pkg.mikan?.displayName ?? pkg.name ?? pkg.version ?? pkg.description)) {\n    return {\n      name: pkg.mikan?.displayName ?? pkg.name,\n      version: pkg.version,\n      description: pkg.description,\n    };\n  }\n\n  const manifestPath = join(rootDir, \"manifest.json\");\n  if (!existsSync(manifestPath)) return {};\n  try {\n    const parsed: unknown = JSON.parse(readFileSync(manifestPath, \"utf-8\"));\n    if (!parsed || typeof parsed !== \"object\") return {};\n    const record = parsed as Record<string, unknown>;\n    return {\n      name: typeof record.name === \"string\" ? record.name : undefined,\n      version: typeof record.version === \"string\" ? record.version : undefined,\n      description: typeof record.description === \"string\" ? record.description : undefined,\n    };\n  } catch (err) {\n    log.logWarning(`Ignoring malformed extension manifest: ${manifestPath}`, String(err));\n    return {};\n  }\n}\n\n/**\n * Skills shipped inside a directory-form extension (`<dir>/skills/`).\n * Marked inline: extension files live under the host-only state dir, which\n * sandbox containers cannot read, so skill bodies must ride in the prompt.\n */\nfunction loadExtensionSkills(rootDir: string, slug: string): MikanSkill[] {\n  // Bare-file extensions (rootDir is a *.mjs/.ts file) ship no skills.\n  if (EXTENSION_FILE_PATTERN.test(basename(rootDir))) return [];\n  const skillsDir = join(rootDir, \"skills\");\n  if (!existsSync(skillsDir)) return [];\n  const result = loadSkillsFromDir({ dir: skillsDir, source: `extension:${slug}` });\n  for (const diagnostic of result.diagnostics) {\n    log.logWarning(`Extension skill warning (${slug}): ${diagnostic.message}`, diagnostic.path);\n  }\n  for (const skill of result.skills) skill.inline = true;\n  return result.skills;\n}\n\nconst SCHEDULE_FILE_SUFFIX = \".json\";\n\nfunction schedulePrefix(slug: string, conversationId: string): string {\n  return `ext.${slug}.${scheduleNameSegment(conversationId)}.`;\n}\n\nfunction payloadFromSpec(\n  spec: ExtensionScheduleSpec,\n  conversationId: string,\n): ExtensionSchedulePayload {\n  if (spec.type === \"periodic\") {\n    if (!spec.schedule || !spec.timezone) {\n      throw new Error(\"periodic schedule requires schedule and timezone\");\n    }\n    return {\n      type: \"periodic\",\n      conversationId,\n      text: spec.text,\n      schedule: spec.schedule,\n      timezone: spec.timezone,\n      ...(spec.platform ? { platform: spec.platform } : {}),\n    };\n  }\n  if (!spec.at) throw new Error(\"one-shot schedule requires at\");\n  return {\n    type: \"one-shot\",\n    conversationId,\n    text: spec.text,\n    at: spec.at,\n    ...(spec.platform ? { platform: spec.platform } : {}),\n  };\n}\n\nfunction specFromPayload(payload: ExtensionSchedulePayload): ExtensionScheduleSpec {\n  if (payload.type === \"periodic\") {\n    return {\n      type: \"periodic\",\n      schedule: payload.schedule ?? \"\",\n      timezone: payload.timezone ?? \"\",\n      text: payload.text,\n      ...(payload.platform ? { platform: payload.platform } : {}),\n    };\n  }\n  return {\n    type: \"one-shot\",\n    at: payload.at ?? \"\",\n    text: payload.text,\n    ...(payload.platform ? { platform: payload.platform } : {}),\n  };\n}\n\n/** Build the v2 api surface for one extension over the injected services. */\nfunction buildExtensionApi(params: {\n  name: string;\n  slug: string;\n  registry: ExtensionRegistry;\n  context: LoadExtensionsOptions[\"context\"];\n  services: ExtensionHostServices;\n}): MikanExtensionApi {\n  const { name, slug, registry, context, services } = params;\n  const stateDir = services.stateDir ?? join(homedir(), \".mikan\");\n  const conversationId = context.conversationId;\n\n  const requireScheduleStore = () => {\n    if (!services.scheduleStore) {\n      throw new Error(\"api.schedules is unavailable: this context provides no schedule store\");\n    }\n    return services.scheduleStore;\n  };\n\n  return {\n    on: (hook, handler) => registry.register(name, hook, handler),\n    registerTool: (tool: AgentTool) => registry.registerTool(tool),\n    registerCommand: (command: ExtensionCommand) => registry.registerCommand(name, command),\n    onDispose: (disposer: ExtensionDisposer) => registry.registerDisposer(name, disposer),\n    log: (message: string) => log.logInfo(`[extension:${name}] ${message}`),\n    context,\n    paths: {\n      get dataDir(): string {\n        // This conversation's own data, co-located with the conversation's\n        // other host-only assets; removed when the conversation is deleted.\n        const dir = join(stateDir, \"conversations\", conversationId, \"extension-data\", slug);\n        mkdirSync(dir, { recursive: true });\n        return dir;\n      },\n      get sharedDataDir(): string {\n        // Cross-conversation data under the sibling `global` scope.\n        const dir = join(stateDir, \"global\", \"extension-data\", slug);\n        mkdirSync(dir, { recursive: true });\n        return dir;\n      },\n    },\n    secrets: {\n      get: (key: string) => services.resolveSecrets?.(slug)[key],\n      list: () => Object.keys(services.resolveSecrets?.(slug) ?? {}),\n    },\n    schedules: {\n      upsert: async (scheduleName, spec) => {\n        const store = requireScheduleStore();\n        const filename = `${schedulePrefix(slug, conversationId)}${scheduleNameSegment(scheduleName)}${SCHEDULE_FILE_SUFFIX}`;\n        await store.write(filename, payloadFromSpec(spec, conversationId));\n      },\n      delete: async (scheduleName) => {\n        const store = requireScheduleStore();\n        const filename = `${schedulePrefix(slug, conversationId)}${scheduleNameSegment(scheduleName)}${SCHEDULE_FILE_SUFFIX}`;\n        return store.delete(filename);\n      },\n      list: async () => {\n        const store = requireScheduleStore();\n        const prefix = schedulePrefix(slug, conversationId);\n        const infos: ExtensionScheduleInfo[] = [];\n        for (const entry of await store.list()) {\n          if (!entry.filename.startsWith(prefix)) continue;\n          if (!entry.filename.endsWith(SCHEDULE_FILE_SUFFIX)) continue;\n          infos.push({\n            name: entry.filename.slice(prefix.length, -SCHEDULE_FILE_SUFFIX.length),\n            spec: specFromPayload(entry.payload),\n          });\n        }\n        return infos;\n      },\n    },\n    subagent: {\n      run: async (request) => {\n        if (!services.runSubagent) {\n          throw new Error(\"api.subagent is unavailable: this context provides no subagent runner\");\n        }\n        return services.runSubagent(request, registry.getContributedTools());\n      },\n    },\n    notify: async (text: string, options?: { conversationId?: string }) => {\n      if (!services.postMessage) {\n        throw new Error(\"api.notify is unavailable: this context provides no platform messaging\");\n      }\n      await services.postMessage(options?.conversationId ?? conversationId, text);\n    },\n    react: async (messageTs: string, emoji: string) => {\n      if (!services.addReaction) {\n        throw new Error(\"api.react is unavailable: this context provides no reaction support\");\n      }\n      await services.addReaction(conversationId, messageTs, emoji);\n    },\n    uploadFile: async (filePath: string, title?: string) => {\n      if (!services.uploadFile) {\n        throw new Error(\"api.uploadFile is unavailable: this context provides no file uploads\");\n      }\n      await services.uploadFile(conversationId, filePath, title);\n    },\n    triggerRun: async (text: string) => {\n      const store = requireScheduleStore();\n      // Distinct \"extrun.\" namespace: run files must never surface in\n      // api.schedules.list(), whose ownership filter is the \"ext.\" prefix.\n      // The embedder's watcher fires and deletes the file immediately.\n      const filename = `extrun.${slug}.${scheduleNameSegment(conversationId)}.${Date.now()}-${runCounter++}${SCHEDULE_FILE_SUFFIX}`;\n      await store.write(filename, { type: \"immediate\", conversationId, text });\n    },\n  };\n}\n\n/** Monotonic suffix so rapid triggerRun calls in one process never collide. */\nlet runCounter = 0;\n\nfunction resolveActivate(moduleExports: unknown): MikanExtensionModule | undefined {\n  if (!moduleExports || typeof moduleExports !== \"object\") return undefined;\n  const candidates: unknown[] = [(moduleExports as { default?: unknown }).default, moduleExports];\n  for (const candidate of candidates) {\n    if (typeof candidate === \"function\") {\n      return { activate: candidate as MikanExtensionActivate };\n    }\n    if (candidate && typeof candidate === \"object\") {\n      const activate = (candidate as { activate?: unknown }).activate;\n      if (typeof activate === \"function\") {\n        return {\n          name:\n            typeof (candidate as { name?: unknown }).name === \"string\"\n              ? (candidate as { name: string }).name\n              : undefined,\n          activate: activate as MikanExtensionActivate,\n        };\n      }\n    }\n  }\n  return undefined;\n}\n\n/** Load and activate all extensions found in the given directories. */\nexport async function loadExtensions(\n  options: LoadExtensionsOptions,\n): Promise<LoadExtensionsResult> {\n  const registry = new ExtensionRegistry();\n  const extensions: LoadedExtension[] = [];\n  const errors: ExtensionLoadError[] = [];\n  const skills: MikanSkill[] = [];\n  const services = options.services ?? {};\n\n  for (const dir of options.dirs) {\n    for (const { entrypoint, rootDir } of discoverExtensionEntrypoints(dir)) {\n      try {\n        const moduleExports: unknown = await importExtensionModule(entrypoint);\n        const extension = resolveActivate(moduleExports);\n        if (!extension) {\n          errors.push({\n            path: entrypoint,\n            error: \"extension must export an activate function (default or named)\",\n          });\n          continue;\n        }\n        const slug = slugForRoot(rootDir);\n        const manifest = readManifest(rootDir);\n        const name = manifest.name ?? extension.name ?? slug;\n        const api = buildExtensionApi({\n          name,\n          slug,\n          registry,\n          context: options.context,\n          services,\n        });\n        const disposer = await extension.activate(api);\n        if (typeof disposer === \"function\") registry.registerDisposer(name, disposer);\n        const extensionSkills = loadExtensionSkills(rootDir, slug);\n        skills.push(...extensionSkills);\n        extensions.push({\n          name,\n          path: entrypoint,\n          slug,\n          version: manifest.version,\n          description: manifest.description,\n          skills: extensionSkills,\n        });\n      } catch (err) {\n        errors.push({\n          path: entrypoint,\n          error: err instanceof Error ? err.message : String(err),\n        });\n      }\n    }\n  }\n\n  return { registry, extensions, errors, skills, dispose: () => registry.dispose() };\n}\n\nexport interface ExtensionValidation {\n  ok: boolean;\n  /** Slug the extension would install as (from the source dir/file name). */\n  slug: string;\n  /** Display name (manifest name, else slug). */\n  name: string;\n  version?: string;\n  description?: string;\n  /** Resolved entrypoint that would be imported. */\n  entrypoint?: string;\n  /** Skill names shipped alongside the extension. */\n  skillNames: string[];\n  errors: string[];\n  warnings: string[];\n}\n\n/**\n * Validate an extension source path (a directory or a single file) WITHOUT\n * activating it: resolves the entrypoint (package.json `mikan.extensions`,\n * index file, or the file itself), imports it, and checks it exports an\n * `activate` function. Used by `mikan ext install` as a preflight and by\n * `mikan ext validate`. Importing runs top-level module code but not\n * `activate`, so there are no schedule/tool side effects.\n */\nexport async function validateExtension(sourcePath: string): Promise<ExtensionValidation> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const rootDir = sourcePath.replace(/[/\\\\]+$/, \"\");\n  const base = basename(rootDir);\n\n  if (INDEX_FILE_PATTERN.test(base)) {\n    warnings.push(\n      \"Entry is a bare index file; install into a named directory so the slug is stable.\",\n    );\n  }\n\n  let entrypoint: string | undefined;\n  if (!existsSync(rootDir)) {\n    errors.push(`Path does not exist: ${rootDir}`);\n  } else if (statSync(rootDir).isDirectory()) {\n    entrypoint = resolveDirectoryEntrypoint(rootDir);\n    if (!entrypoint) {\n      errors.push(\n        \"No entrypoint found: expected package.json with a mikan.extensions entry, or an index.{mjs,js,ts,mts}.\",\n      );\n    }\n  } else if (EXTENSION_FILE_PATTERN.test(base)) {\n    entrypoint = rootDir;\n  } else {\n    errors.push(`Not an extension file (expected .mjs/.js/.ts/.mts): ${rootDir}`);\n  }\n\n  const slug = slugForRoot(rootDir);\n  const manifest = readManifest(rootDir);\n  const skillNames = loadExtensionSkills(rootDir, slug).map((skill) => skill.name);\n\n  if (entrypoint) {\n    try {\n      const moduleExports: unknown = await importExtensionModule(entrypoint);\n      if (!resolveActivate(moduleExports)) {\n        errors.push(\"Module does not export an activate function (default or named).\");\n      }\n    } catch (err) {\n      errors.push(`Failed to import: ${err instanceof Error ? err.message : String(err)}`);\n    }\n  }\n\n  return {\n    ok: errors.length === 0,\n    slug,\n    name: manifest.name ?? slug,\n    version: manifest.version,\n    description: manifest.description,\n    entrypoint,\n    skillNames,\n    errors,\n    warnings,\n  };\n}\n"]}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/harness/extensions/loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Extension discovery and activation.\n *\n * Extension modules execute inside the mikan host process with its full\n * privileges (platform tokens, vault, host filesystem). They must therefore\n * only ever load from host-controlled directories: installing an extension\n * is an administrator action. In particular, extension directories must not\n * live under paths mounted into sandbox containers (workspace and\n * conversation dirs in image mode), or code written from inside the sandbox\n * would be imported into the host process — a sandbox escape.\n * {@link defaultExtensionDirs} returns the canonical host-only locations\n * under mikan's state dir.\n *\n * Directories are scanned in order; all discovered extensions activate.\n * Accepted layouts (entrypoint may be .mjs/.js/.ts/.mts — loaded via jiti):\n *\n * - `extensions/<name>.<ext>`                     (bare file)\n * - `extensions/<name>/index.<ext>`               (directory + index)\n * - `extensions/<name>/package.json`              (mikan.extensions entrypoint;\n *   may carry npm dependencies in node_modules)\n *\n * Modules are imported with a fresh jiti instance (no cache) so edited\n * extensions are picked up when a new harness instance is created.\n */\nimport { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { basename, join } from \"path\";\nimport { createJiti } from \"jiti\";\nimport type { AgentTool, ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport * as log from \"../../log.js\";\nimport { buildEventPayload } from \"../event-format.js\";\nimport { loadSkillsFromDir, type MikanSkill } from \"../skills.js\";\nimport { ExtensionRegistry } from \"./registry.js\";\nimport type {\n  ExtensionCommand,\n  ExtensionDisposer,\n  ExtensionHostServices,\n  ExtensionLoadError,\n  ExtensionManifest,\n  ExtensionSchedulePayload,\n  ExtensionScheduleInfo,\n  ExtensionScheduleSpec,\n  LoadedExtension,\n  MikanExtensionActivate,\n  MikanExtensionApi,\n  MikanExtensionModule,\n} from \"./types.js\";\n\nconst EXTENSION_FILE_PATTERN = /\\.(mjs|js|ts|mts)$/;\nconst INDEX_FILE_PATTERN = /^index\\.(mjs|js|ts|mts)$/;\nconst INDEX_CANDIDATES = [\"index.mjs\", \"index.js\", \"index.ts\", \"index.mts\"];\n\n/**\n * Import an extension entrypoint through jiti so it can be TypeScript and can\n * use node_modules dependencies, transparently compiling on the fly. A fresh\n * jiti instance with caching disabled is used per load so edited extensions\n * are picked up when a new harness instance is created for a conversation.\n */\nasync function importExtensionModule(entrypoint: string): Promise<unknown> {\n  const jiti = createJiti(import.meta.url, { moduleCache: false, fsCache: false });\n  return jiti.import(entrypoint);\n}\n\n/**\n * Canonical host-only extension code directories for a conversation, in load\n * order: `<stateDir>/global/extensions` (all conversations) then\n * `<stateDir>/conversations/<conversationId>/extensions` (that conversation\n * only). `global` and `conversations` are the two sibling scopes; see\n * `LAYOUT.md`. Conversation ids are used verbatim (see LAYOUT.md § Casing).\n */\nexport function defaultExtensionDirs(\n  conversationId: string,\n  stateDir: string = join(homedir(), \".mikan\"),\n): string[] {\n  return [\n    join(stateDir, \"global\", \"extensions\"),\n    join(stateDir, \"conversations\", conversationId, \"extensions\"),\n  ];\n}\n\n/** Discovery-only view of an installed extension (module is not imported). */\nexport interface InstalledExtensionInfo {\n  /** Display name: manifest name, falling back to the slug. */\n  name: string;\n  slug: string;\n  path: string;\n  /** Scan directory the extension was found in. */\n  dir: string;\n  version?: string;\n  description?: string;\n  /** Names of skills shipped in the extension's skills/ directory. */\n  skillNames: string[];\n}\n\n/**\n * List installed extensions without importing or activating them — safe for\n * inventory surfaces (commands, portal). Activation side effects (schedule\n * upserts, tool registration) only happen in {@link loadExtensions}.\n */\nexport function listInstalledExtensions(dirs: string[]): InstalledExtensionInfo[] {\n  const infos: InstalledExtensionInfo[] = [];\n  for (const dir of dirs) {\n    for (const { entrypoint, rootDir } of discoverExtensionEntrypoints(dir)) {\n      const slug = extensionSlug(rootDir);\n      const manifest = readManifest(rootDir);\n      infos.push({\n        name: manifest.name ?? slug,\n        slug,\n        path: entrypoint,\n        dir,\n        version: manifest.version,\n        description: manifest.description,\n        skillNames: loadExtensionSkills(rootDir, slug).map((skill) => skill.name),\n      });\n    }\n  }\n  return infos;\n}\n\nexport interface LoadExtensionsOptions {\n  /** Directories to scan for extensions. Missing directories are skipped. */\n  dirs: string[];\n  context: {\n    conversationId: string;\n    workspaceDir: string;\n    model: Model<Api>;\n    thinkingLevel: ThinkingLevel;\n  };\n  /** Embedder-provided services backing the v2 api surface. */\n  services?: ExtensionHostServices;\n}\n\nexport interface LoadExtensionsResult {\n  registry: ExtensionRegistry;\n  extensions: LoadedExtension[];\n  errors: ExtensionLoadError[];\n  /** Skills contributed by extensions (inline: bodies ride in the prompt). */\n  skills: MikanSkill[];\n  /**\n   * Run extension disposers (from `api.onDispose` and `activate` return\n   * values). Call when the harness instance owning these extensions is\n   * discarded. Idempotent; disposer errors are logged, never thrown.\n   */\n  dispose(): Promise<void>;\n}\n\n/**\n * A discovered extension: its entrypoint (module to import) and root dir\n * (used for slug, manifest.json, and skills/ — which sit at the extension\n * root, not necessarily next to a nested entrypoint).\n */\ninterface DiscoveredExtension {\n  entrypoint: string;\n  rootDir: string;\n}\n\nfunction discoverExtensionEntrypoints(dir: string): DiscoveredExtension[] {\n  if (!existsSync(dir)) return [];\n  const found: DiscoveredExtension[] = [];\n  for (const name of readdirSync(dir).toSorted()) {\n    if (name.startsWith(\".\")) continue;\n    if (INDEX_FILE_PATTERN.test(name)) {\n      // An index file at the scan root means the extension's contents were\n      // copied into the scope directory itself; the slug would degenerate to\n      // the scope name (e.g. the conversation id), mis-keying its data dir,\n      // secrets, and schedules. Require a named form instead.\n      log.logWarning(\n        `Ignoring extension index file at scope root: ${join(dir, name)}`,\n        \"install into a named subdirectory (e.g. extensions/<scope>/my-ext/index.mjs)\",\n      );\n      continue;\n    }\n    const fullPath = join(dir, name);\n    let stats;\n    try {\n      stats = statSync(fullPath);\n    } catch {\n      continue;\n    }\n    if (stats.isFile() && EXTENSION_FILE_PATTERN.test(name)) {\n      // Bare-file form: the file is both entrypoint and (its own) root.\n      found.push({ entrypoint: fullPath, rootDir: fullPath });\n      continue;\n    }\n    if (stats.isDirectory()) {\n      const entrypoint = resolveDirectoryEntrypoint(fullPath);\n      if (entrypoint) found.push({ entrypoint, rootDir: fullPath });\n    }\n  }\n  return found;\n}\n\n/**\n * Resolve a directory-form extension's entrypoint. A `package.json` with a\n * `mikan.extensions` array (first entry, relative to the dir) wins — this is\n * how an extension declares a TypeScript entry and pulls in npm dependencies.\n * Otherwise fall back to an `index.{mjs,js,ts,mts}` file. Returns undefined\n * when neither is present.\n */\nfunction resolveDirectoryEntrypoint(dir: string): string | undefined {\n  const declared = readMikanManifestEntrypoints(dir)[0];\n  if (declared) {\n    const resolved = join(dir, declared);\n    if (existsSync(resolved)) return resolved;\n    log.logWarning(\n      `Extension package.json declares a missing entrypoint: ${resolved}`,\n      \"falling back to an index file\",\n    );\n  }\n  for (const candidate of INDEX_CANDIDATES) {\n    const indexPath = join(dir, candidate);\n    if (existsSync(indexPath)) return indexPath;\n  }\n  return undefined;\n}\n\ninterface ExtensionPackageJson {\n  name?: string;\n  version?: string;\n  description?: string;\n  mikan?: { extensions?: string[]; displayName?: string };\n}\n\n/** Read and shape a directory's package.json; undefined when absent/malformed. */\nfunction readPackageJson(dir: string): ExtensionPackageJson | undefined {\n  const packageJsonPath = join(dir, \"package.json\");\n  if (!existsSync(packageJsonPath)) return undefined;\n  try {\n    const parsed = JSON.parse(readFileSync(packageJsonPath, \"utf-8\")) as unknown;\n    if (!parsed || typeof parsed !== \"object\") return undefined;\n    const record = parsed as Record<string, unknown>;\n    const mikanRaw = record.mikan as { extensions?: unknown; displayName?: unknown } | undefined;\n    return {\n      name: typeof record.name === \"string\" ? record.name : undefined,\n      version: typeof record.version === \"string\" ? record.version : undefined,\n      description: typeof record.description === \"string\" ? record.description : undefined,\n      mikan: {\n        extensions: Array.isArray(mikanRaw?.extensions)\n          ? mikanRaw.extensions.filter((entry): entry is string => typeof entry === \"string\")\n          : undefined,\n        displayName: typeof mikanRaw?.displayName === \"string\" ? mikanRaw.displayName : undefined,\n      },\n    };\n  } catch (err) {\n    log.logWarning(`Ignoring malformed package.json: ${packageJsonPath}`, String(err));\n    return undefined;\n  }\n}\n\n/** Read the `mikan.extensions` entrypoint list from a directory's package.json. */\nfunction readMikanManifestEntrypoints(dir: string): string[] {\n  return readPackageJson(dir)?.mikan?.extensions ?? [];\n}\n\n/** The one filesystem-safe segment sanitizer for extension identity and schedule names. */\nfunction sanitizeSegment(value: string): string {\n  return value\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 64);\n}\n\nfunction sanitizeSlug(base: string): string {\n  return sanitizeSegment(base) || \"extension\";\n}\n\n/**\n * Filesystem-safe identifier for an extension, derived from its root (the\n * install directory, or the file path for a bare-file extension). The slug\n * keys the extension's data dir, secrets vault, and schedule ownership —\n * installing the same extension globally and per-conversation shares one\n * slug and therefore one shared data dir. This is the only slug derivation:\n * a second one keyed off a different input (e.g. the entrypoint, which for\n * package.json-form extensions can live under dist/) would silently split an\n * extension's identity.\n */\nexport function extensionSlug(rootDir: string): string {\n  return EXTENSION_FILE_PATTERN.test(basename(rootDir))\n    ? sanitizeSlug(basename(rootDir).replace(EXTENSION_FILE_PATTERN, \"\"))\n    : sanitizeSlug(basename(rootDir));\n}\n\n/** Sanitize an extension-chosen schedule name into a filename segment. */\nfunction scheduleNameSegment(name: string): string {\n  const segment = sanitizeSegment(name);\n  if (!segment) throw new Error(`Invalid schedule name: ${JSON.stringify(name)}`);\n  return segment;\n}\n\n/**\n * Read display metadata (name/version/description) for a directory-form\n * extension. `package.json` is the primary source — its standard `name`,\n * `version`, `description`, plus an optional `mikan.displayName` that\n * overrides the npm name for the user-facing label (npm names are\n * lowercase/scoped; display names can be arbitrary). A `manifest.json` is a\n * fallback for extensions that ship no package.json.\n */\nfunction readManifest(rootDir: string): ExtensionManifest {\n  // Bare-file extensions (rootDir is a *.mjs/.ts file) have no manifest.\n  if (EXTENSION_FILE_PATTERN.test(basename(rootDir))) return {};\n\n  const pkg = readPackageJson(rootDir);\n  if (pkg && (pkg.mikan?.displayName ?? pkg.name ?? pkg.version ?? pkg.description)) {\n    return {\n      name: pkg.mikan?.displayName ?? pkg.name,\n      version: pkg.version,\n      description: pkg.description,\n    };\n  }\n\n  const manifestPath = join(rootDir, \"manifest.json\");\n  if (!existsSync(manifestPath)) return {};\n  try {\n    const parsed: unknown = JSON.parse(readFileSync(manifestPath, \"utf-8\"));\n    if (!parsed || typeof parsed !== \"object\") return {};\n    const record = parsed as Record<string, unknown>;\n    return {\n      name: typeof record.name === \"string\" ? record.name : undefined,\n      version: typeof record.version === \"string\" ? record.version : undefined,\n      description: typeof record.description === \"string\" ? record.description : undefined,\n    };\n  } catch (err) {\n    log.logWarning(`Ignoring malformed extension manifest: ${manifestPath}`, String(err));\n    return {};\n  }\n}\n\n/**\n * Skills shipped inside a directory-form extension (`<dir>/skills/`).\n * Marked inline: extension files live under the host-only state dir, which\n * sandbox containers cannot read, so skill bodies must ride in the prompt.\n */\nfunction loadExtensionSkills(rootDir: string, slug: string): MikanSkill[] {\n  // Bare-file extensions (rootDir is a *.mjs/.ts file) ship no skills.\n  if (EXTENSION_FILE_PATTERN.test(basename(rootDir))) return [];\n  const skillsDir = join(rootDir, \"skills\");\n  if (!existsSync(skillsDir)) return [];\n  const result = loadSkillsFromDir({ dir: skillsDir, source: `extension:${slug}` });\n  for (const diagnostic of result.diagnostics) {\n    log.logWarning(`Extension skill warning (${slug}): ${diagnostic.message}`, diagnostic.path);\n  }\n  for (const skill of result.skills) skill.inline = true;\n  return result.skills;\n}\n\nconst SCHEDULE_FILE_SUFFIX = \".json\";\n\nfunction schedulePrefix(slug: string, conversationId: string): string {\n  return `ext.${slug}.${scheduleNameSegment(conversationId)}.`;\n}\n\nfunction payloadFromSpec(\n  spec: ExtensionScheduleSpec,\n  conversationId: string,\n): ExtensionSchedulePayload {\n  // Per-type validation (schedule/timezone for periodic, at for one-shot)\n  // is owned by the event-format builder.\n  return buildEventPayload({\n    type: spec.type,\n    conversationId,\n    text: spec.text,\n    ...(spec.platform ? { platform: spec.platform } : {}),\n    ...(spec.type === \"periodic\"\n      ? { schedule: spec.schedule, timezone: spec.timezone }\n      : { at: spec.at }),\n  });\n}\n\nfunction specFromPayload(payload: ExtensionSchedulePayload): ExtensionScheduleSpec {\n  if (payload.type === \"periodic\") {\n    return {\n      type: \"periodic\",\n      schedule: payload.schedule,\n      timezone: payload.timezone,\n      text: payload.text,\n      ...(payload.platform ? { platform: payload.platform } : {}),\n    };\n  }\n  // `immediate` payloads never appear under the schedules namespace (they\n  // live under \"extrun.\"); tolerate them as an empty one-shot rather than\n  // widening the spec union.\n  return {\n    type: \"one-shot\",\n    at: payload.type === \"one-shot\" ? payload.at : \"\",\n    text: payload.text,\n    ...(payload.platform ? { platform: payload.platform } : {}),\n  };\n}\n\n/** Build the v2 api surface for one extension over the injected services. */\nfunction buildExtensionApi(params: {\n  name: string;\n  slug: string;\n  registry: ExtensionRegistry;\n  context: LoadExtensionsOptions[\"context\"];\n  services: ExtensionHostServices;\n}): MikanExtensionApi {\n  const { name, slug, registry, context, services } = params;\n  const stateDir = services.stateDir ?? join(homedir(), \".mikan\");\n  const conversationId = context.conversationId;\n\n  const requireScheduleStore = () => {\n    if (!services.scheduleStore) {\n      throw new Error(\"api.schedules is unavailable: this context provides no schedule store\");\n    }\n    return services.scheduleStore;\n  };\n\n  return {\n    on: (hook, handler) => registry.register(name, hook, handler),\n    registerTool: (tool: AgentTool) => registry.registerTool(tool),\n    registerCommand: (command: ExtensionCommand) => registry.registerCommand(name, command),\n    onDispose: (disposer: ExtensionDisposer) => registry.registerDisposer(name, disposer),\n    log: (message: string) => log.logInfo(`[extension:${name}] ${message}`),\n    context,\n    paths: {\n      get dataDir(): string {\n        // This conversation's own data, co-located with the conversation's\n        // other host-only assets; removed when the conversation is deleted.\n        const dir = join(stateDir, \"conversations\", conversationId, \"extension-data\", slug);\n        mkdirSync(dir, { recursive: true });\n        return dir;\n      },\n      get sharedDataDir(): string {\n        // Cross-conversation data under the sibling `global` scope.\n        const dir = join(stateDir, \"global\", \"extension-data\", slug);\n        mkdirSync(dir, { recursive: true });\n        return dir;\n      },\n    },\n    secrets: {\n      get: (key: string) => services.resolveSecrets?.(slug)[key],\n      list: () => Object.keys(services.resolveSecrets?.(slug) ?? {}),\n    },\n    schedules: {\n      upsert: async (scheduleName, spec) => {\n        const store = requireScheduleStore();\n        const filename = `${schedulePrefix(slug, conversationId)}${scheduleNameSegment(scheduleName)}${SCHEDULE_FILE_SUFFIX}`;\n        await store.write(filename, payloadFromSpec(spec, conversationId));\n      },\n      delete: async (scheduleName) => {\n        const store = requireScheduleStore();\n        const filename = `${schedulePrefix(slug, conversationId)}${scheduleNameSegment(scheduleName)}${SCHEDULE_FILE_SUFFIX}`;\n        return store.delete(filename);\n      },\n      list: async () => {\n        const store = requireScheduleStore();\n        const prefix = schedulePrefix(slug, conversationId);\n        const infos: ExtensionScheduleInfo[] = [];\n        for (const entry of await store.list()) {\n          if (!entry.filename.startsWith(prefix)) continue;\n          if (!entry.filename.endsWith(SCHEDULE_FILE_SUFFIX)) continue;\n          infos.push({\n            name: entry.filename.slice(prefix.length, -SCHEDULE_FILE_SUFFIX.length),\n            spec: specFromPayload(entry.payload),\n          });\n        }\n        return infos;\n      },\n    },\n    subagent: {\n      run: async (request) => {\n        if (!services.runSubagent) {\n          throw new Error(\"api.subagent is unavailable: this context provides no subagent runner\");\n        }\n        return services.runSubagent(request, registry.getContributedTools());\n      },\n    },\n    notify: async (text: string, options?: { conversationId?: string }) => {\n      if (!services.postMessage) {\n        throw new Error(\"api.notify is unavailable: this context provides no platform messaging\");\n      }\n      await services.postMessage(options?.conversationId ?? conversationId, text);\n    },\n    react: async (messageTs: string, emoji: string) => {\n      if (!services.addReaction) {\n        throw new Error(\"api.react is unavailable: this context provides no reaction support\");\n      }\n      await services.addReaction(conversationId, messageTs, emoji);\n    },\n    uploadFile: async (filePath: string, title?: string) => {\n      if (!services.uploadFile) {\n        throw new Error(\"api.uploadFile is unavailable: this context provides no file uploads\");\n      }\n      await services.uploadFile(conversationId, filePath, title);\n    },\n    triggerRun: async (text: string) => {\n      const store = requireScheduleStore();\n      // Distinct \"extrun.\" namespace: run files must never surface in\n      // api.schedules.list(), whose ownership filter is the \"ext.\" prefix.\n      // The embedder's watcher fires and deletes the file immediately.\n      const filename = `extrun.${slug}.${scheduleNameSegment(conversationId)}.${Date.now()}-${runCounter++}${SCHEDULE_FILE_SUFFIX}`;\n      await store.write(filename, { type: \"immediate\", conversationId, text });\n    },\n  };\n}\n\n/** Monotonic suffix so rapid triggerRun calls in one process never collide. */\nlet runCounter = 0;\n\nfunction resolveActivate(moduleExports: unknown): MikanExtensionModule | undefined {\n  if (!moduleExports || typeof moduleExports !== \"object\") return undefined;\n  const candidates: unknown[] = [(moduleExports as { default?: unknown }).default, moduleExports];\n  for (const candidate of candidates) {\n    if (typeof candidate === \"function\") {\n      return { activate: candidate as MikanExtensionActivate };\n    }\n    if (candidate && typeof candidate === \"object\") {\n      const activate = (candidate as { activate?: unknown }).activate;\n      if (typeof activate === \"function\") {\n        return {\n          name:\n            typeof (candidate as { name?: unknown }).name === \"string\"\n              ? (candidate as { name: string }).name\n              : undefined,\n          activate: activate as MikanExtensionActivate,\n        };\n      }\n    }\n  }\n  return undefined;\n}\n\n/** Load and activate all extensions found in the given directories. */\nexport async function loadExtensions(\n  options: LoadExtensionsOptions,\n): Promise<LoadExtensionsResult> {\n  const registry = new ExtensionRegistry();\n  const extensions: LoadedExtension[] = [];\n  const errors: ExtensionLoadError[] = [];\n  const skills: MikanSkill[] = [];\n  const services = options.services ?? {};\n\n  for (const dir of options.dirs) {\n    for (const { entrypoint, rootDir } of discoverExtensionEntrypoints(dir)) {\n      try {\n        const moduleExports: unknown = await importExtensionModule(entrypoint);\n        const extension = resolveActivate(moduleExports);\n        if (!extension) {\n          errors.push({\n            path: entrypoint,\n            error: \"extension must export an activate function (default or named)\",\n          });\n          continue;\n        }\n        const slug = extensionSlug(rootDir);\n        const manifest = readManifest(rootDir);\n        const name = manifest.name ?? extension.name ?? slug;\n        const api = buildExtensionApi({\n          name,\n          slug,\n          registry,\n          context: options.context,\n          services,\n        });\n        const disposer = await extension.activate(api);\n        if (typeof disposer === \"function\") registry.registerDisposer(name, disposer);\n        const extensionSkills = loadExtensionSkills(rootDir, slug);\n        skills.push(...extensionSkills);\n        extensions.push({\n          name,\n          path: entrypoint,\n          slug,\n          version: manifest.version,\n          description: manifest.description,\n          skills: extensionSkills,\n        });\n      } catch (err) {\n        errors.push({\n          path: entrypoint,\n          error: err instanceof Error ? err.message : String(err),\n        });\n      }\n    }\n  }\n\n  return { registry, extensions, errors, skills, dispose: () => registry.dispose() };\n}\n\nexport interface ExtensionValidation {\n  ok: boolean;\n  /** Slug the extension would install as (from the source dir/file name). */\n  slug: string;\n  /** Display name (manifest name, else slug). */\n  name: string;\n  version?: string;\n  description?: string;\n  /** Resolved entrypoint that would be imported. */\n  entrypoint?: string;\n  /** Skill names shipped alongside the extension. */\n  skillNames: string[];\n  errors: string[];\n  warnings: string[];\n}\n\n/**\n * Validate an extension source path (a directory or a single file) WITHOUT\n * activating it: resolves the entrypoint (package.json `mikan.extensions`,\n * index file, or the file itself), imports it, and checks it exports an\n * `activate` function. Used by `mikan ext install` as a preflight and by\n * `mikan ext validate`. Importing runs top-level module code but not\n * `activate`, so there are no schedule/tool side effects.\n */\nexport async function validateExtension(sourcePath: string): Promise<ExtensionValidation> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const rootDir = sourcePath.replace(/[/\\\\]+$/, \"\");\n  const base = basename(rootDir);\n\n  if (INDEX_FILE_PATTERN.test(base)) {\n    warnings.push(\n      \"Entry is a bare index file; install into a named directory so the slug is stable.\",\n    );\n  }\n\n  let entrypoint: string | undefined;\n  if (!existsSync(rootDir)) {\n    errors.push(`Path does not exist: ${rootDir}`);\n  } else if (statSync(rootDir).isDirectory()) {\n    entrypoint = resolveDirectoryEntrypoint(rootDir);\n    if (!entrypoint) {\n      errors.push(\n        \"No entrypoint found: expected package.json with a mikan.extensions entry, or an index.{mjs,js,ts,mts}.\",\n      );\n    }\n  } else if (EXTENSION_FILE_PATTERN.test(base)) {\n    entrypoint = rootDir;\n  } else {\n    errors.push(`Not an extension file (expected .mjs/.js/.ts/.mts): ${rootDir}`);\n  }\n\n  const slug = extensionSlug(rootDir);\n  const manifest = readManifest(rootDir);\n  const skillNames = loadExtensionSkills(rootDir, slug).map((skill) => skill.name);\n\n  if (entrypoint) {\n    try {\n      const moduleExports: unknown = await importExtensionModule(entrypoint);\n      if (!resolveActivate(moduleExports)) {\n        errors.push(\"Module does not export an activate function (default or named).\");\n      }\n    } catch (err) {\n      errors.push(`Failed to import: ${err instanceof Error ? err.message : String(err)}`);\n    }\n  }\n\n  return {\n    ok: errors.length === 0,\n    slug,\n    name: manifest.name ?? slug,\n    version: manifest.version,\n    description: manifest.description,\n    entrypoint,\n    skillNames,\n    errors,\n    warnings,\n  };\n}\n"]}