@backendkit-labs/agent-coding 0.14.0 → 0.16.0

package/dist/transport/TerminalTransport.js

@@ -0,0 +1,176 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalTransport = void 0;
+const readline = __importStar(require("readline"));
+const marked_1 = require("marked");
+const marked_terminal_1 = require("marked-terminal");
+// marked v15 changed MarkedExtension types — cast is safe, runtime is compatible
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+marked_1.marked.use((0, marked_terminal_1.markedTerminal)());
+// ANSI helpers
+const RESET = '\x1b[0m';
+const DIM = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const CYAN = '\x1b[36m';
+const YELLOW = '\x1b[33m';
+const GREEN = '\x1b[32m';
+const RED = '\x1b[31m';
+const GRAY = '\x1b[90m';
+function hr(char = '─', width = 72) {
+    return GRAY + char.repeat(width) + RESET;
+}
+function agentHeader(icon, name) {
+    const label = `${BOLD}${icon}  ${name}${RESET}`;
+    return `\n${hr('─')} ${label}\n`;
+}
+function toolLine(name, preview) {
+    const truncated = preview.length > 60 ? preview.slice(0, 57) + '…' : preview;
+    return `${GRAY}● ${CYAN}${name}${GRAY}(${RESET}${truncated}${GRAY})${RESET}`;
+}
+/**
+ * Terminal transport that renders agent responses as formatted Markdown.
+ *
+ * Instead of streaming raw tokens mid-tool-call (which produces fragmented text),
+ * this transport:
+ *   1. Accumulates tokens per agent block silently
+ *   2. Shows tool calls as compact single-line indicators
+ *   3. Renders the final buffered text as Markdown on block_end
+ *
+ * Pass to createCodingEngine({ transport: new TerminalTransport() }).
+ */
+class TerminalTransport {
+    rl = null;
+    // token buffers per active agent block
+    buffers = new Map();
+    // track whether any tool calls fired in a block (for blank-line spacing)
+    hadTools = new Map();
+    emit(event) {
+        switch (event.type) {
+            case 'block_start': {
+                const id = event.agent_id ?? 'unknown';
+                const icon = event.agent_icon ?? '◆';
+                const name = event.agent_name ?? id;
+                this.buffers.set(id, '');
+                this.hadTools.set(id, false);
+                process.stdout.write(agentHeader(icon, name));
+                break;
+            }
+            case 'token': {
+                // Accumulate silently — no streaming to terminal
+                const id = event.agent_id ?? 'unknown';
+                this.buffers.set(id, (this.buffers.get(id) ?? '') + event.content);
+                break;
+            }
+            case 'tool_call': {
+                // Single-line compact indicator
+                const args = event.args_preview ?? '';
+                process.stdout.write(toolLine(event.name, args) + '\n');
+                // Mark the currently active block as having had tool calls
+                for (const [id] of this.buffers) {
+                    this.hadTools.set(id, true);
+                }
+                break;
+            }
+            case 'block_end': {
+                const id = event.agent_id ?? 'unknown';
+                const buf = (this.buffers.get(id) ?? '').trim();
+                this.buffers.delete(id);
+                this.hadTools.delete(id);
+                if (buf) {
+                    if (this.hadTools.get(id))
+                        process.stdout.write('\n');
+                    const rendered = marked_1.marked.parse(buf);
+                    process.stdout.write(rendered);
+                }
+                process.stdout.write(hr('─') + '\n');
+                break;
+            }
+            case 'system': {
+                const prefix = event.level === 'error' ? `${RED}[error]${RESET}`
+                    : event.level === 'warn' ? `${YELLOW}[warn]${RESET}`
+                        : `${GRAY}[info]${RESET}`;
+                process.stderr.write(`${prefix} ${event.text}\n`);
+                break;
+            }
+            case 'error': {
+                process.stderr.write(`${RED}Error: ${event.message}${RESET}\n`);
+                break;
+            }
+            case 'metrics': {
+                const cost = event.cost_usd != null
+                    ? ` · $${event.cost_usd.toFixed(4)}`
+                    : '';
+                process.stderr.write(`${GRAY}↑ ${event.input_tokens} ↓ ${event.output_tokens}${cost}${RESET}\n`);
+                break;
+            }
+            case 'compacting': {
+                if (event.phase === 'start') {
+                    process.stderr.write(`${DIM}[compacting] ${event.label}…${RESET}\n`);
+                }
+                break;
+            }
+            case 'tool_result':
+            case 'agent_switch':
+            case 'thinking':
+            case 'ready':
+            case 'done':
+                // intentionally silent
+                break;
+            default:
+                break;
+        }
+    }
+    onInput(handler) {
+        if (!this.rl) {
+            this.rl = readline.createInterface({ input: process.stdin });
+        }
+        const listener = (line) => {
+            const trimmed = line.trim();
+            if (trimmed)
+                handler(trimmed);
+        };
+        this.rl.on('line', listener);
+        return () => { this.rl?.off('line', listener); };
+    }
+    close() {
+        this.rl?.close();
+        this.rl = null;
+        this.buffers.clear();
+        this.hadTools.clear();
+    }
+}
+exports.TerminalTransport = TerminalTransport;
+//# sourceMappingURL=TerminalTransport.js.map

package/dist/transport/TerminalTransport.js.map

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

package/package.json

@@ -1,34 +1,44 @@
-{
-  "name": "@backendkit-labs/agent-coding",
-  "version": "0.14.0",
-  "description": "Coding agent profiles and tools for @backendkit-labs/agent-core",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": ["dist/", "README.md"],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/BackendKit-labs/backendkit-agent-framework.git",
-    "directory": "packages/coding"
-  },
-  "publishConfig": { "access": "public" },
-  "engines": { "node": ">=20.0.0" },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "jest",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.98.0",
-    "@backendkit-labs/agent-core": "*",
-    "openai": "^4.0.0"
-  },
-  "devDependencies": {
-    "@types/jest": "^29.0.0",
-    "@types/node": "^20.0.0",
-    "jest": "^29.0.0",
-    "ts-jest": "^29.0.0",
-    "typescript": "^5.4.0"
-  }
-}
+{
+  "name": "@backendkit-labs/agent-coding",
+  "version": "0.16.0",
+  "description": "Coding agent profiles and tools for @backendkit-labs/agent-core",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BackendKit-labs/backendkit-agent-framework.git",
+    "directory": "packages/coding"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.98.0",
+    "@backendkit-labs/agent-core": "*",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "openai": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.0.0",
+    "@types/marked-terminal": "^6.1.1",
+    "@types/node": "^20.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.4.0"
+  }
+}