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

package/dist/harness/types.d.ts

@@ -1,32 +1,391 @@
+import type { OfficeAddress, PlatformTrustModel } from "../types.js";
+import type { MikanAgentSession } from "./session.js";
+import type { Api, ImageContent, Model, RetryPolicy, Usage } from "@earendil-works/pi-ai";
+import type { ConversationResponder, MessagingInfo, SubagentProgressSnapshot } from "../types.js";
+import type { resolveConversationSettings } from "../settings/index.js";
+import type { Executor, RuntimePathContext, SandboxConfig } from "../sandbox/index.js";
+import type { WorkspaceProjection } from "../office/types.js";
+import type { Office } from "../office/index.js";
+import type { AgentEvent, AgentHarnessTool, AgentTool, BranchSummaryEntry, CompactionEntry, CustomEntry, ExecutionToolContext, ThinkingLevel, CompactionSettings, Skill } from "@earendil-works/pi-agent-core";
+import type { MikanModels } from "./models.js";
+import type { SessionStore } from "../sessions/session-store.js";
+import type { Static, TSchema } from "@sinclair/typebox";
+export interface BuildSystemPromptOptions {
+    workspacePath: string;
+    office: Office;
+    memory: string;
+    sandboxConfig: SandboxConfig;
+    platform: MessagingInfo;
+    skills: MikanSkill[];
+    projection: WorkspaceProjection;
+    skippedSkillLinks?: string[];
+}
+export interface RunnerSessionState {
+    responder: ConversationResponder | null;
+    logCtx: {
+        conversationId: string;
+        userName?: string;
+        conversationName?: string;
+        sessionId?: string;
+    } | null;
+    queue: {
+        enqueue(fn: () => Promise<void>, errorContext: string): void;
+    } | null;
+    pendingTools: Map<string, {
+        toolName: string;
+        args: unknown;
+        startTime: number;
+    }>;
+    toolProgress: Map<string, {
+        label: string;
+        status: "running" | "done" | "error";
+    }>;
+    subagentProgress: Map<string, SubagentProgressSnapshot>;
+    completedSubagentProgress: SubagentProgressSnapshot[];
+    subagentToolCalls: Set<string>;
+    subagentProgressShown: boolean;
+    suppressResponseDeltas: boolean;
+    lastSubagentProgressAt: number;
+    toolProgressTimer: ReturnType<typeof setTimeout> | undefined;
+    totalUsage: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        cost: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+            total: number;
+        };
+    };
+    llmCallCount: number;
+    toolCallCount: number;
+    toolErrorCount: number;
+    toolInputCharacters: number;
+    toolOutputCharacters: number;
+    assistantMessageCount: number;
+    outputCharacters: number;
+    reasoningTokens: number;
+    retryCount: number;
+    compactionCount: number;
+    budgetExceeded: boolean;
+    firstTokenLatencyMs?: number;
+    responseModel?: string;
+    stopReason: string;
+    errorMessage: string | undefined;
+    reportedLlmError: boolean;
+    finalResponseHandledByTool: boolean;
+    triggerAttribution?: string;
+}
+export interface UsageReportContext {
+    session: MikanAgentSession;
+    runState: RunnerSessionState;
+    responder: ConversationResponder;
+    platform: MessagingInfo;
+    model: Model<Api>;
+    agentConfig: ReturnType<typeof resolveConversationSettings>;
+    sessionConversation: string;
+    sessionUuid: string;
+    waitForQueue: () => Promise<void>;
+}
+export interface RunnerExecutionContext {
+    executor: Executor;
+    resolveForRun(context: {
+        address: OfficeAddress;
+        userId: string;
+        trustModel?: PlatformTrustModel;
+    }): Promise<{
+        pathContext: RuntimePathContext;
+        projection: WorkspaceProjection;
+    }>;
+}
+export interface RunPresentation {
+    wait(): Promise<void>;
+    dispose(): void;
+}
+export interface PreparedRunContext {
+    sessionConversation: string;
+    userMessage: string;
+    imageAttachments: ImageContent[];
+    triggerAttribution?: string;
+}
+export type { BranchSummaryEntry, CompactionEntry, CustomEntry };
+export interface SubagentModelSpec {
+    provider: string;
+    id: string;
+}
 /**
- * Core types for the mikan agent harness.
- *
- * The harness is built directly on pi-agent-core and pi-ai. Session entries
- * are structurally identical to pi-agent-core's `SessionTreeEntry`, and the
- * on-disk JSONL format stays compatible with the v3 session files mikan has
- * always written, so existing conversation history keeps working unchanged.
+ * A curated capability set a subagent can be launched with. Built-ins ship
+ * with the harness; `<workspaceDir>/agents/<name>.md` patches them per
+ * installation. Turn, cost, and duration fields are caps — an explicit
+ * `request.budget` may tighten them but never raise them. Token budgets use the
+ * larger of the profile default and the request value.
  */
