@mu-agent/mu 0.0.1 → 0.0.3

package/dist/types/ai/index.d.ts

@@ -19,4 +19,5 @@ export { iterateSse } from "./sse.js";
 export { AssistantStream, EventStream } from "./stream.js";
 export type { Cassette, RecordedInteraction, ReplayCall, ReplayHandle } from "./testing/replay.js";
 export { recordFetch, replayFetch } from "./testing/replay.js";
+export { defaultThinkingLevel, supportedThinkingLevels, thinkingLevelForModel, } from "./thinking.js";
 export * from "./types.js";

package/dist/types/ai/thinking.d.ts

@@ -0,0 +1,4 @@
+import type { ModelInfo, ThinkingLevel } from "./types.js";
+export declare function supportedThinkingLevels(model: ModelInfo): ThinkingLevel[];
+export declare function defaultThinkingLevel(model: ModelInfo): ThinkingLevel;
+export declare function thinkingLevelForModel(model: ModelInfo, requested: ThinkingLevel | undefined): ThinkingLevel;

package/dist/types/ai/types.d.ts

@@ -89,10 +89,12 @@ export interface ModelInfo {
     maxOutput: number;
     modalities: ("text" | "image")[];
     thinking?: boolean;
+    thinkingLevels?: ThinkingLevel[];
+    defaultThinkingLevel?: ThinkingLevel;
     thinkingMode?: "adaptive" | "budget";
     pricing: ModelPricing;
 }
