@geminixiang/mikan 1.0.0-beta.9 → 1.0.0-beta.91

package/dist/harness/run-events.d.ts

@@ -0,0 +1,10 @@
+import type { OfficeAddress } from "../types.js";
+import type { HarnessEvent, RunEvent, RunEventListener } from "./types.js";
+export declare function toolResultText(result: unknown): string;
+export declare function toRunEvent(event: HarnessEvent): RunEvent | undefined;
+export declare class RunEventHub {
+    private readonly listeners;
+    subscribe(address: OfficeAddress, sessionKey: string, listener: RunEventListener): () => void;
+    publish(address: OfficeAddress, sessionKey: string, event: RunEvent): void;
+}
+//# sourceMappingURL=run-events.d.ts.map

package/dist/harness/run-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-events.d.ts","sourceRoot":"","sources":["../../src/harness/run-events.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA4B3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAGtD;AAoBD,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,GAAG,SAAS,CA2CpE;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IAEtE,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAS5F;IAED,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAUzE;CACF"}

package/dist/harness/run-events.js

@@ -0,0 +1,126 @@
+import { parseSubagentProgressSnapshot } from "./tools/subagent.js";
+import { JEV_TOOL } from "./tools/jev.js";
+import { JEV_BROWSER_TOOL } from "./tools/jev-browser.js";
+import * as log from "../log.js";
+import { errorMessage } from "../unknown-values.js";
+const TOOL_CALL_PART_TYPES = new Set(["tool_use", "toolCall", "tool-call"]);
+function toolDisplayLabel(toolName, args) {
+    const label = args?.label;
+    const text = typeof label === "string" ? label.trim() || toolName : toolName;
+    if ((toolName === JEV_TOOL || toolName === JEV_BROWSER_TOOL) && text !== toolName) {
+        return `${toolName} · ${text}`;
+    }
+    return text;
+}
+function subagentProgressOf(details) {
+    if (!details || typeof details !== "object")
+        return undefined;
+    return parseSubagentProgressSnapshot(details.progress);
+}
+function toolResultContentText(result) {
+    if (!result || typeof result !== "object" || !("content" in result))
+        return undefined;
+    const content = result.content;
+    if (!Array.isArray(content))
+        return undefined;
+    const textParts = content
+        .filter((part) => part.type === "text" && part.text)
+        .map((part) => part.text);
+    return textParts.length > 0 ? textParts.join("\n") : undefined;
+}
+export function toolResultText(result) {
+    if (typeof result === "string")
+        return result;
+    return toolResultContentText(result) ?? JSON.stringify(result);
+}
+function assistantMessageParts(message) {
+    const thinking = [];
+    const text = [];
+    let callsTools = false;
+    for (const part of message.content) {
+        if (part.type === "thinking")
+            thinking.push(part.thinking);
+        else if (part.type === "text")
+            text.push(part.text);
+        if (TOOL_CALL_PART_TYPES.has(part.type ?? ""))
+            callsTools = true;
+    }
+    return { thinking, text: text.join("\n"), callsTools };
+}
+export function toRunEvent(event) {
+    switch (event.type) {
+        case "tool_execution_start":
+            return {
+                type: "tool_started",
+                toolCallId: event.toolCallId,
+                toolName: event.toolName,
+                label: toolDisplayLabel(event.toolName, event.args),
+            };
+        case "tool_execution_update": {
+            const snapshot = subagentProgressOf(event.details);
+            return snapshot
+                ? { type: "subagent_progress", toolCallId: event.toolCallId, snapshot }
+                : undefined;
+        }
+        case "tool_execution_end":
+            return {
+                type: "tool_ended",
+                toolCallId: event.toolCallId,
+                toolName: event.toolName,
+                isError: event.isError,
+                resultText: toolResultText(event.result),
+            };
+        case "text_delta":
+            return event.delta ? { type: "assistant_delta", delta: event.delta } : undefined;
+        case "message_end":
+            return event.message.role === "assistant"
+                ? { type: "assistant_message", ...assistantMessageParts(event.message) }
+                : undefined;
+        case "compaction_start":
+            return { type: "compaction_started" };
+        case "auto_retry_start":
+            return { type: "retry_started", attempt: event.attempt, maxAttempts: event.maxAttempts };
+        case "budget_exceeded":
+            return {
+                type: "budget_exceeded",
+                reason: event.reason,
+                llmCalls: event.llmCalls,
+                durationMs: event.durationMs,
+            };
+        default:
+            return undefined;
+    }
+}
+function runScopeKey(address, sessionKey) {
+    return JSON.stringify([address.platform, address.conversationId, sessionKey]);
+}
+export class RunEventHub {
+    constructor() {
+        this.listeners = new Map();
+    }
+    subscribe(address, sessionKey, listener) {
+        const key = runScopeKey(address, sessionKey);
+        const scoped = this.listeners.get(key) ?? new Set();
+        scoped.add(listener);
+        this.listeners.set(key, scoped);
+        return () => {
+            scoped.delete(listener);
+            if (scoped.size === 0 && this.listeners.get(key) === scoped)
+                this.listeners.delete(key);
+        };
+    }
+    publish(address, sessionKey, event) {
+        const scoped = this.listeners.get(runScopeKey(address, sessionKey));
+        if (!scoped)
+            return;
+        for (const listener of scoped) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                log.logWarning("Run event listener failed", errorMessage(error));
+            }
+        }
+    }
+}
+//# sourceMappingURL=run-events.js.map

