@robota-sdk/agent-command 3.0.0-beta.100

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

@@ -0,0 +1,55 @@
+import {
+  buildLanguageCommandSubcommands,
+  LANGUAGE_COMMAND_ARGUMENT_HINT,
+  LANGUAGE_COMMAND_DESCRIPTION,
+} from '@robota-sdk/agent-framework';
+
+import { executeLanguageCommand } from './language-command.js';
+
+import type { ICommandModule, ISystemCommand } from '@robota-sdk/agent-framework';
+import type { ICommand, ICommandSource } from '@robota-sdk/agent-interface-command';
+
+export function createLanguageCommandEntry(): ICommand {
+  return {
+    name: 'language',
+    displayName: 'Language',
+    description: LANGUAGE_COMMAND_DESCRIPTION,
+    source: 'language',
+    argumentHint: LANGUAGE_COMMAND_ARGUMENT_HINT,
+    subcommands: buildLanguageCommandSubcommands('language'),
+    // User-only: the user's response-language preference.
+    modelInvocable: false,
+  };
+}
+
+function createLanguageSystemCommand(): ISystemCommand {
+  const entry = createLanguageCommandEntry();
+  return {
+    name: entry.name,
+    displayName: entry.displayName,
+    description: entry.description,
+    requiresPermission: false,
+    userInvocable: true,
+    modelInvocable: false,
+    argumentHint: entry.argumentHint,
+    subcommands: entry.subcommands,
+    lifecycle: 'inline',
+    execute: executeLanguageCommand,
+  };
+}
+
+export class LanguageCommandSource implements ICommandSource {
+  readonly name = 'language';
+
+  getCommands(): ICommand[] {
+    return [createLanguageCommandEntry()];
+  }
+}
+
+export function createLanguageCommandModule(): ICommandModule {
+  return {
+    name: 'agent-command-language',
+    commandSources: [new LanguageCommandSource()],
+    systemCommands: [createLanguageSystemCommand()],
+  };
+}

package/src/language/language-command.ts

@@ -0,0 +1,52 @@
+import { selectAction } from '@robota-sdk/agent-core';
+import {
+  buildLanguageCommandSubcommands,
+  formatLanguageUsageMessage,
+  parseLanguageArgument,
+} from '@robota-sdk/agent-framework';
+
+import type { ICommandHostUserInteraction } from '@robota-sdk/agent-framework';
+import type { ICommandResult } from '@robota-sdk/agent-interface-command';
+
+/**
+ * Ask the user to pick a language (CMD-004 inline ask). Returns a validated language, or `undefined`
+ * when no interactive renderer is attached or the user cancelled — the caller then shows usage.
+ */
+async function resolveLanguageViaAsk(
+  context: ICommandHostUserInteraction,
+): Promise<string | undefined> {
+  const ui = context.getUserInteraction();
+  if (!ui) return undefined;
+  const options = buildLanguageCommandSubcommands().map((sub) => ({
+    value: sub.name,
+    label: sub.name,
+    description: sub.description,
+  }));
+  const response = await ui.ask(selectAction('language', 'Select language', options));
+  const picked = response.type === 'answer' ? response.values[0] : undefined;
+  return picked === undefined ? undefined : parseLanguageArgument(picked);
+}
+
+export async function executeLanguageCommand(
+  context: ICommandHostUserInteraction,
+  args: string,
+): Promise<ICommandResult> {
+  let language = parseLanguageArgument(args);
+
+  if (language === undefined) {
+    language = await resolveLanguageViaAsk(context);
+    if (language === undefined) {
+      return {
+        message: formatLanguageUsageMessage(),
+        success: false,
+      };
+    }
+  }
+
+  return {
+    message: `Language set to "${language}".`,
+    success: true,
+    data: { language },
+    hostActions: [{ type: 'language-change', language }],
+  };
+}