-import type { BranchSummaryEntry, CompactionEntry, CustomEntry, CustomMessageEntry, MessageEntry, SessionContext, SessionInfoEntry, SessionTreeEntry } from "@earendil-works/pi-agent-core";
-export type { BranchSummaryEntry, CompactionEntry, CustomEntry, CustomMessageEntry, SessionContext, SessionInfoEntry, };
-/** Message entry as stored in mikan session files. */
-export type SessionMessageEntry = MessageEntry;
-/** Union of entry types mikan reads and writes. Alias of pi-agent-core's tree entry. */
-export type SessionEntry = SessionTreeEntry;
-export declare const CURRENT_SESSION_VERSION = 3;
+export interface SubagentProfile {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    tools: string[];
+    model?: SubagentModelSpec;
+    thinkingLevel?: ThinkingLevel;
+    maxTurns?: number;
+    maxTokens?: number;
+    maxCostUsd?: number;
+    maxDurationMs?: number;
+}
+export interface SubagentRunBudget {
+    /** Maximum assistant/model calls in the subagent run. */
+    maxTurns?: number;
+    /** Maximum cumulative input/output/cache tokens. */
+    maxTokens?: number;
+    /** Maximum provider cost in USD. */
+    maxCostUsd?: number;
+    /** Maximum wall-clock duration. */
+    maxDurationMs?: number;
+}
+export type SubagentRunStatus = "completed" | "failed" | "cancelled" | "timeout" | "budget_exceeded" | "invalid_output";
+export interface SubagentParentContext {
+    mode: "normalized";
+    /** Number of recent user/assistant turns to include. Defaults to 3. */
+    recentTurns?: number;
+}
+/** Aggregated model usage across every assistant turn in a subagent run. */
+export type SubagentUsage = Usage;
+/** Receives usage from a subagent run, including after detached cleanup settles. */
+export type SubagentUsageSink = (usage: SubagentUsage) => void | Promise<void>;
+/** A fresh, isolated subagent run. */
+export interface SubagentRunRequest<TOutputSchema extends TSchema | undefined = undefined> {
+    task: string;
+    /** Named profile: a harness built-in, patched by `<workspaceDir>/agents/<name>.md`. */
+    profile?: string;
+    /** Opt in to a normalized textual snapshot of the active parent run. Defaults to fresh. */
+    parentContext?: SubagentParentContext;
+    systemPrompt?: string;
+    /** JSON-serializable input appended to the task. */
+    input?: unknown;
+    /** Defaults to the parent runner's configured model. */
+    model?: SubagentModelSpec;
+    /** Tool names explicitly granted to the subagent. Defaults to no tools. */
+    tools?: string[];
+    /** Per-profile thinking override. */
+    thinkingLevel?: ThinkingLevel;
+    /** When present, the final response must be JSON matching this schema. */
+    outputSchema?: TOutputSchema;
+    budget?: SubagentRunBudget;
+    signal?: AbortSignal;
+}
+export type SubagentRunOutput<TSchemaOrUndefined extends TSchema | undefined> = TSchemaOrUndefined extends TSchema ? Static<TSchemaOrUndefined> : string;
+interface SubagentRunMetadata {
+    runId: string;
+    /** Raw final assistant text, including when structured validation failed. */
+    text?: string;
+    model: SubagentModelSpec;
+    turns: number;
+    toolCalls: number;
+    toolCallCounts: Record<string, number>;
+    /** Full token and cost breakdown across the run. */
+    usage: SubagentUsage;
+    /** Aggregate token count; equivalent to `usage.totalTokens`. */
+    tokens: number;
+    /** Aggregate provider cost; equivalent to `usage.cost.total`. */
+    costUsd: number;
+    durationMs: number;
+    /**
+     * The caller received a terminal result before the underlying run settled.
+     * When true, `usage`, `tokens`, and `costUsd` are provisional snapshots;
+     * final usage is delivered later through the run's bound usage sink. The
+     * global slot remains held until cleanup settles because in-process work
+     * cannot be safely reclaimed without a killable execution boundary.
+     */
+    cleanupPending?: boolean;
+}
+interface SubagentRunCompletedResult<TOutput> extends SubagentRunMetadata {
+    status: "completed";
+    output: TOutput;
+    error?: never;
+}
+interface SubagentRunIncompleteResult extends SubagentRunMetadata {
+    status: Exclude<SubagentRunStatus, "completed">;
+    output?: never;
+    error?: string;
+}
+export type SubagentRunResult<TOutput = string> = SubagentRunCompletedResult<TOutput> | SubagentRunIncompleteResult;
+export interface CreateMikanModelsOptions {
+    modelsJsonPath?: string;
+}
 /**
- * First line of every session file. `cwd` records where the session was
- * started; extra fields (for example mikan's `source` marker) are preserved
- * verbatim on read and rewrite.
+ * A loaded skill: Pi's native `Skill` shape plus mikan provenance.
+ * `baseDir` is the directory containing the skill file.
  */
