@octo-cyber/ai 0.5.5 → 0.5.6

package/dist/src/agent/agent-approval.entity.js

@@ -0,0 +1,63 @@
+"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.AgentApproval = void 0;
+const core_1 = require("@octo-cyber/core");
+let AgentApproval = class AgentApproval {
+    id;
+    runId;
+    /** The question or action description requiring human approval. */
+    question;
+    /** Optional JSON or text context to help the reviewer decide. */
+    context;
+    status;
+    /** Optional response message from the human reviewer. */
+    response;
+    respondedAt;
+    createdAt;
+};
+exports.AgentApproval = AgentApproval;
+__decorate([
+    (0, core_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], AgentApproval.prototype, "id", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'varchar', length: 36, name: 'run_id' }),
+    __metadata("design:type", String)
+], AgentApproval.prototype, "runId", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'text' }),
+    __metadata("design:type", String)
+], AgentApproval.prototype, "question", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AgentApproval.prototype, "context", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'varchar', length: 32, default: 'pending' }),
+    __metadata("design:type", String)
+], AgentApproval.prototype, "status", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AgentApproval.prototype, "response", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'datetime', nullable: true, name: 'responded_at' }),
+    __metadata("design:type", Object)
+], AgentApproval.prototype, "respondedAt", void 0);
+__decorate([
+    (0, core_1.CreateDateColumn)({ name: 'created_at' }),
+    __metadata("design:type", Date)
+], AgentApproval.prototype, "createdAt", void 0);
+exports.AgentApproval = AgentApproval = __decorate([
+    (0, core_1.Entity)('agent_approval')
+], AgentApproval);
+//# sourceMappingURL=agent-approval.entity.js.map

package/dist/src/agent/agent-approval.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-approval.entity.js","sourceRoot":"","sources":["../../../src/agent/agent-approval.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAK0B;AAKnB,IAAM,aAAa,GAAnB,MAAM,aAAa;IAExB,EAAE,CAAU;IAGZ,KAAK,CAAU;IAEf,mEAAmE;IAEnE,QAAQ,CAAU;IAElB,iEAAiE;IAEjE,OAAO,CAAiB;IAGxB,MAAM,CAAuB;IAE7B,yDAAyD;IAEzD,QAAQ,CAAiB;IAGzB,WAAW,CAAe;IAG1B,SAAS,CAAQ;CAClB,CAAA;AA3BY,sCAAa;AAExB;IADC,IAAA,6BAAsB,EAAC,MAAM,CAAC;;yCACnB;AAGZ;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;4CACzC;AAIf;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;+CACP;AAIlB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CACjB;AAGxB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;;6CAC/B;AAI7B;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+CAChB;AAGzB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;;kDACzC;AAG1B;IADC,IAAA,uBAAgB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;8BAC7B,IAAI;gDAAC;wBA1BN,aAAa;IADzB,IAAA,aAAM,EAAC,gBAAgB,CAAC;GACZ,aAAa,CA2BzB"}

package/dist/src/agent/agent-approval.service.d.ts

@@ -0,0 +1,35 @@
+import type { Repository } from '@octo-cyber/core';
+import { AgentApproval } from './agent-approval.entity.js';
+export interface AgentApprovalDto {
+    id: string;
+    runId: string;
+    question: string;
+    context: string | null;
+    status: 'pending' | 'approved' | 'rejected';
+    response: string | null;
+    respondedAt: string | null;
+    createdAt: string;
+}
+/**
+ * AgentApprovalService — human-in-the-loop approval mechanism.
+ *
+ * An agent creates an approval request when it needs a human to confirm a
+ * sensitive operation. The agent then calls waitForResponse() to block until
+ * a human approves or rejects, or until the timeout expires.
+ */
+export declare class AgentApprovalService {
+    private repo;
+    setRepository(repo: Repository<AgentApproval>): void;
+    private getRepo;
+    create(runId: string, question: string, context?: string): Promise<AgentApproval>;
+    getPending(): Promise<AgentApproval[]>;
+    getById(id: string): Promise<AgentApproval | null>;
+    respond(id: string, approved: boolean, response?: string): Promise<AgentApproval>;
+    /**
+     * Poll the database every 2 s until the approval is resolved or timeout expires.
+     * Returns the final decision or 'timeout'.
+     */
+    waitForResponse(id: string, timeoutMs?: number): Promise<'approved' | 'rejected' | 'timeout'>;
+    toDto(approval: AgentApproval): AgentApprovalDto;
+}
+//# sourceMappingURL=agent-approval.service.d.ts.map

