@agentick/devtools 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Agentick Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,207 @@
+# @agentick/devtools
+
+Real-time debugging and observability for Agentick applications. Provides a server that captures execution events and a browser UI for inspection.
+
+## Installation
+
+```bash
+pnpm add @agentick/devtools
+```
+
+## Quick Start
+
+```typescript
+import { startDevToolsServer } from "@agentick/devtools";
+import { createApp } from "@agentick/core";
+
+// Start DevTools server
+const devtools = startDevToolsServer({ port: 3001 });
+
+// Enable DevTools in your app
+const app = createApp(MyApp, {
+  model: myModel,
+  devTools: true,  // Enables event emission
+});
+
+// Navigate to http://localhost:3001 to view DevTools UI
+```
+
+## API
+
+### startDevToolsServer(config?)
+
+Convenience function to create and start a DevTools server:
+
+```typescript
+const devtools = startDevToolsServer({
+  port: 3001,           // Default: 3001
+  host: "127.0.0.1",    // Default: 127.0.0.1
+  debug: false,         // Enable debug logging
+  heartbeatInterval: 30000,  // SSE heartbeat interval (ms)
+});
+
+// Get server URL
+console.log(devtools.getUrl()); // "http://127.0.0.1:3001"
+
+// Stop when done
+devtools.stop();
+```
+
+### DevToolsServer Class
+
+For more control, use the class directly:
+
+```typescript
+import { DevToolsServer } from "@agentick/devtools";
+
+const server = new DevToolsServer({ port: 3001 });
+await server.start();
+
+// Later...
+await server.stop();
+```
+
+## HTTP Endpoints
+
+| Endpoint       | Method | Description                    |
+| -------------- | ------ | ------------------------------ |
+| `/`            | GET    | DevTools UI                    |
+| `/events`      | GET    | SSE stream of execution events |
+| `/api/history` | GET    | All buffered events as JSON    |
+| `/api/clear`   | GET    | Clear event history            |
+
+## Event Types
+
+The DevTools server captures these events from `@agentick/core`:
+
+| Event               | Description                    |
+| ------------------- | ------------------------------ |
+| `execution_start`   | Execution began                |
+| `execution_end`     | Execution completed            |
+| `tick_start`        | Model API call started         |
+| `tick_end`          | Model API call completed       |
+| `compiled`          | JSX compiled to messages/tools |
+| `model_request`     | Request sent to provider       |
+| `provider_response` | Raw provider response          |
+| `model_response`    | Normalized response            |
+| `tool_call`         | Tool invocation                |
+| `tool_result`       | Tool execution result          |
+| `fiber_snapshot`    | Component tree state           |
+| `content_delta`     | Streaming text chunk           |
+
+## UI Features
+
+### Execution List
+
+View all executions with status, duration, and token usage.
+
+### Tick Navigator
+
+Scrub through individual ticks within an execution to see:
+
+- Compiled context (system, messages, tools)
+- Provider input/output
+- Model response
+- Tool calls
+
+### Fiber Tree
+
+Inspect the component hierarchy with:
+
+- Props for each component
+- Hook states
+- Token estimates
+
+### Context Info
+
+Monitor context utilization:
+
+- Input/output tokens per tick
+- Context window usage percentage
+- Cumulative usage across ticks
+
+## Integration
+
+### With Express
+
+```typescript
+import express from "express";
+import { createExpressAdapter } from "@agentick/express";
+import { startDevToolsServer } from "@agentick/devtools";
+
+const app = express();
+
+// Start DevTools on separate port
+startDevToolsServer({ port: 3001 });
+
+// Your Agentick app with DevTools enabled
+const agentick = createExpressAdapter(MyApp, {
+  model: myModel,
+  devTools: true,
+});
+
+app.use("/api", agentick);
+app.listen(3000);
+```
+
+### With Gateway
+
+```typescript
+import { createGateway } from "@agentick/gateway";
+import { startDevToolsServer } from "@agentick/devtools";
+
+startDevToolsServer({ port: 3001 });
+
+const gateway = createGateway({
+  agents: { assistant: myApp },
+  devTools: true,
+});
+```
+
+## Architecture
+
+```
+┌─────────────────────────┐
+│  Agentick App/Session  │
+│   (devTools: true)      │
+└────────────┬────────────┘
+             │ devToolsEmitter.emit()
+             ↓
+┌─────────────────────────┐
+│   DevToolsServer        │
+│   - Buffers events      │
+│   - Broadcasts via SSE  │
+│   - Serves UI           │
+└────────────┬────────────┘
+             │ HTTP /events (SSE)
+             ↓
+┌─────────────────────────┐
+│   Browser UI (React)    │
+│   - Real-time updates   │
+│   - Execution inspection│
+│   - Fiber tree viewer   │
+└─────────────────────────┘
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+TENTICKLE_DEVTOOLS_PORT=3001
+TENTICKLE_DEVTOOLS_HOST=127.0.0.1
+```
+
+### Programmatic
+
+```typescript
+const devtools = startDevToolsServer({
+  port: process.env.DEVTOOLS_PORT || 3001,
+  host: process.env.DEVTOOLS_HOST || "127.0.0.1",
+  debug: process.env.NODE_ENV === "development",
+});
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * DevTools Package
+ *
+ * Provides real-time observability for Agentick applications:
+ * - SSE server for streaming events to UI
+ * - HTTP API for querying execution history
+ * - Subscribes to devToolsEmitter for fiber snapshots and execution events
+ */
+export { DevToolsServer, type DevToolsServerConfig } from "./server/devtools-server";
+export { startDevToolsServer } from "./server/start";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * DevTools Package
+ *
+ * Provides real-time observability for Agentick applications:
+ * - SSE server for streaming events to UI
+ * - HTTP API for querying execution history
+ * - Subscribes to devToolsEmitter for fiber snapshots and execution events
+ */
+export { DevToolsServer } from "./server/devtools-server";
+export { startDevToolsServer } from "./server/start";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/server/devtools-server.d.ts

@@ -0,0 +1,42 @@
+export interface DevToolsServerConfig {
+    /** Port to listen on (default: 3001) */
+    port?: number;
+    /** Host to bind to (default: '127.0.0.1') */
+    host?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Heartbeat interval in ms (default: 30000) */
+    heartbeatInterval?: number;
+}
+export declare class DevToolsServer {
+    private server;
+    private clients;
+    private config;
+    private eventHistory;
+    private maxHistorySize;
+    private unsubscribe;
+    constructor(config?: DevToolsServerConfig);
+    private log;
+    /**
+     * Start the devtools server
+     */
+    start(): void;
+    /**
+     * Stop the server
+     */
+    stop(): void;
+    /**
+     * Emit event to all connected clients
+     */
+    private emit;
+    /**
+     * Get the server URL
+     */
+    getUrl(): string;
+    private handleRequest;
+    private handleSSE;
+    private handleHistory;
+    private handleClear;
+    private handleStatic;
+}
+//# sourceMappingURL=devtools-server.d.ts.map

package/dist/server/devtools-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-server.d.ts","sourceRoot":"","sources":["../../src/server/devtools-server.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAcD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,WAAW,CAA6B;gBAEpC,MAAM,GAAE,oBAAyB;IAS7C,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,KAAK,IAAI,IAAI;IA2Bb;;OAEG;IACH,IAAI,IAAI,IAAI;IA8BZ;;OAEG;IACH,OAAO,CAAC,IAAI;IAoBZ;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,SAAS;IA+BjB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;CAsCrB"}

package/dist/server/devtools-server.js

@@ -0,0 +1,214 @@
+/**
+ * DevTools Server
+ *
+ * HTTP server that:
+ * 1. Subscribes to devToolsEmitter for events
+ * 2. Broadcasts events to connected clients via SSE
+ * 3. Provides HTTP API for querying history
+ * 4. Serves the DevTools UI
+ */
+import { createServer } from "node:http";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync, readFileSync } from "node:fs";
+import { devToolsEmitter } from "@agentick/shared";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export class DevToolsServer {
+    server = null;
+    clients = new Set();
+    config;
+    eventHistory = [];
+    maxHistorySize = 1000;
+    unsubscribe = null;
+    constructor(config = {}) {
+        this.config = {
+            port: config.port ?? 3001,
+            host: config.host ?? "127.0.0.1",
+            debug: config.debug ?? false,
+            heartbeatInterval: config.heartbeatInterval ?? 30000,
+        };
+    }
+    log(...args) {
+        if (this.config.debug) {
+            console.log("[DevTools]", ...args);
+        }
+    }
+    /**
+     * Start the devtools server
+     */
+    start() {
+        if (this.server) {
+            this.log("Server already running");
+            return;
+        }
+        // Subscribe to devToolsEmitter
+        this.unsubscribe = devToolsEmitter.subscribe((event) => {
+            this.emit(event);
+        });
+        this.server = createServer((req, res) => this.handleRequest(req, res));
+        this.server.on("error", (error) => {
+            const code = error.code;
+            if (code === "EADDRINUSE") {
+                console.warn(`[DevTools] Port ${this.config.port} is already in use; DevTools disabled.`);
+            }
+            else {
+                console.error("[DevTools] Server error:", error);
+            }
+            this.stop();
+        });
+        this.server.listen(this.config.port, this.config.host, () => {
+            console.log(`[DevTools] Server listening on http://${this.config.host}:${this.config.port}`);
+        });
+    }
+    /**
+     * Stop the server
+     */
+    stop() {
+        // Unsubscribe from events
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = null;
+        }
+        // Close SSE connections
+        for (const client of this.clients) {
+            clearInterval(client.heartbeatInterval);
+            client.res.end();
+        }
+        this.clients.clear();
+        // Close server
+        if (this.server) {
+            const server = this.server;
+            this.server = null;
+            try {
+                server.close();
+            }
+            catch (error) {
+                const code = error.code;
+                if (code !== "ERR_SERVER_NOT_RUNNING") {
+                    this.log("Failed to close server", error);
+                }
+            }
+        }
+        this.log("Server stopped");
+    }
+    /**
+     * Emit event to all connected clients
+     */
+    emit(event) {
+        // Store in history
+        this.eventHistory.push(event);
+        if (this.eventHistory.length > this.maxHistorySize) {
+            this.eventHistory.shift();
+        }
+        // Broadcast to SSE clients
+        const data = `data: ${JSON.stringify(event)}\n\n`;
+        for (const client of this.clients) {
+            try {
+                client.res.write(data);
+            }
+            catch {
+                // Client disconnected
+            }
+        }
+        this.log(`Emitted ${event.type} to ${this.clients.size} clients`);
+    }
+    /**
+     * Get the server URL
+     */
+    getUrl() {
+        return `http://${this.config.host}:${this.config.port}`;
+    }
+    handleRequest(req, res) {
+        const url = new URL(req.url || "/", `http://${this.config.host}:${this.config.port}`);
+        // CORS headers
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        // Route handling
+        if (url.pathname === "/events") {
+            this.handleSSE(req, res);
+        }
+        else if (url.pathname === "/api/history") {
+            this.handleHistory(res);
+        }
+        else if (url.pathname === "/api/clear") {
+            this.handleClear(res);
+        }
+        else {
+            this.handleStatic(url.pathname, res);
+        }
+    }
+    handleSSE(_req, res) {
+        res.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+        });
+        // Send connection event
+        res.write(`data: ${JSON.stringify({ type: "connected", timestamp: Date.now() })}\n\n`);
+        // Setup heartbeat
+        const heartbeatInterval = setInterval(() => {
+            try {
+                res.write(":heartbeat\n\n");
+            }
+            catch {
+                // Connection closed
+            }
+        }, this.config.heartbeatInterval);
+        const client = { res, heartbeatInterval };
+        this.clients.add(client);
+        this.log(`Client connected, total: ${this.clients.size}`);
+        res.on("close", () => {
+            clearInterval(heartbeatInterval);
+            this.clients.delete(client);
+            this.log(`Client disconnected, total: ${this.clients.size}`);
+        });
+    }
+    handleHistory(res) {
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify(this.eventHistory));
+    }
+    handleClear(res) {
+        this.eventHistory = [];
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ cleared: true }));
+    }
+    handleStatic(pathname, res) {
+        // Serve UI from ui/dist
+        const uiDir = join(__dirname, "../../ui/dist");
+        let filePath = pathname === "/" ? "/index.html" : pathname;
+        filePath = join(uiDir, filePath);
+        // Security: prevent directory traversal
+        if (!filePath.startsWith(uiDir)) {
+            res.writeHead(403);
+            res.end("Forbidden");
+            return;
+        }
+        if (!existsSync(filePath)) {
+            // SPA fallback
+            filePath = join(uiDir, "index.html");
+        }
+        if (!existsSync(filePath)) {
+            res.writeHead(404);
+            res.end("Not found - run pnpm build:ui first");
+            return;
+        }
+        const ext = filePath.split(".").pop() || "";
+        const contentTypes = {
+            html: "text/html",
+            js: "application/javascript",
+            css: "text/css",
+            json: "application/json",
+            png: "image/png",
+            svg: "image/svg+xml",
+        };
+        res.writeHead(200, { "Content-Type": contentTypes[ext] || "text/plain" });
+        res.end(readFileSync(filePath));
+    }
+}
+//# sourceMappingURL=devtools-server.js.map

