@octo-cyber/ai 0.5.5 → 0.5.6

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

@@ -0,0 +1,97 @@
+"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.AgentSessionController = void 0;
+const core_1 = require("@octo-cyber/core");
+const agent_session_service_js_1 = require("./agent-session.service.js");
+/**
+ * AgentSessionController — shared context session API.
+ *
+ * Endpoints:
+ *   POST   /api/v1/ai/agent/session           — Create a new session
+ *   GET    /api/v1/ai/agent/session           — List sessions (newest 20)
+ *   GET    /api/v1/ai/agent/session/:id       — Get a session
+ *   PATCH  /api/v1/ai/agent/session/:id/context — Merge-update context
+ *   POST   /api/v1/ai/agent/session/:id/close — Close a session
+ */
+let AgentSessionController = class AgentSessionController {
+    get service() {
+        return core_1.Container.get(agent_session_service_js_1.AgentSessionService);
+    }
+    async createSession(req, res) {
+        const body = req.body;
+        const name = typeof body.name === 'string' ? body.name.trim() || undefined : undefined;
+        const session = await this.service.create(name);
+        res.json(core_1.ApiResponse.ok(this.service.toDto(session)));
+    }
+    async listSessions(_req, res) {
+        const sessions = await this.service.list();
+        res.json(core_1.ApiResponse.ok(sessions.map((s) => this.service.toDto(s))));
+    }
+    async getSession(req, res) {
+        const id = String(req.params['id'] ?? '');
+        const session = await this.service.getById(id);
+        if (!session)
+            throw core_1.AppError.notFound(`Agent session not found: ${id}`);
+        res.json(core_1.ApiResponse.ok(this.service.toDto(session)));
+    }
+    async updateContext(req, res) {
+        const id = String(req.params['id'] ?? '');
+        const patch = req.body;
+        if (!patch || typeof patch !== 'object' || Array.isArray(patch)) {
+            throw core_1.AppError.badRequest('Request body must be a JSON object');
+        }
+        const updated = await this.service.updateContext(id, patch);
+        res.json(core_1.ApiResponse.ok(this.service.toDto(updated)));
+    }
+    async closeSession(req, res) {
+        const id = String(req.params['id'] ?? '');
+        const closed = await this.service.close(id);
+        if (!closed)
+            throw core_1.AppError.notFound(`Agent session not found: ${id}`);
+        res.json(core_1.ApiResponse.ok({ closed: true }));
+    }
+};
+exports.AgentSessionController = AgentSessionController;
+__decorate([
+    (0, core_1.Post)('/session'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentSessionController.prototype, "createSession", null);
+__decorate([
+    (0, core_1.Get)('/session'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentSessionController.prototype, "listSessions", null);
+__decorate([
+    (0, core_1.Get)('/session/:id'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentSessionController.prototype, "getSession", null);
+__decorate([
+    (0, core_1.Patch)('/session/:id/context'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentSessionController.prototype, "updateContext", null);
+__decorate([
+    (0, core_1.Post)('/session/:id/close'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentSessionController.prototype, "closeSession", null);
+exports.AgentSessionController = AgentSessionController = __decorate([
+    (0, core_1.Controller)('/api/v1/ai/agent')
+], AgentSessionController);
+//# sourceMappingURL=agent-session.controller.js.map

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

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

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

@@ -0,0 +1,13 @@
+export type AgentSessionStatus = 'active' | 'closed';
+export declare class AgentSession {
+    id: string;
+    name: string | null;
+    /** JSON blob — shared key/value context for all runs in this session. */
+    context: string;
+    /** JSON array of AgentRun IDs associated with this session. */
+    runIds: string;
+    status: AgentSessionStatus;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=agent-session.entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.entity.d.ts","sourceRoot":"","sources":["../../../src/agent/agent-session.entity.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErD,qBACa,YAAY;IAEvB,EAAE,EAAG,MAAM,CAAC;IAGZ,IAAI,EAAG,MAAM,GAAG,IAAI,CAAC;IAErB,yEAAyE;IAEzE,OAAO,EAAG,MAAM,CAAC;IAEjB,+DAA+D;IAE/D,MAAM,EAAG,MAAM,CAAC;IAGhB,MAAM,EAAG,kBAAkB,CAAC;IAG5B,SAAS,EAAG,IAAI,CAAC;IAGjB,SAAS,EAAG,IAAI,CAAC;CAClB"}

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

@@ -0,0 +1,57 @@
+"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.AgentSession = void 0;
+const core_1 = require("@octo-cyber/core");
+let AgentSession = class AgentSession {
+    id;
+    name;
+    /** JSON blob — shared key/value context for all runs in this session. */
+    context;
+    /** JSON array of AgentRun IDs associated with this session. */
+    runIds;
+    status;
+    createdAt;
+    updatedAt;
+};
+exports.AgentSession = AgentSession;
+__decorate([
+    (0, core_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], AgentSession.prototype, "id", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'varchar', length: 128, nullable: true }),
+    __metadata("design:type", Object)
+], AgentSession.prototype, "name", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'text', default: '{}' }),
+    __metadata("design:type", String)
+], AgentSession.prototype, "context", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'text', default: '[]' }),
+    __metadata("design:type", String)
+], AgentSession.prototype, "runIds", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'varchar', length: 32, default: 'active' }),
+    __metadata("design:type", String)
+], AgentSession.prototype, "status", void 0);
+__decorate([
+    (0, core_1.CreateDateColumn)({ name: 'created_at' }),
+    __metadata("design:type", Date)
+], AgentSession.prototype, "createdAt", void 0);
+__decorate([
+    (0, core_1.UpdateDateColumn)({ name: 'updated_at' }),
+    __metadata("design:type", Date)
+], AgentSession.prototype, "updatedAt", void 0);
+exports.AgentSession = AgentSession = __decorate([
+    (0, core_1.Entity)('agent_session')
+], AgentSession);
+//# sourceMappingURL=agent-session.entity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.entity.js","sourceRoot":"","sources":["../../../src/agent/agent-session.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAM0B;AAKnB,IAAM,YAAY,GAAlB,MAAM,YAAY;IAEvB,EAAE,CAAU;IAGZ,IAAI,CAAiB;IAErB,yEAAyE;IAEzE,OAAO,CAAU;IAEjB,+DAA+D;IAE/D,MAAM,CAAU;IAGhB,MAAM,CAAsB;IAG5B,SAAS,CAAQ;IAGjB,SAAS,CAAQ;CAClB,CAAA;AAvBY,oCAAY;AAEvB;IADC,IAAA,6BAAsB,EAAC,MAAM,CAAC;;wCACnB;AAGZ;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;0CACpC;AAIrB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;6CACvB;AAIjB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;4CACxB;AAGhB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;;4CAC/B;AAG5B;IADC,IAAA,uBAAgB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;8BAC7B,IAAI;+CAAC;AAGjB;IADC,IAAA,uBAAgB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;8BAC7B,IAAI;+CAAC;uBAtBN,YAAY;IADxB,IAAA,aAAM,EAAC,eAAe,CAAC;GACX,YAAY,CAuBxB"}

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

