@geminixiang/mikan 1.0.0-beta.7 → 1.0.0-beta.71

package/dist/harness/extensions/registry.js

@@ -1,45 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"]}

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

@@ -1,248 +0,0 @@
-/**
- * mikan extension system, v1.
- *
- * Extensions are ES modules that export an `activate` function (either as
- * the default export or a named `activate` export, optionally wrapped in an
- * object that also carries a `name`). `activate` receives a
- * {@link MikanExtensionApi} and registers hooks and tools.
- *
- * ```js
- * // extensions/audit.mjs
- * export default function activate(api) {
- *   api.on("tool_call", ({ toolName, args }) => {
- *     if (toolName === "bash" && String(args.command).includes("rm -rf /")) {
- *       return { block: true, reason: "destructive command" };
- *     }
- *   });
- * }
- * ```
- *
- * Hooks run in registration order. For hooks with results, the first
- * non-undefined result wins (v1 semantics; later versions may merge).
- * Hook errors are logged and never crash a run.
- */
-import type { AgentMessage, AgentTool, ThinkingLevel } from "@earendil-works/pi-agent-core";
-import type { Api, ImageContent, Model, TextContent } from "@earendil-works/pi-ai";
-import type { MikanSkill } from "../skills.js";
-import type { CompactionEntry } from "../types.js";
-export interface BeforeAgentStartHookEvent {
-    prompt: string;
-    images?: ImageContent[];
-    systemPrompt: string;
-}
-export interface BeforeAgentStartHookResult {
-    /** Replace the system prompt for this turn. */
-    systemPrompt?: string;
-}
-export interface ToolCallHookEvent {
-    toolCallId: string;
-    toolName: string;
-    args: unknown;
-}
-export interface ToolCallHookResult {
-    /** Block the tool call; the model receives an error tool result instead. */
-    block?: boolean;
-    reason?: string;
-}
-export interface ToolResultHookEvent {
-    toolCallId: string;
-    toolName: string;
-    args: unknown;
-    content: (TextContent | ImageContent)[];
-    isError: boolean;
-}
-export interface MessageEndHookEvent {
-    message: AgentMessage;
-}
-export interface TurnEndHookEvent {
-    messages: AgentMessage[];
-}
-export interface SessionCompactHookEvent {
-    entry: CompactionEntry;
-    reason: "threshold" | "overflow" | "manual";
-}
-/** Map of hook names to handler signatures. */
-export interface MikanHookMap {
-    before_agent_start: (event: BeforeAgentStartHookEvent) => BeforeAgentStartHookResult | undefined | void | Promise<BeforeAgentStartHookResult | undefined | void>;
-    tool_call: (event: ToolCallHookEvent) => ToolCallHookResult | undefined | void | Promise<ToolCallHookResult | undefined | void>;
-    tool_result: (event: ToolResultHookEvent) => void | Promise<void>;
-    message_end: (event: MessageEndHookEvent) => void | Promise<void>;
-    turn_end: (event: TurnEndHookEvent) => void | Promise<void>;
-    session_compact: (event: SessionCompactHookEvent) => void | Promise<void>;
-}
-export type MikanHookName = keyof MikanHookMap;
-/**
- * A schedule contributed by an extension. Fires an autonomous agent run in
- * this conversation with `text` as the task prompt (the run does not inherit
- * conversation history — write `text` self-contained).
- */
-export type ExtensionScheduleSpec = {
-    type: "periodic";
-    /** Cron expression (croner syntax). */
-    schedule: string;
-    /** IANA timezone, e.g. "Asia/Taipei". */
-    timezone: string;
-    text: string;
-    /** Target platform; optional when only one platform is running. */
-    platform?: string;
-} | {
-    type: "one-shot";
-    /** ISO 8601 timestamp with offset. */
-    at: string;
-    text: string;
-    platform?: string;
-};
-export interface ExtensionScheduleInfo {
-    /** Extension-chosen schedule name. */
-    name: string;
-    spec: ExtensionScheduleSpec;
-}
-/**
- * Event-file payload the harness hands to the embedder's schedule store.
- * Mirrors mikan's event-file shape; `platform` may be omitted when the
- * embedder runs a single platform.
- */
-export interface ExtensionSchedulePayload {
-    type: "one-shot" | "periodic";
-    conversationId: string;
-    text: string;
-    platform?: string;
-    at?: string;
-    schedule?: string;
-    timezone?: string;
-}
-/**
- * Persistence backend for extension schedules, injected by the embedder
- * (mikan backs this with event files watched by its EventsWatcher).
- * Filenames are fully qualified by the harness (`ext-<slug>-<name>.json`).
- */
-export interface ExtensionScheduleStore {
-    write(filename: string, payload: ExtensionSchedulePayload): Promise<void>;
-    delete(filename: string): Promise<boolean>;
-    /** List all schedule files, harness filters by ownership prefix. */
-    list(): Promise<Array<{
-        filename: string;
-        payload: ExtensionSchedulePayload;
-    }>>;
-}
-/**
- * Host services injected into extensions by the embedder. All fields are
- * optional: the corresponding api surface throws an informative error when
- * the running context does not provide the service.
- */
-export interface ExtensionHostServices {
-    /** State dir for per-extension data dirs; defaults to `~/.mikan`. */
-    stateDir?: string;
-    /** Schedule persistence; enables `api.schedules`. */
-    scheduleStore?: ExtensionScheduleStore;
-    /** Post a message to a conversation without an agent run; enables `api.notify`. */
-    postMessage?: (conversationId: string, text: string, platform?: string) => Promise<void>;
-    /** Add an emoji reaction to a message; enables `api.react`. */
-    addReaction?: (conversationId: string, messageTs: string, emoji: string, platform?: string) => Promise<void>;
-    /** Resolve read-only secrets for an extension slug; enables `api.secrets`. */
-    resolveSecrets?: (slug: string) => Record<string, string>;
-}
-/**
- * Optional `manifest.json` next to a directory-form extension's entrypoint.
- * `name` is the display name only; the slug (data dir, secrets, schedule
- * ownership) always derives from the install path so identity is
- * admin-controlled and stable across manifest edits.
- */
-export interface ExtensionManifest {
-    name?: string;
-    version?: string;
-    description?: string;
-}
-/** API handed to an extension's `activate` function. */
-export interface MikanExtensionApi {
-    /** Register a hook handler. */
-    on<T extends MikanHookName>(hook: T, handler: MikanHookMap[T]): void;
-    /** Contribute an additional agent tool. */
-    registerTool(tool: AgentTool): void;
-    /** Extension-scoped logging that lands in mikan's structured log. */
-    log(message: string): void;
-    /** Context about the conversation this harness instance serves. */
-    readonly context: {
-        readonly conversationId: string;
-        readonly workspaceDir: string;
-        readonly model: Model<Api>;
-        readonly thinkingLevel: ThinkingLevel;
-    };
-    /**
-     * Host-only filesystem locations owned by this extension (never mounted
-     * into sandbox containers). Which one you use is a declaration: `dataDir`
-     * for conversation-scoped state (the safe default — isolation for free),
-     * `sharedDataDir` for deliberately cross-conversation state (you own tenant
-     * partitioning and concurrency). See `LAYOUT.md`.
-     */
-    readonly paths: {
-        /**
-         * This conversation's private data directory
-         * (`conversations/<conversationId>/extension-data/<slug>`), created on
-         * first access. Default choice: co-located with the conversation, so it
-         * disappears when the conversation is deleted.
-         */
-        readonly dataDir: string;
-        /**
-         * Data shared across all conversations this extension serves
-         * (`global/extension-data/<slug>`), created on first access. Explicit
-         * opt-in for multi-conversation applications (e.g. a PM tool with
-         * cross-channel views); key rows by conversation id yourself.
-         */
-        readonly sharedDataDir: string;
-    };
-    /**
-     * Read-only secrets from the embedder's vault
-     * (mikan: `<stateDir>/vaults/extensions/<slug>/env`).
-     */
-    readonly secrets: {
-        get(key: string): string | undefined;
-        /** Secret names only, never values. */
-        list(): string[];
-    };
-    /**
-     * Named schedules owned by this extension + conversation. Backed by the
-     * embedder's schedule store; in mikan these become event files that fire
-     * autonomous agent runs (hot-reloaded, persisted across restarts).
-     */
-    readonly schedules: {
-        /** Create or replace a named schedule. */
-        upsert(name: string, spec: ExtensionScheduleSpec): Promise<void>;
-        /** Delete a named schedule. Returns false when it did not exist. */
-        delete(name: string): Promise<boolean>;
-        /** Schedules owned by this extension in this conversation. */
-        list(): Promise<ExtensionScheduleInfo[]>;
-    };
-    /**
-     * Post text into this conversation without triggering an agent run.
-     * Available when the embedder provides platform messaging.
-     */
-    notify(text: string): Promise<void>;
-    /**
-     * Add an emoji reaction to a message in this conversation. `messageTs` is
-     * the platform message id the extension read from an event; `emoji` is a
-     * short name without colons. Available when the embedder provides reaction
-     * support.
-     */
-    react(messageTs: string, emoji: string): Promise<void>;
-}
-export type MikanExtensionActivate = (api: MikanExtensionApi) => void | Promise<void>;
-export interface MikanExtensionModule {
-    name?: string;
-    activate: MikanExtensionActivate;
-}
-export interface LoadedExtension {
-    name: string;
-    path: string;
-    /** Filesystem-safe identifier used for data dirs, secrets, and schedules. */
-    slug: string;
-    version?: string;
-    description?: string;
-    /** Skills discovered under the extension's `skills/` directory. */
-    skills: MikanSkill[];
-}
-export interface ExtensionLoadError {
-    path: string;
-    error: string;
-}
-//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/harness/extensions/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * mikan extension system, v1.\n *\n * Extensions are ES modules that export an `activate` function (either as\n * the default export or a named `activate` export, optionally wrapped in an\n * object that also carries a `name`). `activate` receives a\n * {@link MikanExtensionApi} and registers hooks and tools.\n *\n * ```js\n * // extensions/audit.mjs\n * export default function activate(api) {\n *   api.on(\"tool_call\", ({ toolName, args }) => {\n *     if (toolName === \"bash\" && String(args.command).includes(\"rm -rf /\")) {\n *       return { block: true, reason: \"destructive command\" };\n *     }\n *   });\n * }\n * ```\n *\n * Hooks run in registration order. For hooks with results, the first\n * non-undefined result wins (v1 semantics; later versions may merge).\n * Hook errors are logged and never crash a run.\n */\nimport type { AgentMessage, AgentTool, ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, ImageContent, Model, TextContent } from \"@earendil-works/pi-ai\";\nimport type { MikanSkill } from \"../skills.js\";\nimport type { CompactionEntry } from \"../types.js\";\n\nexport interface BeforeAgentStartHookEvent {\n  prompt: string;\n  images?: ImageContent[];\n  systemPrompt: string;\n}\n\nexport interface BeforeAgentStartHookResult {\n  /** Replace the system prompt for this turn. */\n  systemPrompt?: string;\n}\n\nexport interface ToolCallHookEvent {\n  toolCallId: string;\n  toolName: string;\n  args: unknown;\n}\n\nexport interface ToolCallHookResult {\n  /** Block the tool call; the model receives an error tool result instead. */\n  block?: boolean;\n  reason?: string;\n}\n\nexport interface ToolResultHookEvent {\n  toolCallId: string;\n  toolName: string;\n  args: unknown;\n  content: (TextContent | ImageContent)[];\n  isError: boolean;\n}\n\nexport interface MessageEndHookEvent {\n  message: AgentMessage;\n}\n\nexport interface TurnEndHookEvent {\n  messages: AgentMessage[];\n}\n\nexport interface SessionCompactHookEvent {\n  entry: CompactionEntry;\n  reason: \"threshold\" | \"overflow\" | \"manual\";\n}\n\n/** Map of hook names to handler signatures. */\nexport interface MikanHookMap {\n  before_agent_start: (\n    event: BeforeAgentStartHookEvent,\n  ) =>\n    | BeforeAgentStartHookResult\n    | undefined\n    | void\n    | Promise<BeforeAgentStartHookResult | undefined | void>;\n  tool_call: (\n    event: ToolCallHookEvent,\n  ) => ToolCallHookResult | undefined | void | Promise<ToolCallHookResult | undefined | void>;\n  tool_result: (event: ToolResultHookEvent) => void | Promise<void>;\n  message_end: (event: MessageEndHookEvent) => void | Promise<void>;\n  turn_end: (event: TurnEndHookEvent) => void | Promise<void>;\n  session_compact: (event: SessionCompactHookEvent) => void | Promise<void>;\n}\n\nexport type MikanHookName = keyof MikanHookMap;\n\n// ── v2: schedules ────────────────────────────────────────────────────────────\n\n/**\n * A schedule contributed by an extension. Fires an autonomous agent run in\n * this conversation with `text` as the task prompt (the run does not inherit\n * conversation history — write `text` self-contained).\n */\nexport type ExtensionScheduleSpec =\n  | {\n      type: \"periodic\";\n      /** Cron expression (croner syntax). */\n      schedule: string;\n      /** IANA timezone, e.g. \"Asia/Taipei\". */\n      timezone: string;\n      text: string;\n      /** Target platform; optional when only one platform is running. */\n      platform?: string;\n    }\n  | {\n      type: \"one-shot\";\n      /** ISO 8601 timestamp with offset. */\n      at: string;\n      text: string;\n      platform?: string;\n    };\n\nexport interface ExtensionScheduleInfo {\n  /** Extension-chosen schedule name. */\n  name: string;\n  spec: ExtensionScheduleSpec;\n}\n\n/**\n * Event-file payload the harness hands to the embedder's schedule store.\n * Mirrors mikan's event-file shape; `platform` may be omitted when the\n * embedder runs a single platform.\n */\nexport interface ExtensionSchedulePayload {\n  type: \"one-shot\" | \"periodic\";\n  conversationId: string;\n  text: string;\n  platform?: string;\n  at?: string;\n  schedule?: string;\n  timezone?: string;\n}\n\n// ── v2: embedder-injected services ───────────────────────────────────────────\n\n/**\n * Persistence backend for extension schedules, injected by the embedder\n * (mikan backs this with event files watched by its EventsWatcher).\n * Filenames are fully qualified by the harness (`ext-<slug>-<name>.json`).\n */\nexport interface ExtensionScheduleStore {\n  write(filename: string, payload: ExtensionSchedulePayload): Promise<void>;\n  delete(filename: string): Promise<boolean>;\n  /** List all schedule files, harness filters by ownership prefix. */\n  list(): Promise<Array<{ filename: string; payload: ExtensionSchedulePayload }>>;\n}\n\n/**\n * Host services injected into extensions by the embedder. All fields are\n * optional: the corresponding api surface throws an informative error when\n * the running context does not provide the service.\n */\nexport interface ExtensionHostServices {\n  /** State dir for per-extension data dirs; defaults to `~/.mikan`. */\n  stateDir?: string;\n  /** Schedule persistence; enables `api.schedules`. */\n  scheduleStore?: ExtensionScheduleStore;\n  /** Post a message to a conversation without an agent run; enables `api.notify`. */\n  postMessage?: (conversationId: string, text: string, platform?: string) => Promise<void>;\n  /** Add an emoji reaction to a message; enables `api.react`. */\n  addReaction?: (\n    conversationId: string,\n    messageTs: string,\n    emoji: string,\n    platform?: string,\n  ) => Promise<void>;\n  /** Resolve read-only secrets for an extension slug; enables `api.secrets`. */\n  resolveSecrets?: (slug: string) => Record<string, string>;\n}\n\n// ── v2: manifest ─────────────────────────────────────────────────────────────\n\n/**\n * Optional `manifest.json` next to a directory-form extension's entrypoint.\n * `name` is the display name only; the slug (data dir, secrets, schedule\n * ownership) always derives from the install path so identity is\n * admin-controlled and stable across manifest edits.\n */\nexport interface ExtensionManifest {\n  name?: string;\n  version?: string;\n  description?: string;\n}\n\n/** API handed to an extension's `activate` function. */\nexport interface MikanExtensionApi {\n  /** Register a hook handler. */\n  on<T extends MikanHookName>(hook: T, handler: MikanHookMap[T]): void;\n  /** Contribute an additional agent tool. */\n  registerTool(tool: AgentTool): void;\n  /** Extension-scoped logging that lands in mikan's structured log. */\n  log(message: string): void;\n  /** Context about the conversation this harness instance serves. */\n  readonly context: {\n    readonly conversationId: string;\n    readonly workspaceDir: string;\n    readonly model: Model<Api>;\n    readonly thinkingLevel: ThinkingLevel;\n  };\n  /**\n   * Host-only filesystem locations owned by this extension (never mounted\n   * into sandbox containers). Which one you use is a declaration: `dataDir`\n   * for conversation-scoped state (the safe default — isolation for free),\n   * `sharedDataDir` for deliberately cross-conversation state (you own tenant\n   * partitioning and concurrency). See `LAYOUT.md`.\n   */\n  readonly paths: {\n    /**\n     * This conversation's private data directory\n     * (`conversations/<conversationId>/extension-data/<slug>`), created on\n     * first access. Default choice: co-located with the conversation, so it\n     * disappears when the conversation is deleted.\n     */\n    readonly dataDir: string;\n    /**\n     * Data shared across all conversations this extension serves\n     * (`global/extension-data/<slug>`), created on first access. Explicit\n     * opt-in for multi-conversation applications (e.g. a PM tool with\n     * cross-channel views); key rows by conversation id yourself.\n     */\n    readonly sharedDataDir: string;\n  };\n  /**\n   * Read-only secrets from the embedder's vault\n   * (mikan: `<stateDir>/vaults/extensions/<slug>/env`).\n   */\n  readonly secrets: {\n    get(key: string): string | undefined;\n    /** Secret names only, never values. */\n    list(): string[];\n  };\n  /**\n   * Named schedules owned by this extension + conversation. Backed by the\n   * embedder's schedule store; in mikan these become event files that fire\n   * autonomous agent runs (hot-reloaded, persisted across restarts).\n   */\n  readonly schedules: {\n    /** Create or replace a named schedule. */\n    upsert(name: string, spec: ExtensionScheduleSpec): Promise<void>;\n    /** Delete a named schedule. Returns false when it did not exist. */\n    delete(name: string): Promise<boolean>;\n    /** Schedules owned by this extension in this conversation. */\n    list(): Promise<ExtensionScheduleInfo[]>;\n  };\n  /**\n   * Post text into this conversation without triggering an agent run.\n   * Available when the embedder provides platform messaging.\n   */\n  notify(text: string): Promise<void>;\n  /**\n   * Add an emoji reaction to a message in this conversation. `messageTs` is\n   * the platform message id the extension read from an event; `emoji` is a\n   * short name without colons. Available when the embedder provides reaction\n   * support.\n   */\n  react(messageTs: string, emoji: string): Promise<void>;\n}\n\nexport type MikanExtensionActivate = (api: MikanExtensionApi) => void | Promise<void>;\n\nexport interface MikanExtensionModule {\n  name?: string;\n  activate: MikanExtensionActivate;\n}\n\nexport interface LoadedExtension {\n  name: string;\n  path: string;\n  /** Filesystem-safe identifier used for data dirs, secrets, and schedules. */\n  slug: string;\n  version?: string;\n  description?: string;\n  /** Skills discovered under the extension's `skills/` directory. */\n  skills: MikanSkill[];\n}\n\nexport interface ExtensionLoadError {\n  path: string;\n  error: string;\n}\n"]}

