@octo-cyber/ai 0.5.5 → 0.5.7

package/dist/src/agent/agent-run-persistence.service.js

@@ -0,0 +1,171 @@
+"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.AgentRunPersistenceService = void 0;
+const core_1 = require("@octo-cyber/core");
+/**
+ * AgentRunPersistenceService — fine-grained persistence for agent runs and steps.
+ *
+ * Responsibilities:
+ *   - createRun()         — insert a new AgentRun row
+ *   - updateRunStatus()   — transition status + fill output/error/duration
+ *   - addStep()           — append an AgentRunStep row
+ *   - getRunHistory()     — list runs with their steps (newest first)
+ */
+let AgentRunPersistenceService = class AgentRunPersistenceService {
+    logger = core_1.Container.get(core_1.LoggerService).child('AgentRunPersistenceService');
+    runRepo = null;
+    stepRepo = null;
+    setRepositories(runRepo, stepRepo) {
+        this.runRepo = runRepo;
+        this.stepRepo = stepRepo;
+    }
+    getRunRepo() {
+        if (!this.runRepo)
+            throw new Error('AgentRunPersistenceService: runRepo not initialized');
+        return this.runRepo;
+    }
+    getStepRepo() {
+        if (!this.stepRepo)
+            throw new Error('AgentRunPersistenceService: stepRepo not initialized');
+        return this.stepRepo;
+    }
+    /** Create a new AgentRun row in pending state. */
+    async createRun(opts) {
+        const repo = this.getRunRepo();
+        const run = repo.create({
+            agentType: opts.agentType,
+            status: 'pending',
+            prompt: opts.prompt,
+            userId: opts.userId ?? null,
+            maxRounds: opts.maxRounds ?? 20,
+            rounds: 0,
+            output: null,
+            error: null,
+            duration: null,
+            startedAt: null,
+            endedAt: null,
+            metadata: opts.metadata ? JSON.stringify(opts.metadata) : null,
+        });
+        return repo.save(run);
+    }
+    /** Transition the run to a new status and optionally record output/error/duration. */
+    async updateRunStatus(runId, status, extra) {
+        const repo = this.getRunRepo();
+        const patch = { status };
+        if (status === 'running' && !extra?.startedAt) {
+            patch.startedAt = new Date();
+        }
+        if (extra?.startedAt)
+            patch.startedAt = extra.startedAt;
+        if (extra?.endedAt)
+            patch.endedAt = extra.endedAt;
+        if (extra?.output !== undefined)
+            patch.output = extra.output;
+        if (extra?.error !== undefined)
+            patch.error = extra.error;
+        if (['completed', 'failed', 'cancelled'].includes(status)) {
+            const run = await repo.findOne({ where: { id: runId } });
+            if (run?.startedAt) {
+                const endTime = extra?.endedAt ?? new Date();
+                patch.duration = endTime.getTime() - run.startedAt.getTime();
+                patch.endedAt = endTime;
+            }
+        }
+        await repo.update(runId, patch);
+        this.logger.debug(`[AgentRunPersistenceService] run ${runId} → ${status}`);
+    }
+    /** Record a single tool-call step within a run. */
+    async addStep(opts) {
+        const repo = this.getStepRepo();
+        const step = repo.create({
+            runId: opts.runId,
+            stepIndex: opts.stepIndex,
+            toolName: opts.toolName,
+            input: opts.input !== undefined ? JSON.stringify(opts.input) : null,
+            output: opts.output !== undefined ? JSON.stringify(opts.output) : null,
+            status: opts.status,
+            duration: opts.duration ?? null,
+        });
+        return repo.save(step);
+    }
+    /** List runs newest-first, with their steps ordered by stepIndex. */
+    async getRunHistory(limit = 20, userId) {
+        const runRepo = this.getRunRepo();
+        const stepRepo = this.getStepRepo();
+        const where = userId ? { userId } : {};
+        const runs = await runRepo.find({
+            where,
+            order: { createdAt: 'DESC' },
+            take: limit,
+        });
+        return Promise.all(runs.map(async (run) => {
+            const steps = await stepRepo.find({
+                where: { runId: run.id },
+                order: { stepIndex: 'ASC' },
+            });
+            return this.toRunWithStepsDto(run, steps);
+        }));
+    }
+    /** Get a single run with its steps. */
+    async getRunWithSteps(runId) {
+        const run = await this.getRunRepo().findOne({ where: { id: runId } });
+        if (!run)
+            return null;
+        const steps = await this.getStepRepo().find({
+            where: { runId },
+            order: { stepIndex: 'ASC' },
+        });
+        return this.toRunWithStepsDto(run, steps);
+    }
+    toRunWithStepsDto(run, steps) {
+        return {
+            id: run.id,
+            agentType: run.agentType,
+            status: run.status,
+            prompt: run.prompt,
+            output: run.output,
+            error: run.error,
+            rounds: run.rounds,
+            maxRounds: run.maxRounds,
+            userId: run.userId,
+            duration: run.duration,
+            startedAt: run.startedAt?.toISOString() ?? null,
+            endedAt: run.endedAt?.toISOString() ?? null,
+            createdAt: run.createdAt.toISOString(),
+            steps: steps.map((s) => this.toStepDto(s)),
+        };
+    }
+    toStepDto(step) {
+        const parseJson = (raw) => {
+            if (!raw)
+                return null;
+            try {
+                return JSON.parse(raw);
+            }
+            catch {
+                return raw;
+            }
+        };
+        return {
+            id: step.id,
+            stepIndex: step.stepIndex,
+            toolName: step.toolName,
+            input: parseJson(step.input),
+            output: parseJson(step.output),
+            status: step.status,
+            duration: step.duration,
+            createdAt: step.createdAt.toISOString(),
+        };
+    }
+};
+exports.AgentRunPersistenceService = AgentRunPersistenceService;
+exports.AgentRunPersistenceService = AgentRunPersistenceService = __decorate([
+    (0, core_1.Service)()
+], AgentRunPersistenceService);
+//# sourceMappingURL=agent-run-persistence.service.js.map