package/dist/src/agent/agent-approval.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-approval.service.d.ts","sourceRoot":"","sources":["../../../src/agent/agent-approval.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAI3D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAC5C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBACa,oBAAoB;IAC/B,OAAO,CAAC,IAAI,CAA0C;IAEtD,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,IAAI;IAIpD,OAAO,CAAC,OAAO;IAKT,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAajF,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAOtC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIlD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmBvF;;;OAGG;IACG,eAAe,CACnB,EAAE,EAAE,MAAM,EACV,SAAS,SAAU,GAClB,OAAO,CAAC,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAgB/C,KAAK,CAAC,QAAQ,EAAE,aAAa,GAAG,gBAAgB;CAYjD"}

package/dist/src/agent/agent-approval.service.js

@@ -0,0 +1,109 @@
+"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.AgentApprovalService = void 0;
+const core_1 = require("@octo-cyber/core");
+const POLL_INTERVAL_MS = 2_000;
+/**
+ * AgentApprovalService — human-in-the-loop approval mechanism.
+ *
+ * An agent creates an approval request when it needs a human to confirm a
+ * sensitive operation. The agent then calls waitForResponse() to block until
+ * a human approves or rejects, or until the timeout expires.
+ */
+let AgentApprovalService = class AgentApprovalService {
+    repo = null;
+    setRepository(repo) {
+        this.repo = repo;
+    }
+    getRepo() {
+        if (!this.repo)
+            throw new Error('AgentApprovalService: repository not initialized');
+        return this.repo;
+    }
+    async create(runId, question, context) {
+        const repo = this.getRepo();
+        const approval = repo.create({
+            runId,
+            question,
+            context: context ?? null,
+            status: 'pending',
+            response: null,
+            respondedAt: null,
+        });
+        return repo.save(approval);
+    }
+    async getPending() {
+        return this.getRepo().find({
+            where: { status: 'pending' },
+            order: { createdAt: 'DESC' },
+        });
+    }
+    async getById(id) {
+        return this.getRepo().findOne({ where: { id } });
+    }
+    async respond(id, approved, response) {
+        const repo = this.getRepo();
+        const approval = await repo.findOne({ where: { id } });
+        if (!approval)
+            throw core_1.AppError.notFound(`Agent approval not found: ${id}`);
+        if (approval.status !== 'pending') {
+            throw core_1.AppError.badRequest(`Approval ${id} has already been resolved (${approval.status})`);
+        }
+        await repo.update(id, {
+            status: approved ? 'approved' : 'rejected',
+            response: response ?? null,
+            respondedAt: new Date(),
+        });
+        const updated = await repo.findOne({ where: { id } });
+        if (!updated)
+            throw core_1.AppError.notFound(`Agent approval not found after update: ${id}`);
+        return updated;
+    }
+    /**
+     * Poll the database every 2 s until the approval is resolved or timeout expires.
+     * Returns the final decision or 'timeout'.
+     */
+    async waitForResponse(id, timeoutMs = 300_000) {
+        const repo = this.getRepo();
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            const approval = await repo.findOne({ where: { id } });
+            if (!approval)
+                return 'timeout';
+            if (approval.status === 'approved')
+                return 'approved';
+            if (approval.status === 'rejected')
+                return 'rejected';
+            await sleep(POLL_INTERVAL_MS);
+        }
+        return 'timeout';
+    }
+    toDto(approval) {
+        return {
+            id: approval.id,
+            runId: approval.runId,
+            question: approval.question,
+            context: approval.context,
+            status: approval.status,
+            response: approval.response,
+            respondedAt: approval.respondedAt?.toISOString() ?? null,
+            createdAt: approval.createdAt.toISOString(),
+        };
+    }
+};
+exports.AgentApprovalService = AgentApprovalService;
+exports.AgentApprovalService = AgentApprovalService = __decorate([
+    (0, core_1.Service)()
+], AgentApprovalService);
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// Ensure singleton is registered in DI at import time
+core_1.Container.get(AgentApprovalService);
+//# sourceMappingURL=agent-approval.service.js.map