-export interface SessionHeader {
-    type: "session";
-    version?: number;
+export interface MikanSkill extends Skill {
+    baseDir: string;
+    /** Where the skill was loaded from (e.g. "workspace", "channel"). */
+    source: string;
+    /** Embed the skill body in the prompt instead of referencing its file path. */
+    inline?: boolean;
+}
+export interface SkillDiagnostic {
+    type: "warning";
+    message: string;
+    path: string;
+    /** Set when the entry was skipped because it is a symlink on a rejecting load. */
+    code?: "symlink";
+}
+export interface LoadSkillsResult {
+    skills: MikanSkill[];
+    diagnostics: SkillDiagnostic[];
+}
+export type RetrySettings = RetryPolicy;
+export interface BudgetSettings {
+    /** Max cumulative tokens processed this run (input + output + cache read/write). */
+    maxTokens?: number;
+    /** Max cumulative provider cost (USD) this run. Requires a populated model cost table. */
+    maxCostUsd?: number;
+    /** Wall-clock deadline in milliseconds; signals cancellation and waits for active cleanup. */
+    maxDurationMs?: number;
+    /** Max number of LLM calls (assistant turns) this run. */
+    maxLlmCalls?: number;
+}
+export interface HarnessSettings {
+    compaction: CompactionSettings;
+    retry: RetrySettings;
+    budget: BudgetSettings;
+}
+export interface SubagentProfileDiagnostic {
+    type: "warning";
+    message: string;
+    path: string;
+}
+export interface LoadSubagentProfilesResult {
+    profiles: Map<string, SubagentProfile>;
+    diagnostics: SubagentProfileDiagnostic[];
+}
+export type CompactionReason = "threshold" | "overflow" | "manual";
+interface CompactionResultSummary {
+    summary: string;
+    /** Number of recent messages retained inline on the compaction entry. */
+    retainedMessages: number;
+    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>;
+/**
+ * A tool as the harness sees it: pi-native tools (read/write/edit/bash) and
+ * mikan tools adapted at the tool-list boundary. The context carries the
+ * sandbox-backed execution env.
+ */
+export type MikanHarnessTool = AgentHarnessTool<ExecutionToolContext>;
+/**
+ * A session tool entry: a harness tool (pi-native or adapted), or a plain
+ * mikan `AgentTool` that the session upgrades at the boundary. The union keeps
+ * the published `MikanAgentSession` API accepting the legacy `AgentTool` shape.
+ */
+export type MikanToolInput = AgentTool | MikanHarnessTool;
+export interface MikanAgentSessionOptions {
+    systemPrompt: string;
+    model: Model<Api>;
+    thinkingLevel: ThinkingLevel;
+    tools: MikanToolInput[];
+    /** Required by native execution tools; plain AgentTools need no execution env. */
+    toolContext?: ExecutionToolContext;
+    models: MikanModels;
+    sessionStore: SessionStore;
+    settings?: {
+        compaction?: Partial<CompactionSettings>;
+        retry?: Partial<RetrySettings>;
+        budget?: Partial<BudgetSettings>;
+    };
+}
+/**
+ * MCP (Model Context Protocol) server configuration and load results.
+ *
+ * A server entry is either stdio (`command` + optional `args`/`env`) or
+ * streamable HTTP (`url` + optional `headers`). Exactly one of `command`
+ * or `url` must be set — the settings schema keeps both optional so the
+ * file stays object-rooted and forgiving; `loadMcpTools` enforces the
+ * exclusivity at runtime.
+ *
+ * Credentials (API keys in `env`/`headers`) stay in host-side settings and
+ * the MCP server process; the model sees only tool names and schemas.
+ */
+export interface McpServerConfig {
+    /** stdio transport: executable to spawn on the host. */
+    command?: string;
+    args?: string[];
+    /** Extra environment for the spawned server, merged over a safe default. */
+    env?: Record<string, string>;
+    /** streamable-HTTP transport: server endpoint URL. */
+    url?: string;
+    headers?: Record<string, string>;
+    /** Disable without deleting — lets a conversation turn off a global server. */
+    disabled?: boolean;
+}
+type McpPresetCredentialTarget = "env" | "header" | "url";
+interface McpPresetCredential {
+    key: string;
+    label: string;
+    description: string;
+    target: McpPresetCredentialTarget;
+    required: boolean;
+    secret: boolean;
+    valuePrefix?: string;
+}
+export interface McpPreset {
     id: string;
-    timestamp: string;
-    cwd: string;
-    parentSession?: string;
-    [extra: string]: unknown;
+    name: string;
+    description: string;
+    category: string;
+    serverName: string;
+    sourceUrl: string;
+    setupUrl: string;
+    server: McpServerConfig;
+    credentials: McpPresetCredential[];
+}
+export interface McpLoadError {
+    server: string;
+    error: string;
+}
+export interface McpServerInstruction {
+    server: string;
+    text: string;
+}
+export interface McpToolsResult {
+    /** Tools namespaced `mcp__<server>__<tool>`, ready for the agent tool list. */
+    tools: AgentTool<TSchema>[];
+    errors: McpLoadError[];
+    /** Admin-approved server guidance for operating its tools. */
+    instructions: McpServerInstruction[];
+    /** Close all server connections (and kill stdio child processes). */
+    dispose: () => Promise<void>;
 }
-/** Raw file line: the header or one session entry. */
-export type SessionFileEntry = SessionHeader | SessionEntry;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAE/C,wFAAwF;AACxF,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,YAAY,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"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"}

package/dist/harness/types.js

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

package/dist/harness/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC","sourcesContent":["/**\n * Core types for the mikan agent harness.\n *\n * The harness is built directly on pi-agent-core and pi-ai. Session entries\n * are structurally identical to pi-agent-core's `SessionTreeEntry`, and the\n * on-disk JSONL format stays compatible with the v3 session files mikan has\n * always written, so existing conversation history keeps working unchanged.\n */\nimport type {\n  BranchSummaryEntry,\n  CompactionEntry,\n  CustomEntry,\n  CustomMessageEntry,\n  MessageEntry,\n  SessionContext,\n  SessionInfoEntry,\n  SessionTreeEntry,\n} from \"@earendil-works/pi-agent-core\";\n\nexport type {\n  BranchSummaryEntry,\n  CompactionEntry,\n  CustomEntry,\n  CustomMessageEntry,\n  SessionContext,\n  SessionInfoEntry,\n};\n\n/** Message entry as stored in mikan session files. */\nexport type SessionMessageEntry = MessageEntry;\n\n/** Union of entry types mikan reads and writes. Alias of pi-agent-core's tree entry. */\nexport type SessionEntry = SessionTreeEntry;\n\nexport const CURRENT_SESSION_VERSION = 3;\n\n/**\n * First line of every session file. `cwd` records where the session was\n * started; extra fields (for example mikan's `source` marker) are preserved\n * verbatim on read and rewrite.\n */\nexport interface SessionHeader {\n  type: \"session\";\n  version?: number;\n  id: string;\n  timestamp: string;\n  cwd: string;\n  parentSession?: string;\n  [extra: string]: unknown;\n}\n\n/** Raw file line: the header or one session entry. */\nexport type SessionFileEntry = SessionHeader | SessionEntry;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { OfficeAddress, PlatformTrustModel } from \"../types.js\";\nimport type { MikanAgentSession } from \"./session.js\";\nimport type { Api, ImageContent, Model, RetryPolicy, Usage } from \"@earendil-works/pi-ai\";\nimport type { ConversationResponder, MessagingInfo, SubagentProgressSnapshot } from \"../types.js\";\nimport type { resolveConversationSettings } from \"../settings/index.js\";\nimport type { Executor, RuntimePathContext, SandboxConfig } from \"../sandbox/index.js\";\nimport type { WorkspaceProjection } from \"../office/types.js\";\nimport type { Office } from \"../office/index.js\";\nimport type {\n  AgentEvent,\n  AgentHarnessTool,\n  AgentTool,\n  BranchSummaryEntry,\n  CompactionEntry,\n  CustomEntry,\n  ExecutionToolContext,\n  ThinkingLevel,\n  CompactionSettings,\n  Skill,\n} from \"@earendil-works/pi-agent-core\";\nimport type { MikanModels } from \"./models.js\";\nimport type { SessionStore } from \"../sessions/session-store.js\";\nimport type { Static, TSchema } from \"@sinclair/typebox\";\n\nexport interface BuildSystemPromptOptions {\n  workspacePath: string;\n  office: Office;\n  memory: string;\n  sandboxConfig: SandboxConfig;\n  platform: MessagingInfo;\n  skills: MikanSkill[];\n  projection: WorkspaceProjection;\n  skippedSkillLinks?: string[];\n}\n\nexport interface RunnerSessionState {\n  responder: ConversationResponder | null;\n  logCtx: {\n    conversationId: string;\n    userName?: string;\n    conversationName?: string;\n    sessionId?: string;\n  } | null;\n  queue: {\n    enqueue(fn: () => Promise<void>, errorContext: string): void;\n  } | null;\n  pendingTools: Map<string, { toolName: string; args: unknown; startTime: number }>;\n  toolProgress: Map<string, { label: string; status: \"running\" | \"done\" | \"error\" }>;\n  subagentProgress: Map<string, SubagentProgressSnapshot>;\n  completedSubagentProgress: SubagentProgressSnapshot[];\n  subagentToolCalls: Set<string>;\n  subagentProgressShown: boolean;\n  suppressResponseDeltas: boolean;\n  lastSubagentProgressAt: number;\n  toolProgressTimer: ReturnType<typeof setTimeout> | undefined;\n  totalUsage: {\n    input: number;\n    output: number;\n    cacheRead: number;\n    cacheWrite: number;\n    cost: { input: number; output: number; cacheRead: number; cacheWrite: number; total: number };\n  };\n  llmCallCount: number;\n  toolCallCount: number;\n  toolErrorCount: number;\n  toolInputCharacters: number;\n  toolOutputCharacters: number;\n  assistantMessageCount: number;\n  outputCharacters: number;\n  reasoningTokens: number;\n  retryCount: number;\n  compactionCount: number;\n  budgetExceeded: boolean;\n  firstTokenLatencyMs?: number;\n  responseModel?: string;\n  stopReason: string;\n  errorMessage: string | undefined;\n  reportedLlmError: boolean;\n  finalResponseHandledByTool: boolean;\n  triggerAttribution?: string;\n}\n\nexport interface UsageReportContext {\n  session: MikanAgentSession;\n  runState: RunnerSessionState;\n  responder: ConversationResponder;\n  platform: MessagingInfo;\n  model: Model<Api>;\n  agentConfig: ReturnType<typeof resolveConversationSettings>;\n  sessionConversation: string;\n  sessionUuid: string;\n  waitForQueue: () => Promise<void>;\n}\n\nexport interface RunnerExecutionContext {\n  executor: Executor;\n  resolveForRun(context: {\n    address: OfficeAddress;\n    userId: string;\n    trustModel?: PlatformTrustModel;\n  }): Promise<{\n    pathContext: RuntimePathContext;\n    projection: WorkspaceProjection;\n  }>;\n}\n\nexport interface RunPresentation {\n  wait(): Promise<void>;\n  dispose(): void;\n}\n\nexport interface PreparedRunContext {\n  sessionConversation: string;\n  userMessage: string;\n  imageAttachments: ImageContent[];\n  triggerAttribution?: string;\n}\n\nexport type { BranchSummaryEntry, CompactionEntry, CustomEntry };\n\nexport interface SubagentModelSpec {\n  provider: string;\n  id: string;\n}\n\n/**\n * A curated capability set a subagent can be launched with. Built-ins ship\n * with the harness; `<workspaceDir>/agents/<name>.md` patches them per\n * installation. Turn, cost, and duration fields are caps — an explicit\n * `request.budget` may tighten them but never raise them. Token budgets use the\n * larger of the profile default and the request value.\n */\nexport interface SubagentProfile {\n  name: string;\n  description: string;\n  systemPrompt: string;\n  tools: string[];\n  model?: SubagentModelSpec;\n  thinkingLevel?: ThinkingLevel;\n  maxTurns?: number;\n  maxTokens?: number;\n  maxCostUsd?: number;\n  maxDurationMs?: number;\n}\n\nexport interface SubagentRunBudget {\n  /** Maximum assistant/model calls in the subagent run. */\n  maxTurns?: number;\n  /** Maximum cumulative input/output/cache tokens. */\n  maxTokens?: number;\n  /** Maximum provider cost in USD. */\n  maxCostUsd?: number;\n  /** Maximum wall-clock duration. */\n  maxDurationMs?: number;\n}\n\nexport type SubagentRunStatus =\n  | \"completed\"\n  | \"failed\"\n  | \"cancelled\"\n  | \"timeout\"\n  | \"budget_exceeded\"\n  | \"invalid_output\";\n\nexport interface SubagentParentContext {\n  mode: \"normalized\";\n  /** Number of recent user/assistant turns to include. Defaults to 3. */\n  recentTurns?: number;\n}\n\n/** Aggregated model usage across every assistant turn in a subagent run. */\nexport type SubagentUsage = Usage;\n\n/** Receives usage from a subagent run, including after detached cleanup settles. */\nexport type SubagentUsageSink = (usage: SubagentUsage) => void | Promise<void>;\n\n/** A fresh, isolated subagent run. */\nexport interface SubagentRunRequest<TOutputSchema extends TSchema | undefined = undefined> {\n  task: string;\n  /** Named profile: a harness built-in, patched by `<workspaceDir>/agents/<name>.md`. */\n  profile?: string;\n  /** Opt in to a normalized textual snapshot of the active parent run. Defaults to fresh. */\n  parentContext?: SubagentParentContext;\n  systemPrompt?: string;\n  /** JSON-serializable input appended to the task. */\n  input?: unknown;\n  /** Defaults to the parent runner's configured model. */\n  model?: SubagentModelSpec;\n  /** Tool names explicitly granted to the subagent. Defaults to no tools. */\n  tools?: string[];\n  /** Per-profile thinking override. */\n  thinkingLevel?: ThinkingLevel;\n  /** When present, the final response must be JSON matching this schema. */\n  outputSchema?: TOutputSchema;\n  budget?: SubagentRunBudget;\n  signal?: AbortSignal;\n}\n\nexport type SubagentRunOutput<TSchemaOrUndefined extends TSchema | undefined> =\n  TSchemaOrUndefined extends TSchema ? Static<TSchemaOrUndefined> : string;\n\ninterface SubagentRunMetadata {\n  runId: string;\n  /** Raw final assistant text, including when structured validation failed. */\n  text?: string;\n  model: SubagentModelSpec;\n  turns: number;\n  toolCalls: number;\n  toolCallCounts: Record<string, number>;\n  /** Full token and cost breakdown across the run. */\n  usage: SubagentUsage;\n  /** Aggregate token count; equivalent to `usage.totalTokens`. */\n  tokens: number;\n  /** Aggregate provider cost; equivalent to `usage.cost.total`. */\n  costUsd: number;\n  durationMs: number;\n  /**\n   * The caller received a terminal result before the underlying run settled.\n   * When true, `usage`, `tokens`, and `costUsd` are provisional snapshots;\n   * final usage is delivered later through the run's bound usage sink. The\n   * global slot remains held until cleanup settles because in-process work\n   * cannot be safely reclaimed without a killable execution boundary.\n   */\n  cleanupPending?: boolean;\n}\n\ninterface SubagentRunCompletedResult<TOutput> extends SubagentRunMetadata {\n  status: \"completed\";\n  output: TOutput;\n  error?: never;\n}\n\ninterface SubagentRunIncompleteResult extends SubagentRunMetadata {\n  status: Exclude<SubagentRunStatus, \"completed\">;\n  output?: never;\n  error?: string;\n}\n\nexport type SubagentRunResult<TOutput = string> =\n  | SubagentRunCompletedResult<TOutput>\n  | SubagentRunIncompleteResult;\n\nexport interface CreateMikanModelsOptions {\n  modelsJsonPath?: string;\n}\n\n/**\n * A loaded skill: Pi's native `Skill` shape plus mikan provenance.\n * `baseDir` is the directory containing the skill file.\n */\nexport interface MikanSkill extends Skill {\n  baseDir: string;\n  /** Where the skill was loaded from (e.g. \"workspace\", \"channel\"). */\n  source: string;\n  /** Embed the skill body in the prompt instead of referencing its file path. */\n  inline?: boolean;\n}\n\nexport interface SkillDiagnostic {\n  type: \"warning\";\n  message: string;\n  path: string;\n  /** Set when the entry was skipped because it is a symlink on a rejecting load. */\n  code?: \"symlink\";\n}\n\nexport interface LoadSkillsResult {\n  skills: MikanSkill[];\n  diagnostics: SkillDiagnostic[];\n}\n\nexport type RetrySettings = RetryPolicy;\n\nexport interface BudgetSettings {\n  /** Max cumulative tokens processed this run (input + output + cache read/write). */\n  maxTokens?: number;\n  /** Max cumulative provider cost (USD) this run. Requires a populated model cost table. */\n  maxCostUsd?: number;\n  /** Wall-clock deadline in milliseconds; signals cancellation and waits for active cleanup. */\n  maxDurationMs?: number;\n  /** Max number of LLM calls (assistant turns) this run. */\n  maxLlmCalls?: number;\n}\n\nexport interface HarnessSettings {\n  compaction: CompactionSettings;\n  retry: RetrySettings;\n  budget: BudgetSettings;\n}\n\nexport interface SubagentProfileDiagnostic {\n  type: \"warning\";\n  message: string;\n  path: string;\n}\n\nexport interface LoadSubagentProfilesResult {\n  profiles: Map<string, SubagentProfile>;\n  diagnostics: SubagentProfileDiagnostic[];\n}\n\nexport type CompactionReason = \"threshold\" | \"overflow\" | \"manual\";\n\ninterface CompactionResultSummary {\n  summary: string;\n  /** Number of recent messages retained inline on the compaction entry. */\n  retainedMessages: number;\n  tokensBefore: number;\n}\n\nexport type HarnessEvent =\n  | AgentEvent\n  | { type: \"compaction_start\"; reason: CompactionReason }\n  | {\n      type: \"compaction_end\";\n      reason: CompactionReason;\n      result?: CompactionResultSummary;\n      aborted: boolean;\n      errorMessage?: string;\n    }\n  | {\n      type: \"auto_retry_start\";\n      attempt: number;\n      maxAttempts: number;\n      delayMs: number;\n      errorMessage: string;\n    }\n  | { type: \"auto_retry_end\"; success: boolean; attempt: number; finalError?: string }\n  | {\n      type: \"budget_exceeded\";\n      /** Which cap was hit, e.g. \"cost 2.01 USD > 2 USD limit\". */\n      reason: string;\n      tokens: number;\n      costUsd: number;\n      llmCalls: number;\n      durationMs: number;\n    };\n\nexport type HarnessEventListener = (event: HarnessEvent) => void | Promise<void>;\n\n/**\n * A tool as the harness sees it: pi-native tools (read/write/edit/bash) and\n * mikan tools adapted at the tool-list boundary. The context carries the\n * sandbox-backed execution env.\n */\nexport type MikanHarnessTool = AgentHarnessTool<ExecutionToolContext>;\n\n/**\n * A session tool entry: a harness tool (pi-native or adapted), or a plain\n * mikan `AgentTool` that the session upgrades at the boundary. The union keeps\n * the published `MikanAgentSession` API accepting the legacy `AgentTool` shape.\n */\nexport type MikanToolInput = AgentTool | MikanHarnessTool;\n\nexport interface MikanAgentSessionOptions {\n  systemPrompt: string;\n  model: Model<Api>;\n  thinkingLevel: ThinkingLevel;\n  tools: MikanToolInput[];\n  /** Required by native execution tools; plain AgentTools need no execution env. */\n  toolContext?: ExecutionToolContext;\n  models: MikanModels;\n  sessionStore: SessionStore;\n  settings?: {\n    compaction?: Partial<CompactionSettings>;\n    retry?: Partial<RetrySettings>;\n    budget?: Partial<BudgetSettings>;\n  };\n}\n\n/**\n * MCP (Model Context Protocol) server configuration and load results.\n *\n * A server entry is either stdio (`command` + optional `args`/`env`) or\n * streamable HTTP (`url` + optional `headers`). Exactly one of `command`\n * or `url` must be set — the settings schema keeps both optional so the\n * file stays object-rooted and forgiving; `loadMcpTools` enforces the\n * exclusivity at runtime.\n *\n * Credentials (API keys in `env`/`headers`) stay in host-side settings and\n * the MCP server process; the model sees only tool names and schemas.\n */\nexport interface McpServerConfig {\n  /** stdio transport: executable to spawn on the host. */\n  command?: string;\n  args?: string[];\n  /** Extra environment for the spawned server, merged over a safe default. */\n  env?: Record<string, string>;\n  /** streamable-HTTP transport: server endpoint URL. */\n  url?: string;\n  headers?: Record<string, string>;\n  /** Disable without deleting — lets a conversation turn off a global server. */\n  disabled?: boolean;\n}\n\ntype McpPresetCredentialTarget = \"env\" | \"header\" | \"url\";\n\ninterface McpPresetCredential {\n  key: string;\n  label: string;\n  description: string;\n  target: McpPresetCredentialTarget;\n  required: boolean;\n  secret: boolean;\n  valuePrefix?: string;\n}\n\nexport interface McpPreset {\n  id: string;\n  name: string;\n  description: string;\n  category: string;\n  serverName: string;\n  sourceUrl: string;\n  setupUrl: string;\n  server: McpServerConfig;\n  credentials: McpPresetCredential[];\n}\n\nexport interface McpLoadError {\n  server: string;\n  error: string;\n}\n\nexport interface McpServerInstruction {\n  server: string;\n  text: string;\n}\n\nexport interface McpToolsResult {\n  /** Tools namespaced `mcp__<server>__<tool>`, ready for the agent tool list. */\n  tools: AgentTool<TSchema>[];\n  errors: McpLoadError[];\n  /** Admin-approved server guidance for operating its tools. */\n  instructions: McpServerInstruction[];\n  /** Close all server connections (and kill stdio child processes). */\n  dispose: () => Promise<void>;\n}\n"]}

