@kairoaisec/cli 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to the Kairo CLI will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-01-29
+
+### Added
+- **CLI Foundation**: Complete CLI framework with commander.js
+- **Authentication System**:
+  - `kairo auth login` - OAuth and API key login
+  - `kairo auth logout` - Secure logout with confirmation
+  - `kairo auth whoami` - User information display
+- **Project Management**:
+  - `kairo project create <name>` - Create new projects
+  - `kairo project list` - List all projects
+  - `kairo project select <name>` - Select active project
+- **Configuration Management**:
+  - `kairo config get/set` - Configuration management
+  - `kairo config reset` - Reset configuration
+  - Secure credential storage with keytar
+- **API Client**: Complete V1 API integration
+  - Authentication with Bearer tokens
+  - Project management endpoints
+  - Analysis endpoints (ready for scanning implementation)
+  - Error handling and retry logic
+- **Testing**: Unit tests for core functionality
+- **Documentation**: Comprehensive README and examples
+
+### Development
+- TypeScript setup with CommonJS output
+- ESLint and Prettier configuration ready
+- Testing with Vitest
+- Modular command structure for easy extension
+
+### Security
+- Secure token storage using system keychain
+- API key validation
+- OAuth flow with local callback server
+
+### Next Phase
+- Contract scanning implementation
+- Slither integration
+- CI/CD GitHub Action
+- Dashboard findings integration

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kairo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,161 @@
+# Kairo CLI
+
+The official command-line interface for Kairo, the AI-powered smart contract security platform.
+
+## Installation
+
+```bash
+npm install -g @kairo/cli
+```
+
+## Quick Start
+
+1. **Login to your Kairo account:**
+   ```bash
+   kairo auth login
+   ```
+
+2. **Create or select a project:**
+   ```bash
+   kairo project create my-project
+   kairo project select my-project
+   ```
+
+3. **Scan your contracts:**
+   ```bash
+   kairo scan ./contracts
+   ```
+
+## Commands
+
+### Authentication
+
+- `kairo auth login` - Login to your Kairo account
+- `kairo auth logout` - Logout from your account
+- `kairo auth whoami` - Show current user information
+
+### Project Management
+
+- `kairo project create <name>` - Create a new project
+- `kairo project list` - List all projects
+- `kairo project select <name>` - Select active project
+
+### Security Scanning
+
+- `kairo scan [path]` - Scan contracts for vulnerabilities *(coming soon)*
+
+### Configuration
+
+- `kairo config get [key]` - View configuration
+- `kairo config set <key> <value>` - Set configuration value
+- `kairo config reset` - Reset configuration
+- `kairo config path` - Show config file location
+
+## Examples
+
+### Basic Workflow
+
+```bash
+# Login
+kairo auth login
+
+# Create a project
+kairo project create defi-protocol --description "My DeFi protocol"
+
+# Select the project
+kairo project select defi-protocol
+
+# Check status
+kairo whoami
+
+# Scan contracts (coming soon)
+kairo scan ./contracts --critical
+```
+
+### API Key Authentication
+
+```bash
+# Login with API key instead of OAuth
+kairo auth login --api-key k_your_api_key_here
+
+# Create API key via CLI
+kairo project select my-project  # Select project first
+```
+
+### Configuration Management
+
+```bash
+# View all configuration
+kairo config get
+
+# Set custom API URL
+kairo config set apiUrl https://api.kairoaisec.com
+
+# Reset everything
+kairo config reset
+```
+
+## Configuration
+
+Configuration is stored securely using:
+- **Keychain/Credential Manager** - For sensitive tokens
+- **Local config file** - For non-sensitive settings
+
+Default API URL: `https://kairoaisec.com`
+
+## Roadmap
+
+This CLI is part of Kairo's strategic pivot to enterprise CLI + Dashboard. Current status:
+
+### ✅ Phase 0: Foundation (Current)
+- [x] Authentication system
+- [x] Project management
+- [x] API client integration
+- [x] Configuration management
+
+### 🚧 Phase 0: MVP (Next)
+- [ ] Local contract scanning
+- [ ] Slither integration
+- [ ] Findings upload to dashboard
+- [ ] Progress indicators
+
+### 🔮 Phase 1: CI/CD Integration
+- [ ] GitHub Actions integration
+- [ ] PR annotations
+- [ ] Deployment gates
+
+### 🔮 Phase 2: Advanced Features
+- [ ] Mythril integration
+- [ ] AI chat in terminal
+- [ ] Custom rules
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/kairoaisec/kairo.git
+cd kairo/packages/cli
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Development mode
+npm run dev
+
+# Test locally
+npm link
+kairo --help
+```
+
+## Support
+
+- 📚 [Documentation](https://docs.kairoaisec.com)
+- 🐛 [Report Issues](https://github.com/kairoaisec/kairo/issues)
+- 💬 [Discord Community](https://discord.gg/kairo)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

package/dist/api/client.d.ts

@@ -0,0 +1,128 @@
+export interface ApiError {
+    code: string;
+    message: string;
+}
+export interface ApiResponse<T = any> {
+    data?: T;
+    error?: ApiError;
+}
+export interface AnalyzeRequest {
+    source: {
+        type: 'inline' | 'github';
+        files: Array<{
+            path: string;
+            content: string;
+        }>;
+    };
+    project_id?: string;
+    config?: {
+        severity_threshold?: 'critical' | 'high' | 'medium' | 'low' | 'info';
+        include_suggestions?: boolean;
+    };
+}
+export interface Finding {
+    id: string;
+    type: string;
+    severity: 'critical' | 'high' | 'medium' | 'low' | 'info';
+    confidence: number;
+    title: string;
+    description: string;
+    location: {
+        file: string;
+        line_start?: number;
+        line_end?: number;
+    };
+    suggestion?: string | null;
+    cwe_id?: string | null;
+}
+export interface VulnerabilitySummary {
+    total: number;
+    critical: number;
+    high: number;
+    medium: number;
+    low: number;
+    info: number;
+}
+export interface CIAnnotation {
+    status: 'success' | 'failure' | 'neutral';
+    title: string;
+    summary: string;
+}
+export interface AnalyzeResponse {
+    decision: 'ALLOW' | 'WARN' | 'BLOCK';
+    decision_reason: string;
+    scan_id: string;
+    risk_score: number;
+    summary: VulnerabilitySummary;
+    findings: Finding[];
+    ci_annotation: CIAnnotation;
+    analyzed_at: string;
+}
+export interface ApiKey {
+    id: string;
+    name: string;
+    environment: string;
+    key_preview: string;
+    expires_at?: string;
+    last_used?: string;
+    created_at: string;
+    project_id?: string;
+    project_name?: string;
+}
+export interface ApiProject {
+    id: string;
+    name: string;
+    description?: string;
+    created_at: string;
+    updated_at: string;
+}
+export declare class KairoApiClient {
+    private client;
+    private apiUrl;
+    constructor(apiUrl?: string, apiKey?: string);
+    private handleApiError;
+    private makeRequest;
+    createApiKey(data: {
+        project_id?: string;
+        name?: string;
+        environment?: string;
+        expires_in_days?: number;
+    }): Promise<ApiKey>;
+    listApiKeys(projectId?: string): Promise<{
+        api_keys: ApiKey[];
+    }>;
+    rotateApiKey(keyId: string): Promise<ApiKey>;
+    deleteApiKey(keyId: string): Promise<void>;
+    validateAuth(): Promise<{
+        valid: boolean;
+        userId?: string;
+    }>;
+    getUserInfo(): Promise<any>;
+    analyzeCode(request: AnalyzeRequest): Promise<AnalyzeResponse>;
+    listProjects(): Promise<{
+        projects: ApiProject[];
+    }>;
+    createProject(data: {
+        name: string;
+        description?: string;
+        source?: string;
+    }): Promise<{
+        project: ApiProject;
+    }>;
+    getProject(projectId: string): Promise<ApiProject>;
+    updateProject(projectId: string, data: {
+        name?: string;
+        description?: string;
+    }): Promise<ApiProject>;
+    deleteProject(projectId: string): Promise<void>;
+    deployCheck(data: {
+        contract_code: string;
+        deployment_network: string;
+        contract_address?: string;
+    }): Promise<any>;
+    healthCheck(): Promise<{
+        status: string;
+    }>;
+}
+export default KairoApiClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAC1B,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACjD,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,kBAAkB,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;QACrE,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAsC5C,OAAO,CAAC,cAAc;YAyBR,WAAW;IAyCnB,YAAY,CAAC,IAAI,EAAE;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,MAAM,CAAC;IAIb,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAKhE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,YAAY,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAK5D,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;IAU3B,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAK9D,YAAY,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAInD,aAAa,CAAC,IAAI,EAAE;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE,CAAC;IAO9B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlD,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,UAAU,CAAC;IAIhB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,WAAW,CAAC,IAAI,EAAE;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,GAAG,CAAC;IAKV,WAAW,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAGjD;AAED,eAAe,cAAc,CAAC"}

package/dist/api/client.js

@@ -0,0 +1,153 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KairoApiClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const config_1 = require("../config");
+const logger_1 = require("../utils/logger");
+const RETRY_DELAYS = [1000, 2000, 4000]; // Exponential backoff
+const RETRYABLE_CODES = [408, 429, 500, 502, 503, 504];
+class KairoApiClient {
+    client;
+    apiUrl;
+    constructor(apiUrl, apiKey) {
+        this.apiUrl = apiUrl || config_1.configManager.get('apiUrl') || 'https://kairoaisec.com';
+        this.client = axios_1.default.create({
+            baseURL: `${this.apiUrl}/api/v1`,
+            timeout: 30000, // 30 seconds
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': 'kairo-cli/0.1.0',
+            },
+        });
+        // Add request interceptor for authentication
+        this.client.interceptors.request.use(async (config) => {
+            const token = apiKey ||
+                process.env.KAIRO_API_KEY ||
+                (await config_1.configManager.getAuthToken()) ||
+                (await config_1.configManager.getApiKey());
+            if (token) {
+                config.headers.Authorization = `Bearer ${token}`;
+            }
+            return config;
+        }, (error) => Promise.reject(error));
+        // Add response interceptor for error handling
+        this.client.interceptors.response.use((response) => response, (error) => {
+            const apiError = this.handleApiError(error);
+            return Promise.reject(apiError);
+        });
+    }
+    handleApiError(error) {
+        if (error.response?.data) {
+            const errorData = error.response.data;
+            if (errorData.error) {
+                const message = `API Error (${errorData.error.code}): ${errorData.error.message}`;
+                const apiError = new Error(message);
+                apiError.code = errorData.error.code;
+                apiError.statusCode = error.response.status;
+                return apiError;
+            }
+        }
+        if (error.code === 'ECONNREFUSED') {
+            return new Error('Unable to connect to Kairo API. Please check your internet connection.');
+        }
+        if (error.code === 'ENOTFOUND') {
+            return new Error('Unable to resolve Kairo API hostname. Please check your network configuration.');
+        }
+        return new Error(error.message || 'Unknown API error occurred');
+    }
+    async makeRequest(method, endpoint, data, config) {
+        let lastError;
+        for (let attempt = 0; attempt <= RETRY_DELAYS.length; attempt++) {
+            try {
+                const response = await this.client.request({
+                    method,
+                    url: endpoint,
+                    data,
+                    ...config,
+                });
+                return response.data;
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry on final attempt
+                if (attempt === RETRY_DELAYS.length)
+                    break;
+                // Check if error is retryable
+                const statusCode = error.response?.status;
+                const isRetryable = RETRYABLE_CODES.includes(statusCode) || !error.response;
+                if (!isRetryable)
+                    break;
+                // Wait before retry
+                const delay = RETRY_DELAYS[attempt];
+                logger_1.Logger.debug(`Request failed, retrying in ${delay}ms (attempt ${attempt + 1})`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        logger_1.Logger.debug(`API request failed: ${method} ${endpoint}`, lastError);
+        throw lastError;
+    }
+    // Authentication & API Keys
+    async createApiKey(data) {
+        return this.makeRequest('POST', '/keys', data);
+    }
+    async listApiKeys(projectId) {
+        const params = projectId ? { project_id: projectId } : {};
+        return this.makeRequest('GET', '/keys', null, { params });
+    }
+    async rotateApiKey(keyId) {
+        return this.makeRequest('POST', `/keys/${keyId}/rotate`);
+    }
+    async deleteApiKey(keyId) {
+        return this.makeRequest('DELETE', `/keys/${keyId}`);
+    }
+    // Authentication validation
+    async validateAuth() {
+        return this.makeRequest('GET', '/auth/validate');
+    }
+    // User information (for whoami command)
+    async getUserInfo() {
+        // First validate auth to get user ID, then get user details
+        const authResult = await this.validateAuth();
+        if (!authResult.valid) {
+            throw new Error('Authentication invalid');
+        }
+        return authResult;
+    }
+    // Analysis
+    async analyzeCode(request) {
+        return this.makeRequest('POST', '/analyze', request);
+    }
+    // Projects
+    async listProjects() {
+        return this.makeRequest('GET', '/projects');
+    }
+    async createProject(data) {
+        return this.makeRequest('POST', '/projects', {
+            ...data,
+            source: 'cli',
+        });
+    }
+    async getProject(projectId) {
+        return this.makeRequest('GET', `/projects/${projectId}`);
+    }
+    async updateProject(projectId, data) {
+        return this.makeRequest('PATCH', `/projects/${projectId}`, data);
+    }
+    async deleteProject(projectId) {
+        return this.makeRequest('DELETE', `/projects/${projectId}`);
+    }
+    // Deploy Safety Check
+    async deployCheck(data) {
+        return this.makeRequest('POST', '/deploy/check', data);
+    }
+    // Health Check
+    async healthCheck() {
+        return this.makeRequest('GET', '/health');
+    }
+}
+exports.KairoApiClient = KairoApiClient;
+exports.default = KairoApiClient;
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,7 @@
+import KairoApiClient from './client';
+export declare const getApiClient: () => KairoApiClient;
+export declare const createApiClient: (apiUrl?: string, apiKey?: string) => KairoApiClient;
+export declare const resetApiClient: () => void;
+export * from './client';
+export default getApiClient;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,UAAU,CAAC;AAKtC,eAAO,MAAM,YAAY,QAAO,cAM/B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,cAElE,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,IAEjC,CAAC;AAEF,cAAc,UAAU,CAAC;AACzB,eAAe,YAAY,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,42 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetApiClient = exports.createApiClient = exports.getApiClient = void 0;
+const client_1 = __importDefault(require("./client"));
+const config_1 = require("../config");
+let apiClientInstance = null;
+const getApiClient = () => {
+    if (!apiClientInstance) {
+        const apiUrl = config_1.configManager.get('apiUrl');
+        apiClientInstance = new client_1.default(apiUrl);
+    }
+    return apiClientInstance;
+};
+exports.getApiClient = getApiClient;
+const createApiClient = (apiUrl, apiKey) => {
+    return new client_1.default(apiUrl, apiKey);
+};
+exports.createApiClient = createApiClient;
+const resetApiClient = () => {
+    apiClientInstance = null;
+};
+exports.resetApiClient = resetApiClient;
+__exportStar(require("./client"), exports);
+exports.default = exports.getApiClient;
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,sDAAsC;AACtC,sCAA0C;AAE1C,IAAI,iBAAiB,GAA0B,IAAI,CAAC;AAE7C,MAAM,YAAY,GAAG,GAAmB,EAAE;IAC/C,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,sBAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3C,iBAAiB,GAAG,IAAI,gBAAc,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC,CAAC;AANW,QAAA,YAAY,gBAMvB;AAEK,MAAM,eAAe,GAAG,CAAC,MAAe,EAAE,MAAe,EAAkB,EAAE;IAClF,OAAO,IAAI,gBAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC,CAAC;AAFW,QAAA,eAAe,mBAE1B;AAEK,MAAM,cAAc,GAAG,GAAS,EAAE;IACvC,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB;AAEF,2CAAyB;AACzB,kBAAe,oBAAY,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+declare const program: Command;
+export default program;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAoE9B,eAAe,OAAO,CAAC"}

package/dist/cli.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const auth_1 = require("./commands/auth");
+const project_1 = require("./commands/project");
+const scan_1 = require("./commands/scan");
+const config_1 = require("./commands/config");
+const program = new commander_1.Command();
+// CLI metadata
+program
+    .name('kairo')
+    .description('Kairo CLI for smart contract security scanning')
+    .version('0.1.0', '-v, --version', 'display version number');
+// Global options
+program
+    .option('--debug', 'enable debug output')
+    .option('--api-url <url>', 'override API URL')
+    .option('--no-color', 'disable colored output');
+// Commands
+program
+    .addCommand(auth_1.authCommand)
+    .addCommand(project_1.projectCommand)
+    .addCommand(scan_1.scanCommand)
+    .addCommand(config_1.configCommand);
+// Help customization
+program.configureHelp({
+    sortSubcommands: true,
+    subcommandTerm: (cmd) => cmd.name(),
+});
+// Custom help
+program.on('--help', () => {
+    console.log('');
+    console.log(chalk_1.default.cyan('Examples:'));
+    console.log('  $ kairo auth login                    # Login to your Kairo account');
+    console.log('  $ kairo project create my-project     # Create a new project');
+    console.log('  $ kairo scan ./contracts              # Scan contracts directory');
+    console.log('  $ kairo scan contract.sol --critical  # Scan single file, fail on critical');
+    console.log('');
+    console.log(chalk_1.default.cyan('Get help:'));
+    console.log('  $ kairo <command> --help              # Command-specific help');
+    console.log('  $ kairo auth --help                   # Auth command help');
+    console.log('');
+    console.log(chalk_1.default.dim('For more information, visit: https://docs.kairoaisec.com'));
+});
+// Handle unrecognized commands
+program.on('command:*', () => {
+    console.error(chalk_1.default.red(`Invalid command: ${program.args.join(' ')}`));
+    console.log('See --help for a list of available commands.');
+    process.exit(1);
+});
+// Global error handler
+process.on('uncaughtException', (error) => {
+    console.error(chalk_1.default.red('Unexpected error occurred:'), error.message);
+    if (program.opts().debug) {
+        console.error(error.stack);
+    }
+    process.exit(1);
+});
+// Parse command line arguments
+program.parse();
+// If no command provided, show help
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+// Export the program for testing and library use
+exports.default = program;
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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