@robota-sdk/agent-sdk 3.0.0-beta.60 → 3.0.0-beta.61

package/dist/node/index.d.ts

@@ -1,11 +1,8 @@
-import { ICompactEvent, ITerminalOutput, ISessionLogger, TPermissionHandler, Session, SessionStore, FileSessionLogger } from '@robota-sdk/agent-sessions';
-export { ICompactEvent, ISpinner, ITerminalOutput, TCompactTrigger } from '@robota-sdk/agent-sessions';
-import { TUniversalValue, TSessionEndReason, TPermissionMode, IToolWithEventService, IContextWindowState, IProviderProfileConfig, IProviderDefinition, IProviderSetupStepDefinition, TProviderSetupField, IProviderProbeResult, TToolArgs, IHistoryEntry, THooksConfig, IAIProvider, IHookTypeExecutor, IHookDefinition, IHookInput, IHookResult, TTrustLevel, TUniversalMessage } from '@robota-sdk/agent-core';
-export { IAIProvider, IContextTokenUsage, IContextWindowState, IHistoryEntry, IHookInput, IPermissionLists, THookEvent, THooksConfig, TPermissionDecision, TPermissionMode, TRUST_TO_MODE, TToolArgs, TTrustLevel, chatEntryToMessage, evaluatePermission, getMessagesForAPI, isChatEntry, messageToHistoryEntry, runHooks } from '@robota-sdk/agent-core';
+import { ISessionReplayValidationResult, ICompactEvent, ITerminalOutput, ISessionLogger, TPermissionHandler, Session, FileSessionLogger } from '@robota-sdk/agent-sessions';
+import { TUniversalValue, TSessionEndReason, TPermissionMode, IToolWithEventService, IContextWindowState, IProviderProfileConfig, IProviderDefinition, TProviderSetupField, IProviderSetupStepDefinition, IProviderSetupHelpLink, IProviderProbeResult, IProviderModelCatalog, IHistoryEntry, TToolArgs, THooksConfig, IAIProvider, IHookTypeExecutor, IHookDefinition, IHookInput, IHookResult, TTrustLevel, TUniversalMessage, IToolSchema } from '@robota-sdk/agent-core';
 import { IBackgroundTaskManager, TBackgroundTaskStatus, IBackgroundTaskError, IBackgroundTaskListFilter, IBackgroundTaskState, IBackgroundTaskLogCursor, IBackgroundTaskLogPage, TBackgroundTaskEvent, ISubagentRunner, IBackgroundTaskRunner, IBackgroundTaskInput, ISubagentJobState, TBackgroundTaskIsolation, ISubagentJobResult, ISubagentManager } from '@robota-sdk/agent-runtime';
-export { BackgroundTaskError, BackgroundTaskManager, IAgentBackgroundTaskRequest, IBackgroundTaskError, IBackgroundTaskHandle, IBackgroundTaskInput, IBackgroundTaskListFilter, IBackgroundTaskLogCursor, IBackgroundTaskLogPage, IBackgroundTaskManager, IBackgroundTaskManagerOptions, IBackgroundTaskRequest, IBackgroundTaskResult, IBackgroundTaskRunner, IBackgroundTaskStart, IBackgroundTaskState, IBaseBackgroundTaskRequest, IPreparedSubagentWorktree, IProcessBackgroundTaskRequest, ISerializableProviderProfile, ISubagentJobHandle, ISubagentJobResult, ISubagentJobStart, ISubagentJobState, ISubagentManager, ISubagentManagerOptions, ISubagentRunner, ISubagentSpawnRequest, ISubagentWorktreeAdapter, ISubagentWorktreePrepareRequest, IWorktreeSubagentRunnerOptions, SubagentManager, TBackgroundPermissionPolicy, TBackgroundPrimitive, TBackgroundTaskErrorCategory, TBackgroundTaskEvent, TBackgroundTaskEventListener, TBackgroundTaskIdFactory, TBackgroundTaskIsolation, TBackgroundTaskKind, TBackgroundTaskMode, TBackgroundTaskRunnerEvent, TBackgroundTaskStatus, TBackgroundTaskTimeoutReason, TBackgroundTaskTransitionEvent, TSubagentJobMode, TSubagentJobStatus, WorktreeSubagentRunner, createWorktreeSubagentRunner, getBackgroundTaskTransitions, isTerminalBackgroundTaskStatus, transitionBackgroundTaskStatus } from '@robota-sdk/agent-runtime';
-import { createZodFunctionTool } from '@robota-sdk/agent-tools';
-export { TToolResult } from '@robota-sdk/agent-tools';
+export { BackgroundTaskError, BackgroundTaskManager, DEFAULT_BACKGROUND_TASK_LOG_PAGE_SIZE, IAgentBackgroundTaskRequest, IBackgroundTaskError, IBackgroundTaskHandle, IBackgroundTaskInput, IBackgroundTaskListFilter, IBackgroundTaskLogCursor, IBackgroundTaskLogPage, IBackgroundTaskManager, IBackgroundTaskManagerOptions, IBackgroundTaskRequest, IBackgroundTaskResult, IBackgroundTaskRunner, IBackgroundTaskStart, IBackgroundTaskState, IBaseBackgroundTaskRequest, ICreateLimitedOutputCaptureOptions, ILimitedOutputCapture, IPreparedSubagentWorktree, IProcessBackgroundTaskRequest, ISerializableProviderProfile, ISubagentJobHandle, ISubagentJobResult, ISubagentJobStart, ISubagentJobState, ISubagentManager, ISubagentManagerOptions, ISubagentRunner, ISubagentSpawnRequest, ISubagentWorktreeAdapter, ISubagentWorktreePrepareRequest, IWorktreeSubagentRunnerOptions, SubagentManager, TBackgroundPermissionPolicy, TBackgroundPrimitive, TBackgroundTaskErrorCategory, TBackgroundTaskEvent, TBackgroundTaskEventListener, TBackgroundTaskIdFactory, TBackgroundTaskIsolation, TBackgroundTaskKind, TBackgroundTaskMode, TBackgroundTaskRunnerEvent, TBackgroundTaskStatus, TBackgroundTaskTimeoutReason, TBackgroundTaskTransitionEvent, TSubagentJobMode, TSubagentJobStatus, WorktreeSubagentRunner, appendPrefixedLogLines, createBackgroundTaskLogPage, createLimitedOutputCapture, createWorktreeSubagentRunner, getBackgroundTaskTransitions, isTerminalBackgroundTaskStatus, transitionBackgroundTaskStatus } from '@robota-sdk/agent-runtime';
+import { ISandboxClient, IWorkspaceManifest, createZodFunctionTool } from '@robota-sdk/agent-tools';
 
 type TCapabilityKind = 'builtin-command' | 'skill' | 'agent' | 'tool';
 type TCapabilitySafety = 'read-only' | 'write' | 'process' | 'network' | 'background-agent';