package/dist/server/devtools-server.js.map

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

package/dist/server/start.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Convenience function to start DevTools server
+ */
+import { DevToolsServer, type DevToolsServerConfig } from "./devtools-server";
+/**
+ * Start a DevTools server.
+ *
+ * @example
+ * ```typescript
+ * import { startDevToolsServer } from '@agentick/devtools';
+ *
+ * const server = startDevToolsServer({ port: 3001, debug: true });
+ * console.log(`DevTools: ${server.getUrl()}`);
+ *
+ * // Later...
+ * server.stop();
+ * ```
+ */
+export declare function startDevToolsServer(config?: DevToolsServerConfig): DevToolsServer;
+//# sourceMappingURL=start.d.ts.map

package/dist/server/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/server/start.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,cAAc,CAIjF"}

package/dist/server/start.js

@@ -0,0 +1,24 @@
+/**
+ * Convenience function to start DevTools server
+ */
+import { DevToolsServer } from "./devtools-server";
+/**
+ * Start a DevTools server.
+ *
+ * @example
+ * ```typescript
+ * import { startDevToolsServer } from '@agentick/devtools';
+ *
+ * const server = startDevToolsServer({ port: 3001, debug: true });
+ * console.log(`DevTools: ${server.getUrl()}`);
+ *
+ * // Later...
+ * server.stop();
+ * ```
+ */
+export function startDevToolsServer(config) {
+    const server = new DevToolsServer(config);
+    server.start();
+    return server;
+}
+//# sourceMappingURL=start.js.map

package/dist/server/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/server/start.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAA6B,MAAM,mBAAmB,CAAC;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA6B;IAC/D,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@agentick/devtools",
+  "version": "0.0.1",
+  "files": [
+    "dist",
+    "ui/dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@agentick/shared": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.10",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "concurrently": "^9.1.2",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vite": "^6.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && pnpm build:ui",
+    "build:ui": "cd ui && vite build",
+    "dev": "tsx src/cli.ts",
+    "dev:ui": "cd ui && vite",
+    "typecheck": "tsc --noEmit"
+  }
+}