package/dist/index.d.ts

@@ -1,12 +1,36 @@
-export { defaultCommandHandlers, dispatchCommand } from "./commands/registry.js";
-export * from "./harness/index.js";
-export type { CommandContext, CommandHandler, CommandServices } from "./commands/types.js";
-export * from "./sessions/agent-memory-file-manager.js";
-export * from "./sessions/metadata.js";
-export * from "./sessions/policy.js";
-export * from "./sessions/store.js";
-export { createConversationRuntime, type CreateSessionSandboxOptions, type RunSessionOptions, type ConversationRuntime, type ConversationRuntimeOptions, } from "./runtime/conversation-runtime.js";
-export type { MessagingBot, ConversationContext, ConversationEvent, MessagingEventHandler, ChatAdapter, ConversationMessage, ConversationResponder, ChatToolResult, ConversationKind, MessagingInfo, RunningSession, } from "./adapter.js";
+export { defaultCommandHandlers, dispatchCommand } from "./adapters/commands/registry.js";
+export type { CommandContext, CommandHandler, CommandServices } from "./adapters/commands/types.js";
+export { DEFAULT_HTTP_IDLE_TIMEOUT_MS, configureHttpDispatcher, parseHttpIdleTimeoutMs, } from "./harness/http.js";
+export { MikanModels, defaultModelsJsonPath } from "./harness/models.js";
+export { SessionStore } from "./sessions/session-store.js";
+export { findV3SessionFiles, isV3SessionFile, migrateSessionFile } from "./sessions/migrate-v3.js";
+export { MikanAgentSession } from "./harness/session.js";
+export { formatSkillsForPrompt, loadSkillsFromDir, parseFrontmatter } from "./harness/skills.js";
+export { loadSubagentProfiles } from "./harness/subagent-profiles.js";
+export { DEFAULT_BUDGET_SETTINGS, DEFAULT_EVENT_BUDGET, DEFAULT_RETRY_SETTINGS, resolveHarnessSettings, } from "./harness/session.js";
+export { buildEventPayload, EventTypeSchema, parseEventPayload } from "./events/index.js";
+export type { CreateMikanModelsOptions } from "./harness/models.js";
+export type { CompactionReason, HarnessEvent, HarnessEventListener, MikanAgentSessionOptions, } from "./harness/session.js";
+export type { LoadSkillsResult, MikanSkill, SkillDiagnostic } from "./harness/skills.js";
+export type { LoadSubagentProfilesResult, SubagentProfileDiagnostic, } from "./harness/subagent-profiles.js";
+export type { BudgetSettings, CompactionSettings, HarnessSettings, RetrySettings, } from "./harness/session.js";
+export type { EventConversationKind, EventFilePayload, EventPayloadInput, EventType, ImmediateEventPayload, OneShotEventPayload, PeriodicEventPayload, } from "./events/index.js";
+export type { BranchSummaryEntry, CompactionEntry, CustomEntry, SubagentModelSpec, SubagentParentContext, SubagentProfile, SubagentRunBudget, SubagentRunOutput, SubagentRunRequest, SubagentRunResult, SubagentRunStatus, SubagentUsage, SubagentUsageSink, } from "./harness/types.js";
+export type { SessionContext, SessionEntry, SessionHeader, SessionMessageEntry, } from "./sessions/types.js";
+export { CURRENT_SESSION_VERSION } from "./sessions/types.js";
+export { ChatHistorySync, hasMaterializedChatSession, registerThreadSession, waitForThreadSessionBootstrap, } from "./sessions/chat-history-sync.js";
+export type { ChatHistorySyncOptions, ChatSyncReport, HasMaterializedSessionOptions, RegisterThreadSessionOptions, ResetChatSessionOptions, ResolveChatSessionScopeOptions, SyncChatSessionOptions, ThreadBootstrapWaitOptions, } from "./sessions/chat-history-sync.js";
+export { isPlatformHistorySession } from "./sessions/store.js";
+export type { MikanSessionHeader } from "./sessions/store.js";
+export { inferConversationKind, resolveChatSessionKey } from "./sessions/session-key.js";
+export type { ResolveSessionKeyOptions } from "./sessions/session-key.js";
+export { createManagedSessionFile, createManagedSessionFileAtPath, createNewSessionFile, extractSessionSuffix, extractSessionUuid, getThreadSessionFile, openManagedSession, resolveChannelSessionFile, resolveManagedSessionFile, resolveSessionFile, tryResolveCurrentSession, tryResolveThreadSession, } from "./sessions/store.js";
+export type { ResolvedSessionScope, ThreadRootMessage } from "./sessions/store.js";
+export { createConversationRuntime, type ConversationRuntime, type ConversationRuntimeOptions, type RunSessionOptions, } from "./runtime/conversation-runtime.js";
+export { createConversationEvent, createConversationMessage } from "./adapters/index.js";
+export { createOfficeAddress, createWorkspace, officeKey, officeSessionsDir, } from "./office/index.js";
+export type { Office, Workspace } from "./office/index.js";
+export type { ChatToolResult, ConversationContext, ConversationEvent, ConversationKind, ConversationMessage, ConversationResponder, HandleNewCommandOptions, MessagingBot, OfficeAddress, OfficeKey, MessagingEventHandler, MessagingInfo, PlatformName, RunningSession, } from "./adapters/index.js";
 export { SandboxError, createExecutor, getSandboxAdapters, parseSandboxArg, validateSandbox, } from "./sandbox/index.js";
 export type { CloudflareSandboxConfig, ExecOptions, ExecResult, Executor, SandboxAdapter, SandboxConfig, } from "./sandbox/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjF,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3F,cAAc,yCAAyC,CAAC;AACxD,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,yBAAyB,EACzB,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,WAAW,EACX,UAAU,EACV,QAAQ,EACR,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,9 +1,22 @@
