@vellumai/plugin-api 0.10.8-dev.202607111430.dcd3b7b → 0.10.8-dev.202607111622.3c66378

package/index.d.ts

@@ -1912,6 +1912,12 @@ declare interface ClawhubSlimSkill extends SlimSkillBase {
 
 export declare const CLI_COMMAND_HELP: readonly CliCommandHelp[];
 
+declare interface CliArgumentHelp {
+    /** Commander argument spec, e.g. `"<channel>"` or `"[value]"`. */
+    name: string;
+    description: string;
+}
+
 /**
  * Fully declarative description of a top-level `assistant` CLI command and its
  * subcommands. Plain data by design — no action handlers — so plugins (e.g. the
@@ -1929,6 +1935,13 @@ declare interface CliCommandHelp {
      */
     args?: string;
     description: string;
+    /**
+     * Positional arguments that carry their own description, applied via
+     * Commander's `argument(name, description)` (rendered in the generated
+     * `Arguments:` help section). Use `args` instead when the positional needs
+     * no description.
+     */
+    arguments?: CliArgumentHelp[];
     /** Options declared directly on the top-level command. */
     options?: CliOptionHelp[];
     /** Extra help appended after the option list (`addHelpText("after", …)`). */
@@ -1970,7 +1983,7 @@ declare interface CliOptionHelp {
     /** When true, applied via `requiredOption` (missing → error) rather than `option`. */
     required?: boolean;
     /** Default value passed to `option(flags, description, defaultValue)`. */
-    defaultValue?: string;
+    defaultValue?: string | number | boolean;
     /** Allowed values, applied via Commander's `Option.choices()` (invalid → error). */
     choices?: readonly string[];
 }
@@ -1980,9 +1993,18 @@ declare interface CliSubcommandHelp {
     /** Positional-argument spec, e.g. `"<path>"` — see {@link CliCommandHelp.args}. */
     args?: string;
     description: string;
+    /**
+     * Positional arguments that carry their own description, applied via
+     * Commander's `argument(name, description)` (rendered in the generated
+     * `Arguments:` help section). Use `args` instead when the positional needs
+     * no description.
+     */
+    arguments?: CliArgumentHelp[];
     options?: CliOptionHelp[];
     /** Extra help appended after the option list (`addHelpText("after", …)`). */
     helpText?: string;
+    /** When true, this subcommand runs when the parent is invoked without one. */
+    isDefault?: boolean;
     /** Nested subcommand groups (e.g. `avatar character update`). */
     subcommands?: CliSubcommandHelp[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.8-dev.202607111430.dcd3b7b",
+  "version": "0.10.8-dev.202607111622.3c66378",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",