@octo-cyber/ai 0.5.5 → 0.5.7

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

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

package/dist/src/agent/computer-use-tools.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYSTEM_PROMPT_COMPUTER_USE = exports.IMAGE_RESULT_PREFIX = void 0;
+exports.createComputerUseTools = createComputerUseTools;
+// ============================================================
+// Sentinel prefix used to signal an image tool result.
+// OctoAgentClient.run() detects this and wraps it in an
+// Anthropic ImageBlockParam so Claude can see the screenshot.
+// ============================================================
+exports.IMAGE_RESULT_PREFIX = '[IMAGE:png]';
+exports.SYSTEM_PROMPT_COMPUTER_USE = `You are an AI agent that can control the desktop computer.
+You have access to these tools:
+- screenshot: take a screenshot to see the current state of the screen
+- left_click: click at a specific (x, y) coordinate
+- type: type text into the focused element
+- scroll: scroll up or down at a screen position
+- key: press a key or key combination (e.g. "enter", "ctrl+c")
+
+To complete a task:
+1. Start by taking a screenshot to understand the current state of the screen.
+2. Identify what needs to be done based on the screenshot.
+3. Use the appropriate tools to interact with the UI.
+4. Take follow-up screenshots to verify your actions had the intended effect.
+5. Repeat until the task is complete, then summarize what you did.
+
+Important:
+- Always verify actions with a screenshot after significant interactions.
+- Use the "key" tool for keyboard shortcuts (e.g. "enter" to confirm, "escape" to cancel).
+- Coordinate (0, 0) is the top-left corner of the screen.
+- Be precise with coordinates — click the center of buttons and input fields.`;
+// ============================================================
+// Tool factory
+// ============================================================
+/**
+ * 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.
+ */
+function createComputerUseTools() {
+    return [
+        screenshotTool(),
+        leftClickTool(),
+        typeTool(),
+        scrollTool(),
+        keyTool(),
+    ];
+}
+// ── screenshot ────────────────────────────────────────────────
+function screenshotTool() {
+    return {
+        name: 'screenshot',
+        description: 'Take a screenshot of the current screen and return it as an image. ' +
+            'Use this to observe the current state of the desktop or any application.',
+        parameters: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+        async execute(_args) {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const { Monitor } = require('node-screenshots');
+                const monitors = Monitor.all();
+                if (monitors.length === 0)
+                    return 'Error: no monitors found';
+                const monitor = monitors[0];
+                const image = await monitor.captureImage();
+                const pngBuffer = await image.toPng();
+                const base64 = pngBuffer.toString('base64');
+                return `${exports.IMAGE_RESULT_PREFIX}${base64}`;
+            }
+            catch (err) {
+                return `Error taking screenshot: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    };
+}
+// ── left_click ────────────────────────────────────────────────
+function leftClickTool() {
+    return {
+        name: 'left_click',
+        description: 'Move the mouse cursor to screen coordinates (x, y) and perform a left click.',
+        parameters: {
+            type: 'object',
+            properties: {
+                x: { type: 'number', description: 'Horizontal pixel coordinate (from left edge of screen).' },
+                y: { type: 'number', description: 'Vertical pixel coordinate (from top edge of screen).' },
+            },
+            required: ['x', 'y'],
+        },
+        async execute(args) {
+            const { x, y } = args;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-explicit-any
+                const { mouse } = require('@nut-tree/nut-js');
+                await mouse.setPosition({ x, y });
+                await mouse.leftClick();
+                return `Clicked at (${x}, ${y})`;
+            }
+            catch (err) {
+                return `Error clicking at (${x}, ${y}): ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    };
+}
+// ── type ──────────────────────────────────────────────────────
+function typeTool() {
+    return {
+        name: 'type',
+        description: 'Type text into the currently focused input field or application. ' +
+            'Simulates keyboard keystrokes character by character.',
+        parameters: {
+            type: 'object',
+            properties: {
+                text: { type: 'string', description: 'Text to type. Supports printable ASCII characters.' },
+            },
+            required: ['text'],
+        },
+        async execute(args) {
+            const { text } = args;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-explicit-any
+                const { keyboard } = require('@nut-tree/nut-js');
+                await keyboard.type(text);
+                return `Typed: ${text.slice(0, 50)}${text.length > 50 ? '...' : ''}`;
+            }
+            catch (err) {
+                return `Error typing text: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    };
+}
+// ── scroll ────────────────────────────────────────────────────
+function scrollTool() {
+    return {
+        name: 'scroll',
+        description: 'Scroll the mouse wheel at the given screen position. ' +
+            'Positive dy scrolls up; negative dy scrolls down.',
+        parameters: {
+            type: 'object',
+            properties: {
+                x: { type: 'number', description: 'Horizontal coordinate to scroll at.' },
+                y: { type: 'number', description: 'Vertical coordinate to scroll at.' },
+                dy: { type: 'number', description: 'Scroll amount: positive = up, negative = down (e.g. 3 or -3).' },
+            },
+            required: ['x', 'y', 'dy'],
+        },
+        async execute(args) {
+            const { x, y, dy } = args;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-explicit-any
+                const { mouse } = require('@nut-tree/nut-js');
+                await mouse.setPosition({ x, y });
+                const amount = Math.abs(Math.round(dy));
+                if (dy > 0) {
+                    await mouse.scrollUp(amount);
+                }
+                else {
+                    await mouse.scrollDown(amount);
+                }
+                return `Scrolled ${dy > 0 ? 'up' : 'down'} ${amount} at (${x}, ${y})`;
+            }
+            catch (err) {
+                return `Error scrolling: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    };
+}
+// ── key ───────────────────────────────────────────────────────
+function keyTool() {
+    return {
+        name: 'key',
+        description: 'Press a keyboard key or key combination. ' +
+            'Examples: "enter", "escape", "ctrl+c", "cmd+tab", "ctrl+shift+t".',
+        parameters: {
+            type: 'object',
+            properties: {
+                keys: {
+                    type: 'string',
+                    description: 'Key or key combination to press. ' +
+                        'Single key: "enter", "escape", "tab", "space", "backspace". ' +
+                        'Combination: "ctrl+c", "cmd+v", "alt+f4", "ctrl+shift+t".',
+                },
+            },
+            required: ['keys'],
+        },
+        async execute(args) {
+            const { keys } = args;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-explicit-any
+                const { keyboard, Key } = require('@nut-tree/nut-js');
+                const resolved = parseKeys(keys, Key);
+                if (resolved.length === 0)
+                    return `Unknown key: ${keys}`;
+                await keyboard.pressKey(...resolved);
+                await keyboard.releaseKey(...resolved);
+                return `Pressed: ${keys}`;
+            }
+            catch (err) {
+                return `Error pressing key "${keys}": ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    };
+}
+function parseKeys(input, Key) {
+    const parts = input.toLowerCase().split('+').map((s) => s.trim());
+    return parts.map((p) => resolveKey(p, Key)).filter((k) => k !== undefined);
+}
+function resolveKey(name, Key) {
+    const map = {
+        enter: Key.Enter,
+        return: Key.Return,
+        escape: Key.Escape,
+        esc: Key.Escape,
+        tab: Key.Tab,
+        space: Key.Space,
+        backspace: Key.Backspace,
+        delete: Key.Delete,
+        del: Key.Delete,
+        home: Key.Home,
+        end: Key.End,
+        pageup: Key.PageUp,
+        pagedown: Key.PageDown,
+        up: Key.Up,
+        down: Key.Down,
+        left: Key.Left,
+        right: Key.Right,
+        ctrl: Key.LeftControl,
+        control: Key.LeftControl,
+        shift: Key.LeftShift,
+        alt: Key.LeftAlt,
+        option: Key.LeftAlt,
+        cmd: Key.LeftCmd,
+        command: Key.LeftCmd,
+        win: Key.LeftWin,
+        super: Key.LeftWin,
+        a: Key.A, b: Key.B, c: Key.C, d: Key.D, e: Key.E, f: Key.F,
+        g: Key.G, h: Key.H, i: Key.I, j: Key.J, k: Key.K, l: Key.L,
+        m: Key.M, n: Key.N, o: Key.O, p: Key.P, q: Key.Q, r: Key.R,
+        s: Key.S, t: Key.T, u: Key.U, v: Key.V, w: Key.W, x: Key.X,
+        y: Key.Y, z: Key.Z,
+        '0': Key.Num0, '1': Key.Num1, '2': Key.Num2, '3': Key.Num3,
+        '4': Key.Num4, '5': Key.Num5, '6': Key.Num6, '7': Key.Num7,
+        '8': Key.Num8, '9': Key.Num9,
+        f1: Key.F1, f2: Key.F2, f3: Key.F3, f4: Key.F4, f5: Key.F5,
+        f6: Key.F6, f7: Key.F7, f8: Key.F8, f9: Key.F9, f10: Key.F10,
+        f11: Key.F11, f12: Key.F12,
+    };
+    return map[name];
+}
+//# sourceMappingURL=computer-use-tools.js.map

package/dist/src/agent/computer-use-tools.js.map

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

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

@@ -0,0 +1,41 @@
+import type { Request, Response } from '@octo-cyber/core';
+/**
+ * ExternalAgentController — HTTP API for external agent self-management.
+ *
+ * Endpoints:
+ *   POST /api/v1/agents/external/register    — Register or update an external agent
+ *   POST /api/v1/agents/external/heartbeat   — Send a heartbeat to stay online
+ *   POST /api/v1/agents/external/unregister  — Mark the agent as offline
+ *   GET  /api/v1/agents/external             — List all external agents
+ */
+export declare class ExternalAgentController {
+    private get service();
+    /**
+     * Register or update an external agent (upsert by agentId).
+     *
+     * Body:
+     *   agentId      {string}    — Caller-chosen unique identifier
+     *   name         {string}    — Human-readable agent name
+     *   description  {string?}   — Optional description
+     *   endpoint     {string}    — HTTP URL that accepts POST task payloads
+     *   capabilities {string[]?} — Optional list of capability tags
+     */
+    registerAgent(req: Request, res: Response): Promise<void>;
+    /**
+     * Send a heartbeat for the given agentId.
+     *
+     * Body:
+     *   agentId {string}
+     */
+    heartbeat(req: Request, res: Response): Promise<void>;
+    /**
+     * Unregister (mark offline) the given external agent.
+     *
+     * Body:
+     *   agentId {string}
+     */
+    unregisterAgent(req: Request, res: Response): Promise<void>;
+    /** List all external agents (newest first). */
+    listAgents(_req: Request, res: Response): Promise<void>;
+}
+//# sourceMappingURL=external-agent.controller.d.ts.map