package/dist/harness/session-store.d.ts

@@ -1,77 +0,0 @@
-import type { AgentMessage } from "@earendil-works/pi-agent-core";
-import type { ImageContent, TextContent } from "@earendil-works/pi-ai";
-import { type SessionContext, type SessionEntry, type SessionFileEntry, type SessionHeader } from "./types.js";
-/** Parse JSONL content tolerantly: malformed lines are skipped. */
-export declare function parseSessionFileEntries(content: string): SessionFileEntry[];
-/**
- * Load a session file. Returns no entries when the file is missing or its
- * first parseable line is not a valid session header (mirrors the tolerant
- * read behavior mikan has relied on). Throws only on I/O errors.
- */
-export declare function loadSessionFileEntries(filePath: string): SessionFileEntry[];
-/**
- * Append-oriented session store over one v3 JSONL file.
- *
- * Reading is tolerant (missing files and malformed lines yield an empty
- * session); appends persist immediately. A session opened from a file
- * without a valid header gets its header materialized on the first append.
- */
-export declare class SessionStore {
-    private readonly sessionFile;
-    private readonly cwd;
-    private readonly sessionId;
-    private header;
-    private headerOnDisk;
-    private entries;
-    private byId;
-    private leafId;
-    private constructor();
-    /**
-     * Open a session file. A missing or empty file starts an empty session
-     * whose header is written on the first append. A file that has content but
-     * no leading session header is treated as corrupted and throws, rather than
-     * being silently overwritten on the next append (which would erase the
-     * existing history). Callers on read paths already wrap this in try/catch.
-     * @param cwdOverride Working directory override; defaults to the header cwd.
-     */
-    static open(path: string, cwdOverride?: string): SessionStore;
-    /** Create a new session file with a fresh header, replacing any existing file. */
-    static create(path: string, cwd: string, options?: {
-        id?: string;
-    }): SessionStore;
-    getSessionFile(): string;
-    getCwd(): string;
-    /** Session header as read from disk, or null when the file had none. */
-    getHeader(): SessionHeader | null;
-    /** Stable session id: the header id, or a generated id for fresh sessions. */
-    getSessionId(): string;
-    getLeafId(): string | null;
-    getEntry(id: string): SessionEntry | undefined;
-    /** All session entries (header excluded). Returns a shallow copy. */
-    getEntries(): SessionEntry[];
-    /** Latest user-assigned session name, if any. */
-    getSessionName(): string | undefined;
-    /**
-     * Walk from an entry to the root, returning entries in path order
-     * (root first). Defaults to the current leaf.
-     */
-    getBranch(fromId?: string): SessionEntry[];
-    /**
-     * Build the LLM context (messages, thinking level, model) from the current
-     * branch, resolving compaction and branch summaries along the path.
-     */
-    buildSessionContext(): SessionContext;
-    /** Append a chat message as a child of the current leaf. Returns the entry id. */
-    appendMessage(message: AgentMessage): string;
-    /** Append an extension/application data entry (never sent to the LLM). */
-    appendCustomEntry(customType: string, data?: unknown): string;
-    /** Append a custom message entry that participates in LLM context. */
-    appendCustomMessageEntry(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details?: unknown): string;
-    /** Record a user-visible session name. */
-    appendSessionInfo(name: string): string;
-    /** Persist a compaction summary produced for this session. */
-    appendCompaction(summary: string, firstKeptEntryId: string, tokensBefore: number, details?: unknown, fromHook?: boolean): string;
-    private appendEntry;
-    private persist;
-}
-//# sourceMappingURL=session-store.d.ts.map

