@mu-agent/mu 0.0.9 → 0.1.0

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

@@ -52,6 +52,7 @@ export interface ToolResultMessage {
     toolName: string;
     content: ToolResultContent[];
     details?: unknown;
+    usage?: Usage;
     isError: boolean;
     evicted?: boolean;
     timestamp: number;

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

@@ -14,6 +14,7 @@ export interface CommandResult {
 export interface Command {
     name: string;
     description: string;
+    sessionScoped?: boolean;
     run: (ctx: CommandContext) => CommandResult | void | Promise<CommandResult | void>;
 }
 export declare class CommandRegistry {

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

@@ -67,6 +67,7 @@ export type AgentEvent = {
     type: "tool_execution_update";
     toolCallId: string;
     partial: ToolResultContent[];
+    details?: unknown;
 } | {
     type: "tool_execution_end";
     toolCallId: string;

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

@@ -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, PermissionModeTone, Profile, ProfileFactory, ProfileRuntime, ProfileRuntimeHost, } from "./profile.js";
+export type { PermissionMode, PermissionModeTone, Profile, ProfileFactory, ProfileRuntime, ProfileRuntimeHost, ProfileSubagents, } 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/profile.d.ts

@@ -3,7 +3,7 @@ import type { CheckpointProvider } from "./checkpoint.js";
 import type { Command } from "./commands.js";
 import type { AgentEvent } from "./events.js";
 import type { ToolRenderer } from "./extensions.js";
-import type { AgentMessage } from "./messages.js";
+import type { AgentMessage, CustomMessage } from "./messages.js";
 import type { PermissionRule } from "./permission.js";
 import type { AnyTool } from "./tools.js";
 export type PermissionModeTone = "restrictive" | "permissive" | "unrestricted";
@@ -16,7 +16,7 @@ export interface PermissionMode {
 }
 export interface ProfileRuntimeHost {
     emit: (event: AgentEvent) => void;
-    followUp: (message: string) => void;
+    followUp: (message: string | CustomMessage) => void;
 }
 export interface ProfileRuntime {
     attach: (host: ProfileRuntimeHost) => void;
@@ -24,6 +24,11 @@ export interface ProfileRuntime {
     stop?: () => void;
     shutdown?: () => void | Promise<void>;
 }
+export interface ProfileSubagents {
+    inspectionTools: string[];
+    searchPrompt?: string;
+    counselPrompt?: string;
+}
 export interface Profile {
     name: string;
     toolset: AnyTool[];
@@ -36,6 +41,8 @@ export interface Profile {
     commands?: Command[];
     environment?: () => Promise<Record<string, string>> | Record<string, string>;
     contextMessages?: () => Promise<AgentMessage[]> | AgentMessage[];
+    sideBoundary?: () => string;
+    subagents?: ProfileSubagents;
     refreshContext?: (messages: AgentMessage[], context: {
         sessionId: string;
     }) => Promise<AgentMessage[]> | AgentMessage[];

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

@@ -7,6 +7,7 @@ export type SessionEntry = {
     createdAt: string;
     profile: string;
     environment: Record<string, string>;
+    title?: string;
 } | {
     type: "message";
     id: string;
@@ -96,6 +97,7 @@ export declare class SessionTree {
     get header(): (SessionEntry & {
         type: "session";
     }) | undefined;
+    setTitle(title: string | undefined): void;
     get head(): string | null;
     all(): SessionEntry[];
     get(id: string): TreeEntry | undefined;
@@ -113,11 +115,13 @@ export interface SessionStore {
     load(sessionId: string): Promise<SessionTree | undefined>;
     save(sessionId: string, tree: SessionTree): Promise<void>;
     list(): Promise<string[]>;
+    delete?(sessionId: string): Promise<boolean>;
 }
 export declare class MemorySessionStore implements SessionStore {
     private sessions;
     load(sessionId: string): Promise<SessionTree | undefined>;
     save(sessionId: string, tree: SessionTree): Promise<void>;
     list(): Promise<string[]>;
+    delete(sessionId: string): Promise<boolean>;
 }
 export {};

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

@@ -1,8 +1,9 @@
-import type { ToolResultContent } from "../ai/index.js";
+import type { ToolResultContent, Usage } from "../ai/index.js";
 import type { ToolPermissionDetails } from "./permission.js";
 export interface ToolResult {
     content: ToolResultContent[];
     details?: unknown;
+    usage?: Usage;
     isError?: boolean;
     terminate?: boolean;
 }
@@ -16,7 +17,7 @@ export interface Tool<Args = Record<string, unknown>> {
     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>;
+    execute: (toolCallId: string, args: Args, signal: AbortSignal, onUpdate?: (partial: ToolResultContent[], details?: unknown) => void) => Promise<ToolResult>;
 }
 export type AnyTool = Tool<any>;
 export declare function errorResult(message: string): ToolResult;

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

@@ -1,2 +1,5 @@
 import type { PromptSection } from "../ai/index.js";
+export declare const CODING_SIDE_BOUNDARY = "This is a coding side conversation. Do not modify files, source, git state, configuration, or workspace state unless the user deliberately changes the side conversation's permission mode. Do not request broader permissions or use subagents.";
+export declare const CODING_SEARCH_PROMPT = "Use rg and rg --files through bash for broad discovery, then read only the relevant ranges. Ground every finding in exact workspace-relative paths and 1-based line ranges. Distinguish observed code behavior from hypotheses.";
+export declare const CODING_COUNSEL_PROMPT = "Inspect the current implementation and tests before judging. Cite exact workspace-relative paths and 1-based line ranges for the evidence behind the recommendation.";
 export declare function codingPrompt(modelRef: string): PromptSection[];

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

@@ -1,5 +1,5 @@
 import { type Credential, type ModelInfo, type PromptSection, type Provider, type ThinkingLevel, type Usage } from "../ai/index.js";
-import { type AgentEvent, type AgentMessage, type AnyTool, type CheckpointDiffFile, CheckpointHistory, type CheckpointProvider, type EventSink, type ExtensionHost, type PermissionRequest, type PermissionRule, type ProfileRuntime, type SessionStore, SessionTree, type UserContent } from "../core/index.js";
+import { type AgentEvent, type AgentMessage, type AnyTool, type CheckpointDiffFile, CheckpointHistory, type CheckpointProvider, type CustomMessage, type EventSink, type ExtensionHost, type PermissionRequest, type PermissionRule, type ProfileRuntime, type SessionStore, SessionTree, type UserContent } from "../core/index.js";
 import type { z } from "zod";
 import { type Budget } from "./budget.js";
 export type HaltReason = "done" | "aborted" | "error" | "maxTurns" | "maxCostUsd" | "maxTokens";
@@ -40,6 +40,7 @@ export interface CheckpointActionData {
     kind: "checkpoint";
     action: "undo" | "redo";
     files: CheckpointDiffFile[];
+    turnCount?: number;
     messageCount: number;
     prompt?: string;
 }
@@ -48,6 +49,11 @@ export interface CheckpointActionResult {
     message: string;
     data?: CheckpointActionData;
 }
+export interface UndoPoint {
+    steps: number;
+    prompt: string;
+    messageCount: number;
+}
 export interface ManualCompactionResult {
     status: "completed" | "queued" | "failed" | "cancelled" | "noop";
     message: string;
@@ -62,6 +68,14 @@ export interface AgentRunOptions<T = unknown> {
     model?: string | ModelInfo;
     allowedTools?: string[];
 }
+export interface ChildAgentOptions {
+    model?: ModelInfo;
+    thinkingLevel?: ThinkingLevel;
+    systemPrompt: string;
+    tools: AnyTool[];
+    permissions?: PermissionRule[];
+    budget?: Budget;
+}
 export declare class Agent {
     private readonly options;
     private model;
@@ -104,12 +118,16 @@ export declare class Agent {
     get session(): SessionTree;
     get sessionStore(): SessionStore;
     get modelRef(): string;
+    get modelInfo(): ModelInfo;
     get contextWindow(): number;
     get thinking(): ThinkingLevel;
     get thinkingLevels(): ThinkingLevel[];
     get isRunning(): boolean;
     get isCompacting(): boolean;
     get permissions(): PermissionRule[];
+    get tools(): AnyTool[];
+    availableModel(ref: string): ModelInfo | undefined;
+    createChild(options: ChildAgentOptions): Agent;
     setPermissions(rules: PermissionRule[]): void;
     addPermissionRule(rule: PermissionRule): void;
     setModel(ref: string | ModelInfo): void;
@@ -117,7 +135,7 @@ export declare class Agent {
     resume(tree: SessionTree): void;
     newSession(sessionId?: string): void;
     send(message: string): void;
-    followUp(message: string): void;
+    followUp(message: string | CustomMessage): void;
     removeQueuedMessage(kind: "steer" | "follow-up", text: string): boolean;
     emitTaskEvent(event: AgentEvent): void;
     subscribe(listener: EventSink): () => void;
@@ -130,7 +148,8 @@ export declare class Agent {
     compactNow(focus?: string): Promise<ManualCompactionResult>;
     private executeManualCompaction;
     get checkpointHistory(): CheckpointHistory;
-    undo(): Promise<CheckpointActionResult>;
+    undoPoints(): UndoPoint[];
+    undo(turnCount?: number): Promise<CheckpointActionResult>;
     redo(): Promise<CheckpointActionResult>;
     sessionDiff(): Promise<Awaited<ReturnType<CheckpointProvider["diff"]>>>;
     forkPoints(): {
@@ -161,6 +180,7 @@ export declare class Agent {
     private execute;
     private executeRun;
     private providerFor;
+    private resolveChildPermission;
     private publishEvent;
     private refreshContextAccounting;
     private publishToSubscribers;

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, ManualCompactionResult } from "./agent.js";
+import type { CheckpointActionResult, ManualCompactionResult, UndoPoint } from "./agent.js";
 export interface ForkPoint {
     id: string;
     description: string;
@@ -9,12 +9,17 @@ export interface DiffCommandData {
     kind: "diff";
     files: CheckpointDiffFile[];
 }
+export interface UndoPointsCommandData {
+    kind: "undo-points";
+    points: UndoPoint[];
+}
 export interface CoreCommandHooks {
     requestCompaction?: (focus?: string) => ManualCompactionResult | undefined | Promise<ManualCompactionResult | undefined>;
     usage?: () => Usage & {
         contextPercent: number;
     };
-    undo?: () => Promise<CheckpointActionResult>;
+    undo?: (turnCount?: number) => Promise<CheckpointActionResult>;
+    undoPoints?: () => UndoPoint[];
     redo?: () => Promise<CheckpointActionResult>;
     fork?: (entryId: string) => Promise<{
         ok: boolean;

package/dist/types/sdk/file-store.d.ts

@@ -11,4 +11,5 @@ export declare class FileSessionStore implements SessionStore {
     load(sessionId: string): Promise<SessionTree | undefined>;
     save(sessionId: string, tree: SessionTree): Promise<void>;
     list(): Promise<string[]>;
+    delete(sessionId: string): Promise<boolean>;
 }

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

@@ -2,7 +2,7 @@ export type { Credential, ModelDiscoveryOptions, ModelInfo, Provider, ProviderMo
 export { builtinProviderConfigs, defaultModelId, defaultModelRef, defaultThinkingLevel, discoverModels, findModel, listModels, providerConfig, 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, ManualCompactionResult, RunResult, } from "./agent.js";
+export type { AgentOptions, AgentRunOptions, CheckpointActionData, CheckpointActionResult, ChildAgentOptions, HaltReason, ManualCompactionResult, RunResult, UndoPoint, } 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";
@@ -10,7 +10,7 @@ export type { AuthPageOptions } from "./auth-page.js";
 export { authErrorPage, authSuccessPage, renderAuthPage } from "./auth-page.js";
 export type { Budget, BudgetBreach } from "./budget.js";
 export { checkBudget, totalTokens } from "./budget.js";
-export type { DiffCommandData, ForkPoint } from "./commands.js";
+export type { DiffCommandData, ForkPoint, UndoPointsCommandData } from "./commands.js";
 export { coreCommands, registryWithCoreCommands } from "./commands.js";
 export type { LoadOptions, LoadReport } from "./extension-loader.js";
 export { loadExtensions, resolveExtensionFiles } from "./extension-loader.js";
@@ -24,9 +24,13 @@ export type { Profile, ProfileImporter } from "./profile.js";
 export { loadProfile, optionsFromProfile } from "./profile.js";
 export type { HookEvent, HookRunner, HookSpec } from "./shell-hooks.js";
 export { shellHooksExtension } from "./shell-hooks.js";
+export type { SideConversation, SideConversationInput } from "./side.js";
+export { startSideConversation } from "./side.js";
 export type { Skill } from "./skills.js";
 export { defaultSkillRoots, discoverSkills, loadSkill, skillListing, skillsExtension, } from "./skills.js";
 export { STRUCTURED_OUTPUT_TOOL, structuredOutputPrompt, structuredOutputTool, } from "./structured-output.js";
+export type { SubagentDetails, SubagentExtensionOptions, SubagentKind, SubagentProgressUpdate, } from "./subagents.js";
+export { subagentsExtension } from "./subagents.js";
 export type { ToolDefinition, ToolResult } from "./tool.js";
 export { tool } from "./tool.js";
 export type { MarkdownTranscript, TranscriptMarkdownOptions, } from "./transcript-markdown.js";

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

@@ -0,0 +1,12 @@
+import { type AgentMessage, type PermissionRule } from "../core/index.js";
+import { Agent, type AgentOptions } from "./agent.js";
+export interface SideConversationInput {
+    messages: AgentMessage[];
+    boundary?: string;
+    permissions?: PermissionRule[];
+}
+export interface SideConversation {
+    agent: Agent;
+    close(): Promise<void>;
+}
+export declare function startSideConversation(options: AgentOptions, input: SideConversationInput): SideConversation;

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

@@ -0,0 +1,46 @@
+import { type ModelInfo, type ThinkingLevel, type Usage } from "../ai/index.js";
+import type { AgentMessage, Extension, PermissionRule, ProfileSubagents } from "../core/index.js";
+import type { Agent, HaltReason } from "./agent.js";
+export type SubagentKind = "task" | "search" | "counsel";
+export interface SubagentDetails {
+    type: "subagent";
+    kind: SubagentKind;
+    description: string;
+    model: string;
+    thinkingLevel: ThinkingLevel;
+    durationMs: number;
+    messages: AgentMessage[];
+    usage: Usage;
+    reason: HaltReason;
+}
+export interface SubagentProgressUpdate {
+    type: "subagent-progress";
+    kind: SubagentKind;
+    description: string;
+    model: string;
+    thinkingLevel: ThinkingLevel;
+    event: {
+        type: "assistant_start";
+    } | {
+        type: "text_delta";
+        text: string;
+    } | {
+        type: "message";
+        message: AgentMessage;
+    };
+}
+interface SubagentExtensionBaseOptions {
+    parent: () => Agent;
+    excludeTools?: readonly string[];
+    searchModel?: (parent: Agent) => ModelInfo | undefined;
+    counselModel?: (parent: Agent) => ModelInfo | undefined;
+}
+export type SubagentExtensionOptions = SubagentExtensionBaseOptions & ({
+    coding: ProfileSubagents;
+    inspectionPermissions: PermissionRule[];
+} | {
+    coding?: undefined;
+    inspectionPermissions?: PermissionRule[];
+});
+export declare function subagentsExtension(options: SubagentExtensionOptions): Extension;
+export {};

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

@@ -15,7 +15,7 @@ export interface ToolDefinition<Schema extends z.ZodType> {
     execute: (args: z.infer<Schema>, ctx: {
         toolCallId: string;
         signal: AbortSignal;
-        update: (text: string) => void;
+        update: (text: string, details?: unknown) => void;
     }) => Promise<ToolResult | string> | ToolResult | string;
 }
 export declare function tool<Schema extends z.ZodType>(definition: ToolDefinition<Schema>): Tool<z.infer<Schema>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mu-agent/mu",
-  "version": "0.0.9",
+  "version": "0.1.0",
   "description": "Mu, a general-purpose extensible AI agent platform for the terminal and TypeScript",
   "type": "module",
   "main": "./dist/index.js",