@agentuity/cli 3.0.0-alpha.7 → 3.0.0-beta.0

package/src/cmd/ai/index.ts

@@ -1,51 +0,0 @@
-import { createCommand } from '../../types';
-import capabilitiesCommand from './capabilities';
-import promptCommand from './prompt';
-import schemaCommand from './schema';
-import opencodeCommand from './opencode';
-import claudeCodeCommand from './claude-code';
-import introSubcommand from './intro';
-import detectSubcommand from './detect';
-import { getCommand } from '../../command-prefix';
-
-export const command = createCommand({
-	name: 'ai',
-	description: 'AI coding agent related commands',
-	skipUpgradeCheck: true,
-	tags: ['fast'],
-	examples: [
-		{
-			command: getCommand('ai detect'),
-			description: 'Detect if running from an AI coding agent',
-		},
-		{
-			command: getCommand('ai intro'),
-			description: 'Introduce the Agentuity CLI to your AI agent',
-		},
-		{
-			command: getCommand('ai opencode install'),
-			description: 'Install Agentuity Open Code plugin',
-		},
-		{
-			command: getCommand('ai claude-code install'),
-			description: 'Install Agentuity Coder plugin for Claude Code',
-		},
-		{
-			command: getCommand('ai capabilities show'),
-			description: 'Show CLI capabilities for AI agents',
-		},
-		{
-			command: getCommand('ai schema show'),
-			description: 'Output CLI schema for AI consumption',
-		},
-	],
-	subcommands: [
-		detectSubcommand,
-		introSubcommand,
-		opencodeCommand,
-		claudeCodeCommand,
-		capabilitiesCommand,
-		promptCommand,
-		schemaCommand,
-	],
-});

package/src/cmd/ai/intro.ts

