@geminixiang/mikan 1.0.0-beta.4 → 1.0.0-beta.41

package/dist/harness/extensions/registry.js

@@ -1,15 +1,36 @@
 import * as log from "../../log.js";
+const COMMAND_NAME_PATTERN = /^[a-z0-9_-]+$/i;
+/**
+ * Parse `/name args…` slash-command text. Returns undefined when the text is
+ * not a slash command with a valid name (`COMMAND_NAME_PATTERN`).
+ */
+export function parseCommandInput(text) {
+    const match = /^\/(\S+)(?:\s+([\s\S]*))?$/.exec(text.trim());
+    const name = match?.[1];
+    if (name === undefined || !COMMAND_NAME_PATTERN.test(name))
+        return undefined;
+    return { name, args: match?.[2]?.trim() ?? "" };
+}
 export class ExtensionRegistry {
     constructor() {
         this.handlers = {
             before_agent_start: [],
+            context: [],
             tool_call: [],
             tool_result: [],
             message_end: [],
             turn_end: [],
             session_compact: [],
+            agent_error: [],
+            budget_exceeded: [],
         };
         this.tools = [];
+        this.commands = new Map();
+        /** Block action handlers keyed `<slug>\n<actionId>` (slug scopes, so no cross-extension dups). */
+        this.actions = new Map();
+        /** Schedule callback handlers keyed `<slug>\n<callbackName>`, mirroring actions. */
+        this.scheduleCallbacks = new Map();
+        this.disposers = [];
     }
     register(owner, hook, handler) {
         this.handlers[hook].push({ owner, handler });
@@ -17,9 +38,139 @@ export class ExtensionRegistry {
     registerTool(tool) {
         this.tools.push(tool);
     }
+    /**
+     * Register an extension command. Invalid names throw (surfaces as an
+     * activation error for that extension); a duplicate name is logged and
+     * ignored so the first registration wins, mirroring hook isolation.
+     */
+    registerCommand(owner, command) {
+        if (!COMMAND_NAME_PATTERN.test(command.name)) {
+            throw new Error(`Invalid extension command name: ${JSON.stringify(command.name)}`);
+        }
+        const key = command.name.toLowerCase();
+        const existing = this.commands.get(key);
+        if (existing) {
+            log.logWarning(`Extension command "/${command.name}" already registered by ${existing.owner}`, `ignoring registration from ${owner}`);
+            return;
+        }
+        this.commands.set(key, { owner, command });
+    }
+    registerDisposer(owner, disposer) {
+        this.disposers.push({ owner, disposer });
+    }
+    /**
+     * Register a block action handler for `actionId` under an extension slug.
+     * A duplicate registration is logged and ignored (first wins), mirroring
+     * command registration.
+     */
+    registerAction(slug, actionId, handler) {
+        if (!actionId)
+            throw new Error("Extension block action id must be non-empty");
+        const key = `${slug}\n${actionId}`;
+        if (this.actions.has(key)) {
+            log.logWarning(`Extension block action "${actionId}" already registered by ${slug}`, "ignoring duplicate registration");
+            return;
+        }
+        this.actions.set(key, { owner: slug, handler });
+    }
+    /**
+     * Register a schedule callback handler under an extension slug. Invalid
+     * names throw (an activation error for that extension); a duplicate
+     * registration is logged and ignored (first wins), mirroring commands.
+     */
+    registerScheduleCallback(slug, callbackName, handler) {
+        if (!COMMAND_NAME_PATTERN.test(callbackName)) {
+            throw new Error(`Invalid schedule callback name: ${JSON.stringify(callbackName)}`);
+        }
+        const key = `${slug}\n${callbackName}`;
+        if (this.scheduleCallbacks.has(key)) {
+            log.logWarning(`Extension schedule callback "${callbackName}" already registered by ${slug}`, "ignoring duplicate registration");
+            return;
+        }
+        this.scheduleCallbacks.set(key, { handler });
+    }
+    /**
+     * Run the handler for a fired callback schedule. Returns true when a
+     * matching handler exists — including when it threw (the fire was
+     * consumed; the error is logged).
+     */
+    async dispatchScheduleCallback(slug, callbackName, event) {
+        const entry = this.scheduleCallbacks.get(`${slug}\n${callbackName}`);
+        if (!entry)
+            return false;
+        try {
+            await entry.handler(event);
+        }
+        catch (err) {
+            log.logWarning(`Extension schedule callback "${callbackName}" failed (${slug}, schedule "${event.scheduleName}")`, err instanceof Error ? err.message : String(err));
+        }
+        return true;
+    }
+    /**
+     * Run the handler for an extension-owned block action. Returns true when a
+     * matching handler exists — including when it threw (the action was
+     * consumed; the error is logged, never surfaced to the platform).
+     */
+    async dispatchAction(slug, action) {
+        const entry = this.actions.get(`${slug}\n${action.actionId}`);
+        if (!entry)
+            return false;
+        try {
+            await entry.handler(action);
+        }
+        catch (err) {
+            log.logWarning(`Extension block action "${action.actionId}" failed (${entry.owner})`, err instanceof Error ? err.message : String(err));
+        }
+        return true;
+    }
     getContributedTools() {
         return [...this.tools];
     }
+    /** Registered commands, for inventory surfaces. */
+    getCommands() {
+        return [...this.commands.values()].map((entry) => entry.command);
+    }
+    /**
+     * Run the handler for `/name`, if an extension registered it. Returns true
+     * when a matching command exists — including when its handler threw (the
+     * command was consumed; the error is logged and reported to the user).
+     */
+    async dispatchCommand(name, context) {
+        const entry = this.commands.get(name.toLowerCase());
+        if (!entry)
+            return false;
+        try {
+            await entry.command.handler(context);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            log.logWarning(`Extension command "/${entry.command.name}" failed (${entry.owner})`, message);
+            try {
+                await context.respond(`Command /${entry.command.name} failed: ${message}`);
+            }
+            catch {
+                // The reply channel itself failed; the log line above is the record.
+            }
+        }
+        return true;
+    }
+    /**
+     * Run all registered disposers in reverse registration order (LIFO).
+     * Disposer errors are logged and never propagate. Idempotent: disposers
+     * run once and the list is cleared.
+     */
+    async dispose() {
+        const disposers = this.disposers;
+        this.disposers = [];
+        for (const { owner, disposer } of disposers.toReversed()) {
+            try {
+                await disposer();
+            }
+            catch (err) {
+                log.logWarning(`Extension disposer failed (${owner})`, err instanceof Error ? err.message : String(err));
+            }
+        }
+    }
     hasHandlers(hook) {
         return this.handlers[hook].length > 0;
     }
@@ -41,5 +192,170 @@ export class ExtensionRegistry {
         }
         return undefined;
     }
+    /**
+     * Dispatch `before_agent_start` with merge semantics: `systemPrompt` and
+     * `prompt` rewrites chain (each handler sees the event as rewritten by
+     * earlier handlers), while `block` from ANY handler wins so a policy
+     * extension cannot be shadowed by registration order. The first block's
+     * reason is kept. Returns undefined when no handler changed anything.
+     */
+    async emitBeforeAgentStart(event) {
+        const chained = { ...event };
+        const merged = {};
+        for (const { owner, handler } of this.handlers.before_agent_start) {
+            try {
+                const result = await handler(chained);
+                if (!result)
+                    continue;
+                if (result.systemPrompt !== undefined) {
+                    merged.systemPrompt = result.systemPrompt;
+                    chained.systemPrompt = result.systemPrompt;
+                }
+                if (result.prompt !== undefined) {
+                    merged.prompt = result.prompt;
+                    chained.prompt = result.prompt;
+                }
+                if (result.block && !merged.block) {
+                    merged.block = true;
+                    merged.reason = result.reason;
+                }
+            }
+            catch (err) {
+                log.logWarning(`Extension hook "before_agent_start" failed (${owner})`, err instanceof Error ? err.message : String(err));
+            }
+        }
+        return merged.systemPrompt !== undefined || merged.prompt !== undefined || merged.block
+            ? merged
+            : undefined;
+    }
+    /**
+     * Dispatch `context` with Pi-compatible chaining semantics. Handlers receive
+     * a call-local clone, so in-place mutations and returned replacements affect
+     * only this LLM call and never the canonical transcript.
+     */
+    async emitContext(event) {
+        let messages = structuredClone(event.messages);
+        for (const { owner, handler } of this.handlers.context) {
+            try {
+                const result = await handler({ ...event, messages });
+                if (result?.messages)
+                    messages = result.messages;
+            }
+            catch (err) {
+                log.logWarning(`Extension hook "context" failed (${owner})`, err instanceof Error ? err.message : String(err));
+            }
+        }
+        return messages;
+    }
+    /**
+     * Dispatch `message_end` with Pi-compatible chaining semantics. Each handler
+     * sees the replacement from the previous handler. Role-changing replacements
+     * are rejected because the agent lifecycle event role cannot be changed.
+     */
+    async emitMessageEnd(event) {
+        let message = event.message;
+        let modified = false;
+        for (const { owner, handler } of this.handlers.message_end) {
+            try {
+                const result = await handler({ ...event, message });
+                if (!result?.message)
+                    continue;
+                if (result.message.role !== message.role) {
+                    log.logWarning(`Extension hook "message_end" failed (${owner})`, "message_end handlers must return a message with the same role");
+                    continue;
+                }
+                message = result.message;
+                modified = true;
+            }
+            catch (err) {
+                log.logWarning(`Extension hook "message_end" failed (${owner})`, err instanceof Error ? err.message : String(err));
+            }
+        }
+        return modified ? { message } : undefined;
+    }
+    /**
+     * Dispatch `tool_result` with chaining semantics: each handler sees content,
+     * details, isError, and usage as rewritten by earlier handlers, so e.g. a
+     * redaction extension processes the output of upstream rewriters instead of
+     * the original. Returns the accumulated override, or undefined when no
+     * handler changed anything.
+     */
+    async emitToolResult(event) {
+        const chained = { ...event };
+        const merged = {};
+        for (const { owner, handler } of this.handlers.tool_result) {
+            try {
+                const result = await handler(chained);
+                if (!result)
+                    continue;
+                if (result.content !== undefined) {
+                    merged.content = result.content;
+                    chained.content = result.content;
+                }
+                if (result.details !== undefined) {
+                    merged.details = result.details;
+                    chained.details = result.details;
+                }
+                if (result.isError !== undefined) {
+                    merged.isError = result.isError;
+                    chained.isError = result.isError;
+                }
+                if (result.usage !== undefined) {
+                    merged.usage = result.usage;
+                    chained.usage = result.usage;
+                }
+            }
+            catch (err) {
+                log.logWarning(`Extension hook "tool_result" failed (${owner})`, err instanceof Error ? err.message : String(err));
+            }
+        }
+        return merged.content !== undefined ||
+            merged.details !== undefined ||
+            merged.isError !== undefined ||
+            merged.usage !== undefined
+            ? merged
+            : undefined;
+    }
+}
+/**
+ * Action-id namespacing for extension-posted interactive messages.
+ *
+ * Blocks posted through `api.blockkit.post` get every `action_id` rewritten
+ * to `ext:<slug>:<original>` so the platform adapter can route interactions
+ * exclusively to the owning extension's `onAction` handlers (never into an
+ * agent run). Model-posted blocks carry no prefix and keep the existing
+ * conversation-event path; the two worlds cannot collide because extension
+ * slugs are admin-controlled, filesystem-safe identifiers (no `:`).
+ */
+export const EXT_ACTION_PREFIX = "ext:";
+/** Deep-clone blocks, rewriting every `action_id` to `ext:<slug>:<id>`. */
+export function namespaceActionIds(blocks, slug) {
+    const walk = (node) => {
+        if (Array.isArray(node))
+            return node.map(walk);
+        if (!node || typeof node !== "object")
+            return node;
+        const out = {};
+        for (const [key, value] of Object.entries(node)) {
+            if (key === "action_id" && typeof value === "string") {
+                out[key] = `${EXT_ACTION_PREFIX}${slug}:${value}`;
+            }
+            else {
+                out[key] = walk(value);
+            }
+        }
+        return out;
+    };
+    return walk(blocks);
+}
+/** Parse an `ext:<slug>:<actionId>` routing id; null for non-extension actions. */
+export function parseExtActionId(actionId) {
+    if (!actionId.startsWith(EXT_ACTION_PREFIX))
+        return null;
+    const rest = actionId.slice(EXT_ACTION_PREFIX.length);
+    const separator = rest.indexOf(":");
+    if (separator <= 0 || separator === rest.length - 1)
+        return null;
+    return { slug: rest.slice(0, separator), actionId: rest.slice(separator + 1) };
 }
 //# sourceMappingURL=registry.js.map

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

@@ -1 +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"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/harness/extensions/registry.ts"],"names":[],"mappings":"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","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 { AgentMessage, AgentTool } from \"@earendil-works/pi-agent-core\";\nimport * as log from \"../../log.js\";\nimport type {\n  BeforeAgentStartHookEvent,\n  BeforeAgentStartHookResult,\n  ContextHookEvent,\n  ExtensionBlockAction,\n  ExtensionBlockActionHandler,\n  ExtensionCommand,\n  ExtensionCommandContext,\n  ExtensionDisposer,\n  ExtensionScheduleCallbackEvent,\n  ExtensionScheduleCallbackHandler,\n  MessageEndHookEvent,\n  MessageEndHookResult,\n  MikanHookMap,\n  MikanHookName,\n  ToolResultHookEvent,\n  ToolResultHookResult,\n} from \"./types.js\";\n\nconst COMMAND_NAME_PATTERN = /^[a-z0-9_-]+$/i;\n\n/**\n * Parse `/name args…` slash-command text. Returns undefined when the text is\n * not a slash command with a valid name (`COMMAND_NAME_PATTERN`).\n */\nexport function parseCommandInput(text: string): { name: string; args: string } | undefined {\n  const match = /^\\/(\\S+)(?:\\s+([\\s\\S]*))?$/.exec(text.trim());\n  const name = match?.[1];\n  if (name === undefined || !COMMAND_NAME_PATTERN.test(name)) return undefined;\n  return { name, args: match?.[2]?.trim() ?? \"\" };\n}\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    context: [],\n    tool_call: [],\n    tool_result: [],\n    message_end: [],\n    turn_end: [],\n    session_compact: [],\n    agent_error: [],\n    budget_exceeded: [],\n  };\n  private tools: AgentTool[] = [];\n  private commands = new Map<string, { owner: string; command: ExtensionCommand }>();\n  /** Block action handlers keyed `<slug>\\n<actionId>` (slug scopes, so no cross-extension dups). */\n  private actions = new Map<string, { owner: string; handler: ExtensionBlockActionHandler }>();\n  /** Schedule callback handlers keyed `<slug>\\n<callbackName>`, mirroring actions. */\n  private scheduleCallbacks = new Map<string, { handler: ExtensionScheduleCallbackHandler }>();\n  private disposers: Array<{ owner: string; disposer: ExtensionDisposer }> = [];\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  /**\n   * Register an extension command. Invalid names throw (surfaces as an\n   * activation error for that extension); a duplicate name is logged and\n   * ignored so the first registration wins, mirroring hook isolation.\n   */\n  registerCommand(owner: string, command: ExtensionCommand): void {\n    if (!COMMAND_NAME_PATTERN.test(command.name)) {\n      throw new Error(`Invalid extension command name: ${JSON.stringify(command.name)}`);\n    }\n    const key = command.name.toLowerCase();\n    const existing = this.commands.get(key);\n    if (existing) {\n      log.logWarning(\n        `Extension command \"/${command.name}\" already registered by ${existing.owner}`,\n        `ignoring registration from ${owner}`,\n      );\n      return;\n    }\n    this.commands.set(key, { owner, command });\n  }\n\n  registerDisposer(owner: string, disposer: ExtensionDisposer): void {\n    this.disposers.push({ owner, disposer });\n  }\n\n  /**\n   * Register a block action handler for `actionId` under an extension slug.\n   * A duplicate registration is logged and ignored (first wins), mirroring\n   * command registration.\n   */\n  registerAction(slug: string, actionId: string, handler: ExtensionBlockActionHandler): void {\n    if (!actionId) throw new Error(\"Extension block action id must be non-empty\");\n    const key = `${slug}\\n${actionId}`;\n    if (this.actions.has(key)) {\n      log.logWarning(\n        `Extension block action \"${actionId}\" already registered by ${slug}`,\n        \"ignoring duplicate registration\",\n      );\n      return;\n    }\n    this.actions.set(key, { owner: slug, handler });\n  }\n\n  /**\n   * Register a schedule callback handler under an extension slug. Invalid\n   * names throw (an activation error for that extension); a duplicate\n   * registration is logged and ignored (first wins), mirroring commands.\n   */\n  registerScheduleCallback(\n    slug: string,\n    callbackName: string,\n    handler: ExtensionScheduleCallbackHandler,\n  ): void {\n    if (!COMMAND_NAME_PATTERN.test(callbackName)) {\n      throw new Error(`Invalid schedule callback name: ${JSON.stringify(callbackName)}`);\n    }\n    const key = `${slug}\\n${callbackName}`;\n    if (this.scheduleCallbacks.has(key)) {\n      log.logWarning(\n        `Extension schedule callback \"${callbackName}\" already registered by ${slug}`,\n        \"ignoring duplicate registration\",\n      );\n      return;\n    }\n    this.scheduleCallbacks.set(key, { handler });\n  }\n\n  /**\n   * Run the handler for a fired callback schedule. Returns true when a\n   * matching handler exists — including when it threw (the fire was\n   * consumed; the error is logged).\n   */\n  async dispatchScheduleCallback(\n    slug: string,\n    callbackName: string,\n    event: ExtensionScheduleCallbackEvent,\n  ): Promise<boolean> {\n    const entry = this.scheduleCallbacks.get(`${slug}\\n${callbackName}`);\n    if (!entry) return false;\n    try {\n      await entry.handler(event);\n    } catch (err) {\n      log.logWarning(\n        `Extension schedule callback \"${callbackName}\" failed (${slug}, schedule \"${event.scheduleName}\")`,\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n    return true;\n  }\n\n  /**\n   * Run the handler for an extension-owned block action. Returns true when a\n   * matching handler exists — including when it threw (the action was\n   * consumed; the error is logged, never surfaced to the platform).\n   */\n  async dispatchAction(slug: string, action: ExtensionBlockAction): Promise<boolean> {\n    const entry = this.actions.get(`${slug}\\n${action.actionId}`);\n    if (!entry) return false;\n    try {\n      await entry.handler(action);\n    } catch (err) {\n      log.logWarning(\n        `Extension block action \"${action.actionId}\" failed (${entry.owner})`,\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n    return true;\n  }\n\n  getContributedTools(): AgentTool[] {\n    return [...this.tools];\n  }\n\n  /** Registered commands, for inventory surfaces. */\n  getCommands(): ExtensionCommand[] {\n    return [...this.commands.values()].map((entry) => entry.command);\n  }\n\n  /**\n   * Run the handler for `/name`, if an extension registered it. Returns true\n   * when a matching command exists — including when its handler threw (the\n   * command was consumed; the error is logged and reported to the user).\n   */\n  async dispatchCommand(name: string, context: ExtensionCommandContext): Promise<boolean> {\n    const entry = this.commands.get(name.toLowerCase());\n    if (!entry) return false;\n    try {\n      await entry.command.handler(context);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      log.logWarning(`Extension command \"/${entry.command.name}\" failed (${entry.owner})`, message);\n      try {\n        await context.respond(`Command /${entry.command.name} failed: ${message}`);\n      } catch {\n        // The reply channel itself failed; the log line above is the record.\n      }\n    }\n    return true;\n  }\n\n  /**\n   * Run all registered disposers in reverse registration order (LIFO).\n   * Disposer errors are logged and never propagate. Idempotent: disposers\n   * run once and the list is cleared.\n   */\n  async dispose(): Promise<void> {\n    const disposers = this.disposers;\n    this.disposers = [];\n    for (const { owner, disposer } of disposers.toReversed()) {\n      try {\n        await disposer();\n      } catch (err) {\n        log.logWarning(\n          `Extension disposer failed (${owner})`,\n          err instanceof Error ? err.message : String(err),\n        );\n      }\n    }\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  /**\n   * Dispatch `before_agent_start` with merge semantics: `systemPrompt` and\n   * `prompt` rewrites chain (each handler sees the event as rewritten by\n   * earlier handlers), while `block` from ANY handler wins so a policy\n   * extension cannot be shadowed by registration order. The first block's\n   * reason is kept. Returns undefined when no handler changed anything.\n   */\n  async emitBeforeAgentStart(\n    event: BeforeAgentStartHookEvent,\n  ): Promise<BeforeAgentStartHookResult | undefined> {\n    const chained: BeforeAgentStartHookEvent = { ...event };\n    const merged: BeforeAgentStartHookResult = {};\n    for (const { owner, handler } of this.handlers.before_agent_start) {\n      try {\n        const result = await handler(chained);\n        if (!result) continue;\n        if (result.systemPrompt !== undefined) {\n          merged.systemPrompt = result.systemPrompt;\n          chained.systemPrompt = result.systemPrompt;\n        }\n        if (result.prompt !== undefined) {\n          merged.prompt = result.prompt;\n          chained.prompt = result.prompt;\n        }\n        if (result.block && !merged.block) {\n          merged.block = true;\n          merged.reason = result.reason;\n        }\n      } catch (err) {\n        log.logWarning(\n          `Extension hook \"before_agent_start\" failed (${owner})`,\n          err instanceof Error ? err.message : String(err),\n        );\n      }\n    }\n    return merged.systemPrompt !== undefined || merged.prompt !== undefined || merged.block\n      ? merged\n      : undefined;\n  }\n\n  /**\n   * Dispatch `context` with Pi-compatible chaining semantics. Handlers receive\n   * a call-local clone, so in-place mutations and returned replacements affect\n   * only this LLM call and never the canonical transcript.\n   */\n  async emitContext(event: ContextHookEvent): Promise<AgentMessage[]> {\n    let messages = structuredClone(event.messages);\n    for (const { owner, handler } of this.handlers.context) {\n      try {\n        const result = await handler({ ...event, messages });\n        if (result?.messages) messages = result.messages;\n      } catch (err) {\n        log.logWarning(\n          `Extension hook \"context\" failed (${owner})`,\n          err instanceof Error ? err.message : String(err),\n        );\n      }\n    }\n    return messages;\n  }\n\n  /**\n   * Dispatch `message_end` with Pi-compatible chaining semantics. Each handler\n   * sees the replacement from the previous handler. Role-changing replacements\n   * are rejected because the agent lifecycle event role cannot be changed.\n   */\n  async emitMessageEnd(event: MessageEndHookEvent): Promise<MessageEndHookResult | undefined> {\n    let message = event.message;\n    let modified = false;\n    for (const { owner, handler } of this.handlers.message_end) {\n      try {\n        const result = await handler({ ...event, message });\n        if (!result?.message) continue;\n        if (result.message.role !== message.role) {\n          log.logWarning(\n            `Extension hook \"message_end\" failed (${owner})`,\n            \"message_end handlers must return a message with the same role\",\n          );\n          continue;\n        }\n        message = result.message;\n        modified = true;\n      } catch (err) {\n        log.logWarning(\n          `Extension hook \"message_end\" failed (${owner})`,\n          err instanceof Error ? err.message : String(err),\n        );\n      }\n    }\n    return modified ? { message } : undefined;\n  }\n\n  /**\n   * Dispatch `tool_result` with chaining semantics: each handler sees content,\n   * details, isError, and usage as rewritten by earlier handlers, so e.g. a\n   * redaction extension processes the output of upstream rewriters instead of\n   * the original. Returns the accumulated override, or undefined when no\n   * handler changed anything.\n   */\n  async emitToolResult(event: ToolResultHookEvent): Promise<ToolResultHookResult | undefined> {\n    const chained: ToolResultHookEvent = { ...event };\n    const merged: ToolResultHookResult = {};\n    for (const { owner, handler } of this.handlers.tool_result) {\n      try {\n        const result = await handler(chained);\n        if (!result) continue;\n        if (result.content !== undefined) {\n          merged.content = result.content;\n          chained.content = result.content;\n        }\n        if (result.details !== undefined) {\n          merged.details = result.details;\n          chained.details = result.details;\n        }\n        if (result.isError !== undefined) {\n          merged.isError = result.isError;\n          chained.isError = result.isError;\n        }\n        if (result.usage !== undefined) {\n          merged.usage = result.usage;\n          chained.usage = result.usage;\n        }\n      } catch (err) {\n        log.logWarning(\n          `Extension hook \"tool_result\" failed (${owner})`,\n          err instanceof Error ? err.message : String(err),\n        );\n      }\n    }\n    return merged.content !== undefined ||\n      merged.details !== undefined ||\n      merged.isError !== undefined ||\n      merged.usage !== undefined\n      ? merged\n      : undefined;\n  }\n}\n\n/**\n * Action-id namespacing for extension-posted interactive messages.\n *\n * Blocks posted through `api.blockkit.post` get every `action_id` rewritten\n * to `ext:<slug>:<original>` so the platform adapter can route interactions\n * exclusively to the owning extension's `onAction` handlers (never into an\n * agent run). Model-posted blocks carry no prefix and keep the existing\n * conversation-event path; the two worlds cannot collide because extension\n * slugs are admin-controlled, filesystem-safe identifiers (no `:`).\n */\n\nexport const EXT_ACTION_PREFIX = \"ext:\";\n\n/** Deep-clone blocks, rewriting every `action_id` to `ext:<slug>:<id>`. */\nexport function namespaceActionIds<T>(blocks: T, slug: string): T {\n  const walk = (node: unknown): unknown => {\n    if (Array.isArray(node)) return node.map(walk);\n    if (!node || typeof node !== \"object\") return node;\n    const out: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(node as Record<string, unknown>)) {\n      if (key === \"action_id\" && typeof value === \"string\") {\n        out[key] = `${EXT_ACTION_PREFIX}${slug}:${value}`;\n      } else {\n        out[key] = walk(value);\n      }\n    }\n    return out;\n  };\n  return walk(blocks) as T;\n}\n\n/** Parse an `ext:<slug>:<actionId>` routing id; null for non-extension actions. */\nexport function parseExtActionId(actionId: string): { slug: string; actionId: string } | null {\n  if (!actionId.startsWith(EXT_ACTION_PREFIX)) return null;\n  const rest = actionId.slice(EXT_ACTION_PREFIX.length);\n  const separator = rest.indexOf(\":\");\n  if (separator <= 0 || separator === rest.length - 1) return null;\n  return { slug: rest.slice(0, separator), actionId: rest.slice(separator + 1) };\n}\n"]}