@@ -0,0 +1,38 @@
+import type { Repository } from '@octo-cyber/core';
+import { AgentSession } from './agent-session.entity.js';
+export interface AgentSessionDto {
+    id: string;
+    name: string | null;
+    context: Record<string, unknown>;
+    runIds: string[];
+    status: 'active' | 'closed';
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * AgentSessionService — manages shared context sessions across multiple agent runs.
+ *
+ * A session acts as a shared memory store:
+ *   - Multiple agent runs can be attached to a single session
+ *   - Any run can read/write session context to share state
+ *   - Sessions can be closed to signal completion
+ */
+export declare class AgentSessionService {
+    private repo;
+    setRepository(repo: Repository<AgentSession>): void;
+    private getRepo;
+    create(name?: string): Promise<AgentSession>;
+    getById(id: string): Promise<AgentSession | null>;
+    /** List the 20 most recently updated sessions. */
+    list(): Promise<AgentSession[]>;
+    /**
+     * Merge patch into the session's existing context JSON.
+     * Shallow-merges: top-level keys from patch override existing keys.
+     */
+    updateContext(id: string, patch: Record<string, unknown>): Promise<AgentSession>;
+    /** Append a run ID to the session's runIds list. */
+    addRunId(id: string, runId: string): Promise<void>;
+    close(id: string): Promise<boolean>;
+    toDto(session: AgentSession): AgentSessionDto;
+}
+//# sourceMappingURL=agent-session.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.service.d.ts","sourceRoot":"","sources":["../../../src/agent/agent-session.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,qBACa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAAyC;IAErD,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,GAAG,IAAI;IAInD,OAAO,CAAC,OAAO;IAKT,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAW5C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAIvD,kDAAkD;IAC5C,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAOrC;;;OAGG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IActF,oDAAoD;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASzC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe;CAW9C"}

package/dist/src/agent/agent-session.service.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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentSessionService = void 0;
+const core_1 = require("@octo-cyber/core");
+/**
+ * AgentSessionService — manages shared context sessions across multiple agent runs.
+ *
+ * A session acts as a shared memory store:
+ *   - Multiple agent runs can be attached to a single session
+ *   - Any run can read/write session context to share state
+ *   - Sessions can be closed to signal completion
+ */
+let AgentSessionService = class AgentSessionService {
+    repo = null;
+    setRepository(repo) {
+        this.repo = repo;
+    }
+    getRepo() {
+        if (!this.repo)
+            throw new Error('AgentSessionService: repository not initialized');
+        return this.repo;
+    }
+    async create(name) {
+        const repo = this.getRepo();
+        const session = repo.create({
+            name: name ?? null,
+            context: '{}',
+            runIds: '[]',
+            status: 'active',
+        });
+        return repo.save(session);
+    }
+    async getById(id) {
+        return this.getRepo().findOne({ where: { id } });
+    }
+    /** List the 20 most recently updated sessions. */
+    async list() {
+        return this.getRepo().find({
+            order: { updatedAt: 'DESC' },
+            take: 20,
+        });
+    }
+    /**
+     * Merge patch into the session's existing context JSON.
+     * Shallow-merges: top-level keys from patch override existing keys.
+     */
+    async updateContext(id, patch) {
+        const repo = this.getRepo();
+        const session = await repo.findOne({ where: { id } });
+        if (!session)
+            throw core_1.AppError.notFound(`Agent session not found: ${id}`);
+        const existing = parseJson(session.context, {});
+        const merged = { ...existing, ...patch };
+        await repo.update(id, { context: JSON.stringify(merged) });
+        const updated = await repo.findOne({ where: { id } });
+        if (!updated)
+            throw core_1.AppError.notFound(`Agent session not found after update: ${id}`);
+        return updated;
+    }
+    /** Append a run ID to the session's runIds list. */
+    async addRunId(id, runId) {
+        const repo = this.getRepo();
+        const session = await repo.findOne({ where: { id } });
+        if (!session)
+            throw core_1.AppError.notFound(`Agent session not found: ${id}`);
+        const existing = parseJson(session.runIds, []);
+        if (!existing.includes(runId)) {
+            await repo.update(id, { runIds: JSON.stringify([...existing, runId]) });
+        }
+    }
+    async close(id) {
+        const repo = this.getRepo();
+        const session = await repo.findOne({ where: { id } });
+        if (!session)
+            return false;
+        await repo.update(id, { status: 'closed' });
+        return true;
+    }
+    toDto(session) {
+        return {
+            id: session.id,
+            name: session.name,
+            context: parseJson(session.context, {}),
+            runIds: parseJson(session.runIds, []),
+            status: session.status,
+            createdAt: session.createdAt.toISOString(),
+            updatedAt: session.updatedAt.toISOString(),
+        };
+    }
+};
+exports.AgentSessionService = AgentSessionService;
+exports.AgentSessionService = AgentSessionService = __decorate([
+    (0, core_1.Service)()
+], AgentSessionService);
+// Intentionally not exported — module-private helper
+function parseJson(value, fallback) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return fallback;
+    }
+}
+// Ensure singleton is registered in DI at import time
+core_1.Container.get(AgentSessionService);
+//# sourceMappingURL=agent-session.service.js.map

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

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

