@orchagent/cli 0.2.4 → 0.2.6

package/dist/commands/call.js

@@ -109,6 +109,15 @@ function registerCallCommand(program) {
         .option('--no-skills', 'Ignore default skills')
         .option('--file <path...>', 'File(s) to upload (can specify multiple)')
         .option('--metadata <json>', 'JSON metadata to send with files')
+        .addHelpText('after', `
+Examples:
+  orch call orchagent/invoice-scanner invoice.pdf
+  orch call orchagent/leak-finder --data '{"repo_url": "https://github.com/org/repo"}'
+  cat input.json | orch call acme/agent --data @-
+  orch call acme/image-processor photo.jpg --output result.png
+
+Note: Use 'call' for server-side execution (requires login), 'run' for local execution.
+`)
         .action(async (agentRef, file, options) => {
         const resolved = await (0, config_1.getResolvedConfig)();
         if (!resolved.apiKey) {

package/dist/commands/info.js

@@ -14,6 +14,24 @@ function parseAgentRef(value) {
     }
     throw new errors_1.CliError('Invalid agent reference. Use org/agent format (e.g., joe/leak-finder)');
 }
+function formatSchema(schema, indent = '  ') {
+    const lines = [];
+    const props = schema.properties || {};
+    const required = schema.required || [];
+    for (const [key, value] of Object.entries(props)) {
+        let typeStr = value.type || 'any';
+        if (typeStr === 'array' && value.items?.type) {
+            typeStr = `${value.items.type}[]`;
+        }
+        const reqMark = required.includes(key) ? '' : '?';
+        let line = `${indent}${key}${reqMark}: ${typeStr}`;
+        if (value.description) {
+            line += ` - ${value.description}`;
+        }
+        lines.push(line);
+    }
+    return lines.join('\n');
+}
 function deriveReadmeUrl(sourceUrl) {
     // Parse GitHub URLs like:
     // git+https://github.com/user/repo.git#subdirectory=path
@@ -76,6 +94,16 @@ function registerInfoCommand(program) {
                 process.stdout.write(`Run: ${agentData.run_command}\n`);
             }
         }
+        // Display input schema if available
+        if (agentData.input_schema?.properties && Object.keys(agentData.input_schema.properties).length > 0) {
+            process.stdout.write('\nInput Schema:\n');
+            process.stdout.write(formatSchema(agentData.input_schema) + '\n');
+        }
+        // Display output schema if available
+        if (agentData.output_schema?.properties && Object.keys(agentData.output_schema.properties).length > 0) {
+            process.stdout.write('\nOutput Schema:\n');
+            process.stdout.write(formatSchema(agentData.output_schema) + '\n');
+        }
         // Fetch and display README if available
         if (agentData.source_url) {
             const readmeUrl = deriveReadmeUrl(agentData.source_url);

package/dist/commands/run.js

@@ -289,7 +289,9 @@ async function unzipBundle(zipPath, destDir) {
         });
     });
 }