package/dist/harness/session-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/harness/session-store.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAkBpB,mEAAmE;AACnE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAmB3E;AAMD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAM3E;AAQD;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,MAAM,CAAuB;IAErC,OAAO,eAiBN;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAW5D;IAED,kFAAkF;IAClF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAUhF;IAED,cAAc,IAAI,MAAM,CAEvB;IAED,MAAM,IAAI,MAAM,CAEf;IAED,wEAAwE;IACxE,SAAS,IAAI,aAAa,GAAG,IAAI,CAEhC;IAED,8EAA8E;IAC9E,YAAY,IAAI,MAAM,CAErB;IAED,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7C;IAED,qEAAqE;IACrE,UAAU,IAAI,YAAY,EAAE,CAE3B;IAED,iDAAiD;IACjD,cAAc,IAAI,MAAM,GAAG,SAAS,CAMnC;IAED;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAUzC;IAED;;;OAGG;IACH,mBAAmB,IAAI,cAAc,CAEpC;IAED,kFAAkF;IAClF,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAE3C;IAED,0EAA0E;IAC1E,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAE5D;IAED,sEAAsE;IACtE,wBAAwB,CACtB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CAER;IAED,0CAA0C;IAC1C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtC;IAED,8DAA8D;IAC9D,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,OAAO,GACjB,MAAM,CASR;IAED,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,OAAO;CAiBhB"}