-export type ThinkingLevel = "off" | "low" | "medium" | "high";
+export type ThinkingLevel = "off" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | "ultra" | (string & {});
 export type Credential = {
     type: "apiKey";
     apiKey: string;

package/dist/types/core/compaction.d.ts

@@ -14,6 +14,12 @@ export interface CompactionRequest {
     keepFromIndex: number;
     carryover?: unknown;
 }
+export interface CompactionPlan {
+    keepFromIndex: number;
+    keptTokens: number;
+    isSplitTurn: boolean;
+    turnStartIndex: number | null;
+}
 export interface CompactionResult {
     summary: string;
     carryover?: unknown;
@@ -26,15 +32,16 @@ export declare class CompactionError extends Error {
     readonly usage?: Usage | undefined;
     constructor(message: string, usage?: Usage | undefined);
 }
-export declare function planCompaction(messages: AgentMessage[], keepRatio?: number): {
-    keepFromIndex: number;
-};
+export declare const DEFAULT_KEEP_RECENT_TOKENS = 20000;
+export declare function planCompaction(messages: AgentMessage[], keepRecentTokens?: number): CompactionPlan;
 export declare const SUMMARY_PROMPT = "Summarize the conversation so far so that work can continue without the original transcript.\n\nPreserve, in this order:\n1. What the user asked for \u2014 the goal, in their terms, including any constraints they stated.\n2. Decisions taken and why, including approaches tried and rejected.\n3. Current task state: what is done, what is in progress, what remains.\n4. Concrete facts discovered that would be expensive to rediscover (file locations, API shapes, error messages, command invocations that work).\n5. Anything the user corrected you on.\n\nBe specific and factual. Do not include pleasantries or narration. This summary replaces the transcript, so anything you omit is lost.";
+export declare function serializeCompactionMessages(messages: AgentMessage[]): string;
 export interface CompactorOptions {
     provider: Provider;
     model: ModelInfo;
     carryoverExtractor?: (messages: AgentMessage[]) => unknown;
-    keepRatio?: number;
+    keepRecentTokens?: number;
+    customInstructions?: string;
     signal?: AbortSignal;
     streamOpts?: StreamOpts;
 }

package/dist/types/core/events.d.ts

@@ -34,6 +34,8 @@ export type StreamDelta = {
     toolCallId: string;
 };
 export type AgentEndReason = "done" | "aborted" | "budget" | "maxTurns" | "error";
+export type CompactionTrigger = "manual" | "threshold" | "overflow" | "model-change";
+export type CompactionStage = "clearing-tool-output" | "summarizing" | "installing";
 export type AgentEvent = {
     type: "agent_start";
 } | {
@@ -80,11 +82,25 @@ export type AgentEvent = {
 } | {
     type: "compaction_start";
     layer: 1 | 2 | 3;
+    trigger?: CompactionTrigger;
+    contextTokensBefore?: number;
+} | {
+    type: "compaction_update";
+    layer: 1 | 2 | 3;
+    stage: CompactionStage;
+    toolResultsCleared?: number;
 } | {
     type: "compaction_end";
     layer: 1 | 2 | 3;
     tokensFreed: number;
     summaryEntryId?: string;
+    trigger?: CompactionTrigger;
+    status?: "completed" | "failed" | "cancelled" | "noop";
+    contextTokensBefore?: number;
+    contextTokensAfter?: number;
+    toolResultsCleared?: number;
+    keptTokens?: number;
+    errorMessage?: string;
 } | {
     type: "task_started";
     taskId: string;

package/dist/types/core/index.d.ts

@@ -2,9 +2,9 @@ export type { CheckpointDiffFile, CheckpointEntry, CheckpointProvider, } from ".
 export { CheckpointHistory } from "./checkpoint.js";
 export type { Command, CommandContext, CommandResult } from "./commands.js";
 export { CommandRegistry } from "./commands.js";
-export type { CompactionRequest, CompactionResult, CompactorOptions, ContextState, } from "./compaction.js";
-export { AUTO_COMPACT_THRESHOLD, applyCompaction, CompactionError, compact, compactionSummaryMessage, contextState, estimateTokens, formatCarryover, planCompaction, SUMMARY_PROMPT, shouldCompact, } from "./compaction.js";
-export type { AgentEndReason, AgentEvent, AgentEventType, EventSink, StreamDelta, } from "./events.js";
+export type { CompactionPlan, CompactionRequest, CompactionResult, CompactorOptions, ContextState, } from "./compaction.js";
+export { AUTO_COMPACT_THRESHOLD, applyCompaction, CompactionError, compact, compactionSummaryMessage, contextState, DEFAULT_KEEP_RECENT_TOKENS, estimateTokens, formatCarryover, planCompaction, SUMMARY_PROMPT, serializeCompactionMessages, shouldCompact, } from "./compaction.js";
+export type { AgentEndReason, AgentEvent, AgentEventType, CompactionStage, CompactionTrigger, EventSink, StreamDelta, } from "./events.js";
 export type { Extension, ExtensionAPI, ExtensionEvent, ExtensionEventFor, ExtensionEventType, InputDirective, LifecycleEvent, LifecycleNotification, ToolCallDirective, ToolCallHookInfo, ToolRenderer, ToolResultDirective, ToolResultHookInfo, } from "./extensions.js";
 export { ExtensionHost } from "./extensions.js";
 export type { AfterToolCallInfo, AgentContext, AgentRunResult, BeforeToolCallInfo, ContextPreparation, LoopConfig, NextTurnDirective, TurnInfo, } from "./loop.js";
@@ -18,7 +18,7 @@ export type { PermissionAction, PermissionPreview, PermissionRequest, Permission
 export { evaluate } from "./permission.js";
 export type { ManagedProcessHandle, ProcessEvents, Spawner, SpawnRequest, TaskInfo, TaskStatus, } from "./process.js";
 export { exitNotification, OutputBuffer, ProcessManager } from "./process.js";
-export type { PermissionMode, Profile, ProfileFactory, ProfileRuntime, ProfileRuntimeHost, } from "./profile.js";
+export type { PermissionMode, PermissionModeTone, Profile, ProfileFactory, ProfileRuntime, ProfileRuntimeHost, } from "./profile.js";
 export type { RecoveryAttempt } from "./recovery.js";
 export { isContextTooLongError, isContextTooLongResult, withContextRecovery, } from "./recovery.js";
 export type { NewTreeEntry, SessionEntry, SessionStore, TreeEntry } from "./session.js";

package/dist/types/core/permission.d.ts

@@ -9,6 +9,7 @@ export interface PermissionRequest {
     id: string;
     toolCallId: string;
     toolName: string;
+    permission: string;
     pattern: string;
     description: string;
     preview?: PermissionPreview;
@@ -24,4 +25,4 @@ export interface ToolPermissionDetails {
     description?: string;
     preview?: PermissionPreview;
 }
-export declare function evaluate(rules: PermissionRule[], permission: string, pattern: string): PermissionAction;
+export declare function evaluate(rules: PermissionRule[], permission: string | readonly string[], pattern: string): PermissionAction;

package/dist/types/core/profile.d.ts

@@ -6,10 +6,12 @@ import type { ToolRenderer } from "./extensions.js";
 import type { AgentMessage } from "./messages.js";
 import type { PermissionRule } from "./permission.js";
 import type { AnyTool } from "./tools.js";
+export type PermissionModeTone = "restrictive" | "permissive" | "unrestricted";
 export interface PermissionMode {
     id: string;
     label: string;
     description: string;
+    tone?: PermissionModeTone;
     rules: PermissionRule[];
 }
 export interface ProfileRuntimeHost {

package/dist/types/core/session.d.ts

@@ -1,4 +1,4 @@
-import type { AgentMessage } from "./messages.js";
+import type { AgentMessage, Usage } from "./messages.js";
 export declare const SESSION_VERSION = 1;
 export type SessionEntry = {
     type: "session";
@@ -21,6 +21,16 @@ export type SessionEntry = {
     carryover?: unknown;
     firstKeptEntryId: string | null;
     timestamp?: number;
+    trigger?: "manual" | "threshold" | "overflow" | "model-change";
+    contextTokensBefore?: number;
+    contextTokensAfter?: number;
+    model?: string;
+    compactorModel?: string;
+    windowNumber?: number;
+    strategy?: "summary-tail";
+    keptTokens?: number;
+    toolResultsCleared?: number;
+    usage?: Usage;
 } | {
     type: "microcompaction";
     id: string;

package/dist/types/core/tools.d.ts

@@ -13,6 +13,8 @@ export interface Tool<Args = Record<string, unknown>> {
     isConcurrencySafe?: (args: Args) => boolean;
     executionMode?: "sequential";
     changesState?: boolean | ((args: Args) => boolean);
+    permissionScope?: (args: Args) => string;
+    permissionPattern?: (args: Args) => string;
     permissionDetails?: (args: Args) => ToolPermissionDetails | undefined | Promise<ToolPermissionDetails | undefined>;
     execute: (toolCallId: string, args: Args, signal: AbortSignal, onUpdate?: (partial: ToolResultContent[]) => void) => Promise<ToolResult>;
 }

package/dist/types/profile-coding/checkpoint.d.ts

@@ -22,6 +22,8 @@ export declare class ShadowCheckpointProvider implements CheckpointProvider {
     private env;
     private git;
     private ensure;
+    private ignoredDisposableDirectories;
+    private checkpointPathspecs;
     snapshot(label?: string): Promise<string | undefined>;
     restore(ref: string): Promise<void>;
     restoreResources(ref: string, resources: string[]): Promise<void>;

package/dist/types/profile-coding/index.d.ts

@@ -25,6 +25,7 @@ export { codingEnvironment, contextMessages, DEFAULT_INSTRUCTION_FALLBACKS, DEFA
 export { CODING_PERMISSION_DEFAULTS, CODING_PERMISSION_MODES, layerPermissions, loadProjectConfig, rememberAllow, } from "./permissions.js";
 export { codingPrompt } from "./prompts.js";
 export { shellCommand, terminateProcessTree, windowsTaskkillCommand } from "./shell.js";
+export { classifyShellCommand, isInspectionShellCommand, parseInspectionCommands, type ShellCommandClassification, } from "./shell-inspection.js";
 export { FileState } from "./state.js";
 export { bashTool } from "./tools/bash.js";
 export { editTool, lsTool, readTool, resolveInRoot, writeTool } from "./tools/files.js";

package/dist/types/profile-coding/shell-inspection.d.ts

@@ -0,0 +1,4 @@
+export type ShellCommandClassification = "inspect" | "other";
+export declare function parseInspectionCommands(source: string): string[][] | undefined;
+export declare function classifyShellCommand(command: string): ShellCommandClassification;
+export declare function isInspectionShellCommand(command: string): boolean;

package/dist/types/profile-coding/tools/files.d.ts

@@ -21,11 +21,14 @@ export declare function writeTool(deps: ToolDeps): import("../../sdk/index.js").
     path: string;
     content: string;
 }>;
+export declare function coerceEditInput(raw: unknown): unknown;
 export declare function editTool(deps: ToolDeps): import("../../sdk/index.js").Tool<{
     path: string;
-    oldString: string;
-    newString: string;
-    replaceAll?: boolean | undefined;
+    edits: {
+        oldString: string;
+        newString: string;
+        replaceAll?: boolean | undefined;
+    }[];
 }>;
 export declare function lsTool(deps: ToolDeps): import("../../sdk/index.js").Tool<{
     path?: string | undefined;

package/dist/types/sdk/agent.d.ts

@@ -46,6 +46,15 @@ export interface CheckpointActionResult {
     message: string;
     data?: CheckpointActionData;
 }
+export interface ManualCompactionResult {
+    status: "completed" | "queued" | "failed" | "cancelled" | "noop";
+    message: string;
+    tokensBefore?: number;
+    tokensAfter?: number;
+    tokensFreed?: number;
+    toolResultsCleared?: number;
+    summaryEntryId?: string;
+}
 export interface AgentRunOptions<T = unknown> {
     output?: z.ZodType<T>;
     model?: string | ModelInfo;
@@ -63,7 +72,13 @@ export declare class Agent {
     private followUps;
     private totals;
     private compactRequested;
+    private compactRequestedFocus;
+    private queuedManualCompactionFocus;
+    private manualCompactionQueued;
+    private compacting;
+    private compactorOverride;
     private lastContextPercent;
+    private lastContextTokens;
     private lastContextUsage;
     private readonly checkpoints;
     private recoveryAttempted;
@@ -88,7 +103,9 @@ export declare class Agent {
     get modelRef(): string;
     get contextWindow(): number;
     get thinking(): ThinkingLevel;
+    get thinkingLevels(): ThinkingLevel[];
     get isRunning(): boolean;
+    get isCompacting(): boolean;
     get permissions(): PermissionRule[];
     setPermissions(rules: PermissionRule[]): void;
     addPermissionRule(rule: PermissionRule): void;
@@ -106,7 +123,9 @@ export declare class Agent {
     stop(): void;
     shutdown(): Promise<void>;
     abort(): void;
-    requestCompaction(): void;
+    requestCompaction(focus?: string): void;
+    compactNow(focus?: string): Promise<ManualCompactionResult>;
+    private executeManualCompaction;
     get checkpointHistory(): CheckpointHistory;
     undo(): Promise<CheckpointActionResult>;
     redo(): Promise<CheckpointActionResult>;
@@ -120,6 +139,7 @@ export declare class Agent {
         message: string;
     }>;
     get contextPercent(): number;
+    get contextTokens(): number;
     run<T>(prompt: string | UserContent[], opts: AgentRunOptions<T> & {
         output: z.ZodType<T>;
     }): Promise<RunResult & {
@@ -138,7 +158,10 @@ export declare class Agent {
     private execute;
     private executeRun;
     private providerFor;
+    private publishEvent;
+    private refreshContextAccounting;
     private publishToSubscribers;
     private scheduleAutonomousRun;
+    private scheduleManualCompaction;
     private resolveIdleIfDone;
 }

package/dist/types/sdk/commands.d.ts

@@ -1,6 +1,6 @@
 import { type Usage } from "../ai/index.js";
 import { type CheckpointDiffFile, type Command, CommandRegistry } from "../core/index.js";
-import type { CheckpointActionResult } from "./agent.js";
+import type { CheckpointActionResult, ManualCompactionResult } from "./agent.js";
 export interface ForkPoint {
     id: string;
     description: string;
@@ -10,7 +10,7 @@ export interface DiffCommandData {
     files: CheckpointDiffFile[];
 }
 export interface CoreCommandHooks {
-    requestCompaction?: () => void;
+    requestCompaction?: (focus?: string) => ManualCompactionResult | undefined | Promise<ManualCompactionResult | undefined>;
     usage?: () => Usage & {
         contextPercent: number;
     };

package/dist/types/sdk/index.d.ts

@@ -1,8 +1,8 @@
 export type { Credential, ModelDiscoveryOptions, ModelInfo, Provider, ProviderModelDiscoveryOptions, ThinkingLevel, Usage, } from "../ai/index.js";
-export { builtinProviderConfigs, defaultModelRef, discoverModels, findModel, listModels, providerHasCredentials, refreshModels, registerModels, registerProvider, } from "../ai/index.js";
-export type { AgentEvent, AgentMessage, AnyTool, Command, CommandContext, CommandResult, CustomMessage, Extension, ExtensionAPI, ExtensionEvent, ExtensionEventFor, ExtensionEventType, LifecycleEvent, LifecycleNotification, PermissionMode, PermissionRequest, PermissionRule, ProfileRuntime, ProfileRuntimeHost, SessionStore, StreamDelta, Tool, ToolRenderer, UserContent, } from "../core/index.js";
+export { builtinProviderConfigs, defaultModelRef, defaultThinkingLevel, discoverModels, findModel, listModels, providerHasCredentials, refreshModels, registerModels, registerProvider, supportedThinkingLevels, thinkingLevelForModel, } from "../ai/index.js";
+export type { AgentEvent, AgentMessage, AnyTool, Command, CommandContext, CommandResult, CustomMessage, Extension, ExtensionAPI, ExtensionEvent, ExtensionEventFor, ExtensionEventType, LifecycleEvent, LifecycleNotification, PermissionMode, PermissionModeTone, PermissionRequest, PermissionRule, ProfileRuntime, ProfileRuntimeHost, SessionStore, StreamDelta, Tool, ToolRenderer, UserContent, } from "../core/index.js";
 export { CommandRegistry, customMessage, ExtensionHost, errorResult, MemorySessionStore, SessionTree, textResult, userMessage, } from "../core/index.js";
-export type { AgentOptions, AgentRunOptions, CheckpointActionData, CheckpointActionResult, HaltReason, RunResult, } from "./agent.js";
+export type { AgentOptions, AgentRunOptions, CheckpointActionData, CheckpointActionResult, HaltReason, ManualCompactionResult, RunResult, } from "./agent.js";
 export { Agent } from "./agent.js";
 export type { AuthFile, AuthStoreOptions, OpenAiCallbackServer, OpenAiLoginOptions, OpenAiLoginResult, PlanLoginCallbackServer, PlanLoginOptions, PlanLoginResult, StoredApiKey, StoredCredential, StoredOpenAiOAuth, StoredPlanOAuth, } from "./auth.js";
 export { createCredentialResolver, defaultAuthFile, loginGitHubCopilot, loginKimiCoding, loginOpenAI, loginOpenRouter, loginXai, preferredAuthProvider, readAuthFile, removeStoredCredential, saveApiKey, storedAuthProviders, } from "./auth.js";
@@ -29,3 +29,5 @@ export { defaultSkillRoots, discoverSkills, loadSkill, skillListing, skillsExten
 export { STRUCTURED_OUTPUT_TOOL, structuredOutputPrompt, structuredOutputTool, } from "./structured-output.js";
 export type { ToolDefinition, ToolResult } from "./tool.js";
 export { tool } from "./tool.js";
+export type { MarkdownTranscript, TranscriptMarkdownOptions, } from "./transcript-markdown.js";
+export { sessionToMarkdown } from "./transcript-markdown.js";

package/dist/types/sdk/tool.d.ts

@@ -5,9 +5,12 @@ export interface ToolDefinition<Schema extends z.ZodType> {
     name: string;
     description: string;
     inputSchema: Schema;
+    coerceInput?: (raw: unknown) => unknown;
     isConcurrencySafe?: (args: z.infer<Schema>) => boolean;
     executionMode?: "sequential";
     changesState?: boolean | ((args: z.infer<Schema>) => boolean);
+    permissionScope?: (args: z.infer<Schema>) => string;
+    permissionPattern?: (args: z.infer<Schema>) => string;
     permissionDetails?: (args: z.infer<Schema>) => ToolPermissionDetails | undefined | Promise<ToolPermissionDetails | undefined>;
     execute: (args: z.infer<Schema>, ctx: {
         toolCallId: string;

package/dist/types/sdk/transcript-markdown.d.ts

@@ -0,0 +1,11 @@
+import type { SessionTree } from "../core/index.js";
+export interface TranscriptMarkdownOptions {
+    sessionId?: string;
+    model?: string;
+    exportedAt?: Date;
+}
+export interface MarkdownTranscript {
+    markdown: string;
+    messageCount: number;
+}
+export declare function sessionToMarkdown(session: SessionTree, options?: TranscriptMarkdownOptions): MarkdownTranscript;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mu-agent/mu",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Mu, a general-purpose extensible AI agent platform for the terminal and TypeScript",
   "type": "module",
   "main": "./dist/index.js",
@@ -64,9 +64,9 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@mu/profile-coding": "0.0.1",
-    "@mu/tui": "0.0.1",
-    "mu": "0.0.1",
-    "@mu/core": "0.0.1"
+    "@mu/profile-coding": "workspace:*",
+    "@mu/tui": "workspace:*",
+    "mu": "workspace:*",
+    "@mu/core": "workspace:*"
   }
 }

package/dist/types/ai/providers/radius.d.ts

@@ -1,5 +0,0 @@
-import type { AssistantStream } from "../stream.js";
-import type { LlmContext, ModelInfo, Provider, ProviderModelDiscoveryOptions, StreamOpts } from "../types.js";
-export declare function discoverRadiusModels(options: ProviderModelDiscoveryOptions): Promise<ModelInfo[] | undefined>;
-export declare function streamRadius(model: ModelInfo, context: LlmContext, opts?: StreamOpts): AssistantStream;
-export declare const radius: Provider;