@geminixiang/mikan 0.5.2 → 1.0.0-beta.0

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

@@ -0,0 +1,225 @@
+/**
+ * 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>;
+    /** 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. */
+    readonly paths: {
+        /**
+         * Per-extension data directory under the state dir
+         * (`<stateDir>/extension-data/<slug>`), created on first access.
+         * Host-only: never mounted into sandbox containers.
+         */
+        readonly dataDir: 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>;
+}
+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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"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  /** 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  /** Host-only filesystem locations owned by this extension. */\n  readonly paths: {\n    /**\n     * Per-extension data directory under the state dir\n     * (`<stateDir>/extension-data/<slug>`), created on first access.\n     * Host-only: never mounted into sandbox containers.\n     */\n    readonly dataDir: 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\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/http.d.ts

@@ -0,0 +1,16 @@
+/** Idle timeout applied to HTTP headers/body when none is configured. */
+export declare const DEFAULT_HTTP_IDLE_TIMEOUT_MS = 300000;
+/**
+ * Parse an idle-timeout setting into milliseconds.
+ *
+ * Accepts a non-negative number of milliseconds or its string form;
+ * `"disabled"` (case-insensitive) yields `0`. Returns `undefined` for
+ * anything unparseable so callers can fall back to the default.
+ */
+export declare function parseHttpIdleTimeoutMs(value: unknown): number | undefined;
+/**
+ * Install the global HTTP dispatcher and fetch. A timeout of `0` disables
+ * idle timeouts. Safe to call more than once; the last call wins.
+ */
+export declare function configureHttpDispatcher(timeoutMs?: number): void;
+//# sourceMappingURL=http.d.ts.map

package/dist/harness/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/harness/http.ts"],"names":[],"mappings":"AAmBA,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,SAAU,CAAC;AAKpD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAWzE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,GAAE,MAAqC,GAAG,IAAI,CA2B9F"}

package/dist/harness/http.js

