@octo-cyber/ai 0.5.6 → 0.5.7

package/dist/cli/cli-registry.service.js

@@ -0,0 +1,114 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliRegistryService = void 0;
+const core_1 = require("@octo-cyber/core");
+/**
+ * Registry of available AI CLI tools.
+ *
+ * Manages CLI adapter registration, tool detection, and health checks.
+ * Adapters are registered at module initialization time;
+ * detection runs lazily on first query or explicitly via refresh().
+ */
+let CliRegistryService = class CliRegistryService {
+    logger = core_1.Container.get(core_1.LoggerService);
+    adapters = new Map();
+    toolInfoCache = new Map();
+    hasDetected = false;
+    /** Register a CLI adapter */
+    registerAdapter(adapter) {
+        this.adapters.set(adapter.toolName, adapter);
+        this.logger.info(`[CliRegistry] Registered adapter: ${adapter.displayName}`);
+    }
+    /** Get adapter by tool name */
+    getAdapter(name) {
+        return this.adapters.get(name);
+    }
+    /** Get all registered adapter names */
+    getRegisteredTools() {
+        return [...this.adapters.keys()];
+    }
+    /** Check if a specific tool is available (installed and detected) */
+    async isToolAvailable(name) {
+        await this.ensureDetected();
+        const info = this.toolInfoCache.get(name);
+        return info?.isAvailable ?? false;
+    }
+    /** Get info for a specific tool */
+    async getToolInfo(name) {
+        await this.ensureDetected();
+        return this.toolInfoCache.get(name) ?? null;
+    }
+    /** Get info for all registered tools */
+    async getAvailableTools() {
+        await this.ensureDetected();
+        return [...this.toolInfoCache.values()];
+    }
+    /** Force re-detection of all tools */
+    async refresh() {
+        this.hasDetected = false;
+        this.toolInfoCache.clear();
+        return this.getAvailableTools();
+    }
+    /**
+     * Health check for a specific tool.
+     * Re-detects the tool regardless of cache.
+     */
+    async healthCheck(name) {
+        const adapter = this.adapters.get(name);
+        if (!adapter)
+            return null;
+        const info = await this.detectSingleTool(adapter);
+        this.toolInfoCache.set(name, info);
+        return info;
+    }
+    /** Get available models for a specific tool */
+    async getModels(name) {
+        const adapter = this.adapters.get(name);
+        if (!adapter?.listModels)
+            return [];
+        return adapter.listModels();
+    }
+    // ─── Private ────────────────────────────────────────────────
+    async ensureDetected() {
+        if (this.hasDetected)
+            return;
+        const detectionPromises = [...this.adapters.values()].map((adapter) => this.detectSingleTool(adapter));
+        const results = await Promise.all(detectionPromises);
+        for (const info of results) {
+            this.toolInfoCache.set(info.name, info);
+        }
+        this.hasDetected = true;
+        const available = results.filter((r) => r.isAvailable);
+        this.logger.info(`[CliRegistry] Detection complete: ${available.length}/${results.length} tools available`);
+    }
+    async detectSingleTool(adapter) {
+        const toolType = adapter.executionType === 'spawn' ? 'cli' : 'api';
+        try {
+            const info = await adapter.detectInstallation();
+            if (info)
+                return { ...info, toolType };
+        }
+        catch (err) {
+            this.logger.warn(`[CliRegistry] Detection failed for ${adapter.toolName}: ${err}`);
+        }
+        return {
+            name: adapter.toolName,
+            displayName: adapter.displayName,
+            version: '',
+            executablePath: '',
+            isAvailable: false,
+            toolType,
+        };
+    }
+};
+exports.CliRegistryService = CliRegistryService;
+exports.CliRegistryService = CliRegistryService = __decorate([
+    (0, core_1.Service)()
+], CliRegistryService);
+//# sourceMappingURL=cli-registry.service.js.map

package/dist/cli/cli-registry.service.js.map

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

package/dist/cli/controllers/ai-cli.controller.d.ts

