@vellumai/plugin-api 0.10.7-dev.202607101106.c87f4e3 → 0.10.7-dev.202607101252.74ea83d

package/index.d.ts

@@ -1909,6 +1909,25 @@ declare interface ClawhubSlimSkill extends SlimSkillBase {
     version: string;
 }
 
+export declare const CLI_COMMAND_HELP: readonly CliCommandHelp[];
+
+/**
+ * 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
+ * memory capability indexer) can import a command's help and iterate over it
+ * without dragging in the CLI's daemon/IPC action graph. Command modules apply
+ * the same data via {@link applyCommandHelp}, then attach their handlers.
+ */
+declare interface CliCommandHelp {
+    name: string;
+    description: string;
+    /** Options declared directly on the top-level command. */
+    options?: CliOptionHelp[];
+    /** Extra help appended after the option list (`addHelpText("after", …)`). */
+    helpText?: string;
+    subcommands?: CliSubcommandHelp[];
+}
+
 declare interface ClientEntry extends BaseSubscriberEntry {
     type: "client";
     clientId: string;
@@ -1936,6 +1955,24 @@ declare interface ClientSettingsUpdate {
     value: string;
 }
 
+declare interface CliOptionHelp {
+    /** Commander flag spec, e.g. `"--path <file>"` or `"-l, --limit <n>"`. */
+    flags: string;
+    description: string;
+    /** When true, applied via `requiredOption` (missing → error) rather than `option`. */
+    required?: boolean;
+    /** Default value passed to `option(flags, description, defaultValue)`. */
+    defaultValue?: string;
+}
+
+declare interface CliSubcommandHelp {
+    name: string;
+    description: string;
+    options?: CliOptionHelp[];
+    /** Extra help appended after the option list (`addHelpText("after", …)`). */
+    helpText?: string;
+}
+
 declare type CompactionCircuitClosedEvent = z.infer<typeof CompactionCircuitClosedEventSchema>;
 
 declare const CompactionCircuitClosedEventSchema: z.ZodObject<{

package/index.js

@@ -1,5 +1,6 @@
 // Generated by scripts/build-plugin-api.ts — do not edit by hand.
 const api = globalThis[Symbol.for("vellum.plugin-api")] ?? {};
+export const CLI_COMMAND_HELP = api.CLI_COMMAND_HELP;
 export const HOOKS = api.HOOKS;
 export const RiskLevel = api.RiskLevel;
 export const addMessage = api.addMessage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.7-dev.202607101106.c87f4e3",
+  "version": "0.10.7-dev.202607101252.74ea83d",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",