@agentuity/cli 0.0.51 → 0.0.52

package/dist/cmd/ai/prompt/llm.js

@@ -0,0 +1,365 @@
+import { createSubcommand } from '../../../types';
+import { getCommand } from '../../../command-prefix';
+export const llmSubcommand = createSubcommand({
+    name: 'llm',
+    description: 'Generate a comprehensive prompt for LLM agents',
+    tags: ['read-only', 'fast'],
+    idempotent: true,
+    examples: [getCommand('prompt llm')],
+    async handler(_ctx) {
+        const prompt = generateLLMPrompt();
+        console.log(prompt);
+    },
+});
+function generateLLMPrompt() {
+    return `# Agentuity CLI - Agent Usage Guide
+
+## Overview
+
+The Agentuity CLI is an agent-friendly command-line interface for managing cloud deployments, projects, secrets, and infrastructure. It provides machine-readable output, introspection capabilities, and safety features designed for automated agent usage.
+
+## Key Principles for Agent Usage
+
+1. **Always use \`--json\` for machine-readable output**
+   - All commands support \`--json\` for structured output
+   - Errors are also output as JSON when using \`--error-format=json\` (automatically set with \`--json\`)
+
+2. **Use \`--explain\` before executing destructive operations**
+   - Preview what a command will do without executing it
+   - Provides structured explanation with steps, prerequisites, and warnings
+
+3. **Use \`--dry-run\` for safe exploration**
+   - Execute validation and planning without making changes
+   - Test commands safely before actual execution
+
+4. **Discover capabilities programmatically**
+   - Use \`${getCommand('--help=json')}\` to get the complete CLI schema
+   - Use \`${getCommand('capabilities show --json')}\` to discover available tasks
+   - Use \`${getCommand('schema show')}\` for detailed command metadata
+
+## Machine-Readable Modes
+
+### Global Flags
+
+- \`--json\`: Output in JSON format (machine-readable)
+- \`--quiet\`: Suppress non-essential output (only errors shown)
+- \`--no-progress\`: Disable progress indicators and spinners
+- \`--error-format json\`: Structured error output with error codes
+- \`--explain\`: Show what command would do without executing
+- \`--dry-run\`: Execute without making changes
+- \`--color never\`: Disable color output
+
+### Recommended Flag Combinations
+
+For agent usage:
+\`\`\`bash
+${getCommand('--json --quiet command')}
+\`\`\`
+
+For safe exploration:
+\`\`\`bash
+${getCommand('--explain command args')}
+${getCommand('--dry-run command args')}
+\`\`\`
+
+## Introspection Capabilities
+
+### 1. Schema Discovery
+
+Get the complete CLI schema with all commands, arguments, options, and requirements:
+
+\`\`\`bash
+${getCommand('--help=json')}
+${getCommand('schema show')}
+\`\`\`
+
+The schema includes:
+- Command names and descriptions
+- Arguments (type, required/optional, variadic)
+- Options (type, defaults, enums)
+- Authentication requirements
+- Project requirements
+- Examples
+
+### 2. Capabilities Discovery
+
+Get high-level tasks and workflows:
+
+\`\`\`bash
+${getCommand('capabilities show --json')}
+\`\`\`
+
+This returns:
+- Functional capabilities (auth, projects, deployment, secrets, etc.)
+- Common workflows with step-by-step instructions
+- Requirements for each capability (auth, project)
+
+### 3. Examples
+
+All commands include examples in their help text and schema:
+
+\`\`\`bash
+${getCommand('command subcommand --help')}
+\`\`\`
+
+## Error Handling
+
+### Structured Errors
+
+When using \`--json\` or \`--error-format=json\`, errors are structured:
+
+\`\`\`json
+{
+  "error": {
+    "code": "PROJECT_NOT_FOUND",
+    "message": "Invalid project folder",
+    "details": {},
+    "suggestions": [
+      "Use --dir to specify a different directory",
+      "Change to a directory containing agentuity.json",
+      "Run \\"${getCommand('project create')}\\" to create a new project"
+    ]
+  }
+}
+\`\`\`
+
+### Common Error Codes
+
+- \`VALIDATION_FAILED\`: Invalid arguments or options
+- \`AUTH_REQUIRED\`: Authentication needed
+- \`PROJECT_NOT_FOUND\`: No project configuration found
+- \`REGION_REQUIRED\`: Cloud region must be specified
+- \`RESOURCE_NOT_FOUND\`: Requested resource doesn't exist
+- \`PERMISSION_DENIED\`: Insufficient permissions
+
+### Error Recovery
+
+Always check error details and suggestions for recovery steps. Errors include actionable guidance.
+
+## Authentication Flow
+
+### Required for Most Operations
+
+Many commands require authentication. Check the schema's \`requires.auth\` field.
+
+### Authentication Commands
+
+\`\`\`bash
+# Check if authenticated
+${getCommand('auth whoami')}
+
+# Login (interactive)
+${getCommand('auth login')}
+
+# Signup (interactive)
+${getCommand('auth signup')}
+\`\`\`
+
+### Non-Interactive Environments
+
+In non-TTY environments:
+- Commands requiring interactive input will fail with clear error messages
+- Use API keys or pre-authenticate before running automated tasks
+- Some commands support \`--confirm\` to skip interactive prompts
+
+## Project Context
+
+### Project-Based Commands
+
+Commands requiring a project look for \`agentuity.json\` in the current directory.
+
+### Specifying Project Directory
+
+\`\`\`bash
+${getCommand('--dir /path/to/project command')}
+\`\`\`
+
+### Creating a Project
+
+\`\`\`bash
+${getCommand('project create')}
+\`\`\`
+
+## Common Workflows
+
+### 1. Initial Setup
+
+\`\`\`bash
+${getCommand('auth signup')}
+${getCommand('auth login')}
+${getCommand('project create')}
+${getCommand('secret set API_KEY <value>')}
+\`\`\`
+
+### 2. Deploy Application
+
+\`\`\`bash
+# Preview deployment
+${getCommand('--explain bundle')}
+
+# Test deployment (dry-run)
+${getCommand('--dry-run cloud deploy')}
+
+# Actual deployment
+${getCommand('bundle')}
+${getCommand('cloud deploy')}
+
+# Check deployment status
+${getCommand('--json cloud deployment show')}
+\`\`\`
+
+### 3. Manage Secrets
+
+\`\`\`bash
+${getCommand('--json secret list')}
+${getCommand('secret set DATABASE_URL <value>')}
+${getCommand('secret get DATABASE_URL')}
+\`\`\`
+
+### 4. List Resources
+
+\`\`\`bash
+${getCommand('--json project list')}
+${getCommand('--json cloud deployment list')}
+${getCommand('--json kv list')}
+\`\`\`
+
+## Best Practices
+
+### 1. Always Validate First
+
+- Use \`--explain\` to understand what will happen
+- Use \`--dry-run\` for commands that mutate state
+- Check schema to understand command requirements
+
+### 2. Use Structured Output
+
+- Always use \`--json\` when parsing output programmatically
+- Parse error messages from structured error format
+- Never rely on human-readable text parsing
+
+### 3. Handle Non-Interactive Mode
+
+- Detect TTY status
+- Provide all required arguments upfront
+- Use \`--confirm\` or similar flags to skip prompts
+
+### 4. Check Requirements
+
+Before running a command, verify from schema:
+- Does it require authentication?
+- Does it require a project context?
+- Does it require organization or region selection?
+
+### 5. Progressive Enhancement
+
+Start with safe operations:
+1. Discover capabilities (\`capabilities show\`)
+2. Get schema for specific command (\`--help=json\`)
+3. Use \`--explain\` to preview
+4. Use \`--dry-run\` to test
+5. Execute actual command
+
+### 6. Error Recovery
+
+When an error occurs:
+1. Parse the error code
+2. Read the suggestions array
+3. Take corrective action
+4. Retry the operation
+
+## Agent Safety Guidelines
+
+### Destructive Operations
+
+For destructive operations (delete, remove, rollback):
+1. ALWAYS use \`--explain\` first
+2. ALWAYS use \`--dry-run\` before execution
+3. Verify the operation matches intent
+4. Only then execute the actual command
+
+### Confirmation Flags
+
+Many destructive commands support:
+- \`--confirm\`: Skip confirmation prompts (be careful!)
+- \`--no-confirm\`: Disable confirmation (dangerous!)
+
+### Non-Destructive Exploration
+
+These are always safe:
+- \`--help\`, \`--help=json\`
+- \`capabilities show\`
+- \`schema show\`
+- \`--explain\` (never executes)
+- \`--dry-run\` (no side effects)
+- List commands (\`list\`, \`ls\`)
+- Show commands (\`show\`, \`get\` without mutations)
+
+## Examples for Common Tasks
+
+### Discover All Commands
+
+\`\`\`bash
+${getCommand('--help=json')} | jq '.commands[].name'
+\`\`\`
+
+### Find Commands Requiring Auth
+
+\`\`\`bash
+${getCommand('--help=json')} | jq '.commands[] | select(.requires.auth == true) | .name'
+\`\`\`
+
+### Get Details About a Specific Command
+
+\`\`\`bash
+${getCommand('auth ssh delete --help')}
+${getCommand('--help=json')} | jq '.commands[] | select(.name == "auth")'
+\`\`\`
+
+### Test a Deployment
+
+\`\`\`bash
+${getCommand('--explain bundle')}
+${getCommand('--dry-run cloud deploy')}
+${getCommand('cloud deploy')}
+\`\`\`
+
+### Safe SSH Key Deletion
+
+\`\`\`bash
+${getCommand('--explain auth ssh delete abc123')}
+${getCommand('--dry-run auth ssh delete abc123')}
+${getCommand('auth ssh delete abc123')}
+\`\`\`
+
+## Version Information
+
+This prompt is for Agentuity CLI. Always check the version:
+
+\`\`\`bash
+${getCommand('version')}
+\`\`\`
+
+The CLI follows semantic versioning. Check schema compatibility across versions.
+
+## Getting Help
+
+- CLI Schema: \`${getCommand('--help=json')}\`
+- Capabilities: \`${getCommand('capabilities show')}\`
+- Command Help: \`${getCommand('command --help')}\`
+- Examples: Included in help text for all commands
+
+## Summary
+
+The Agentuity CLI is designed for agent-friendly usage with:
+- Complete introspection via \`--help=json\` and \`schema\` commands
+- Machine-readable output via \`--json\`
+- Safety features via \`--explain\` and \`--dry-run\`
+- Structured errors with recovery suggestions
+- Comprehensive examples for all commands
+
+Always start with discovery (\`capabilities\`, \`schema\`), use safety features (\`--explain\`, \`--dry-run\`), and rely on structured output (\`--json\`) for reliable automation.
+`;
+}
+export default llmSubcommand;
+//# sourceMappingURL=llm.js.map