-async function executeBundleAgent(config, org, agentName, version, agentData, args) {
+async function executeBundleAgent(config, org, agentName, version, agentData, args, inputOption) {
+    // Capture the user's working directory before we change anything
+    const userCwd = process.cwd();
     // Create temp directory for the bundle
     const tempDir = path_1.default.join(os_1.default.tmpdir(), `orchagent-${agentName}-${Date.now()}`);
     await promises_1.default.mkdir(tempDir, { recursive: true });
@@ -331,30 +333,50 @@ async function executeBundleAgent(config, org, agentName, version, agentData, ar
         catch {
             throw new errors_1.CliError(`Entrypoint not found: ${entrypoint}`);
         }
-        // Build input JSON from args
-        // The first arg should be the input (file path or JSON string)
+        // Build input JSON from --input option or positional args
         let inputJson = '{}';
-        if (args.length > 0) {
+        if (inputOption) {
+            // --input was provided, use it directly (should be valid JSON)
+            try {
+                // Parse and re-stringify to validate JSON
+                const parsed = JSON.parse(inputOption);
+                // Resolve any relative paths in the input to absolute paths
+                if (typeof parsed === 'object' && parsed !== null) {
+                    for (const key of ['path', 'directory', 'file_path']) {
+                        if (typeof parsed[key] === 'string' && !path_1.default.isAbsolute(parsed[key])) {
+                            parsed[key] = path_1.default.resolve(userCwd, parsed[key]);
+                        }
+                    }
+                }
+                inputJson = JSON.stringify(parsed);
+            }
+            catch {
+                throw new errors_1.CliError('Invalid JSON in --input option');
+            }
+        }
+        else if (args.length > 0) {
             const firstArg = args[0];
+            // Resolve to absolute path relative to user's working directory
+            const resolvedArg = path_1.default.isAbsolute(firstArg) ? firstArg : path_1.default.resolve(userCwd, firstArg);
             // Check if it's a file path
             try {
-                const stat = await promises_1.default.stat(firstArg);
+                const stat = await promises_1.default.stat(resolvedArg);
                 if (stat.isFile()) {
                     // Read file content as input
-                    const fileContent = await promises_1.default.readFile(firstArg, 'utf-8');
+                    const fileContent = await promises_1.default.readFile(resolvedArg, 'utf-8');
                     // Check if it's already JSON
                     try {
                         JSON.parse(fileContent);
                         inputJson = fileContent;
                     }
                     catch {
-                        // Wrap as file_path in JSON
-                        inputJson = JSON.stringify({ file_path: firstArg });
+                        // Wrap as file_path in JSON (use absolute path)
+                        inputJson = JSON.stringify({ file_path: resolvedArg });
                     }
                 }
                 else if (stat.isDirectory()) {
-                    // Pass directory path
-                    inputJson = JSON.stringify({ directory: firstArg });
+                    // Pass directory path (use absolute path)
+                    inputJson = JSON.stringify({ directory: resolvedArg });
                 }
             }
             catch {
@@ -364,7 +386,7 @@ async function executeBundleAgent(config, org, agentName, version, agentData, ar
                     inputJson = firstArg;
                 }
                 catch {
-                    // Treat as a simple string input
+                    // Treat as a simple string input (could be a URL)
                     inputJson = JSON.stringify({ input: firstArg });
                 }
             }
@@ -474,6 +496,15 @@ function registerRunCommand(program) {
         .option('--skills <skills>', 'Add skills (comma-separated)')
         .option('--skills-only <skills>', 'Use only these skills')
         .option('--no-skills', 'Ignore default skills')
+        .addHelpText('after', `
+Examples:
+  orch run orchagent/leak-finder --input '{"path": "."}'
+  orch run orchagent/leak-finder --input '{"repo_url": "https://github.com/org/repo"}'
+  orch run joe/summarizer --input '{"text": "Hello world"}'
+  orch run orchagent/leak-finder --download-only
+
+Note: Use 'run' for local execution, 'call' for server-side execution.
+`)
         .action(async (agentRef, args, options) => {
         const resolved = await (0, config_1.getResolvedConfig)();
         const parsed = parseAgentRef(agentRef);
@@ -536,7 +567,7 @@ function registerRunCommand(program) {
                     return;
                 }
                 // Execute the bundle-based code agent locally
-                await executeBundleAgent(resolved, org, parsed.agent, parsed.version, agentData, args);
+                await executeBundleAgent(resolved, org, parsed.agent, parsed.version, agentData, args, options.input);
                 return;
             }
             // Check for pip/source-based local execution (legacy)

package/dist/index.js

@@ -51,7 +51,13 @@ const program = new commander_1.Command();
 program
     .name('orchagent')
     .description('OrchAgent CLI')
-    .version(package_json_1.default.version);
+    .version(package_json_1.default.version)
+    .addHelpText('after', `
+Quick Reference:
+  run   Download and run an agent locally (your machine)
+  call  Execute an agent on OrchAgent servers (requires login)
+  info  Show agent details and input/output schemas
+`);
 (0, commands_1.registerCommands)(program);
 program
     .parseAsync(process.argv)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchagent/cli",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Command-line interface for the OrchAgent AI agent marketplace",
   "license": "MIT",
   "author": "OrchAgent <hello@orchagent.io>",
@@ -38,6 +38,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:all": "vitest run && vitest run --config vitest.e2e.config.ts",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {