@plosson/agentio 0.4.1 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plosson/agentio",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "CLI for LLM agents to interact with communication and tracking services",
   "type": "module",
   "license": "MIT",

package/src/commands/docs.ts

@@ -0,0 +1,126 @@
+import { Command } from 'commander';
+
+interface CommandInfo {
+  fullPath: string;
+  description: string;
+  arguments: string[];
+  options: Array<{ flags: string; description: string; defaultValue?: string }>;
+}
+
+function collectCommands(cmd: Command, parentPath: string = ''): CommandInfo[] {
+  const results: CommandInfo[] = [];
+  const help = cmd.createHelp();
+
+  // Get visible subcommands (filters out help command)
+  const subcommands = help.visibleCommands(cmd).filter((c) => c.name() !== 'help');
+
+  for (const subcmd of subcommands) {
+    const fullPath = parentPath ? `${parentPath} ${subcmd.name()}` : subcmd.name();
+
+    // Get arguments
+    const args = help.visibleArguments(subcmd).map((arg) => {
+      const argName = arg.variadic ? `${arg.name()}...` : arg.name();
+      return arg.required ? `<${argName}>` : `[${argName}]`;
+    });
+
+    // Get options (filter out help)
+    const options = help
+      .visibleOptions(subcmd)
+      .filter((opt) => !opt.long?.includes('help'))
+      .map((opt) => {
+        const flags = opt.flags;
+        const desc = opt.description;
+        const defaultVal = opt.defaultValue;
+        return { flags, description: desc, defaultValue: defaultVal };
+      });
+
+    const description = subcmd.description() || '';
+
+    // Only add if it's a leaf command or has its own action
+    const childCommands = help.visibleCommands(subcmd).filter((c) => c.name() !== 'help');
+    if (childCommands.length === 0 || options.length > 0 || args.length > 0) {
+      results.push({
+        fullPath,
+        description,
+        arguments: args,
+        options,
+      });
+    }
+
+    // Recurse into subcommands
+    results.push(...collectCommands(subcmd, fullPath));
+  }
+
+  return results;
+}
+
+function formatOption(opt: { flags: string; description: string; defaultValue?: string }): string {
+  let line = opt.flags;
+  if (opt.description) {
+    line += `: ${opt.description}`;
+  }
+  if (opt.defaultValue !== undefined && opt.defaultValue !== '') {
+    line += ` (default: ${opt.defaultValue})`;
+  }
+  return line;
+}
+
+// Commands excluded from docs output by default (utility/meta commands)
+const EXCLUDED_COMMANDS = ['config', 'status', 'update', 'claude', 'docs'];
+
+function generateDocs(program: Command, services?: string[]): string {
+  const lines: string[] = [];
+  const version = program.version();
+
+  lines.push(`# agentio CLI v${version}`);
+  lines.push('');
+
+  let commands = collectCommands(program, 'agentio');
+
+  // Filter by services if specified, otherwise exclude utility commands
+  // Always exclude profile subcommands
+  commands = commands.filter((cmd) => {
+    if (cmd.fullPath.includes(' profile ')) {
+      return false;
+    }
+    const parts = cmd.fullPath.split(' ');
+    const service = parts[1];
+    if (services && services.length > 0) {
+      return services.includes(service);
+    }
+    return !EXCLUDED_COMMANDS.includes(service);
+  });
+
+  for (const cmd of commands) {
+    // Header with full path and arguments
+    let header = `## ${cmd.fullPath}`;
+    if (cmd.arguments.length > 0) {
+      header += ` ${cmd.arguments.join(' ')}`;
+    }
+    lines.push(header);
+
+    // Description
+    if (cmd.description) {
+      lines.push(cmd.description);
+    }
+
+    // Options
+    for (const opt of cmd.options) {
+      lines.push(formatOption(opt));
+    }
+
+    lines.push('');
+  }
+
+  return lines.join('\n').trimEnd();
+}
+
+export function registerDocsCommand(program: Command): void {
+  program
+    .command('docs')
+    .description('Output CLI reference for LLMs')
+    .option('--service <names>', 'Filter by service (comma-separated)', (val) => val.split(',').map((s: string) => s.trim()))
+    .action((options) => {
+      console.log(generateDocs(program, options.service));
+    });
+}

package/src/commands/gchat.ts

@@ -134,7 +134,8 @@ export function registerGChatCommands(program: Command): void {
     });
 
   gchat