package/dist/src/agent/agent-approval.service.js.map

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

package/dist/src/agent/agent-gateway.controller.d.ts

@@ -0,0 +1,30 @@
+import type { Request, Response } from '@octo-cyber/core';
+/**
+ * AgentGatewayController — unified agent capability registry and execution gateway.
+ *
+ * Endpoints:
+ *   GET  /api/v1/agents          — List all registered agent capabilities
+ *   GET  /api/v1/agents/:type    — Get a specific agent capability by type
+ *   POST /api/v1/agents/execute  — Universal execute (routes to the right agent adapter)
+ */
+export declare class AgentGatewayController {
+    private get registry();
+    private get gateway();
+    /** List all registered agent capabilities. */
+    listAgents(_req: Request, res: Response): void;
+    /** Get a specific agent capability by type. */
+    getAgent(req: Request, res: Response): void;
+    /**
+     * Execute an agent task via the unified gateway.
+     *
+     * Body:
+     *   agentType  {AgentType} — Target agent type
+     *   prompt     {string}    — Task description
+     *   maxRounds  {number?}   — Max LLM rounds (default 20, max 50)
+     *   timeoutMs  {number?}   — Timeout in ms (default 300 000)
+     *   async      {boolean?}  — If true, returns runId immediately (default false)
+     *   metadata   {object?}   — Adapter-specific config
+     */
+    executeAgent(req: Request, res: Response): Promise<void>;
+}
+//# sourceMappingURL=agent-gateway.controller.d.ts.map

package/dist/src/agent/agent-gateway.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-gateway.controller.d.ts","sourceRoot":"","sources":["../../../src/agent/agent-gateway.controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAiB1D;;;;;;;GAOG;AACH,qBACa,sBAAsB;IACjC,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,OAAO,GAElB;IAED,8CAA8C;IAE9C,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI;IAK9C,+CAA+C;IAE/C,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI;IAS3C;;;;;;;;;;OAUG;IAEG,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAyC/D"}

package/dist/src/agent/agent-gateway.controller.js