package/dist/harness/session-store.js

@@ -1,248 +0,0 @@
-/**
- * mikan-owned session storage.
- *
- * Sessions are append-only trees stored as JSONL files: a `session` header
- * line followed by entries that carry `id`/`parentId` links. The format is
- * the v3 layout mikan has always written, and entry shapes are structurally
- * identical to pi-agent-core's `SessionTreeEntry`, so pi-agent-core's
- * context-building and compaction helpers operate on these entries directly.
- *
- * The store is synchronous by design: every mikan call site (session scope
- * resolution, chat-history sync, session view, admin portal) reads and
- * writes sessions inside synchronous flows.
- */
-import { randomUUID } from "crypto";
-import { appendFileSync, existsSync, mkdirSync, readFileSync } from "fs";
-import { dirname, resolve } from "path";
-import { buildSessionContext as buildContextFromEntries } from "@earendil-works/pi-agent-core";
-import { atomicWritePrivateFile } from "../utils/fs-atomic.js";
-import { CURRENT_SESSION_VERSION, } from "./types.js";
-/** Generate a unique short entry id (8 hex chars, collision-checked). */
-function generateEntryId(byId) {
-    for (let i = 0; i < 100; i++) {
-        const id = randomUUID().slice(0, 8);
-        if (!byId.has(id))
-            return id;
-    }
-    return randomUUID();
-}
-/** Parse JSONL content tolerantly: malformed lines are skipped. */
-export function parseSessionFileEntries(content) {
-    const entries = [];
-    for (const line of content.split("\n")) {
-        const trimmed = line.trim();
-        if (!trimmed)
-            continue;
-        try {
-            const parsed = JSON.parse(trimmed);
-            if (parsed &&
-                typeof parsed === "object" &&
-                typeof parsed.type === "string") {
-                entries.push(parsed);
-            }
-        }
-        catch {
-            // Skip malformed lines
-        }
-    }
-    return entries;
-}
-function isSessionHeader(entry) {
-    return entry.type === "session" && typeof entry.id === "string";
-}
-/**
- * Load a session file. Returns no entries when the file is missing or its
- * first parseable line is not a valid session header (mirrors the tolerant
- * read behavior mikan has relied on). Throws only on I/O errors.
- */
-export function loadSessionFileEntries(filePath) {
-    if (!existsSync(filePath))
-        return [];
-    const entries = parseSessionFileEntries(readFileSync(filePath, "utf-8"));
-    if (entries.length === 0)
-        return entries;
-    if (!isSessionHeader(entries[0]))
-        return [];
-    return entries;
-}
-/** True when the file exists and holds any non-whitespace content on disk. */
-function hasSessionFileContent(filePath) {
-    if (!existsSync(filePath))
-        return false;
-    return readFileSync(filePath, "utf-8").trim().length > 0;
-}
-/**
- * Append-oriented session store over one v3 JSONL file.
- *
- * Reading is tolerant (missing files and malformed lines yield an empty
- * session); appends persist immediately. A session opened from a file
- * without a valid header gets its header materialized on the first append.
- */
-export class SessionStore {
-    constructor(sessionFile, cwd, fileEntries) {
-        this.entries = [];
-        this.byId = new Map();
-        this.leafId = null;
-        this.sessionFile = resolve(sessionFile);
-        this.header = fileEntries.length > 0 && isSessionHeader(fileEntries[0]) ? fileEntries[0] : null;
-        this.headerOnDisk = this.header !== null;
-        this.sessionId = this.header?.id ?? randomUUID();
-        this.cwd = cwd;
-        for (const entry of fileEntries) {
-            if (isSessionHeader(entry))
-                continue;
-            if (entry.type === "leaf") {
-                // Written by pi-agent-core JSONL sessions; mikan tracks the leaf implicitly.
-                this.leafId = entry.targetId;
-                continue;
-            }
-            this.entries.push(entry);
-            this.byId.set(entry.id, entry);
-            this.leafId = entry.id;
-        }
-    }
-    /**
-     * Open a session file. A missing or empty file starts an empty session
-     * whose header is written on the first append. A file that has content but
-     * no leading session header is treated as corrupted and throws, rather than
-     * being silently overwritten on the next append (which would erase the
-     * existing history). Callers on read paths already wrap this in try/catch.
-     * @param cwdOverride Working directory override; defaults to the header cwd.
-     */
-    static open(path, cwdOverride) {
-        const fileEntries = loadSessionFileEntries(path);
-        if (fileEntries.length === 0 && hasSessionFileContent(path)) {
-            throw new Error(`Session file is corrupted (no valid session header): ${path}. ` +
-                `Refusing to open to avoid overwriting existing content.`);
-        }
-        const header = fileEntries.find(isSessionHeader);
-        const cwd = cwdOverride ?? header?.cwd ?? process.cwd();
-        return new SessionStore(path, cwd, fileEntries);
-    }
-    /** Create a new session file with a fresh header, replacing any existing file. */
-    static create(path, cwd, options) {
-        const header = {
-            type: "session",
-            version: CURRENT_SESSION_VERSION,
-            id: options?.id ?? randomUUID(),
-            timestamp: new Date().toISOString(),
-            cwd,
-        };
-        atomicWritePrivateFile(path, `${JSON.stringify(header)}\n`);
-        return new SessionStore(path, cwd, [header]);
-    }
-    getSessionFile() {
-        return this.sessionFile;
-    }
-    getCwd() {
-        return this.cwd;
-    }
-    /** Session header as read from disk, or null when the file had none. */
-    getHeader() {
-        return this.header;
-    }
-    /** Stable session id: the header id, or a generated id for fresh sessions. */
-    getSessionId() {
-        return this.sessionId;
-    }
-    getLeafId() {
-        return this.leafId;
-    }
-    getEntry(id) {
-        return this.byId.get(id);
-    }
-    /** All session entries (header excluded). Returns a shallow copy. */
-    getEntries() {
-        return [...this.entries];
-    }
-    /** Latest user-assigned session name, if any. */
-    getSessionName() {
-        for (let i = this.entries.length - 1; i >= 0; i--) {
-            const entry = this.entries[i];
-            if (entry.type === "session_info")
-                return entry.name?.trim() || undefined;
-        }
-        return undefined;
-    }
-    /**
-     * Walk from an entry to the root, returning entries in path order
-     * (root first). Defaults to the current leaf.
-     */
-    getBranch(fromId) {
-        const path = [];
-        let currentId = fromId ?? this.leafId;
-        while (currentId) {
-            const entry = this.byId.get(currentId);
-            if (!entry)
-                break;
-            path.push(entry);
-            currentId = entry.parentId;
-        }
-        return path.toReversed();
-    }
-    /**
-     * Build the LLM context (messages, thinking level, model) from the current
-     * branch, resolving compaction and branch summaries along the path.
-     */
-    buildSessionContext() {
-        return buildContextFromEntries(this.getBranch());
-    }
-    /** Append a chat message as a child of the current leaf. Returns the entry id. */
-    appendMessage(message) {
-        return this.appendEntry({ type: "message", message });
-    }
-    /** Append an extension/application data entry (never sent to the LLM). */
-    appendCustomEntry(customType, data) {
-        return this.appendEntry({ type: "custom", customType, data });
-    }
-    /** Append a custom message entry that participates in LLM context. */
-    appendCustomMessageEntry(customType, content, display, details) {
-        return this.appendEntry({ type: "custom_message", customType, content, display, details });
-    }
-    /** Record a user-visible session name. */
-    appendSessionInfo(name) {
-        return this.appendEntry({ type: "session_info", name });
-    }
-    /** Persist a compaction summary produced for this session. */
-    appendCompaction(summary, firstKeptEntryId, tokensBefore, details, fromHook) {
-        return this.appendEntry({
-            type: "compaction",
-            summary,
-            firstKeptEntryId,
-            tokensBefore,
-            ...(details !== undefined ? { details } : {}),
-            ...(fromHook !== undefined ? { fromHook } : {}),
-        });
-    }
-    appendEntry(partial) {
-        const entry = {
-            ...partial,
-            id: generateEntryId(this.byId),
-            parentId: this.leafId,
-            timestamp: new Date().toISOString(),
-        };
-        this.entries.push(entry);
-        this.byId.set(entry.id, entry);
-        this.leafId = entry.id;
-        this.persist(entry);
-        return entry.id;
-    }
-    persist(entry) {
-        if (!this.headerOnDisk) {
-            this.header ??= {
-                type: "session",
-                version: CURRENT_SESSION_VERSION,
-                id: this.sessionId,
-                timestamp: new Date().toISOString(),
-                cwd: this.cwd,
-            };
-            const lines = [this.header, ...this.entries].map((line) => JSON.stringify(line));
-            mkdirSync(dirname(this.sessionFile), { recursive: true });
-            atomicWritePrivateFile(this.sessionFile, `${lines.join("\n")}\n`);
-            this.headerOnDisk = true;
-            return;
-        }
-        appendFileSync(this.sessionFile, `${JSON.stringify(entry)}\n`);
-    }
-}
-//# sourceMappingURL=session-store.js.map