package/dist/cmd/ai/prompt/llm.js.map

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

package/dist/cmd/ai/schema/index.js

@@ -0,0 +1,10 @@
+import { createCommand } from '../../../types';
+import { showSubcommand } from './show';
+export const schemaCommand = createCommand({
+    name: 'schema',
+    description: 'Output CLI schema in machine-readable format',
+    tags: ['read-only', 'fast'],
+    subcommands: [showSubcommand],
+});
+export default schemaCommand;
+//# sourceMappingURL=index.js.map

package/dist/cmd/ai/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cmd/ai/schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,CAAC,MAAM,aAAa,GAAsB,aAAa,CAAC;IAC7D,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,8CAA8C;IAC3D,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,CAAC,cAAc,CAAC;CAC7B,CAAC,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/cmd/ai/schema/show.js

@@ -0,0 +1,23 @@
+import { createSubcommand } from '../../../types';
+import { ErrorCode } from '../../../errors';
+import { getCommand } from '../../../command-prefix';
+export const showSubcommand = createSubcommand({
+    name: 'show',
+    description: 'Display the complete CLI schema',
+    tags: ['read-only', 'fast'],
+    idempotent: true,
+    examples: [getCommand('schema show'), getCommand('--help=json')],
+    async handler(ctx) {
+        const { logger } = ctx;
+        // Access the schema stored in the global context
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const schema = global.__CLI_SCHEMA__;
+        if (!schema) {
+            logger.fatal('Schema not available. This is a CLI bug.', ErrorCode.INTERNAL_ERROR);
+        }
+        // Always output JSON (this command is primarily for machine consumption)
+        console.log(JSON.stringify(schema, null, 2));
+    },
+});
+export default showSubcommand;
+//# sourceMappingURL=show.js.map