package/dist/src/agent/coding-tools.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from '../workflow-design/types.js';
+/**
+ * Creates the standard coding tool set for a Claude Code agent session.
+ * All tools operate strictly within the given worktree directory.
+ */
+export declare function createCodingTools(worktreePath: string): ToolDefinition[];
+//# sourceMappingURL=coding-tools.d.ts.map

package/dist/src/agent/coding-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-tools.d.ts","sourceRoot":"","sources":["../../../src/agent/coding-tools.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAmClE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,EAAE,CAExE"}

package/dist/src/agent/coding-tools.js

@@ -0,0 +1,181 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCodingTools = createCodingTools;
+const node_child_process_1 = require("node:child_process");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const execAsync = (0, node_util_1.promisify)(node_child_process_1.exec);
+const BASH_TIMEOUT_MS = 60_000;
+const STDOUT_MAX_BYTES = 8 * 1024; // 8 KB
+// ============================================================
+// Path safety
+// ============================================================
+/**
+ * Resolves a user-supplied path relative to worktreePath and ensures it does
+ * not escape the worktree directory (path traversal guard).
+ *
+ * @throws Error if the resolved path is outside the worktree.
+ */
+function resolveJailed(userPath, worktreePath) {
+    // Reject absolute paths that don't start with the worktree
+    const base = node_path_1.default.resolve(worktreePath);
+    const resolved = node_path_1.default.resolve(base, userPath);
+    if (!resolved.startsWith(base + node_path_1.default.sep) && resolved !== base) {
+        throw new Error(`Path "${userPath}" resolves to "${resolved}" which is outside the worktree "${base}"`);
+    }
+    return resolved;
+}
+// ============================================================
+// Tool factory
+// ============================================================
+/**
+ * Creates the standard coding tool set for a Claude Code agent session.
+ * All tools operate strictly within the given worktree directory.
+ */
+function createCodingTools(worktreePath) {
+    return [bashTool(worktreePath), fileEditTool(worktreePath), readFileTool(worktreePath), gitTool(worktreePath)];
+}
+// ── bash ──────────────────────────────────────────────────────
+function bashTool(worktreePath) {
+    return {
+        name: 'bash',
+        description: 'Execute a shell command inside the worktree directory. Use for build, test, and inspection commands. Output is truncated to 8 KB.',
+        parameters: {
+            type: 'object',
+            properties: {
+                command: { type: 'string', description: 'Shell command to run (e.g. "pnpm build")' },
+                cwd: {
+                    type: 'string',
+                    description: 'Optional subdirectory (relative to worktree root) in which to run the command.',
+                },
+            },
+            required: ['command'],
+        },
+        async execute(args) {
+            const { command, cwd: cwdArg } = args;
+            const effectiveCwd = cwdArg ? resolveJailed(cwdArg, worktreePath) : worktreePath;
+            let stdout;
+            let stderr;
+            try {
+                const result = await execAsync(command, {
+                    cwd: effectiveCwd,
+                    timeout: BASH_TIMEOUT_MS,
+                    maxBuffer: STDOUT_MAX_BYTES * 4,
+                    env: { ...process.env, FORCE_COLOR: '0' },
+                });
+                stdout = result.stdout;
+                stderr = result.stderr;
+            }
+            catch (err) {
+                const execErr = err;
+                stdout = execErr.stdout ?? '';
+                stderr = execErr.stderr ?? execErr.message ?? 'Unknown error';
+            }
+            const combined = [stdout, stderr].filter(Boolean).join('\n').trim();
+            const truncated = Buffer.byteLength(combined) > STDOUT_MAX_BYTES
+                ? combined.slice(0, STDOUT_MAX_BYTES) + '\n[output truncated]'
+                : combined;
+            return truncated || '(no output)';
+        },
+    };
+}
+// ── file_edit ─────────────────────────────────────────────────
+function fileEditTool(worktreePath) {
+    return {
+        name: 'file_edit',
+        description: 'Write or overwrite a file inside the worktree.',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'File path relative to the worktree root.' },
+                content: { type: 'string', description: 'New file content (complete, not a diff).' },
+            },
+            required: ['path', 'content'],
+        },
+        async execute(args) {
+            const { path: filePath, content } = args;
+            const resolved = resolveJailed(filePath, worktreePath);
+            // Create intermediate directories if needed
+            await promises_1.default.mkdir(node_path_1.default.dirname(resolved), { recursive: true });
+            await promises_1.default.writeFile(resolved, content, 'utf-8');
+            return `Written ${resolved}`;
+        },
+    };
+}
+// ── read_file ─────────────────────────────────────────────────
+function readFileTool(worktreePath) {
+    return {
+        name: 'read_file',
+        description: 'Read the contents of a file inside the worktree.',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'File path relative to the worktree root.' },
+            },
+            required: ['path'],
+        },
+        async execute(args) {
+            const { path: filePath } = args;
+            const resolved = resolveJailed(filePath, worktreePath);
+            let content;
+            try {
+                content = await promises_1.default.readFile(resolved, 'utf-8');
+            }
+            catch {
+                return `Error: file "${resolved}" not found or unreadable.`;
+            }
+            const truncated = Buffer.byteLength(content) > STDOUT_MAX_BYTES
+                ? content.slice(0, STDOUT_MAX_BYTES) + '\n[file truncated]'
+                : content;
+            return truncated;
+        },
+    };
+}
+// ── git ───────────────────────────────────────────────────────
+function gitTool(worktreePath) {
+    return {
+        name: 'git',
+        description: 'Run a git command inside the worktree. Pass args as an array (e.g. ["add", "-A"] or ["commit", "-m", "feat: add login"]).',
+        parameters: {
+            type: 'object',
+            properties: {
+                args: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Git subcommand and arguments (without the "git" prefix).',
+                },
+            },
+            required: ['args'],
+        },
+        async execute(args) {
+            const { args: gitArgs } = args;
+            if (!Array.isArray(gitArgs) || gitArgs.length === 0) {
+                return 'Error: args must be a non-empty array of strings.';
+            }
+            const command = `git ${gitArgs.map((a) => JSON.stringify(a)).join(' ')}`;
+            let stdout;
+            let stderr;
+            try {
+                const result = await execAsync(command, {
+                    cwd: worktreePath,
+                    timeout: BASH_TIMEOUT_MS,
+                    maxBuffer: STDOUT_MAX_BYTES * 4,
+                });
+                stdout = result.stdout;
+                stderr = result.stderr;
+            }
+            catch (err) {
+                const execErr = err;
+                stdout = execErr.stdout ?? '';
+                stderr = execErr.stderr ?? execErr.message ?? 'git command failed';
+            }
+            const combined = [stdout, stderr].filter(Boolean).join('\n').trim();
+            return combined || '(no output)';
+        },
+    };
+}
+//# sourceMappingURL=coding-tools.js.map