@@ -0,0 +1,71 @@
+/**
+ * Global HTTP dispatcher configuration for the mikan harness.
+ *
+ * mikan is a long-running headless process whose LLM traffic goes through
+ * global `fetch`. Node's built-in fetch ignores `HTTP_PROXY`/`HTTPS_PROXY`/
+ * `NO_PROXY` and offers no idle-timeout control, so a proxied deployment
+ * cannot reach providers and a silently stalled streaming response would
+ * hang a session without ever erroring (auto-retry never kicks in).
+ *
+ * `configureHttpDispatcher` installs undici's `EnvHttpProxyAgent` as the
+ * global dispatcher (proxy support via the standard env vars) with
+ * headers/body idle timeouts, and swaps global `fetch` to undici's so both
+ * share one implementation. A caller that deliberately replaced `fetch`
+ * after module load is left alone.
+ *
+ * Design adapted from pi-coding-agent's http-dispatcher.
+ */
+import * as undici from "undici";
+/** Idle timeout applied to HTTP headers/body when none is configured. */
+export const DEFAULT_HTTP_IDLE_TIMEOUT_MS = 300_000;
+const originalGlobalFetch = globalThis.fetch;
+let installedGlobalFetch;
+/**
+ * Parse an idle-timeout setting into milliseconds.
+ *
+ * Accepts a non-negative number of milliseconds or its string form;
+ * `"disabled"` (case-insensitive) yields `0`. Returns `undefined` for
+ * anything unparseable so callers can fall back to the default.
+ */
+export function parseHttpIdleTimeoutMs(value) {
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed.toLowerCase() === "disabled")
+            return 0;
+        if (trimmed.length === 0)
+            return undefined;
+        return parseHttpIdleTimeoutMs(Number(trimmed));
+    }
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        return undefined;
+    }
+    return Math.floor(value);
+}
+/**
+ * Install the global HTTP dispatcher and fetch. A timeout of `0` disables
+ * idle timeouts. Safe to call more than once; the last call wins.
+ */
+export function configureHttpDispatcher(timeoutMs = DEFAULT_HTTP_IDLE_TIMEOUT_MS) {
+    const normalizedTimeoutMs = parseHttpIdleTimeoutMs(timeoutMs);
+    if (normalizedTimeoutMs === undefined) {
+        throw new Error(`Invalid HTTP idle timeout: ${String(timeoutMs)}`);
+    }
+    undici.setGlobalDispatcher(new undici.EnvHttpProxyAgent({
+        allowH2: false,
+        bodyTimeout: normalizedTimeoutMs,
+        headersTimeout: normalizedTimeoutMs,
+    }));
+    // Node's built-in fetch uses its own bundled undici and never sees the
+    // dispatcher installed above, so global fetch must be swapped to undici's.
+    const shouldInstallGlobals = installedGlobalFetch === undefined
+        ? globalThis.fetch === originalGlobalFetch
+        : globalThis.fetch === installedGlobalFetch;
+    if (shouldInstallGlobals) {
+        // `install` swaps global fetch to undici's; it only exists in undici >= 7,
+        // whose types aren't guaranteed here, so access it defensively and no-op
+        // on older undici (runtime behavior unchanged from the original `?.` call).
+        undici.install?.();
+        installedGlobalFetch = globalThis.fetch;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/harness/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/harness/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,yEAAyE;AACzE,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC;AAEpD,MAAM,mBAAmB,GAAG,UAAU,CAAC,KAAK,CAAC;AAC7C,IAAI,oBAAyD,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,UAAU;YAAE,OAAO,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAS,GAAW,4BAA4B;IACtF,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC9D,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,CAAC,mBAAmB,CACxB,IAAI,MAAM,CAAC,iBAAiB,CAAC;QAC3B,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,mBAAmB;QAChC,cAAc,EAAE,mBAAmB;KACpC,CAAC,CACH,CAAC;IAEF,uEAAuE;IACvE,2EAA2E;IAC3E,MAAM,oBAAoB,GACxB,oBAAoB,KAAK,SAAS;QAChC,CAAC,CAAC,UAAU,CAAC,KAAK,KAAK,mBAAmB;QAC1C,CAAC,CAAC,UAAU,CAAC,KAAK,KAAK,oBAAoB,CAAC;IAChD,IAAI,oBAAoB,EAAE,CAAC;QACzB,2EAA2E;QAC3E,yEAAyE;QACzE,4EAA4E;QAC3E,MAAmC,CAAC,OAAO,EAAE,EAAE,CAAC;QACjD,oBAAoB,GAAG,UAAU,CAAC,KAAK,CAAC;IAC1C,CAAC;AACH,CAAC","sourcesContent":["/**\n * Global HTTP dispatcher configuration for the mikan harness.\n *\n * mikan is a long-running headless process whose LLM traffic goes through\n * global `fetch`. Node's built-in fetch ignores `HTTP_PROXY`/`HTTPS_PROXY`/\n * `NO_PROXY` and offers no idle-timeout control, so a proxied deployment\n * cannot reach providers and a silently stalled streaming response would\n * hang a session without ever erroring (auto-retry never kicks in).\n *\n * `configureHttpDispatcher` installs undici's `EnvHttpProxyAgent` as the\n * global dispatcher (proxy support via the standard env vars) with\n * headers/body idle timeouts, and swaps global `fetch` to undici's so both\n * share one implementation. A caller that deliberately replaced `fetch`\n * after module load is left alone.\n *\n * Design adapted from pi-coding-agent's http-dispatcher.\n */\nimport * as undici from \"undici\";\n\n/** Idle timeout applied to HTTP headers/body when none is configured. */\nexport const DEFAULT_HTTP_IDLE_TIMEOUT_MS = 300_000;\n\nconst originalGlobalFetch = globalThis.fetch;\nlet installedGlobalFetch: typeof globalThis.fetch | undefined;\n\n/**\n * Parse an idle-timeout setting into milliseconds.\n *\n * Accepts a non-negative number of milliseconds or its string form;\n * `\"disabled\"` (case-insensitive) yields `0`. Returns `undefined` for\n * anything unparseable so callers can fall back to the default.\n */\nexport function parseHttpIdleTimeoutMs(value: unknown): number | undefined {\n  if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    if (trimmed.toLowerCase() === \"disabled\") return 0;\n    if (trimmed.length === 0) return undefined;\n    return parseHttpIdleTimeoutMs(Number(trimmed));\n  }\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n    return undefined;\n  }\n  return Math.floor(value);\n}\n\n/**\n * Install the global HTTP dispatcher and fetch. A timeout of `0` disables\n * idle timeouts. Safe to call more than once; the last call wins.\n */\nexport function configureHttpDispatcher(timeoutMs: number = DEFAULT_HTTP_IDLE_TIMEOUT_MS): void {\n  const normalizedTimeoutMs = parseHttpIdleTimeoutMs(timeoutMs);\n  if (normalizedTimeoutMs === undefined) {\n    throw new Error(`Invalid HTTP idle timeout: ${String(timeoutMs)}`);\n  }\n\n  undici.setGlobalDispatcher(\n    new undici.EnvHttpProxyAgent({\n      allowH2: false,\n      bodyTimeout: normalizedTimeoutMs,\n      headersTimeout: normalizedTimeoutMs,\n    }),\n  );\n\n  // Node's built-in fetch uses its own bundled undici and never sees the\n  // dispatcher installed above, so global fetch must be swapped to undici's.\n  const shouldInstallGlobals =\n    installedGlobalFetch === undefined\n      ? globalThis.fetch === originalGlobalFetch\n      : globalThis.fetch === installedGlobalFetch;\n  if (shouldInstallGlobals) {\n    // `install` swaps global fetch to undici's; it only exists in undici >= 7,\n    // whose types aren't guaranteed here, so access it defensively and no-op\n    // on older undici (runtime behavior unchanged from the original `?.` call).\n    (undici as { install?: () => void }).install?.();\n    installedGlobalFetch = globalThis.fetch;\n  }\n}\n"]}

