@robota-sdk/agent-framework 3.0.0-beta.67 → 3.0.0-beta.68

package/dist/node/index.d.ts

@@ -1,9 +1,264 @@
+import { IAIProvider, IContextWindowState, IFileSystem, IFileSystemAsync, IHistoryEntry, IHookInput, IHookResult, IHookTypeExecutor, IProviderConfig, IProviderDefinition, IProviderProbeResult, IProviderProfileConfig, ISession, ITerminalOutput, ITerminalOutput as ITerminalOutput$2, IToolSchema, IToolWithEventService, THookDefinition, THooksConfig, TPermissionMode, TSessionEndReason, TToolArgs, TTrustLevel, TUniversalMessage, TUniversalValue, formatEnvReference, hasUsableSecretReference, isEnvReference, resolveEnvReference } from "@robota-sdk/agent-core";
 import { IAgentBackgroundTaskRequest, IBackgroundTaskError, IBackgroundTaskError as IBackgroundTaskError$1, IBackgroundTaskHandle, IBackgroundTaskInput, IBackgroundTaskListFilter, IBackgroundTaskLogCursor, IBackgroundTaskLogCursor as IBackgroundTaskLogCursor$1, IBackgroundTaskLogPage, IBackgroundTaskManager, IBackgroundTaskManager as IBackgroundTaskManager$1, IBackgroundTaskManagerOptions, IBackgroundTaskResult, IBackgroundTaskRunner, IBackgroundTaskRunner as IBackgroundTaskRunner$1, IBackgroundTaskStart, IBackgroundTaskState, IBackgroundTaskState as IBackgroundTaskState$1, IBaseBackgroundTaskRequest, ICreateLimitedOutputCaptureOptions, ILimitedOutputCapture, IPreparedSubagentWorktree, IProcessBackgroundTaskRequest, ISerializableProviderProfile, ISubagentJobHandle, ISubagentJobResult, ISubagentJobStart, ISubagentJobState, ISubagentManager, ISubagentManagerOptions, ISubagentRunner, ISubagentRunner as ISubagentRunner$1, ISubagentSpawnRequest, ISubagentWorktreeAdapter, ISubagentWorktreePrepareRequest, IWorktreeSubagentRunnerOptions, TBackgroundPermissionPolicy, TBackgroundPermissionPolicy as TBackgroundPermissionPolicy$1, TBackgroundPrimitive, TBackgroundPrimitive as TBackgroundPrimitive$1, TBackgroundTaskErrorCategory, TBackgroundTaskEvent, TBackgroundTaskEventListener, TBackgroundTaskIdFactory, TBackgroundTaskIsolation, TBackgroundTaskIsolation as TBackgroundTaskIsolation$1, TBackgroundTaskKind, TBackgroundTaskKind as TBackgroundTaskKind$1, TBackgroundTaskMode, TBackgroundTaskMode as TBackgroundTaskMode$1, TBackgroundTaskRequest, TBackgroundTaskRunnerEvent, TBackgroundTaskStatus, TBackgroundTaskStatus as TBackgroundTaskStatus$1, TBackgroundTaskTimeoutReason, TBackgroundTaskTransitionEvent, TSubagentJobMode, TSubagentJobStatus } from "@robota-sdk/agent-executor";
-import { IAIProvider, IContextWindowState, IFileSystem, IFileSystemAsync, IHistoryEntry, IHookInput, IHookResult, IHookTypeExecutor, IProviderConfig, IProviderDefinition, IProviderModelCatalog, IProviderProbeResult, IProviderProfileConfig, ISession, ITerminalOutput, ITerminalOutput as ITerminalOutput$2, IToolSchema, IToolWithEventService, THookDefinition, THooksConfig, TPermissionMode, TSessionEndReason, TToolArgs, TTrustLevel, TUniversalMessage, TUniversalValue, formatEnvReference, hasUsableSecretReference, isEnvReference, resolveEnvReference } from "@robota-sdk/agent-core";
-import { FileSessionLogger, ICompactEvent, ISessionLogger, ISessionReplayValidationResult, ITerminalOutput as ITerminalOutput$1, Session, TPermissionHandler } from "@robota-sdk/agent-session";
+import { FileSessionLogger, ICompactEvent, ISessionLogger, ISessionReplayValidationResult, ITerminalOutput as ITerminalOutput$1, Session, TPermissionHandler, TPermissionResult } from "@robota-sdk/agent-session";
 import { ISandboxClient, IWorkspaceManifest, createZodFunctionTool } from "@robota-sdk/agent-tools";
 import { IConfigurableTransport, ITransportAdapter, ITransportAdapter as ITransportAdapter$1, ITransportConfig, ITransportRegistryView } from "@robota-sdk/agent-interface-transport";
 
+//#region src/command-api/org-policy/org-policy-types.d.ts
+interface IOrgPolicy {
+  /** Allowed provider profile names. Undefined = all allowed. */
+  allowedProviders?: string[];
+  /** Slash command names blocked by policy (without leading slash). */
+  blockedCommands?: string[];
+  /** If true, API keys must be stored as env references ($ENV:VAR), not plaintext. */
+  requireApiKeyFromEnv?: boolean;
+  /** Shown in policy violation messages so users know who to contact. */
+  adminContact?: string;
+}
+//#endregion
+//#region src/command-api/org-policy/org-policy-loader.d.ts
+declare function loadOrgPolicy(): IOrgPolicy | null;
+declare function formatOrgPolicyViolationMessage(reason: string, adminContact: string | undefined): string;
+declare function isApiKeyPlaintext(apiKey: string | undefined): boolean;
+//#endregion
+//#region src/capabilities/types.d.ts
+type TCapabilityKind = 'builtin-command' | 'skill' | 'agent' | 'tool';
+type TCapabilitySafety = 'read-only' | 'write' | 'process' | 'network' | 'background-agent';
+interface ICapabilityDescriptor {
+  readonly name: string;
+  readonly kind: TCapabilityKind;
+  readonly description: string;
+  readonly userInvocable: boolean;
+  readonly modelInvocable: boolean;
+  readonly argumentHint?: string;
+  readonly safety?: TCapabilitySafety;
+  /** When false, the projected tool is auto-approved without prompting the user. */
+  readonly requiresPermission?: boolean;
+}
+//#endregion
+//#region src/command-api/types.d.ts
+/** A command entry */
+interface ICommand {
+  /** Command name without slash (e.g., "mode") — used for invocation */
+  name: string;
+  /** User-friendly display label (e.g., "Interaction Mode"). Falls back to `name` if not set. */
+  displayName?: string;
+  /** Short description shown in autocomplete */
+  description: string;
+  /** Optional usage example shown in /help output (e.g., "/compact Summarize the context"). */
+  example?: string;
+  /** Source identifier (e.g., "builtin", "skill") */
+  source: string;
+  /** Subcommands for hierarchical menus */
+  subcommands?: ICommand[];
+  /** Execute the command. Args is everything after the command name. */
+  execute?: (args: string) => void | Promise<void>;
+  /** Full SKILL.md content (only for skill commands) */
+  skillContent?: string;
+  /** Hint for the expected argument (Claude Code frontmatter) */
+  argumentHint?: string;
+  /** When true, models cannot invoke this skill autonomously */
+  disableModelInvocation?: boolean;
+  /** When true, models may invoke this command through the SDK-projected command tool */
+  modelInvocable?: boolean;
+  /** When false, users cannot invoke this skill directly */
+  userInvocable?: boolean;
+  /** Safety category for model-visible capability descriptors */
+  safety?: TCapabilitySafety;
+  /** List of tools this skill is allowed to use */
+  allowedTools?: string[];
+  /** Preferred model for executing this skill */
+  model?: string;
+  /** Effort level hint for the skill */
+  effort?: string;
+  /** Context scope for the skill (e.g., "project") */
+  context?: string;
+  /** Agent identity to use when executing this skill */
+  agent?: string;
+  /** Plugin installation directory (plugin skills/commands only) */
+  pluginDir?: string;
+}
+/** A source that provides commands */
+interface ICommandSource {
+  name: string;
+  getCommands(): ICommand[];
+}
+//#endregion
+//#region src/config/settings-io.d.ts
+type TSettingsData = Record<string, TUniversalValue>;
+declare function getUserSettingsPath(): string;
+type TSettingsScope = 'user' | 'project-local';
+declare function resolveSettingsPathForScope(cwd: string, scope: TSettingsScope | undefined): string;
+declare function readSettings(path: string): TSettingsData;
+declare function writeSettings(path: string, settings: TSettingsData): void;
+declare function updateModelInSettings(settingsPath: string, modelId: string): void;
+declare function deleteSettings(path: string): boolean;
+//#endregion
+//#region src/command-api/statusline/statusline-command-api.d.ts
+declare const STATUSLINE_COMMAND_DESCRIPTION = "Configure TUI status-line visibility and fields such as model, context, tokens, session, and git branch.";
+declare const STATUSLINE_COMMAND_ARGUMENT_HINT = "on | off | reset | git on | git off";
+interface IStatusLineCommandSettings {
+  enabled: boolean;
+  gitBranch: boolean;
+}
+type TStatusLineCommandSettingsPatch = Partial<IStatusLineCommandSettings> & Record<string, TUniversalValue>;
+declare const DEFAULT_STATUS_LINE_COMMAND_SETTINGS: Readonly<IStatusLineCommandSettings>;
+declare function buildStatusLineCommandSubcommands(source?: string): ICommand[];
+declare function isStatusLineCommandSettingsPatch(value: Record<string, TUniversalValue>): value is TStatusLineCommandSettingsPatch;
+declare function readStatusLineSettings(settings: TSettingsData): IStatusLineCommandSettings;
+declare function applyStatusLineSettings(settingsPath: string, patch: TStatusLineCommandSettingsPatch): IStatusLineCommandSettings;
+//#endregion
+//#region src/command-api/effects.d.ts
+type TCommandEffect = {
+  type: 'provider-hot-swap-requested';
+  profileName: string;
+} | {
+  type: 'language-change-requested';
+  language: string;
+} | {
+  type: 'settings-reset-requested';
+} | {
+  type: 'session-exit-requested';
+  reason?: TSessionEndReason;
+  message?: string;
+} | {
+  type: 'session-restart-requested';
+  reason: TSessionEndReason;
+  message: string;
+} | {
+  type: 'plugin-tui-requested';
+} | {
+  type: 'plugin-registry-reload-requested';
+} | {
+  type: 'settings-tui-requested';
+} | {
+  type: 'session-picker-requested';
+} | {
+  type: 'session-renamed';
+  name: string;
+} | {
+  type: 'conversation-history-cleared';
+} | {
+  type: 'session-execution-started';
+} | {
+  type: 'statusline-settings-patch';
+  patch: TStatusLineCommandSettingsPatch;
+} | {
+  type: 'agent-switcher-requested';
+};
+//#endregion
+//#region src/command-api/interactions.d.ts
+/** Choice option for command-owned follow-up prompts. */
+interface ICommandChoicePromptOption {
+  value: string;
+  label: string;
+}
+/** Generic prompt descriptor rendered by host UIs for command interactions. */
+type TCommandInteractionPrompt = {
+  kind: 'choice';
+  title: string;
+  description?: string;
+  options: readonly ICommandChoicePromptOption[];
+  maxVisible?: number;
+} | {
+  kind: 'text';
+  title: string;
+  description?: string;
+  placeholder?: string;
+  allowEmpty?: boolean;
+  masked?: boolean;
+  validate?: (value: string) => string | undefined;
+};
+/** Stateful command continuation owned by the command module. */
+interface ICommandInteraction {
+  prompt: TCommandInteractionPrompt;
+  submit(value: string): Promise<ICommandResult> | ICommandResult;
+  cancel?(): Promise<ICommandResult> | ICommandResult;
+}
+//#endregion
+//#region src/command-api/command-result.d.ts
+type TCommandResultDataValue = TUniversalValue | Record<string, unknown> | readonly Record<string, unknown>[];
+/** Result of a system command execution. */
+interface ICommandResult {
+  /** Human-readable output message */
+  message: string;
+  /** Command completed successfully */
+  success: boolean;
+  /** Additional structured data (command-specific diagnostics only) */
+  data?: Record<string, unknown>;
+  /** Typed host effects requested by the command */
+  effects?: readonly TCommandEffect[];
+  /** Command-owned follow-up prompt and continuation */
+  interaction?: ICommandInteraction;
+}
+//#endregion
+//#region src/command-api/plugin/plugin-command-api.d.ts
+declare const PLUGIN_COMMAND_DESCRIPTION = "Manage plugins";
+declare const PLUGIN_COMMAND_ARGUMENT_HINT = "manage | install <name@marketplace> | uninstall <name@marketplace> | enable <name@marketplace> | disable <name@marketplace> | marketplace <action>";
+declare const RELOAD_PLUGINS_COMMAND_DESCRIPTION = "Reload all plugin resources";
+type TPluginInstallScope = 'user' | 'project';
+interface ICommandInstalledPlugin {
+  name: string;
+  description: string;
+  enabled: boolean;
+}
+interface ICommandAvailablePlugin {
+  name: string;
+  description: string;
+  installed: boolean;
+}
+interface ICommandMarketplaceSource {
+  name: string;
+  type: string;
+}
+interface ICommandPluginReloadResult {
+  loadedPluginCount: number;
+}
+interface ICommandPluginAdapter {
+  listInstalled(): Promise<readonly ICommandInstalledPlugin[]>;
+  listAvailablePlugins(marketplace: string): Promise<readonly ICommandAvailablePlugin[]>;
+  install(pluginId: string, scope?: TPluginInstallScope): Promise<void>;
+  uninstall(pluginId: string): Promise<void>;
+  enable(pluginId: string): Promise<void>;
+  disable(pluginId: string): Promise<void>;
+  marketplaceAdd(source: string): Promise<string>;
+  marketplaceRemove(name: string): Promise<void>;
+  marketplaceUpdate(name: string): Promise<void>;
+  marketplaceList(): Promise<readonly ICommandMarketplaceSource[]>;
+  reloadPlugins(): Promise<ICommandPluginReloadResult>;
+}
+declare function createPluginTuiRequestedEffect(): TCommandEffect;
+declare function createPluginRegistryReloadRequestedEffect(): TCommandEffect;
+declare function resolvePluginCommandAdapter(context: ICommandHostContext): ICommandPluginAdapter | undefined;
+declare function buildPluginCommandSubcommands(): ICommand[];
+//#endregion
+//#region src/command-api/host-adapters.d.ts
+interface ICommandSettingsDocument {
+  [key: string]: TUniversalValue;
+}
+interface ICommandSettingsAdapter<TSettings extends ICommandSettingsDocument = ICommandSettingsDocument> {
+  read(): TSettings;
+  write(settings: TSettings): void;
+}
+interface ICommandProcessAdapter {
+  requestExit(reason?: TSessionEndReason): void;
+  requestRestart(reason: TSessionEndReason, message: string): void;
+}
+interface ICommandPickerAdapter<TItem extends ICommandSettingsDocument> {
+  pick(items: readonly TItem[]): Promise<TItem | undefined> | TItem | undefined;
+}
+interface ICommandPermissionModeAdapter {
+  getPermissionMode(): TPermissionMode;
+  setPermissionMode(mode: TPermissionMode): void;
+  listSessionAllowedTools(): readonly string[];
+}
+interface ICommandHostAdapters {
+  settings?: ICommandSettingsAdapter;
+  process?: ICommandProcessAdapter;
+  permissionMode?: ICommandPermissionModeAdapter;
+  plugin?: ICommandPluginAdapter;
+}
+//#endregion
 //#region src/background-tasks/background-job-orchestrator.d.ts
 type TBackgroundJobWaitPolicy = 'detached' | 'wait_all' | 'wait_any' | 'manual';
 type TBackgroundJobGroupStatus = 'running' | 'completed';