@@ -0,0 +1,40 @@
+import type { Request, Response } from '@octo-cyber/core';
+/**
+ * REST API controller for AI CLI operations.
+ *
+ * Endpoints:
+ * - GET  /api/v1/ai-cli/tools              — List available CLI tools
+ * - GET  /api/v1/ai-cli/tools/:name/health — Health check for a tool
+ * - GET  /api/v1/ai-cli/tools/:name/models — List models for a tool
+ * - POST /api/v1/ai-cli/execute            — Execute a CLI tool
+ * - GET  /api/v1/ai-cli/workspaces         — List workspaces
+ * - POST /api/v1/ai-cli/workspaces         — Create workspace (local or github)
+ * - POST /api/v1/ai-cli/workspaces/:id/pull — Pull latest for github workspace
+ * - POST /api/v1/ai-cli/workspaces/:id/delete — Delete workspace
+ */
+export declare class AiCliController {
+    private registry;
+    private executor;
+    private workspace;
+    /** List all registered CLI tools with availability status */
+    listTools(_req: Request, res: Response): Promise<void>;
+    /** Health check for a specific CLI tool */
+    healthCheck(req: Request, res: Response): Promise<void>;
+    /** List available models for a specific tool */
+    listModels(req: Request, res: Response): Promise<void>;
+    /** Execute an AI CLI tool */
+    execute(req: Request, res: Response): Promise<void>;
+    /** Browse directories at a given path */
+    browseDir(req: Request, res: Response): Promise<void>;
+    /** Detect git info for a directory */
+    detectGit(req: Request, res: Response): Promise<void>;
+    /** List all workspaces */
+    listWorkspaces(_req: Request, res: Response): Promise<void>;
+    /** Create a new workspace (local or github) */
+    createWorkspace(req: Request, res: Response): Promise<void>;
+    /** Pull latest changes for a github workspace */
+    pullWorkspace(req: Request, res: Response): Promise<void>;
+    /** Delete a workspace */
+    deleteWorkspace(req: Request, res: Response): Promise<void>;
+}
+//# sourceMappingURL=ai-cli.controller.d.ts.map

package/dist/cli/controllers/ai-cli.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-cli.controller.d.ts","sourceRoot":"","sources":["../../../src/cli/controllers/ai-cli.controller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ1D;;;;;;;;;;;;GAYG;AACH,qBACa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,SAAS,CAAmC;IAEpD,6DAA6D;IAEvD,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D,2CAA2C;IAErC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7D,gDAAgD;IAE1C,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D,6BAA6B;IAEvB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BzD,yCAAyC;IAEnC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,sCAAsC;IAEhC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,0BAA0B;IAEpB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjE,+CAA+C;IAEzC,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BjE,iDAAiD;IAE3C,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,yBAAyB;IAEnB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAKlE"}

package/dist/cli/controllers/ai-cli.controller.js