package/dist/src/agent/agent-run-persistence.service.js.map

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

package/dist/src/agent/agent-run-step.entity.d.ts

@@ -0,0 +1,23 @@
+export type StepStatus = 'running' | 'completed' | 'failed';
+/**
+ * AgentRunStep — records a single tool-call step within an AgentRun.
+ *
+ * Allows fine-grained replay / audit of what actions the agent took.
+ */
+export declare class AgentRunStep {
+    id: string;
+    runId: string;
+    /** Zero-based position of this step in the run. */
+    stepIndex: number;
+    /** Name of the tool called (e.g. "bash", "computer_use", "read_file"). */
+    toolName: string;
+    /** JSON-serialized tool input arguments. */
+    input: string | null;
+    /** JSON-serialized tool output / result. */
+    output: string | null;
+    status: StepStatus;
+    /** Execution duration in milliseconds. */
+    duration: number | null;
+    createdAt: Date;
+}
+//# sourceMappingURL=agent-run-step.entity.d.ts.map

package/dist/src/agent/agent-run-step.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-step.entity.d.ts","sourceRoot":"","sources":["../../../src/agent/agent-run-step.entity.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5D;;;;GAIG;AACH,qBACa,YAAY;IAEvB,EAAE,EAAG,MAAM,CAAC;IAIZ,KAAK,EAAG,MAAM,CAAC;IAEf,mDAAmD;IAEnD,SAAS,EAAG,MAAM,CAAC;IAEnB,0EAA0E;IAE1E,QAAQ,EAAG,MAAM,CAAC;IAElB,4CAA4C;IAE5C,KAAK,EAAG,MAAM,GAAG,IAAI,CAAC;IAEtB,4CAA4C;IAE5C,MAAM,EAAG,MAAM,GAAG,IAAI,CAAC;IAGvB,MAAM,EAAG,UAAU,CAAC;IAEpB,0CAA0C;IAE1C,QAAQ,EAAG,MAAM,GAAG,IAAI,CAAC;IAGzB,SAAS,EAAG,IAAI,CAAC;CAClB"}

package/dist/src/agent/agent-run-step.entity.js