package/dist/src/agent/coding-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-tools.js","sourceRoot":"","sources":["../../../src/agent/coding-tools.ts"],"names":[],"mappings":";;;;;AA2CA,8CAEC;AA7CD,2DAA0C;AAC1C,gEAAkC;AAClC,0DAA6B;AAC7B,yCAAsC;AAGtC,MAAM,SAAS,GAAG,IAAA,qBAAS,EAAC,yBAAI,CAAC,CAAC;AAElC,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO;AAE1C,+DAA+D;AAC/D,cAAc;AACd,+DAA+D;AAE/D;;;;;GAKG;AACH,SAAS,aAAa,CAAC,QAAgB,EAAE,YAAoB;IAC3D,2DAA2D;IAC3D,MAAM,IAAI,GAAG,mBAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,mBAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE9C,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,mBAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,kBAAkB,QAAQ,oCAAoC,IAAI,GAAG,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,+DAA+D;AAC/D,eAAe;AACf,+DAA+D;AAE/D;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,YAAoB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;AACjH,CAAC;AAED,iEAAiE;AAEjE,SAAS,QAAQ,CAAC,YAAoB;IACpC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,mIAAmI;QACrI,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;gBACpF,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,gFAAgF;iBACnF;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAyC,CAAC;YAE3E,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;YAEjF,IAAI,MAAc,CAAC;YACnB,IAAI,MAAc,CAAC;YAEnB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;oBACtC,GAAG,EAAE,YAAY;oBACjB,OAAO,EAAE,eAAe;oBACxB,SAAS,EAAE,gBAAgB,GAAG,CAAC;oBAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE;iBAC1C,CAAC,CAAC;gBACH,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;gBACvB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YACzB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAA6D,CAAC;gBAC9E,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;gBAC9B,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC;YAChE,CAAC;YAED,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACpE,MAAM,SAAS,GACb,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,gBAAgB;gBAC5C,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,sBAAsB;gBAC9D,CAAC,CAAC,QAAQ,CAAC;YAEf,OAAO,SAAS,IAAI,aAAa,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iEAAiE;AAEjE,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,gDAAgD;QAC7D,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;gBACjF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;aACrF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC9B;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAyC,CAAC;YAE9E,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAEvD,4CAA4C;YAC5C,MAAM,kBAAE,CAAC,KAAK,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAE/C,OAAO,WAAW,QAAQ,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iEAAiE;AAEjE,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,kDAAkD;QAC/D,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;aAClF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAwB,CAAC;YAEpD,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAEvD,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,gBAAgB,QAAQ,4BAA4B,CAAC;YAC9D,CAAC;YAED,MAAM,SAAS,GACb,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,gBAAgB;gBAC3C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,oBAAoB;gBAC3D,CAAC,CAAC,OAAO,CAAC;YAEd,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iEAAiE;AAEjE,SAAS,OAAO,CAAC,YAAoB;IACnC,OAAO;QACL,IAAI,EAAE,KAAK;QACX,WAAW,EACT,2HAA2H;QAC7H,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,0DAA0D;iBACxE;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAA0B,CAAC;YAErD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpD,OAAO,mDAAmD,CAAC;YAC7D,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAEzE,IAAI,MAAc,CAAC;YACnB,IAAI,MAAc,CAAC;YAEnB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;oBACtC,GAAG,EAAE,YAAY;oBACjB,OAAO,EAAE,eAAe;oBACxB,SAAS,EAAE,gBAAgB,GAAG,CAAC;iBAChC,CAAC,CAAC;gBACH,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;gBACvB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YACzB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAA6D,CAAC;gBAC9E,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;gBAC9B,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,oBAAoB,CAAC;YACrE,CAAC;YAED,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACpE,OAAO,QAAQ,IAAI,aAAa,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/agent/computer-use-tools.d.ts