package/dist/harness/run-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-events.js","sourceRoot":"","sources":["../../src/harness/run-events.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseSubagentProgressSnapshot } from \"./tools/subagent.js\";\nimport { JEV_TOOL } from \"./tools/jev.js\";\nimport { JEV_BROWSER_TOOL } from \"./tools/jev-browser.js\";\nimport type { OfficeAddress } from \"../types.js\";\nimport * as log from \"../log.js\";\nimport { errorMessage } from \"../unknown-values.js\";\nimport type { HarnessEvent, RunEvent, RunEventListener } from \"./types.js\";\n\nconst TOOL_CALL_PART_TYPES = new Set([\"tool_use\", \"toolCall\", \"tool-call\"]);\n\nfunction toolDisplayLabel(toolName: string, args: unknown): string {\n  const label = (args as { label?: unknown } | undefined)?.label;\n  const text = typeof label === \"string\" ? label.trim() || toolName : toolName;\n  if ((toolName === JEV_TOOL || toolName === JEV_BROWSER_TOOL) && text !== toolName) {\n    return `${toolName} · ${text}`;\n  }\n  return text;\n}\n\nfunction subagentProgressOf(details: unknown) {\n  if (!details || typeof details !== \"object\") return undefined;\n  return parseSubagentProgressSnapshot((details as { progress?: unknown }).progress);\n}\n\nfunction toolResultContentText(result: unknown): string | undefined {\n  if (!result || typeof result !== \"object\" || !(\"content\" in result)) return undefined;\n  const content = (result as { content: unknown }).content;\n  if (!Array.isArray(content)) return undefined;\n  const textParts = (content as Array<{ type?: string; text?: string }>)\n    .filter((part) => part.type === \"text\" && part.text)\n    .map((part) => part.text);\n  return textParts.length > 0 ? textParts.join(\"\\n\") : undefined;\n}\n\nexport function toolResultText(result: unknown): string {\n  if (typeof result === \"string\") return result;\n  return toolResultContentText(result) ?? JSON.stringify(result);\n}\n\ntype AssistantMessageEvent = Extract<HarnessEvent, { type: \"message_end\" }>[\"message\"];\n\nfunction assistantMessageParts(message: Extract<AssistantMessageEvent, { role: \"assistant\" }>): {\n  thinking: string[];\n  text: string;\n  callsTools: boolean;\n} {\n  const thinking: string[] = [];\n  const text: string[] = [];\n  let callsTools = false;\n  for (const part of message.content) {\n    if (part.type === \"thinking\") thinking.push(part.thinking);\n    else if (part.type === \"text\") text.push(part.text);\n    if (TOOL_CALL_PART_TYPES.has((part as { type?: string }).type ?? \"\")) callsTools = true;\n  }\n  return { thinking, text: text.join(\"\\n\"), callsTools };\n}\n\nexport function toRunEvent(event: HarnessEvent): RunEvent | undefined {\n  switch (event.type) {\n    case \"tool_execution_start\":\n      return {\n        type: \"tool_started\",\n        toolCallId: event.toolCallId,\n        toolName: event.toolName,\n        label: toolDisplayLabel(event.toolName, event.args),\n      };\n    case \"tool_execution_update\": {\n      const snapshot = subagentProgressOf(event.details);\n      return snapshot\n        ? { type: \"subagent_progress\", toolCallId: event.toolCallId, snapshot }\n        : undefined;\n    }\n    case \"tool_execution_end\":\n      return {\n        type: \"tool_ended\",\n        toolCallId: event.toolCallId,\n        toolName: event.toolName,\n        isError: event.isError,\n        resultText: toolResultText(event.result),\n      };\n    case \"text_delta\":\n      return event.delta ? { type: \"assistant_delta\", delta: event.delta } : undefined;\n    case \"message_end\":\n      return event.message.role === \"assistant\"\n        ? { type: \"assistant_message\", ...assistantMessageParts(event.message) }\n        : undefined;\n    case \"compaction_start\":\n      return { type: \"compaction_started\" };\n    case \"auto_retry_start\":\n      return { type: \"retry_started\", attempt: event.attempt, maxAttempts: event.maxAttempts };\n    case \"budget_exceeded\":\n      return {\n        type: \"budget_exceeded\",\n        reason: event.reason,\n        llmCalls: event.llmCalls,\n        durationMs: event.durationMs,\n      };\n    default:\n      return undefined;\n  }\n}\n\nfunction runScopeKey(address: OfficeAddress, sessionKey: string): string {\n  return JSON.stringify([address.platform, address.conversationId, sessionKey]);\n}\n\nexport class RunEventHub {\n  private readonly listeners = new Map<string, Set<RunEventListener>>();\n\n  subscribe(address: OfficeAddress, sessionKey: string, listener: RunEventListener): () => void {\n    const key = runScopeKey(address, sessionKey);\n    const scoped = this.listeners.get(key) ?? new Set<RunEventListener>();\n    scoped.add(listener);\n    this.listeners.set(key, scoped);\n    return () => {\n      scoped.delete(listener);\n      if (scoped.size === 0 && this.listeners.get(key) === scoped) this.listeners.delete(key);\n    };\n  }\n\n  publish(address: OfficeAddress, sessionKey: string, event: RunEvent): void {\n    const scoped = this.listeners.get(runScopeKey(address, sessionKey));\n    if (!scoped) return;\n    for (const listener of scoped) {\n      try {\n        listener(event);\n      } catch (error) {\n        log.logWarning(\"Run event listener failed\", errorMessage(error));\n      }\n    }\n  }\n}\n"]}

