@geminixiang/mikan 0.5.2 → 1.0.0-beta.0

package/dist/harness/extensions/loader.js

@@ -0,0 +1,325 @@
+/**
+ * Extension discovery and activation.
+ *
+ * Extension modules execute inside the mikan host process with its full
+ * privileges (platform tokens, vault, host filesystem). They must therefore
+ * only ever load from host-controlled directories: installing an extension
+ * is an administrator action. In particular, extension directories must not
+ * live under paths mounted into sandbox containers (workspace and
+ * conversation dirs in image mode), or code written from inside the sandbox
+ * would be imported into the host process — a sandbox escape.
+ * {@link defaultExtensionDirs} returns the canonical host-only locations
+ * under mikan's state dir.
+ *
+ * Directories are scanned in order; all discovered extensions activate.
+ * Accepted layouts:
+ *
+ * - `extensions/<name>.mjs` / `extensions/<name>.js`
+ * - `extensions/<name>/index.mjs` / `extensions/<name>/index.js`
+ *
+ * Modules are imported with a cache-busting query so edited extensions are
+ * picked up when a new harness instance is created for a conversation.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from "fs";
+import { homedir } from "os";
+import { basename, dirname, join } from "path";
+import { pathToFileURL } from "url";
+import * as log from "../../log.js";
+import { loadSkillsFromDir } from "../skills.js";
+import { ExtensionRegistry } from "./registry.js";
+const EXTENSION_FILE_PATTERN = /\.(mjs|js)$/;
+/**
+ * Canonical host-only extension directories for a conversation:
+ * `<stateDir>/extensions/global` (all conversations) and
+ * `<stateDir>/extensions/<conversationId>` (that conversation only).
+ * `global` is reserved as a scope name; platform conversation ids never
+ * take that value.
+ */
+export function defaultExtensionDirs(conversationId, stateDir = join(homedir(), ".mikan")) {
+    return [join(stateDir, "extensions", "global"), join(stateDir, "extensions", conversationId)];
+}
+function discoverExtensionEntrypoints(dir) {
+    if (!existsSync(dir))
+        return [];
+    const entrypoints = [];
+    for (const name of readdirSync(dir).toSorted()) {
+        if (name.startsWith("."))
+            continue;
+        const fullPath = join(dir, name);
+        let stats;
+        try {
+            stats = statSync(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (stats.isFile() && EXTENSION_FILE_PATTERN.test(name)) {
+            entrypoints.push(fullPath);
+            continue;
+        }
+        if (stats.isDirectory()) {
+            for (const candidate of ["index.mjs", "index.js"]) {
+                const indexPath = join(fullPath, candidate);
+                if (existsSync(indexPath)) {
+                    entrypoints.push(indexPath);
+                    break;
+                }
+            }
+        }
+    }
+    return entrypoints;
+}
+/**
+ * Filesystem-safe identifier for an extension, derived from its install
+ * location (directory name for `<name>/index.mjs`, file basename otherwise).
+ * 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 data dir.
+ */
+export function extensionSlug(entrypoint) {
+    const base = /^index\.(mjs|js)$/.test(basename(entrypoint))
+        ? basename(dirname(entrypoint))
+        : basename(entrypoint).replace(EXTENSION_FILE_PATTERN, "");
+    const slug = base
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 64);
+    return slug || "extension";
+}
+/** 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);
+    if (!segment)
+        throw new Error(`Invalid schedule name: ${JSON.stringify(name)}`);
+    return segment;
+}
+/** Read `manifest.json` next to a directory-form extension's entrypoint. */
+function readManifest(entrypoint) {
+    if (!/^index\.(mjs|js)$/.test(basename(entrypoint)))
+        return {};
+    const manifestPath = join(dirname(entrypoint), "manifest.json");
+    if (!existsSync(manifestPath))
+        return {};
+    try {
+        const parsed = JSON.parse(readFileSync(manifestPath, "utf-8"));
+        if (!parsed || typeof parsed !== "object")
+            return {};
+        const record = parsed;
+        return {
+            name: typeof record.name === "string" ? record.name : undefined,
+            version: typeof record.version === "string" ? record.version : undefined,
+            description: typeof record.description === "string" ? record.description : undefined,
+        };
+    }
+    catch (err) {
+        log.logWarning(`Ignoring malformed extension manifest: ${manifestPath}`, String(err));
+        return {};
+    }
+}
+/**
+ * Skills shipped inside a directory-form extension (`<dir>/skills/`).
+ * Marked inline: extension files live under the host-only state dir, which
+ * sandbox containers cannot read, so skill bodies must ride in the prompt.
+ */
+function loadExtensionSkills(entrypoint, slug) {
+    if (!/^index\.(mjs|js)$/.test(basename(entrypoint)))
+        return [];
+    const skillsDir = join(dirname(entrypoint), "skills");
+    if (!existsSync(skillsDir))
+        return [];
+    const result = loadSkillsFromDir({ dir: skillsDir, source: `extension:${slug}` });
+    for (const diagnostic of result.diagnostics) {
+        log.logWarning(`Extension skill warning (${slug}): ${diagnostic.message}`, diagnostic.path);
+    }
+    for (const skill of result.skills)
+        skill.inline = true;
+    return result.skills;
+}
+const SCHEDULE_FILE_SUFFIX = ".json";
+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",
+        conversationId,
+        text: spec.text,
+        at: spec.at,
+        ...(spec.platform ? { platform: spec.platform } : {}),
+    };
+}
+function specFromPayload(payload) {
+    if (payload.type === "periodic") {
+        return {
+            type: "periodic",
+            schedule: payload.schedule ?? "",
+            timezone: payload.timezone ?? "",
+            text: payload.text,
+            ...(payload.platform ? { platform: payload.platform } : {}),
+        };
+    }
+    return {
+        type: "one-shot",
+        at: payload.at ?? "",
+        text: payload.text,
+        ...(payload.platform ? { platform: payload.platform } : {}),
+    };
+}
+/** Build the v2 api surface for one extension over the injected services. */
+function buildExtensionApi(params) {
+    const { name, slug, registry, context, services } = params;
+    const stateDir = services.stateDir ?? join(homedir(), ".mikan");
+    const conversationId = context.conversationId;
+    const requireScheduleStore = () => {
+        if (!services.scheduleStore) {
+            throw new Error("api.schedules is unavailable: this context provides no schedule store");
+        }
+        return services.scheduleStore;
+    };
+    return {
+        on: (hook, handler) => registry.register(name, hook, handler),
+        registerTool: (tool) => registry.registerTool(tool),
+        log: (message) => log.logInfo(`[extension:${name}] ${message}`),
+        context,
+        paths: {
+            get dataDir() {
+                const dir = join(stateDir, "extension-data", slug);
+                mkdirSync(dir, { recursive: true });
+                return dir;
+            },
+        },
+        secrets: {
+            get: (key) => services.resolveSecrets?.(slug)[key],
+            list: () => Object.keys(services.resolveSecrets?.(slug) ?? {}),
+        },
+        schedules: {
+            upsert: async (scheduleName, spec) => {
+                const store = requireScheduleStore();
+                const filename = `${schedulePrefix(slug, conversationId)}${scheduleNameSegment(scheduleName)}${SCHEDULE_FILE_SUFFIX}`;
+                await store.write(filename, payloadFromSpec(spec, conversationId));
+            },
+            delete: async (scheduleName) => {
+                const store = requireScheduleStore();
+                const filename = `${schedulePrefix(slug, conversationId)}${scheduleNameSegment(scheduleName)}${SCHEDULE_FILE_SUFFIX}`;
+                return store.delete(filename);
+            },
+            list: async () => {
+                const store = requireScheduleStore();
+                const prefix = schedulePrefix(slug, conversationId);
+                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),
+                    });
+                }
+                return infos;
+            },
+        },
+        notify: async (text) => {
+            if (!services.postMessage) {
+                throw new Error("api.notify is unavailable: this context provides no platform messaging");
+            }
+            await services.postMessage(conversationId, text);
+        },
+    };
+}
+function resolveActivate(moduleExports) {
+    if (!moduleExports || typeof moduleExports !== "object")
+        return undefined;
+    const candidates = [moduleExports.default, moduleExports];
+    for (const candidate of candidates) {
+        if (typeof candidate === "function") {
+            return { activate: candidate };
+        }
+        if (candidate && typeof candidate === "object") {
+            const activate = candidate.activate;
+            if (typeof activate === "function") {
+                return {
+                    name: typeof candidate.name === "string"
+                        ? candidate.name
+                        : undefined,
+                    activate: activate,
+                };
+            }
+        }
+    }
+    return undefined;
+}
+/** Load and activate all extensions found in the given directories. */
+export async function loadExtensions(options) {
+    const registry = new ExtensionRegistry();
+    const extensions = [];
+    const errors = [];
+    const skills = [];
+    const services = options.services ?? {};
+    for (const dir of options.dirs) {
+        for (const entrypoint of discoverExtensionEntrypoints(dir)) {
+            try {
+                const moduleUrl = `${pathToFileURL(entrypoint).href}?t=${Date.now()}`;
+                const moduleExports = await import(moduleUrl);
+                const extension = resolveActivate(moduleExports);
+                if (!extension) {
+                    errors.push({
+                        path: entrypoint,
+                        error: "extension must export an activate function (default or named)",
+                    });
+                    continue;
+                }
+                const slug = extensionSlug(entrypoint);
+                const manifest = readManifest(entrypoint);
+                const name = manifest.name ?? extension.name ?? slug;
+                const api = buildExtensionApi({
+                    name,
+                    slug,
+                    registry,
+                    context: options.context,
+                    services,
+                });
+                await extension.activate(api);
+                const extensionSkills = loadExtensionSkills(entrypoint, slug);
+                skills.push(...extensionSkills);
+                extensions.push({
+                    name,
+                    path: entrypoint,
+                    slug,
+                    version: manifest.version,
+                    description: manifest.description,
+                    skills: extensionSkills,
+                });
+            }
+            catch (err) {
+                errors.push({
+                    path: entrypoint,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    return { registry, extensions, errors, skills };
+}
+//# sourceMappingURL=loader.js.map

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

@@ -0,0 +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:\n *\n * - `extensions/<name>.mjs` / `extensions/<name>.js`\n * - `extensions/<name>/index.mjs` / `extensions/<name>/index.js`\n *\n * Modules are imported with a cache-busting query so edited extensions are\n * picked up when a new harness instance is created for a conversation.\n */\nimport { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { basename, dirname, join } from \"path\";\nimport { pathToFileURL } from \"url\";\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  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)$/;\n\n/**\n * Canonical host-only extension directories for a conversation:\n * `<stateDir>/extensions/global` (all conversations) and\n * `<stateDir>/extensions/<conversationId>` (that conversation only).\n * `global` is reserved as a scope name; platform conversation ids never\n * take that value.\n */\nexport function defaultExtensionDirs(\n  conversationId: string,\n  stateDir: string = join(homedir(), \".mikan\"),\n): string[] {\n  return [join(stateDir, \"extensions\", \"global\"), join(stateDir, \"extensions\", conversationId)];\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\nfunction discoverExtensionEntrypoints(dir: string): string[] {\n  if (!existsSync(dir)) return [];\n  const entrypoints: string[] = [];\n  for (const name of readdirSync(dir).toSorted()) {\n    if (name.startsWith(\".\")) continue;\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      entrypoints.push(fullPath);\n      continue;\n    }\n    if (stats.isDirectory()) {\n      for (const candidate of [\"index.mjs\", \"index.js\"]) {\n        const indexPath = join(fullPath, candidate);\n        if (existsSync(indexPath)) {\n          entrypoints.push(indexPath);\n          break;\n        }\n      }\n    }\n  }\n  return entrypoints;\n}\n\n/**\n * Filesystem-safe identifier for an extension, derived from its install\n * location (directory name for `<name>/index.mjs`, file basename otherwise).\n * The slug keys the extension's data dir, secrets vault, and schedule\n * ownership — installing the same extension globally and per-conversation\n * shares one slug and therefore one data dir.\n */\nexport function extensionSlug(entrypoint: string): string {\n  const base = /^index\\.(mjs|js)$/.test(basename(entrypoint))\n    ? basename(dirname(entrypoint))\n    : basename(entrypoint).replace(EXTENSION_FILE_PATTERN, \"\");\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/** 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/** Read `manifest.json` next to a directory-form extension's entrypoint. */\nfunction readManifest(entrypoint: string): ExtensionManifest {\n  if (!/^index\\.(mjs|js)$/.test(basename(entrypoint))) return {};\n  const manifestPath = join(dirname(entrypoint), \"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(entrypoint: string, slug: string): MikanSkill[] {\n  if (!/^index\\.(mjs|js)$/.test(basename(entrypoint))) return [];\n  const skillsDir = join(dirname(entrypoint), \"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    log: (message: string) => log.logInfo(`[extension:${name}] ${message}`),\n    context,\n    paths: {\n      get dataDir(): string {\n        const dir = join(stateDir, \"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    notify: async (text: string) => {\n      if (!services.postMessage) {\n        throw new Error(\"api.notify is unavailable: this context provides no platform messaging\");\n      }\n      await services.postMessage(conversationId, text);\n    },\n  };\n}\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 of discoverExtensionEntrypoints(dir)) {\n      try {\n        const moduleUrl = `${pathToFileURL(entrypoint).href}?t=${Date.now()}`;\n        const moduleExports: unknown = await import(moduleUrl);\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(entrypoint);\n        const manifest = readManifest(entrypoint);\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        await extension.activate(api);\n        const extensionSkills = loadExtensionSkills(entrypoint, 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 };\n}\n"]}

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

@@ -0,0 +1,23 @@
+/**
+ * Hook registry and dispatch for mikan extensions.
+ *
+ * The registry collects hook handlers and contributed tools from activated
+ * extensions and dispatches events from the harness runner. Handler failures
+ * are logged and swallowed so a broken extension cannot take down a run.
+ */
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { MikanHookMap, MikanHookName } from "./types.js";
+export declare class ExtensionRegistry {
+    private handlers;
+    private tools;
+    register<T extends MikanHookName>(owner: string, hook: T, handler: MikanHookMap[T]): void;
+    registerTool(tool: AgentTool): void;
+    getContributedTools(): AgentTool[];
+    hasHandlers(hook: MikanHookName): boolean;
+    /**
+     * Run handlers in registration order. Returns the first non-undefined
+     * result. Handler errors are logged and skipped.
+     */
+    emit<T extends MikanHookName>(hook: T, event: Parameters<MikanHookMap[T]>[0]): Promise<Awaited<ReturnType<MikanHookMap[T]>> | undefined>;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/harness/extensions/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM9D,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAOd;IACF,OAAO,CAAC,KAAK,CAAmB;IAEhC,QAAQ,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAExF;IAED,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAElC;IAED,mBAAmB,IAAI,SAAS,EAAE,CAEjC;IAED,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAExC;IAED;;;OAGG;IACG,IAAI,CAAC,CAAC,SAAS,aAAa,EAChC,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAe3D;CACF"}

package/dist/harness/extensions/registry.js

@@ -0,0 +1,45 @@
+import * as log from "../../log.js";
+export class ExtensionRegistry {
+    constructor() {
+        this.handlers = {
+            before_agent_start: [],
+            tool_call: [],
+            tool_result: [],
+            message_end: [],
+            turn_end: [],
+            session_compact: [],
+        };
+        this.tools = [];
+    }
+    register(owner, hook, handler) {
+        this.handlers[hook].push({ owner, handler });
+    }
+    registerTool(tool) {
+        this.tools.push(tool);
+    }
+    getContributedTools() {
+        return [...this.tools];
+    }
+    hasHandlers(hook) {
+        return this.handlers[hook].length > 0;
+    }
+    /**
+     * Run handlers in registration order. Returns the first non-undefined
+     * result. Handler errors are logged and skipped.
+     */
+    async emit(hook, event) {
+        for (const { owner, handler } of this.handlers[hook]) {
+            try {
+                const result = await handler(event);
+                if (result !== undefined) {
+                    return result;
+                }
+            }
+            catch (err) {
+                log.logWarning(`Extension hook "${hook}" failed (${owner})`, err instanceof Error ? err.message : String(err));
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/harness/extensions/registry.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAOpC,MAAM,OAAO,iBAAiB;IAA9B;QACU,aAAQ,GAAiB;YAC/B,kBAAkB,EAAE,EAAE;YACtB,SAAS,EAAE,EAAE;YACb,WAAW,EAAE,EAAE;YACf,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,EAAE;YACZ,eAAe,EAAE,EAAE;SACpB,CAAC;QACM,UAAK,GAAgB,EAAE,CAAC;IAyClC,CAAC;IAvCC,QAAQ,CAA0B,KAAa,EAAE,IAAO,EAAE,OAAwB;QAChF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,YAAY,CAAC,IAAe;QAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,mBAAmB;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,WAAW,CAAC,IAAmB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CACR,IAAO,EACP,KAAqC;QAErC,KAAK,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAO,OAAuC,CAAC,KAAK,CAAC,CAAC;gBACrE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,OAAO,MAA8C,CAAC;gBACxD,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,UAAU,CACZ,mBAAmB,IAAI,aAAa,KAAK,GAAG,EAC5C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF","sourcesContent":["/**\n * Hook registry and dispatch for mikan extensions.\n *\n * The registry collects hook handlers and contributed tools from activated\n * extensions and dispatches events from the harness runner. Handler failures\n * are logged and swallowed so a broken extension cannot take down a run.\n */\nimport type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport * as log from \"../../log.js\";\nimport type { MikanHookMap, MikanHookName } from \"./types.js\";\n\ntype HookHandlers = {\n  [T in MikanHookName]: Array<{ owner: string; handler: MikanHookMap[T] }>;\n};\n\nexport class ExtensionRegistry {\n  private handlers: HookHandlers = {\n    before_agent_start: [],\n    tool_call: [],\n    tool_result: [],\n    message_end: [],\n    turn_end: [],\n    session_compact: [],\n  };\n  private tools: AgentTool[] = [];\n\n  register<T extends MikanHookName>(owner: string, hook: T, handler: MikanHookMap[T]): void {\n    this.handlers[hook].push({ owner, handler });\n  }\n\n  registerTool(tool: AgentTool): void {\n    this.tools.push(tool);\n  }\n\n  getContributedTools(): AgentTool[] {\n    return [...this.tools];\n  }\n\n  hasHandlers(hook: MikanHookName): boolean {\n    return this.handlers[hook].length > 0;\n  }\n\n  /**\n   * Run handlers in registration order. Returns the first non-undefined\n   * result. Handler errors are logged and skipped.\n   */\n  async emit<T extends MikanHookName>(\n    hook: T,\n    event: Parameters<MikanHookMap[T]>[0],\n  ): Promise<Awaited<ReturnType<MikanHookMap[T]>> | undefined> {\n    for (const { owner, handler } of this.handlers[hook]) {\n      try {\n        const result = await (handler as (input: unknown) => unknown)(event);\n        if (result !== undefined) {\n          return result as Awaited<ReturnType<MikanHookMap[T]>>;\n        }\n      } catch (err) {\n        log.logWarning(\n          `Extension hook \"${hook}\" failed (${owner})`,\n          err instanceof Error ? err.message : String(err),\n        );\n      }\n    }\n    return undefined;\n  }\n}\n"]}