@agentuity/cli 1.0.34 → 1.0.36

package/bin/cli.ts

@@ -26,6 +26,7 @@ import type { GlobalOptions } from '../src/types';
 import { ensureBunOnPath } from '../src/bun-path';
 import { checkForUpdates } from '../src/version-check';
 import { closeDatabase } from '../src/cache';
+import { ErrorCode, createError, formatErrorJSON } from '../src/errors';
 import { createInternalLogger } from '../src/internal-logger';
 import { createCompositeLogger } from '../src/composite-logger';
 import { getAuth } from '../src/config';
@@ -342,21 +343,52 @@ try {
 		((errorWithMessage._tag === 'ServiceException' && errorWithMessage.statusCode === 402) ||
 			errorWithMessage._tag === 'PaymentRequiredError')
 	) {
-		const { errorBox, link, newline } = await import('../src/tui');
-		const overrides = config?.overrides as { app_url?: string } | undefined;
-		const appBaseUrl = getAppBaseURL(undefined, overrides);
-		const billingUrl = `${appBaseUrl}/billing`;
-		newline();
-		errorBox(
-			'Out of Credit',
-			`Your organization is out of credit.\n\nPlease add more here:\n${link(billingUrl)}`,
-			false // standalone box, not connected to a guide
-		);
+		if (earlyOpts.errorFormat === 'json') {
+			console.error(
+				formatErrorJSON(
+					createError(
+						ErrorCode.PAYMENT_REQUIRED,
+						'Your organization is out of credit. Please visit your billing page to add credit.'
+					)
+				)
+			);
+		} else {
+			const { errorBox, link, newline } = await import('../src/tui');
+			const overrides = config?.overrides as { app_url?: string } | undefined;
+			const appBaseUrl = getAppBaseURL(undefined, overrides);
+			const billingUrl = `${appBaseUrl}/billing`;
+			newline();
+			errorBox(
+				'Out of Credit',
+				`Your organization is out of credit.\n\nPlease add more here:\n${link(billingUrl)}`,
+				false // standalone box, not connected to a guide
+			);
+		}
 		closeDatabase();
 		exit(1);
 	}
 