-export { defaultCommandHandlers, dispatchCommand } from "./commands/registry.js";
-export * from "./harness/index.js";
-export * from "./sessions/agent-memory-file-manager.js";
-export * from "./sessions/metadata.js";
-export * from "./sessions/policy.js";
-export * from "./sessions/store.js";
+export { defaultCommandHandlers, dispatchCommand } from "./adapters/commands/registry.js";
+// Public harness interface. Keep this list explicit: adding an internal harness
+// helper must not silently expand the npm package interface.
+export { DEFAULT_HTTP_IDLE_TIMEOUT_MS, configureHttpDispatcher, parseHttpIdleTimeoutMs, } from "./harness/http.js";
+export { MikanModels, defaultModelsJsonPath } from "./harness/models.js";
+export { SessionStore } from "./sessions/session-store.js";
+export { findV3SessionFiles, isV3SessionFile, migrateSessionFile } from "./sessions/migrate-v3.js";
+export { MikanAgentSession } from "./harness/session.js";
+export { formatSkillsForPrompt, loadSkillsFromDir, parseFrontmatter } from "./harness/skills.js";
+export { loadSubagentProfiles } from "./harness/subagent-profiles.js";
+export { DEFAULT_BUDGET_SETTINGS, DEFAULT_EVENT_BUDGET, DEFAULT_RETRY_SETTINGS, resolveHarnessSettings, } from "./harness/session.js";
+export { buildEventPayload, EventTypeSchema, parseEventPayload } from "./events/index.js";
+export { CURRENT_SESSION_VERSION } from "./sessions/types.js";
+export { ChatHistorySync, hasMaterializedChatSession, registerThreadSession, waitForThreadSessionBootstrap, } from "./sessions/chat-history-sync.js";
+export { isPlatformHistorySession } from "./sessions/store.js";
+export { inferConversationKind, resolveChatSessionKey } from "./sessions/session-key.js";
+export { createManagedSessionFile, createManagedSessionFileAtPath, createNewSessionFile, extractSessionSuffix, extractSessionUuid, getThreadSessionFile, openManagedSession, resolveChannelSessionFile, resolveManagedSessionFile, resolveSessionFile, tryResolveCurrentSession, tryResolveThreadSession, } from "./sessions/store.js";
 export { createConversationRuntime, } from "./runtime/conversation-runtime.js";
