@robota-sdk/agent-command 3.0.0-beta.65 → 3.0.0-beta.66

package/src/provider/provider-startup.ts

@@ -0,0 +1,117 @@
+import { join } from 'node:path';
+
+import {
+  checkSettingsDocument,
+  readMergedProviderSettings,
+  readSettings,
+  writeSettings,
+  resolveSettingsPathForScope,
+  getProviderSettingsPaths,
+  applyProviderConfiguration,
+} from '@robota-sdk/agent-framework';
+
+import {
+  formatProviderSetupSelectionPrompt,
+  resolveProviderSetupSelection,
+  runProviderSetupPromptFlow,
+  type TPromptInput,
+} from './provider-setup-flow.js';
+
+import type { IProviderDefinition } from '@robota-sdk/agent-core';
+import type { ITerminalOutput } from '@robota-sdk/agent-core';
+import type { TSettingsScope } from '@robota-sdk/agent-framework';
+
+export interface IProviderStartupContext {
+  provider?: string;
+  settingsScope?: TSettingsScope;
+}
+
+export interface IEnsureProviderConfigOptions {
+  formatError: (defs: readonly IProviderDefinition[]) => string;
+  isInteractive?: () => boolean;
+}
+
+export async function runProviderStartupSetup(
+  cwd: string,
+  ctx: IProviderStartupContext,
+  promptInput: TPromptInput,
+  terminal: ITerminalOutput,
+  providerDefinitions: readonly IProviderDefinition[],
+): Promise<void> {
+  const providerChoice = await promptInput(formatProviderSetupSelectionPrompt(providerDefinitions));
+  const type = resolveProviderSetupSelection(providerChoice, providerDefinitions);
+  const settingsPath = resolveSettingsPathForScope(cwd, ctx.settingsScope);
+  const input = await runProviderSetupPromptFlow(type, promptInput, providerDefinitions, {
+    existingProfileNames: Object.keys(readMergedProviderSettings(cwd).providers ?? {}),
+  });
+  applyProviderConfiguration(settingsPath, input, { providerDefinitions });
+  const language = await promptInput('  Response language (ko/en/ja/zh, default: en): ');
+  if (language) {
+    const settings = readSettings(settingsPath);
+    settings.language = language;
+    writeSettings(settingsPath, settings);
+  }
+  terminal.writeLine(`\n  Config saved to ${settingsPath}\n`);
+}
+
+export async function ensureProviderConfig(
+  cwd: string,
+  ctx: IProviderStartupContext,
+  promptInput: TPromptInput,
+  terminal: ITerminalOutput,
+  providerDefinitions: readonly IProviderDefinition[],
+  options: IEnsureProviderConfigOptions,
+): Promise<void> {
+  const merged = readMergedProviderSettings(cwd);
+  const selectedSettings =
+    ctx.provider !== undefined ? { ...merged, currentProvider: ctx.provider } : merged;
+  if (checkSettingsDocument(selectedSettings, providerDefinitions) === 'valid') {
+    return;
+  }
+  const checkInteractive = options.isInteractive ?? (() => false);
+  if (!checkInteractive()) {
+    throw new Error(options.formatError(providerDefinitions));
+  }
+  await runProviderStartupSetup(
+    cwd,
+    selectStartupContext(cwd, ctx),
+    promptInput,
+    terminal,
+    providerDefinitions,
+  );
+  const updated = readMergedProviderSettings(cwd);
+  const updatedSettings =
+    ctx.provider !== undefined ? { ...updated, currentProvider: ctx.provider } : updated;
+  if (checkSettingsDocument(updatedSettings, providerDefinitions) !== 'valid') {
+    throw new Error(options.formatError(providerDefinitions));
+  }
+}
+
+function selectStartupContext(cwd: string, ctx: IProviderStartupContext): IProviderStartupContext {
+  if (ctx.settingsScope !== undefined || ctx.provider !== undefined) return ctx;
+  const currentProviderPath = findHighestPriorityCurrentProviderPath(getProviderSettingsPaths(cwd));
+  if (currentProviderPath === undefined) return ctx;
+  const projectSettingsPath = join(cwd, '.robota', 'settings.json');
+  const projectLocalSettingsPath = join(cwd, '.robota', 'settings.local.json');
+  if (
+    currentProviderPath === projectSettingsPath ||
+    currentProviderPath === projectLocalSettingsPath
+  ) {
+    return { ...ctx, settingsScope: 'project-local' };
+  }
+  return ctx;
+}
+
+function findHighestPriorityCurrentProviderPath(
+  settingsPaths: readonly string[],
+): string | undefined {
+  for (let index = settingsPaths.length - 1; index >= 0; index -= 1) {
+    const settingsPath = settingsPaths[index];
+    if (settingsPath === undefined) continue;
+    const settings = readSettings(settingsPath);
+    if (typeof settings.currentProvider === 'string') {
+      return settingsPath;
+    }
+  }
+  return undefined;
+}

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

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

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