-    .command('get <message-id>')
+    .command('get')
+    .argument('<message-id>', 'Message ID')
     .description('Get a message from a Google Chat space (OAuth profiles only)')
     .option('--profile <name>', 'Profile name (optional if only one profile exists)')
     .requiredOption('--space <id>', 'Space ID')

package/src/commands/gdocs.ts

@@ -24,7 +24,8 @@ export function registerGDocsCommands(program: Command): void {
     .description('Google Docs operations');
 
   gdocs
-    .command('get <doc-id-or-url>')
+    .command('get')
+    .argument('<doc-id-or-url>', 'Document ID or URL')
     .description('Export a document')
     .option('--profile <name>', 'Profile name (optional if only one profile exists)')
     .option('--format <format>', 'Export format: markdown or docx', 'markdown')

package/src/commands/gdrive.ts

@@ -95,7 +95,8 @@ Query Syntax Examples:
     });
 
   gdrive
-    .command('get <file-id-or-url>')
+    .command('get')
+    .argument('<file-id-or-url>', 'File ID or URL')
     .description('Get file metadata')
     .option('--profile <name>', 'Profile name')
     .action(async (fileIdOrUrl: string, options) => {
@@ -132,7 +133,8 @@ Query Syntax Examples:
     });
 
   gdrive
-    .command('download <file-id-or-url>')
+    .command('download')
+    .argument('<file-id-or-url>', 'File ID or URL')
     .description('Download a file (or export Google Workspace files)')
     .option('--profile <name>', 'Profile name')
     .requiredOption('--output <path>', 'Output file path')
@@ -164,7 +166,8 @@ Examples:
     });
 
   gdrive
-    .command('put <file-path>')
+    .command('put')
+    .argument('<file-path>', 'Local file path')
     .description('Upload a file to Google Drive')
     .option('--profile <name>', 'Profile name')
     .option('--name <name>', 'Name for the file in Drive (defaults to local filename)')

package/src/commands/gmail.ts

@@ -101,7 +101,8 @@ export function registerGmailCommands(program: Command): void {
     });
 
   gmail
-    .command('get <message-id>')
+    .command('get')
+    .argument('<message-id>', 'Message ID')
     .description('Get a message')
     .option('--profile <name>', 'Profile name (optional if only one profile exists)')
     .option('--format <format>', 'Body format: text, html, or raw', 'text')
@@ -275,7 +276,8 @@ Query Syntax Examples:
     });
 
   gmail
-    .command('archive <message-id...>')
+    .command('archive')
+    .argument('<message-id...>', 'Message ID(s)')
     .description('Archive one or more messages')
     .option('--profile <name>', 'Profile name (optional if only one profile exists)')
     .action(async (messageIds: string[], options) => {
@@ -291,7 +293,8 @@ Query Syntax Examples:
     });
 
   gmail
-    .command('mark <message-id...>')
+    .command('mark')
+    .argument('<message-id...>', 'Message ID(s)')
     .description('Mark one or more messages as read or unread')
     .option('--profile <name>', 'Profile name (optional if only one profile exists)')
     .option('--read', 'Mark as read')
@@ -316,7 +319,8 @@ Query Syntax Examples:
     });
 
   gmail
-    .command('attachment <message-id>')
+    .command('attachment')
+    .argument('<message-id>', 'Message ID')
     .description('Download attachments from a message')
     .option('--profile <name>', 'Profile name (optional if only one profile exists)')
     .option('--name <filename>', 'Download specific attachment by filename (downloads all if not specified)')
@@ -359,7 +363,8 @@ Query Syntax Examples:
     });
 
   gmail
-    .command('export <message-id>')
+    .command('export')
+    .argument('<message-id>', 'Message ID')
     .description('Export a message as PDF')
     .option('--profile <name>', 'Profile name (optional if only one profile exists)')
     .option('--output <path>', 'Output file path', 'message.pdf')

package/src/index.ts

@@ -15,6 +15,7 @@ import { registerUpdateCommand } from './commands/update';
 import { registerConfigCommands } from './commands/config';
 import { registerClaudeCommands } from './commands/claude';
 import { registerStatusCommand } from './commands/status';
+import { registerDocsCommand } from './commands/docs';
 
 declare const BUILD_VERSION: string | undefined;
 
@@ -48,5 +49,6 @@ registerUpdateCommand(program);
 registerConfigCommands(program);
 registerClaudeCommands(program);
 registerStatusCommand(program);
+registerDocsCommand(program);
 
 program.parse();