@@ -0,0 +1,76 @@
+"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.AgentRunStep = void 0;
+const core_1 = require("@octo-cyber/core");
+/**
+ * AgentRunStep — records a single tool-call step within an AgentRun.
+ *
+ * Allows fine-grained replay / audit of what actions the agent took.
+ */
+let AgentRunStep = class AgentRunStep {
+    id;
+    runId;
+    /** Zero-based position of this step in the run. */
+    stepIndex;
+    /** Name of the tool called (e.g. "bash", "computer_use", "read_file"). */
+    toolName;
+    /** JSON-serialized tool input arguments. */
+    input;
+    /** JSON-serialized tool output / result. */
+    output;
+    status;
+    /** Execution duration in milliseconds. */
+    duration;
+    createdAt;
+};
+exports.AgentRunStep = AgentRunStep;
+__decorate([
+    (0, core_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], AgentRunStep.prototype, "id", void 0);
+__decorate([
+    (0, core_1.Index)(),
+    (0, core_1.Column)({ type: 'varchar', length: 36, name: 'run_id' }),
+    __metadata("design:type", String)
+], AgentRunStep.prototype, "runId", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'integer', name: 'step_index' }),
+    __metadata("design:type", Number)
+], AgentRunStep.prototype, "stepIndex", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'varchar', length: 128, name: 'tool_name' }),
+    __metadata("design:type", String)
+], AgentRunStep.prototype, "toolName", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AgentRunStep.prototype, "input", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AgentRunStep.prototype, "output", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'varchar', length: 16, default: 'running' }),
+    __metadata("design:type", String)
+], AgentRunStep.prototype, "status", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'integer', nullable: true }),
+    __metadata("design:type", Object)
+], AgentRunStep.prototype, "duration", void 0);
+__decorate([
+    (0, core_1.CreateDateColumn)({ name: 'created_at' }),
+    __metadata("design:type", Date)
+], AgentRunStep.prototype, "createdAt", void 0);
+exports.AgentRunStep = AgentRunStep = __decorate([
+    (0, core_1.Entity)('agent_run_step')
+], AgentRunStep);
+//# sourceMappingURL=agent-run-step.entity.js.map

package/dist/src/agent/agent-run-step.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-step.entity.js","sourceRoot":"","sources":["../../../src/agent/agent-run-step.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAM0B;AAI1B;;;;GAIG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAY;IAEvB,EAAE,CAAU;IAIZ,KAAK,CAAU;IAEf,mDAAmD;IAEnD,SAAS,CAAU;IAEnB,0EAA0E;IAE1E,QAAQ,CAAU;IAElB,4CAA4C;IAE5C,KAAK,CAAiB;IAEtB,4CAA4C;IAE5C,MAAM,CAAiB;IAGvB,MAAM,CAAc;IAEpB,0CAA0C;IAE1C,QAAQ,CAAiB;IAGzB,SAAS,CAAQ;CAClB,CAAA;AAjCY,oCAAY;AAEvB;IADC,IAAA,6BAAsB,EAAC,MAAM,CAAC;;wCACnB;AAIZ;IAFC,IAAA,YAAK,GAAE;IACP,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;2CACzC;AAIf;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;;+CAC7B;AAInB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;;8CAC1C;AAIlB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2CACnB;AAItB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;4CAClB;AAGvB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;;4CACxC;AAIpB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CACnB;AAGzB;IADC,IAAA,uBAAgB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;8BAC7B,IAAI;+CAAC;uBAhCN,YAAY;IADxB,IAAA,aAAM,EAAC,gBAAgB,CAAC;GACZ,YAAY,CAiCxB"}

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"}

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