@@ -0,0 +1,208 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiCliController = void 0;
+const node_os_1 = require("node:os");
+const core_1 = require("@octo-cyber/core");
+const cli_registry_service_js_1 = require("../cli-registry.service.js");
+const cli_executor_service_js_1 = require("../cli-executor.service.js");
+const workspace_service_js_1 = require("../workspace.service.js");
+const VALID_TOOLS = new Set(['claude', 'gemini', 'codex', 'antigravity', 'cli-proxy-api']);
+/**
+ * REST API controller for AI CLI operations.
+ *
+ * Endpoints:
+ * - GET  /api/v1/ai-cli/tools              — List available CLI tools
+ * - GET  /api/v1/ai-cli/tools/:name/health — Health check for a tool
+ * - GET  /api/v1/ai-cli/tools/:name/models — List models for a tool
+ * - POST /api/v1/ai-cli/execute            — Execute a CLI tool
+ * - GET  /api/v1/ai-cli/workspaces         — List workspaces
+ * - POST /api/v1/ai-cli/workspaces         — Create workspace (local or github)
+ * - POST /api/v1/ai-cli/workspaces/:id/pull — Pull latest for github workspace
+ * - POST /api/v1/ai-cli/workspaces/:id/delete — Delete workspace
+ */
+let AiCliController = class AiCliController {
+    registry = core_1.Container.get(cli_registry_service_js_1.CliRegistryService);
+    executor = core_1.Container.get(cli_executor_service_js_1.CliExecutorService);
+    workspace = core_1.Container.get(workspace_service_js_1.WorkspaceService);
+    /** List all registered CLI tools with availability status */
+    async listTools(_req, res) {
+        const tools = await this.registry.getAvailableTools();
+        res.json(core_1.ApiResponse.ok(tools));
+    }
+    /** Health check for a specific CLI tool */
+    async healthCheck(req, res) {
+        const name = req.params.name;
+        if (!VALID_TOOLS.has(name)) {
+            throw core_1.AppError.badRequest(`Invalid tool name: ${name}`);
+        }
+        const info = await this.registry.healthCheck(name);
+        if (!info) {
+            throw core_1.AppError.notFound(`Tool not registered: ${name}`);
+        }
+        res.json(core_1.ApiResponse.ok(info));
+    }
+    /** List available models for a specific tool */
+    async listModels(req, res) {
+        const name = req.params.name;
+        if (!VALID_TOOLS.has(name)) {
+            throw core_1.AppError.badRequest(`Invalid tool name: ${name}`);
+        }
+        const models = await this.registry.getModels(name);
+        res.json(core_1.ApiResponse.ok(models));
+    }
+    /** Execute an AI CLI tool */
+    async execute(req, res) {
+        const { tool, prompt, model, workingDir, timeoutMs, args, jsonOutput } = req.body;
+        if (!tool || !VALID_TOOLS.has(tool)) {
+            throw core_1.AppError.badRequest(`Invalid or missing tool. Must be one of: ${[...VALID_TOOLS].join(', ')}`);
+        }
+        if (!prompt || typeof prompt !== 'string') {
+            throw core_1.AppError.badRequest('Missing or invalid prompt');
+        }
+        const result = await this.executor.execute({
+            tool: tool,
+            prompt,
+            model: model && typeof model === 'string' ? model : undefined,
+            workingDir: workingDir || (0, node_os_1.tmpdir)(),
+            timeoutMs: timeoutMs ? Number(timeoutMs) : undefined,
+            args: Array.isArray(args) ? args : undefined,
+            jsonOutput: Boolean(jsonOutput),
+        });
+        res.json(core_1.ApiResponse.ok(result));
+    }
+    /** Browse directories at a given path */
+    async browseDir(req, res) {
+        const dirPath = req.query.path || '/';
+        const entries = await this.workspace.browseDir(dirPath);
+        res.json(core_1.ApiResponse.ok(entries));
+    }
+    /** Detect git info for a directory */
+    async detectGit(req, res) {
+        const { path: dirPath } = req.body;
+        if (!dirPath || typeof dirPath !== 'string') {
+            throw core_1.AppError.badRequest('Directory path is required');
+        }
+        const info = await this.workspace.detectGitInfo(dirPath);
+        res.json(core_1.ApiResponse.ok(info));
+    }
+    /** List all workspaces */
+    async listWorkspaces(_req, res) {
+        const workspaces = await this.workspace.listWorkspaces();
+        res.json(core_1.ApiResponse.ok(workspaces));
+    }
+    /** Create a new workspace (local or github) */
+    async createWorkspace(req, res) {
+        const { type, name, localPath, repoUrl, branch, description } = req.body;
+        if (!name || typeof name !== 'string') {
+            throw core_1.AppError.badRequest('Workspace name is required');
+        }
+        if (type === 'local') {
+            if (!localPath || typeof localPath !== 'string') {
+                throw core_1.AppError.badRequest('Local workspace requires a localPath');
+            }
+            const ws = await this.workspace.createLocalWorkspace(name, localPath, {
+                description, repoUrl, branch,
+            });
+            res.status(201).json(core_1.ApiResponse.ok(ws, 'Workspace created'));
+        }
+        else if (type === 'github') {
+            if (!repoUrl || typeof repoUrl !== 'string') {
+                throw core_1.AppError.badRequest('GitHub workspace requires a repoUrl');
+            }
+            if (!branch || typeof branch !== 'string') {
+                throw core_1.AppError.badRequest('GitHub workspace requires a branch');
+            }
+            const ws = await this.workspace.createGithubWorkspace(name, repoUrl, branch, description);
+            res.status(201).json(core_1.ApiResponse.ok(ws, 'Workspace created'));
+        }
+        else {
+            throw core_1.AppError.badRequest('Invalid workspace type. Must be "local" or "github"');
+        }
+    }
+    /** Pull latest changes for a github workspace */
+    async pullWorkspace(req, res) {
+        const id = req.params.id;
+        await this.workspace.pullWorkspace(id);
+        res.json(core_1.ApiResponse.ok(null, 'Workspace pulled'));
+    }
+    /** Delete a workspace */
+    async deleteWorkspace(req, res) {
+        const id = req.params.id;
+        await this.workspace.deleteWorkspace(id);
+        res.json(core_1.ApiResponse.ok(null, 'Workspace deleted'));
+    }
+};
+exports.AiCliController = AiCliController;
+__decorate([
+    (0, core_1.Get)('/tools'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AiCliController.prototype, "listTools", null);
+__decorate([
+    (0, core_1.Get)('/tools/:name/health'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AiCliController.prototype, "healthCheck", null);
+__decorate([
+    (0, core_1.Get)('/tools/:name/models'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AiCliController.prototype, "listModels", null);
+__decorate([
+    (0, core_1.Post)('/execute'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AiCliController.prototype, "execute", null);
+__decorate([
+    (0, core_1.Get)('/browse-dir'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AiCliController.prototype, "browseDir", null);
+__decorate([
+    (0, core_1.Post)('/detect-git'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AiCliController.prototype, "detectGit", null);
+__decorate([
+    (0, core_1.Get)('/workspaces'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AiCliController.prototype, "listWorkspaces", null);
+__decorate([
+    (0, core_1.Post)('/workspaces'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AiCliController.prototype, "createWorkspace", null);
+__decorate([
+    (0, core_1.Post)('/workspaces/:id/pull'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AiCliController.prototype, "pullWorkspace", null);
+__decorate([
+    (0, core_1.Post)('/workspaces/:id/delete'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AiCliController.prototype, "deleteWorkspace", null);
+exports.AiCliController = AiCliController = __decorate([
+    (0, core_1.Controller)('/api/v1/ai-cli')
+], AiCliController);
+//# sourceMappingURL=ai-cli.controller.js.map

package/dist/cli/controllers/ai-cli.controller.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+export type { CliToolName, CliToolInfo, CliExecuteOptions, CliExecuteResult, ICliAdapter, FileInput, FileOutput, WorkspaceType, WorkspaceMetadata, Workspace, DetectedGitInfo, DirEntry, } from './types.js';
+export { CliRegistryService } from './cli-registry.service.js';
+export { CliExecutorService } from './cli-executor.service.js';
+export { WorkspaceService } from './workspace.service.js';
+export { ClaudeCliAdapter } from './adapters/claude-cli.adapter.js';
+export { GeminiCliAdapter } from './adapters/gemini-cli.adapter.js';
+export { CodexCliAdapter } from './adapters/codex-cli.adapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodexCliAdapter = exports.GeminiCliAdapter = exports.ClaudeCliAdapter = exports.WorkspaceService = exports.CliExecutorService = exports.CliRegistryService = void 0;
+var cli_registry_service_js_1 = require("./cli-registry.service.js");
+Object.defineProperty(exports, "CliRegistryService", { enumerable: true, get: function () { return cli_registry_service_js_1.CliRegistryService; } });
+var cli_executor_service_js_1 = require("./cli-executor.service.js");
+Object.defineProperty(exports, "CliExecutorService", { enumerable: true, get: function () { return cli_executor_service_js_1.CliExecutorService; } });
+var workspace_service_js_1 = require("./workspace.service.js");
+Object.defineProperty(exports, "WorkspaceService", { enumerable: true, get: function () { return workspace_service_js_1.WorkspaceService; } });
+// Adapters
+var claude_cli_adapter_js_1 = require("./adapters/claude-cli.adapter.js");
+Object.defineProperty(exports, "ClaudeCliAdapter", { enumerable: true, get: function () { return claude_cli_adapter_js_1.ClaudeCliAdapter; } });
+var gemini_cli_adapter_js_1 = require("./adapters/gemini-cli.adapter.js");
+Object.defineProperty(exports, "GeminiCliAdapter", { enumerable: true, get: function () { return gemini_cli_adapter_js_1.GeminiCliAdapter; } });
+var codex_cli_adapter_js_1 = require("./adapters/codex-cli.adapter.js");
+Object.defineProperty(exports, "CodexCliAdapter", { enumerable: true, get: function () { return codex_cli_adapter_js_1.CodexCliAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AAeA,qEAA+D;AAAtD,6HAAA,kBAAkB,OAAA;AAC3B,qEAA+D;AAAtD,6HAAA,kBAAkB,OAAA;AAC3B,+DAA0D;AAAjD,wHAAA,gBAAgB,OAAA;AAEzB,WAAW;AACX,0EAAoE;AAA3D,yHAAA,gBAAgB,OAAA;AACzB,0EAAoE;AAA3D,yHAAA,gBAAgB,OAAA;AACzB,wEAAkE;AAAzD,uHAAA,eAAe,OAAA"}

package/dist/cli/types.d.ts

@@ -0,0 +1,153 @@
+/**
+ * AI CLI integration type definitions.
+ *
+ * Defines interfaces for CLI tool adapters, execution options/results,
+ * and workspace management.
+ */
+/** Supported CLI tool identifiers */
+export type CliToolName = 'claude' | 'gemini' | 'codex' | 'antigravity' | 'cli-proxy-api';
+/** High-level tool category: spawns a local process vs calls an HTTP API */
+export type ToolType = 'cli' | 'api';
+/** How the adapter executes: spawn a child process or call an HTTP API */
+export type AdapterExecutionType = 'spawn' | 'http';
+/** Information about an installed CLI tool */
+export interface CliToolInfo {
+    name: CliToolName;
+    displayName: string;
+    version: string;
+    executablePath: string;
+    isAvailable: boolean;
+    /** cli = spawns a local process; api = calls an HTTP API. Set by CliRegistryService. */
+    toolType?: ToolType;
+    /** Available models for this tool */
+    models?: string[];
+    /** Default model identifier */
+    defaultModel?: string;
+}
+/** File passed as input to a CLI execution */
+export interface FileInput {
+    /** Relative path within the workspace */
+    path: string;
+    /** File content (text) or absolute path to existing file */
+    content?: string;
+    sourcePath?: string;
+}
+/** File produced by a CLI execution */
+export interface FileOutput {
+    /** Relative path within the workspace */
+    path: string;
+    /** Size in bytes */
+    size: number;
+}
+/** Options for executing an AI CLI tool */
+export interface CliExecuteOptions {
+    /** Which CLI tool to use */
+    tool: CliToolName;
+    /** The prompt to send to the CLI */
+    prompt: string;
+    /** System prompt (used by HTTP/API adapters that support separate system message role) */
+    systemPrompt?: string;
+    /** Model to use (tool-specific, e.g. 'sonnet', 'gemini-2.5-flash') */
+    model?: string;
+    /** Working directory for the CLI process (default: temp workspace) */
+    workingDir?: string;
+    /** Files to place in the workspace before execution */
+    files?: FileInput[];
+    /** Timeout in milliseconds (default: 300_000, max: 600_000) */
+    timeoutMs?: number;
+    /** Extra CLI arguments */
+    args?: string[];
+    /** Extra environment variables for the CLI process */
+    env?: Record<string, string>;
+    /** Request JSON output format from the CLI */
+    jsonOutput?: boolean;
+}
+/** Result of a CLI execution */
+export interface CliExecuteResult {
+    success: boolean;
+    /** CLI stdout content */
+    output: string;
+    /** CLI stderr content (if any) */
+    error?: string;
+    /** Process exit code */
+    exitCode: number;
+    /** Execution duration in milliseconds */
+    durationMs: number;
+    /** Files generated or modified by the CLI */
+    files?: FileOutput[];
+    /** The tool that was executed */
+    tool: CliToolName;
+}
+/**
+ * Adapter for a specific CLI tool.
+ * Each CLI (claude, gemini, codex) implements this interface
+ * to handle tool-specific argument construction and output parsing.
+ */
+export interface ICliAdapter {
+    /** Tool identifier */
+    readonly toolName: CliToolName;
+    /** Human-readable display name */
+    readonly displayName: string;
+    /** How this adapter executes: spawn a child process or call HTTP API */
+    readonly executionType: AdapterExecutionType;
+    /** Build CLI command-line arguments from execution options */
+    buildArgs(options: CliExecuteOptions): string[];
+    /**
+     * Build environment variables for the CLI process.
+     * Returns only tool-specific env vars (merged with system env at execution time).
+     */
+    buildEnv(options: CliExecuteOptions): Record<string, string>;
+    /** Parse raw CLI output into structured result */
+    parseOutput(stdout: string, stderr: string, exitCode: number, durationMs: number): CliExecuteResult;
+    /** Detect if this CLI tool is installed and get its info */
+    detectInstallation(): Promise<CliToolInfo | null>;
+    /** Execute via HTTP (only for http-type adapters) */
+    executeHttp?(options: CliExecuteOptions): Promise<CliExecuteResult>;
+    /** Execute via HTTP with streaming chunks (only for http-type adapters) */
+    executeHttpStream?(options: CliExecuteOptions, onChunk: (chunk: string) => void): Promise<CliExecuteResult>;
+    /** List available models for this tool */
+    listModels?(): Promise<string[]>;
+    /** Default model identifier */
+    getDefaultModel?(): string;
+}
+export type WorkspaceType = 'local' | 'github';
+/** Workspace metadata stored in .workspace.json */
+export interface WorkspaceMetadata {
+    id: string;
+    type: WorkspaceType;
+    name: string;
+    description?: string;
+    createdAt: string;
+    /** Original local directory path (local type) */
+    localPath?: string;
+    /** GitHub repository URL (github type) */
+    repoUrl?: string;
+    /** Git branch name (github type) */
+    branch?: string;
+}
+/** Workspace information returned by WorkspaceService */
+export interface Workspace {
+    id: string;
+    type: WorkspaceType;
+    name: string;
+    description?: string;
+    /** Effective working directory path */
+    path: string;
+    createdAt: Date;
+    localPath?: string;
+    repoUrl?: string;
+    branch?: string;
+}
+/** Git info detected from a local directory */
+export interface DetectedGitInfo {
+    isGitRepo: boolean;
+    remoteUrl?: string;
+    branch?: string;
+}
+/** Directory entry for browsing */
+export interface DirEntry {
+    name: string;
+    path: string;
+    isDirectory: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

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

package/dist/cli/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * AI CLI integration type definitions.
+ *
+ * Defines interfaces for CLI tool adapters, execution options/results,
+ * and workspace management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/cli/workspace.service.d.ts

@@ -0,0 +1,42 @@
+import type { Workspace, DetectedGitInfo, DirEntry } from './types.js';
+/**
+ * Manages workspaces for AI CLI executions.
+ *
+ * Two workspace types:
+ * - **local**: References an existing local directory (no file copying)
+ * - **github**: Clones a GitHub repo + branch to a managed directory
+ */
+export declare class WorkspaceService {
+    private readonly logger;
+    private basePath;
+    /** Initialize with base data directory */
+    initialize(dataDir: string): void;
+    /** Create a workspace pointing to an existing local directory */
+    createLocalWorkspace(name: string, localPath: string, options?: {
+        description?: string;
+        repoUrl?: string;
+        branch?: string;
+    }): Promise<Workspace>;
+    /** Create a workspace by cloning a GitHub repository */
+    createGithubWorkspace(name: string, repoUrl: string, branch: string, description?: string): Promise<Workspace>;
+    /** Pull latest changes for a github workspace */
+    pullWorkspace(id: string): Promise<void>;
+    /** Get workspace by ID */
+    getWorkspace(id: string): Promise<Workspace | null>;
+    /** List all workspaces */
+    listWorkspaces(): Promise<Workspace[]>;
+    /** Delete a workspace */
+    deleteWorkspace(id: string): Promise<void>;
+    /** Detect git info (remote URL + branch) for a given directory */
+    detectGitInfo(dirPath: string): Promise<DetectedGitInfo>;
+    /** Browse directory contents — returns subdirectories at the given path */
+    browseDir(dirPath: string): Promise<DirEntry[]>;
+    private resolveMetaPath;
+    private resolveClonePath;
+    private readWorkspace;
+    private metadataToWorkspace;
+    private ensureBaseDir;
+    private slugify;
+    private gitExec;
+}
+//# sourceMappingURL=workspace.service.d.ts.map

package/dist/cli/workspace.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.service.d.ts","sourceRoot":"","sources":["../../src/cli/workspace.service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAqB,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI1F;;;;;;GAMG;AACH,qBACa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAM;IAEtB,0CAA0C;IAC1C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjC,iEAAiE;IAC3D,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACpE,OAAO,CAAC,SAAS,CAAC;IA0BrB,wDAAwD;IAClD,qBAAqB,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,CAAC;IA2BrB,iDAAiD;IAC3C,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C,0BAA0B;IACpB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IASzD,0BAA0B;IACpB,cAAc,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAuB5C,yBAAyB;IACnB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhD,kEAAkE;IAC5D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA2B9D,2EAA2E;IACrE,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAyBrD,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,gBAAgB;YAIV,aAAa;IAW3B,OAAO,CAAC,mBAAmB;YAkBb,aAAa;IAI3B,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,OAAO;CAWhB"}