package/dist/harness/runner.d.ts

@@ -1,124 +1,3 @@
-/**
- * MikanAgentSession — mikan's agent run loop.
- *
- * Owns a pi-agent-core `Agent` and layers on the behaviors mikan needs for
- * long-lived chat conversations:
- *
- * - message persistence into the conversation's {@link SessionStore}
- * - automatic context compaction (threshold and overflow recovery), using
- *   pi-agent-core's compaction pipeline over the session tree
- * - automatic retry with exponential backoff on transient provider errors
- * - extension hook dispatch ({@link ExtensionRegistry})
- *
- * Events mirror the agent's lifecycle events plus `compaction_start/_end`
- * and `auto_retry_start/_end`, preserving the event surface mikan's
- * platform adapters already render.
- */
-import { Agent, type AgentEvent, type AgentMessage, type AgentTool, type ThinkingLevel } from "@earendil-works/pi-agent-core";
-import { type Api, type ImageContent, type Model } from "@earendil-works/pi-ai";
-import type { ExtensionRegistry } from "./extensions/registry.js";
-import type { MikanModels } from "./models.js";
-import { resolveHarnessSettings, type BudgetSettings } from "./settings.js";
-import type { SessionStore } from "./session-store.js";
-export type CompactionReason = "threshold" | "overflow" | "manual";
-interface CompactionResultSummary {
-    summary: string;
-    firstKeptEntryId: string;
-    tokensBefore: number;
-}
-export type HarnessEvent = AgentEvent | {
-    type: "compaction_start";
-    reason: CompactionReason;
-} | {
-    type: "compaction_end";
-    reason: CompactionReason;
-    result?: CompactionResultSummary;
-    aborted: boolean;
-    errorMessage?: string;
-} | {
-    type: "auto_retry_start";
-    attempt: number;
-    maxAttempts: number;
-    delayMs: number;
-    errorMessage: string;
-} | {
-    type: "auto_retry_end";
-    success: boolean;
-    attempt: number;
-    finalError?: string;
-} | {
-    type: "budget_exceeded";
-    /** Which cap was hit, e.g. "cost 2.01 USD > 2 USD limit". */
-    reason: string;
-    tokens: number;
-    costUsd: number;
-    llmCalls: number;
-    durationMs: number;
-};
-export type HarnessEventListener = (event: HarnessEvent) => void | Promise<void>;
-export interface MikanAgentSessionOptions {
-    systemPrompt: string;
-    model: Model<Api>;
-    thinkingLevel: ThinkingLevel;
-    tools: AgentTool[];
-    models: MikanModels;
-    sessionStore: SessionStore;
-    settings?: Parameters<typeof resolveHarnessSettings>[0];
-    extensions?: ExtensionRegistry;
-}
-export declare class MikanAgentSession {
-    readonly agent: Agent;
-    readonly sessionStore: SessionStore;
-    private readonly models;
-    private readonly settings;
-    private readonly extensions;
-    private listeners;
-    private retryAttempt;
-    private overflowRecoveryAttempted;
-    private retryAbortController;
-    private compactionAbortController;
-    private tally;
-    private runBudget;
-    private budgetExceededReason;
-    constructor(options: MikanAgentSessionOptions);
-    /** Conversation transcript currently held by the agent. */
-    get messages(): AgentMessage[];
-    get model(): Model<Api>;
-    subscribe(listener: HarnessEventListener): () => void;
-    /** Replace the agent transcript from the persisted session tree. */
-    reloadFromSession(): number;
-    /**
-     * Send a user prompt and run the agent loop to completion, including
-     * automatic retries and compaction. Resolves when the turn (and any
-     * recovery continuations) settles.
-     *
-     * @param options.budget Per-run resource ceilings that override the session
-     *   defaults. Autonomous (event / trigger) runs should pass a budget so a
-     *   runaway loop is stopped even with no human watching.
-     */
-    prompt(text: string, options?: {
-        images?: ImageContent[];
-        budget?: BudgetSettings;
-    }): Promise<void>;
-    /** Abort the active run, pending retry backoff, and in-flight compaction. */
-    abort(): void;
-    private ensureAuthConfigured;
-    private emit;
-    private handleAgentEvent;
-    /** Fold one assistant turn's usage into the running per-run tally. */
-    private recordUsage;
-    /** Compare the tally against the run budget; abort the run when a cap is exceeded. */
-    private enforceBudget;
-    private overBudgetReason;
-    private findLastAssistantMessage;
-    /** Decide what to do after a run settles. Returns true when the agent should continue. */
-    private handlePostRun;
-    private handleOverflow;
-    private checkThresholdCompaction;
-    private runCompaction;
-    private isRetryableError;
-    private prepareRetry;
-    private dropTrailingErrorMessage;
-}
-export {};
+import type { CreateRunnerOptions, PiAgentWrapper } from "../types.js";
+export declare function createRunner(options: CreateRunnerOptions): Promise<PiAgentWrapper>;
 //# sourceMappingURL=runner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/harness/runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/harness/runner.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,cAAc,EAAE,MAAM,aAAa,CAAC;AAgyBtF,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyFxF"}