package/dist/harness/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * mikan agent harness.
+ *
+ * mikan's own harness engineering layer, built directly on pi-agent-core
+ * (agent loop, compaction, context building) and pi-ai (providers, models,
+ * auth). See `src/harness/README.md` for the architecture.
+ */
+export { FileCredentialStore, defaultAuthPath } from "./auth.js";
+export { DEFAULT_HTTP_IDLE_TIMEOUT_MS, configureHttpDispatcher, parseHttpIdleTimeoutMs, } from "./http.js";
+export { MikanModels, defaultModelsJsonPath, type CreateMikanModelsOptions } from "./models.js";
+export { SessionStore, loadSessionFileEntries, parseSessionFileEntries } from "./session-store.js";
+export { MikanAgentSession, type CompactionReason, type HarnessEvent, type HarnessEventListener, type MikanAgentSessionOptions, } from "./runner.js";
+export { formatSkillsForPrompt, loadSkillsFromDir, parseFrontmatter, type LoadSkillsResult, type MikanSkill, type SkillDiagnostic, } from "./skills.js";
+export { DEFAULT_BUDGET_SETTINGS, DEFAULT_EVENT_BUDGET, DEFAULT_RETRY_SETTINGS, resolveHarnessSettings, type BudgetSettings, type CompactionSettings, type HarnessSettings, type RetrySettings, } from "./settings.js";
+export { ExtensionRegistry } from "./extensions/registry.js";
+export { defaultExtensionDirs, extensionSlug, loadExtensions, type LoadExtensionsOptions, type LoadExtensionsResult, } from "./extensions/loader.js";
+export type { BeforeAgentStartHookEvent, BeforeAgentStartHookResult, ExtensionHostServices, ExtensionLoadError, ExtensionManifest, ExtensionScheduleInfo, ExtensionSchedulePayload, ExtensionScheduleSpec, ExtensionScheduleStore, LoadedExtension, MessageEndHookEvent, MikanExtensionActivate, MikanExtensionApi, MikanExtensionModule, MikanHookMap, MikanHookName, SessionCompactHookEvent, ToolCallHookEvent, ToolCallHookResult, ToolResultHookEvent, TurnEndHookEvent, } from "./extensions/types.js";
+export { CURRENT_SESSION_VERSION, type BranchSummaryEntry, type CompactionEntry, type CustomEntry, type CustomMessageEntry, type SessionContext, type SessionEntry, type SessionFileEntry, type SessionHeader, type SessionInfoEntry, type SessionMessageEntry, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC"}

package/dist/harness/index.js

@@ -0,0 +1,18 @@
+/**
+ * mikan agent harness.
+ *
+ * mikan's own harness engineering layer, built directly on pi-agent-core
+ * (agent loop, compaction, context building) and pi-ai (providers, models,
+ * auth). See `src/harness/README.md` for the architecture.
+ */
+export { FileCredentialStore, defaultAuthPath } from "./auth.js";
+export { DEFAULT_HTTP_IDLE_TIMEOUT_MS, configureHttpDispatcher, parseHttpIdleTimeoutMs, } from "./http.js";
+export { MikanModels, defaultModelsJsonPath } from "./models.js";
+export { SessionStore, loadSessionFileEntries, parseSessionFileEntries } from "./session-store.js";
+export { MikanAgentSession, } from "./runner.js";
+export { formatSkillsForPrompt, loadSkillsFromDir, parseFrontmatter, } from "./skills.js";
+export { DEFAULT_BUDGET_SETTINGS, DEFAULT_EVENT_BUDGET, DEFAULT_RETRY_SETTINGS, resolveHarnessSettings, } from "./settings.js";
+export { ExtensionRegistry } from "./extensions/registry.js";
+export { defaultExtensionDirs, extensionSlug, loadExtensions, } from "./extensions/loader.js";
+export { CURRENT_SESSION_VERSION, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAiC,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EACL,iBAAiB,GAKlB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GAIjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GAKvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,cAAc,GAGf,MAAM,wBAAwB,CAAC;AAwBhC,OAAO,EACL,uBAAuB,GAWxB,MAAM,YAAY,CAAC","sourcesContent":["/**\n * mikan agent harness.\n *\n * mikan's own harness engineering layer, built directly on pi-agent-core\n * (agent loop, compaction, context building) and pi-ai (providers, models,\n * auth). See `src/harness/README.md` for the architecture.\n */\nexport { FileCredentialStore, defaultAuthPath } from \"./auth.js\";\nexport {\n  DEFAULT_HTTP_IDLE_TIMEOUT_MS,\n  configureHttpDispatcher,\n  parseHttpIdleTimeoutMs,\n} from \"./http.js\";\nexport { MikanModels, defaultModelsJsonPath, type CreateMikanModelsOptions } from \"./models.js\";\nexport { SessionStore, loadSessionFileEntries, parseSessionFileEntries } from \"./session-store.js\";\nexport {\n  MikanAgentSession,\n  type CompactionReason,\n  type HarnessEvent,\n  type HarnessEventListener,\n  type MikanAgentSessionOptions,\n} from \"./runner.js\";\nexport {\n  formatSkillsForPrompt,\n  loadSkillsFromDir,\n  parseFrontmatter,\n  type LoadSkillsResult,\n  type MikanSkill,\n  type SkillDiagnostic,\n} from \"./skills.js\";\nexport {\n  DEFAULT_BUDGET_SETTINGS,\n  DEFAULT_EVENT_BUDGET,\n  DEFAULT_RETRY_SETTINGS,\n  resolveHarnessSettings,\n  type BudgetSettings,\n  type CompactionSettings,\n  type HarnessSettings,\n  type RetrySettings,\n} from \"./settings.js\";\nexport { ExtensionRegistry } from \"./extensions/registry.js\";\nexport {\n  defaultExtensionDirs,\n  extensionSlug,\n  loadExtensions,\n  type LoadExtensionsOptions,\n  type LoadExtensionsResult,\n} from \"./extensions/loader.js\";\nexport type {\n  BeforeAgentStartHookEvent,\n  BeforeAgentStartHookResult,\n  ExtensionHostServices,\n  ExtensionLoadError,\n  ExtensionManifest,\n  ExtensionScheduleInfo,\n  ExtensionSchedulePayload,\n  ExtensionScheduleSpec,\n  ExtensionScheduleStore,\n  LoadedExtension,\n  MessageEndHookEvent,\n  MikanExtensionActivate,\n  MikanExtensionApi,\n  MikanExtensionModule,\n  MikanHookMap,\n  MikanHookName,\n  SessionCompactHookEvent,\n  ToolCallHookEvent,\n  ToolCallHookResult,\n  ToolResultHookEvent,\n  TurnEndHookEvent,\n} from \"./extensions/types.js\";\nexport {\n  CURRENT_SESSION_VERSION,\n  type BranchSummaryEntry,\n  type CompactionEntry,\n  type CustomEntry,\n  type CustomMessageEntry,\n  type SessionContext,\n  type SessionEntry,\n  type SessionFileEntry,\n  type SessionHeader,\n  type SessionInfoEntry,\n  type SessionMessageEntry,\n} from \"./types.js\";\n"]}