@@ -0,0 +1,15 @@
+import type { ToolDefinition } from '../workflow-design/types.js';
+export declare const IMAGE_RESULT_PREFIX = "[IMAGE:png]";
+export declare const SYSTEM_PROMPT_COMPUTER_USE = "You are an AI agent that can control the desktop computer.\nYou have access to these tools:\n- screenshot: take a screenshot to see the current state of the screen\n- left_click: click at a specific (x, y) coordinate\n- type: type text into the focused element\n- scroll: scroll up or down at a screen position\n- key: press a key or key combination (e.g. \"enter\", \"ctrl+c\")\n\nTo complete a task:\n1. Start by taking a screenshot to understand the current state of the screen.\n2. Identify what needs to be done based on the screenshot.\n3. Use the appropriate tools to interact with the UI.\n4. Take follow-up screenshots to verify your actions had the intended effect.\n5. Repeat until the task is complete, then summarize what you did.\n\nImportant:\n- Always verify actions with a screenshot after significant interactions.\n- Use the \"key\" tool for keyboard shortcuts (e.g. \"enter\" to confirm, \"escape\" to cancel).\n- Coordinate (0, 0) is the top-left corner of the screen.\n- Be precise with coordinates \u2014 click the center of buttons and input fields.";
+/**
+ * Creates the computer-use tool set for agent loops.
+ *
+ * Screenshot results use the `[IMAGE:png]<base64>` sentinel so
+ * OctoAgentClient can pass them as Anthropic ImageBlockParam,
+ * enabling Claude to see and reason about the screen content.
+ *
+ * macOS: grant Accessibility + Screen Recording to Terminal/Node.
+ * Windows/Linux: no extra permissions required.
+ */
+export declare function createComputerUseTools(): ToolDefinition[];
+//# sourceMappingURL=computer-use-tools.d.ts.map

package/dist/src/agent/computer-use-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer-use-tools.d.ts","sourceRoot":"","sources":["../../../src/agent/computer-use-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAOlE,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAEjD,eAAO,MAAM,0BAA0B,sjCAmBuC,CAAC;AAM/E;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,EAAE,CAQzD"}