package/dist/cmd/ai/schema/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../../src/cmd/ai/schema/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAuB,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;IAC9C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,iCAAiC;IAC9C,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;IAChE,KAAK,CAAC,OAAO,CAAC,GAAmB;QAChC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QAEvB,iDAAiD;QACjD,8DAA8D;QAC9D,MAAM,MAAM,GAAI,MAAc,CAAC,cAAc,CAAC;QAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,0CAA0C,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;QACpF,CAAC;QAED,yEAAyE;QACzE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/cmd/auth/api.js

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+import { APIError, APIResponseSchema, APIResponseSchemaOptionalData } from '@agentuity/server';
+// Zod schemas for API validation
+const OTPStartDataSchema = z.object({
+    otp: z.string(),
+});
+const OTPCompleteDataSchema = z.object({
+    apiKey: z.string(),
+    userId: z.string(),
+    expires: z.number(),
+});
+const SignupCompleteDataSchema = z.object({
+    userId: z.string(),
+    apiKey: z.string(),
+    expiresAt: z.number(),
+});
+const OTPCheckRequestSchema = z.object({
+    otp: z.string(),
+});
+export async function generateLoginOTP(apiClient) {
+    const resp = await apiClient.request('GET', '/cli/auth/start', APIResponseSchema(OTPStartDataSchema));
+    if (!resp.success) {
+        throw new Error(resp.message);
+    }
+    if (!resp.data) {
+        throw new Error('No OTP returned from server');
+    }
+    return resp.data.otp;
+}
+export async function pollForLoginCompletion(apiClient, otp, timeoutMs = 60000) {
+    const started = Date.now();
+    while (Date.now() - started < timeoutMs) {
+        const resp = await apiClient.request('POST', '/cli/auth/check', APIResponseSchemaOptionalData(OTPCompleteDataSchema), { otp }, OTPCheckRequestSchema);
+        if (!resp.success) {
+            throw new Error(resp.message);
+        }
+        if (resp.data) {
+            return {
+                apiKey: resp.data.apiKey,
+                userId: resp.data.userId,
+                expires: new Date(resp.data.expires),
+            };
+        }
+        await Bun.sleep(2000);
+    }
+    throw new Error('Login timed out');
+}
+export function generateSignupOTP() {
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+    let result = '';
+    const array = new Uint8Array(5);
+    crypto.getRandomValues(array);
+    for (let i = 0; i < 5; i++) {
+        result += chars[array[i] % chars.length];
+    }
+    return result;
+}
+export async function pollForSignupCompletion(apiClient, otp, timeoutMs = 350000) {
+    const started = Date.now();
+    while (Date.now() - started < timeoutMs) {
+        try {
+            const resp = await apiClient.request('GET', `/cli/auth/signup/${otp}`, APIResponseSchema(SignupCompleteDataSchema));
+            if (!resp.success) {
+                throw new Error(resp.message);
+            }
+            if (resp.data) {
+                return {
+                    apiKey: resp.data.apiKey,
+                    userId: resp.data.userId,
+                    expires: new Date(resp.data.expiresAt),
+                };
+            }
+        }
+        catch (error) {
+            if (error instanceof APIError && error.status === 404) {
+                await Bun.sleep(2000);
+                continue;
+            }
+            throw error;
+        }
+        await Bun.sleep(2000);
+    }
+    throw new Error('Signup timed out');
+}
+//# sourceMappingURL=api.js.map