@@ -37,7 +34,7 @@ interface ICommand {
     argumentHint?: string;
     /** When true, models cannot invoke this skill autonomously */
     disableModelInvocation?: boolean;
-    /** When true, models may invoke this command through the command execution tool */
+    /** 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;
@@ -100,6 +97,8 @@ type TCommandEffect = {
     name: string;
 } | {
     type: 'conversation-history-cleared';
+} | {
+    type: 'session-execution-started';
 } | {
     type: 'statusline-settings-patch';
     patch: TStatusLineCommandSettingsPatch;
@@ -114,11 +113,13 @@ interface ICommandChoicePromptOption {
 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;
@@ -446,6 +447,94 @@ interface IMemoryEvent {
     data?: Record<string, TUniversalValue>;
 }
 
+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;
+}
+interface IPromptFileReferenceDiagnostic {
+    code: TPromptFileReferenceDiagnosticCode;
+    severity: 'error';
+    reference: string;
+    message: string;
+    path?: string;
+}
+interface IPromptFileReferenceLimits {
+    maxDepth?: number;
+    maxReferences?: number;
+    maxFileBytes?: number;
+    maxTotalBytes?: number;
+}
+interface IPromptFileReferenceResolveOptions {
+    cwd: string;
+    limits?: IPromptFileReferenceLimits;
+    reason?: TPromptFileReferenceReason;
+}
+interface IResolvedPromptFileReferences {
+    references: IResolvedPromptFileReference[];
+    diagnostics: IPromptFileReferenceDiagnostic[];
+}
+interface IPromptFileReferenceHistoryData {
+    message: string;
+    references: IPromptFileReferenceRecord[];
+}
+
+type TContextReferenceLoadType = 'manual' | 'prompt-reference';
+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;
+    maxObservedReferences?: number;
+}
+interface IContextReferenceAddResult {
+    reference?: IContextReferenceItem;
+    evicted: IContextReferenceItem[];
+    diagnostics: string[];
+}
+interface IContextReferenceRemoveResult {
+    removed?: IContextReferenceItem;
+}
+interface IContextReferenceClearResult {
+    removed: IContextReferenceItem[];
+}
+interface IContextReferenceUpsertResult {
+    references: IContextReferenceItem[];
+    evicted: IContextReferenceItem[];
+}
+declare function createContextReferenceItem(record: IPromptFileReferenceRecord, loadType: TContextReferenceLoadType, status: TContextReferenceStatus, timestamp?: string): IContextReferenceItem;
+declare function upsertContextReference(references: readonly IContextReferenceItem[], item: IContextReferenceItem, limits?: IContextReferenceInventoryLimits): IContextReferenceUpsertResult;
+declare function removeContextReference(references: readonly IContextReferenceItem[], query: string): {
+    references: IContextReferenceItem[];
+    result: IContextReferenceRemoveResult;
+};
+declare function clearContextReferences(references: readonly IContextReferenceItem[]): IContextReferenceClearResult;
+declare function listActiveContextReferences(references: readonly IContextReferenceItem[]): IContextReferenceItem[];
+declare function toContextReferenceRecords(references: readonly IContextReferenceItem[]): IPromptFileReferenceRecord[];
+
 type TAutoCompactThreshold$1 = number | false;
 declare const DEFAULT_AUTO_COMPACT_THRESHOLD = 0.835;
 declare const AUTO_COMPACT_THRESHOLD_SETTINGS_KEY = "autoCompactThreshold";
@@ -467,11 +556,35 @@ declare function writeAutoCompactThresholdSetting(context: ICommandHostContext,
 declare function resetAutoCompactThresholdSetting(context: ICommandHostContext): boolean;
 /** Run manual compaction through the command host facade and return before/after state. */
 declare function compactCommandContext(context: ICommandHostContext, instructions?: string): Promise<ICompactContextResult>;
+/** List context reference inventory entries through the command host facade. */
+declare function listCommandContextReferences(context: ICommandHostContext): IContextReferenceItem[];
+/** Add a manual context reference through the command host facade. */
+declare function addCommandContextReference(context: ICommandHostContext, path: string): Promise<IContextReferenceAddResult>;
+/** Remove a context reference through the command host facade. */
+declare function removeCommandContextReference(context: ICommandHostContext, path: string): IContextReferenceRemoveResult;
+/** Clear all context references through the command host facade. */
+declare function clearCommandContextReferences(context: ICommandHostContext): IContextReferenceClearResult;
 
 interface ICommandListEntry {
     name: string;
     description: string;
 }
+interface ICommandSkillListEntry {
+    readonly name: string;
+    readonly description: string;
+    readonly source: string;
+    readonly modelInvocable: boolean;
+    readonly userInvocable: boolean;
+    readonly argumentHint?: string;
+    readonly context?: string;
+    readonly agent?: string;
+}
+type TCommandInvocationSource = 'user' | 'model';
+interface ICommandSkillActivationRequest {
+    readonly invocationSource: TCommandInvocationSource;
+    readonly displayInput?: string;
+    readonly rawInput?: string;
+}
 type TAutoCompactThresholdSource = 'default' | 'settings' | 'session';
 interface ICommandSessionRuntime {
     clearHistory(): void;
@@ -485,8 +598,14 @@ interface ICommandSessionRuntime {
     getAutoCompactThreshold?(): number | false;
     setAutoCompactThreshold?(threshold: TAutoCompactThreshold$1): void;
 }
+interface ICommandSessionReplayValidationReport {
+    logFile: string;
+    entryCount: number;
+    validation: ISessionReplayValidationResult;
+}
 interface ICommandHostContext {
     clearConversationHistory?(): void;
+    validateCurrentSessionReplayLog?(): ICommandSessionReplayValidationReport;
     getSession(): ICommandSessionRuntime;
     getContextState(): IContextWindowState;
     getAutoCompactThreshold(): TAutoCompactThreshold$1;
@@ -494,8 +613,15 @@ interface ICommandHostContext {
     setAutoCompactThreshold?(threshold: TAutoCompactThreshold$1, source?: TAutoCompactThresholdSource): void;
     getCommandHostAdapters?(): ICommandHostAdapters;
     compactContext(instructions?: string): Promise<void>;
+    listContextReferences?(): IContextReferenceItem[];
+    addContextReference?(path: string): Promise<IContextReferenceAddResult>;
+    removeContextReference?(path: string): IContextReferenceRemoveResult;
+    clearContextReferences?(): IContextReferenceClearResult;
     getCwd(): string;
+    getCommandInvocationSource?(): TCommandInvocationSource;
     listCommands?(): ICommandListEntry[];
+    listSkills?(): ICommandSkillListEntry[];
+    executeSkillCommandByName?(name: string, args: string, request: ICommandSkillActivationRequest): Promise<ICommandResult | null>;
     listEditCheckpoints(): IEditCheckpointSummary[];
     inspectEditCheckpoint?(checkpointId: string): IEditCheckpointInspection;
     restoreEditCheckpoint(checkpointId: string): Promise<IEditCheckpointRestoreResult>;
@@ -573,6 +699,9 @@ interface IProviderSettingsBuildOptions {
 }
 declare function upsertProviderProfile(settings: TProviderSettingsDocument, profileName: string, profile: IProviderProfileSettings): TProviderSettingsDocument;
 declare function setCurrentProvider(settings: TProviderSettingsDocument, profileName: string): TProviderSettingsDocument;
+declare function deleteProviderProfile(settings: TProviderSettingsDocument, profileName: string, options?: {
+    replacementCurrentProvider?: string;
+}): TProviderSettingsDocument;
 declare function validateProviderProfile(profileName: string, profile: IProviderProfileSettings, options?: IProviderSettingsBuildOptions): void;
 declare function buildProviderSetupPatch(input: IProviderSetupInput, options?: IProviderSettingsBuildOptions): IProviderSetupPatch;
 declare function buildProviderProfile(input: IProviderSetupInput, options?: IProviderSettingsBuildOptions): IProviderProfileSettings;
@@ -588,6 +717,16 @@ interface IProviderCommandModuleOptions {
     settings: IProviderCommandSettingsAdapter;
 }
 
+interface IProviderProfileNameSuggestionInput {
+    type: string;
+    model?: string;
+}
+interface IProviderProfileNameSuggestionOptions {
+    existingProfileNames?: readonly string[];
+}
+declare function suggestProviderProfileName(input: IProviderProfileNameSuggestionInput, options?: IProviderProfileNameSuggestionOptions): string;
+declare function sanitizeProviderProfileName(value: string | undefined): string | undefined;
+
 type TProviderSetupType = string;
 type TPromptInput = (label: string, masked?: boolean) => Promise<string>;
 interface IProviderSetupPromptStep extends IProviderSetupStepDefinition {
@@ -596,8 +735,18 @@ interface IProviderSetupPromptStep extends IProviderSetupStepDefinition {
 interface IProviderSetupFlowState {
     type: TProviderSetupType;
     steps: readonly IProviderSetupPromptStep[];
+    setupHelpLinks: readonly IProviderSetupHelpLink[];
     stepIndex: number;
     values: Partial<Record<TProviderSetupField, string>>;
+    existingProfileNames: readonly string[];
+    profileName?: string;
+    setCurrent?: boolean;
+}
+interface IProviderSetupFlowOptions {
+    existingProfileNames?: readonly string[];
+    initialValues?: Partial<Record<TProviderSetupField, string>>;
+    profileName?: string;
+    setCurrent?: boolean;
 }
 type TProviderSetupFlowSubmitResult = {
     status: 'next';
@@ -610,14 +759,15 @@ type TProviderSetupFlowSubmitResult = {
     state: IProviderSetupFlowState;
     message: string;
 };
-declare function createProviderSetupFlow(type: TProviderSetupType, providerDefinitions: readonly IProviderDefinition[]): IProviderSetupFlowState;
+declare function createProviderSetupFlow(type: TProviderSetupType, providerDefinitions: readonly IProviderDefinition[], options?: IProviderSetupFlowOptions): IProviderSetupFlowState;
 declare function formatProviderSetupSelectionPrompt(providerDefinitions: readonly IProviderDefinition[]): string;
 declare function resolveProviderSetupSelection(rawValue: string, providerDefinitions: readonly IProviderDefinition[]): TProviderSetupType;
 declare function getProviderSetupStep(state: IProviderSetupFlowState): IProviderSetupPromptStep;
 declare function submitProviderSetupValue(state: IProviderSetupFlowState, rawValue: string): TProviderSetupFlowSubmitResult;
-declare function runProviderSetupPromptFlow(type: TProviderSetupType, promptInput: TPromptInput, providerDefinitions: readonly IProviderDefinition[]): Promise<IProviderSetupInput>;
-declare function formatProviderSetupPromptLabel(step: IProviderSetupPromptStep): string;
+declare function runProviderSetupPromptFlow(type: TProviderSetupType, promptInput: TPromptInput, providerDefinitions: readonly IProviderDefinition[], options?: IProviderSetupFlowOptions): Promise<IProviderSetupInput>;
+declare function formatProviderSetupPromptLabel(step: IProviderSetupPromptStep, setupHelpLinks?: readonly IProviderSetupHelpLink[]): string;
 declare function formatProviderSetupChoiceLabel(definition: IProviderDefinition): string;
+declare function formatProviderSetupHelpLinks(setupHelpLinks?: readonly IProviderSetupHelpLink[]): string;
 declare function validateProviderSetupValue(step: IProviderSetupPromptStep, value: string): string | undefined;
 
 declare function isEnvReference(value: string): boolean;
@@ -644,7 +794,37 @@ declare function closeCommandBackgroundTask(context: ICommandHostContext, taskId
 
 declare const MODEL_COMMAND_DESCRIPTION = "Change AI model";
 declare const MODEL_COMMAND_ARGUMENT_HINT = "<model-id>";
-declare function buildModelCommandSubcommands(source?: string): ICommand[];
+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>;
 
 declare const LANGUAGE_COMMAND_DESCRIPTION = "Set response language";
 declare const LANGUAGE_COMMAND_ARGUMENT_HINT = "<code>";
@@ -668,7 +848,7 @@ declare function formatLanguageUsageMessage(commandName?: string): string;
 
 declare const PERMISSION_MODE_COMMAND_DESCRIPTION = "Show/change permission mode";
 declare const PERMISSION_MODE_ARGUMENT_HINT = "plan | default | acceptEdits | bypassPermissions";
-declare const PERMISSIONS_COMMAND_DESCRIPTION = "Show permission rules";
+declare const PERMISSIONS_COMMAND_DESCRIPTION = "Show/change permission mode and permission rules";
 interface IPermissionsCommandState {
     readonly mode: TPermissionMode;
     readonly sessionAllowed: readonly string[];
@@ -690,6 +870,7 @@ 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 VALIDATE_SESSION_COMMAND_DESCRIPTION = "Validate current session replay log";
 declare const EXIT_COMMAND_DESCRIPTION = "Exit CLI";
 interface ICommandSessionInfo {
     sessionId: string;
@@ -701,6 +882,8 @@ declare function createSessionRenamedEffect(name: string): TCommandEffect;
 declare function createSessionPickerRequestedEffect(): TCommandEffect;
 declare function createSessionExitRequestedEffect(): TCommandEffect;
 declare function readCommandSessionInfo(context: ICommandHostContext): ICommandSessionInfo;
+declare function validateCommandSessionReplayLog(context: ICommandHostContext): ICommandSessionReplayValidationReport;
+declare function formatCommandSessionReplayValidationReport(report: ICommandSessionReplayValidationReport): string;
 
 declare const REWIND_COMMAND_DESCRIPTION = "List, inspect, restore, or rollback edit checkpoints.";
 declare const REWIND_COMMAND_ARGUMENT_HINT = "list | inspect CHECKPOINT_ID | restore CHECKPOINT_ID | code CHECKPOINT_ID | rollback CHECKPOINT_ID";
@@ -1175,11 +1358,6 @@ declare class SystemCommandExecutor {
 /** Built-in system commands. */
 declare function createSystemCommands(): ISystemCommand[];
 
-/**
- * Build a skill prompt from slash command input.
- * Supports variable substitution and shell command preprocessing.
- */
-
 /** Context variables available during skill prompt processing */
 interface SkillPromptContext {
     /** Current session ID — substituted for ${CLAUDE_SESSION_ID} */
@@ -1204,8 +1382,6 @@ declare function substituteVariables(content: string, args: string, context?: Sk
  * Commands have a 5-second timeout.
  */
 declare function preprocessShellCommands(content: string): Promise<string>;
-/** Build a skill prompt from a slash command input and registry */
-declare function buildSkillPrompt(input: string, registry: CommandRegistry, context?: SkillPromptContext): Promise<string | null>;
 
 /**
  * Skill execution logic.
@@ -1247,6 +1423,36 @@ interface ISkillExecutionResult {
  */
 declare function executeSkill(skill: ICommand, args: string, callbacks: ISkillExecutionCallbacks, context?: SkillPromptContext): Promise<ISkillExecutionResult>;
 
+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;
+}
+
+declare function buildPromptWithFileReferences(input: string, references: readonly IResolvedPromptFileReference[]): string;
+declare function hasBlockingPromptFileReferenceDiagnostics(diagnostics: readonly IPromptFileReferenceDiagnostic[]): boolean;
+declare function formatPromptFileReferenceDiagnostics(diagnostics: readonly IPromptFileReferenceDiagnostic[]): string;
+declare function toPromptFileReferenceRecords(references: readonly IResolvedPromptFileReference[]): IPromptFileReferenceRecord[];
+declare function createPromptFileReferenceHistoryEntry(references: readonly IResolvedPromptFileReference[]): IHistoryEntry<IPromptFileReferenceHistoryData>;
+
+declare function parsePromptFileReferences(input: string): IPromptFileReferenceToken[];
+
+declare function resolvePromptFileReferences(input: string, options: IPromptFileReferenceResolveOptions): Promise<IResolvedPromptFileReferences>;
+declare function resolvePromptFileReferencePaths(referencePaths: readonly string[], options: IPromptFileReferenceResolveOptions): Promise<IResolvedPromptFileReferences>;
+
 /**
  * Types for InteractiveSession — event-driven session wrapper.
  */
@@ -1288,6 +1494,7 @@ interface IExecutionResult {
     toolSummaries: IToolSummary[];
     contextState: IContextWindowState;
     usage?: IUsageSnapshot;
+    promptFileReferences?: IPromptFileReferenceRecord[];
 }
 /** Summary of a tool call extracted from history. */
 interface IToolSummary {
@@ -1307,6 +1514,7 @@ interface IInteractiveSessionEvents {
     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;
 }
@@ -1623,6 +1831,45 @@ declare function wrapReversibleExecutionTools(tools: readonly IToolWithEventServ
     checkpointAvailable: boolean;
 }): IToolWithEventService[];
 
+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): 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;
+
 /**
  * Session factory — assembles a fully-configured Session from config, context,
  * tools, and provider.
@@ -1650,7 +1897,7 @@ interface ICreateSessionOptions {
     /** Maximum number of agentic turns per run() call. Undefined = unlimited. */
     maxTurns?: number;
     /** Optional session store for persistence */
-    sessionStore?: SessionStore;
+    sessionStore?: IInteractiveSessionStore;
     /** Inject a pre-constructed AI provider (used by tests to avoid real API calls) */
     provider?: IAIProvider;
     /** Custom permission handler (overrides terminal-based prompts, used by Ink UI) */
@@ -1714,6 +1961,8 @@ interface ICreateSessionOptions {
     editCheckpointRecorder?: IEditCheckpointRecorder;
     /** Opt-in local-first reversible execution policy for write/shell tools. */
     reversibleExecution?: IReversibleExecutionOptions;
+    /** Optional provider sandbox client used by sandbox-aware built-in tools. */
+    sandboxClient?: ISandboxClient;
 }
 
 /**
@@ -1724,7 +1973,10 @@ interface ICreateSessionOptions {
  * Create the default set of CLI tools.
  * Returns the 8 standard tools as IToolWithEventService[].
  */
-declare function createDefaultTools(): IToolWithEventService[];
+interface ICreateDefaultToolsOptions {
+    sandboxClient?: ISandboxClient;
+}
+declare function createDefaultTools(options?: ICreateDefaultToolsOptions): IToolWithEventService[];
 
 /**
  * Framework system prompt suffixes for subagent sessions.
@@ -1808,7 +2060,7 @@ interface IInteractiveSessionStandardOptions {
     permissionMode?: ICreateSessionOptions['permissionMode'];
     maxTurns?: number;
     permissionHandler?: TInteractivePermissionHandler;
-    sessionStore?: SessionStore;
+    sessionStore?: IInteractiveSessionStore;
     sessionName?: string;
     resumeSessionId?: string;
     forkSession?: boolean;
@@ -1836,6 +2088,14 @@ interface IInteractiveSessionStandardOptions {
     config?: IResolvedConfig;
     /** Opt-in local-first reversible execution policy for write/shell tools. */
     reversibleExecution?: IReversibleExecutionOptions;
+    /** Optional provider sandbox client used by sandbox-aware built-in tools. */
+    sandboxClient?: ISandboxClient;
+    /** Fresh-session workspace manifest applied through the sandbox client. */
+    workspaceManifest?: IWorkspaceManifest;
+    /** Sandbox target root for workspace manifest entries. Defaults to /workspace. */
+    sandboxWorkspaceRoot?: string;
+    /** Provider sandbox snapshot id to restore before replaying saved messages. */
+    sandboxSnapshotId?: string;
 }
 /** Test/advanced construction: inject pre-built session directly. */
 interface IInteractiveSessionInjectedOptions {
@@ -1845,7 +2105,7 @@ interface IInteractiveSessionInjectedOptions {
     permissionMode?: ICreateSessionOptions['permissionMode'];
     maxTurns?: number;
     permissionHandler?: TInteractivePermissionHandler;
-    sessionStore?: SessionStore;
+    sessionStore?: IInteractiveSessionStore;
     sessionName?: string;
     resumeSessionId?: string;
     forkSession?: boolean;
@@ -1895,6 +2155,7 @@ declare class InteractiveSession {
     private backgroundJobGroupEvents;
     private memoryEvents;
     private usedMemoryReferences;
+    private contextReferences;
     private editCheckpointStore;
     private resumeSessionId?;
     private forkSession;
@@ -1903,10 +2164,18 @@ declare class InteractiveSession {
     private backgroundJobOrchestrator;
     private readonly commandModules;
     private readonly commandHostAdapters?;
+    private readonly skillCommandSource;
+    private skillActivationEvents;
     private autoCompactThresholdSource;
     private shuttingDown;
     private shutdownPromise;
+    private readonly sandboxClient?;
+    private sandboxSnapshotId?;
+    private commandInvocationSource;
     constructor(options: IInteractiveSessionOptions);
+    private configureInjectedSession;
+    private restoreSessionRecordIfNeeded;
+    private startAsyncInitializationIfNeeded;
     private initializeAsync;
     private ensureInitialized;
     private getSessionOrThrow;
@@ -1915,16 +2184,22 @@ declare class InteractiveSession {
     private emit;
     submit(input: string, displayInput?: string, rawInput?: string): Promise<void>;
     executeCommand(name: string, args: string): Promise<ICommandResult | null>;
+    private executeCommandWithInvocationSource;
     executeModelCommand(name: string, args: string): Promise<ICommandResult | null>;
-    executeSkillCommand(skill: ICommand, args: string, displayInput?: string, rawInput?: string): Promise<ISkillExecutionResult>;
+    getCommandInvocationSource(): TCommandInvocationSource;
+    executeSkillCommandByName(name: string, args: string, request: ICommandSkillActivationRequest): Promise<ICommandResult | null>;
+    private executeUserResolvedSkillCommand;
     listCommands(): Array<{
         name: string;
         description: string;
     }>;
+    listSkills(): ICommandSkillListEntry[];
     listModelInvocableCommands(): Array<{
         name: string;
         description: string;
     }>;
+    getSkillActivationEvents(): ISkillActivationEvent[];
+    private findSkillCommand;
     abort(): void;
     shutdown(options?: IInteractiveSessionShutdownOptions): Promise<void>;
     cancelQueue(): void;
@@ -1951,6 +2226,10 @@ declare class InteractiveSession {
     rollbackEditCheckpoint(checkpointId: string): Promise<IEditCheckpointRestoreResult>;
     getUsedMemoryReferences(): IMemoryReference[];
     recordMemoryEvent(event: IMemoryEvent): void;
+    listContextReferences(): IContextReferenceItem[];
+    addContextReference(path: string): Promise<IContextReferenceAddResult>;
+    removeContextReference(path: string): IContextReferenceRemoveResult;
+    clearContextReferences(): IContextReferenceClearResult;
     listBackgroundTasks(filter?: IBackgroundTaskListFilter): IBackgroundTaskState[];
     getBackgroundTask(taskId: string): IBackgroundTaskState | undefined;
     cancelBackgroundTask(taskId: string, reason?: string): Promise<void>;
@@ -1980,6 +2259,9 @@ declare class InteractiveSession {
     closeAgentJob(jobId: string): Promise<void>;
     setName(name: string): void;
     attachTransport(transport: ITransportAdapter): void;
+    private executeSkillWithActivation;
+    private recordSkillActivation;
+    private recordSkillActivationEvent;
     private executeForkSkillCommand;
     private getBackgroundTaskManagerOrThrow;
     private getBackgroundTaskManager;
@@ -1994,6 +2276,7 @@ declare class InteractiveSession {
     private getBackgroundTaskSnapshots;
     private getBackgroundJobGroupSnapshots;
     private persistCurrentSession;
+    private captureSandboxSnapshot;
     private startForkSkillExecution;
     private finishForkSkillExecution;
     private recordForkSkillError;
@@ -2002,6 +2285,8 @@ declare class InteractiveSession {
     private applyForkSkillResult;
     private executeForegroundCommand;
     private executePrompt;
+    private recordContextReferenceUsage;
+    private recordPromptContextReferences;
     private getEditCheckpointStore;
     private beginEditCheckpointTurn;
     private finalizeEditCheckpointTurn;
@@ -2118,12 +2403,40 @@ declare function retrieveAgentToolDeps(key: object): IAgentToolDeps | undefined;
  */
 declare function createAgentTool(deps: IAgentToolDeps): ReturnType<typeof createZodFunctionTool>;
 
+type TModelCommandDescriptor$1 = Pick<ICapabilityDescriptor, 'name' | 'description' | 'argumentHint'>;
 interface ICommandExecutionToolDeps {
     isModelInvocable: (command: string) => boolean;
     execute: (command: string, args: string) => Promise<ICommandResult | null>;
+    commandNames?: readonly string[];
+    commandDescriptors?: readonly TModelCommandDescriptor$1[];
 }
 declare function createCommandExecutionTool(deps: ICommandExecutionToolDeps): ReturnType<typeof createZodFunctionTool>;
 
+declare const MODEL_COMMAND_TOOL_PREFIX: "robota_command_";
+declare const PROVIDER_SAFE_TOOL_NAME_PATTERN: RegExp;
+type TModelCommandDescriptor = Pick<ICapabilityDescriptor, 'name' | 'description' | 'argumentHint'>;
+interface IProjectedModelCommandTool {
+    readonly commandName: string;
+    readonly toolName: string;
+    readonly description: string;
+    readonly descriptor: TModelCommandDescriptor;
+}
+interface IModelCommandToolProjection {
+    readonly commandTools: readonly IProjectedModelCommandTool[];
+    readonly toolNameToCommandName: ReadonlyMap<string, string>;
+    readonly commandNameToToolName: ReadonlyMap<string, string>;
+}
+interface IProjectedCommandExecutionToolsDeps {
+    isModelInvocable: (command: string) => boolean;
+    execute: (command: string, args: string) => Promise<ICommandResult | null>;
+    commandDescriptors: readonly TModelCommandDescriptor[];
+}
+declare function normalizeModelCommandName(command: string): string;
+declare function createProviderSafeModelCommandToolName(commandName: string): string;
+declare function createModelCommandToolProjection(commandDescriptors: readonly TModelCommandDescriptor[]): IModelCommandToolProjection;
+declare function formatProjectedModelCommandToolPromptDescription(projection: IProjectedModelCommandTool): string;
+declare function createProjectedCommandExecutionTools(deps: IProjectedCommandExecutionToolsDeps): Array<ReturnType<typeof createZodFunctionTool>>;
+
 interface IBackgroundProcessToolDeps {
     backgroundTaskManager: IBackgroundTaskManager;
     cwd?: string;
@@ -2190,4 +2503,4 @@ declare function updateTaskFileStatus(taskPath: string, status: TTaskFileStatus,
  */
 declare function promptForApproval(terminal: ITerminalOutput, toolName: string, toolArgs: TToolArgs): Promise<boolean>;
 
-export { AUTO_COMPACT_THRESHOLD_SETTINGS_KEY, AgentExecutor, BACKGROUND_COMMAND_DESCRIPTION, BACKGROUND_COMMAND_USAGE, BUILT_IN_AGENTS, BackgroundJobOrchestrator, BuiltinCommandSource, BundlePluginInstaller, BundlePluginLoader, CLEAR_COMMAND_DESCRIPTION, COST_COMMAND_DESCRIPTION, CommandRegistry, DEFAULT_AUTO_COMPACT_THRESHOLD, DEFAULT_STATUS_LINE_COMMAND_SETTINGS, EXIT_COMMAND_DESCRIPTION, EditCheckpointStore, HELP_COMMAND_DESCRIPTION, type IAgentDefinition, type IAgentExecutorOptions, type IAgentSession, type IAgentToolDeps, type IAppendMemoryInput, type IAppendMemoryResult, type IBackgroundJobGroupCreateRequest, type IBackgroundJobGroupState, type IBackgroundJobGroupSummary, type IBackgroundJobOrchestratorOptions, type IBackgroundJobResultEnvelope, type IBackgroundProcessToolDeps, type IBundlePluginFeatures, type IBundlePluginInstallerOptions, type IBundlePluginManifest, type IBundleSkill, type ICapabilityDescriptor, 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 ICommandSessionRuntime, type ICommandSettingsAdapter, type ICommandSettingsDocument, type ICommandSource, type ICompactContextResult, type ICreateQueryOptions, type IDiffLine, type IEditCheckpointFileInspection, type IEditCheckpointFileRecord, type IEditCheckpointInspection, type IEditCheckpointInspectionPlan, type IEditCheckpointManifest, type IEditCheckpointRecorder, type IEditCheckpointRestoreResult, type IEditCheckpointSummary, type IEditCheckpointTurnInput, type IExecutionResult, type IForkExecutionOptions, type IInProcessSubagentRunnerDeps, type IInstalledPluginRecord, type IInstalledPluginsRegistry, type IInteractiveSessionEvents, type IInteractiveSessionOptions, type IInteractiveSessionShutdownOptions, type IKnownMarketplaceEntry, type IKnownMarketplacesRegistry, type ILegacyProviderSettings, type ILoadedBundlePlugin, type IMarketplaceClientOptions, type IMarketplaceManifest, type IMarketplacePluginEntry, type IMarketplaceSource, type IMemoryCandidate, type IMemoryEvent, type IMemoryPendingRecord, type IMemoryReference, type IPermissionsCommandState, type IPluginSettings, type IProjectMemorySummary, type IPromptExecutorOptions, type IPromptProvider, type IProviderCommandModuleOptions, type IProviderCommandSettingsAdapter, type IProviderProfileSettings, type IProviderSettingsBuildOptions, type IProviderSetupFlowState, type IProviderSetupInput, type IProviderSetupPatch, type IProviderSetupPromptStep, type IReversibleExecutionOptions, type IReversibleToolSafetyContext, type IReversibleToolSafetyInput, type IReversibleToolSafetyReport, type ISelfHostingVerificationPlan, type ISelfHostingVerificationPlanInput, type ISelfHostingVerificationStep, type ISkillExecutionCallbacks, type ISkillExecutionResult, type IStartupMemory, type IStatusLineCommandSettings, type ISubagentOptions, type ISubagentPromptOptions, type ISystemCommand, type ITaskContextFile, type ITaskSelectionOptions, type IToolState, type IToolSummary, type ITransportAdapter, type IUpdateTaskFileStatusOptions, type IUsageSnapshot, 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, MarketplaceClient, PERMISSIONS_COMMAND_DESCRIPTION, PERMISSION_MODE_ARGUMENT_HINT, PERMISSION_MODE_COMMAND_DESCRIPTION, PLUGIN_COMMAND_ARGUMENT_HINT, PLUGIN_COMMAND_DESCRIPTION, 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$1 as TAutoCompactThreshold, type TAutoCompactThresholdSource, type TBackgroundJobGroupEvent, type TBackgroundJobGroupEventListener, type TBackgroundJobGroupIdFactory, type TBackgroundJobGroupStatus, type TBackgroundJobWaitPolicy, type TCapabilityKind, type TCapabilitySafety, type TCommandEffect, type TCommandInteractionPrompt, type TCommandModuleSessionRequirement, type TCommandResultDataValue, type TEditCheckpointFileRestoreAction, type TEnabledPlugins, type TInteractiveEventName, type TInteractivePermissionHandler, type TMemoryCandidateStatus, type TMemoryType, type TPermissionResultValue, type TPluginInstallScope, type TPromptInput, type TProviderFactory, type TProviderSettingsDocument, type TProviderSetupFlowSubmitResult, type TProviderSetupType, type TRecommendedResponseLanguage, type TReversibleExecutionIsolation, type TReversibleRollbackLayer, type TReversibleSafetyStatus, type TReversibleSideEffect, type TSelfHostingLoopEvent, type TSelfHostingLoopState, type TSelfHostingVerificationPhase, type TSessionFactory, type TStatusLineCommandSettingsPatch, type TSubagentRunnerFactory, type TSystemCommandLifecycle, type TTaskFileStatus, VALID_PERMISSION_MODES, assembleSubagentPrompt, buildBackgroundCommandSubcommands, buildLanguageCommandSubcommands, buildMemoryCommandSubcommands, buildModelCommandSubcommands, buildPermissionModeSubcommands, buildPluginCommandSubcommands, buildProviderProfile, buildProviderSetupPatch, buildRewindCommandSubcommands, buildSkillPrompt, buildStatusLineCommandSubcommands, cancelCommandBackgroundTask, clearConversationHistory, closeCommandBackgroundTask, compactCommandContext, createAgentTool, createBackgroundProcessTool, createBuiltinCommandModule, createCommandExecutionTool, createCommandMemoryStores, createCommandPendingMemoryStore, createCommandProjectMemoryStore, createDefaultTools, createPluginRegistryReloadRequestedEffect, createPluginTuiRequestedEffect, createProviderSetupFlow, createQuery, createSessionExitRequestedEffect, createSessionPickerRequestedEffect, createSessionRenamedEffect, createSubagentLogger, createSubagentSession, createSystemCommands, discoverTaskFiles, evaluateReversibleToolSafety, executeSkill, formatCommandBackgroundTask, formatCommandBackgroundTaskList, formatCommandHelpMessage, formatCommandPermissionsMessage, formatEnvReference, formatInvalidPermissionModeMessage, formatLanguageUsageMessage, formatProviderSetupChoiceLabel, formatProviderSetupPromptLabel, formatProviderSetupSelectionPrompt, formatTaskContext, getBuiltInAgent, getForkWorkerSuffix, getProviderSetupStep, getSubagentSuffix, hasSensitiveCommandMemoryContent, hasUsableSecretReference, inspectCommandEditCheckpoint, isCommandMemoryType, isEnvReference, isMemoryType, isPermissionMode, isStatusLineCommandSettingsPatch, listCommandBackgroundTasks, listCommandEditCheckpoints, listCommandSessionAllowedTools, listCommandUsedMemoryReferences, loadTaskContext, mergeProviderPatch, parseCommandBackgroundLogCursor, parseFrontmatter, parseLanguageArgument, parsePermissionModeArgument, parseSessionNameArgument, parseTaskFile, planSelfHostingVerification, preprocessShellCommands, probeProviderProfile, projectPaths, promptForApproval, readAutoCompactThreshold, readAutoCompactThresholdSource, readCommandBackgroundTaskLog, readCommandContextState, readCommandPermissionMode, readCommandPermissionsState, readCommandSessionInfo, readCurrentGitBranch, recordCommandMemoryEvent, resetAutoCompactThresholdSetting, resolveEnvReference, resolvePermissionModeAdapter, resolvePluginCommandAdapter, resolveProviderSetupSelection, resolveSubagentLogDir, restoreCommandEditCheckpoint, retrieveAgentToolDeps, rollbackCommandEditCheckpoint, runProviderSetupPromptFlow, selectRelevantTasks, setCommandAutoCompactThreshold, setCurrentProvider, storeAgentToolDeps, submitProviderSetupValue, substituteVariables, summarizeBackgroundJobGroup, testProviderProfileCommand, transitionSelfHostingLoop, updateTaskFileStatus, upsertProviderProfile, userPaths, validateProviderProfile, validateProviderSetupValue, wrapEditCheckpointTools, wrapReversibleExecutionTools, writeAutoCompactThresholdSetting, writeCommandPermissionMode };
+export { AUTO_COMPACT_THRESHOLD_SETTINGS_KEY, AgentExecutor, BACKGROUND_COMMAND_DESCRIPTION, BACKGROUND_COMMAND_USAGE, BUILT_IN_AGENTS, BackgroundJobOrchestrator, BuiltinCommandSource, BundlePluginInstaller, BundlePluginLoader, CLEAR_COMMAND_DESCRIPTION, COST_COMMAND_DESCRIPTION, CommandRegistry, DEFAULT_AUTO_COMPACT_THRESHOLD, DEFAULT_STATUS_LINE_COMMAND_SETTINGS, EXIT_COMMAND_DESCRIPTION, EditCheckpointStore, HELP_COMMAND_DESCRIPTION, type IActiveProviderModelCatalogState, type IAgentDefinition, type IAgentExecutorOptions, type IAgentSession, type IAgentToolDeps, type IAppendMemoryInput, type IAppendMemoryResult, type IBackgroundJobGroupCreateRequest, type IBackgroundJobGroupState, type IBackgroundJobGroupSummary, type IBackgroundJobOrchestratorOptions, type IBackgroundJobResultEnvelope, type IBackgroundProcessToolDeps, type IBuildModelCommandSubcommandsOptions, type IBundlePluginFeatures, type IBundlePluginInstallerOptions, type IBundlePluginManifest, type IBundleSkill, type ICapabilityDescriptor, 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 IContextReferenceAddResult, type IContextReferenceClearResult, type IContextReferenceInventoryLimits, type IContextReferenceItem, type IContextReferenceRemoveResult, type IContextReferenceUpsertResult, type ICreateQueryOptions, type IDiffLine, type IEditCheckpointFileInspection, type IEditCheckpointFileRecord, type IEditCheckpointInspection, type IEditCheckpointInspectionPlan, type IEditCheckpointManifest, type IEditCheckpointRecorder, type IEditCheckpointRestoreResult, type IEditCheckpointSummary, type IEditCheckpointTurnInput, type IExecutionResult, type IForkExecutionOptions, type IInProcessSubagentRunnerDeps, type IInstalledPluginRecord, type IInstalledPluginsRegistry, type IInteractiveSessionEvents, type IInteractiveSessionOptions, type IInteractiveSessionRecord, type IInteractiveSessionShutdownOptions, type IInteractiveSessionStore, type IKnownMarketplaceEntry, type IKnownMarketplacesRegistry, type ILegacyProviderSettings, type ILoadedBundlePlugin, type IMarketplaceClientOptions, type IMarketplaceManifest, type IMarketplacePluginEntry, type IMarketplaceSource, type IMemoryCandidate, type IMemoryEvent, type IMemoryPendingRecord, type IMemoryReference, type IModelCommandModuleOptions, type IModelCommandSettingsAdapter, type IModelCommandToolProjection, type IPermissionsCommandState, type IPluginSettings, 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 IProviderSetupFlowOptions, type IProviderSetupFlowState, type IProviderSetupInput, type IProviderSetupPatch, type IProviderSetupPromptStep, type IResolveActiveProviderModelCatalogStateOptions, type IResolvedPromptFileReference, type IResolvedPromptFileReferences, type IResumableSessionSummary, type IReversibleExecutionOptions, type IReversibleToolSafetyContext, type IReversibleToolSafetyInput, type IReversibleToolSafetyReport, type ISelfHostingVerificationPlan, type ISelfHostingVerificationPlanInput, type ISelfHostingVerificationStep, type ISkillActivationEvent, type ISkillActivationHistoryData, type ISkillExecutionCallbacks, type ISkillExecutionResult, type IStartupMemory, type IStatusLineCommandSettings, type ISubagentOptions, type ISubagentPromptOptions, type ISystemCommand, type ITaskContextFile, type ITaskSelectionOptions, type IToolState, type IToolSummary, type ITransportAdapter, type IUpdateTaskFileStatusOptions, type IUsageSnapshot, 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$1 as TAutoCompactThreshold, type TAutoCompactThresholdSource, type TBackgroundJobGroupEvent, type TBackgroundJobGroupEventListener, type TBackgroundJobGroupIdFactory, type TBackgroundJobGroupStatus, type TBackgroundJobWaitPolicy, type TCapabilityKind, type TCapabilitySafety, type TCommandEffect, type TCommandInteractionPrompt, type TCommandModuleSessionRequirement, type TCommandResultDataValue, type TContextReferenceLoadType, type TContextReferenceStatus, type TEditCheckpointFileRestoreAction, type TEnabledPlugins, type TInteractiveEventName, type TInteractivePermissionHandler, type TMemoryCandidateStatus, type TMemoryType, type TPermissionResultValue, type TPluginInstallScope, type TPromptFileReferenceDiagnosticCode, type TPromptFileReferenceReason, type TPromptInput, type TProviderFactory, type TProviderSettingsDocument, type TProviderSetupFlowSubmitResult, type TProviderSetupType, type TRecommendedResponseLanguage, type TReversibleExecutionIsolation, type TReversibleRollbackLayer, type TReversibleSafetyStatus, type TReversibleSideEffect, type TSelfHostingLoopEvent, type TSelfHostingLoopState, type TSelfHostingVerificationPhase, type TSessionFactory, type TSkillActivationInvocation, type TSkillActivationMode, type TSkillActivationSource, type TSkillActivationStatus, type TStatusLineCommandSettingsPatch, type TSubagentRunnerFactory, type TSystemCommandLifecycle, type TTaskFileStatus, VALIDATE_SESSION_COMMAND_DESCRIPTION, VALID_PERMISSION_MODES, addCommandContextReference, assembleSubagentPrompt, buildBackgroundCommandSubcommands, buildLanguageCommandSubcommands, buildMemoryCommandSubcommands, buildModelCommandSubcommands, buildPermissionModeSubcommands, buildPluginCommandSubcommands, buildPromptWithFileReferences, buildProviderProfile, buildProviderSetupPatch, buildRewindCommandSubcommands, buildStatusLineCommandSubcommands, cancelCommandBackgroundTask, clearCommandContextReferences, clearContextReferences, clearConversationHistory, closeCommandBackgroundTask, compactCommandContext, createAgentTool, createBackgroundProcessTool, createBuiltinCommandModule, createCommandExecutionTool, createCommandMemoryStores, createCommandPendingMemoryStore, createCommandProjectMemoryStore, createContextReferenceItem, createDefaultTools, createModelCommandToolProjection, createPluginRegistryReloadRequestedEffect, createPluginTuiRequestedEffect, createProjectSessionStore, createProjectedCommandExecutionTools, createPromptFileReferenceHistoryEntry, createProviderSafeModelCommandToolName, createProviderSetupFlow, createQuery, createSessionExitRequestedEffect, createSessionPickerRequestedEffect, createSessionRenamedEffect, createSubagentLogger, createSubagentSession, createSystemCommands, deleteProviderProfile, discoverTaskFiles, evaluateReversibleToolSafety, executeSkill, formatCommandBackgroundTask, formatCommandBackgroundTaskList, formatCommandHelpMessage, formatCommandPermissionsMessage, formatCommandSessionReplayValidationReport, formatEnvReference, formatInvalidPermissionModeMessage, formatLanguageUsageMessage, formatModelCommandUsageMessage, formatModelCommandUsageMessageAsync, formatProjectedModelCommandToolPromptDescription, formatPromptFileReferenceDiagnostics, formatProviderSetupChoiceLabel, formatProviderSetupHelpLinks, formatProviderSetupPromptLabel, formatProviderSetupSelectionPrompt, formatTaskContext, getBuiltInAgent, getForkWorkerSuffix, getProviderSetupStep, getSubagentSuffix, hasBlockingPromptFileReferenceDiagnostics, hasSensitiveCommandMemoryContent, hasUsableSecretReference, inspectCommandEditCheckpoint, isCommandMemoryType, isEnvReference, isMemoryType, isPermissionMode, isStatusLineCommandSettingsPatch, listActiveContextReferences, listCommandBackgroundTasks, listCommandContextReferences, listCommandEditCheckpoints, listCommandSessionAllowedTools, listCommandUsedMemoryReferences, listResumableSessionSummaries, loadTaskContext, mergeProviderPatch, normalizeModelCommandName, parseCommandBackgroundLogCursor, parseFrontmatter, parseLanguageArgument, parsePermissionModeArgument, parsePromptFileReferences, parseSessionNameArgument, parseTaskFile, planSelfHostingVerification, preprocessShellCommands, probeProviderProfile, projectPaths, promptForApproval, readAutoCompactThreshold, readAutoCompactThresholdSource, readCommandBackgroundTaskLog, readCommandContextState, readCommandPermissionMode, readCommandPermissionsState, readCommandSessionInfo, readCurrentGitBranch, recordCommandMemoryEvent, removeCommandContextReference, removeContextReference, resetAutoCompactThresholdSetting, resolveActiveProviderModelCatalog, resolveActiveProviderModelCatalogState, resolveEnvReference, resolveLatestSessionId, resolvePermissionModeAdapter, resolvePluginCommandAdapter, resolvePromptFileReferencePaths, resolvePromptFileReferences, resolveProviderSetupSelection, resolveSessionIdByIdOrName, resolveSubagentLogDir, restoreCommandEditCheckpoint, retrieveAgentToolDeps, rollbackCommandEditCheckpoint, runProviderSetupPromptFlow, sanitizeProviderProfileName, selectRelevantTasks, setCommandAutoCompactThreshold, setCurrentProvider, storeAgentToolDeps, submitProviderSetupValue, substituteVariables, suggestProviderProfileName, summarizeBackgroundJobGroup, testProviderProfileCommand, toContextReferenceRecords, toPromptFileReferenceRecords, transitionSelfHostingLoop, updateTaskFileStatus, upsertContextReference, upsertProviderProfile, userPaths, validateCommandSessionReplayLog, validateProviderProfile, validateProviderSetupValue, wrapEditCheckpointTools, wrapReversibleExecutionTools, writeAutoCompactThresholdSetting, writeCommandPermissionMode };