@@ -1,16 +1,18 @@
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
 import {
   REWIND_COMMAND_ARGUMENT_HINT,
   REWIND_COMMAND_DESCRIPTION,
   buildRewindCommandSubcommands,
 } from '@robota-sdk/agent-framework';
+
 import { executeRewindCommand } from './rewind-command.js';
 
+import type {
+  ICommand,
+  ICommandModule,
+  ICommandSource,
+  ISystemCommand,
+} from '@robota-sdk/agent-framework';
+
 export function createRewindCommandEntry(): ICommand {
   return {
     name: 'rewind',

package/src/rewind/rewind-command.ts

@@ -1,3 +1,10 @@
+import {
+  inspectCommandEditCheckpoint,
+  listCommandEditCheckpoints,
+  restoreCommandEditCheckpoint,
+  rollbackCommandEditCheckpoint,
+} from '@robota-sdk/agent-framework';
+
 import type {
   ICommandHostContext,
   ICommandResult,
@@ -5,12 +12,6 @@ import type {
   IEditCheckpointRestoreResult,
   IEditCheckpointSummary,
 } from '@robota-sdk/agent-framework';
-import {
-  inspectCommandEditCheckpoint,
-  listCommandEditCheckpoints,
-  restoreCommandEditCheckpoint,
-  rollbackCommandEditCheckpoint,
-} from '@robota-sdk/agent-framework';
 
 const SUBCOMMAND_INDEX = 0;
 const CHECKPOINT_ID_INDEX = 1;

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

@@ -1,9 +1,3 @@
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
 import {
   CLEAR_COMMAND_DESCRIPTION,
   COST_COMMAND_DESCRIPTION,
@@ -11,6 +5,7 @@ import {
   RESUME_COMMAND_DESCRIPTION,
   VALIDATE_SESSION_COMMAND_DESCRIPTION,
 } from '@robota-sdk/agent-framework';
+
 import {
   executeClearCommand,
   executeCostCommand,
@@ -19,6 +14,13 @@ import {
   executeValidateSessionCommand,
 } from './session-command.js';
 
+import type {
+  ICommand,
+  ICommandModule,
+  ICommandSource,
+  ISystemCommand,
+} from '@robota-sdk/agent-framework';
+
 export function createClearCommandEntry(): ICommand {
   return {
     name: 'clear',

package/src/session/session-command.ts

@@ -1,4 +1,3 @@
-import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
 import {
   RENAME_COMMAND_USAGE,
   clearConversationHistory,
@@ -10,6 +9,8 @@ import {
   validateCommandSessionReplayLog,
 } from '@robota-sdk/agent-framework';
 
+import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
+
 export const CLEAR_COMMAND_MESSAGE = 'Conversation cleared.';
 
 export function executeClearCommand(context: ICommandHostContext, _args: string): ICommandResult {

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

@@ -1,14 +1,16 @@
+import { SkillCommandSource } from '@robota-sdk/agent-framework';
+
+import { executeSkillsCommand, SKILLS_COMMAND_DESCRIPTION } from './skills-command.js';
+
 import type {
   ICommand,
   ICommandModule,
   ICommandSource,
   ISystemCommand,
 } from '@robota-sdk/agent-framework';
-import { SkillCommandSource } from '@robota-sdk/agent-framework';
-import { executeSkillsCommand, SKILLS_COMMAND_DESCRIPTION } from './skills-command.js';
 
 export interface ISkillsCommandModuleOptions {
-  readonly cwd?: string;
+  readonly cwd: string;
 }
 
 export function createSkillsCommandEntry(): ICommand {
@@ -48,11 +50,9 @@ export class SkillsCommandSource implements ICommandSource {
   }
 }
 
-export function createSkillsCommandModule(
-  options: ISkillsCommandModuleOptions = {},
-): ICommandModule {
+export function createSkillsCommandModule(options: ISkillsCommandModuleOptions): ICommandModule {
   const commandSources: ICommandSource[] = [new SkillsCommandSource()];
-  commandSources.push(new SkillCommandSource(options.cwd ?? process.cwd()));
+  commandSources.push(new SkillCommandSource(options.cwd));
 
   return {
     name: 'agent-command-skills',

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

@@ -1,16 +1,18 @@
-import type {
-  ICommand,
-  ICommandModule,
-  ICommandSource,
-  ISystemCommand,
-} from '@robota-sdk/agent-framework';
 import {
   buildStatusLineCommandSubcommands,
   STATUSLINE_COMMAND_ARGUMENT_HINT,
   STATUSLINE_COMMAND_DESCRIPTION,
 } from '@robota-sdk/agent-framework';
+
 import { executeStatusLineCommand } from './statusline-command.js';
 
+import type {
+  ICommand,
+  ICommandModule,
+  ICommandSource,
+  ISystemCommand,
+} from '@robota-sdk/agent-framework';
+
 export function createStatusLineCommandEntry(): ICommand {
   return {
     name: 'statusline',

package/src/statusline/statusline-command.ts

@@ -1,9 +1,10 @@
+import { DEFAULT_STATUS_LINE_COMMAND_SETTINGS } from '@robota-sdk/agent-framework';
+
 import type {
   ICommandHostContext,
   ICommandResult,
   TStatusLineCommandSettingsPatch,
 } from '@robota-sdk/agent-framework';
-import { DEFAULT_STATUS_LINE_COMMAND_SETTINGS } from '@robota-sdk/agent-framework';
 
 interface IStatusLineCommandSuccessAction {
   success: true;

package/src/user-local/user-local-command-module.ts

@@ -1,14 +1,15 @@
+import {
+  USER_LOCAL_COMMAND_ARGUMENT_HINT,
+  USER_LOCAL_COMMAND_DESCRIPTION,
+  executeUserLocalCommand,
+} from './user-local-command.js';
+
 import type {
   ICommand,
   ICommandModule,
   ICommandSource,
   ISystemCommand,
 } from '@robota-sdk/agent-framework';
-import {
-  USER_LOCAL_COMMAND_ARGUMENT_HINT,
-  USER_LOCAL_COMMAND_DESCRIPTION,
-  executeUserLocalCommand,
-} from './user-local-command.js';
 
 export function createUserLocalCommandEntry(): ICommand {
   return {

package/src/user-local/user-local-command.ts

@@ -1,7 +1,9 @@
-import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
 import { inspectUserLocalStorage } from '@robota-sdk/agent-framework';
-import { executeMemoryCommand } from './user-local-memory-command.js';
+
 import { USER_LOCAL_COMMAND_USAGE } from './user-local-command-constants.js';
+import { executeMemoryCommand } from './user-local-memory-command.js';
+
+import type { ICommandHostContext, ICommandResult } from '@robota-sdk/agent-framework';
 export {
   USER_LOCAL_COMMAND_ARGUMENT_HINT,
   USER_LOCAL_COMMAND_DESCRIPTION,

package/src/user-local/user-local-memory-command.ts

@@ -1,4 +1,3 @@
-import type { ICommandResult, TUserLocalMemoryCategory } from '@robota-sdk/agent-framework';
 import {
   deleteUserLocalMemoryItem,
   disableUserLocalMemoryItem,
@@ -6,8 +5,11 @@ import {
   listUserLocalMemoryItems,
   setUserLocalMemoryItem,
 } from '@robota-sdk/agent-framework';
+
 import { USER_LOCAL_COMMAND_USAGE } from './user-local-command-constants.js';
 
+import type { ICommandResult, TUserLocalMemoryCategory } from '@robota-sdk/agent-framework';
+
 export interface IUserLocalMemoryCommandArgs {
   readonly action?: string;
   readonly positional: readonly string[];