@@ -0,0 +1,112 @@
+"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.AgentGatewayController = void 0;
+const core_1 = require("@octo-cyber/core");
+const agent_registry_service_js_1 = require("./agent-registry.service.js");
+const agent_gateway_service_js_1 = require("./agent-gateway.service.js");
+const VALID_AGENT_TYPES = new Set([
+    'computer-use',
+    'coding',
+    'cli',
+    'dify',
+    'remote',
+]);
+const MAX_ROUNDS_DEFAULT = 20;
+const MAX_ROUNDS_LIMIT = 50;
+const TIMEOUT_MS_DEFAULT = 300_000;
+/**
+ * AgentGatewayController — unified agent capability registry and execution gateway.
+ *
+ * Endpoints:
+ *   GET  /api/v1/agents          — List all registered agent capabilities
+ *   GET  /api/v1/agents/:type    — Get a specific agent capability by type
+ *   POST /api/v1/agents/execute  — Universal execute (routes to the right agent adapter)
+ */
+let AgentGatewayController = class AgentGatewayController {
+    get registry() {
+        return core_1.Container.get(agent_registry_service_js_1.AgentRegistryService);
+    }
+    get gateway() {
+        return core_1.Container.get(agent_gateway_service_js_1.AgentGatewayService);
+    }
+    /** List all registered agent capabilities. */
+    listAgents(_req, res) {
+        const capabilities = this.registry.list();
+        res.json(core_1.ApiResponse.ok(capabilities));
+    }
+    /** Get a specific agent capability by type. */
+    getAgent(req, res) {
+        const type = String(req.params['type'] ?? '');
+        const capability = this.registry.get(type);
+        if (!capability) {
+            throw core_1.AppError.notFound(`Agent type not registered: ${type}`);
+        }
+        res.json(core_1.ApiResponse.ok(capability));
+    }
+    /**
+     * Execute an agent task via the unified gateway.
+     *
+     * Body:
+     *   agentType  {AgentType} — Target agent type
+     *   prompt     {string}    — Task description
+     *   maxRounds  {number?}   — Max LLM rounds (default 20, max 50)
+     *   timeoutMs  {number?}   — Timeout in ms (default 300 000)
+     *   async      {boolean?}  — If true, returns runId immediately (default false)
+     *   metadata   {object?}   — Adapter-specific config
+     */
+    async executeAgent(req, res) {
+        const { agentType, prompt, maxRounds, timeoutMs, async: asyncMode, metadata } = req.body;
+        if (!prompt || typeof prompt !== 'string' || prompt.trim().length === 0) {
+            throw core_1.AppError.badRequest('Missing or invalid prompt');
+        }
+        if (!agentType || typeof agentType !== 'string') {
+            throw core_1.AppError.badRequest('Missing or invalid agentType');
+        }
+        if (!VALID_AGENT_TYPES.has(agentType)) {
+            throw core_1.AppError.badRequest(`Invalid agentType: ${agentType}. Valid types: ${[...VALID_AGENT_TYPES].join(', ')}`);
+        }
+        const result = await this.gateway.execute({
+            agentType: agentType,
+            prompt: prompt.trim(),
+            maxRounds: Math.min(typeof maxRounds === 'number' ? maxRounds : MAX_ROUNDS_DEFAULT, MAX_ROUNDS_LIMIT),
+            timeoutMs: typeof timeoutMs === 'number' ? timeoutMs : TIMEOUT_MS_DEFAULT,
+            async: asyncMode === true || asyncMode === 'true',
+            metadata: metadata && typeof metadata === 'object'
+                ? metadata
+                : undefined,
+        });
+        res.json(core_1.ApiResponse.ok(result));
+    }
+};
+exports.AgentGatewayController = AgentGatewayController;
+__decorate([
+    (0, core_1.Get)('/'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", void 0)
+], AgentGatewayController.prototype, "listAgents", null);
+__decorate([
+    (0, core_1.Get)('/:type'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", void 0)
+], AgentGatewayController.prototype, "getAgent", null);
+__decorate([
+    (0, core_1.Post)('/execute'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentGatewayController.prototype, "executeAgent", null);
+exports.AgentGatewayController = AgentGatewayController = __decorate([
+    (0, core_1.Controller)('/api/v1/agents')
+], AgentGatewayController);
+//# sourceMappingURL=agent-gateway.controller.js.map

package/dist/src/agent/agent-gateway.controller.js.map

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

package/dist/src/agent/agent-gateway.service.d.ts

@@ -0,0 +1,33 @@
+import type { AgentType } from './agent-registry.service.js';
+export interface GatewayExecuteOptions {
+    agentType: AgentType;
+    prompt: string;
+    maxRounds?: number;
+    timeoutMs?: number;
+    metadata?: Record<string, unknown>;
+    async?: boolean;
+}
+export interface GatewayExecuteResult {
+    runId?: string;
+    output?: string;
+    status: string;
+}
+/**
+ * AgentGatewayService — routes execution requests to the correct agent adapter.
+ *
+ * Routing logic:
+ *   async=true  → delegates to AgentRunService.submit(), returns { runId, status: 'pending' }
+ *   async=false → runs OctoAgentClient directly (computer-use), returns { output, status: 'completed' }
+ *
+ * Throws AppError if the requested agent type is not registered or not available.
+ */
+export declare class AgentGatewayService {
+    private get registry();
+    private get agentRunService();
+    execute(opts: GatewayExecuteOptions): Promise<GatewayExecuteResult>;
+    private assertCapabilityAvailable;
+    private executeAsync;
+    private executeSync;
+    private runComputerUseSync;
+}
+//# sourceMappingURL=agent-gateway.service.d.ts.map

package/dist/src/agent/agent-gateway.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-gateway.service.d.ts","sourceRoot":"","sources":["../../../src/agent/agent-gateway.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAM7D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,qBACa,mBAAmB;IAC9B,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,eAAe,GAE1B;IAEK,OAAO,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAYzE,OAAO,CAAC,yBAAyB;YAUnB,YAAY;YAcZ,WAAW;YASX,kBAAkB;CAcjC"}

package/dist/src/agent/agent-gateway.service.js

@@ -0,0 +1,84 @@
+"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.AgentGatewayService = void 0;
+const core_1 = require("@octo-cyber/core");
+const agent_registry_service_js_1 = require("./agent-registry.service.js");
+const agent_run_service_js_1 = require("./agent-run.service.js");
+const OctoAgentClient_js_1 = require("../workflow-design/OctoAgentClient.js");
+const computer_use_tools_js_1 = require("./computer-use-tools.js");
+/**
+ * AgentGatewayService — routes execution requests to the correct agent adapter.
+ *
+ * Routing logic:
+ *   async=true  → delegates to AgentRunService.submit(), returns { runId, status: 'pending' }
+ *   async=false → runs OctoAgentClient directly (computer-use), returns { output, status: 'completed' }
+ *
+ * Throws AppError if the requested agent type is not registered or not available.
+ */
+let AgentGatewayService = class AgentGatewayService {
+    get registry() {
+        return core_1.Container.get(agent_registry_service_js_1.AgentRegistryService);
+    }
+    get agentRunService() {
+        return core_1.Container.get(agent_run_service_js_1.AgentRunService);
+    }
+    async execute(opts) {
+        this.assertCapabilityAvailable(opts.agentType);
+        if (opts.async === true) {
+            return this.executeAsync(opts);
+        }
+        return this.executeSync(opts);
+    }
+    // ─── Private helpers ──────────────────────────────────────────────────
+    assertCapabilityAvailable(type) {
+        const capability = this.registry.get(type);
+        if (!capability) {
+            throw core_1.AppError.notFound(`Agent type not registered: ${type}`);
+        }
+        if (!capability.isAvailable) {
+            throw core_1.AppError.badRequest(`Agent type not available: ${type}`);
+        }
+    }
+    async executeAsync(opts) {
+        // Normalize remote:{agentId} keys to 'remote' for AgentRunService storage
+        const agentType = (opts.agentType.startsWith('remote:') ? 'remote' : opts.agentType);
+        const run = await this.agentRunService.submit({
+            agentType,
+            prompt: opts.prompt,
+            maxRounds: opts.maxRounds,
+            timeoutMs: opts.timeoutMs,
+            metadata: opts.metadata,
+        });
+        return { runId: run.id, status: 'pending' };
+    }
+    async executeSync(opts) {
+        if (opts.agentType === 'computer-use') {
+            return this.runComputerUseSync(opts);
+        }
+        // All non-computer-use types fall back to async execution via AgentRunService
+        return this.executeAsync(opts);
+    }
+    async runComputerUseSync(opts) {
+        const client = new OctoAgentClient_js_1.OctoAgentClient();
+        const tools = (0, computer_use_tools_js_1.createComputerUseTools)();
+        const output = await client.run({
+            systemPrompt: computer_use_tools_js_1.SYSTEM_PROMPT_COMPUTER_USE,
+            userMessage: opts.prompt,
+            tools,
+            maxRounds: opts.maxRounds ?? 20,
+            timeoutMs: opts.timeoutMs ?? 300_000,
+        });
+        return { output, status: 'completed' };
+    }
+};
+exports.AgentGatewayService = AgentGatewayService;
+exports.AgentGatewayService = AgentGatewayService = __decorate([
+    (0, core_1.Service)()
+], AgentGatewayService);
+//# sourceMappingURL=agent-gateway.service.js.map

package/dist/src/agent/agent-gateway.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-gateway.service.js","sourceRoot":"","sources":["../../../src/agent/agent-gateway.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgE;AAChE,2EAAmE;AAEnE,iEAAyD;AAEzD,8EAAwE;AACxE,mEAA6F;AAiB7F;;;;;;;;GAQG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,IAAY,QAAQ;QAClB,OAAO,gBAAS,CAAC,GAAG,CAAC,gDAAoB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAY,eAAe;QACzB,OAAO,gBAAS,CAAC,GAAG,CAAC,sCAAe,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAA2B;QACvC,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE/C,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,yEAAyE;IAEjE,yBAAyB,CAAC,IAAe;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,eAAQ,CAAC,QAAQ,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YAC5B,MAAM,eAAQ,CAAC,UAAU,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,IAA2B;QACpD,0EAA0E;QAC1E,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAiB,CAAC;QACrG,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;YAC5C,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QAEH,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,IAA2B;QACnD,IAAI,IAAI,CAAC,SAAS,KAAK,cAAc,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAED,8EAA8E;QAC9E,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,IAA2B;QAC1D,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,kDAA0B;YACxC,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,OAAO;SACrC,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACzC,CAAC;CACF,CAAA;AApEY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,cAAO,GAAE;GACG,mBAAmB,CAoE/B"}

package/dist/src/agent/agent-registry.service.d.ts

@@ -0,0 +1,30 @@
+export type BuiltinAgentType = 'computer-use' | 'coding' | 'cli' | 'dify' | 'remote';
+export type AgentType = BuiltinAgentType | `remote:${string}`;
+export interface AgentCapability {
+    type: AgentType;
+    name: string;
+    description: string;
+    isAvailable: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * AgentRegistryService — maintains a registry of all agent capabilities.
+ *
+ * Provides a central catalog of what agent types are registered and available.
+ * Adapters register themselves during module initialization; the gateway
+ * queries this registry before routing execution requests.
+ */
+export declare class AgentRegistryService {
+    private readonly capabilities;
+    /** Register or update a capability. Overwrites any existing entry for the same type. */
+    register(capability: AgentCapability): void;
+    /** Remove a registered capability by type. No-op if not found. */
+    unregister(type: AgentType): void;
+    /** Get a capability by type. Returns undefined if not registered. */
+    get(type: AgentType): AgentCapability | undefined;
+    /** List all registered capabilities (available and unavailable). */
+    list(): AgentCapability[];
+    /** List only capabilities where isAvailable === true. */
+    getAvailable(): AgentCapability[];
+}
+//# sourceMappingURL=agent-registry.service.d.ts.map

package/dist/src/agent/agent-registry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.service.d.ts","sourceRoot":"","sources":["../../../src/agent/agent-registry.service.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AACrF,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,UAAU,MAAM,EAAE,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;GAMG;AACH,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsC;IAEnE,wFAAwF;IACxF,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAI3C,kEAAkE;IAClE,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAIjC,qEAAqE;IACrE,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS;IAIjD,oEAAoE;IACpE,IAAI,IAAI,eAAe,EAAE;IAIzB,yDAAyD;IACzD,YAAY,IAAI,eAAe,EAAE;CAGlC"}

package/dist/src/agent/agent-registry.service.js

@@ -0,0 +1,45 @@
+"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.AgentRegistryService = void 0;
+const core_1 = require("@octo-cyber/core");
+/**
+ * AgentRegistryService — maintains a registry of all agent capabilities.
+ *
+ * Provides a central catalog of what agent types are registered and available.
+ * Adapters register themselves during module initialization; the gateway
+ * queries this registry before routing execution requests.
+ */
+let AgentRegistryService = class AgentRegistryService {
+    capabilities = new Map();
+    /** Register or update a capability. Overwrites any existing entry for the same type. */
+    register(capability) {
+        this.capabilities.set(capability.type, { ...capability });
+    }
+    /** Remove a registered capability by type. No-op if not found. */
+    unregister(type) {
+        this.capabilities.delete(type);
+    }
+    /** Get a capability by type. Returns undefined if not registered. */
+    get(type) {
+        return this.capabilities.get(type);
+    }
+    /** List all registered capabilities (available and unavailable). */
+    list() {
+        return Array.from(this.capabilities.values());
+    }
+    /** List only capabilities where isAvailable === true. */
+    getAvailable() {
+        return this.list().filter((c) => c.isAvailable);
+    }
+};
+exports.AgentRegistryService = AgentRegistryService;
+exports.AgentRegistryService = AgentRegistryService = __decorate([
+    (0, core_1.Service)()
+], AgentRegistryService);
+//# sourceMappingURL=agent-registry.service.js.map

package/dist/src/agent/agent-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.service.js","sourceRoot":"","sources":["../../../src/agent/agent-registry.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA2C;AAc3C;;;;;;GAMG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IACd,YAAY,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEnE,wFAAwF;IACxF,QAAQ,CAAC,UAA2B;QAClC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,kEAAkE;IAClE,UAAU,CAAC,IAAe;QACxB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,qEAAqE;IACrE,GAAG,CAAC,IAAe;QACjB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,oEAAoE;IACpE,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,yDAAyD;IACzD,YAAY;QACV,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF,CAAA;AA3BY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,cAAO,GAAE;GACG,oBAAoB,CA2BhC"}

package/dist/src/agent/agent-run.controller.d.ts

@@ -0,0 +1,42 @@
+import type { Request, Response } from '@octo-cyber/core';
+/**
+ * AgentRunController — async agent execution API.
+ *
+ * Endpoints:
+ *   POST /api/v1/ai/agent/run          — Submit a new agent run (returns runId immediately)
+ *   GET  /api/v1/ai/agent/run          — List recent runs
+ *   GET  /api/v1/ai/agent/run/:id      — Get run status + result
+ *   POST /api/v1/ai/agent/run/:id/cancel — Cancel a pending/running run
+ *   GET  /api/v1/ai/agent/run/:id/events — SSE stream of run events
+ */
+export declare class AgentRunController {
+    private get service();
+    /**
+     * Submit a new agent run.
+     *
+     * Body:
+     *   agentType  {'computer-use'|'coding'|'cli'} — Agent type
+     *   prompt     {string}                        — Task description
+     *   maxRounds  {number?}                       — Max LLM rounds (default 20, max 50)
+     *   timeoutMs  {number?}                       — Timeout in ms (default 300 000)
+     *   metadata   {object?}                       — Adapter-specific config
+     */
+    submitRun(req: Request, res: Response): Promise<void>;
+    /** List recent agent runs (newest first, max 20). */
+    listRuns(_req: Request, res: Response): Promise<void>;
+    /** Get status and result of a specific run. */
+    getRunStatus(req: Request, res: Response): Promise<void>;
+    /** Cancel a pending or running agent run. */
+    cancelRun(req: Request, res: Response): Promise<void>;
+    /**
+     * SSE stream — emits run lifecycle events until terminal state.
+     *
+     * Events:
+     *   status  — {status, output?, error?}  on every state transition
+     *   done    — final event when run reaches completed/failed/cancelled
+     *
+     * Clients should close the connection on receiving `done`.
+     */
+    streamRunEvents(req: Request, res: Response): Promise<void>;
+}
+//# sourceMappingURL=agent-run.controller.d.ts.map

package/dist/src/agent/agent-run.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run.controller.d.ts","sourceRoot":"","sources":["../../../src/agent/agent-run.controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAO1D;;;;;;;;;GASG;AACH,qBACa,kBAAkB;IAC7B,OAAO,KAAK,OAAO,GAElB;IAED;;;;;;;;;OASG;IAEG,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC3D,qDAAqD;IAE/C,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D,+CAA+C;IAEzC,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,6CAA6C;IAEvC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D;;;;;;;;OAQG;IAEG,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA8ElE"}