@@ -273,485 +528,9 @@ interface ICreateExecutionWorkspaceTaskSpawnerOptions {
 }
 declare function createExecutionWorkspaceTaskSpawner(options: ICreateExecutionWorkspaceTaskSpawnerOptions): IExecutionWorkspaceTaskSpawner;
 //#endregion
-//#region src/interactive/interactive-session-background-tracker.d.ts
-interface IBackgroundTrackerState {
-  tasks: IBackgroundTaskState[];
-  taskEvents: TBackgroundTaskEvent[];
-  groups: IBackgroundJobGroupState[];
-  groupEvents: TBackgroundJobGroupEvent[];
-}
-declare class SessionBackgroundTaskTracker {
-  private readonly getManager;
-  private readonly onChanged;
-  private readonly emitTaskEvent;
-  private readonly emitGroupEvent;
-  private readonly persistSession;
-  private backgroundTasks;
-  private backgroundTaskEvents;
-  private backgroundJobGroups;
-  private backgroundJobGroupEvents;
-  private backgroundTaskUnsubscribe;
-  private backgroundJobUnsubscribe;
-  private backgroundJobOrchestrator;
-  constructor(getManager: () => IBackgroundTaskManager | undefined, onChanged: (cause: TExecutionWorkspaceUpdateCause, entryId?: string) => void, emitTaskEvent: (event: TBackgroundTaskEvent) => void, emitGroupEvent: (event: TBackgroundJobGroupEvent) => void, persistSession: () => void);
-  subscribe(session: Session): void;
-  dispose(): void;
-  restoreState(state: IBackgroundTrackerState): void;
-  getState(): IBackgroundTrackerState;
-  getManagerOrThrow(): IBackgroundTaskManager;
-  getOrchestratorOrThrow(sessionId: string): BackgroundJobOrchestrator;
-  cancelTask(taskId: string, reason?: string): Promise<void>;
-  closeTask(taskId: string): Promise<void>;
-  sendTask(taskId: string, input: IBackgroundTaskInput): Promise<void>;
-  readTaskLog(taskId: string, cursor?: IBackgroundTaskLogCursor): Promise<IBackgroundTaskLogPage>;
-  listTasks(filter?: IBackgroundTaskListFilter): IBackgroundTaskState[];
-  getTask(taskId: string): IBackgroundTaskState | undefined;
-  createGroup(input: Omit<IBackgroundJobGroupCreateRequest, 'parentSessionId'>, sessionId: string): IBackgroundJobGroupState;
-  listGroups(sessionId: string): IBackgroundJobGroupState[];
-  getGroup(groupId: string, sessionId: string): IBackgroundJobGroupState | undefined;
-  waitGroup(groupId: string, sessionId: string): Promise<IBackgroundJobGroupState>;
-  readTaskDetail(entryId: string, taskId: string, cursor?: IExecutionDetailCursor): Promise<IExecutionDetailPage>;
-  readGroupDetail(entryId: string, groupId: string, sessionId: string): IExecutionDetailPage;
-  getTaskSnapshots(): IBackgroundTaskState[];
-  getGroupSnapshots(): IBackgroundJobGroupState[];
-  private subscribeGroupEvents;
-  private recordTaskEvent;
-  private recordGroupEvent;
-}
-//#endregion
-//#region src/agents/agent-definition-types.d.ts
-/**
- * Definition of an agent that can be spawned as a subagent.
- *
- * Built-in agents and custom (user-defined) agents share this shape.
- * Optional fields inherit from the parent session when omitted.
- */
-interface IAgentDefinition {
-  /** Unique name used to reference the agent (e.g., 'Explore', 'Plan'). */
-  name: string;
-  /** Human-readable description of the agent's purpose. */
-  description: string;
-  /** Markdown body content used as the agent's system prompt. */
-  systemPrompt: string;
-  /** Model override (e.g., 'claude-haiku-4-5', 'sonnet', 'opus'). Inherits parent model when omitted. */
-  model?: string;
-  /** Maximum number of agentic turns the subagent may execute. */
-  maxTurns?: number;
-  /** Allowlist of tool names. Only these tools are available when set. */
-  tools?: string[];
-  /** Denylist of tool names. These tools are removed from the inherited set. */
-  disallowedTools?: string[];
-}
-//#endregion
-//#region src/config/config-types.d.ts
-/**
- * Fully resolved config after merging all settings files and applying defaults.
- */
-interface IResolvedConfig {
-  defaultTrustLevel: 'safe' | 'moderate' | 'full';
-  /** Response language code (e.g., "ko", "en"). Undefined = no language constraint. */
-  language?: string;
-  /** Active provider profile key when providers/currentProvider are used. */
-  currentProvider?: string;
-  provider: {
-    name: string;
-    model: string;
-    apiKey: string | undefined;
-    baseURL?: string;
-    timeout?: number;
-    options?: Record<string, TUniversalValue>;
-  };
-  permissions: {
-    allow: string[];
-    deny: string[];
-  };
-  env: Record<string, string>;
-  hooks?: THooksConfig;
-  /** Plugin enablement map: plugin name -> enabled/disabled */
-  enabledPlugins?: Record<string, boolean>;
-  /** Extra marketplace sources: name -> { source } */
-  extraKnownMarketplaces?: Record<string, {
-    source: {
-      type: string;
-      repo?: string;
-      url?: string;
-      path?: string;
-      ref?: string;
-    };
-  }>;
-  /** Auto-compact threshold as a 0-1 fraction. Set false to disable automatic compaction. */
-  autoCompactThreshold?: number | false;
-  /** Transport enable/disable + options: transport name -> { enabled, options } */
-  transports?: Record<string, {
-    enabled?: boolean;
-    options?: Record<string, unknown>;
-  }>;
-}
-//#endregion
-//#region src/context/context-file-tracker.d.ts
-/** A single context file entry tracked with its content hash. */
-interface IContextFileEntry {
-  /** Absolute path to the file. */
-  filePath: string;
-  /** Content as read at load time. */
-  content: string;
-  /** SHA-256 hex digest of `content`. */
-  contentHash: string;
-}
-//#endregion
-//#region src/context/context-loader.d.ts
-interface ILoadedContext {
-  /** Concatenated content of all AGENTS.md files found (root-first) */
-  agentsMd: string;
-  /** Concatenated content of all CLAUDE.md files found (root-first) */
-  claudeMd: string;
-  /** Startup project memory index loaded from .robota/memory/MEMORY.md, if present */
-  memoryMd?: string;
-  /** Formatted active task context loaded from .agents/tasks/*.md, if present */
-  taskContext?: string;
-  /** Extracted "Compact Instructions" section from CLAUDE.md, if present */
-  compactInstructions?: string;
-  /** Per-file entries for all AGENTS.md files, root-first. Present for staleness detection. */
-  agentsFileEntries?: IContextFileEntry[];
-  /** Per-file entries for all CLAUDE.md files, root-first. Present for staleness detection. */
-  claudeFileEntries?: IContextFileEntry[];
-}
-//#endregion
-//#region src/assembly/create-subagent-session.d.ts
-/** Options for creating a subagent session. */
-interface ISubagentOptions {
-  /** Agent definition (built-in or custom). */
-  agentDefinition: IAgentDefinition;
-  /** Parent's resolved config (for provider, permissions, etc.). */
-  parentConfig: IResolvedConfig;
-  /** Parent's loaded context (CLAUDE.md, AGENTS.md). */
-  parentContext: ILoadedContext;
-  /** Parent session's available tools (to inherit/filter). */
-  parentTools: IToolWithEventService[];
-  /** AI provider instance. */
-  provider: IAIProvider;
-  /** Terminal output interface. */
-  terminal: ITerminalOutput$1;
-  /** Stable session ID for transcript files. */
-  sessionId?: string;
-  /** Optional logger for subagent transcripts. */
-  sessionLogger?: ISessionLogger;
-  /** Whether this is a fork worker (uses fork suffix instead of standard). */
-  isForkWorker?: boolean;
-  /** Permission mode from parent (bypassPermissions, acceptEdits, etc.). */
-  permissionMode?: TPermissionMode;
-  /** Permission handler from parent. */
-  permissionHandler?: TPermissionHandler;
-  /** Plugin hooks configuration from parent session. */
-  hooks?: Record<string, unknown>;
-  /** Hook type executors from parent session (prompt, agent, etc.). */
-  hookTypeExecutors?: IHookTypeExecutor[];
-  /** Streaming callback. */
-  onTextDelta?: (delta: string) => void;
-  /** Tool execution callback. */
-  onToolExecution?: (event: {
-    type: 'start' | 'end';
-    toolName: string;
-    toolArgs?: TToolArgs;
-    success?: boolean;
-    denied?: boolean;
-    toolResultData?: string;
-  }) => void;
-}
-/**
- * Create a fully-configured Session for subagent execution.
- *
- * Assembles provider, tools, and system prompt from parent context and
- * agent definition, then returns a new Session instance.
- */
-declare function createSubagentSession(options: ISubagentOptions): Session;
-//#endregion
-//#region src/subagents/in-process-subagent-runner.d.ts
-interface IInProcessSubagentRunnerDeps {
-  config: IResolvedConfig;
-  context: ILoadedContext;
-  tools: IToolWithEventService[];
-  terminal: ITerminalOutput;
-  provider: IAIProvider;
-  permissionMode?: TPermissionMode;
-  permissionHandler?: TPermissionHandler;
-  hooks?: ISubagentOptions['hooks'];
-  hookTypeExecutors?: IHookTypeExecutor[];
-  onTextDelta?: (delta: string) => void;
-  onToolExecution?: (event: {
-    type: 'start' | 'end';
-    toolName: string;
-    toolArgs?: TToolArgs;
-    success?: boolean;
-    denied?: boolean;
-    toolResultData?: string;
-  }) => void;
-  customAgentRegistry?: (name: string) => IAgentDefinition | undefined;
-}
-type TSubagentRunnerFactory = (deps: IInProcessSubagentRunnerDeps) => ISubagentRunner$1;
-declare function createInProcessSubagentRunner(deps: IInProcessSubagentRunnerDeps): ISubagentRunner$1;
-//#endregion
-//#region src/tools/agent-tool.d.ts
-/** Dependencies injected at creation time via createAgentTool factory */
-interface IAgentToolDeps extends IInProcessSubagentRunnerDeps {
-  cwd?: string;
-  parentSessionId?: string;
-  subagentDepth?: number;
-  subagentManager?: ISubagentManager;
-  backgroundTaskManager?: IBackgroundTaskManager;
-  /** Optional custom agent registry for resolving non-built-in agent types. */
-  customAgentRegistry?: (name: string) => IAgentDefinition | undefined;
-  /** Model-visible and command-visible agent definitions available to this session. */
-  agentDefinitions?: IAgentDefinition[];
-}
-/** Store agent tool deps keyed by a session (or any object). */
-declare function storeAgentToolDeps(key: object, deps: IAgentToolDeps): void;
-/** Retrieve agent tool deps for a given session key. */
-declare function retrieveAgentToolDeps(key: object): IAgentToolDeps | undefined;
-/**
- * Create an agent tool instance with deps captured in closure.
- *
- * Each session gets its own tool instance — no shared mutable state.
- */
-declare function createAgentTool(deps: IAgentToolDeps): ReturnType<typeof createZodFunctionTool>;
-//#endregion
-//#region src/capabilities/types.d.ts
-type TCapabilityKind = 'builtin-command' | 'skill' | 'agent' | 'tool';
-type TCapabilitySafety = 'read-only' | 'write' | 'process' | 'network' | 'background-agent';
-interface ICapabilityDescriptor {
-  readonly name: string;
-  readonly kind: TCapabilityKind;
-  readonly description: string;
-  readonly userInvocable: boolean;
-  readonly modelInvocable: boolean;
-  readonly argumentHint?: string;
-  readonly safety?: TCapabilitySafety;
-}
-//#endregion
-//#region src/command-api/types.d.ts
-/** A command entry */
-interface ICommand {
-  /** Command name without slash (e.g., "mode") — used for invocation */
-  name: string;
-  /** User-friendly display label (e.g., "Interaction Mode"). Falls back to `name` if not set. */
-  displayName?: string;
-  /** Short description shown in autocomplete */
-  description: string;
-  /** Source identifier (e.g., "builtin", "skill") */
-  source: string;
-  /** Subcommands for hierarchical menus */
-  subcommands?: ICommand[];
-  /** Execute the command. Args is everything after the command name. */
-  execute?: (args: string) => void | Promise<void>;
-  /** Full SKILL.md content (only for skill commands) */
-  skillContent?: string;
-  /** Hint for the expected argument (Claude Code frontmatter) */
-  argumentHint?: string;
-  /** When true, models cannot invoke this skill autonomously */
-  disableModelInvocation?: boolean;
-  /** When true, models may invoke this command through the SDK-projected command tool */
-  modelInvocable?: boolean;
-  /** When false, users cannot invoke this skill directly */
-  userInvocable?: boolean;
-  /** Safety category for model-visible capability descriptors */
-  safety?: TCapabilitySafety;
-  /** List of tools this skill is allowed to use */
-  allowedTools?: string[];
-  /** Preferred model for executing this skill */
-  model?: string;
-  /** Effort level hint for the skill */
-  effort?: string;
-  /** Context scope for the skill (e.g., "project") */
-  context?: string;
-  /** Agent identity to use when executing this skill */
-  agent?: string;
-  /** Plugin installation directory (plugin skills/commands only) */
-  pluginDir?: string;
-}
-/** A source that provides commands */
-interface ICommandSource {
-  name: string;
-  getCommands(): ICommand[];
-}
-//#endregion
-//#region src/config/settings-io.d.ts
-type TSettingsData = Record<string, TUniversalValue>;
-declare function getUserSettingsPath(): string;
-type TSettingsScope = 'user' | 'project-local';
-declare function resolveSettingsPathForScope(cwd: string, scope: TSettingsScope | undefined): string;
-declare function readSettings(path: string): TSettingsData;
-declare function writeSettings(path: string, settings: TSettingsData): void;
-declare function updateModelInSettings(settingsPath: string, modelId: string): void;
-declare function deleteSettings(path: string): boolean;
-//#endregion
-//#region src/command-api/statusline/statusline-command-api.d.ts
-declare const STATUSLINE_COMMAND_DESCRIPTION = "Configure TUI status-line visibility and fields such as model, context, tokens, session, and git branch.";
-declare const STATUSLINE_COMMAND_ARGUMENT_HINT = "on | off | reset | git on | git off";
-interface IStatusLineCommandSettings {
-  enabled: boolean;
-  gitBranch: boolean;
-}
-type TStatusLineCommandSettingsPatch = Partial<IStatusLineCommandSettings> & Record<string, TUniversalValue>;
-declare const DEFAULT_STATUS_LINE_COMMAND_SETTINGS: Readonly<IStatusLineCommandSettings>;
-declare function buildStatusLineCommandSubcommands(source?: string): ICommand[];
-declare function isStatusLineCommandSettingsPatch(value: Record<string, TUniversalValue>): value is TStatusLineCommandSettingsPatch;
-declare function readStatusLineSettings(settings: TSettingsData): IStatusLineCommandSettings;
-declare function applyStatusLineSettings(settingsPath: string, patch: TStatusLineCommandSettingsPatch): IStatusLineCommandSettings;
-//#endregion
-//#region src/command-api/effects.d.ts
-type TCommandEffect = {
-  type: 'model-change-requested';
-  modelId: string;
-} | {
-  type: 'language-change-requested';
-  language: string;
-} | {
-  type: 'settings-reset-requested';
-} | {
-  type: 'session-exit-requested';
-  reason?: TSessionEndReason;
-  message?: string;
-} | {
-  type: 'session-restart-requested';
-  reason: TSessionEndReason;
-  message: string;
-} | {
-  type: 'plugin-tui-requested';
-} | {
-  type: 'plugin-registry-reload-requested';
-} | {
-  type: 'settings-tui-requested';
-} | {
-  type: 'session-picker-requested';
-} | {
-  type: 'session-renamed';
-  name: string;
-} | {
-  type: 'conversation-history-cleared';
-} | {
-  type: 'session-execution-started';
-} | {
-  type: 'statusline-settings-patch';
-  patch: TStatusLineCommandSettingsPatch;
-} | {
-  type: 'agent-switcher-requested';
-};
-//#endregion
-//#region src/command-api/interactions.d.ts
-/** Choice option for command-owned follow-up prompts. */
-interface ICommandChoicePromptOption {
-  value: string;
-  label: string;
-}
-/** Generic prompt descriptor rendered by host UIs for command interactions. */
-type TCommandInteractionPrompt = {
-  kind: 'choice';
-  title: string;
-  description?: string;
-  options: readonly ICommandChoicePromptOption[];
-  maxVisible?: number;
-} | {
-  kind: 'text';
-  title: string;
-  description?: string;
-  placeholder?: string;
-  allowEmpty?: boolean;
-  masked?: boolean;
-  validate?: (value: string) => string | undefined;
-};
-/** Stateful command continuation owned by the command module. */
-interface ICommandInteraction {
-  prompt: TCommandInteractionPrompt;
-  submit(value: string): Promise<ICommandResult> | ICommandResult;
-  cancel?(): Promise<ICommandResult> | ICommandResult;
-}
-//#endregion
-//#region src/command-api/command-result.d.ts
-type TCommandResultDataValue = TUniversalValue | Record<string, unknown> | readonly Record<string, unknown>[];
-/** Result of a system command execution. */
-interface ICommandResult {
-  /** Human-readable output message */
-  message: string;
-  /** Command completed successfully */
-  success: boolean;
-  /** Additional structured data (command-specific diagnostics only) */
-  data?: Record<string, unknown>;
-  /** Typed host effects requested by the command */
-  effects?: readonly TCommandEffect[];
-  /** Command-owned follow-up prompt and continuation */
-  interaction?: ICommandInteraction;
-}
-//#endregion
-//#region src/command-api/plugin/plugin-command-api.d.ts
-declare const PLUGIN_COMMAND_DESCRIPTION = "Manage plugins";
-declare const PLUGIN_COMMAND_ARGUMENT_HINT = "manage | install <name@marketplace> | uninstall <name@marketplace> | enable <name@marketplace> | disable <name@marketplace> | marketplace <action>";
-declare const RELOAD_PLUGINS_COMMAND_DESCRIPTION = "Reload all plugin resources";
-type TPluginInstallScope = 'user' | 'project';
-interface ICommandInstalledPlugin {
-  name: string;
-  description: string;
-  enabled: boolean;
-}
-interface ICommandAvailablePlugin {
-  name: string;
-  description: string;
-  installed: boolean;
-}
-interface ICommandMarketplaceSource {
-  name: string;
-  type: string;
-}
-interface ICommandPluginReloadResult {
-  loadedPluginCount: number;
-}
-interface ICommandPluginAdapter {
-  listInstalled(): Promise<readonly ICommandInstalledPlugin[]>;
-  listAvailablePlugins(marketplace: string): Promise<readonly ICommandAvailablePlugin[]>;
-  install(pluginId: string, scope?: TPluginInstallScope): Promise<void>;
-  uninstall(pluginId: string): Promise<void>;
-  enable(pluginId: string): Promise<void>;
-  disable(pluginId: string): Promise<void>;
-  marketplaceAdd(source: string): Promise<string>;
-  marketplaceRemove(name: string): Promise<void>;
-  marketplaceUpdate(name: string): Promise<void>;
-  marketplaceList(): Promise<readonly ICommandMarketplaceSource[]>;
-  reloadPlugins(): Promise<ICommandPluginReloadResult>;
-}
-declare function createPluginTuiRequestedEffect(): TCommandEffect;
-declare function createPluginRegistryReloadRequestedEffect(): TCommandEffect;
-declare function resolvePluginCommandAdapter(context: ICommandHostContext): ICommandPluginAdapter | undefined;
-declare function buildPluginCommandSubcommands(): ICommand[];
-//#endregion
-//#region src/command-api/host-adapters.d.ts
-interface ICommandSettingsDocument {
-  [key: string]: TUniversalValue;
-}
-interface ICommandSettingsAdapter<TSettings extends ICommandSettingsDocument = ICommandSettingsDocument> {
-  read(): TSettings;
-  write(settings: TSettings): void;
-}
-interface ICommandProcessAdapter {
-  requestExit(reason?: TSessionEndReason): void;
-  requestRestart(reason: TSessionEndReason, message: string): void;
-}
-interface ICommandPickerAdapter<TItem extends ICommandSettingsDocument> {
-  pick(items: readonly TItem[]): Promise<TItem | undefined> | TItem | undefined;
-}
-interface ICommandPermissionModeAdapter {
-  getPermissionMode(): TPermissionMode;
-  setPermissionMode(mode: TPermissionMode): void;
-  listSessionAllowedTools(): readonly string[];
-}
-interface ICommandHostAdapters {
-  settings?: ICommandSettingsAdapter;
-  process?: ICommandProcessAdapter;
-  permissionMode?: ICommandPermissionModeAdapter;
-  plugin?: ICommandPluginAdapter;
-}
-//#endregion
-//#region src/checkpoints/edit-checkpoint-types.d.ts
-interface IEditCheckpointRecorder {
-  captureFile(filePath: string): Promise<void> | void;
+//#region src/checkpoints/edit-checkpoint-types.d.ts
+interface IEditCheckpointRecorder {
+  captureFile(filePath: string): Promise<void> | void;
 }
 interface IEditCheckpointTurnInput {
   sessionId: string;
@@ -966,37 +745,211 @@ declare class ProjectMemoryStore {
   append(input: IAppendMemoryInput): IAppendMemoryResult;
 }
 //#endregion
-//#region src/memory/automatic-memory-types.d.ts
-type TMemoryCandidateStatus = 'pending' | 'approved' | 'rejected' | 'saved' | 'skipped';
-interface IMemoryCandidate {
-  id: string;
-  type: TMemoryType;
-  topic: string;
-  text: string;
-  sourceMessageIds: string[];
-  confidence: number;
-  createdAt: string;
-  reason: string;
-}
-interface IMemoryPendingRecord extends IMemoryCandidate {
-  status: TMemoryCandidateStatus;
-  updatedAt: string;
-  decisionReason?: string;
-}
-interface IMemoryReference {
-  topic: string;
-  path: string;
-  score: number;
-  truncated: boolean;
-}
-interface IMemoryEvent {
-  type: 'memory_candidate_extracted' | 'memory_candidate_queued' | 'memory_candidate_saved' | 'memory_candidate_skipped' | 'memory_candidate_approved' | 'memory_candidate_rejected' | 'memory_retrieved';
-  at: string;
-  candidateId?: string;
-  topic?: string;
-  reason?: string;
-  data?: Record<string, TUniversalValue>;
+//#region src/memory/automatic-memory-types.d.ts
+type TMemoryCandidateStatus = 'pending' | 'approved' | 'rejected' | 'saved' | 'skipped';
+interface IMemoryCandidate {
+  id: string;
+  type: TMemoryType;
+  topic: string;
+  text: string;
+  sourceMessageIds: string[];
+  confidence: number;
+  createdAt: string;
+  reason: string;
+}
+interface IMemoryPendingRecord extends IMemoryCandidate {
+  status: TMemoryCandidateStatus;
+  updatedAt: string;
+  decisionReason?: string;
+}
+interface IMemoryReference {
+  topic: string;
+  path: string;
+  score: number;
+  truncated: boolean;
+}
+interface IMemoryEvent {
+  type: 'memory_candidate_extracted' | 'memory_candidate_queued' | 'memory_candidate_saved' | 'memory_candidate_skipped' | 'memory_candidate_approved' | 'memory_candidate_rejected' | 'memory_retrieved';
+  at: string;
+  candidateId?: string;
+  topic?: string;
+  reason?: string;
+  data?: Record<string, TUniversalValue>;
+}
+//#endregion
+//#region src/agents/agent-definition-types.d.ts
+/**
+ * Definition of an agent that can be spawned as a subagent.
+ *
+ * Built-in agents and custom (user-defined) agents share this shape.
+ * Optional fields inherit from the parent session when omitted.
+ */
+interface IAgentDefinition {
+  /** Unique name used to reference the agent (e.g., 'Explore', 'Plan'). */
+  name: string;
+  /** Human-readable description of the agent's purpose. */
+  description: string;
+  /** Markdown body content used as the agent's system prompt. */
+  systemPrompt: string;
+  /** Model override (e.g., 'claude-haiku-4-5', 'sonnet', 'opus'). Inherits parent model when omitted. */
+  model?: string;
+  /** Maximum number of agentic turns the subagent may execute. */
+  maxTurns?: number;
+  /** Allowlist of tool names. Only these tools are available when set. */
+  tools?: string[];
+  /** Denylist of tool names. These tools are removed from the inherited set. */
+  disallowedTools?: string[];
+}
+//#endregion
+//#region src/config/config-types.d.ts
+/**
+ * Fully resolved config after merging all settings files and applying defaults.
+ */
+interface IResolvedConfig {
+  defaultTrustLevel: 'safe' | 'moderate' | 'full';
+  /** Response language code (e.g., "ko", "en"). Undefined = no language constraint. */
+  language?: string;
+  /** Active provider profile key when providers/currentProvider are used. */
+  currentProvider?: string;
+  provider: {
+    name: string;
+    model: string;
+    apiKey: string | undefined;
+    baseURL?: string;
+    timeout?: number;
+    options?: Record<string, TUniversalValue>;
+  };
+  permissions: {
+    allow: string[];
+    deny: string[];
+  };
+  env: Record<string, string>;
+  hooks?: THooksConfig;
+  /** Plugin enablement map: plugin name -> enabled/disabled */
+  enabledPlugins?: Record<string, boolean>;
+  /** Extra marketplace sources: name -> { source } */
+  extraKnownMarketplaces?: Record<string, {
+    source: {
+      type: string;
+      repo?: string;
+      url?: string;
+      path?: string;
+      ref?: string;
+    };
+  }>;
+  /** Auto-compact threshold as a 0-1 fraction. Set false to disable automatic compaction. */
+  autoCompactThreshold?: number | false;
+  /** Transport enable/disable + options: transport name -> { enabled, options } */
+  transports?: Record<string, {
+    enabled?: boolean;
+    options?: Record<string, unknown>;
+  }>;
+}
+//#endregion
+//#region src/context/context-file-tracker.d.ts
+/** A single context file entry tracked with its content hash. */
+interface IContextFileEntry {
+  /** Absolute path to the file. */
+  filePath: string;
+  /** Content as read at load time. */
+  content: string;
+  /** SHA-256 hex digest of `content`. */
+  contentHash: string;
+}
+//#endregion
+//#region src/context/context-loader.d.ts
+interface ILoadedContext {
+  /** Concatenated content of all AGENTS.md files found (root-first) */
+  agentsMd: string;
+  /** Concatenated content of all CLAUDE.md files found (root-first) */
+  claudeMd: string;
+  /** Startup project memory index loaded from .robota/memory/MEMORY.md, if present */
+  memoryMd?: string;
+  /** Formatted active task context loaded from .agents/tasks/*.md, if present */
+  taskContext?: string;
+  /** Extracted "Compact Instructions" section from CLAUDE.md, if present */
+  compactInstructions?: string;
+  /** Per-file entries for all AGENTS.md files, root-first. Present for staleness detection. */
+  agentsFileEntries?: IContextFileEntry[];
+  /** Per-file entries for all CLAUDE.md files, root-first. Present for staleness detection. */
+  claudeFileEntries?: IContextFileEntry[];
+}
+//#endregion
+//#region src/assembly/create-subagent-session.d.ts
+/** Options for creating a subagent session. */
+interface ISubagentOptions {
+  /** Agent definition (built-in or custom). */
+  agentDefinition: IAgentDefinition;
+  /** Parent's resolved config (for provider, permissions, etc.). */
+  parentConfig: IResolvedConfig;
+  /** Parent's loaded context (CLAUDE.md, AGENTS.md). */
+  parentContext: ILoadedContext;
+  /** Parent session's available tools (to inherit/filter). */
+  parentTools: IToolWithEventService[];
+  /** AI provider instance. */
+  provider: IAIProvider;
+  /** Terminal output interface. */
+  terminal: ITerminalOutput$1;
+  /** Stable session ID for transcript files. */
+  sessionId?: string;
+  /** Optional logger for subagent transcripts. */
+  sessionLogger?: ISessionLogger;
+  /** Whether this is a fork worker (uses fork suffix instead of standard). */
+  isForkWorker?: boolean;
+  /** Permission mode from parent (bypassPermissions, acceptEdits, etc.). */
+  permissionMode?: TPermissionMode;
+  /** Permission handler from parent. */
+  permissionHandler?: TPermissionHandler;
+  /** Plugin hooks configuration from parent session. */
+  hooks?: Record<string, unknown>;
+  /** Hook type executors from parent session (prompt, agent, etc.). */
+  hookTypeExecutors?: IHookTypeExecutor[];
+  /** Streaming callback. */
+  onTextDelta?: (delta: string) => void;
+  /** Tool execution callback. */
+  onToolExecution?: (event: {
+    type: 'start' | 'end';
+    toolName: string;
+    toolArgs?: TToolArgs;
+    success?: boolean;
+    denied?: boolean;
+    toolResultData?: string;
+    executionId?: string;
+  }) => void;
+}
+/**
+ * Create a fully-configured Session for subagent execution.
+ *
+ * Assembles provider, tools, and system prompt from parent context and
+ * agent definition, then returns a new Session instance.
+ */
+declare function createSubagentSession(options: ISubagentOptions): Session;
+//#endregion
+//#region src/subagents/in-process-subagent-runner.d.ts
+interface IInProcessSubagentRunnerDeps {
+  config: IResolvedConfig;
+  context: ILoadedContext;
+  tools: IToolWithEventService[];
+  terminal: ITerminalOutput;
+  provider: IAIProvider;
+  permissionMode?: TPermissionMode;
+  permissionHandler?: TPermissionHandler;
+  hooks?: ISubagentOptions['hooks'];
+  hookTypeExecutors?: IHookTypeExecutor[];
+  onTextDelta?: (delta: string) => void;
+  onToolExecution?: (event: {
+    type: 'start' | 'end';
+    toolName: string;
+    toolArgs?: TToolArgs;
+    success?: boolean;
+    denied?: boolean;
+    toolResultData?: string;
+    executionId?: string;
+  }) => void;
+  customAgentRegistry?: (name: string) => IAgentDefinition | undefined;
 }
+type TSubagentRunnerFactory = (deps: IInProcessSubagentRunnerDeps) => ISubagentRunner$1;
+declare function createInProcessSubagentRunner(deps: IInProcessSubagentRunnerDeps): ISubagentRunner$1;
 //#endregion
 //#region src/command-api/context/context-command-api.d.ts
 type TAutoCompactThreshold = number | false;
@@ -1005,6 +958,8 @@ declare const AUTO_COMPACT_THRESHOLD_SETTINGS_KEY = "autoCompactThreshold";
 interface ICompactContextResult {
   before: IContextWindowState;
   after: IContextWindowState;
+  beforeMessageCount: number;
+  afterMessageCount: number;
 }
 /** Read context-window state through the command host facade. */
 declare function readCommandContextState(context: ICommandHostContext): IContextWindowState;
@@ -1035,6 +990,8 @@ interface ICommandListEntry {
   /** User-friendly display label. Falls back to `name` if not set. */
   displayName?: string;
   description: string;
+  /** Optional usage example shown in /help output (e.g., "/compact Summarize the context"). */
+  example?: string;
 }
 interface ICommandSkillListEntry {
   readonly name: string;
@@ -1064,6 +1021,11 @@ interface ICommandSessionRuntime {
   getSessionAllowedTools(): readonly string[];
   getAutoCompactThreshold(): number | false;
   setAutoCompactThreshold?(threshold: TAutoCompactThreshold): void;
+  getSessionTokenUsage?(): {
+    inputTokens: number;
+    outputTokens: number;
+  } | undefined;
+  getModelId?(): string | undefined;
 }
 interface ICommandSessionReplayValidationReport {
   logFile: string;
@@ -1131,6 +1093,8 @@ interface ISystemCommand {
   /** User-friendly display label (e.g., "Interaction Mode"). Falls back to `name` if not set. */
   displayName?: string;
   description: string;
+  /** Optional usage example shown in /help output (e.g., "/compact Summarize the context"). */
+  example?: string;
   modelInvocable?: boolean;
   userInvocable?: boolean;
   argumentHint?: string;
@@ -1217,6 +1181,7 @@ interface IProviderCommandSettingsAdapter {
 interface IProviderCommandModuleOptions {
   providerDefinitions: readonly IProviderDefinition[];
   settings: IProviderCommandSettingsAdapter;
+  orgPolicy?: IOrgPolicy;
 }
 //#endregion
 //#region src/command-api/provider/provider-profile-names.d.ts
@@ -1290,41 +1255,6 @@ declare function readCommandBackgroundTaskLog(context: ICommandHostContext, task
 declare function cancelCommandBackgroundTask(context: ICommandHostContext, taskId: string, reason?: string): Promise<void>;
 declare function closeCommandBackgroundTask(context: ICommandHostContext, taskId: string): Promise<void>;
 //#endregion
-//#region src/command-api/model/model-command-api.d.ts
-declare const MODEL_COMMAND_DESCRIPTION = "Change AI model";
-declare const MODEL_COMMAND_ARGUMENT_HINT = "<model-id>";
-interface IModelCommandSettingsAdapter {
-  readMergedSettings(): TProviderSettingsDocument;
-}
-interface IModelCommandModuleOptions {
-  providerDefinitions: readonly IProviderDefinition[];
-  settings: IModelCommandSettingsAdapter;
-}
-interface IBuildModelCommandSubcommandsOptions {
-  source?: string;
-  providerDefinitions?: readonly IProviderDefinition[];
-  settings?: TProviderSettingsDocument;
-}
-interface IActiveProviderModelCatalogState {
-  providerType: string;
-  catalog?: IProviderModelCatalog;
-  refreshAttempted: boolean;
-  refreshMessage?: string;
-}
-interface IResolveActiveProviderModelCatalogStateOptions {
-  settings?: TProviderSettingsDocument;
-  providerDefinitions?: readonly IProviderDefinition[];
-  refresh?: boolean;
-}
-declare function buildModelCommandSubcommands(sourceOrOptions?: string | IBuildModelCommandSubcommandsOptions): ICommand[];
-declare function formatModelCommandUsageMessage(options?: {
-  settings?: TProviderSettingsDocument;
-  providerDefinitions?: readonly IProviderDefinition[];
-}): string;
-declare function formatModelCommandUsageMessageAsync(options?: IResolveActiveProviderModelCatalogStateOptions): Promise<string>;
-declare function resolveActiveProviderModelCatalog(settings: TProviderSettingsDocument | undefined, providerDefinitions?: readonly IProviderDefinition[]): IProviderModelCatalog | undefined;
-declare function resolveActiveProviderModelCatalogState(options: IResolveActiveProviderModelCatalogStateOptions): Promise<IActiveProviderModelCatalogState | undefined>;
-//#endregion
 //#region src/command-api/language/language-command-api.d.ts
 declare const LANGUAGE_COMMAND_DESCRIPTION = "Set response language";
 declare const LANGUAGE_COMMAND_ARGUMENT_HINT = "<code>";
@@ -1371,7 +1301,7 @@ declare const CLEAR_COMMAND_DESCRIPTION = "Clear conversation history";
 declare const RENAME_COMMAND_DESCRIPTION = "Rename the current session";
 declare const RENAME_COMMAND_USAGE = "Usage: rename <name>";
 declare const RESUME_COMMAND_DESCRIPTION = "Resume a previous session";
-declare const COST_COMMAND_DESCRIPTION = "Show session info";
+declare const COST_COMMAND_DESCRIPTION = "Show session token usage and estimated cost. /cost budget <amount> sets a monthly budget.";
 declare const VALIDATE_SESSION_COMMAND_DESCRIPTION = "Validate current session replay log";
 declare const EXIT_COMMAND_DESCRIPTION = "Exit CLI";
 interface ICommandSessionInfo {
@@ -1914,6 +1844,76 @@ interface ISkillActivationHistoryData extends ISkillActivationEvent {
   readonly message: string;
 }
 //#endregion
+//#region src/interactive/interactive-session-background-tracker.d.ts
+interface IBackgroundTrackerState {
+  tasks: IBackgroundTaskState[];
+  taskEvents: TBackgroundTaskEvent[];
+  groups: IBackgroundJobGroupState[];
+  groupEvents: TBackgroundJobGroupEvent[];
+}
+declare class SessionBackgroundTaskTracker {
+  private readonly getManager;
+  private readonly onChanged;
+  private readonly emitTaskEvent;
+  private readonly emitGroupEvent;
+  private readonly persistSession;
+  private backgroundTasks;
+  private backgroundTaskEvents;
+  private backgroundJobGroups;
+  private backgroundJobGroupEvents;
+  private backgroundTaskUnsubscribe;
+  private backgroundJobUnsubscribe;
+  private backgroundJobOrchestrator;
+  constructor(getManager: () => IBackgroundTaskManager | undefined, onChanged: (cause: TExecutionWorkspaceUpdateCause, entryId?: string) => void, emitTaskEvent: (event: TBackgroundTaskEvent) => void, emitGroupEvent: (event: TBackgroundJobGroupEvent) => void, persistSession: () => void);
+  subscribe(session: Session): void;
+  dispose(): void;
+  restoreState(state: IBackgroundTrackerState): void;
+  getState(): IBackgroundTrackerState;
+  getManagerOrThrow(): IBackgroundTaskManager;
+  getOrchestratorOrThrow(sessionId: string): BackgroundJobOrchestrator;
+  cancelTask(taskId: string, reason?: string): Promise<void>;
+  closeTask(taskId: string): Promise<void>;
+  sendTask(taskId: string, input: IBackgroundTaskInput): Promise<void>;
+  readTaskLog(taskId: string, cursor?: IBackgroundTaskLogCursor): Promise<IBackgroundTaskLogPage>;
+  listTasks(filter?: IBackgroundTaskListFilter): IBackgroundTaskState[];
+  getTask(taskId: string): IBackgroundTaskState | undefined;
+  createGroup(input: Omit<IBackgroundJobGroupCreateRequest, 'parentSessionId'>, sessionId: string): IBackgroundJobGroupState;
+  listGroups(sessionId: string): IBackgroundJobGroupState[];
+  getGroup(groupId: string, sessionId: string): IBackgroundJobGroupState | undefined;
+  waitGroup(groupId: string, sessionId: string): Promise<IBackgroundJobGroupState>;
+  readTaskDetail(entryId: string, taskId: string, cursor?: IExecutionDetailCursor): Promise<IExecutionDetailPage>;
+  readGroupDetail(entryId: string, groupId: string, sessionId: string): IExecutionDetailPage;
+  getTaskSnapshots(): IBackgroundTaskState[];
+  getGroupSnapshots(): IBackgroundJobGroupState[];
+  private subscribeGroupEvents;
+  private recordTaskEvent;
+  private recordGroupEvent;
+}
+//#endregion
+//#region src/tools/agent-tool.d.ts
+/** Dependencies injected at creation time via createAgentTool factory */
+interface IAgentToolDeps extends IInProcessSubagentRunnerDeps {
+  cwd?: string;
+  parentSessionId?: string;
+  subagentDepth?: number;
+  subagentManager?: ISubagentManager;
+  backgroundTaskManager?: IBackgroundTaskManager;
+  /** Optional custom agent registry for resolving non-built-in agent types. */
+  customAgentRegistry?: (name: string) => IAgentDefinition | undefined;
+  /** Model-visible and command-visible agent definitions available to this session. */
+  agentDefinitions?: IAgentDefinition[];
+}
+/** Store agent tool deps keyed by a session (or any object). */
+declare function storeAgentToolDeps(key: object, deps: IAgentToolDeps): void;
+/** Retrieve agent tool deps for a given session key. */
+declare function retrieveAgentToolDeps(key: object): IAgentToolDeps | undefined;
+/**
+ * Create an agent tool instance with deps captured in closure.
+ *
+ * Each session gets its own tool instance — no shared mutable state.
+ */
+declare function createAgentTool(deps: IAgentToolDeps): ReturnType<typeof createZodFunctionTool>;
+//#endregion
 //#region src/interactive/interactive-session-agent-jobs.d.ts
 interface ISpawnAgentJobInput {
   agentType: string;
@@ -2027,8 +2027,9 @@ declare function resolveSessionIdByIdOrName(sessionStore: IInteractiveSessionSto
 //#endregion
 //#region src/interactive/types.d.ts
 /** Permission handler result — SDK-owned type (mirrors agent-sessions TPermissionResult).
- *  true = allow, false = deny, 'allow-session' = allow and remember for this session. */
-type TPermissionResultValue = boolean | 'allow-session';
+ *  true = allow, false = deny, 'allow-session' = allow and remember for this session,
+ *  'allow-project' = allow and persist to .robota/settings.local.json. */
+type TPermissionResultValue = boolean | 'allow-session' | 'allow-project';
 /** Tool execution state visible to clients. */
 interface IToolState {
   toolName: string;
@@ -2038,6 +2039,7 @@ interface IToolState {
   diffLines?: IDiffLine[];
   diffFile?: string;
   toolResultData?: string;
+  executionId?: string;
 }
 /** A single diff line for Edit tool display. */
 interface IDiffLine {
@@ -2245,7 +2247,7 @@ interface ICreateSessionOptions {
   /** Callback when context window usage is refreshed */
   onContextUpdate?: (state: IContextWindowState) => void;
   /** Custom prompt-for-approval function (injected from CLI) */
-  promptForApproval?: (terminal: ITerminalOutput$1, toolName: string, toolArgs: TToolArgs) => Promise<boolean>;
+  promptForApproval?: (terminal: ITerminalOutput$1, toolName: string, toolArgs: TToolArgs) => Promise<TPermissionResult>;
   /** Additional tools to register beyond the defaults (e.g. agent-tool) */
   additionalTools?: IToolWithEventService[];
   /** Additional background task runners composed by the runtime shell. */
@@ -2262,6 +2264,7 @@ interface ICreateSessionOptions {
     success?: boolean;
     denied?: boolean;
     toolResultData?: string;
+    executionId?: string;
   }) => void;
   /** Callback when context is compacted */
   onCompact?: (summary: string) => void;
@@ -2287,6 +2290,10 @@ interface ICreateSessionOptions {
   sessionId?: string;
   /** Pre-approved tool names — added to permissions.allow as ToolName(*) patterns. */
   allowedTools?: string[];
+  /** Denied tool names — added to permissions.deny as ToolName(*) patterns. denied > allowed. */
+  deniedTools?: string[];
+  /** Override the model from config. When set, takes precedence over config.provider.model. */
+  model?: string;
   /** Text to append to the generated system prompt. */
   appendSystemPrompt?: string;
   /** Model command execution bridge. */
@@ -2303,6 +2310,10 @@ interface ICreateSessionOptions {
   sandboxClient?: ISandboxClient;
   /** Name reported to the underlying Robota agent config. Defaults to 'agent'. */
   agentName?: string;
+  /** Request structured output from the provider for this session. */
+  responseFormat?: {
+    type: 'text' | 'json_object';
+  };
 }
 //#endregion
 //#region src/assembly/create-tools.d.ts
@@ -2312,6 +2323,7 @@ interface ICreateSessionOptions {
  */
 interface ICreateDefaultToolsOptions {
   sandboxClient?: ISandboxClient;
+  cwd?: string;
 }
 declare function createDefaultTools(options?: ICreateDefaultToolsOptions): IToolWithEventService[];
 //#endregion
@@ -2393,6 +2405,10 @@ interface IInteractiveSessionStandardOptions {
   bare?: boolean;
   /** Pre-approved tool names passed to createSession. */
   allowedTools?: string[];
+  /** Denied tool names — added to permissions.deny. denied > allowed. */
+  deniedTools?: string[];
+  /** Override the model from config. When set, takes precedence over config.provider.model. */
+  model?: string;
   /** Text to append to the system prompt. */
   appendSystemPrompt?: string;
   /** Replace the entire system prompt with this string. Takes precedence over the default builder. */
@@ -2411,6 +2427,8 @@ interface IInteractiveSessionStandardOptions {
   shellExec?: TShellExecFn;
   /** Model-visible command descriptors derived from the composed command executor. */
   commandDescriptors?: readonly ICapabilityDescriptor[];
+  /** Provider definitions for hot-swap via /provider switch. */
+  providerDefinitions?: readonly import('@robota-sdk/agent-core').IProviderDefinition[];
   /** Model command execution bridge. */
   modelCommandExecutor?: (command: string, args: string) => Promise<ICommandResult | null>;
   /** Predicate for commands allowed through the model command execution bridge. */
@@ -2429,6 +2447,14 @@ interface IInteractiveSessionStandardOptions {
   sandboxSnapshotId?: string;
   /** Name reported to the underlying Robota agent config. Defaults to 'agent'. */
   agentName?: string;
+  /** Organization policy for enforcing provider restrictions, command blocks, and API key rules. */
+  orgPolicy?: IOrgPolicy;
+  /** Additional tools registered alongside the default CLI tools. */
+  additionalTools?: IToolWithEventService[];
+  /** Request structured output from the provider for this session. */
+  responseFormat?: {
+    type: 'text' | 'json_object';
+  };
 }
 /** Test/advanced construction: inject pre-built session directly. */
 interface IInteractiveSessionInjectedOptions {
@@ -2490,6 +2516,7 @@ declare class SessionSkillRouter {
     name: string;
     displayName?: string;
     description: string;
+    example?: string;
   }>;
   listSkills(): ICommandSkillListEntry[];
   listModelInvocableCommands(): Array<{
@@ -2542,6 +2569,7 @@ declare class SessionExecutionController {
     success?: boolean;
     denied?: boolean;
     toolResultData?: string;
+    executionId?: string;
   }): void;
   emitExecutionWorkspaceUpdated(cause: TExecutionWorkspaceUpdateCause, entryId?: string): void;
   private drainPendingQueue;
@@ -2573,6 +2601,7 @@ declare abstract class InteractiveSessionBase {
     name: string;
     displayName?: string;
     description: string;
+    example?: string;
   }>;
   listSkills(): ICommandSkillListEntry[];
   listModelInvocableCommands(): Array<{
@@ -2698,6 +2727,8 @@ declare class InteractiveSession extends InteractiveSessionBase implements ISess
   private agentsFileEntries;
   private claudeFileEntries;
   private rebuildSystemMessage;
+  private providerDefinitions;
+  private orgPolicy;
   protected readonly bgTracker: SessionBackgroundTaskTracker;
   protected readonly histTracker: SessionHistoryTracker;
   protected readonly skillRouter: SessionSkillRouter;
@@ -2730,6 +2761,8 @@ declare class InteractiveSession extends InteractiveSessionBase implements ISess
   private getBackgroundTaskManager;
   private captureSandboxSnapshot;
   private persistCurrentSession;
+  private switchProvider;
+  executeCommand(name: string, args: string): Promise<ICommandResult | null>;
 }
 //#endregion
 //#region src/query.d.ts
@@ -2746,7 +2779,15 @@ interface ICreateQueryOptions {
   permissionHandler?: TInteractivePermissionHandler;
   /** Streaming text callback. */
   onTextDelta?: (delta: string) => void;
+  /** Additional tools registered alongside the default CLI tools. */
+  additionalTools?: IToolWithEventService[];
+  /** Request structured output from the provider. */
+  responseFormat?: {
+    type: 'text' | 'json_object';
+  };
 }
+/** Type of the function returned by createQuery(). */
+type TQueryFunction = (prompt: string) => Promise<string>;
 /**
  * Create a prompt-only query function bound to a provider.
  *
@@ -2917,12 +2958,14 @@ declare function createCommandExecutionTool(deps: ICommandExecutionToolDeps): Re
 //#region src/tools/model-command-tool-projection.d.ts
 declare const MODEL_COMMAND_TOOL_PREFIX: "robota_command_";
 declare const PROVIDER_SAFE_TOOL_NAME_PATTERN: RegExp;
-type TModelCommandDescriptor = Pick<ICapabilityDescriptor, 'name' | 'description' | 'argumentHint'>;
+type TModelCommandDescriptor = Pick<ICapabilityDescriptor, 'name' | 'description' | 'argumentHint' | 'requiresPermission'>;
 interface IProjectedModelCommandTool {
   readonly commandName: string;
   readonly toolName: string;
   readonly description: string;
   readonly descriptor: TModelCommandDescriptor;
+  /** Mirrors the source command's requiresPermission flag. false = auto-approved. */
+  readonly requiresPermission: boolean;
 }
 interface IModelCommandToolProjection {
   readonly commandTools: readonly IProjectedModelCommandTool[];
@@ -2969,6 +3012,7 @@ declare function projectPaths(cwd: string): {
 declare function userPaths(): {
   settings: string;
   sessions: string;
+  onboarded: string;
 };
 //#endregion
 //#region src/context/task-context.d.ts
@@ -3000,7 +3044,7 @@ declare function loadTaskContext(cwd: string, options?: ITaskSelectionOptions, f
 declare function updateTaskFileStatus(taskPath: string, status: TTaskFileStatus, options?: IUpdateTaskFileStatusOptions, fs?: IFileSystem): void;
 //#endregion
 //#region src/permissions/permission-prompt.d.ts
-declare function promptForApproval(terminal: ITerminalOutput$2, toolName: string, toolArgs: TToolArgs): Promise<boolean>;
+declare function promptForApproval(terminal: ITerminalOutput$2, toolName: string, toolArgs: TToolArgs): Promise<TPermissionResultValue>;
 //#endregion
 //#region src/testing/create-test-interactive-session.d.ts
 /** Creates a stub IInteractiveSession for use in tests. All methods return sensible defaults.
@@ -3024,46 +3068,6 @@ declare function resolveGitBranch(cwd: string): string | undefined;
 declare function compareSemverVersions(left: string, right: string): number;
 declare function isNewerSemverVersion(candidate: string, current: string): boolean;
 //#endregion
-//#region src/runtime/agent-runtime.d.ts
-interface IAgentRuntimeConfig {
-  cwd: string;
-  provider: IAIProvider;
-  commandModules?: readonly ICommandModule[];
-  commandHostAdapters?: ICommandHostAdapters;
-  backgroundTaskRunners?: IBackgroundTaskRunner$1[];
-  subagentRunnerFactory?: TSubagentRunnerFactory;
-  sessionStore?: IInteractiveSessionStore;
-  transportRegistry?: ITransportRegistryView<IInteractiveSession>;
-  reloadPluginCommandSource?: (registry: CommandRegistry) => void;
-}
-/** Session-specific options for IAgentRuntime.createSession(). Runtime fields (cwd, provider, etc.) are inherited automatically. */
-interface IHeadlessSessionOptions {
-  permissionMode?: TPermissionMode;
-  maxTurns?: number;
-  sessionStore?: IInteractiveSessionStore;
-  sessionName?: string;
-  bare?: boolean;
-  allowedTools?: string[];
-  appendSystemPrompt?: string;
-  /** Replace the entire system prompt. Takes precedence over the default builder. */
-  systemPrompt?: string;
-  shellExec?: TShellExecFn;
-  agentName?: string;
-}
-interface IAgentRuntime {
-  readonly cwd: string;
-  readonly provider: IAIProvider;
-  readonly commandModules: readonly ICommandModule[];
-  readonly commandHostAdapters: ICommandHostAdapters;
-  readonly backgroundTaskRunners: IBackgroundTaskRunner$1[];
-  readonly subagentRunnerFactory: TSubagentRunnerFactory | undefined;
-  readonly sessionStore: IInteractiveSessionStore | undefined;
-  readonly transportRegistry: ITransportRegistryView<IInteractiveSession> | undefined;
-  readonly reloadPluginCommandSource: (registry: CommandRegistry) => void;
-  createSession(opts: IHeadlessSessionOptions): InteractiveSession;
-}
-declare function createAgentRuntime(config: IAgentRuntimeConfig): IAgentRuntime;
-//#endregion
 //#region src/utils/read-package-version.d.ts
 declare function readPackageVersion(importMetaUrl: string): string;
 //#endregion
@@ -3123,5 +3127,66 @@ declare function shouldRunStartupCliUpdateCheck(input: IStartupCliUpdatePolicyIn
 declare function formatCliUpdateNotice(notice: ICliUpdateNotice): string;
 declare function formatCliUpdateCheckMessage(result: TCliUpdateCheckResult): string;
 //#endregion
-export { AUTO_COMPACT_THRESHOLD_SETTINGS_KEY, AgentExecutor, BACKGROUND_COMMAND_DESCRIPTION, BACKGROUND_COMMAND_USAGE, BUILT_IN_AGENTS, BackgroundJobOrchestrator, BuiltinCommandSource, BundlePluginInstaller, BundlePluginLoader, CLEAR_COMMAND_DESCRIPTION, CLI_UPDATE_CACHE_TTL_MS, CLI_UPDATE_PACKAGE_NAME, CLI_UPDATE_REGISTRY_URL, CLI_UPDATE_TIMEOUT_MS, COST_COMMAND_DESCRIPTION, CommandRegistry, DEFAULT_AUTO_COMPACT_THRESHOLD, DEFAULT_STATUS_LINE_COMMAND_SETTINGS, EXECUTION_ORIGIN_METADATA_KEYS, EXIT_COMMAND_DESCRIPTION, EditCheckpointStore, HELP_COMMAND_DESCRIPTION, type IActiveModelChangeOptions, type IActiveModelChangeResult, type IActiveProviderModelCatalogState, type IAgentBackgroundTaskRequest, type IAgentDefinition, type IAgentExecutorOptions, type IAgentJobHostContext, type IAgentRuntime, type IAgentRuntimeConfig, type IAgentSession, type IAgentToolDeps, type IAppendMemoryInput, type IAppendMemoryResult, type IBackgroundJobGroupCreateRequest, type IBackgroundJobGroupState, type IBackgroundJobGroupSummary, type IBackgroundJobOrchestratorOptions, type IBackgroundJobResultEnvelope, type IBackgroundProcessToolDeps, type IBackgroundTaskError, type IBackgroundTaskHandle, type IBackgroundTaskInput, type IBackgroundTaskListFilter, type IBackgroundTaskLogCursor, type IBackgroundTaskLogPage, type IBackgroundTaskManager, type IBackgroundTaskManagerOptions, type IBackgroundTaskResult, type IBackgroundTaskRunner, type IBackgroundTaskSpawnerGroupRequest, type IBackgroundTaskStart, type IBackgroundTaskState, type IBaseBackgroundTaskRequest, type IBuildModelCommandSubcommandsOptions, type IBundlePluginFeatures, type IBundlePluginInstallerOptions, type IBundlePluginManifest, type IBundleSkill, type ICapabilityDescriptor, type ICheckForCliUpdateOptions, type ICliUpdateNotice, type ICommand, type ICommandAvailablePlugin, type ICommandChoicePromptOption, type ICommandExecutionToolDeps, type ICommandHostAdapters, type ICommandHostContext, type ICommandInstalledPlugin, type ICommandInteraction, type ICommandListEntry, type ICommandMarketplaceSource, type ICommandMemoryStores, type ICommandModule, type ICommandPendingMemoryStore, type ICommandPermissionModeAdapter, type ICommandPickerAdapter, type ICommandPluginAdapter, type ICommandPluginReloadResult, type ICommandProcessAdapter, type ICommandProjectMemoryStore, type ICommandResult, type ICommandSessionInfo, type ICommandSessionReplayValidationReport, type ICommandSessionRuntime, type ICommandSettingsAdapter, type ICommandSettingsDocument, type ICommandSkillListEntry, type ICommandSource, type ICompactContextResult, type IConfigurableTransport, type IContextFileRefreshedEvent, type IContextReferenceAddResult, type IContextReferenceClearResult, type IContextReferenceInventoryLimits, type IContextReferenceItem, type IContextReferenceRemoveResult, type IContextReferenceUpsertResult, type ICreateExecutionWorkspaceSnapshotInput, type ICreateExecutionWorkspaceTaskSpawnerOptions, type ICreateLimitedOutputCaptureOptions, type ICreateLineDetailPageInput, type ICreateMainThreadDetailPageInput, type ICreateMainThreadEntryInput, type ICreateQueryOptions, type IDiffLine, type IEditCheckpointFileInspection, type IEditCheckpointFileRecord, type IEditCheckpointInspection, type IEditCheckpointInspectionPlan, type IEditCheckpointManifest, type IEditCheckpointRecorder, type IEditCheckpointRestoreResult, type IEditCheckpointSummary, type IEditCheckpointTurnInput, type IExecutionDetailCursor, type IExecutionDetailPage, type IExecutionDetailRecord, type IExecutionOrigin, type IExecutionResult, type IExecutionWorkspaceEntry, type IExecutionWorkspaceEntryRef, type IExecutionWorkspaceEvent, type IExecutionWorkspaceFilter, type IExecutionWorkspaceSnapshot, type IExecutionWorkspaceSnapshotOptions, type IExecutionWorkspaceTaskSpawner, type IForkExecutionOptions, type IHeadlessSessionOptions, type IInProcessSubagentRunnerDeps, type IInspectUserLocalStorageOptions, type IInstalledPluginRecord, type IInteractiveSession, type IInteractiveSessionEvents, type IInteractiveSessionRecord, type IInteractiveSessionShutdownOptions, type IInteractiveSessionStore, type IKnownMarketplaceEntry, type ILegacyProviderSettings, type ILimitedOutputCapture, type ILoadedBundlePlugin, type IMarketplaceClientOptions, type IMarketplaceManifest, type IMarketplacePluginEntry, type IMemoryCandidate, type IMemoryEvent, type IMemoryPendingRecord, type IMemoryReference, type IModelCommandModuleOptions, type IModelCommandSettingsAdapter, type IModelCommandToolProjection, type IPermissionsCommandState, type IPluginSettings, type IPreparedSubagentWorktree, type IProcessBackgroundTaskRequest, type IProjectMemorySummary, type IProjectedCommandExecutionToolsDeps, type IProjectedModelCommandTool, type IPromptExecutorOptions, type IPromptFileReferenceDiagnostic, type IPromptFileReferenceHistoryData, type IPromptFileReferenceLimits, type IPromptFileReferenceRecord, type IPromptFileReferenceResolveOptions, type IPromptFileReferenceToken, type IPromptProvider, type IProviderCommandModuleOptions, type IProviderCommandSettingsAdapter, type IProviderProfileNameSuggestionInput, type IProviderProfileNameSuggestionOptions, type IProviderProfileSettings, type IProviderSettingsBuildOptions, type IProviderSettingsWriteTargetOptions, type IProviderSetupInput, type IProviderSetupPatch, type IProviderSwitchOptions, type IReadProviderSettingsOptions, type IResetUserConfigResult, type IResolveActiveProviderModelCatalogStateOptions, type IResolveUserLocalStorageRootOptions, type IResolvedPromptFileReference, type IResolvedPromptFileReferences, type IResumableSessionSummary, type IReversibleExecutionOptions, type IReversibleToolSafetyContext, type IReversibleToolSafetyInput, type IReversibleToolSafetyReport, type ISelfHostingVerificationPlan, type ISelfHostingVerificationPlanInput, type ISelfHostingVerificationStep, type ISerializableProviderProfile, type ISkillActivationEvent, type ISkillActivationHistoryData, type ISkillExecutionCallbacks, type ISkillExecutionResult, type ISpawnAgentTaskRequest, type ISpawnProcessTaskRequest, type IStartupCliUpdatePolicyInput, type IStartupMemory, type IStatusLineCommandSettings, type ISubagentJobHandle, type ISubagentJobResult, type ISubagentJobStart, type ISubagentJobState, type ISubagentManager, type ISubagentManagerOptions, type ISubagentOptions, type ISubagentPromptOptions, type ISubagentRunner, type ISubagentSpawnRequest, type ISubagentWorktreeAdapter, type ISubagentWorktreePrepareRequest, type ISystemCommand, type ITaskContextFile, type ITaskSelectionOptions, type IToolState, type IToolSummary, type ITransportAdapter, type ITransportConfig, type IUpdateCheckCache, type IUpdateTaskFileStatusOptions, type IUsageSnapshot, type IUserLocalMemoryDeleteResult, type IUserLocalMemoryItemOptions, type IUserLocalMemoryItemProjection, type IUserLocalMemoryListOptions, type IUserLocalMemoryListProjection, type IUserLocalMemorySetOptions, type IUserLocalStorageCategoryDefinition, type IUserLocalStorageCategoryProjection, type IUserLocalStorageInspection, type IUserLocalStorageItemSummary, type IWorktreeSubagentRunnerOptions, InteractiveSession, LANGUAGE_COMMAND_ARGUMENT_HINT, LANGUAGE_COMMAND_DESCRIPTION, MEMORY_COMMAND_ARGUMENT_HINT, MEMORY_COMMAND_DESCRIPTION, MEMORY_COMMAND_USAGE, MEMORY_INDEX_MAX_BYTES, MEMORY_INDEX_MAX_LINES, MODEL_COMMAND_ARGUMENT_HINT, MODEL_COMMAND_DESCRIPTION, MODEL_COMMAND_TOOL_PREFIX, MarketplaceClient, PERMISSIONS_COMMAND_DESCRIPTION, PERMISSION_MODE_ARGUMENT_HINT, PERMISSION_MODE_COMMAND_DESCRIPTION, PLUGIN_COMMAND_ARGUMENT_HINT, PLUGIN_COMMAND_DESCRIPTION, PROVIDER_SAFE_TOOL_NAME_PATTERN, PluginCommandSource, PluginSettingsStore, ProjectMemoryStore, PromptExecutor, RECOMMENDED_RESPONSE_LANGUAGES, RELOAD_PLUGINS_COMMAND_DESCRIPTION, RENAME_COMMAND_DESCRIPTION, RENAME_COMMAND_USAGE, RESUME_COMMAND_DESCRIPTION, REWIND_COMMAND_ARGUMENT_HINT, REWIND_COMMAND_DESCRIPTION, STATUSLINE_COMMAND_ARGUMENT_HINT, STATUSLINE_COMMAND_DESCRIPTION, SkillCommandSource, type SkillPromptContext, SystemCommandExecutor, type TAutoCompactThreshold, type TAutoCompactThresholdSource, type TBackgroundJobGroupEvent, type TBackgroundJobGroupEventListener, type TBackgroundJobGroupIdFactory, type TBackgroundJobGroupStatus, type TBackgroundJobWaitPolicy, type TBackgroundPermissionPolicy, type TBackgroundPrimitive, type TBackgroundTaskErrorCategory, type TBackgroundTaskEvent, type TBackgroundTaskEventListener, type TBackgroundTaskIdFactory, type TBackgroundTaskIsolation, type TBackgroundTaskKind, type TBackgroundTaskMode, type TBackgroundTaskRequest, type TBackgroundTaskRunnerEvent, type TBackgroundTaskStatus, type TBackgroundTaskTimeoutReason, type TBackgroundTaskTransitionEvent, type TCapabilityKind, type TCapabilitySafety, type TCliUpdateCheckResult, type TCommandEffect, type TCommandInteractionPrompt, type TCommandModuleSessionRequirement, type TCommandResultDataValue, type TContextReferenceLoadType, type TContextReferenceStatus, type TEditCheckpointFileRestoreAction, type TEnabledPlugins, type TExecutionAttention, type TExecutionControl, type TExecutionDetailRecordKind, type TExecutionEntryKind, type TExecutionOriginKind, type TExecutionWorkspaceStatus, type TExecutionWorkspaceUpdateCause, type TExecutionWorkspaceVisibility, type TInstalledPluginsRegistry, type TInteractiveEventName, type TInteractivePermissionHandler, type TInteractiveSessionOptions, type TKnownMarketplacesRegistry, type TMarketplaceSource, type TMemoryCandidateStatus, type TMemoryType, type TPermissionResultValue, type TPluginInstallScope, type TPromptFileReferenceDiagnosticCode, type TPromptFileReferenceReason, type TProviderFactory, type TProviderSettingsDocument, type TRecommendedResponseLanguage, type TReversibleExecutionIsolation, type TReversibleRollbackLayer, type TReversibleSafetyStatus, type TReversibleSideEffect, type TSelfHostingLoopEvent, type TSelfHostingLoopState, type TSelfHostingVerificationPhase, type TSessionFactory, type TSettingsCheck, type TSettingsData, type TSettingsScope, type TShellExecFn, type TSkillActivationInvocation, type TSkillActivationMode, type TSkillActivationSource, type TSkillActivationStatus, type TStatusLineCommandSettingsPatch, type TSubagentJobMode, type TSubagentJobStatus, type TSubagentRunnerFactory, type TSystemCommandLifecycle, type TTaskFileStatus, type TUserLocalMemoryCategory, type TUserLocalMemoryCommandExecutionEffect, type TUserLocalStorageCategory, USER_LOCAL_MEMORY_CATEGORIES, USER_LOCAL_STORAGE_CATEGORIES, USER_LOCAL_STORAGE_CATEGORY_DEFINITIONS, VALIDATE_SESSION_COMMAND_DESCRIPTION, VALID_PERMISSION_MODES, addCommandContextReference, applyActiveModelChange, applyProviderConfiguration, applyProviderSwitch, applyStatusLineSettings, assembleSubagentPrompt, buildBackgroundCommandSubcommands, buildLanguageCommandSubcommands, buildMemoryCommandSubcommands, buildModelCommandSubcommands, buildPermissionModeSubcommands, buildPluginCommandSubcommands, buildPromptWithFileReferences, buildProviderProfile, buildProviderSetupPatch, buildRewindCommandSubcommands, buildStatusLineCommandSubcommands, cancelCommandBackgroundTask, checkForCliUpdate, checkSettingsDocument, checkSettingsFile, clearCommandContextReferences, clearContextReferences, clearConversationHistory, closeCommandBackgroundTask, compactCommandContext, compareSemverVersions, createAgentRuntime, createAgentTool, createBackgroundGroupExecutionEntryId, createBackgroundProcessTool, createBackgroundTaskExecutionEntryId, createBuiltinCommandModule, createCommandExecutionTool, createCommandMemoryStores, createCommandPendingMemoryStore, createCommandProjectMemoryStore, createContextReferenceItem, createDefaultTools, createExecutionOriginMetadata, createExecutionWorkspaceSnapshot, createExecutionWorkspaceTaskSpawner, createInProcessSubagentRunner, createLineDetailPage, createMainThreadDetailPage, createMainThreadExecutionEntryId, createModelCommandToolProjection, createPluginRegistryReloadRequestedEffect, createPluginTuiRequestedEffect, createProjectSessionStore, createProjectedCommandExecutionTools, createPromptFileReferenceHistoryEntry, createProviderFromSettings, createProviderSafeModelCommandToolName, createQuery, createSessionExitRequestedEffect, createSessionPickerRequestedEffect, createSessionRenamedEffect, createSubagentLogger, createSubagentSession, createSystemCommands, createTestInteractiveSession, deleteProviderProfile, deleteSettings, deleteUserLocalMemoryItem, disableUserLocalMemoryItem, discoverTaskFiles, evaluateReversibleToolSafety, executeSkill, formatCliUpdateCheckMessage, formatCliUpdateNotice, formatCommandBackgroundTask, formatCommandBackgroundTaskList, formatCommandHelpMessage, formatCommandPermissionsMessage, formatCommandSessionReplayValidationReport, formatEnvReference, formatInvalidPermissionModeMessage, formatLanguageUsageMessage, formatModelCommandUsageMessage, formatModelCommandUsageMessageAsync, formatProjectedModelCommandToolPromptDescription, formatPromptFileReferenceDiagnostics, formatTaskContext, getBuiltInAgent, getForkWorkerSuffix, getProviderSettingsPaths, getStartupCliUpdateNotice, getSubagentSuffix, getUserSettingsPath, getUserUpdateCheckCachePath, hasBlockingPromptFileReferenceDiagnostics, hasSensitiveCommandMemoryContent, hasUsableSecretReference, inspectCommandEditCheckpoint, inspectUserLocalMemoryItem, inspectUserLocalStorage, isCommandMemoryType, isEnvReference, isMemoryType, isNewerSemverVersion, isPermissionMode, isStatusLineCommandSettingsPatch, listActiveContextReferences, listCommandBackgroundTasks, listCommandContextReferences, listCommandEditCheckpoints, listCommandSessionAllowedTools, listCommandUsedMemoryReferences, listResumableSessionSummaries, listUserLocalMemoryItems, loadTaskContext, mergeProviderPatch, mergeProviders, mergeSettings, normalizeModelCommandName, parseCommandBackgroundLogCursor, parseExecutionWorkspaceEntryId, parseFrontmatter, parseLanguageArgument, parsePermissionModeArgument, parsePromptFileReferences, parseSessionNameArgument, parseTaskFile, planSelfHostingVerification, preprocessShellCommands, probeProviderProfile, projectPaths, promptForApproval, readAutoCompactThreshold, readAutoCompactThresholdSource, readCommandBackgroundTaskLog, readCommandContextState, readCommandPermissionMode, readCommandPermissionsState, readCommandSessionInfo, readCurrentGitBranch, readEnabledUserLocalMemoryItem, readMergedProviderSettings, readMergedProviderSettingsFromPaths, readPackageVersion, readProviderSettings, readSettings, readStatusLineSettings, readUpdateCheckCache, recordCommandMemoryEvent, removeCommandContextReference, removeContextReference, resetAutoCompactThresholdSetting, resetUserConfig, resolveActiveProvider, resolveActiveProviderModelCatalog, resolveActiveProviderModelCatalogState, resolveEnvReference, resolveGitBranch, resolveLatestSessionId, resolvePermissionModeAdapter, resolvePluginCommandAdapter, resolvePromptFileReferencePaths, resolvePromptFileReferences, resolveProviderSettingsWriteTargetPath, resolveSessionIdByIdOrName, resolveSettingsPathForScope, resolveSubagentLogDir, resolveUserLocalStorageRoot, restoreCommandEditCheckpoint, retrieveAgentToolDeps, rollbackCommandEditCheckpoint, sanitizeProviderProfileName, selectRelevantTasks, setCommandAutoCompactThreshold, setCurrentProvider, setUserLocalMemoryItem, shouldRunStartupCliUpdateCheck, storeAgentToolDeps, substituteVariables, suggestProviderProfileName, summarizeBackgroundJobGroup, testProviderProfileCommand, toContextReferenceRecords, toPromptFileReferenceRecords, transitionSelfHostingLoop, updateModelInSettings, updateTaskFileStatus, upsertContextReference, upsertProviderProfile, userPaths, validateCommandSessionReplayLog, validateProviderProfile, wrapEditCheckpointTools, wrapReversibleExecutionTools, writeAutoCompactThresholdSetting, writeCommandPermissionMode, writeSettings, writeUpdateCheckCache };
+//#region src/runtime/agent-runtime.d.ts
+interface IAgentRuntimeConfig {
+  cwd: string;
+  provider: IAIProvider;
+  commandModules?: readonly ICommandModule[];
+  commandHostAdapters?: ICommandHostAdapters;
+  backgroundTaskRunners?: IBackgroundTaskRunner$1[];
+  subagentRunnerFactory?: TSubagentRunnerFactory;
+  sessionStore?: IInteractiveSessionStore;
+  transportRegistry?: ITransportRegistryView<IInteractiveSession>;
+  reloadPluginCommandSource?: (registry: CommandRegistry) => void;
+  orgPolicy?: IOrgPolicy;
+}
+/** Session-specific options for IAgentRuntime.createSession(). Runtime fields (cwd, provider, etc.) are inherited automatically. */
+interface IHeadlessSessionOptions {
+  permissionMode?: TPermissionMode;
+  maxTurns?: number;
+  sessionStore?: IInteractiveSessionStore;
+  sessionName?: string;
+  bare?: boolean;
+  allowedTools?: string[];
+  /** Denied tool names — added to permissions.deny. denied > allowed. */
+  deniedTools?: string[];
+  /** Override the model from config. When set, takes precedence over config.provider.model. */
+  model?: string;
+  appendSystemPrompt?: string;
+  /** Replace the entire system prompt. Takes precedence over the default builder. */
+  systemPrompt?: string;
+  shellExec?: TShellExecFn;
+  agentName?: string;
+  /** Additional tools registered alongside the default CLI tools. */
+  additionalTools?: IToolWithEventService[];
+  /** Resume an existing persisted session by ID. Requires sessionStore to be configured. */
+  resumeSessionId?: string;
+  /** Request structured output from the provider for this session. */
+  responseFormat?: {
+    type: 'text' | 'json_object';
+  };
+}
+interface IAgentRuntime {
+  readonly cwd: string;
+  readonly provider: IAIProvider;
+  readonly commandModules: readonly ICommandModule[];
+  readonly commandHostAdapters: ICommandHostAdapters;
+  readonly backgroundTaskRunners: IBackgroundTaskRunner$1[];
+  readonly subagentRunnerFactory: TSubagentRunnerFactory | undefined;
+  readonly sessionStore: IInteractiveSessionStore | undefined;
+  readonly transportRegistry: ITransportRegistryView<IInteractiveSession> | undefined;
+  readonly reloadPluginCommandSource: (registry: CommandRegistry) => void;
+  createSession(opts: IHeadlessSessionOptions): InteractiveSession;
+}
+declare function createAgentRuntime(config: IAgentRuntimeConfig): IAgentRuntime;
+//#endregion
+//#region src/runtime/stateless-runtime.d.ts
+interface IStatelessRuntimeConfig {
+  provider: IAIProvider;
+  /** Working directory. Defaults to process.cwd(). Not used for file I/O in stateless mode. */
+  cwd?: string;
+}
+declare function createStatelessRuntime(config: IStatelessRuntimeConfig): IAgentRuntime;
+//#endregion
+export { AUTO_COMPACT_THRESHOLD_SETTINGS_KEY, AgentExecutor, BACKGROUND_COMMAND_DESCRIPTION, BACKGROUND_COMMAND_USAGE, BUILT_IN_AGENTS, BackgroundJobOrchestrator, BuiltinCommandSource, BundlePluginInstaller, BundlePluginLoader, CLEAR_COMMAND_DESCRIPTION, CLI_UPDATE_CACHE_TTL_MS, CLI_UPDATE_PACKAGE_NAME, CLI_UPDATE_REGISTRY_URL, CLI_UPDATE_TIMEOUT_MS, COST_COMMAND_DESCRIPTION, CommandRegistry, DEFAULT_AUTO_COMPACT_THRESHOLD, DEFAULT_STATUS_LINE_COMMAND_SETTINGS, EXECUTION_ORIGIN_METADATA_KEYS, EXIT_COMMAND_DESCRIPTION, EditCheckpointStore, HELP_COMMAND_DESCRIPTION, type IActiveModelChangeOptions, type IActiveModelChangeResult, type IAgentBackgroundTaskRequest, type IAgentDefinition, type IAgentExecutorOptions, type IAgentJobHostContext, type IAgentRuntime, type IAgentRuntimeConfig, type IAgentSession, type IAgentToolDeps, type IAppendMemoryInput, type IAppendMemoryResult, type IBackgroundJobGroupCreateRequest, type IBackgroundJobGroupState, type IBackgroundJobGroupSummary, type IBackgroundJobOrchestratorOptions, type IBackgroundJobResultEnvelope, type IBackgroundProcessToolDeps, type IBackgroundTaskError, type IBackgroundTaskHandle, type IBackgroundTaskInput, type IBackgroundTaskListFilter, type IBackgroundTaskLogCursor, type IBackgroundTaskLogPage, type IBackgroundTaskManager, type IBackgroundTaskManagerOptions, type IBackgroundTaskResult, type IBackgroundTaskRunner, type IBackgroundTaskSpawnerGroupRequest, type IBackgroundTaskStart, type IBackgroundTaskState, type IBaseBackgroundTaskRequest, type IBundlePluginFeatures, type IBundlePluginInstallerOptions, type IBundlePluginManifest, type IBundleSkill, type ICapabilityDescriptor, type ICheckForCliUpdateOptions, type ICliUpdateNotice, type ICommand, type ICommandAvailablePlugin, type ICommandChoicePromptOption, type ICommandExecutionToolDeps, type ICommandHostAdapters, type ICommandHostContext, type ICommandInstalledPlugin, type ICommandInteraction, type ICommandListEntry, type ICommandMarketplaceSource, type ICommandMemoryStores, type ICommandModule, type ICommandPendingMemoryStore, type ICommandPermissionModeAdapter, type ICommandPickerAdapter, type ICommandPluginAdapter, type ICommandPluginReloadResult, type ICommandProcessAdapter, type ICommandProjectMemoryStore, type ICommandResult, type ICommandSessionInfo, type ICommandSessionReplayValidationReport, type ICommandSessionRuntime, type ICommandSettingsAdapter, type ICommandSettingsDocument, type ICommandSkillListEntry, type ICommandSource, type ICompactContextResult, type IConfigurableTransport, type IContextFileRefreshedEvent, type IContextReferenceAddResult, type IContextReferenceClearResult, type IContextReferenceInventoryLimits, type IContextReferenceItem, type IContextReferenceRemoveResult, type IContextReferenceUpsertResult, type ICreateExecutionWorkspaceSnapshotInput, type ICreateExecutionWorkspaceTaskSpawnerOptions, type ICreateLimitedOutputCaptureOptions, type ICreateLineDetailPageInput, type ICreateMainThreadDetailPageInput, type ICreateMainThreadEntryInput, type ICreateQueryOptions, type IDiffLine, type IEditCheckpointFileInspection, type IEditCheckpointFileRecord, type IEditCheckpointInspection, type IEditCheckpointInspectionPlan, type IEditCheckpointManifest, type IEditCheckpointRecorder, type IEditCheckpointRestoreResult, type IEditCheckpointSummary, type IEditCheckpointTurnInput, type IExecutionDetailCursor, type IExecutionDetailPage, type IExecutionDetailRecord, type IExecutionOrigin, type IExecutionResult, type IExecutionWorkspaceEntry, type IExecutionWorkspaceEntryRef, type IExecutionWorkspaceEvent, type IExecutionWorkspaceFilter, type IExecutionWorkspaceSnapshot, type IExecutionWorkspaceSnapshotOptions, type IExecutionWorkspaceTaskSpawner, type IForkExecutionOptions, type IHeadlessSessionOptions, type IInProcessSubagentRunnerDeps, type IInspectUserLocalStorageOptions, type IInstalledPluginRecord, type IInteractiveSession, type IInteractiveSessionEvents, type IInteractiveSessionRecord, type IInteractiveSessionShutdownOptions, type IInteractiveSessionStore, type IKnownMarketplaceEntry, type ILegacyProviderSettings, type ILimitedOutputCapture, type ILoadedBundlePlugin, type IMarketplaceClientOptions, type IMarketplaceManifest, type IMarketplacePluginEntry, type IMemoryCandidate, type IMemoryEvent, type IMemoryPendingRecord, type IMemoryReference, type IModelCommandToolProjection, type IOrgPolicy, type IPermissionsCommandState, type IPluginSettings, type IPreparedSubagentWorktree, type IProcessBackgroundTaskRequest, type IProjectMemorySummary, type IProjectedCommandExecutionToolsDeps, type IProjectedModelCommandTool, type IPromptExecutorOptions, type IPromptFileReferenceDiagnostic, type IPromptFileReferenceHistoryData, type IPromptFileReferenceLimits, type IPromptFileReferenceRecord, type IPromptFileReferenceResolveOptions, type IPromptFileReferenceToken, type IPromptProvider, type IProviderCommandModuleOptions, type IProviderCommandSettingsAdapter, type IProviderProfileNameSuggestionInput, type IProviderProfileNameSuggestionOptions, type IProviderProfileSettings, type IProviderSettingsBuildOptions, type IProviderSettingsWriteTargetOptions, type IProviderSetupInput, type IProviderSetupPatch, type IProviderSwitchOptions, type IReadProviderSettingsOptions, type IResetUserConfigResult, type IResolveUserLocalStorageRootOptions, type IResolvedConfig, type IResolvedPromptFileReference, type IResolvedPromptFileReferences, type IResumableSessionSummary, type IReversibleExecutionOptions, type IReversibleToolSafetyContext, type IReversibleToolSafetyInput, type IReversibleToolSafetyReport, type ISelfHostingVerificationPlan, type ISelfHostingVerificationPlanInput, type ISelfHostingVerificationStep, type ISerializableProviderProfile, type ISkillActivationEvent, type ISkillActivationHistoryData, type ISkillExecutionCallbacks, type ISkillExecutionResult, type ISpawnAgentTaskRequest, type ISpawnProcessTaskRequest, type IStartupCliUpdatePolicyInput, type IStartupMemory, type IStatelessRuntimeConfig, type IStatusLineCommandSettings, type ISubagentJobHandle, type ISubagentJobResult, type ISubagentJobStart, type ISubagentJobState, type ISubagentManager, type ISubagentManagerOptions, type ISubagentOptions, type ISubagentPromptOptions, type ISubagentRunner, type ISubagentSpawnRequest, type ISubagentWorktreeAdapter, type ISubagentWorktreePrepareRequest, type ISystemCommand, type ITaskContextFile, type ITaskSelectionOptions, type IToolState, type IToolSummary, type ITransportAdapter, type ITransportConfig, type IUpdateCheckCache, type IUpdateTaskFileStatusOptions, type IUsageSnapshot, type IUserLocalMemoryDeleteResult, type IUserLocalMemoryItemOptions, type IUserLocalMemoryItemProjection, type IUserLocalMemoryListOptions, type IUserLocalMemoryListProjection, type IUserLocalMemorySetOptions, type IUserLocalStorageCategoryDefinition, type IUserLocalStorageCategoryProjection, type IUserLocalStorageInspection, type IUserLocalStorageItemSummary, type IWorktreeSubagentRunnerOptions, InteractiveSession, LANGUAGE_COMMAND_ARGUMENT_HINT, LANGUAGE_COMMAND_DESCRIPTION, MEMORY_COMMAND_ARGUMENT_HINT, MEMORY_COMMAND_DESCRIPTION, MEMORY_COMMAND_USAGE, MEMORY_INDEX_MAX_BYTES, MEMORY_INDEX_MAX_LINES, MODEL_COMMAND_TOOL_PREFIX, MarketplaceClient, PERMISSIONS_COMMAND_DESCRIPTION, PERMISSION_MODE_ARGUMENT_HINT, PERMISSION_MODE_COMMAND_DESCRIPTION, PLUGIN_COMMAND_ARGUMENT_HINT, PLUGIN_COMMAND_DESCRIPTION, PROVIDER_SAFE_TOOL_NAME_PATTERN, PluginCommandSource, PluginSettingsStore, ProjectMemoryStore, PromptExecutor, RECOMMENDED_RESPONSE_LANGUAGES, RELOAD_PLUGINS_COMMAND_DESCRIPTION, RENAME_COMMAND_DESCRIPTION, RENAME_COMMAND_USAGE, RESUME_COMMAND_DESCRIPTION, REWIND_COMMAND_ARGUMENT_HINT, REWIND_COMMAND_DESCRIPTION, STATUSLINE_COMMAND_ARGUMENT_HINT, STATUSLINE_COMMAND_DESCRIPTION, SkillCommandSource, type SkillPromptContext, SystemCommandExecutor, type TAutoCompactThreshold, type TAutoCompactThresholdSource, type TBackgroundJobGroupEvent, type TBackgroundJobGroupEventListener, type TBackgroundJobGroupIdFactory, type TBackgroundJobGroupStatus, type TBackgroundJobWaitPolicy, type TBackgroundPermissionPolicy, type TBackgroundPrimitive, type TBackgroundTaskErrorCategory, type TBackgroundTaskEvent, type TBackgroundTaskEventListener, type TBackgroundTaskIdFactory, type TBackgroundTaskIsolation, type TBackgroundTaskKind, type TBackgroundTaskMode, type TBackgroundTaskRequest, type TBackgroundTaskRunnerEvent, type TBackgroundTaskStatus, type TBackgroundTaskTimeoutReason, type TBackgroundTaskTransitionEvent, type TCapabilityKind, type TCapabilitySafety, type TCliUpdateCheckResult, type TCommandEffect, type TCommandInteractionPrompt, type TCommandModuleSessionRequirement, type TCommandResultDataValue, type TContextReferenceLoadType, type TContextReferenceStatus, type TEditCheckpointFileRestoreAction, type TEnabledPlugins, type TExecutionAttention, type TExecutionControl, type TExecutionDetailRecordKind, type TExecutionEntryKind, type TExecutionOriginKind, type TExecutionWorkspaceStatus, type TExecutionWorkspaceUpdateCause, type TExecutionWorkspaceVisibility, type TInstalledPluginsRegistry, type TInteractiveEventName, type TInteractivePermissionHandler, type TInteractiveSessionOptions, type TKnownMarketplacesRegistry, type TMarketplaceSource, type TMemoryCandidateStatus, type TMemoryType, type TPermissionResultValue, type TPluginInstallScope, type TPromptFileReferenceDiagnosticCode, type TPromptFileReferenceReason, type TProviderFactory, type TProviderSettingsDocument, type TQueryFunction, type TRecommendedResponseLanguage, type TReversibleExecutionIsolation, type TReversibleRollbackLayer, type TReversibleSafetyStatus, type TReversibleSideEffect, type TSelfHostingLoopEvent, type TSelfHostingLoopState, type TSelfHostingVerificationPhase, type TSessionFactory, type TSettingsCheck, type TSettingsData, type TSettingsScope, type TShellExecFn, type TSkillActivationInvocation, type TSkillActivationMode, type TSkillActivationSource, type TSkillActivationStatus, type TStatusLineCommandSettingsPatch, type TSubagentJobMode, type TSubagentJobStatus, type TSubagentRunnerFactory, type TSystemCommandLifecycle, type TTaskFileStatus, type TUserLocalMemoryCategory, type TUserLocalMemoryCommandExecutionEffect, type TUserLocalStorageCategory, USER_LOCAL_MEMORY_CATEGORIES, USER_LOCAL_STORAGE_CATEGORIES, USER_LOCAL_STORAGE_CATEGORY_DEFINITIONS, VALIDATE_SESSION_COMMAND_DESCRIPTION, VALID_PERMISSION_MODES, addCommandContextReference, applyActiveModelChange, applyProviderConfiguration, applyProviderSwitch, applyStatusLineSettings, assembleSubagentPrompt, buildBackgroundCommandSubcommands, buildLanguageCommandSubcommands, buildMemoryCommandSubcommands, buildPermissionModeSubcommands, buildPluginCommandSubcommands, buildPromptWithFileReferences, buildProviderProfile, buildProviderSetupPatch, buildRewindCommandSubcommands, buildStatusLineCommandSubcommands, cancelCommandBackgroundTask, checkForCliUpdate, checkSettingsDocument, checkSettingsFile, clearCommandContextReferences, clearContextReferences, clearConversationHistory, closeCommandBackgroundTask, compactCommandContext, compareSemverVersions, createAgentRuntime, createAgentTool, createBackgroundGroupExecutionEntryId, createBackgroundProcessTool, createBackgroundTaskExecutionEntryId, createBuiltinCommandModule, createCommandExecutionTool, createCommandMemoryStores, createCommandPendingMemoryStore, createCommandProjectMemoryStore, createContextReferenceItem, createDefaultTools, createExecutionOriginMetadata, createExecutionWorkspaceSnapshot, createExecutionWorkspaceTaskSpawner, createInProcessSubagentRunner, createLineDetailPage, createMainThreadDetailPage, createMainThreadExecutionEntryId, createModelCommandToolProjection, createPluginRegistryReloadRequestedEffect, createPluginTuiRequestedEffect, createProjectSessionStore, createProjectedCommandExecutionTools, createPromptFileReferenceHistoryEntry, createProviderFromSettings, createProviderSafeModelCommandToolName, createQuery, createSessionExitRequestedEffect, createSessionPickerRequestedEffect, createSessionRenamedEffect, createStatelessRuntime, createSubagentLogger, createSubagentSession, createSystemCommands, createTestInteractiveSession, deleteProviderProfile, deleteSettings, deleteUserLocalMemoryItem, disableUserLocalMemoryItem, discoverTaskFiles, evaluateReversibleToolSafety, executeSkill, formatCliUpdateCheckMessage, formatCliUpdateNotice, formatCommandBackgroundTask, formatCommandBackgroundTaskList, formatCommandHelpMessage, formatCommandPermissionsMessage, formatCommandSessionReplayValidationReport, formatEnvReference, formatInvalidPermissionModeMessage, formatLanguageUsageMessage, formatOrgPolicyViolationMessage, formatProjectedModelCommandToolPromptDescription, formatPromptFileReferenceDiagnostics, formatTaskContext, getBuiltInAgent, getForkWorkerSuffix, getProviderSettingsPaths, getStartupCliUpdateNotice, getSubagentSuffix, getUserSettingsPath, getUserUpdateCheckCachePath, hasBlockingPromptFileReferenceDiagnostics, hasSensitiveCommandMemoryContent, hasUsableSecretReference, inspectCommandEditCheckpoint, inspectUserLocalMemoryItem, inspectUserLocalStorage, isApiKeyPlaintext, isCommandMemoryType, isEnvReference, isMemoryType, isNewerSemverVersion, isPermissionMode, isStatusLineCommandSettingsPatch, listActiveContextReferences, listCommandBackgroundTasks, listCommandContextReferences, listCommandEditCheckpoints, listCommandSessionAllowedTools, listCommandUsedMemoryReferences, listResumableSessionSummaries, listUserLocalMemoryItems, loadOrgPolicy, loadTaskContext, mergeProviderPatch, mergeProviders, mergeSettings, normalizeModelCommandName, parseCommandBackgroundLogCursor, parseExecutionWorkspaceEntryId, parseFrontmatter, parseLanguageArgument, parsePermissionModeArgument, parsePromptFileReferences, parseSessionNameArgument, parseTaskFile, planSelfHostingVerification, preprocessShellCommands, probeProviderProfile, projectPaths, promptForApproval, readAutoCompactThreshold, readAutoCompactThresholdSource, readCommandBackgroundTaskLog, readCommandContextState, readCommandPermissionMode, readCommandPermissionsState, readCommandSessionInfo, readCurrentGitBranch, readEnabledUserLocalMemoryItem, readMergedProviderSettings, readMergedProviderSettingsFromPaths, readPackageVersion, readProviderSettings, readSettings, readStatusLineSettings, readUpdateCheckCache, recordCommandMemoryEvent, removeCommandContextReference, removeContextReference, resetAutoCompactThresholdSetting, resetUserConfig, resolveActiveProvider, resolveEnvReference, resolveGitBranch, resolveLatestSessionId, resolvePermissionModeAdapter, resolvePluginCommandAdapter, resolvePromptFileReferencePaths, resolvePromptFileReferences, resolveProviderSettingsWriteTargetPath, resolveSessionIdByIdOrName, resolveSettingsPathForScope, resolveSubagentLogDir, resolveUserLocalStorageRoot, restoreCommandEditCheckpoint, retrieveAgentToolDeps, rollbackCommandEditCheckpoint, sanitizeProviderProfileName, selectRelevantTasks, setCommandAutoCompactThreshold, setCurrentProvider, setUserLocalMemoryItem, shouldRunStartupCliUpdateCheck, storeAgentToolDeps, substituteVariables, suggestProviderProfileName, summarizeBackgroundJobGroup, testProviderProfileCommand, toContextReferenceRecords, toPromptFileReferenceRecords, transitionSelfHostingLoop, updateModelInSettings, updateTaskFileStatus, upsertContextReference, upsertProviderProfile, userPaths, validateCommandSessionReplayLog, validateProviderProfile, wrapEditCheckpointTools, wrapReversibleExecutionTools, writeAutoCompactThresholdSetting, writeCommandPermissionMode, writeSettings, writeUpdateCheckCache };
 //# sourceMappingURL=index.d.ts.map