@octo-cyber/ai 0.5.5 → 0.5.7

package/dist/src/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/src/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,eAAe,CAAC;AAE1F,4EAA4E;AAC5E,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;AAErC,0EAA0E;AAC1E,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,8CAA8C;AAC9C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,iCAAiC;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AAID;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAE7C,8DAA8D;IAC9D,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAAC;IAEhD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7D,kDAAkD;IAClD,WAAW,CACT,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,gBAAgB,CAAC;IAEpB,4DAA4D;IAC5D,kBAAkB,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAElD,qDAAqD;IACrD,WAAW,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEpE,2EAA2E;IAC3E,iBAAiB,CAAC,CAChB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7B,0CAA0C;IAC1C,UAAU,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjC,+BAA+B;IAC/B,eAAe,CAAC,IAAI,MAAM,CAAC;CAC5B;AAID,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/C,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,mCAAmC;AACnC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/src/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/src/cli/types.js.map

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

package/dist/src/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/src/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"}

package/dist/src/cli/workspace.service.js

@@ -0,0 +1,249 @@
+"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.WorkspaceService = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const core_1 = require("@octo-cyber/core");
+const METADATA_FILE = '.workspace.json';
+/**
+ * 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
+ */
+let WorkspaceService = class WorkspaceService {
+    logger = core_1.Container.get(core_1.LoggerService);
+    basePath = '';
+    /** Initialize with base data directory */
+    initialize(dataDir) {
+        this.basePath = (0, node_path_1.resolve)(dataDir, 'workspaces');
+        this.logger.info(`[WorkspaceService] Base path: ${this.basePath}`);
+    }
+    /** Create a workspace pointing to an existing local directory */
+    async createLocalWorkspace(name, localPath, options) {
+        const resolvedPath = (0, node_path_1.resolve)(localPath);
+        const dirStat = await (0, promises_1.stat)(resolvedPath);
+        if (!dirStat.isDirectory()) {
+            throw core_1.AppError.badRequest(`Path is not a directory: ${resolvedPath}`);
+        }
+        const id = `local-${this.slugify(name)}-${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+        const metaDir = this.resolveMetaPath(id);
+        await (0, promises_1.mkdir)(metaDir, { recursive: true });
+        const metadata = {
+            id,
+            type: 'local',
+            name,
+            description: options?.description,
+            localPath: resolvedPath,
+            repoUrl: options?.repoUrl,
+            branch: options?.branch,
+            createdAt: new Date().toISOString(),
+        };
+        await (0, promises_1.writeFile)((0, node_path_1.join)(metaDir, METADATA_FILE), JSON.stringify(metadata, null, 2));
+        return this.metadataToWorkspace(metadata);
+    }
+    /** Create a workspace by cloning a GitHub repository */
+    async createGithubWorkspace(name, repoUrl, branch, description) {
+        const id = `github-${this.slugify(name)}-${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+        const cloneDir = this.resolveClonePath(id);
+        await this.gitExec([
+            'clone',
+            '--branch', branch,
+            '--single-branch',
+            '--depth', '1',
+            repoUrl,
+            cloneDir,
+        ]);
+        const metadata = {
+            id,
+            type: 'github',
+            name,
+            description,
+            repoUrl,
+            branch,
+            createdAt: new Date().toISOString(),
+        };
+        await (0, promises_1.writeFile)((0, node_path_1.join)(cloneDir, METADATA_FILE), JSON.stringify(metadata, null, 2));
+        return this.metadataToWorkspace(metadata);
+    }
+    /** Pull latest changes for a github workspace */
+    async pullWorkspace(id) {
+        const ws = await this.getWorkspace(id);
+        if (!ws)
+            throw core_1.AppError.notFound(`Workspace not found: ${id}`);
+        if (ws.type !== 'github')
+            throw core_1.AppError.badRequest('Pull is only supported for github workspaces');
+        await this.gitExec(['pull'], ws.path);
+        this.logger.info(`[WorkspaceService] Pulled workspace: ${id}`);
+    }
+    /** Get workspace by ID */
+    async getWorkspace(id) {
+        const cloneDir = this.resolveClonePath(id);
+        const fromClone = await this.readWorkspace(cloneDir);
+        if (fromClone)
+            return fromClone;
+        const metaDir = this.resolveMetaPath(id);
+        return this.readWorkspace(metaDir);
+    }
+    /** List all workspaces */
+    async listWorkspaces() {
+        await this.ensureBaseDir();
+        const workspaces = [];
+        const metaBase = (0, node_path_1.resolve)(this.basePath, 'meta');
+        await (0, promises_1.mkdir)(metaBase, { recursive: true });
+        for (const entry of await (0, promises_1.readdir)(metaBase, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const ws = await this.readWorkspace((0, node_path_1.join)(metaBase, entry.name));
+            if (ws)
+                workspaces.push(ws);
+        }
+        const clonesBase = (0, node_path_1.resolve)(this.basePath, 'clones');
+        await (0, promises_1.mkdir)(clonesBase, { recursive: true });
+        for (const entry of await (0, promises_1.readdir)(clonesBase, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const ws = await this.readWorkspace((0, node_path_1.join)(clonesBase, entry.name));
+            if (ws)
+                workspaces.push(ws);
+        }
+        return workspaces;
+    }
+    /** Delete a workspace */
+    async deleteWorkspace(id) {
+        const ws = await this.getWorkspace(id);
+        if (!ws)
+            throw core_1.AppError.notFound(`Workspace not found: ${id}`);
+        if (ws.type === 'local') {
+            // Only remove metadata, never delete the original directory
+            const metaDir = this.resolveMetaPath(id);
+            await (0, promises_1.rm)(metaDir, { recursive: true, force: true });
+        }
+        else {
+            // Remove the cloned directory entirely
+            const cloneDir = this.resolveClonePath(id);
+            await (0, promises_1.rm)(cloneDir, { recursive: true, force: true });
+        }
+        this.logger.info(`[WorkspaceService] Deleted workspace: ${id} (${ws.type})`);
+    }
+    /** Detect git info (remote URL + branch) for a given directory */
+    async detectGitInfo(dirPath) {
+        try {
+            const resolvedPath = (0, node_path_1.resolve)(dirPath);
+            const dirStat = await (0, promises_1.stat)(resolvedPath);
+            if (!dirStat.isDirectory())
+                return { isGitRepo: false };
+            // Check if it's a git repo
+            await this.gitExec(['rev-parse', '--git-dir'], resolvedPath);
+            // Get remote URL
+            let remoteUrl;
+            try {
+                remoteUrl = await this.gitExec(['config', '--get', 'remote.origin.url'], resolvedPath);
+            }
+            catch { /* no remote */ }
+            // Get current branch
+            let branch;
+            try {
+                branch = await this.gitExec(['rev-parse', '--abbrev-ref', 'HEAD'], resolvedPath);
+            }
+            catch { /* detached HEAD */ }
+            return { isGitRepo: true, remoteUrl: remoteUrl || undefined, branch: branch || undefined };
+        }
+        catch {
+            return { isGitRepo: false };
+        }
+    }
+    /** Browse directory contents — returns subdirectories at the given path */
+    async browseDir(dirPath) {
+        const resolvedPath = (0, node_path_1.resolve)(dirPath || '/');
+        const entries = [];
+        try {
+            const items = await (0, promises_1.readdir)(resolvedPath, { withFileTypes: true });
+            for (const item of items) {
+                if (item.name.startsWith('.'))
+                    continue; // skip hidden
+                if (item.isDirectory()) {
+                    entries.push({
+                        name: item.name,
+                        path: (0, node_path_1.join)(resolvedPath, item.name),
+                        isDirectory: true,
+                    });
+                }
+            }
+        }
+        catch {
+            // Directory not readable
+        }
+        return entries.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    // ─── Private ────────────────────────────────────────────────
+    resolveMetaPath(id) {
+        return (0, node_path_1.resolve)(this.basePath, 'meta', id);
+    }
+    resolveClonePath(id) {
+        return (0, node_path_1.resolve)(this.basePath, 'clones', id);
+    }
+    async readWorkspace(dir) {
+        try {
+            const metaPath = (0, node_path_1.join)(dir, METADATA_FILE);
+            const raw = await (0, promises_1.readFile)(metaPath, 'utf-8');
+            const metadata = JSON.parse(raw);
+            return this.metadataToWorkspace(metadata);
+        }
+        catch {
+            return null;
+        }
+    }
+    metadataToWorkspace(metadata) {
+        const path = metadata.type === 'local' && metadata.localPath
+            ? metadata.localPath
+            : this.resolveClonePath(metadata.id);
+        return {
+            id: metadata.id,
+            type: metadata.type,
+            name: metadata.name,
+            description: metadata.description,
+            path,
+            createdAt: new Date(metadata.createdAt),
+            localPath: metadata.localPath,
+            repoUrl: metadata.repoUrl,
+            branch: metadata.branch,
+        };
+    }
+    async ensureBaseDir() {
+        await (0, promises_1.mkdir)(this.basePath, { recursive: true });
+    }
+    slugify(name) {
+        return name
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '')
+            .slice(0, 30);
+    }
+    gitExec(args, cwd) {
+        return new Promise((resolve, reject) => {
+            (0, node_child_process_1.execFile)('git', args, { cwd, timeout: 120_000 }, (err, stdout, stderr) => {
+                if (err) {
+                    reject(new Error(stderr.trim() || err.message));
+                }
+                else {
+                    resolve(stdout.trim());
+                }
+            });
+        });
+    }
+};
+exports.WorkspaceService = WorkspaceService;
+exports.WorkspaceService = WorkspaceService = __decorate([
+    (0, core_1.Service)()
+], WorkspaceService);
+//# sourceMappingURL=workspace.service.js.map

package/dist/src/cli/workspace.service.js.map

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

package/dist/src/computer-use/computer-use.controller.d.ts

@@ -0,0 +1,23 @@
+import type { Request, Response } from '@octo-cyber/core';
+/**
+ * Computer Use controller.
+ *
+ * Exposes a single endpoint that runs a computer-use agent loop:
+ * the agent takes screenshots, clicks, types, scrolls, and presses keys
+ * to complete the requested task on the local desktop.
+ *
+ * Endpoints:
+ *   POST /api/v1/ai/computer-use  — Run a computer-use agent task
+ */
+export declare class ComputerUseController {
+    /**
+     * Run a computer-use agent loop.
+     *
+     * Body:
+     *   prompt     {string}  — Task description for the agent
+     *   maxRounds  {number?} — Max LLM rounds (default 20, max 50)
+     *   timeoutMs  {number?} — Timeout in ms (default 300 000)
+     */
+    runComputerUse(req: Request, res: Response): Promise<void>;
+}
+//# sourceMappingURL=computer-use.controller.d.ts.map

package/dist/src/computer-use/computer-use.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer-use.controller.d.ts","sourceRoot":"","sources":["../../../src/computer-use/computer-use.controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA6B1D;;;;;;;;;GASG;AACH,qBACa,qBAAqB;IAChC;;;;;;;OAOG;IAEG,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA+BjE"}

package/dist/src/computer-use/computer-use.controller.js

@@ -0,0 +1,87 @@
+"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.ComputerUseController = void 0;
+const core_1 = require("@octo-cyber/core");
+const OctoAgentClient_js_1 = require("../workflow-design/OctoAgentClient.js");
+const computer_use_tools_js_1 = require("../agent/computer-use-tools.js");
+const MAX_ROUNDS_DEFAULT = 20;
+const MAX_ROUNDS_LIMIT = 50;
+const TIMEOUT_MS_DEFAULT = 300_000; // 5 minutes
+const SYSTEM_PROMPT = `You are an AI agent that can control the desktop computer.
+You have access to these tools:
+- screenshot: take a screenshot to see the current state of the screen
+- left_click: click at a specific (x, y) coordinate
+- type: type text into the focused element
+- scroll: scroll up or down at a screen position
+- key: press a key or key combination (e.g. "enter", "ctrl+c")
+
+To complete a task:
+1. Start by taking a screenshot to understand the current state of the screen.
+2. Identify what needs to be done based on the screenshot.
+3. Use the appropriate tools to interact with the UI.
+4. Take follow-up screenshots to verify your actions had the intended effect.
+5. Repeat until the task is complete, then summarize what you did.
+
+Important:
+- Always verify actions with a screenshot after significant interactions.
+- Use the "key" tool for keyboard shortcuts (e.g. "enter" to confirm, "escape" to cancel).
+- Coordinate (0, 0) is the top-left corner of the screen.
+- Be precise with coordinates — click the center of buttons and input fields.`;
+/**
+ * Computer Use controller.
+ *
+ * Exposes a single endpoint that runs a computer-use agent loop:
+ * the agent takes screenshots, clicks, types, scrolls, and presses keys
+ * to complete the requested task on the local desktop.
+ *
+ * Endpoints:
+ *   POST /api/v1/ai/computer-use  — Run a computer-use agent task
+ */
+let ComputerUseController = class ComputerUseController {
+    /**
+     * Run a computer-use agent loop.
+     *
+     * Body:
+     *   prompt     {string}  — Task description for the agent
+     *   maxRounds  {number?} — Max LLM rounds (default 20, max 50)
+     *   timeoutMs  {number?} — Timeout in ms (default 300 000)
+     */
+    async runComputerUse(req, res) {
+        const { prompt, maxRounds, timeoutMs } = req.body;
+        if (!prompt || typeof prompt !== 'string' || prompt.trim().length === 0) {
+            throw core_1.AppError.badRequest('Missing or invalid prompt');
+        }
+        const rounds = Math.min(typeof maxRounds === 'number' ? maxRounds : MAX_ROUNDS_DEFAULT, MAX_ROUNDS_LIMIT);
+        const timeout = typeof timeoutMs === 'number' ? timeoutMs : TIMEOUT_MS_DEFAULT;
+        const client = new OctoAgentClient_js_1.OctoAgentClient();
+        const tools = (0, computer_use_tools_js_1.createComputerUseTools)();
+        const output = await client.run({
+            systemPrompt: SYSTEM_PROMPT,
+            userMessage: prompt.trim(),
+            tools,
+            maxRounds: rounds,
+            timeoutMs: timeout,
+        });
+        res.json(core_1.ApiResponse.ok({ output }));
+    }
+};
+exports.ComputerUseController = ComputerUseController;
+__decorate([
+    (0, core_1.Post)('/computer-use'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], ComputerUseController.prototype, "runComputerUse", null);
+exports.ComputerUseController = ComputerUseController = __decorate([
+    (0, core_1.Controller)('/api/v1/ai')
+], ComputerUseController);
+//# sourceMappingURL=computer-use.controller.js.map

package/dist/src/computer-use/computer-use.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer-use.controller.js","sourceRoot":"","sources":["../../../src/computer-use/computer-use.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA2E;AAE3E,8EAAwE;AACxE,0EAAwE;AAExE,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,kBAAkB,GAAG,OAAO,CAAC,CAAC,YAAY;AAEhD,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;8EAmBwD,CAAC;AAE/E;;;;;;;;;GASG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC;;;;;;;OAOG;IAEG,AAAN,KAAK,CAAC,cAAc,CAAC,GAAY,EAAE,GAAa;QAC9C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,IAI5C,CAAC;QAEF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,eAAQ,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CACrB,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,EAC9D,gBAAgB,CACjB,CAAC;QAEF,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAE/E,MAAM,MAAM,GAAG,IAAI,oCAAe,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAA,8CAAsB,GAAE,CAAC;QAEvC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;YAC9B,YAAY,EAAE,aAAa;YAC3B,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE;YAC1B,KAAK;YACL,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,OAAO;SACnB,CAAC,CAAC;QAEH,GAAG,CAAC,IAAI,CAAC,kBAAW,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;CACF,CAAA;AAzCY,sDAAqB;AAU1B;IADL,IAAA,WAAI,EAAC,eAAe,CAAC;;;;2DA+BrB;gCAxCU,qBAAqB;IADjC,IAAA,iBAAU,EAAC,YAAY,CAAC;GACZ,qBAAqB,CAyCjC"}

package/dist/src/index.d.ts

@@ -0,0 +1,12 @@
+export { AiModule } from './ai.module.js';
+export { CliRegistryService, CliExecutorService, WorkspaceService, ClaudeCliAdapter, GeminiCliAdapter, CodexCliAdapter, type CliToolName, type CliToolInfo, type CliExecuteOptions, type CliExecuteResult, type ICliAdapter, type FileInput, type FileOutput, type WorkspaceType, type Workspace, } from './cli/index.js';
+export { AiCliController } from './cli/controllers/ai-cli.controller.js';
+export { OctoSkill, SkillGeneratorService, SkillRegistryService, SkillInstallerService, SkillController, type SkillTarget, type SkillTargetInfo, type SkillSourceType, type SkillGenerateParams, type SkillGenerateResult, type EndpointInfo, } from './skill/index.js';
+export { BranchDecisionEngine, type BranchDecision, type BranchStrategy, type DecisionInput, type RequirementType, } from './BranchDecisionEngine.js';
+export { WorkflowDesignOrchestrator, OctoAgentClient, N8nNodeKnowledgeBase, TriggerAnalystAgent, ActionChainAgent, LogicFlowAgent, CodeScriptAgent, WorkflowValidatorAgent, type Message, type Tool, type TriggerNodeSpec, type ActionNodeSpec, type LogicNodeSpec, type N8nWorkflow, type WorkflowDraft, type ValidationResult, type ModificationScope, type NodeCategory, type NodeTemplate, type ToolDefinition, type AgentRunOptions, } from './workflow-design/index.js';
+export { createCodingTools } from './agent/coding-tools.js';
+export { createComputerUseTools, IMAGE_RESULT_PREFIX } from './agent/computer-use-tools.js';
+export { ComputerUseController } from './computer-use/computer-use.controller.js';
+export { ClaudeCodeSessionManagerService } from './session/claude-code-session-manager.service.js';
+export { CLAUDE_CODE_SESSION_MANAGER, type IClaudeCodeSessionManager, type ClaudeCodeSession, type ClaudeCodeSessionStatus, type StartSessionOptions, type StopSessionResult, } from '../shared/IClaudeCodeSessionManager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAGzE,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAG5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,OAAO,EAAE,+BAA+B,EAAE,MAAM,kDAAkD,CAAC;AACnG,OAAO,EACL,2BAA2B,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,wCAAwC,CAAC"}