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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-command",
-  "version": "3.0.0-beta.72",
+  "version": "3.0.0-beta.74",
   "description": "Consolidated command module implementations for Robota SDK CLI",
   "type": "module",
   "main": "dist/node/index.js",
@@ -24,15 +24,16 @@
     "src"
   ],
   "dependencies": {
-    "@robota-sdk/agent-core": "3.0.0-beta.72",
-    "@robota-sdk/agent-framework": "3.0.0-beta.72"
+    "@robota-sdk/agent-core": "3.0.0-beta.74",
+    "@robota-sdk/agent-framework": "3.0.0-beta.74",
+    "@robota-sdk/agent-interface-transport": "3.0.0-beta.74"
   },
   "devDependencies": {
-    "@types/node": "^22.14.0",
-    "rimraf": "^6.0.1",
-    "tsdown": "^0.22.0",
-    "typescript": "^5.8.3",
-    "vitest": "^1.6.1"
+    "@types/node": "^22.19.21",
+    "rimraf": "^6.1.3",
+    "tsdown": "^0.22.2",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.6"
   },
   "license": "MIT",
   "publishConfig": {

package/src/agent/agent-command-module.ts

@@ -2,12 +2,11 @@ import { executeAgentCommand } from './agent-command.js';
 
 import type {
   IAgentJobHostContext,
-  ICommand,
   ICommandHostContext,
   ICommandModule,
-  ICommandSource,
   ISystemCommand,
 } from '@robota-sdk/agent-framework';
+import type { ICommand, ICommandSource } from '@robota-sdk/agent-interface-transport';
 
 function getAgentHostContext(context: ICommandHostContext): IAgentJobHostContext {
   const cap = context.getAgentJobCapability?.();

package/src/agent/agent-command-parser.ts

@@ -1,6 +1,6 @@
 import type { TBackgroundTaskIsolation } from '@robota-sdk/agent-framework';
 
-export const DEFAULT_AGENT_TYPE = 'general-purpose';
+const DEFAULT_AGENT_TYPE = 'general-purpose';
 
 export type TAgentMode = 'background';
 

package/src/agent/agent-command.ts

@@ -3,11 +3,8 @@ import { summarizeBackgroundJobGroup } from '@robota-sdk/agent-framework';
 import { parseParallelRequests, parseRunRequest, tokenizeArgs } from './agent-command-parser.js';
 
 import type { IAgentRunRequest } from './agent-command-parser.js';
-import type {
-  IAgentJobHostContext,
-  ICommandResult,
-  ISubagentJobState,
-} from '@robota-sdk/agent-framework';
+import type { IAgentJobHostContext, ISubagentJobState } from '@robota-sdk/agent-framework';
+import type { ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 function formatError<TError>(error: TError): string {
   return error instanceof Error ? error.message : String(error);

package/src/background/background-command-module.ts

@@ -5,12 +5,8 @@ import {
 
 import { executeBackgroundCommand } from './background-command.js';
 
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
+import type { ICommand, ICommandSource } from '@robota-sdk/agent-interface-transport';
 
 export function createBackgroundCommandEntry(): ICommand {
   return {

package/src/background/background-command.ts

@@ -8,7 +8,8 @@ import {
   readCommandBackgroundTaskLog,
 } from '@robota-sdk/agent-framework';
 
-import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
+import type { ICommandHostContext } from '@robota-sdk/agent-framework';
+import type { ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 function parseCommandParts(args: string): string[] {
   return args.trim().split(/\s+/).filter(Boolean);

package/src/compact/compact-command-module.ts

@@ -1,11 +1,7 @@
 import { executeCompactCommand } from './compact-command.js';
 
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
+import type { ICommand, ICommandSource } from '@robota-sdk/agent-interface-transport';
 
 export function createCompactCommandEntry(): ICommand {
   return {

package/src/compact/compact-command.ts

@@ -1,6 +1,7 @@
 import { compactCommandContext } from '@robota-sdk/agent-framework';
 
-import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
+import type { ICommandHostContext } from '@robota-sdk/agent-framework';
+import type { ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 function parseInstructions(args: string): string | undefined {
   const instructions = args.trim();

package/src/context/__tests__/context-command-module.test.ts

@@ -2,13 +2,13 @@ import { describe, expect, it, vi } from 'vitest';
 import type { IHistoryEntry } from '@robota-sdk/agent-core';
 import type {
   ICommandHostContext,
+  ICommandSessionRuntime,
   IContextReferenceAddResult,
   IContextReferenceClearResult,
-  IContextReferenceItem,
   IContextReferenceRemoveResult,
-  ICommandSessionRuntime,
   TAutoCompactThresholdSource,
 } from '@robota-sdk/agent-framework';
+import type { IContextReferenceItem } from '@robota-sdk/agent-interface-transport';
 import { SystemCommandExecutor } from '@robota-sdk/agent-framework';
 import { createContextCommandModule } from '../context-command-module.js';
 

package/src/context/context-command-module.ts

@@ -1,11 +1,7 @@
 import { executeContextCommand } from './context-command.js';
 
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
+import type { ICommand, ICommandSource } from '@robota-sdk/agent-interface-transport';
 
 export function createContextCommandEntry(): ICommand {
   return {

package/src/context/context-command.ts

@@ -15,11 +15,10 @@ import {
 import type { IHistoryEntry, TUniversalMessage } from '@robota-sdk/agent-core';
 import type {
   ICommandHostContext,
-  ICommandResult,
   TAutoCompactThreshold,
   TAutoCompactThresholdSource,
 } from '@robota-sdk/agent-framework';
-import type { IContextReferenceItem } from '@robota-sdk/agent-framework';
+import type { ICommandResult, IContextReferenceItem } from '@robota-sdk/agent-interface-transport';
 
 const PERCENT = 100;
 const USAGE = [

package/src/default/default-command-modules.ts

@@ -12,6 +12,7 @@ import { createPluginCommandModule } from '../plugin/index.js';
 import { createProviderCommandModule } from '../provider/index.js';
 import { createResetCommandModule } from '../reset/index.js';
 import { createRewindCommandModule } from '../rewind/index.js';
+import { createScheduleCommandModule } from '../schedule/index.js';
 import { createSessionCommandModule } from '../session/index.js';
 import { createSettingsCommandModule } from '../settings/index.js';
 import { createSkillsCommandModule } from '../skills/index.js';
@@ -48,6 +49,7 @@ export function createDefaultCommandModules({
     createSessionCommandModule(),
     createResetCommandModule(),
     createRewindCommandModule(),
+    createScheduleCommandModule(),
     createStatusLineCommandModule(),
     createPluginCommandModule(),
     createSettingsCommandModule(),

package/src/exit/exit-command-module.ts

@@ -2,13 +2,12 @@ import { EXIT_COMMAND_DESCRIPTION } from '@robota-sdk/agent-framework';
 
 import { executeExitCommand } from './exit-command.js';
 
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
 import type {
   ICommand,
   ICommandInteractionHint,
-  ICommandModule,
   ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+} from '@robota-sdk/agent-interface-transport';
 
 export function createExitCommandEntry(): ICommand {
   return {

package/src/exit/exit-command.ts

@@ -1,6 +1,7 @@
 import { createSessionExitRequestedEffect } from '@robota-sdk/agent-framework';
 
-import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
+import type { ICommandHostContext } from '@robota-sdk/agent-framework';
+import type { ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 export function executeExitCommand(_context: ICommandHostContext, _args: string): ICommandResult {
   return {

package/src/help/__tests__/help-command.test.ts

@@ -1,8 +1,5 @@
-import type {
-  ICommandHostContext,
-  ICommandListEntry,
-  ICommandSessionRuntime,
-} from '@robota-sdk/agent-framework';
+import type { ICommandHostContext, ICommandSessionRuntime } from '@robota-sdk/agent-framework';
+import type { ICommandListEntry } from '@robota-sdk/agent-interface-transport';
 import { formatCommandHelpMessage } from '@robota-sdk/agent-framework';
 import { describe, expect, it } from 'vitest';
 

package/src/help/help-command-module.ts

@@ -2,12 +2,8 @@ import { HELP_COMMAND_DESCRIPTION } from '@robota-sdk/agent-framework';
 
 import { executeHelpCommand } from './help-command.js';
 
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
+import type { ICommand, ICommandSource } from '@robota-sdk/agent-interface-transport';
 
 export function createHelpCommandEntry(): ICommand {
   return {

package/src/help/help-command.ts

@@ -1,6 +1,7 @@
 import { formatCommandHelpMessage } from '@robota-sdk/agent-framework';
 
-import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
+import type { ICommandHostContext } from '@robota-sdk/agent-framework';
+import type { ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 export function executeHelpCommand(context: ICommandHostContext, _args: string): ICommandResult {
   return {

package/src/index.ts

@@ -13,6 +13,7 @@ export * from './plugin/index.js';
 export * from './provider/index.js';
 export * from './reset/index.js';
 export * from './rewind/index.js';
+export * from './schedule/index.js';
 export * from './session/index.js';
 export * from './settings/index.js';
 export * from './skills/index.js';

package/src/language/language-command-module.ts

@@ -6,13 +6,12 @@ import {
 
 import { executeLanguageCommand } from './language-command.js';
 
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
 import type {
   ICommand,
   ICommandInteractionHint,
-  ICommandModule,
   ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+} from '@robota-sdk/agent-interface-transport';
 
 export function createLanguageCommandEntry(): ICommand {
   return {

package/src/language/language-command.ts

@@ -1,6 +1,7 @@
 import { formatLanguageUsageMessage, parseLanguageArgument } from '@robota-sdk/agent-framework';
 
-import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
+import type { ICommandHostContext } from '@robota-sdk/agent-framework';
+import type { ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 export function executeLanguageCommand(
   _context: ICommandHostContext,

package/src/memory/memory-command-module.ts

@@ -6,12 +6,8 @@ import {
 
 import { executeMemoryCommand } from './memory-command.js';
 
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
+import type { ICommand, ICommandSource } from '@robota-sdk/agent-interface-transport';
 
 export function createMemoryCommandEntry(): ICommand {
   return {

package/src/memory/memory-command.ts

@@ -12,9 +12,8 @@ import type {
   ICommandHostContext,
   ICommandPendingMemoryStore,
   ICommandProjectMemoryStore,
-  ICommandResult,
-  IMemoryEvent,
 } from '@robota-sdk/agent-framework';
+import type { ICommandResult, IMemoryEvent } from '@robota-sdk/agent-interface-transport';
 
 const SUBCOMMAND_INDEX = 0;
 const TYPE_INDEX = 1;

package/src/mode/__tests__/mode-command-module.test.ts

@@ -7,7 +7,7 @@ import { SystemCommandExecutor } from '@robota-sdk/agent-framework';
 import { createModeCommandModule } from '../mode-command-module.js';
 
 type TPermissionModeName = 'plan' | 'default' | 'acceptEdits' | 'bypassPermissions';
-type TSetPermissionModeSpy = ReturnType<typeof vi.fn<[nextMode: TPermissionModeName], void>>;
+type TSetPermissionModeSpy = ReturnType<typeof vi.fn<(nextMode: TPermissionModeName) => void>>;
 
 function createCheckpointResult(): IEditCheckpointRestoreResult {
   return {

package/src/mode/mode-command-module.ts

@@ -6,13 +6,12 @@ import {
 
 import { executeModeCommand } from './mode-command.js';
 
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
 import type {
   ICommand,
   ICommandInteractionHint,
-  ICommandModule,
   ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+} from '@robota-sdk/agent-interface-transport';
 
 export function createModeCommandEntry(): ICommand {
   return {

package/src/mode/mode-command.ts

@@ -6,7 +6,8 @@ import {
   writeCommandPermissionMode,
 } from '@robota-sdk/agent-framework';
 
-import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
+import type { ICommandHostContext } from '@robota-sdk/agent-framework';
+import type { ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 export function executeModeCommand(context: ICommandHostContext, args: string): ICommandResult {
   const arg = parsePermissionModeArgument(args);

package/src/permissions/__tests__/permissions-command-module.test.ts

@@ -7,7 +7,7 @@ import { SystemCommandExecutor } from '@robota-sdk/agent-framework';
 import { createPermissionsCommandModule } from '../permissions-command-module.js';
 
 type TPermissionModeName = 'plan' | 'default' | 'acceptEdits' | 'bypassPermissions';
-type TSetPermissionModeSpy = ReturnType<typeof vi.fn<[nextMode: TPermissionModeName], void>>;
+type TSetPermissionModeSpy = ReturnType<typeof vi.fn<(nextMode: TPermissionModeName) => void>>;
 
 function createCheckpointResult(): IEditCheckpointRestoreResult {
   return {

package/src/permissions/permissions-command-module.ts

@@ -6,12 +6,8 @@ import {
 
 import { executePermissionsCommand } from './permissions-command.js';
 
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
+import type { ICommand, ICommandSource } from '@robota-sdk/agent-interface-transport';
 
 export function createPermissionsCommandEntry(): ICommand {
   return {

package/src/permissions/permissions-command.ts

@@ -7,7 +7,8 @@ import {
   writeCommandPermissionMode,
 } from '@robota-sdk/agent-framework';
 
-import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
+import type { ICommandHostContext } from '@robota-sdk/agent-framework';
+import type { ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 export function executePermissionsCommand(
   context: ICommandHostContext,

package/src/plugin/__tests__/plugin-command-module.test.ts

@@ -1,8 +1,5 @@
-import type {
-  ICommandHostContext,
-  ICommandPluginAdapter,
-  ICommandSessionRuntime,
-} from '@robota-sdk/agent-framework';
+import type { ICommandHostContext, ICommandSessionRuntime } from '@robota-sdk/agent-framework';
+import type { ICommandPluginAdapter } from '@robota-sdk/agent-interface-transport';
 import { describe, expect, it, vi } from 'vitest';
 import { createPluginCommandModule } from '../plugin-command-module.js';
 import { executePluginCommand, executeReloadPluginsCommand } from '../plugin-command.js';

package/src/plugin/plugin-command-module.ts

@@ -7,12 +7,8 @@ import {
 
 import { executePluginCommand, executeReloadPluginsCommand } from './plugin-command.js';
 
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
+import type { ICommand, ICommandSource } from '@robota-sdk/agent-interface-transport';
 
 export function createPluginCommandEntry(): ICommand {
   return {

package/src/plugin/plugin-command.ts

@@ -4,11 +4,8 @@ import {
   resolvePluginCommandAdapter,
 } from '@robota-sdk/agent-framework';
 
-import type {
-  ICommandHostContext,
-  ICommandPluginAdapter,
-  ICommandResult,
-} from '@robota-sdk/agent-framework';
+import type { ICommandHostContext } from '@robota-sdk/agent-framework';
+import type { ICommandPluginAdapter, ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 function getSubcommandParts(args: string): { subcommand: string; subArgs: string } {
   const parts = args

package/src/plugins/default-plugin-command-adapter.ts

@@ -9,14 +9,14 @@ import {
   PluginSettingsStore,
 } from '@robota-sdk/agent-framework';
 
+import type { IMarketplaceManifest } from '@robota-sdk/agent-framework';
 import type {
   ICommandAvailablePlugin,
   ICommandInstalledPlugin,
   ICommandMarketplaceSource,
   ICommandPluginAdapter,
-  IMarketplaceManifest,
   TPluginInstallScope,
-} from '@robota-sdk/agent-framework';
+} from '@robota-sdk/agent-interface-transport';
 
 interface IPluginServices {
   cwd: string;

package/src/provider/provider-command-execution.ts

@@ -7,11 +7,10 @@ import { createSetupFlow, createProviderSetupInteraction } from './provider-comm
 import { formatProviderSetupChoiceLabel } from './provider-setup-flow.js';
 
 import type {
-  ICommandInteraction,
-  ICommandResult,
   IProviderCommandModuleOptions,
   IProviderProfileSettings,
 } from '@robota-sdk/agent-framework';
+import type { ICommandInteraction, ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 export async function executeProviderCommand(
   args: string,

package/src/provider/provider-command-module.ts

@@ -1,14 +1,16 @@
 import { executeProviderCommand } from './provider-command-execution.js';
 
 import type {
-  ICommand,
-  ICommandInteractionHint,
   ICommandModule as TCommandModule,
-  ICommandSource,
   IProviderCommandModuleOptions,
   IProviderCommandSettingsAdapter,
   ISystemCommand as TSystemCommand,
 } from '@robota-sdk/agent-framework';
+import type {
+  ICommand,
+  ICommandInteractionHint,
+  ICommandSource,
+} from '@robota-sdk/agent-interface-transport';
 export type { IProviderCommandModuleOptions, IProviderCommandSettingsAdapter };
 
 function buildProviderSubcommands(): ICommand[] {

package/src/provider/provider-command-profile-lifecycle.ts

@@ -6,11 +6,8 @@ import {
 
 import { formatProviderChoiceLabel } from './provider-command-profile-operations.js';
 
-import type {
-  ICommandInteraction,
-  ICommandResult,
-  IProviderCommandModuleOptions,
-} from '@robota-sdk/agent-framework';
+import type { IProviderCommandModuleOptions } from '@robota-sdk/agent-framework';
+import type { ICommandInteraction, ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 const YES = 'yes';
 const MAX_DUPLICATE_PROFILE_SUFFIX = 1000;

package/src/provider/provider-command-profile-operations.ts

@@ -14,12 +14,11 @@ import { createProviderSetupFlow, submitProviderSetupValue } from './provider-se
 
 import type { IProviderSetupFlowState } from './provider-setup-flow.js';
 import type {
-  ICommandInteraction,
-  ICommandResult,
   IProviderCommandModuleOptions,
   IProviderProfileSettings,
   IProviderSetupInput,
 } from '@robota-sdk/agent-framework';
+import type { ICommandInteraction, ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 export function formatProviderChoiceLabel(
   name: string,
@@ -110,7 +109,7 @@ function getProviderProfileSetupValues(profile: IProviderProfileSettings): {
   };
 }
 
-export function createProviderEditInteraction(
+function createProviderEditInteraction(
   flow: IProviderSetupFlowState,
   profileName: string,
   options: IProviderCommandModuleOptions,

package/src/provider/provider-command-profile.ts

@@ -11,11 +11,10 @@ import {
 } from './provider-command-profile-operations.js';
 
 import type {
-  ICommandInteraction,
-  ICommandResult,
   IProviderCommandModuleOptions,
   IProviderProfileSettings,
 } from '@robota-sdk/agent-framework';
+import type { ICommandInteraction, ICommandResult } from '@robota-sdk/agent-interface-transport';
 
 const ACTION_SWITCH = 'switch';
 const ACTION_EDIT = 'edit';

package/src/provider/provider-command-setup.ts

@@ -10,12 +10,14 @@ import {
 
 import type { IProviderSetupFlowState } from './provider-setup-flow.js';
 import type {
-  ICommandInteraction,
-  ICommandResult,
   IProviderCommandModuleOptions,
   IProviderSetupInput,
-  TCommandInteractionPrompt,
 } from '@robota-sdk/agent-framework';
+import type {
+  ICommandInteraction,
+  ICommandResult,
+  TCommandInteractionPrompt,
+} from '@robota-sdk/agent-interface-transport';
 
 const PROVIDER_RESTART_EFFECT = {
   type: 'session-restart-requested',
@@ -59,7 +61,7 @@ export function toProviderSetupStepPrompt(
   };
 }
 
-export function toProviderSetupPromptDescription(
+function toProviderSetupPromptDescription(
   flow: IProviderSetupFlowState,
 ): { description: string } | Record<string, never> {
   const description = formatProviderSetupHelpLinks(flow.setupHelpLinks);
@@ -89,7 +91,7 @@ function submitProviderSetupInteractionValue(
   };
 }
 
-export function completeProviderSetup(
+function completeProviderSetup(
   input: IProviderSetupInput,
   options: IProviderCommandModuleOptions,
 ): ICommandResult {

package/src/provider/provider-startup.ts

@@ -2,9 +2,11 @@ import { join } from 'node:path';
 
 import {
   checkSettingsDocument,
+  ProviderConfigError,
   readMergedProviderSettings,
   readSettings,
   writeSettings,
+  resolveEnvDefaultProvider,
   resolveSettingsPathForScope,
   getProviderSettingsPaths,
   applyProviderConfiguration,
@@ -30,6 +32,8 @@ export interface IProviderStartupContext {
 export interface IEnsureProviderConfigOptions {
   formatError: (defs: readonly IProviderDefinition[]) => string;
   isInteractive?: () => boolean;
+  /** Environment map for env-default synthesis (test seam, default: process.env). */
+  env?: Record<string, string | undefined>;
 }
 
 export async function runProviderStartupSetup(
@@ -80,9 +84,17 @@ export async function ensureProviderConfig(
   if (checkSettingsDocument(selectedSettings, providerDefinitions) === 'valid') {
     return;
   }
+  // Zero-config startup: a recognized provider env key with complete definition defaults
+  // makes setup unnecessary — resolution will synthesize an env-default config.
+  if (
+    ctx.provider === undefined &&
+    resolveEnvDefaultProvider(providerDefinitions, options.env) !== undefined
+  ) {
+    return;
+  }
   const checkInteractive = options.isInteractive ?? (() => false);
   if (!checkInteractive()) {
-    throw new Error(options.formatError(providerDefinitions));
+    throw new ProviderConfigError(options.formatError(providerDefinitions));
   }
   await runProviderStartupSetup(
     cwd,
@@ -95,7 +107,7 @@ export async function ensureProviderConfig(
   const updatedSettings =
     ctx.provider !== undefined ? { ...updated, currentProvider: ctx.provider } : updated;
   if (checkSettingsDocument(updatedSettings, providerDefinitions) !== 'valid') {
-    throw new Error(options.formatError(providerDefinitions));
+    throw new ProviderConfigError(options.formatError(providerDefinitions));
   }
 }
 

package/src/reset/reset-command-module.ts

@@ -1,11 +1,7 @@
 import { executeResetCommand } from './reset-command.js';
 
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
+import type { ICommand, ICommandSource } from '@robota-sdk/agent-interface-transport';
 
 const RESET_COMMAND_DESCRIPTION = 'Delete settings';