@@ -0,0 +1,195 @@
+"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.AgentRunController = void 0;
+const core_1 = require("@octo-cyber/core");
+const agent_run_service_js_1 = require("./agent-run.service.js");
+const MAX_ROUNDS_LIMIT = 50;
+const MAX_ROUNDS_DEFAULT = 20;
+const TIMEOUT_MS_DEFAULT = 300_000;
+/**
+ * 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
+ */
+let AgentRunController = class AgentRunController {
+    get service() {
+        return core_1.Container.get(agent_run_service_js_1.AgentRunService);
+    }
+    /**
+     * 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
+     */
+    async submitRun(req, res) {
+        const { agentType, prompt, maxRounds, timeoutMs, metadata } = req.body;
+        if (!prompt || typeof prompt !== 'string' || prompt.trim().length === 0) {
+            throw core_1.AppError.badRequest('Missing or invalid prompt');
+        }
+        const validTypes = ['computer-use', 'coding', 'cli'];
+        const resolvedType = agentType ?? 'computer-use';
+        if (!validTypes.includes(resolvedType)) {
+            throw core_1.AppError.badRequest(`Invalid agentType: ${String(agentType)}`);
+        }
+        const run = await this.service.submit({
+            agentType: resolvedType,
+            prompt: prompt.trim(),
+            maxRounds: Math.min(typeof maxRounds === 'number' ? maxRounds : MAX_ROUNDS_DEFAULT, MAX_ROUNDS_LIMIT),
+            timeoutMs: typeof timeoutMs === 'number' ? timeoutMs : TIMEOUT_MS_DEFAULT,
+            metadata: metadata && typeof metadata === 'object' ? metadata : undefined,
+        });
+        res.json(core_1.ApiResponse.ok(this.service.toDto(run)));
+    }
+    /** List recent agent runs (newest first, max 20). */
+    async listRuns(_req, res) {
+        const runs = await this.service.list();
+        res.json(core_1.ApiResponse.ok(runs.map((r) => this.service.toDto(r))));
+    }
+    /** Get status and result of a specific run. */
+    async getRunStatus(req, res) {
+        const id = String(req.params['id'] ?? '');
+        const run = await this.service.getStatus(id);
+        if (!run)
+            throw core_1.AppError.notFound(`Agent run not found: ${id}`);
+        res.json(core_1.ApiResponse.ok(this.service.toDto(run)));
+    }
+    /** Cancel a pending or running agent run. */
+    async cancelRun(req, res) {
+        const id = String(req.params['id'] ?? '');
+        const cancelled = await this.service.cancel(id);
+        if (!cancelled) {
+            throw core_1.AppError.badRequest('Run not found or already in a terminal state');
+        }
+        res.json(core_1.ApiResponse.ok({ cancelled: true }));
+    }
+    /**
+     * 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`.
+     */
+    async streamRunEvents(req, res) {
+        const runId = String(req.params['id'] ?? '');
+        const run = await this.service.getStatus(runId);
+        if (!run)
+            throw core_1.AppError.notFound(`Agent run not found: ${runId}`);
+        // Disable socket timeout — SSE connections are long-lived
+        req.socket.setTimeout(0);
+        req.socket.setNoDelay(true);
+        req.socket.setKeepAlive(true);
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+            'X-Accel-Buffering': 'no',
+        });
+        const sendEvent = (event, data) => {
+            res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+        };
+        // If already in terminal state, emit and close immediately
+        const terminalStates = new Set(['completed', 'failed', 'cancelled']);
+        if (terminalStates.has(run.status)) {
+            sendEvent('status', this.service.toDto(run));
+            sendEvent('done', { status: run.status });
+            res.end();
+            return;
+        }
+        // Poll until terminal state, emit SSE events on transitions
+        let lastStatus = run.status;
+        const POLL_INTERVAL_MS = 2000;
+        const MAX_POLL_DURATION_MS = 35 * 60 * 1000; // 35 minutes
+        const startAt = Date.now();
+        const interval = setInterval(async () => {
+            if (res.writableEnded) {
+                clearInterval(interval);
+                return;
+            }
+            if (Date.now() - startAt > MAX_POLL_DURATION_MS) {
+                sendEvent('done', { status: 'timeout', error: 'SSE stream exceeded maximum duration' });
+                clearInterval(interval);
+                res.end();
+                return;
+            }
+            try {
+                const current = await this.service.getStatus(runId);
+                if (!current) {
+                    clearInterval(interval);
+                    res.end();
+                    return;
+                }
+                if (current.status !== lastStatus) {
+                    lastStatus = current.status;
+                    sendEvent('status', this.service.toDto(current));
+                }
+                if (terminalStates.has(current.status)) {
+                    sendEvent('done', { status: current.status });
+                    clearInterval(interval);
+                    res.end();
+                }
+            }
+            catch {
+                clearInterval(interval);
+                res.end();
+            }
+        }, POLL_INTERVAL_MS);
+        req.on('close', () => {
+            clearInterval(interval);
+        });
+    }
+};
+exports.AgentRunController = AgentRunController;
+__decorate([
+    (0, core_1.Post)('/run'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentRunController.prototype, "submitRun", null);
+__decorate([
+    (0, core_1.Get)('/run'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentRunController.prototype, "listRuns", null);
+__decorate([
+    (0, core_1.Get)('/run/:id'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentRunController.prototype, "getRunStatus", null);
+__decorate([
+    (0, core_1.Post)('/run/:id/cancel'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentRunController.prototype, "cancelRun", null);
+__decorate([
+    (0, core_1.Get)('/run/:id/events'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentRunController.prototype, "streamRunEvents", null);
+exports.AgentRunController = AgentRunController = __decorate([
+    (0, core_1.Controller)('/api/v1/ai/agent')
+], AgentRunController);
+//# sourceMappingURL=agent-run.controller.js.map

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

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

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

@@ -0,0 +1,35 @@
+export type AgentRunStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+export type AgentRunType = 'computer-use' | 'coding' | 'cli' | 'dify' | 'remote';
+/**
+ * AgentRun — persistent record of an async agent execution.
+ *
+ * Enables the async agent pattern:
+ * 1. Client submits a task → AgentRun row created (status: pending)
+ * 2. Background worker picks it up → status transitions to running
+ * 3. Worker completes → status: completed / failed, output / error filled
+ * 4. Clients poll GET /agent/run/:id or stream SSE /agent/run/:id/events
+ */
+export declare class AgentRun {
+    id: string;
+    /** Which kind of agent is executing this run. */
+    agentType: AgentRunType;
+    status: AgentRunStatus;
+    /** The user-supplied task prompt. */
+    prompt: string;
+    /** Final text output produced by the agent (set on completion). */
+    output: string | null;
+    /** Error message if the run failed. */
+    error: string | null;
+    /** Number of LLM reasoning rounds actually used. */
+    rounds: number;
+    /** Configured upper-bound for LLM reasoning rounds. */
+    maxRounds: number;
+    /** Wall-clock time when the agent loop started (ms after epoch). */
+    startedAt: Date | null;
+    /** Wall-clock time when the agent loop finished. */
+    endedAt: Date | null;
+    /** JSON blob for adapter-specific configuration (tool, model, workingDir…). */
+    metadata: string | null;
+    createdAt: Date;
+}
+//# sourceMappingURL=agent-run.entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run.entity.d.ts","sourceRoot":"","sources":["../../../src/agent/agent-run.entity.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAC1F,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjF;;;;;;;;GAQG;AACH,qBACa,QAAQ;IAEnB,EAAE,EAAG,MAAM,CAAC;IAEZ,iDAAiD;IAEjD,SAAS,EAAG,YAAY,CAAC;IAGzB,MAAM,EAAG,cAAc,CAAC;IAExB,qCAAqC;IAErC,MAAM,EAAG,MAAM,CAAC;IAEhB,mEAAmE;IAEnE,MAAM,EAAG,MAAM,GAAG,IAAI,CAAC;IAEvB,uCAAuC;IAEvC,KAAK,EAAG,MAAM,GAAG,IAAI,CAAC;IAEtB,oDAAoD;IAEpD,MAAM,EAAG,MAAM,CAAC;IAEhB,uDAAuD;IAEvD,SAAS,EAAG,MAAM,CAAC;IAEnB,oEAAoE;IAEpE,SAAS,EAAG,IAAI,GAAG,IAAI,CAAC;IAExB,oDAAoD;IAEpD,OAAO,EAAG,IAAI,GAAG,IAAI,CAAC;IAEtB,+EAA+E;IAE/E,QAAQ,EAAG,MAAM,GAAG,IAAI,CAAC;IAGzB,SAAS,EAAG,IAAI,CAAC;CAClB"}