+export { createConversationEvent, createConversationMessage } from "./adapters/index.js";
+export { createOfficeAddress, createWorkspace, officeKey, officeSessionsDir, } from "./office/index.js";
 export { SandboxError, createExecutor, getSandboxAdapters, parseSandboxArg, validateSandbox, } from "./sandbox/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjF,cAAc,oBAAoB,CAAC;AAEnC,cAAc,yCAAyC,CAAC;AACxD,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,yBAAyB,GAK1B,MAAM,mCAAmC,CAAC;AAc3C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC","sourcesContent":["export { defaultCommandHandlers, dispatchCommand } from \"./commands/registry.js\";\nexport * from \"./harness/index.js\";\nexport type { CommandContext, CommandHandler, CommandServices } from \"./commands/types.js\";\nexport * from \"./sessions/agent-memory-file-manager.js\";\nexport * from \"./sessions/metadata.js\";\nexport * from \"./sessions/policy.js\";\nexport * from \"./sessions/store.js\";\nexport {\n  createConversationRuntime,\n  type CreateSessionSandboxOptions,\n  type RunSessionOptions,\n  type ConversationRuntime,\n  type ConversationRuntimeOptions,\n} from \"./runtime/conversation-runtime.js\";\nexport type {\n  MessagingBot,\n  ConversationContext,\n  ConversationEvent,\n  MessagingEventHandler,\n  ChatAdapter,\n  ConversationMessage,\n  ConversationResponder,\n  ChatToolResult,\n  ConversationKind,\n  MessagingInfo,\n  RunningSession,\n} from \"./adapter.js\";\nexport {\n  SandboxError,\n  createExecutor,\n  getSandboxAdapters,\n  parseSandboxArg,\n  validateSandbox,\n} from \"./sandbox/index.js\";\nexport type {\n  CloudflareSandboxConfig,\n  ExecOptions,\n  ExecResult,\n  Executor,\n  SandboxAdapter,\n  SandboxConfig,\n} from \"./sandbox/index.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAG1F,gFAAgF;AAChF,6DAA6D;AAC7D,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAiD1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AAWzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEzF,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,yBAAyB,GAI1B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAkB3B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC","sourcesContent":["export { defaultCommandHandlers, dispatchCommand } from \"./adapters/commands/registry.js\";\nexport type { CommandContext, CommandHandler, CommandServices } from \"./adapters/commands/types.js\";\n\n// Public harness interface. Keep this list explicit: adding an internal harness\n// helper must not silently expand the npm package interface.\nexport {\n  DEFAULT_HTTP_IDLE_TIMEOUT_MS,\n  configureHttpDispatcher,\n  parseHttpIdleTimeoutMs,\n} from \"./harness/http.js\";\nexport { MikanModels, defaultModelsJsonPath } from \"./harness/models.js\";\nexport { SessionStore } from \"./sessions/session-store.js\";\nexport { findV3SessionFiles, isV3SessionFile, migrateSessionFile } from \"./sessions/migrate-v3.js\";\nexport { MikanAgentSession } from \"./harness/session.js\";\nexport { formatSkillsForPrompt, loadSkillsFromDir, parseFrontmatter } from \"./harness/skills.js\";\nexport { loadSubagentProfiles } from \"./harness/subagent-profiles.js\";\nexport {\n  DEFAULT_BUDGET_SETTINGS,\n  DEFAULT_EVENT_BUDGET,\n  DEFAULT_RETRY_SETTINGS,\n  resolveHarnessSettings,\n} from \"./harness/session.js\";\nexport { buildEventPayload, EventTypeSchema, parseEventPayload } from \"./events/index.js\";\nexport type { CreateMikanModelsOptions } from \"./harness/models.js\";\nexport type {\n  CompactionReason,\n  HarnessEvent,\n  HarnessEventListener,\n  MikanAgentSessionOptions,\n} from \"./harness/session.js\";\nexport type { LoadSkillsResult, MikanSkill, SkillDiagnostic } from \"./harness/skills.js\";\nexport type {\n  LoadSubagentProfilesResult,\n  SubagentProfileDiagnostic,\n} from \"./harness/subagent-profiles.js\";\nexport type {\n  BudgetSettings,\n  CompactionSettings,\n  HarnessSettings,\n  RetrySettings,\n} from \"./harness/session.js\";\nexport type {\n  EventConversationKind,\n  EventFilePayload,\n  EventPayloadInput,\n  EventType,\n  ImmediateEventPayload,\n  OneShotEventPayload,\n  PeriodicEventPayload,\n} from \"./events/index.js\";\nexport type {\n  BranchSummaryEntry,\n  CompactionEntry,\n  CustomEntry,\n  SubagentModelSpec,\n  SubagentParentContext,\n  SubagentProfile,\n  SubagentRunBudget,\n  SubagentRunOutput,\n  SubagentRunRequest,\n  SubagentRunResult,\n  SubagentRunStatus,\n  SubagentUsage,\n  SubagentUsageSink,\n} from \"./harness/types.js\";\nexport type {\n  SessionContext,\n  SessionEntry,\n  SessionHeader,\n  SessionMessageEntry,\n} from \"./sessions/types.js\";\nexport { CURRENT_SESSION_VERSION } from \"./sessions/types.js\";\n\nexport {\n  ChatHistorySync,\n  hasMaterializedChatSession,\n  registerThreadSession,\n  waitForThreadSessionBootstrap,\n} from \"./sessions/chat-history-sync.js\";\nexport type {\n  ChatHistorySyncOptions,\n  ChatSyncReport,\n  HasMaterializedSessionOptions,\n  RegisterThreadSessionOptions,\n  ResetChatSessionOptions,\n  ResolveChatSessionScopeOptions,\n  SyncChatSessionOptions,\n  ThreadBootstrapWaitOptions,\n} from \"./sessions/chat-history-sync.js\";\nexport { isPlatformHistorySession } from \"./sessions/store.js\";\nexport type { MikanSessionHeader } from \"./sessions/store.js\";\nexport { inferConversationKind, resolveChatSessionKey } from \"./sessions/session-key.js\";\nexport type { ResolveSessionKeyOptions } from \"./sessions/session-key.js\";\nexport {\n  createManagedSessionFile,\n  createManagedSessionFileAtPath,\n  createNewSessionFile,\n  extractSessionSuffix,\n  extractSessionUuid,\n  getThreadSessionFile,\n  openManagedSession,\n  resolveChannelSessionFile,\n  resolveManagedSessionFile,\n  resolveSessionFile,\n  tryResolveCurrentSession,\n  tryResolveThreadSession,\n} from \"./sessions/store.js\";\nexport type { ResolvedSessionScope, ThreadRootMessage } from \"./sessions/store.js\";\nexport {\n  createConversationRuntime,\n  type ConversationRuntime,\n  type ConversationRuntimeOptions,\n  type RunSessionOptions,\n} from \"./runtime/conversation-runtime.js\";\nexport { createConversationEvent, createConversationMessage } from \"./adapters/index.js\";\nexport {\n  createOfficeAddress,\n  createWorkspace,\n  officeKey,\n  officeSessionsDir,\n} from \"./office/index.js\";\nexport type { Office, Workspace } from \"./office/index.js\";\nexport type {\n  ChatToolResult,\n  ConversationContext,\n  ConversationEvent,\n  ConversationKind,\n  ConversationMessage,\n  ConversationResponder,\n  HandleNewCommandOptions,\n  MessagingBot,\n  OfficeAddress,\n  OfficeKey,\n  MessagingEventHandler,\n  MessagingInfo,\n  PlatformName,\n  RunningSession,\n} from \"./adapters/index.js\";\nexport {\n  SandboxError,\n  createExecutor,\n  getSandboxAdapters,\n  parseSandboxArg,\n  validateSandbox,\n} from \"./sandbox/index.js\";\nexport type {\n  CloudflareSandboxConfig,\n  ExecOptions,\n  ExecResult,\n  Executor,\n  SandboxAdapter,\n  SandboxConfig,\n} from \"./sandbox/index.js\";\n"]}