package/dist/cmd/auth/api.js.map

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

package/dist/cmd/auth/index.js

@@ -0,0 +1,13 @@
+import { createCommand } from '../../types';
+import { loginCommand } from './login';
+import { logoutCommand } from './logout';
+import { signupCommand } from './signup';
+import { whoamiCommand } from './whoami';
+import { sshSubcommand } from './ssh';
+export const command = createCommand({
+    name: 'auth',
+    description: 'Authentication and authorization related commands',
+    tags: ['read-only', 'fast'],
+    subcommands: [loginCommand, logoutCommand, signupCommand, whoamiCommand, sshSubcommand],
+});
+//# sourceMappingURL=index.js.map

package/dist/cmd/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cmd/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC;IACpC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,mDAAmD;IAChE,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,CAAC;CACvF,CAAC,CAAC"}

package/dist/cmd/auth/login.js

@@ -0,0 +1,84 @@
+import { createSubcommand } from '../../types';
+import { UpgradeRequiredError, ValidationError } from '@agentuity/server';
+import { getAppBaseURL } from '../../api';
+import { saveAuth } from '../../config';
+import { generateLoginOTP, pollForLoginCompletion } from './api';
+import * as tui from '../../tui';
+import { getCommand } from '../../command-prefix';
+import { ErrorCode } from '../../errors';
+export const loginCommand = createSubcommand({
+    name: 'login',
+    description: 'Login to the Agentuity Platform using a browser-based authentication flow',
+    tags: ['mutating', 'creates-resource', 'slow', 'api-intensive'],
+    toplevel: true,
+    idempotent: false,
+    requires: { apiClient: true },
+    examples: [getCommand('auth login'), getCommand('login')],
+    async handler(ctx) {
+        const { logger, config, apiClient } = ctx;
+        if (!apiClient) {
+            throw new Error('API client is not available. This is likely a configuration or initialization issue.');
+        }
+        const appUrl = getAppBaseURL(config);
+        try {
+            const otp = await tui.spinner({
+                message: 'Generating login one time code...',
+                clearOnSuccess: true,
+                callback: () => {
+                    return generateLoginOTP(apiClient);
+                },
+            });
+            if (!otp) {
+                return;
+            }
+            const authURL = `${appUrl}/auth/cli`;
+            const copied = await tui.copyToClipboard(otp);
+            tui.newline();
+            if (copied) {
+                console.log(`Code copied to clipboard: ${tui.bold(otp)}`);
+            }
+            else {
+                console.log('Copy the following code:');
+                tui.newline();
+                console.log(`  ${tui.bold(otp)}`);
+            }
+            tui.newline();
+            console.log('Then open the URL in your browser and paste the code:');
+            tui.newline();
+            console.log(`  ${tui.link(authURL)}`);
+            tui.newline();
+            console.log(tui.muted('This code will expire in 60 seconds'));
+            tui.newline();
+            console.log('Waiting for login to complete...');
+            const result = await pollForLoginCompletion(apiClient, otp);
+            await saveAuth({
+                apiKey: result.apiKey,
+                userId: result.userId,
+                expires: result.expires,
+            });
+            tui.newline();
+            tui.success('Welcome to Agentuity! You are now logged in');
+        }
+        catch (error) {
+            logger.trace(error);
+            if (error instanceof UpgradeRequiredError) {
+                const bannerBody = `${error.message}\n\nVisit: ${tui.link('https://agentuity.dev/CLI/installation')}`;
+                tui.banner('CLI Upgrade Required', bannerBody);
+                process.exit(1);
+            }
+            else if (error instanceof ValidationError) {
+                tui.error(`API error: ${error.message}`);
+                tui.warning(`API url: ${error.url}`);
+                error.issues.map((i) => tui.arrow(`${i.message} for ${i.path}`));
+                process.exit(1);
+            }
+            else if (error instanceof Error) {
+                logger.fatal(`Login failed: ${error.message}`, ErrorCode.AUTH_FAILED);
+            }
+            else {
+                logger.fatal('Login failed', ErrorCode.AUTH_FAILED);
+            }
+        }
+    },
+});
+//# sourceMappingURL=login.js.map

package/dist/cmd/auth/login.js.map

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

package/dist/cmd/auth/logout.js

@@ -0,0 +1,17 @@
+import { createSubcommand } from '../../types';
+import { clearAuth } from '../../config';
+import * as tui from '../../tui';
+import { getCommand } from '../../command-prefix';
+export const logoutCommand = createSubcommand({
+    name: 'logout',
+    description: 'Logout of the Agentuity Cloud Platform',
+    tags: ['mutating', 'deletes-resource', 'fast', 'requires-auth'],
+    toplevel: true,
+    idempotent: false,
+    examples: [getCommand('auth logout'), getCommand('logout')],
+    async handler() {
+        await clearAuth();
+        tui.success('You have been logged out');
+    },
+});
+//# sourceMappingURL=logout.js.map

package/dist/cmd/auth/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../../src/cmd/auth/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC;IAC7C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,wCAAwC;IACrD,IAAI,EAAE,CAAC,UAAU,EAAE,kBAAkB,EAAE,MAAM,EAAE,eAAe,CAAC;IAC/D,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE3D,KAAK,CAAC,OAAO;QACZ,MAAM,SAAS,EAAE,CAAC;QAClB,GAAG,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzC,CAAC;CACD,CAAC,CAAC"}