@@ -1,174 +0,0 @@
-import { createSubcommand } from '../../types';
-import type { CommandContext } from '../../types';
-import { getCommand } from '../../command-prefix';
-import { getExecutingAgent, getAgentDisplayName, KNOWN_AGENTS } from '../../agent-detection';
-import { getVersion } from '../../version';
-import * as tui from '../../tui';
-
-/**
- * Generate the introduction prompt for AI agents
- */
-export function generateIntroPrompt(agent: string | undefined): string {
-	const agentGreeting = agent ? `Hello ${getAgentDisplayName(agent)}! ` : 'Hello! ';
-
-	const detectedAgents = KNOWN_AGENTS.map(([, name]) => getAgentDisplayName(name)).join(', ');
-
-	return `${agentGreeting}Welcome to the Agentuity CLI (v${getVersion()}).
-
-## What is Agentuity?
-
-Agentuity is a cloud platform for building, deploying, and running AI agents with production-grade infrastructure. It provides:
-
-- **Serverless Agent Runtime**: Deploy agents that scale automatically with zero cold starts
-- **Built-in Services**: Key-value storage, vector databases, object storage, and PostgreSQL - all accessible via simple APIs
-- **Agent-to-Agent Communication**: Agents can discover and communicate with each other seamlessly
-- **Observability**: Full tracing, logging, and monitoring out of the box
-- **Developer Experience**: Local development server, hot reload, and TypeScript-first SDK
-
-## How to Use This CLI
-
-The Agentuity CLI is designed to be agent-friendly. Here are the key commands:
-
-### Discovery & Introspection
-\`\`\`bash
-${getCommand('<command> --describe')}     # Get command schema as JSON (args, options, response)
-${getCommand('--help=json')}              # Get complete CLI schema as JSON
-${getCommand('ai capabilities show')}     # List all capabilities and workflows
-${getCommand('ai schema show')}           # Detailed command metadata
-\`\`\`
-
-### Project Management
-\`\`\`bash
-${getCommand('project create')}           # Create a new Agentuity project
-${getCommand('project list')}             # List all projects
-${getCommand('dev')}                      # Start local development server
-\`\`\`
-
-### Deployment
-\`\`\`bash
-${getCommand('cloud deploy')}             # Deploy to production
-${getCommand('cloud deployment list')}    # List deployments
-${getCommand('cloud deployment logs')}    # View deployment logs
-\`\`\`
-
-### Cloud Services
-\`\`\`bash
-${getCommand('cloud kv')}                 # Key-value storage operations
-${getCommand('cloud vector')}             # Vector database operations
-${getCommand('cloud storage')}            # Object storage operations
-${getCommand('env set KEY value')}        # Set environment variables
-${getCommand('env set KEY value --secret')} # Set secrets (encrypted)
-\`\`\`
-
-## Best Practices for AI Agents
-
-1. **Use \`--input <json>\` to pass arguments and options as a single JSON object**
-   \`\`\`bash
-   ${getCommand('cloud sandbox create --input \'{"runtime":"bun:1","memory":"1Gi","network":true}\'')}
-   ${getCommand('cloud kv set --input \'{"namespace":"ns","key":"k","value":"v","ttl":300}\'')}
-   \`\`\`
-   JSON keys must be the **camelCase schema keys** shown by \`--describe\` output (not kebab-case flag names). For example, the flag \`--dry-run\` becomes \`dryRun\` in JSON. CLI flags take precedence over --input values.
-
-2. **Use \`--describe\` to introspect what a command accepts before calling it**
-   \`\`\`bash
-   ${getCommand('cloud sandbox create --describe')}
-   \`\`\`
-   Returns the full command schema as JSON: arguments, options (with types), response shape, requirements, and examples. No authentication required.
-
-3. **Use \`--fields\` with \`--json\` to limit output and protect your context window**
-   \`\`\`bash
-   ${getCommand('--json --fields "id,name,status" cloud deployment list')}
-   \`\`\`
-   Comma-separated field names, supports dot notation for nested fields (e.g., \`properties.title\`).
-
-4. **Always use \`--json\` for machine-readable output**
-   \`\`\`bash
-   ${getCommand('--json project list')}
-   \`\`\`
-
-5. **Use \`--dry-run\` to test commands safely before mutating**
-   \`\`\`bash
-   ${getCommand('--dry-run cloud deploy')}
-   \`\`\`
-
-6. **Use \`--validate\` to check inputs without executing**
-   \`\`\`bash
-   ${getCommand('--validate cloud kv set --input \'{"namespace":"ns","key":"k","value":"v"}\'')}
-   \`\`\`
-
-7. **Check requirements before running commands**
-   - Many commands require authentication (\`${getCommand('auth login')}\`)
-   - Project commands require an \`agentuity.json\` file in the current directory
-
-## Error Handling
-
-Errors are returned as structured JSON when using \`--json\`:
-\`\`\`json
-{
-  "error": {
-    "code": "AUTH_REQUIRED",
-    "message": "Authentication required",
-    "suggestions": ["Run '${getCommand('auth login')}' to authenticate"]
-  }
-}
-\`\`\`
-
-## Getting Started Workflow
-
-1. \`${getCommand('auth login')}\` - Authenticate with Agentuity
-2. \`${getCommand('project create')}\` - Create a new project (or work in existing one)
-3. \`${getCommand('dev')}\` - Start local development
-4. \`${getCommand('cloud deploy')}\` - Deploy to production
-
-## Agent Detection
-
-This CLI can detect when it's being run by an AI coding agent. Currently supported agents: ${detectedAgents}.
-
-${agent ? `You were detected as: **${getAgentDisplayName(agent)}**` : 'No agent was detected for this session.'}
-
-## More Information
-
-- Documentation: https://agentuity.dev/docs
-- API Reference: https://agentuity.dev/api
-- Examples: https://github.com/agentuity/examples
-
-For detailed command help, use \`${getCommand('<command> --help')}\` or \`${getCommand('--help=json')}\` for the full schema.
-`;
-}
-
-export const introSubcommand = createSubcommand({
-	name: 'intro',
-	description: 'Introduction to Agentuity CLI for AI coding agents',
-	tags: ['read-only', 'fast'],
-	idempotent: true,
-	examples: [{ command: getCommand('ai intro'), description: 'Show introduction for AI agents' }],
-	handler(_ctx: CommandContext) {
-		const agent = getExecutingAgent();
-
-		if (!agent) {
-			// Human is running this command directly
-			tui.newline();
-			tui.info(tui.bold('This command is designed for AI coding agents'));
-			tui.newline();
-			console.log(
-				`  This command outputs an introduction to the Agentuity CLI that helps AI\n` +
-					`  coding agents understand how to use the platform effectively.\n`
-			);
-			console.log(`  ${tui.bold('To use this command:')}\n`);
-			console.log(
-				`  Ask your AI coding agent to run ${tui.colorPrimary(`"${getCommand('ai intro')}"`)} to introduce\n` +
-					`  itself to the Agentuity platform and learn how to help you build and deploy agents.\n`
-			);
-			console.log(
-				`  ${tui.muted('Supported agents:')} ${KNOWN_AGENTS.map(([, name]) => getAgentDisplayName(name)).join(', ')}\n`
-			);
-			return;
-		}
-
-		// Agent is running this command - output the full prompt
-		const prompt = generateIntroPrompt(agent);
-		console.log(prompt);
-	},
-});
-
-export default introSubcommand;