-	if (isStructuredError(error)) {
+	if (earlyOpts.errorFormat === 'json') {
+		const message = errorWithMessage?.message ?? String(error);
+		const code = isStructuredError(error) ? ErrorCode.API_ERROR : ErrorCode.INTERNAL_ERROR;
+		const details: Record<string, unknown> = {};
+		if (isStructuredError(error) && errorWithMessage._tag) {
+			details.tag = errorWithMessage._tag;
+		}
+		if (
+			typeof error === 'object' &&
+			error !== null &&
+			'status' in error &&
+			typeof (error as any).status === 'number'
+		) {
+			details.status = (error as any).status;
+		}
+		console.error(
+			formatErrorJSON(
+				createError(code, message, Object.keys(details).length > 0 ? details : undefined)
+			)
+		);
+	} else if (isStructuredError(error)) {
 		logger.error(error);
 	} else {
 		logger.error(

package/dist/ai-help.js

@@ -71,6 +71,7 @@ function buildContent(schema, config) {
     const sections = [
         buildHeader(config),
         buildWhenToUse(),
+        buildAgentOptimizedIO(),
         buildQuickReference(schema),
         buildCommandReference(schema),
         buildGlobalOptions(schema),
@@ -103,6 +104,65 @@ Do NOT use this CLI for:
 - Non-AI/agent related tasks
 - Direct database queries (use the SDK or cloud console)`;
 }
+/**
+ * Build Agent-Optimized Input/Output section
+ */
+function buildAgentOptimizedIO() {
+    return `## Agent-Optimized Input/Output
+
+This CLI provides structured input and output modes designed for AI agents:
+
+### Structured Input: \`--input <json>\`
+
+Pass all arguments and options as a single JSON object instead of individual flags:
+
+\`\`\`bash
+# Instead of individual flags:
+agentuity cloud sandbox create --runtime "bun:1" --memory "1Gi" --network --port 8080
+
+# Use structured JSON input:
+agentuity cloud sandbox create --input '{"runtime":"bun:1","memory":"1Gi","network":true,"port":8080}'
+\`\`\`
+
+JSON keys map to argument and option names from the command schema. CLI flags take precedence over \`--input\` values.
+
+### Schema Introspection: \`--describe\`
+
+Discover what any command accepts at runtime without executing it:
+
+\`\`\`bash
+agentuity cloud sandbox create --describe
+# Returns: { "name": "create", "options": [...], "arguments": [...], "response": {...} }
+\`\`\`
+
+No authentication required. Use this to self-serve command schemas instead of reading documentation.
+
+### Output Field Filtering: \`--fields <fields>\`
+
+Limit JSON output to only the fields you need (protects context window):
+
+\`\`\`bash
+agentuity --json --fields "id,name,status" cloud deployment list
+\`\`\`
+
+Supports dot notation for nested fields (e.g., \`properties.title\`). Applies to arrays automatically.
+
+### Input Validation: \`--validate\`
+
+Validate your input without executing the command:
+
+\`\`\`bash
+agentuity --validate cloud kv set --input '{"namespace":"ns","key":"k","value":"v"}'
+# Returns: { "valid": true, "command": "cloud kv set" }
+\`\`\`
+
+### Recommended Agent Workflow
+
+1. **Discover**: \`agentuity <command> --describe\` — learn what the command accepts
+2. **Validate**: \`agentuity --validate <command> --input '{...}'\` — check input before executing
+3. **Execute**: \`agentuity --json <command> --input '{...}' --fields "id,status"\` — run with structured I/O
+4. **Dry-run**: \`agentuity --dry-run <command> --input '{...}'\` — test mutating operations safely`;
+}
 /**
  * Build Quick Reference with 15-20 most common operations
  */

package/dist/ai-help.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-help.js","sourceRoot":"","sources":["../src/ai-help.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai-help.js","sourceRoot":"","sources":["../src/ai-help.ts"],"names":[],"mappings":"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"}

package/dist/cache/agent-intro.d.ts

@@ -10,4 +10,14 @@ export declare function hasAgentSeenIntro(agentId: string): boolean;
  * Silently fails on error (non-critical feature).
  */
 export declare function markAgentIntroSeen(agentId: string): void;
+/**
+ * Check if an agent has already seen the structured input hint.
+ * Returns true on error to avoid blocking CLI (assumes seen).
+ */
+export declare function hasAgentSeenInputHint(agentId: string): boolean;
+/**
+ * Mark an agent as having seen the structured input hint.
+ * Silently fails on error (non-critical feature).
+ */
+export declare function markAgentInputHintSeen(agentId: string): void;
 //# sourceMappingURL=agent-intro.d.ts.map

package/dist/cache/agent-intro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-intro.d.ts","sourceRoot":"","sources":["../../src/cache/agent-intro.ts"],"names":[],"mappings":"AA2BA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAY1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CASxD"}
+{"version":3,"file":"agent-intro.d.ts","sourceRoot":"","sources":["../../src/cache/agent-intro.ts"],"names":[],"mappings":"AA2BA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAY1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CASxD;AAsBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAY9D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAU5D"}

package/dist/cache/agent-intro.js

@@ -51,4 +51,54 @@ export function markAgentIntroSeen(agentId) {
         // Non-critical - intro tracking failure shouldn't block CLI
     }
 }
+/**
+ * Ensure the agent_input_hint_seen table exists.
+ * Called lazily on first hint check.
+ */
+let hintTableCreated = false;
+function ensureHintTable() {
+    if (hintTableCreated)
+        return;
+    try {
+        getDatabase().run(`
+			CREATE TABLE IF NOT EXISTS agent_input_hint_seen (
+				agent_id TEXT PRIMARY KEY,
+				first_seen_at INTEGER NOT NULL
+			)
+		`);
+        hintTableCreated = true;
+    }
+    catch {
+        // Non-critical
+    }
+}
+/**
+ * Check if an agent has already seen the structured input hint.
+ * Returns true on error to avoid blocking CLI (assumes seen).
+ */
+export function hasAgentSeenInputHint(agentId) {
+    try {
+        ensureHintTable();
+        const row = getDatabase()
+            .query('SELECT agent_id FROM agent_input_hint_seen WHERE agent_id = ?')
+            .get(agentId);
+        return row !== null;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Mark an agent as having seen the structured input hint.
+ * Silently fails on error (non-critical feature).
+ */
+export function markAgentInputHintSeen(agentId) {
+    try {
+        ensureHintTable();
+        getDatabase().run('INSERT OR IGNORE INTO agent_input_hint_seen (agent_id, first_seen_at) VALUES (?, ?)', [agentId, Date.now()]);
+    }
+    catch {
+        // Non-critical
+    }
+}
 //# sourceMappingURL=agent-intro.js.map

package/dist/cache/agent-intro.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-intro.js","sourceRoot":"","sources":["../../src/cache/agent-intro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,IAAI,EAAE,GAAoB,IAAI,CAAC;AAE/B;;;GAGG;AACH,SAAS,WAAW;IACnB,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAClD,EAAE,CAAC,GAAG,CAAC;;;;;EAKN,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAChD,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,WAAW,EAAE;aACvB,KAAK,CACL,0DAA0D,CAC1D;aACA,GAAG,CAAC,OAAO,CAAC,CAAC;QACf,OAAO,GAAG,KAAK,IAAI,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACR,6CAA6C;QAC7C,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IACjD,IAAI,CAAC;QACJ,WAAW,EAAE,CAAC,GAAG,CAChB,gFAAgF,EAChF,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CACrB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,4DAA4D;IAC7D,CAAC;AACF,CAAC"}
+{"version":3,"file":"agent-intro.js","sourceRoot":"","sources":["../../src/cache/agent-intro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,IAAI,EAAE,GAAoB,IAAI,CAAC;AAE/B;;;GAGG;AACH,SAAS,WAAW;IACnB,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAClD,EAAE,CAAC,GAAG,CAAC;;;;;EAKN,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAChD,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,WAAW,EAAE;aACvB,KAAK,CACL,0DAA0D,CAC1D;aACA,GAAG,CAAC,OAAO,CAAC,CAAC;QACf,OAAO,GAAG,KAAK,IAAI,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACR,6CAA6C;QAC7C,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IACjD,IAAI,CAAC;QACJ,WAAW,EAAE,CAAC,GAAG,CAChB,gFAAgF,EAChF,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CACrB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,4DAA4D;IAC7D,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,IAAI,gBAAgB,GAAG,KAAK,CAAC;AAC7B,SAAS,eAAe;IACvB,IAAI,gBAAgB;QAAE,OAAO;IAC7B,IAAI,CAAC;QACJ,WAAW,EAAE,CAAC,GAAG,CAAC;;;;;GAKjB,CAAC,CAAC;QACH,gBAAgB,GAAG,IAAI,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACR,eAAe;IAChB,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACpD,IAAI,CAAC;QACJ,eAAe,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,WAAW,EAAE;aACvB,KAAK,CACL,+DAA+D,CAC/D;aACA,GAAG,CAAC,OAAO,CAAC,CAAC;QACf,OAAO,GAAG,KAAK,IAAI,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACrD,IAAI,CAAC;QACJ,eAAe,EAAE,CAAC;QAClB,WAAW,EAAE,CAAC,GAAG,CAChB,qFAAqF,EACrF,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CACrB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,eAAe;IAChB,CAAC;AACF,CAAC"}

package/dist/cache/index.d.ts

@@ -1,5 +1,5 @@
 export { getResourceInfo, getResourceRegion, setResourceInfo, setResourceRegion, deleteResourceRegion, clearProfileCache, closeDatabase, type ResourceType, type ResourceInfo, } from './resource-region';
 export { getCachedProject, setCachedProject, clearProjectCache } from './project-cache';
-export { hasAgentSeenIntro, markAgentIntroSeen } from './agent-intro';
+export { hasAgentSeenIntro, markAgentIntroSeen, hasAgentSeenInputHint, markAgentInputHintSeen, } from './agent-intro';
 export { getCachedUserInfo, setCachedUserInfo, clearCachedUserInfo } from './user-cache';
 //# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,YAAY,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAExF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,YAAY,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAExF,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/cache/index.js

@@ -1,5 +1,5 @@
 export { getResourceInfo, getResourceRegion, setResourceInfo, setResourceRegion, deleteResourceRegion, clearProfileCache, closeDatabase, } from './resource-region';
 export { getCachedProject, setCachedProject, clearProjectCache } from './project-cache';
-export { hasAgentSeenIntro, markAgentIntroSeen } from './agent-intro';
+export { hasAgentSeenIntro, markAgentIntroSeen, hasAgentSeenInputHint, markAgentInputHintSeen, } from './agent-intro';
 export { getCachedUserInfo, setCachedUserInfo, clearCachedUserInfo } from './user-cache';
 //# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,GAGb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAExF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,GAGb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAExF,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EACX,iBAAiB,EAEjB,cAAc,EAEd,MAAM,EAGN,MAAM,EAGN,MAAM,SAAS,CAAC;AAWjB,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AA6c3E,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA8OjE;AAkFD,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;CAC3C;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyJ3F;AAunCD,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAoOf"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EACX,iBAAiB,EAEjB,cAAc,EAEd,MAAM,EAGN,MAAM,EAGN,MAAM,SAAS,CAAC;AAWjB,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AAqd3E,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoPjE;AAkFD,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;CAC3C;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyJ3F;AAyqCD,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CA6Of"}

package/dist/cli.js

@@ -225,11 +225,16 @@ function handleValidationError(error, commandName, baseCtx) {
             const primaryMessage = errorMessages.length === 1 && errorMessages[0]
                 ? errorMessages[0]
                 : 'Invalid options or arguments';
+            const suggestions = [`Run 'agentuity ${commandName} --help' for usage information`];
+            // Add agent-friendly hints when running from an AI agent
+            if (getExecutingAgent()) {
+                suggestions.push(`Run 'agentuity ${commandName} --describe' to see the command schema as JSON`, `Use --input '{...}' to pass arguments and options as a JSON object`);
+            }
             exitWithError({
                 code: ErrorCode.VALIDATION_FAILED,
                 message: primaryMessage,
                 details: errorMessages.length > 1 ? { errors: errorMessages } : undefined,
-                suggestions: [`Run 'agentuity ${commandName} --help' for usage information`],
+                suggestions,
             }, baseCtx.logger, baseCtx.options.errorFormat ?? 'text');
         }
     }
@@ -392,7 +397,10 @@ export async function createCLI(version) {
         .option('--explain', 'Show what the command would do without executing', false)
         .option('--dry-run', 'Execute command without making changes', false)
         .option('--validate', 'Validate arguments and options without executing', false)
-        .option('--ai-help', 'Show AI-optimized help in dashdash format', false);
+        .option('--ai-help', 'Show AI-optimized help in dashdash format', false)
+        .option('--input <json>', 'Pass arguments and options as a JSON object (for agents)')
+        .option('--describe', 'Output command schema as JSON for agent introspection', false)
+        .option('--fields <fields>', 'Filter JSON output to specified fields (comma-separated, dot notation for nested)');
     const skipVersionCheckOption = program.createOption('--skip-version-check', 'Skip version compatibility check (dev only)');
     skipVersionCheckOption.hideHelp();
     program.addOption(skipVersionCheckOption);
@@ -798,6 +806,17 @@ async function registerSubcommand(parent, subcommand, baseCtx, hidden) {
             .action(() => {
             cmd.help();
         });
+        // Handle --describe for command-group nodes
+        cmd.action(async () => {
+            if (baseCtx.options.describe) {
+                const { extractSubcommandSchema } = await import('./schema-generator');
+                const schema = extractSubcommandSchema(subcommand);
+                const { outputJSON } = await import('./output');
+                outputJSON(schema);
+                return;
+            }
+            cmd.help();
+        });
         // Don't add options to parent commands - only to leaf commands
         return;
     }
@@ -958,6 +977,24 @@ async function registerSubcommand(parent, subcommand, baseCtx, hidden) {
         const cmdObj = rawArgs[rawArgs.length - 1];
         const options = cmdObj.opts();
         const args = rawArgs.slice(0, -1);
+        // Handle --describe mode: output command schema and exit
+        if (baseCtx.options.describe) {
+            const { extractSubcommandSchema } = await import('./schema-generator');
+            const schema = extractSubcommandSchema(subcommand);
+            const { outputJSON } = await import('./output');
+            outputJSON(schema);
+            return;
+        }
+        // One-time hint for agents about structured input/output features
+        // Emitted on stderr so it doesn't interfere with --json stdout
+        const detectedAgent = getExecutingAgent();
+        if (detectedAgent) {
+            const { hasAgentSeenInputHint, markAgentInputHintSeen } = await import('./cache');
+            if (!hasAgentSeenInputHint(detectedAgent)) {
+                markAgentInputHintSeen(detectedAgent);
+                console.error(`[agent] This CLI supports structured I/O for agents: --input <json> (structured input), --describe (schema introspection), --fields (output filtering). Run --ai-help for details.`);
+            }
+        }
         // Merge global --org-id and --project-id into subcommand options when the schema
         // defines these fields. Global options (program-level) capture the values first,
         // so subcommand-level options may not have them. Only merge when the user
@@ -1114,9 +1151,7 @@ async function registerSubcommand(parent, subcommand, baseCtx, hidden) {
                 try {
                     // Check if command uses stdin (don't auto-confirm if it does)
                     const usesStdin = subcommand.tags?.includes('uses-stdin') ?? false;
-                    const input = await buildValidationInputAsync(subcommand.schema, args, options, {
-                        usesStdin,
-                    });
+                    const input = await buildValidationInputAsync(subcommand.schema, args, options, { usesStdin }, baseCtx.options.input);
                     const ctx = {
                         ...baseCtx,
                         config: {
@@ -1342,7 +1377,7 @@ async function registerSubcommand(parent, subcommand, baseCtx, hidden) {
                     const usesStdin = subcommand.tags?.includes('uses-stdin') ?? false;
                     const input = await buildValidationInputAsync(subcommand.schema, args, options, {
                         usesStdin,
-                    });
+                    }, baseCtx.options.input);
                     const ctx = {
                         ...baseCtx,
                         config: auth
@@ -1547,7 +1582,7 @@ async function registerSubcommand(parent, subcommand, baseCtx, hidden) {
                     const usesStdin = subcommand.tags?.includes('uses-stdin') ?? false;
                     const input = await buildValidationInputAsync(subcommand.schema, args, options, {
                         usesStdin,
-                    });
+                    }, baseCtx.options.input);
                     const ctx = {
                         ...baseCtx,
                     };
@@ -1685,6 +1720,14 @@ export async function registerCommands(program, commands, baseCtx) {
             }
             if (cmdDef.handler) {
                 cmd.action(async () => {
+                    // Handle --describe mode: output command schema and exit
+                    if (baseCtx.options.describe) {
+                        const { extractCommandSchema } = await import('./schema-generator');
+                        const schema = extractCommandSchema(cmdDef);
+                        const { outputJSON } = await import('./output');
+                        outputJSON(schema);
+                        return;
+                    }
                     if (cmdDef.banner) {
                         showBanner();
                     }