package/dist/log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8B7C,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAElE;AAGD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAWN;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,IAAI,CAYN;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,IAAI,CAUN;AAGD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAON;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAEtD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQnE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ/D;AAGD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CASlE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQ7E;AAUD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE;IACL,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/F,EACD,aAAa,CAAC,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAiCR;AAGD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIpE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGnD;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAGD,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAElF;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAOnF"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8B7C,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAElE;AAGD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAWN;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,IAAI,CAYN;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,IAAI,CAUN;AAGD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAON;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAEtD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQnE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ/D;AAGD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CASlE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQ7E;AAUD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE;IACL,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/F,EACD,aAAa,CAAC,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAoCR;AAGD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIpE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGnD;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAGD,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAElF;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAOnF"}

package/dist/log.js

@@ -142,7 +142,10 @@ export function logUsageSummary(ctx, usage, contextTokens, contextWindow) {
     lines.push(`Cost: ` + costParts.join(" + ") + ` = *\$${usage.cost.total.toFixed(4)}*`);
     const summary = lines.join("\n");
     console.log(chalk.yellow(`${timestamp()} ${formatContext(ctx)} 💰 Usage`));
-    console.log(chalk.dim(`           in ${usage.input.toLocaleString()} → out ${usage.output.toLocaleString()} = $${usage.cost.total.toFixed(4)}`));
+    // Show cache hits alongside fresh input; otherwise a warm-cache turn reads
+    // as if the system prompt had not been sent at all.
+    const cached = usage.cacheRead > 0 ? ` (+${usage.cacheRead.toLocaleString()} cached)` : "";
+    console.log(chalk.dim(`           in ${usage.input.toLocaleString()}${cached} → out ${usage.output.toLocaleString()} = $${usage.cost.total.toFixed(4)}`));
     return summary;
 }
 // Startup (no context needed)