package/dist/harness/models.d.ts

@@ -0,0 +1,34 @@
+import { type Api, type AuthResult, type Model, type Models } from "@earendil-works/pi-ai";
+/** Default location of mikan's models.json. */
+export declare function defaultModelsJsonPath(): string;
+export interface CreateMikanModelsOptions {
+    authPath?: string;
+    modelsJsonPath?: string;
+}
+/**
+ * Model catalog backed by pi-ai's `Models`. Exposes the lookup and auth
+ * operations mikan needs; streaming goes through {@link MikanModels.models}.
+ */
+export declare class MikanModels {
+    /** Underlying pi-ai collection, for streaming/completion calls. */
+    readonly models: Models;
+    private loadError;
+    private constructor();
+    static create(options?: CreateMikanModelsOptions): MikanModels;
+    /** Error from loading models.json, if any. Built-in models stay available. */
+    getError(): string | undefined;
+    /** All known models (built-in plus custom). */
+    getAll(): Model<Api>[];
+    /** Find a model by provider and id. */
+    find(provider: string, modelId: string): Model<Api> | undefined;
+    /** Models whose provider auth currently resolves (API key, OAuth, or ambient). */
+    getAvailable(): Promise<Model<Api>[]>;
+    /** Resolve request auth for a model. Undefined when unconfigured. */
+    getAuth(model: Model<Api>): Promise<AuthResult | undefined>;
+    /**
+     * Resolve an API key for a provider. Convenience for call sites that only
+     * need a bearer key (for example pi-agent-core's compat stream function).
+     */
+    getApiKeyForProvider(provider: string): Promise<string | undefined>;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/harness/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/harness/models.ts"],"names":[],"mappings":"AA6BA,OAAO,EAEL,KAAK,GAAG,EACR,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,MAAM,EAIZ,MAAM,uBAAuB,CAAC;AAoD/B,+CAA+C;AAC/C,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AA8GD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,SAAS,CAAqB;IAEtC,OAAO,eAGN;IAED,MAAM,CAAC,MAAM,CAAC,OAAO,GAAE,wBAA6B,GAAG,WAAW,CAwBjE;IAED,8EAA8E;IAC9E,QAAQ,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,+CAA+C;IAC/C,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAErB;IAED,uCAAuC;IACvC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAE9D;IAED,kFAAkF;IAC5E,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAkB1C;IAED,qEAAqE;IACrE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAE1D;IAED;;;OAGG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CASxE;CACF"}