@robota-sdk/agent-framework 3.0.0-beta.72 → 3.0.0-beta.74

package/dist/node/index.d.ts

@@ -1,8 +1,8 @@
-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 { IActionRequest, IActionResponse, IBackgroundJobGroupCreateRequest, IBackgroundJobGroupCreateRequest as IBackgroundJobGroupCreateRequest$1, IBackgroundJobGroupState, IBackgroundJobGroupState as IBackgroundJobGroupState$1, IBackgroundJobGroupSummary, IBackgroundJobGroupSummary as IBackgroundJobGroupSummary$1, IBackgroundJobResultEnvelope, ICapabilityDescriptor, ICommand, ICommandAvailablePlugin, ICommandChoicePromptOption, ICommandInfo, ICommandInstalledPlugin, ICommandInteraction, ICommandInteractionHint, ICommandListEntry, ICommandMarketplaceSource, ICommandPluginAdapter, ICommandPluginAdapter as ICommandPluginAdapter$1, ICommandPluginReloadResult, ICommandResult, ICommandSource, IConfigurableTransport, IContextFileRefreshedEvent, IContextReferenceItem, ICreateExecutionWorkspaceSnapshotInput, ICreateLineDetailPageInput, ICreateMainThreadDetailPageInput, ICreateMainThreadEntryInput, IDiffLine, IExecutionDetailCursor, IExecutionDetailPage, IExecutionDetailRecord, IExecutionOrigin, IExecutionOrigin as IExecutionOrigin$1, IExecutionResult, IExecutionWorkspaceEntry, IExecutionWorkspaceEntryRef, IExecutionWorkspaceEntryRef as IExecutionWorkspaceEntryRef$1, IExecutionWorkspaceEvent, IExecutionWorkspaceFilter, IExecutionWorkspaceSnapshot, IExecutionWorkspaceSnapshotOptions, IInteractionChannel, IInteractiveSession, IInteractiveSessionEvents, IInteractiveSessionRecord, IInteractiveSessionStore, IMemoryEvent, IMemoryReference, IPermissionRequest, IPickItem, IPromptFileReferenceRecord, IResumableSessionSummary, ISkillActivationEvent, IStatusLineCommandSettings, IToolState, IToolSummary, ITransportAdapter, ITransportAdapter as ITransportAdapter$1, ITransportConfig, ITransportRegistryView, IUsageSnapshot, InteractionEvent, TBackgroundJobGroupEvent, TBackgroundJobGroupEventListener, TBackgroundJobGroupEventListener as TBackgroundJobGroupEventListener$1, TBackgroundJobGroupIdFactory, TBackgroundJobGroupIdFactory as TBackgroundJobGroupIdFactory$1, TBackgroundJobGroupStatus, TBackgroundJobWaitPolicy, TCapabilityKind, TCapabilitySafety, TCommandEffect, TCommandInteractionPrompt, TCommandResultDataValue, TContextReferenceLoadType, TContextReferenceStatus, TExecutionAttention, TExecutionControl, TExecutionDetailRecordKind, TExecutionEntryKind, TExecutionOriginKind, TExecutionWorkspaceStatus, TExecutionWorkspaceUpdateCause, TExecutionWorkspaceVisibility, TInteractiveEventName, TInteractivePermissionHandler, TMemoryType, TPermissionResultValue, TPluginInstallScope, TPromptFileReferenceReason, TSkillActivationInvocation, TSkillActivationMode, TSkillActivationSource, TSkillActivationStatus, TStatusLineCommandSettingsPatch } from "@robota-sdk/agent-interface-transport";
+import { IAIProvider, IContextWindowState, IFileSystem, IFileSystemAsync, IHistoryEntry, IHookInput, IHookResult, IHookTypeExecutor, IProviderConfig, IProviderDefinition, IProviderProbeResult, IProviderProfileConfig, ISession, ITerminalOutput, ITerminalOutput as ITerminalOutput$2, IToolWithEventService, THookDefinition, THooksConfig, TPermissionMode, TSessionEndReason, TToolArgs, TUniversalMessage, TUniversalValue, formatEnvReference, hasUsableSecretReference, isEnvReference, resolveEnvReference } from "@robota-sdk/agent-core";
+import { IAgentBackgroundTaskRequest, IBackgroundTaskError, IBackgroundTaskHandle, IBackgroundTaskInput, IBackgroundTaskListFilter, IBackgroundTaskLogCursor, 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, TBackgroundTaskMode, TBackgroundTaskMode as TBackgroundTaskMode$1, TBackgroundTaskRequest, TBackgroundTaskRunnerEvent, TBackgroundTaskStatus, TBackgroundTaskTimeoutReason, TBackgroundTaskTransitionEvent, TSubagentJobMode, TSubagentJobStatus } from "@robota-sdk/agent-executor";
 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 {
@@ -21,215 +21,13 @@ 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 resolvePluginCommandAdapter(context: ICommandHostContext): ICommandPluginAdapter$1 | undefined;
 declare function buildPluginCommandSubcommands(): ICommand[];
 //#endregion
 //#region src/command-api/host-adapters.d.ts
@@ -260,63 +58,11 @@ interface ICommandHostAdapters {
 }
 //#endregion
 //#region src/background-tasks/background-job-orchestrator.d.ts
-type TBackgroundJobWaitPolicy = 'detached' | 'wait_all' | 'wait_any' | 'manual';
-type TBackgroundJobGroupStatus = 'running' | 'completed';
-interface IBackgroundJobResultEnvelope {
-  taskId: string;
-  label: string;
-  status: TBackgroundTaskStatus$1;
-  summary?: string;
-  outputRef?: string;
-  error?: IBackgroundTaskError$1;
-  startedAt?: string;
-  completedAt?: string;
-}
-interface IBackgroundJobGroupState {
-  id: string;
-  parentSessionId: string;
-  waitPolicy: TBackgroundJobWaitPolicy;
-  taskIds: string[];
-  status: TBackgroundJobGroupStatus;
-  createdAt: string;
-  updatedAt: string;
-  label?: string;
-  completedAt?: string;
-  results: IBackgroundJobResultEnvelope[];
-}
-interface IBackgroundJobGroupSummary {
-  groupId: string;
-  status: TBackgroundJobGroupStatus;
-  total: number;
-  completed: number;
-  failed: number;
-  cancelled: number;
-  pending: number;
-  lines: string[];
-}
-interface IBackgroundJobGroupCreateRequest {
-  parentSessionId: string;
-  waitPolicy: TBackgroundJobWaitPolicy;
-  taskIds: string[];
-  label?: string;
-}
-type TBackgroundJobGroupEvent = {
-  type: 'background_job_group_created';
-  group: IBackgroundJobGroupState;
-} | {
-  type: 'background_job_group_updated';
-  group: IBackgroundJobGroupState;
-} | {
-  type: 'background_job_group_completed';
-  group: IBackgroundJobGroupState;
-};
-type TBackgroundJobGroupEventListener = (event: TBackgroundJobGroupEvent) => void;
-type TBackgroundJobGroupIdFactory = (request: IBackgroundJobGroupCreateRequest) => string;
 interface IBackgroundJobOrchestratorOptions {
   manager: IBackgroundTaskManager$1;
   now?: () => string;
-  idFactory?: TBackgroundJobGroupIdFactory;
-  initialGroups?: readonly IBackgroundJobGroupState[];
+  idFactory?: TBackgroundJobGroupIdFactory$1;
+  initialGroups?: readonly IBackgroundJobGroupState$1[];
 }
 declare class BackgroundJobOrchestrator {
   private readonly manager;
@@ -327,11 +73,11 @@ declare class BackgroundJobOrchestrator {
   private readonly groups;
   private sequence;
   constructor(options: IBackgroundJobOrchestratorOptions);
-  createGroup(request: IBackgroundJobGroupCreateRequest): IBackgroundJobGroupState;
-  listGroups(): IBackgroundJobGroupState[];
-  getGroup(groupId: string): IBackgroundJobGroupState | undefined;
-  waitGroup(groupId: string): Promise<IBackgroundJobGroupState>;
-  subscribe(listener: TBackgroundJobGroupEventListener): () => void;
+  createGroup(request: IBackgroundJobGroupCreateRequest$1): IBackgroundJobGroupState$1;
+  listGroups(): IBackgroundJobGroupState$1[];
+  getGroup(groupId: string): IBackgroundJobGroupState$1 | undefined;
+  waitGroup(groupId: string): Promise<IBackgroundJobGroupState$1>;
+  subscribe(listener: TBackgroundJobGroupEventListener$1): () => void;
   dispose(): void;
   private nextGroupId;
   private restoreGroup;
@@ -342,7 +88,7 @@ declare class BackgroundJobOrchestrator {
   private evaluateCompletion;
   private emit;
 }
-declare function summarizeBackgroundJobGroup(group: IBackgroundJobGroupState): IBackgroundJobGroupSummary;
+declare function summarizeBackgroundJobGroup(group: IBackgroundJobGroupState$1): IBackgroundJobGroupSummary$1;
 //#endregion
 //#region src/background-tasks/execution-workspace-types.d.ts
 declare const EXECUTION_ORIGIN_METADATA_KEYS: {
@@ -354,116 +100,11 @@ declare const EXECUTION_ORIGIN_METADATA_KEYS: {
   readonly skillId: "executionOriginSkillId";
   readonly label: "executionOriginLabel";
 };
-type TExecutionEntryKind = 'main_thread' | 'background_task' | 'background_group';
-type TExecutionWorkspaceStatus = 'active' | 'idle' | TBackgroundTaskStatus$1;
-type TExecutionAttention = 'none' | 'unread' | 'failed' | 'permission' | 'completed';
-type TExecutionWorkspaceVisibility = 'default' | 'collapsed';
-type TExecutionControl = 'select' | 'cancel' | 'close' | 'send' | 'read_log' | 'wait';
-type TExecutionOriginKind = 'user_prompt' | 'slash_command' | 'model_command' | 'tool_call' | 'skill' | 'transport' | 'system';
-type TExecutionDetailRecordKind = 'message' | 'tool_activity' | 'process_output' | 'progress' | 'result' | 'error' | 'group_summary';
-type TExecutionWorkspaceUpdateCause = 'main_thread' | 'background_task' | 'background_group';
-interface IExecutionOrigin {
-  readonly kind: TExecutionOriginKind;
-  readonly sessionId: string;
-  readonly turnId?: string;
-  readonly commandName?: string;
-  readonly toolCallId?: string;
-  readonly skillId?: string;
-  readonly label?: string;
-}
-interface IExecutionWorkspaceEntry {
-  readonly id: string;
-  readonly sourceId: string;
-  readonly kind: TExecutionEntryKind;
-  readonly parentId?: string;
-  readonly groupId?: string;
-  readonly origin: IExecutionOrigin;
-  readonly taskKind?: TBackgroundTaskKind$1;
-  readonly status: TExecutionWorkspaceStatus;
-  readonly title: string;
-  readonly subtitle?: string;
-  readonly preview?: string;
-  readonly currentAction?: string;
-  readonly unread: boolean;
-  readonly attention: TExecutionAttention;
-  readonly visibility: TExecutionWorkspaceVisibility;
-  readonly updatedAt: string;
-  readonly controls: readonly TExecutionControl[];
-}
-interface IExecutionWorkspaceFilter {
-  readonly includeMainThread?: boolean;
-  readonly kinds?: readonly TExecutionEntryKind[];
-  readonly visibility?: readonly TExecutionWorkspaceVisibility[];
-}
-interface IExecutionWorkspaceSnapshot {
-  readonly sessionId: string;
-  readonly selectedEntryId?: string;
-  readonly updatedAt: string;
-  readonly entries: readonly IExecutionWorkspaceEntry[];
-}
-interface IExecutionWorkspaceSnapshotOptions {
-  readonly selectedEntryId?: string;
-  readonly filter?: IExecutionWorkspaceFilter;
-}
-interface IExecutionWorkspaceEvent {
-  readonly type: 'execution_workspace_updated';
-  readonly cause: TExecutionWorkspaceUpdateCause;
-  readonly entryId?: string;
-  readonly snapshot: IExecutionWorkspaceSnapshot;
-}
-interface IExecutionDetailCursor {
-  readonly offset: number;
-}
-interface IExecutionDetailRecord {
-  readonly id: string;
-  readonly kind: TExecutionDetailRecordKind;
-  readonly text: string;
-  readonly timestamp?: string;
-  readonly sourceId?: string;
-}
-interface IExecutionDetailPage {
-  readonly entryId: string;
-  readonly cursor?: IExecutionDetailCursor;
-  readonly nextCursor?: IExecutionDetailCursor;
-  readonly records: readonly IExecutionDetailRecord[];
-}
-interface ICreateMainThreadEntryInput {
-  readonly sessionId: string;
-  readonly isExecuting: boolean;
-  readonly hasPendingPrompt: boolean;
-  readonly historyLength: number;
-  readonly updatedAt: string;
-  readonly preview?: string;
-}
-interface ICreateExecutionWorkspaceSnapshotInput {
-  readonly sessionId: string;
-  readonly mainThread: ICreateMainThreadEntryInput;
-  readonly tasks: readonly IBackgroundTaskState$1[];
-  readonly groups: readonly IBackgroundJobGroupState[];
-  readonly selectedEntryId?: string;
-  readonly filter?: IExecutionWorkspaceFilter;
-}
-interface IExecutionWorkspaceEntryRef {
-  readonly kind: TExecutionEntryKind;
-  readonly sourceId: string;
-}
-interface ICreateMainThreadDetailPageInput {
-  readonly entryId: string;
-  readonly history: readonly IHistoryEntry[];
-  readonly cursor?: IExecutionDetailCursor;
-}
-interface ICreateLineDetailPageInput {
-  readonly entryId: string;
-  readonly lines: readonly string[];
-  readonly cursor?: IBackgroundTaskLogCursor$1;
-  readonly nextCursor?: IBackgroundTaskLogCursor$1;
-  readonly kind?: TExecutionDetailRecordKind;
-}
 declare function createMainThreadExecutionEntryId(sessionId: string): string;
 declare function createBackgroundTaskExecutionEntryId(taskId: string): string;
 declare function createBackgroundGroupExecutionEntryId(groupId: string): string;
-declare function parseExecutionWorkspaceEntryId(entryId: string): IExecutionWorkspaceEntryRef | undefined;
-declare function createExecutionOriginMetadata(origin: IExecutionOrigin): Record<string, TBackgroundPrimitive$1>;
+declare function parseExecutionWorkspaceEntryId(entryId: string): IExecutionWorkspaceEntryRef$1 | undefined;
+declare function createExecutionOriginMetadata(origin: IExecutionOrigin$1): Record<string, TBackgroundPrimitive$1>;
 //#endregion
 //#region src/background-tasks/execution-workspace-projection.d.ts
 declare function createExecutionWorkspaceSnapshot(input: ICreateExecutionWorkspaceSnapshotInput): IExecutionWorkspaceSnapshot;
@@ -612,21 +253,12 @@ declare class EditCheckpointStore {
 declare function wrapEditCheckpointTools(tools: readonly IToolWithEventService[], recorder: IEditCheckpointRecorder): IToolWithEventService[];
 //#endregion
 //#region src/context/prompt-file-reference-types.d.ts
-type TPromptFileReferenceReason = 'manual' | 'prompt-reference';
 type TPromptFileReferenceDiagnosticCode = 'not-found' | 'outside-root' | 'directory-not-supported' | 'file-too-large' | 'total-too-large' | 'too-many-references' | 'max-depth' | 'circular-reference' | 'unreadable';
 interface IPromptFileReferenceToken {
   original: string;
   path: string;
   index: number;
 }
-interface IPromptFileReferenceRecord {
-  originalReference: string;
-  sourcePath: string;
-  relativePath: string;
-  reason: TPromptFileReferenceReason;
-  depth: number;
-  byteLength: number;
-}
 interface IResolvedPromptFileReference extends IPromptFileReferenceRecord {
   content: string;
 }
@@ -659,19 +291,6 @@ interface IPromptFileReferenceHistoryData {
 }
 //#endregion
 //#region src/context/context-reference-inventory.d.ts
-type TContextReferenceLoadType = 'manual' | 'prompt-reference' | 'system';
-type TContextReferenceStatus = 'active' | 'observed';
-interface IContextReferenceItem {
-  id: string;
-  sourcePath: string;
-  relativePath: string;
-  originalReference: string;
-  loadType: TContextReferenceLoadType;
-  status: TContextReferenceStatus;
-  byteLength: number;
-  loadedAt: string;
-  lastUsedAt?: string;
-}
 interface IContextReferenceInventoryLimits {
   maxActiveReferences?: number;
   maxActiveBytes?: number;
@@ -705,7 +324,6 @@ declare function toContextReferenceRecords(references: readonly IContextReferenc
 //#region src/memory/project-memory-store.d.ts
 declare const MEMORY_INDEX_MAX_LINES = 200;
 declare const MEMORY_INDEX_MAX_BYTES: number;
-type TMemoryType = 'user' | 'feedback' | 'project' | 'reference';
 interface IStartupMemory {
   content: string;
   path: string;
@@ -762,20 +380,6 @@ interface IMemoryPendingRecord extends IMemoryCandidate {
   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
 /**
@@ -985,14 +589,6 @@ declare function removeCommandContextReference(context: ICommandHostContext, pat
 declare function clearCommandContextReferences(context: ICommandHostContext): IContextReferenceClearResult;
 //#endregion
 //#region src/command-api/host-context.d.ts
-interface ICommandListEntry {
-  name: string;
-  /** 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;
   readonly description: string;
@@ -1084,6 +680,26 @@ interface IAgentJobHostContext {
   closeAgentJob(jobId: string): Promise<void>;
   createBackgroundJobGroup(input: Omit<IBackgroundJobGroupCreateRequest, 'parentSessionId'>): IBackgroundJobGroupState;
   waitBackgroundJobGroup(groupId: string): Promise<IBackgroundJobGroupState>;
+  /**
+   * FLOW-005: schedule a recurring/one-shot agent wake. On each cron fire the agent loop
+   * re-enters with `agentInstruction` (FLOW-001/002). `cronExpression` may be a standard cron
+   * string or an ISO timestamp (one-shot).
+   */
+  spawnScheduledWake(input: {
+    label: string;
+    cronExpression: string;
+    agentInstruction: string;
+  }): Promise<IBackgroundTaskState>;
+  /**
+   * FLOW-005: monitor a process's output and wake the agent with `agentInstruction` when a
+   * line matches `matchPattern` (FLOW-004).
+   */
+  spawnMonitorWake(input: {
+    label: string;
+    command: string;
+    matchPattern: string;
+    agentInstruction: string;
+  }): Promise<IBackgroundTaskState>;
   readBackgroundTaskLog(taskId: string, cursor?: IBackgroundTaskLogCursor): Promise<IBackgroundTaskLogPage>;
 }
 //#endregion
@@ -1113,89 +729,6 @@ interface ISystemCommand {
   execute(context: ICommandHostContext, args: string): Promise<ICommandResult> | ICommandResult;
 }
 //#endregion
-//#region src/interaction/types.d.ts
-/** One-way display events pushed by the framework to the channel. */
-type InteractionEvent = {
-  type: 'user-message';
-  text: string;
-} | {
-  type: 'assistant-chunk';
-  chunk: string;
-} | {
-  type: 'assistant-done';
-  fullText: string;
-} | {
-  type: 'tool-call';
-  id: string;
-  name: string;
-  args: unknown;
-} | {
-  type: 'tool-result';
-  id: string;
-  name: string;
-  result: unknown;
-} | {
-  type: 'permission-request';
-  request: IPermissionRequest;
-} | {
-  type: 'permission-resolved';
-  id: string;
-  granted: boolean;
-} | {
-  type: 'command-result';
-  name: string;
-  output: string;
-} | {
-  type: 'error';
-  error: Error;
-};
-/** Framework-level permission request (id used to correlate with permission-resolved). */
-interface IPermissionRequest {
-  id: string;
-  toolName: string;
-  toolArgs: unknown;
-}
-/** Request-response contract for disambiguation dialogs. */
-type IActionRequest = {
-  type: 'pick';
-  id: string;
-  title: string;
-  items: IPickItem[];
-  defaultIndex?: number;
-} | {
-  type: 'confirm';
-  id: string;
-  message: string;
-  defaultValue?: boolean;
-};
-type IActionResponse = {
-  type: 'pick';
-  item: IPickItem;
-} | {
-  type: 'confirm';
-  confirmed: boolean;
-} | {
-  type: 'cancelled';
-};
-interface IPickItem {
-  label: string;
-  value: string;
-  description?: string;
-}
-interface ICommandInfo {
-  name: string;
-  description: string;
-  subcommands?: ICommandInfo[];
-}
-/** Declared by command modules; consumed by createInteractiveRuntime to call requestAction. */
-type ICommandInteractionHint = {
-  type: 'pick';
-  getItems(): IPickItem[];
-} | {
-  type: 'confirm';
-  message: string;
-};
-//#endregion
 //#region src/command-api/command-module.d.ts
 type TCommandModuleSessionRequirement = 'agent-runtime';
 /** Composable command capability module. */
@@ -1248,6 +781,8 @@ interface IProviderSetupPatch {
 }
 interface IProviderSettingsBuildOptions {
   providerDefinitions?: readonly IProviderDefinition[];
+  /** Environment map for configure-time checks (test seam, default: process.env). */
+  env?: Record<string, string | undefined>;
 }
 declare function upsertProviderProfile(settings: TProviderSettingsDocument, profileName: string, profile: IProviderProfileSettings): TProviderSettingsDocument;
 declare function setCurrentProvider(settings: TProviderSettingsDocument, profileName: string): TProviderSettingsDocument;
@@ -1321,8 +856,24 @@ declare function resolveActiveProvider(settings: TProviderSettingsDocument, prov
 interface IReadProviderSettingsOptions {
   providerOverride?: string;
   providerDefinitions?: readonly IProviderDefinition[];
+  /** Environment map for env-default synthesis (test seam, default: process.env). */
+  env?: Record<string, string | undefined>;
+}
+/**
+ * Missing or unusable provider configuration at session start.
+ * Typed so callers can map it to a distinct exit code without message matching.
+ */
+declare class ProviderConfigError extends Error {
+  constructor(message: string);
 }
 declare function readMergedProviderSettings(cwd: string): TProviderSettingsDocument;
+/**
+ * Zero-config fallback: synthesize an in-memory provider config from the first
+ * definition (in order) whose defaults are complete — `$ENV:` apiKey reference with the
+ * referenced variable set, plus a default model. Settings profiles always win; nothing
+ * is persisted. Returns undefined when no definition qualifies.
+ */
+declare function resolveEnvDefaultProvider(providerDefinitions: readonly IProviderDefinition[], env?: Record<string, string | undefined>): IProviderConfig | undefined;
 declare function readProviderSettings(cwd: string, options?: IReadProviderSettingsOptions): IProviderConfig;
 declare function createProviderFromSettings(cwd: string, modelOverride?: string, options?: IReadProviderSettingsOptions): IAIProvider;
 //#endregion
@@ -1383,6 +934,29 @@ declare function listCommandSessionAllowedTools(context: ICommandHostContext): r
 declare function readCommandPermissionsState(context: ICommandHostContext): IPermissionsCommandState;
 declare function formatCommandPermissionsMessage(state: IPermissionsCommandState): string;
 //#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;
+/**
+ * CLI-069: missing file → empty defaults (non-error); an EXISTING file that
+ * fails to parse throws SettingsParseError — no warn-and-continue masking.
+ */
+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";
+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/session/session-command-api.d.ts
 declare const CLEAR_COMMAND_DESCRIPTION = "Clear conversation history";
 declare const RENAME_COMMAND_DESCRIPTION = "Rename the current session";
@@ -1912,21 +1486,6 @@ interface ISkillExecutionResult {
 declare function executeSkill(skill: ICommand, args: string, callbacks: ISkillExecutionCallbacks, context?: SkillPromptContext): Promise<ISkillExecutionResult>;
 //#endregion
 //#region src/commands/skill-activation-events.d.ts
-type TSkillActivationSource = 'skill' | 'plugin';
-type TSkillActivationInvocation = 'user-slash' | 'model-tool';
-type TSkillActivationMode = 'inject' | 'fork';
-type TSkillActivationStatus = 'started' | 'completed' | 'failed';
-interface ISkillActivationEvent {
-  readonly type: 'skill-activation';
-  readonly skillName: string;
-  readonly source: TSkillActivationSource;
-  readonly invocation: TSkillActivationInvocation;
-  readonly mode: TSkillActivationMode;
-  readonly status: TSkillActivationStatus;
-  readonly timestamp: string;
-  readonly qualifiedName?: string;
-  readonly error?: string;
-}
 interface ISkillActivationHistoryData extends ISkillActivationEvent {
   readonly message: string;
 }
@@ -1944,6 +1503,8 @@ declare class SessionBackgroundTaskTracker {
   private readonly emitTaskEvent;
   private readonly emitGroupEvent;
   private readonly persistSession;
+  private readonly onWake?;
+  private readonly appendSystemNote?;
   private backgroundTasks;
   private backgroundTaskEvents;
   private backgroundJobGroups;
@@ -1951,8 +1512,13 @@ declare class SessionBackgroundTaskTracker {
   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);
+  constructor(getManager: () => IBackgroundTaskManager | undefined, onChanged: (cause: TExecutionWorkspaceUpdateCause, entryId?: string) => void, emitTaskEvent: (event: TBackgroundTaskEvent) => void, emitGroupEvent: (event: TBackgroundJobGroupEvent) => void, persistSession: () => void, onWake?: ((instruction: string, taskId: string) => void) | undefined, appendSystemNote?: ((message: string) => void) | undefined);
   subscribe(session: Session): void;
+  /**
+   * FLOW-003: re-spawn restored sleeping scheduled wakes so they fire again after a resume,
+   * and surface a one-time note for any whose fire time elapsed while the CLI was closed.
+   */
+  private reArmRestoredSchedules;
   dispose(): void;
   restoreState(state: IBackgroundTrackerState): void;
   getState(): IBackgroundTrackerState;
@@ -2039,6 +1605,7 @@ declare class SessionHistoryTracker {
   private readonly getExecuting;
   private readonly persistSession;
   private readonly emitSkillActivation;
+  private readonly emitMemoryEvent;
   private history;
   private editCheckpointStore;
   private memoryEvents;
@@ -2046,7 +1613,7 @@ declare class SessionHistoryTracker {
   private contextReferences;
   private systemContextReferences;
   private skillActivationEvents;
-  constructor(cwd: string, getSessionId: () => string, getExecuting: () => boolean, persistSession: () => void, emitSkillActivation: (event: ISkillActivationEvent) => void, editCheckpointStore?: EditCheckpointStore | null);
+  constructor(cwd: string, getSessionId: () => string, getExecuting: () => boolean, persistSession: () => void, emitSkillActivation: (event: ISkillActivationEvent) => void, emitMemoryEvent: (event: IMemoryEvent) => void, editCheckpointStore?: EditCheckpointStore | null);
   restoreState(state: IHistoryTrackerState): void;
   getState(): IHistoryTrackerState;
   append(entry: IHistoryEntry): void;
@@ -2076,119 +1643,11 @@ declare class SessionHistoryTracker {
 }
 //#endregion
 //#region src/interactive/session-persistence.d.ts
-interface IInteractiveSessionRecord {
-  id: string;
-  name?: string;
-  cwd: string;
-  createdAt: string;
-  updatedAt: string;
-  messages: TUniversalMessage[];
-  history?: IHistoryEntry[];
-  systemPrompt?: string;
-  toolSchemas?: IToolSchema[];
-  backgroundTasks?: IBackgroundTaskState[];
-  backgroundTaskEvents?: TBackgroundTaskEvent[];
-  backgroundJobGroups?: IBackgroundJobGroupState[];
-  backgroundJobGroupEvents?: TBackgroundJobGroupEvent[];
-  skillActivationEvents?: ISkillActivationEvent[];
-  memoryEvents?: IMemoryEvent[];
-  usedMemoryReferences?: IMemoryReference[];
-  contextReferences?: IContextReferenceItem[];
-  sandboxSnapshotId?: string;
-}
-interface IInteractiveSessionStore {
-  save(session: IInteractiveSessionRecord): void;
-  load(id: string): IInteractiveSessionRecord | undefined;
-  list(): IInteractiveSessionRecord[];
-  delete(id: string): void;
-}
-interface IResumableSessionSummary {
-  id: string;
-  name?: string;
-  cwd: string;
-  updatedAt: string;
-  messageCount: number;
-  preview: string;
-}
 declare function createProjectSessionStore(cwd: string, fs?: IFileSystem): IInteractiveSessionStore;
 declare function listResumableSessionSummaries(sessionStore: IInteractiveSessionStore | undefined, cwd: string): IResumableSessionSummary[];
 declare function resolveLatestSessionId(sessionStore: IInteractiveSessionStore | undefined, cwd: string): string | undefined;
 declare function resolveSessionIdByIdOrName(sessionStore: IInteractiveSessionStore | undefined, idOrName: string): string | undefined;
 //#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,
- *  '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;
-  firstArg: string;
-  isRunning: boolean;
-  result?: 'success' | 'error' | 'denied';
-  diffLines?: IDiffLine[];
-  diffFile?: string;
-  toolResultData?: string;
-  executionId?: string;
-}
-/** A single diff line for Edit tool display. */
-interface IDiffLine {
-  type: 'add' | 'remove' | 'context' | 'hunk';
-  text: string;
-  lineNumber: number;
-}
-interface IUsageSnapshot {
-  kind: 'exact' | 'estimated';
-  scope: 'turn';
-  totalTokens: number;
-  promptTokens?: number;
-  completionTokens?: number;
-  contextUsedTokens: number;
-  contextMaxTokens: number;
-  contextUsedPercentage: number;
-  costStatus: 'unknown' | 'estimated' | 'exact';
-}
-/** Result of a completed prompt execution. */
-interface IExecutionResult {
-  response: string;
-  history: IHistoryEntry[];
-  toolSummaries: IToolSummary[];
-  contextState: IContextWindowState;
-  usage?: IUsageSnapshot;
-  promptFileReferences?: IPromptFileReferenceRecord[];
-}
-/** Summary of a tool call extracted from history. */
-interface IToolSummary {
-  name: string;
-  args: string;
-}
-/** Permission handler delegate — clients provide their own UI. */
-type TInteractivePermissionHandler = (toolName: string, toolArgs: TToolArgs) => Promise<TPermissionResultValue>;
-/** Events emitted by InteractiveSession. */
-interface IInteractiveSessionEvents {
-  text_delta: (delta: string) => void;
-  tool_start: (state: IToolState) => void;
-  tool_end: (state: IToolState) => void;
-  thinking: (isThinking: boolean) => void;
-  complete: (result: IExecutionResult) => void;
-  error: (error: Error) => void;
-  context_update: (state: IContextWindowState) => void;
-  compact: (event: ICompactEvent) => void;
-  interrupted: (result: IExecutionResult) => void;
-  skill_activation: (event: ISkillActivationEvent) => void;
-  background_task_event: (event: TBackgroundTaskEvent) => void;
-  background_job_group_event: (event: TBackgroundJobGroupEvent) => void;
-  execution_workspace_event: (event: IExecutionWorkspaceEvent) => void;
-  user_message: (content: string) => void;
-  /** Emitted when a context file (AGENTS.md or CLAUDE.md) is refreshed due to staleness. */
-  context_file_refreshed: (event: IContextFileRefreshedEvent) => void;
-}
-/** Emitted when a context file is found stale and re-read before a turn. */
-interface IContextFileRefreshedEvent {
-  filePath: string;
-}
-type TInteractiveEventName = keyof IInteractiveSessionEvents;
-//#endregion
 //#region src/context/project-detector.d.ts
 type TProjectType = 'node' | 'python' | 'rust' | 'go' | 'unknown';
 type TPackageManager = 'pnpm' | 'yarn' | 'npm' | 'bun';
@@ -2212,8 +1671,8 @@ interface ISystemPromptParams {
   taskContext?: string;
   /** Human-readable tool descriptions, one per entry */
   toolDescriptions: string[];
-  /** Active trust level governing permission checks */
-  trustLevel: TTrustLevel;
+  /** Active permission mode — the value the permission gate enforces */
+  permissionMode: TPermissionMode;
   /** Detected project metadata */
   projectInfo: IProjectInfo;
   /** Current working directory */
@@ -2634,6 +2093,16 @@ interface IExecutionControllerCallbacks {
   emit: <E extends string>(event: E, ...args: unknown[]) => void;
   persistSession: () => void;
 }
+/** Origin of a turn — distinguishes a human prompt from an agent-wakeup (FLOW-002). */
+type TTurnSource = 'user' | 'agent-wakeup';
+/** Options threaded through submit/executePrompt for non-user turns (FLOW-002). */
+interface ITurnOptions {
+  turnSource?: TTurnSource;
+  /** When set, the in-flight wake for this background task id is cleared on turn completion. */
+  wakeTaskId?: string;
+}
+/** A submit callback that optionally carries turn options (default = user turn). */
+type TSubmitFn = (prompt: string, displayInput?: string, rawInput?: string, options?: ITurnOptions) => Promise<void>;
 declare class SessionExecutionController {
   private readonly histTracker;
   private readonly skillRouter;
@@ -2645,7 +2114,10 @@ declare class SessionExecutionController {
   pendingPrompt: string | null;
   pendingDisplayInput: string | undefined;
   pendingRawInput: string | undefined;
+  pendingTurnOptions: ITurnOptions;
   shuttingDown: boolean;
+  /** FLOW-002: background task ids with an in-flight wake turn (coalesces duplicate wakes). */
+  readonly wakeTaskIds: Set<string>;
   constructor(histTracker: SessionHistoryTracker, skillRouter: SessionSkillRouter, callbacks: IExecutionControllerCallbacks);
   clearPendingQueue(): void;
   clearStreaming(): void;
@@ -2663,7 +2135,7 @@ declare class SessionExecutionController {
   }): void;
   emitExecutionWorkspaceUpdated(cause: TExecutionWorkspaceUpdateCause, entryId?: string): void;
   private drainPendingQueue;
-  executePrompt(input: string, displayInput: string | undefined, rawInput: string | undefined, agentsFileEntries: IContextFileEntry[], claudeFileEntries: IContextFileEntry[], rebuildSystemMessage: ICreatedInteractiveSession['rebuildSystemMessage'] | null, setEntries: (agents: IContextFileEntry[], claude: IContextFileEntry[]) => void, submit: (p: string, d?: string, r?: string) => Promise<void>): Promise<void>;
+  executePrompt(input: string, displayInput: string | undefined, rawInput: string | undefined, agentsFileEntries: IContextFileEntry[], claudeFileEntries: IContextFileEntry[], rebuildSystemMessage: ICreatedInteractiveSession['rebuildSystemMessage'] | null, setEntries: (agents: IContextFileEntry[], claude: IContextFileEntry[]) => void, submit: TSubmitFn, turnOptions?: ITurnOptions): Promise<void>;
   executeForkSkillCommand(skill: ICommand, args: string, displayInput: string | undefined, qualifiedName: string | undefined, invocation: ISkillActivationEvent['invocation'], submit: (p: string, d?: string, r?: string) => Promise<void>): Promise<ISkillExecutionResult>;
   executeForegroundCommand(execute: () => Promise<ICommandResult>, submit: (p: string, d?: string, r?: string) => Promise<void>): Promise<ICommandResult>;
   applyForkSkillResult(result: string): Promise<void>;
@@ -2739,59 +2211,17 @@ declare abstract class InteractiveSessionBase {
   sendAgentJob(jobId: string, prompt: string): Promise<void>;
   cancelAgentJob(jobId: string, reason?: string): Promise<void>;
   closeAgentJob(jobId: string): Promise<void>;
-}
-//#endregion
-//#region src/interactive/i-interactive-session.d.ts
-/** Minimal session surface consumed by transport adapters and test factories. */
-interface IInteractiveSession {
-  /** True once the underlying session has been initialized. */
-  readonly isInitialized?: boolean;
-  submit(input: string, displayInput?: string, rawInput?: string): Promise<void>;
-  abort(): void;
-  cancelQueue(): void;
-  shutdown(options?: {
-    reason?: string;
-    message?: string;
-  }): Promise<void>;
-  isExecuting(): boolean;
-  getPendingPrompt(): string | null;
-  getMessages(): TUniversalMessage[];
-  getContextState(): IContextWindowState;
-  getSession(): {
-    getSessionId(): string;
-  };
-  getCwd(): string;
-  executeCommand(name: string, args: string): Promise<ICommandResult | null>;
-  listCommands(): ICommandListEntry[];
-  on<E extends TInteractiveEventName>(event: E, handler: IInteractiveSessionEvents[E]): void;
-  off<E extends TInteractiveEventName>(event: E, handler: IInteractiveSessionEvents[E]): void;
-  listBackgroundTasks(filter?: IBackgroundTaskListFilter): IBackgroundTaskState[];
-  getBackgroundTask(taskId: string): IBackgroundTaskState | undefined;
-  cancelBackgroundTask(taskId: string, reason?: string): Promise<void>;
-  closeBackgroundTask(taskId: string): Promise<void>;
-  sendBackgroundTask(taskId: string, input: IBackgroundTaskInput): Promise<void>;
-  readBackgroundTaskLog(taskId: string, cursor?: IBackgroundTaskLogCursor): Promise<IBackgroundTaskLogPage>;
-  listBackgroundJobGroups(): IBackgroundJobGroupState[];
-  getBackgroundJobGroup(groupId: string): IBackgroundJobGroupState | undefined;
-  createBackgroundJobGroup(input: Omit<IBackgroundJobGroupCreateRequest, 'parentSessionId'>): IBackgroundJobGroupState;
-  waitBackgroundJobGroup(groupId: string): Promise<IBackgroundJobGroupState>;
-  getExecutionWorkspaceSnapshot(options?: IExecutionWorkspaceSnapshotOptions): IExecutionWorkspaceSnapshot;
-  listAgentDefinitions(): Array<{
-    name: string;
-    description: string;
-  }>;
-  listAgentJobs(): ISubagentJobState[];
-  spawnAgentJob(input: {
-    agentType: string;
+  spawnScheduledWake(input: {
     label: string;
-    mode: 'foreground' | 'background';
-    prompt: string;
-    model?: string;
-    isolation?: TBackgroundTaskIsolation;
-  }): Promise<ISubagentJobState>;
-  sendAgentJob(jobId: string, prompt: string): Promise<void>;
-  cancelAgentJob(jobId: string, reason?: string): Promise<void>;
-  closeAgentJob(jobId: string): Promise<void>;
+    cronExpression: string;
+    agentInstruction: string;
+  }): Promise<IBackgroundTaskState>;
+  spawnMonitorWake(input: {
+    label: string;
+    command: string;
+    matchPattern: string;
+    agentInstruction: string;
+  }): Promise<IBackgroundTaskState>;
 }
 //#endregion
 //#region src/interactive/interactive-session.d.ts
@@ -2835,7 +2265,13 @@ declare class InteractiveSession extends InteractiveSessionBase implements ISess
   on<E extends TInteractiveEventName>(event: E, handler: IInteractiveSessionEvents[E]): void;
   off<E extends TInteractiveEventName>(event: E, handler: IInteractiveSessionEvents[E]): void;
   private emit;
-  submit(input: string, displayInput?: string, rawInput?: string): Promise<void>;
+  submit(input: string, displayInput?: string, rawInput?: string, options?: ITurnOptions): Promise<void>;
+  /**
+   * FLOW-002: re-enter the agent loop with a non-user turn triggered by a background wake
+   * (a scheduled fire or, later, a monitor match). Coalesces by source task id so repeated
+   * wakes for the same task while one is still in flight collapse to a single turn.
+   */
+  requestWakeup(instruction: string, sourceTaskId: string): void;
   abort(): void;
   shutdown(options?: IInteractiveSessionShutdownOptions): Promise<void>;
   get isInitialized(): boolean;
@@ -3133,25 +2569,6 @@ declare function formatTaskContext(tasks: readonly ITaskContextFile[]): string;
 declare function loadTaskContext(cwd: string, options?: ITaskSelectionOptions, fs?: IFileSystem): string;
 declare function updateTaskFileStatus(taskPath: string, status: TTaskFileStatus, options?: IUpdateTaskFileStatusOptions, fs?: IFileSystem): void;
 //#endregion
-//#region src/interaction/IInteractionChannel.d.ts
-interface IInteractionChannel {
-  /** Framework registers input handler. Channel calls it when user submits text. */
-  onSubmit(handler: (text: string) => Promise<void>): void;
-  /** Framework pushes one-way display events. Fire-and-forget. */
-  write(event: InteractionEvent): void;
-  /**
-   * Framework requests user disambiguation. Channel decides HOW to present it
-   * (Ink dialog, web modal, programmatic preset). Resolves when user responds.
-   */
-  requestAction(action: IActionRequest): Promise<IActionResponse>;
-  /** Framework provides registered slash commands for autocomplete. */
-  setAvailableCommands(commands: ICommandInfo[]): void;
-  /** Signal whether session is busy (channel may disable input). */
-  setBusy(busy: boolean): void;
-  start(): Promise<void>;
-  stop(): Promise<void>;
-}
-//#endregion
 //#region src/interaction/input-parser.d.ts
 type ParsedInput = {
   type: 'slash-command';
@@ -3200,6 +2617,18 @@ declare function promptForApproval(terminal: ITerminalOutput$2, toolName: string
  *  Pass overrides to spy on or replace specific methods. */
 declare function createTestInteractiveSession(overrides?: Partial<IInteractiveSession>): IInteractiveSession;
 //#endregion
+//#region src/config/settings-parse-error.d.ts
+/**
+ * CLI-069: an EXISTING settings file that fails to parse is an error condition,
+ * never silently equated with a missing file (forbidden-fallback class). Thrown
+ * by the settings readers; session start propagates it (fail fast, exit 1),
+ * reporting consumers (e.g. diagnose) catch it and present it as a finding.
+ */
+declare class SettingsParseError extends Error {
+  readonly filePath: string;
+  constructor(filePath: string, parseMessage: string);
+}
+//#endregion
 //#region src/config/reset-user-config.d.ts
 interface IResetUserConfigResult {
   deleted: boolean;
@@ -3337,5 +2766,5 @@ interface IStatelessRuntimeConfig {
 }
 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 IActionRequest, type IActionResponse, 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 ICommandInfo, type ICommandInstalledPlugin, type ICommandInteraction, type ICommandInteractionHint, 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 IInteractionChannel, type IInteractiveRuntime, type IInteractiveRuntimeOptions, 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 IPermissionRequest, type IPermissionsCommandState, type IPickItem, 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, type InteractionEvent, 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, type ParsedInput, 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, createInteractiveRuntime, 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, isSlashCommand, isStatusLineCommandSettingsPatch, listActiveContextReferences, listCommandBackgroundTasks, listCommandContextReferences, listCommandEditCheckpoints, listCommandSessionAllowedTools, listCommandUsedMemoryReferences, listResumableSessionSummaries, listUserLocalMemoryItems, loadOrgPolicy, loadTaskContext, mergeProviderPatch, mergeProviders, mergeSettings, normalizeModelCommandName, parseCommandBackgroundLogCursor, parseExecutionWorkspaceEntryId, parseFrontmatter, parseInput, 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, tokeniseSlashCommand, transitionSelfHostingLoop, updateModelInSettings, updateTaskFileStatus, upsertContextReference, upsertProviderProfile, userPaths, validateCommandSessionReplayLog, validateProviderProfile, wrapEditCheckpointTools, wrapReversibleExecutionTools, writeAutoCompactThresholdSetting, writeCommandPermissionMode, writeSettings, writeUpdateCheckCache };
+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 IActionRequest, type IActionResponse, 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 ICommandInfo, type ICommandInstalledPlugin, type ICommandInteraction, type ICommandInteractionHint, 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 IInteractionChannel, type IInteractiveRuntime, type IInteractiveRuntimeOptions, 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 IPermissionRequest, type IPermissionsCommandState, type IPickItem, 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, type InteractionEvent, 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, type ParsedInput, PluginCommandSource, PluginSettingsStore, ProjectMemoryStore, PromptExecutor, ProviderConfigError, 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, SettingsParseError, 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, createInteractiveRuntime, 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, isSlashCommand, isStatusLineCommandSettingsPatch, listActiveContextReferences, listCommandBackgroundTasks, listCommandContextReferences, listCommandEditCheckpoints, listCommandSessionAllowedTools, listCommandUsedMemoryReferences, listResumableSessionSummaries, listUserLocalMemoryItems, loadOrgPolicy, loadTaskContext, mergeProviderPatch, mergeProviders, mergeSettings, normalizeModelCommandName, parseCommandBackgroundLogCursor, parseExecutionWorkspaceEntryId, parseFrontmatter, parseInput, 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, resolveEnvDefaultProvider, 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, tokeniseSlashCommand, transitionSelfHostingLoop, updateModelInSettings, updateTaskFileStatus, upsertContextReference, upsertProviderProfile, userPaths, validateCommandSessionReplayLog, validateProviderProfile, wrapEditCheckpointTools, wrapReversibleExecutionTools, writeAutoCompactThresholdSetting, writeCommandPermissionMode, writeSettings, writeUpdateCheckCache };
 //# sourceMappingURL=index.d.ts.map