Commands: add dynamic arg menus

src/auto-reply/commands-registry.types.ts

@@ -2,12 +2,51 @@ import type { ClawdbotConfig } from "../config/types.js";
 
 export type CommandScope = "text" | "native" | "both";
 
+export type CommandArgType = "string" | "number" | "boolean";
+
+export type CommandArgChoiceContext = {
+  cfg?: ClawdbotConfig;
+  provider?: string;
+  model?: string;
+  command: ChatCommandDefinition;
+  arg: CommandArgDefinition;
+};
+
+export type CommandArgChoicesProvider = (context: CommandArgChoiceContext) => string[];
+
+export type CommandArgDefinition = {
+  name: string;
+  description: string;
+  type: CommandArgType;
+  required?: boolean;
+  choices?: string[] | CommandArgChoicesProvider;
+  captureRemaining?: boolean;
+};
+
+export type CommandArgMenuSpec = {
+  arg: string;
+  title?: string;
+};
+
+export type CommandArgValues = Record<string, unknown>;
+
+export type CommandArgs = {
+  raw?: string;
+  values?: CommandArgValues;
+};
+
+export type CommandArgsParsing = "none" | "positional";
+
 export type ChatCommandDefinition = {
   key: string;
   nativeName?: string;
   description: string;
   textAliases: string[];
   acceptsArgs?: boolean;
+  args?: CommandArgDefinition[];
+  argsParsing?: CommandArgsParsing;
+  formatArgs?: (values: CommandArgValues) => string | undefined;
+  argsMenu?: CommandArgMenuSpec | "auto";
   scope: CommandScope;
 };
 
@@ -15,6 +54,7 @@ export type NativeCommandSpec = {
   name: string;
   description: string;
   acceptsArgs: boolean;
+  args?: CommandArgDefinition[];
 };
 
 export type CommandNormalizeOptions = {