@agentic-patterns/server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pattern Stack
+
+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/dist/index.cjs

@@ -0,0 +1,242 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  agentEventToSSE: () => agentEventToSSE,
+  createServer: () => createServer
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/app.ts
+var import_hono6 = require("hono");
+
+// src/middleware/cors.ts
+var import_cors = require("hono/cors");
+function corsMiddleware(config) {
+  return (0, import_cors.cors)({
+    origin: config?.origin ?? "*",
+    allowMethods: config?.allowMethods ?? ["GET", "POST", "OPTIONS"],
+    allowHeaders: config?.allowHeaders ?? ["Content-Type"],
+    ...config?.maxAge !== void 0 ? { maxAge: config.maxAge } : {},
+    ...config?.credentials !== void 0 ? { credentials: config.credentials } : {},
+    ...config?.exposeHeaders !== void 0 ? { exposeHeaders: config.exposeHeaders } : {}
+  });
+}
+
+// src/middleware/error-handler.ts
+var errorHandler = (err, c) => {
+  console.error("Server error:", err);
+  return c.json({ error: err.message || "Internal server error" }, 500);
+};
+
+// src/routes/admin.ts
+var import_hono = require("hono");
+function adminRoutes(config) {
+  const app = new import_hono.Hono();
+  app.get("/admin/dashboard", async (c) => {
+    const stats = await config.adminService.getDashboardStats();
+    return c.json(stats);
+  });
+  app.get("/admin/agents", async (c) => {
+    const agents = await config.adminService.getAllAgentStats();
+    return c.json(agents);
+  });
+  app.get("/admin/tools", async (c) => {
+    const tools = await config.adminService.getToolAnalytics();
+    return c.json(tools);
+  });
+  app.get("/admin/tokens", async (c) => {
+    const groupBy = c.req.query("group_by") ?? "agent";
+    const usage = await config.adminService.getTokenUsage({ groupBy });
+    return c.json(usage);
+  });
+  app.get("/admin/events/stream", (c) => {
+    const stream = config.sseExporter.connect();
+    c.req.raw.signal.addEventListener("abort", () => {
+      config.sseExporter.disconnect(stream);
+    });
+    return new Response(stream, {
+      headers: {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        Connection: "keep-alive"
+      }
+    });
+  });
+  return app;
+}
+
+// src/routes/agents.ts
+var import_hono2 = require("hono");
+function agentRoutes(agents) {
+  const app = new import_hono2.Hono();
+  app.get("/agents", (c) => {
+    const summaries = agents.map((a) => ({
+      id: a.id,
+      name: a.name,
+      description: a.description ?? ""
+    }));
+    return c.json(summaries);
+  });
+  return app;
+}
+
+// src/routes/conversations.ts
+var import_runtime2 = require("@agentic-patterns/runtime");
+var import_hono3 = require("hono");
+var import_streaming = require("hono/streaming");
+
+// src/sse.ts
+var import_runtime = require("@agentic-patterns/runtime");
+var INTERNAL_EVENT_TYPES = /* @__PURE__ */ new Set([
+  "agent.iteration.start",
+  "agent.iteration.end",
+  "agent.llm.start",
+  "agent.llm.end"
+]);
+function agentEventToSSE(event) {
+  if (INTERNAL_EVENT_TYPES.has(event.type)) return null;
+  const mapping = (0, import_runtime.toSSEMapping)(event);
+  if (!mapping) return null;
+  return { event: mapping.name, data: JSON.stringify(mapping.payload) };
+}
+
+// src/routes/conversations.ts
+function conversationRoutes(agents, conversations, eventBus) {
+  const app = new import_hono3.Hono();
+  app.post("/conversations", async (c) => {
+    const body = await c.req.json();
+    const agentId = body.agent_id;
+    const reg = agents.find((a) => a.id === agentId);
+    if (!reg) {
+      return c.json({ error: "Agent not found" }, 404);
+    }
+    const toolExecutor = (0, import_runtime2.createToolboxExecutor)(
+      reg.agent
+    );
+    const conversation = new import_runtime2.Conversation(reg.agent, reg.runner, { toolExecutor });
+    conversations.set(conversation.id, { conversation, agentId });
+    return c.json({ id: conversation.id, agent_id: agentId }, 201);
+  });
+  app.post("/conversations/:id/messages", async (c) => {
+    const convId = c.req.param("id");
+    const entry = conversations.get(convId);
+    if (!entry) {
+      return c.json({ error: "Conversation not found" }, 404);
+    }
+    const body = await c.req.json();
+    const content = body.content;
+    if (!content || typeof content !== "string") {
+      return c.json({ error: "content is required" }, 400);
+    }
+    const { conversation } = entry;
+    if (!conversation.runner.stream) {
+      return c.json({ error: "Streaming not supported by this runner" }, 501);
+    }
+    return (0, import_streaming.streamSSE)(c, async (stream) => {
+      for await (const event of conversation.stream(content, { eventBus })) {
+        const msg = agentEventToSSE(event);
+        if (msg) {
+          await stream.writeSSE(msg);
+        }
+      }
+      await stream.writeSSE({ event: "done", data: "{}" });
+    });
+  });
+  return app;
+}
+
+// src/routes/health.ts
+var import_hono4 = require("hono");
+function healthRoutes() {
+  const app = new import_hono4.Hono();
+  app.get("/health", (c) => c.json({ status: "ok" }));
+  return app;
+}
+
+// src/routes/hooks.ts
+var import_runtime3 = require("@agentic-patterns/runtime");
+var import_hono5 = require("hono");
+function newSpanId() {
+  if (typeof globalThis !== "undefined" && "crypto" in globalThis) {
+    return globalThis.crypto.randomUUID();
+  }
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function hookRoutes(eventBus) {
+  const app = new import_hono5.Hono();
+  app.post("/hooks/:eventType", async (c) => {
+    const eventType = c.req.param("eventType");
+    if (!(0, import_runtime3.isClaudeCodeHookName)(eventType)) {
+      return c.json({ error: `unknown hook event: ${eventType}` }, 400);
+    }
+    const body = await c.req.json().catch(() => ({}));
+    const sessionId = typeof body.session_id === "string" ? body.session_id : "unknown";
+    const runnerCorrelationId = c.req.header("x-ap-runner-correlation-id") ?? void 0;
+    const hookEvent = {
+      type: "claude_code.hook",
+      traceId: sessionId,
+      runId: sessionId,
+      spanId: newSpanId(),
+      timestamp: /* @__PURE__ */ new Date(),
+      hookName: eventType,
+      sessionId,
+      transcriptPath: typeof body.transcript_path === "string" ? body.transcript_path : void 0,
+      cwd: typeof body.cwd === "string" ? body.cwd : void 0,
+      permissionMode: typeof body.permission_mode === "string" ? body.permission_mode : void 0,
+      toolName: typeof body.tool_name === "string" ? body.tool_name : void 0,
+      toolInput: body.tool_input,
+      toolResponse: body.tool_response,
+      toolUseId: typeof body.tool_use_id === "string" ? body.tool_use_id : void 0,
+      payload: body,
+      ...runnerCorrelationId ? { runnerCorrelationId } : {}
+    };
+    await eventBus.publish(hookEvent);
+    if (!runnerCorrelationId) {
+      const derived = (0, import_runtime3.mapClaudeCodeHookToAgentEvents)(hookEvent);
+      for (const e of derived) {
+        await eventBus.publish(e);
+      }
+    }
+    return c.json({ ok: true });
+  });
+  return app;
+}
+
+// src/app.ts
+function createServer(config) {
+  const app = new import_hono6.Hono();
+  const conversations = /* @__PURE__ */ new Map();
+  app.use("*", corsMiddleware(config.cors));
+  app.onError(errorHandler);
+  app.route("/", healthRoutes());
+  app.route("/", agentRoutes(config.agents));
+  app.route("/", conversationRoutes(config.agents, conversations, config.eventBus));
+  app.route("/", adminRoutes(config));
+  app.route("/", hookRoutes(config.eventBus));
+  return app;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  agentEventToSSE,
+  createServer
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/app.ts","../src/middleware/cors.ts","../src/middleware/error-handler.ts","../src/routes/admin.ts","../src/routes/agents.ts","../src/routes/conversations.ts","../src/sse.ts","../src/routes/health.ts","../src/routes/hooks.ts"],"sourcesContent":["// @agentic-patterns/server — barrel export\nexport { createServer } from \"./app.js\";\nexport type {\n  ServerConfig,\n  AgentRegistration,\n  AdminServiceProtocol,\n  SSEExporterLike,\n  ConversationStoreLike,\n  CORSConfig,\n} from \"./config.js\";\nexport { agentEventToSSE, type SSEMessage } from \"./sse.js\";\n","/**\n * Hono application factory.\n */\n\nimport { Hono } from \"hono\";\nimport type { ServerConfig } from \"./config.js\";\nimport { corsMiddleware } from \"./middleware/cors.js\";\nimport { errorHandler } from \"./middleware/error-handler.js\";\nimport { adminRoutes } from \"./routes/admin.js\";\nimport { agentRoutes } from \"./routes/agents.js\";\nimport { type ConversationEntry, conversationRoutes } from \"./routes/conversations.js\";\nimport { healthRoutes } from \"./routes/health.js\";\nimport { hookRoutes } from \"./routes/hooks.js\";\n\n/**\n * Create a configured Hono app with all routes.\n *\n * Each call creates a fresh conversation registry, so multiple\n * servers in the same process do not share conversation state.\n */\nexport function createServer(config: ServerConfig): Hono {\n  const app = new Hono();\n  const conversations = new Map<string, ConversationEntry>();\n\n  // Middleware\n  app.use(\"*\", corsMiddleware(config.cors));\n  app.onError(errorHandler);\n\n  // Routes\n  app.route(\"/\", healthRoutes());\n  app.route(\"/\", agentRoutes(config.agents));\n  app.route(\"/\", conversationRoutes(config.agents, conversations, config.eventBus));\n  app.route(\"/\", adminRoutes(config));\n  app.route(\"/\", hookRoutes(config.eventBus));\n\n  return app;\n}\n","/**\n * CORS middleware for dashboard dev.\n */\n\nimport { cors } from \"hono/cors\";\nimport type { CORSConfig } from \"../config.js\";\n\n/**\n * Build the Hono cors middleware for this server.\n *\n * Defaults are permissive (`origin: \"*\"`) for local development; callers\n * should pin origin/headers/credentials for production via `ServerConfig.cors`.\n */\nexport function corsMiddleware(config?: CORSConfig) {\n  return cors({\n    origin: config?.origin ?? \"*\",\n    allowMethods: config?.allowMethods ?? [\"GET\", \"POST\", \"OPTIONS\"],\n    allowHeaders: config?.allowHeaders ?? [\"Content-Type\"],\n    ...(config?.maxAge !== undefined ? { maxAge: config.maxAge } : {}),\n    ...(config?.credentials !== undefined ? { credentials: config.credentials } : {}),\n    ...(config?.exposeHeaders !== undefined ? { exposeHeaders: config.exposeHeaders } : {}),\n  });\n}\n","/**\n * Global error handler.\n */\n\nimport type { ErrorHandler } from \"hono\";\n\nexport const errorHandler: ErrorHandler = (err, c) => {\n  console.error(\"Server error:\", err);\n  return c.json({ error: err.message || \"Internal server error\" }, 500);\n};\n","/**\n * Admin routes — dashboard stats, tool analytics, token usage, live event stream.\n */\n\nimport { Hono } from \"hono\";\nimport type { ServerConfig } from \"../config.js\";\n\nexport function adminRoutes(config: ServerConfig): Hono {\n  const app = new Hono();\n\n  app.get(\"/admin/dashboard\", async (c) => {\n    const stats = await config.adminService.getDashboardStats();\n    return c.json(stats);\n  });\n\n  app.get(\"/admin/agents\", async (c) => {\n    const agents = await config.adminService.getAllAgentStats();\n    return c.json(agents);\n  });\n\n  app.get(\"/admin/tools\", async (c) => {\n    const tools = await config.adminService.getToolAnalytics();\n    return c.json(tools);\n  });\n\n  app.get(\"/admin/tokens\", async (c) => {\n    const groupBy = (c.req.query(\"group_by\") as \"agent\" | \"model\") ?? \"agent\";\n    const usage = await config.adminService.getTokenUsage({ groupBy });\n    return c.json(usage);\n  });\n\n  app.get(\"/admin/events/stream\", (c) => {\n    const stream = config.sseExporter.connect();\n\n    c.req.raw.signal.addEventListener(\"abort\", () => {\n      config.sseExporter.disconnect(stream);\n    });\n\n    return new Response(stream, {\n      headers: {\n        \"Content-Type\": \"text/event-stream\",\n        \"Cache-Control\": \"no-cache\",\n        Connection: \"keep-alive\",\n      },\n    });\n  });\n\n  return app;\n}\n","/**\n * Agent listing routes.\n */\n\nimport { Hono } from \"hono\";\nimport type { AgentRegistration } from \"../config.js\";\n\nexport function agentRoutes(agents: AgentRegistration[]): Hono {\n  const app = new Hono();\n\n  app.get(\"/agents\", (c) => {\n    const summaries = agents.map((a) => ({\n      id: a.id,\n      name: a.name,\n      description: a.description ?? \"\",\n    }));\n    return c.json(summaries);\n  });\n\n  return app;\n}\n","/**\n * Conversation routes — create conversations and stream messages via SSE.\n */\n\nimport type { AgentEventBus } from \"@agentic-patterns/runtime\";\nimport { Conversation, createToolboxExecutor } from \"@agentic-patterns/runtime\";\nimport { Hono } from \"hono\";\nimport { streamSSE } from \"hono/streaming\";\nimport type { AgentRegistration } from \"../config.js\";\nimport { agentEventToSSE } from \"../sse.js\";\n\n/** Entry in the per-server conversation registry. */\nexport interface ConversationEntry {\n  conversation: Conversation;\n  agentId: string;\n}\n\nexport function conversationRoutes(\n  agents: AgentRegistration[],\n  conversations: Map<string, ConversationEntry>,\n  eventBus: AgentEventBus,\n): Hono {\n  const app = new Hono();\n\n  // POST /conversations — create a new conversation\n  app.post(\"/conversations\", async (c) => {\n    const body = await c.req.json<{ agent_id: string }>();\n    const agentId = body.agent_id;\n\n    const reg = agents.find((a) => a.id === agentId);\n    if (!reg) {\n      return c.json({ error: \"Agent not found\" }, 404);\n    }\n\n    // Wire a ToolExecutor so AgentRunner can actually execute tool calls\n    // from the agent's Capability toolboxes (not just format them for the LLM).\n    const toolExecutor = createToolboxExecutor(\n      reg.agent as unknown as Parameters<typeof createToolboxExecutor>[0],\n    );\n    const conversation = new Conversation(reg.agent, reg.runner, { toolExecutor });\n    conversations.set(conversation.id, { conversation, agentId });\n\n    return c.json({ id: conversation.id, agent_id: agentId }, 201);\n  });\n\n  // POST /conversations/:id/messages — send message, stream SSE response\n  app.post(\"/conversations/:id/messages\", async (c) => {\n    const convId = c.req.param(\"id\");\n    const entry = conversations.get(convId);\n\n    if (!entry) {\n      return c.json({ error: \"Conversation not found\" }, 404);\n    }\n\n    const body = await c.req.json<{ content: string }>();\n    const content = body.content;\n\n    if (!content || typeof content !== \"string\") {\n      return c.json({ error: \"content is required\" }, 400);\n    }\n\n    const { conversation } = entry;\n\n    if (!conversation.runner.stream) {\n      return c.json({ error: \"Streaming not supported by this runner\" }, 501);\n    }\n\n    // SSE streaming response. We pass the server's shared eventBus so\n    // emitted events reach every attached exporter (collector, SSE\n    // broadcast, etc.) in addition to flowing through the generator for\n    // this client stream.\n    return streamSSE(c, async (stream) => {\n      for await (const event of conversation.stream(content, { eventBus })) {\n        const msg = agentEventToSSE(event);\n        if (msg) {\n          await stream.writeSSE(msg);\n        }\n      }\n\n      await stream.writeSSE({ event: \"done\", data: \"{}\" });\n    });\n  });\n\n  return app;\n}\n","/**\n * SSE formatting for Hono streaming.\n *\n * Converts AgentEvents to `{ event, data }` objects compatible with Hono's\n * streamSSE writeSSE() method.\n *\n * Delegates wire-name and payload mapping to the runtime's canonical\n * `toSSEMapping` so the server stays in sync with the 20-event vocabulary\n * defined in the spec. Only internal observability events (iteration.* and\n * llm.*) are filtered here — they remain available over the admin SSE\n * stream (SSEExporter) for operators.\n */\n\nimport type { AgentEvent, AgentEventType } from \"@agentic-patterns/runtime\";\nimport { toSSEMapping } from \"@agentic-patterns/runtime\";\n\n/** SSE message shape for Hono's writeSSE(). */\nexport interface SSEMessage {\n  event: string;\n  data: string;\n}\n\n/**\n * Internal observability events not surfaced to end clients. They remain\n * available over the admin SSE stream for operators.\n */\nconst INTERNAL_EVENT_TYPES: ReadonlySet<AgentEventType> = new Set<AgentEventType>([\n  \"agent.iteration.start\",\n  \"agent.iteration.end\",\n  \"agent.llm.start\",\n  \"agent.llm.end\",\n]);\n\n/**\n * Convert an AgentEvent to an SSE message for Hono streaming.\n *\n * Returns `null` for events that are not part of the client-facing\n * protocol (internal observability events, or events with no SSE mapping).\n */\nexport function agentEventToSSE(event: AgentEvent): SSEMessage | null {\n  if (INTERNAL_EVENT_TYPES.has(event.type)) return null;\n  const mapping = toSSEMapping(event);\n  if (!mapping) return null;\n  return { event: mapping.name, data: JSON.stringify(mapping.payload) };\n}\n","/**\n * Health check route.\n */\n\nimport { Hono } from \"hono\";\n\nexport function healthRoutes(): Hono {\n  const app = new Hono();\n  app.get(\"/health\", (c) => c.json({ status: \"ok\" }));\n  return app;\n}\n","/**\n * Claude Code hook bridge — receive hook callbacks from the Claude Code\n * CLI and republish them on the AgentEventBus.\n *\n * The Claude Code CLI is configured (via `.claude/settings.json`) to POST\n * each hook callback as JSON to `/hooks/:eventType`. We validate the\n * event name against the known hook list, normalize the payload into a\n * `ClaudeCodeHookEvent`, publish it to the bus, then publish any derived\n * canonical events (PreToolUse → agent.tool.start, etc.).\n */\n\nimport {\n  type AgentEventBus,\n  type ClaudeCodeHookEvent,\n  isClaudeCodeHookName,\n  mapClaudeCodeHookToAgentEvents,\n} from \"@agentic-patterns/runtime\";\nimport { Hono } from \"hono\";\n\nfunction newSpanId(): string {\n  if (typeof globalThis !== \"undefined\" && \"crypto\" in globalThis) {\n    return (globalThis as unknown as { crypto: { randomUUID(): string } }).crypto.randomUUID();\n  }\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function hookRoutes(eventBus: AgentEventBus): Hono {\n  const app = new Hono();\n\n  app.post(\"/hooks/:eventType\", async (c) => {\n    const eventType = c.req.param(\"eventType\");\n    if (!isClaudeCodeHookName(eventType)) {\n      return c.json({ error: `unknown hook event: ${eventType}` }, 400);\n    }\n\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const sessionId = typeof body.session_id === \"string\" ? body.session_id : \"unknown\";\n\n    // Runner correlation: when a ClaudeCodeRunner spawned this CC session it\n    // tags every hook POST with `x-ap-runner-correlation-id`. We preserve the\n    // raw hook (PreCompact, PermissionRequest, etc. give value the runner\n    // doesn't emit) but SKIP deriving `agent.tool.start`/`agent.tool.end`\n    // events to avoid double-counting alongside the runner's own tool events.\n    const runnerCorrelationId =\n      c.req.header(\"x-ap-runner-correlation-id\") ?? undefined;\n\n    const hookEvent: ClaudeCodeHookEvent = {\n      type: \"claude_code.hook\",\n      traceId: sessionId,\n      runId: sessionId,\n      spanId: newSpanId(),\n      timestamp: new Date(),\n      hookName: eventType,\n      sessionId,\n      transcriptPath:\n        typeof body.transcript_path === \"string\" ? body.transcript_path : undefined,\n      cwd: typeof body.cwd === \"string\" ? body.cwd : undefined,\n      permissionMode:\n        typeof body.permission_mode === \"string\" ? body.permission_mode : undefined,\n      toolName: typeof body.tool_name === \"string\" ? body.tool_name : undefined,\n      toolInput: body.tool_input,\n      toolResponse: body.tool_response,\n      toolUseId: typeof body.tool_use_id === \"string\" ? body.tool_use_id : undefined,\n      payload: body,\n      ...(runnerCorrelationId ? { runnerCorrelationId } : {}),\n    };\n\n    await eventBus.publish(hookEvent);\n\n    if (!runnerCorrelationId) {\n      const derived = mapClaudeCodeHookToAgentEvents(hookEvent);\n      for (const e of derived) {\n        await eventBus.publish(e);\n      }\n    }\n\n    return c.json({ ok: true });\n  });\n\n  return app;\n}\n"],"mappings":"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","names":["import_hono","import_hono","import_runtime","import_hono","import_hono","import_runtime","import_hono"]}

package/dist/index.d.cts

@@ -0,0 +1,106 @@
+import { Hono } from 'hono';
+import { AgentLike, RunnerProtocol, RunResult, AdminServiceProtocol, AgentEventBus, AgentEvent } from '@agentic-patterns/runtime';
+export { AdminServiceProtocol } from '@agentic-patterns/runtime';
+
+/**
+ * Server configuration types.
+ */
+
+/**
+ * Agent registration — what the server knows about each agent.
+ *
+ * `agent` and `runner.run/stream` use the canonical protocol shapes
+ * (`AgentLike`, `RunnerProtocol`, `RunResult`) from the runtime so the
+ * server and runtime share a single contract end-to-end.
+ */
+interface AgentRegistration {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly agent: AgentLike;
+    readonly runner: Pick<RunnerProtocol, "run" | "stream"> & {
+        run(agent: AgentLike, message: string, options?: Record<string, unknown>): Promise<RunResult>;
+    };
+}
+
+/**
+ * SSE exporter interface — structural typing for SSEExporter from runtime.
+ */
+interface SSEExporterLike {
+    connect(): ReadableStream<Uint8Array>;
+    disconnect(stream: ReadableStream<Uint8Array>): void;
+}
+/**
+ * Conversation store interface — structural typing for ConversationStoreProtocol.
+ */
+interface ConversationStoreLike {
+    get(id: string): Promise<unknown>;
+    list(): Promise<unknown[]>;
+}
+/**
+ * CORS configuration passed to the Hono cors middleware.
+ *
+ * Default is `origin: "*"` for local development. Production deployments
+ * should pin to known origins.
+ */
+interface CORSConfig {
+    readonly origin?: string | string[];
+    readonly allowMethods?: string[];
+    readonly allowHeaders?: string[];
+    readonly maxAge?: number;
+    readonly credentials?: boolean;
+    readonly exposeHeaders?: string[];
+}
+/**
+ * Server configuration.
+ */
+interface ServerConfig {
+    readonly agents: AgentRegistration[];
+    readonly adminService: AdminServiceProtocol;
+    readonly eventBus: AgentEventBus;
+    readonly sseExporter: SSEExporterLike;
+    readonly store?: ConversationStoreLike;
+    readonly staticDir?: string;
+    /** CORS options forwarded to Hono's cors middleware. Defaults to `origin: "*"`. */
+    readonly cors?: CORSConfig;
+}
+
+/**
+ * Hono application factory.
+ */
+
+/**
+ * Create a configured Hono app with all routes.
+ *
+ * Each call creates a fresh conversation registry, so multiple
+ * servers in the same process do not share conversation state.
+ */
+declare function createServer(config: ServerConfig): Hono;
+
+/**
+ * SSE formatting for Hono streaming.
+ *
+ * Converts AgentEvents to `{ event, data }` objects compatible with Hono's
+ * streamSSE writeSSE() method.
+ *
+ * Delegates wire-name and payload mapping to the runtime's canonical
+ * `toSSEMapping` so the server stays in sync with the 20-event vocabulary
+ * defined in the spec. Only internal observability events (iteration.* and
+ * llm.*) are filtered here — they remain available over the admin SSE
+ * stream (SSEExporter) for operators.
+ */
+
+/** SSE message shape for Hono's writeSSE(). */
+interface SSEMessage {
+    event: string;
+    data: string;
+}
+/**
+ * Convert an AgentEvent to an SSE message for Hono streaming.
+ *
+ * Returns `null` for events that are not part of the client-facing
+ * protocol (internal observability events, or events with no SSE mapping).
+ */
+declare function agentEventToSSE(event: AgentEvent): SSEMessage | null;
+
+export { type AgentRegistration, type CORSConfig, type ConversationStoreLike, type SSEExporterLike, type SSEMessage, type ServerConfig, agentEventToSSE, createServer };

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+import { Hono } from 'hono';
+import { AgentLike, RunnerProtocol, RunResult, AdminServiceProtocol, AgentEventBus, AgentEvent } from '@agentic-patterns/runtime';
+export { AdminServiceProtocol } from '@agentic-patterns/runtime';
+
+/**
+ * Server configuration types.
+ */
+
+/**
+ * Agent registration — what the server knows about each agent.
+ *
+ * `agent` and `runner.run/stream` use the canonical protocol shapes
+ * (`AgentLike`, `RunnerProtocol`, `RunResult`) from the runtime so the
+ * server and runtime share a single contract end-to-end.
+ */
+interface AgentRegistration {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly agent: AgentLike;
+    readonly runner: Pick<RunnerProtocol, "run" | "stream"> & {
+        run(agent: AgentLike, message: string, options?: Record<string, unknown>): Promise<RunResult>;
+    };
+}
+
+/**
+ * SSE exporter interface — structural typing for SSEExporter from runtime.
+ */
+interface SSEExporterLike {
+    connect(): ReadableStream<Uint8Array>;
+    disconnect(stream: ReadableStream<Uint8Array>): void;
+}
+/**
+ * Conversation store interface — structural typing for ConversationStoreProtocol.
+ */
+interface ConversationStoreLike {
+    get(id: string): Promise<unknown>;
+    list(): Promise<unknown[]>;
+}
+/**
+ * CORS configuration passed to the Hono cors middleware.
+ *
+ * Default is `origin: "*"` for local development. Production deployments
+ * should pin to known origins.
+ */
+interface CORSConfig {
+    readonly origin?: string | string[];
+    readonly allowMethods?: string[];
+    readonly allowHeaders?: string[];
+    readonly maxAge?: number;
+    readonly credentials?: boolean;
+    readonly exposeHeaders?: string[];
+}
+/**
+ * Server configuration.
+ */
+interface ServerConfig {
+    readonly agents: AgentRegistration[];
+    readonly adminService: AdminServiceProtocol;
+    readonly eventBus: AgentEventBus;
+    readonly sseExporter: SSEExporterLike;
+    readonly store?: ConversationStoreLike;
+    readonly staticDir?: string;
+    /** CORS options forwarded to Hono's cors middleware. Defaults to `origin: "*"`. */
+    readonly cors?: CORSConfig;
+}
+
+/**
+ * Hono application factory.
+ */
+
+/**
+ * Create a configured Hono app with all routes.
+ *
+ * Each call creates a fresh conversation registry, so multiple
+ * servers in the same process do not share conversation state.
+ */
+declare function createServer(config: ServerConfig): Hono;
+
+/**
+ * SSE formatting for Hono streaming.
+ *
+ * Converts AgentEvents to `{ event, data }` objects compatible with Hono's
+ * streamSSE writeSSE() method.
+ *
+ * Delegates wire-name and payload mapping to the runtime's canonical
+ * `toSSEMapping` so the server stays in sync with the 20-event vocabulary
+ * defined in the spec. Only internal observability events (iteration.* and
+ * llm.*) are filtered here — they remain available over the admin SSE
+ * stream (SSEExporter) for operators.
+ */
+
+/** SSE message shape for Hono's writeSSE(). */
+interface SSEMessage {
+    event: string;
+    data: string;
+}
+/**
+ * Convert an AgentEvent to an SSE message for Hono streaming.
+ *
+ * Returns `null` for events that are not part of the client-facing
+ * protocol (internal observability events, or events with no SSE mapping).
+ */
+declare function agentEventToSSE(event: AgentEvent): SSEMessage | null;
+
+export { type AgentRegistration, type CORSConfig, type ConversationStoreLike, type SSEExporterLike, type SSEMessage, type ServerConfig, agentEventToSSE, createServer };

package/dist/index.js

@@ -0,0 +1,217 @@
+// src/app.ts
+import { Hono as Hono6 } from "hono";
+
+// src/middleware/cors.ts
+import { cors } from "hono/cors";
+function corsMiddleware(config) {
+  return cors({
+    origin: config?.origin ?? "*",
+    allowMethods: config?.allowMethods ?? ["GET", "POST", "OPTIONS"],
+    allowHeaders: config?.allowHeaders ?? ["Content-Type"],
+    ...config?.maxAge !== void 0 ? { maxAge: config.maxAge } : {},
+    ...config?.credentials !== void 0 ? { credentials: config.credentials } : {},
+    ...config?.exposeHeaders !== void 0 ? { exposeHeaders: config.exposeHeaders } : {}
+  });
+}
+
+// src/middleware/error-handler.ts
+var errorHandler = (err, c) => {
+  console.error("Server error:", err);
+  return c.json({ error: err.message || "Internal server error" }, 500);
+};
+
+// src/routes/admin.ts
+import { Hono } from "hono";
+function adminRoutes(config) {
+  const app = new Hono();
+  app.get("/admin/dashboard", async (c) => {
+    const stats = await config.adminService.getDashboardStats();
+    return c.json(stats);
+  });
+  app.get("/admin/agents", async (c) => {
+    const agents = await config.adminService.getAllAgentStats();
+    return c.json(agents);
+  });
+  app.get("/admin/tools", async (c) => {
+    const tools = await config.adminService.getToolAnalytics();
+    return c.json(tools);
+  });
+  app.get("/admin/tokens", async (c) => {
+    const groupBy = c.req.query("group_by") ?? "agent";
+    const usage = await config.adminService.getTokenUsage({ groupBy });
+    return c.json(usage);
+  });
+  app.get("/admin/events/stream", (c) => {
+    const stream = config.sseExporter.connect();
+    c.req.raw.signal.addEventListener("abort", () => {
+      config.sseExporter.disconnect(stream);
+    });
+    return new Response(stream, {
+      headers: {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        Connection: "keep-alive"
+      }
+    });
+  });
+  return app;
+}
+
+// src/routes/agents.ts
+import { Hono as Hono2 } from "hono";
+function agentRoutes(agents) {
+  const app = new Hono2();
+  app.get("/agents", (c) => {
+    const summaries = agents.map((a) => ({
+      id: a.id,
+      name: a.name,
+      description: a.description ?? ""
+    }));
+    return c.json(summaries);
+  });
+  return app;
+}
+
+// src/routes/conversations.ts
+import { Conversation, createToolboxExecutor } from "@agentic-patterns/runtime";
+import { Hono as Hono3 } from "hono";
+import { streamSSE } from "hono/streaming";
+
+// src/sse.ts
+import { toSSEMapping } from "@agentic-patterns/runtime";
+var INTERNAL_EVENT_TYPES = /* @__PURE__ */ new Set([
+  "agent.iteration.start",
+  "agent.iteration.end",
+  "agent.llm.start",
+  "agent.llm.end"
+]);
+function agentEventToSSE(event) {
+  if (INTERNAL_EVENT_TYPES.has(event.type)) return null;
+  const mapping = toSSEMapping(event);
+  if (!mapping) return null;
+  return { event: mapping.name, data: JSON.stringify(mapping.payload) };
+}
+
+// src/routes/conversations.ts
+function conversationRoutes(agents, conversations, eventBus) {
+  const app = new Hono3();
+  app.post("/conversations", async (c) => {
+    const body = await c.req.json();
+    const agentId = body.agent_id;
+    const reg = agents.find((a) => a.id === agentId);
+    if (!reg) {
+      return c.json({ error: "Agent not found" }, 404);
+    }
+    const toolExecutor = createToolboxExecutor(
+      reg.agent
+    );
+    const conversation = new Conversation(reg.agent, reg.runner, { toolExecutor });
+    conversations.set(conversation.id, { conversation, agentId });
+    return c.json({ id: conversation.id, agent_id: agentId }, 201);
+  });
+  app.post("/conversations/:id/messages", async (c) => {
+    const convId = c.req.param("id");
+    const entry = conversations.get(convId);
+    if (!entry) {
+      return c.json({ error: "Conversation not found" }, 404);
+    }
+    const body = await c.req.json();
+    const content = body.content;
+    if (!content || typeof content !== "string") {
+      return c.json({ error: "content is required" }, 400);
+    }
+    const { conversation } = entry;
+    if (!conversation.runner.stream) {
+      return c.json({ error: "Streaming not supported by this runner" }, 501);
+    }
+    return streamSSE(c, async (stream) => {
+      for await (const event of conversation.stream(content, { eventBus })) {
+        const msg = agentEventToSSE(event);
+        if (msg) {
+          await stream.writeSSE(msg);
+        }
+      }
+      await stream.writeSSE({ event: "done", data: "{}" });
+    });
+  });
+  return app;
+}
+
+// src/routes/health.ts
+import { Hono as Hono4 } from "hono";
+function healthRoutes() {
+  const app = new Hono4();
+  app.get("/health", (c) => c.json({ status: "ok" }));
+  return app;
+}
+
+// src/routes/hooks.ts
+import {
+  isClaudeCodeHookName,
+  mapClaudeCodeHookToAgentEvents
+} from "@agentic-patterns/runtime";
+import { Hono as Hono5 } from "hono";
+function newSpanId() {
+  if (typeof globalThis !== "undefined" && "crypto" in globalThis) {
+    return globalThis.crypto.randomUUID();
+  }
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function hookRoutes(eventBus) {
+  const app = new Hono5();
+  app.post("/hooks/:eventType", async (c) => {
+    const eventType = c.req.param("eventType");
+    if (!isClaudeCodeHookName(eventType)) {
+      return c.json({ error: `unknown hook event: ${eventType}` }, 400);
+    }
+    const body = await c.req.json().catch(() => ({}));
+    const sessionId = typeof body.session_id === "string" ? body.session_id : "unknown";
+    const runnerCorrelationId = c.req.header("x-ap-runner-correlation-id") ?? void 0;
+    const hookEvent = {
+      type: "claude_code.hook",
+      traceId: sessionId,
+      runId: sessionId,
+      spanId: newSpanId(),
+      timestamp: /* @__PURE__ */ new Date(),
+      hookName: eventType,
+      sessionId,
+      transcriptPath: typeof body.transcript_path === "string" ? body.transcript_path : void 0,
+      cwd: typeof body.cwd === "string" ? body.cwd : void 0,
+      permissionMode: typeof body.permission_mode === "string" ? body.permission_mode : void 0,
+      toolName: typeof body.tool_name === "string" ? body.tool_name : void 0,
+      toolInput: body.tool_input,
+      toolResponse: body.tool_response,
+      toolUseId: typeof body.tool_use_id === "string" ? body.tool_use_id : void 0,
+      payload: body,
+      ...runnerCorrelationId ? { runnerCorrelationId } : {}
+    };
+    await eventBus.publish(hookEvent);
+    if (!runnerCorrelationId) {
+      const derived = mapClaudeCodeHookToAgentEvents(hookEvent);
+      for (const e of derived) {
+        await eventBus.publish(e);
+      }
+    }
+    return c.json({ ok: true });
+  });
+  return app;
+}
+
+// src/app.ts
+function createServer(config) {
+  const app = new Hono6();
+  const conversations = /* @__PURE__ */ new Map();
+  app.use("*", corsMiddleware(config.cors));
+  app.onError(errorHandler);
+  app.route("/", healthRoutes());
+  app.route("/", agentRoutes(config.agents));
+  app.route("/", conversationRoutes(config.agents, conversations, config.eventBus));
+  app.route("/", adminRoutes(config));
+  app.route("/", hookRoutes(config.eventBus));
+  return app;
+}
+export {
+  agentEventToSSE,
+  createServer
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/app.ts","../src/middleware/cors.ts","../src/middleware/error-handler.ts","../src/routes/admin.ts","../src/routes/agents.ts","../src/routes/conversations.ts","../src/sse.ts","../src/routes/health.ts","../src/routes/hooks.ts"],"sourcesContent":["/**\n * Hono application factory.\n */\n\nimport { Hono } from \"hono\";\nimport type { ServerConfig } from \"./config.js\";\nimport { corsMiddleware } from \"./middleware/cors.js\";\nimport { errorHandler } from \"./middleware/error-handler.js\";\nimport { adminRoutes } from \"./routes/admin.js\";\nimport { agentRoutes } from \"./routes/agents.js\";\nimport { type ConversationEntry, conversationRoutes } from \"./routes/conversations.js\";\nimport { healthRoutes } from \"./routes/health.js\";\nimport { hookRoutes } from \"./routes/hooks.js\";\n\n/**\n * Create a configured Hono app with all routes.\n *\n * Each call creates a fresh conversation registry, so multiple\n * servers in the same process do not share conversation state.\n */\nexport function createServer(config: ServerConfig): Hono {\n  const app = new Hono();\n  const conversations = new Map<string, ConversationEntry>();\n\n  // Middleware\n  app.use(\"*\", corsMiddleware(config.cors));\n  app.onError(errorHandler);\n\n  // Routes\n  app.route(\"/\", healthRoutes());\n  app.route(\"/\", agentRoutes(config.agents));\n  app.route(\"/\", conversationRoutes(config.agents, conversations, config.eventBus));\n  app.route(\"/\", adminRoutes(config));\n  app.route(\"/\", hookRoutes(config.eventBus));\n\n  return app;\n}\n","/**\n * CORS middleware for dashboard dev.\n */\n\nimport { cors } from \"hono/cors\";\nimport type { CORSConfig } from \"../config.js\";\n\n/**\n * Build the Hono cors middleware for this server.\n *\n * Defaults are permissive (`origin: \"*\"`) for local development; callers\n * should pin origin/headers/credentials for production via `ServerConfig.cors`.\n */\nexport function corsMiddleware(config?: CORSConfig) {\n  return cors({\n    origin: config?.origin ?? \"*\",\n    allowMethods: config?.allowMethods ?? [\"GET\", \"POST\", \"OPTIONS\"],\n    allowHeaders: config?.allowHeaders ?? [\"Content-Type\"],\n    ...(config?.maxAge !== undefined ? { maxAge: config.maxAge } : {}),\n    ...(config?.credentials !== undefined ? { credentials: config.credentials } : {}),\n    ...(config?.exposeHeaders !== undefined ? { exposeHeaders: config.exposeHeaders } : {}),\n  });\n}\n","/**\n * Global error handler.\n */\n\nimport type { ErrorHandler } from \"hono\";\n\nexport const errorHandler: ErrorHandler = (err, c) => {\n  console.error(\"Server error:\", err);\n  return c.json({ error: err.message || \"Internal server error\" }, 500);\n};\n","/**\n * Admin routes — dashboard stats, tool analytics, token usage, live event stream.\n */\n\nimport { Hono } from \"hono\";\nimport type { ServerConfig } from \"../config.js\";\n\nexport function adminRoutes(config: ServerConfig): Hono {\n  const app = new Hono();\n\n  app.get(\"/admin/dashboard\", async (c) => {\n    const stats = await config.adminService.getDashboardStats();\n    return c.json(stats);\n  });\n\n  app.get(\"/admin/agents\", async (c) => {\n    const agents = await config.adminService.getAllAgentStats();\n    return c.json(agents);\n  });\n\n  app.get(\"/admin/tools\", async (c) => {\n    const tools = await config.adminService.getToolAnalytics();\n    return c.json(tools);\n  });\n\n  app.get(\"/admin/tokens\", async (c) => {\n    const groupBy = (c.req.query(\"group_by\") as \"agent\" | \"model\") ?? \"agent\";\n    const usage = await config.adminService.getTokenUsage({ groupBy });\n    return c.json(usage);\n  });\n\n  app.get(\"/admin/events/stream\", (c) => {\n    const stream = config.sseExporter.connect();\n\n    c.req.raw.signal.addEventListener(\"abort\", () => {\n      config.sseExporter.disconnect(stream);\n    });\n\n    return new Response(stream, {\n      headers: {\n        \"Content-Type\": \"text/event-stream\",\n        \"Cache-Control\": \"no-cache\",\n        Connection: \"keep-alive\",\n      },\n    });\n  });\n\n  return app;\n}\n","/**\n * Agent listing routes.\n */\n\nimport { Hono } from \"hono\";\nimport type { AgentRegistration } from \"../config.js\";\n\nexport function agentRoutes(agents: AgentRegistration[]): Hono {\n  const app = new Hono();\n\n  app.get(\"/agents\", (c) => {\n    const summaries = agents.map((a) => ({\n      id: a.id,\n      name: a.name,\n      description: a.description ?? \"\",\n    }));\n    return c.json(summaries);\n  });\n\n  return app;\n}\n","/**\n * Conversation routes — create conversations and stream messages via SSE.\n */\n\nimport type { AgentEventBus } from \"@agentic-patterns/runtime\";\nimport { Conversation, createToolboxExecutor } from \"@agentic-patterns/runtime\";\nimport { Hono } from \"hono\";\nimport { streamSSE } from \"hono/streaming\";\nimport type { AgentRegistration } from \"../config.js\";\nimport { agentEventToSSE } from \"../sse.js\";\n\n/** Entry in the per-server conversation registry. */\nexport interface ConversationEntry {\n  conversation: Conversation;\n  agentId: string;\n}\n\nexport function conversationRoutes(\n  agents: AgentRegistration[],\n  conversations: Map<string, ConversationEntry>,\n  eventBus: AgentEventBus,\n): Hono {\n  const app = new Hono();\n\n  // POST /conversations — create a new conversation\n  app.post(\"/conversations\", async (c) => {\n    const body = await c.req.json<{ agent_id: string }>();\n    const agentId = body.agent_id;\n\n    const reg = agents.find((a) => a.id === agentId);\n    if (!reg) {\n      return c.json({ error: \"Agent not found\" }, 404);\n    }\n\n    // Wire a ToolExecutor so AgentRunner can actually execute tool calls\n    // from the agent's Capability toolboxes (not just format them for the LLM).\n    const toolExecutor = createToolboxExecutor(\n      reg.agent as unknown as Parameters<typeof createToolboxExecutor>[0],\n    );\n    const conversation = new Conversation(reg.agent, reg.runner, { toolExecutor });\n    conversations.set(conversation.id, { conversation, agentId });\n\n    return c.json({ id: conversation.id, agent_id: agentId }, 201);\n  });\n\n  // POST /conversations/:id/messages — send message, stream SSE response\n  app.post(\"/conversations/:id/messages\", async (c) => {\n    const convId = c.req.param(\"id\");\n    const entry = conversations.get(convId);\n\n    if (!entry) {\n      return c.json({ error: \"Conversation not found\" }, 404);\n    }\n\n    const body = await c.req.json<{ content: string }>();\n    const content = body.content;\n\n    if (!content || typeof content !== \"string\") {\n      return c.json({ error: \"content is required\" }, 400);\n    }\n\n    const { conversation } = entry;\n\n    if (!conversation.runner.stream) {\n      return c.json({ error: \"Streaming not supported by this runner\" }, 501);\n    }\n\n    // SSE streaming response. We pass the server's shared eventBus so\n    // emitted events reach every attached exporter (collector, SSE\n    // broadcast, etc.) in addition to flowing through the generator for\n    // this client stream.\n    return streamSSE(c, async (stream) => {\n      for await (const event of conversation.stream(content, { eventBus })) {\n        const msg = agentEventToSSE(event);\n        if (msg) {\n          await stream.writeSSE(msg);\n        }\n      }\n\n      await stream.writeSSE({ event: \"done\", data: \"{}\" });\n    });\n  });\n\n  return app;\n}\n","/**\n * SSE formatting for Hono streaming.\n *\n * Converts AgentEvents to `{ event, data }` objects compatible with Hono's\n * streamSSE writeSSE() method.\n *\n * Delegates wire-name and payload mapping to the runtime's canonical\n * `toSSEMapping` so the server stays in sync with the 20-event vocabulary\n * defined in the spec. Only internal observability events (iteration.* and\n * llm.*) are filtered here — they remain available over the admin SSE\n * stream (SSEExporter) for operators.\n */\n\nimport type { AgentEvent, AgentEventType } from \"@agentic-patterns/runtime\";\nimport { toSSEMapping } from \"@agentic-patterns/runtime\";\n\n/** SSE message shape for Hono's writeSSE(). */\nexport interface SSEMessage {\n  event: string;\n  data: string;\n}\n\n/**\n * Internal observability events not surfaced to end clients. They remain\n * available over the admin SSE stream for operators.\n */\nconst INTERNAL_EVENT_TYPES: ReadonlySet<AgentEventType> = new Set<AgentEventType>([\n  \"agent.iteration.start\",\n  \"agent.iteration.end\",\n  \"agent.llm.start\",\n  \"agent.llm.end\",\n]);\n\n/**\n * Convert an AgentEvent to an SSE message for Hono streaming.\n *\n * Returns `null` for events that are not part of the client-facing\n * protocol (internal observability events, or events with no SSE mapping).\n */\nexport function agentEventToSSE(event: AgentEvent): SSEMessage | null {\n  if (INTERNAL_EVENT_TYPES.has(event.type)) return null;\n  const mapping = toSSEMapping(event);\n  if (!mapping) return null;\n  return { event: mapping.name, data: JSON.stringify(mapping.payload) };\n}\n","/**\n * Health check route.\n */\n\nimport { Hono } from \"hono\";\n\nexport function healthRoutes(): Hono {\n  const app = new Hono();\n  app.get(\"/health\", (c) => c.json({ status: \"ok\" }));\n  return app;\n}\n","/**\n * Claude Code hook bridge — receive hook callbacks from the Claude Code\n * CLI and republish them on the AgentEventBus.\n *\n * The Claude Code CLI is configured (via `.claude/settings.json`) to POST\n * each hook callback as JSON to `/hooks/:eventType`. We validate the\n * event name against the known hook list, normalize the payload into a\n * `ClaudeCodeHookEvent`, publish it to the bus, then publish any derived\n * canonical events (PreToolUse → agent.tool.start, etc.).\n */\n\nimport {\n  type AgentEventBus,\n  type ClaudeCodeHookEvent,\n  isClaudeCodeHookName,\n  mapClaudeCodeHookToAgentEvents,\n} from \"@agentic-patterns/runtime\";\nimport { Hono } from \"hono\";\n\nfunction newSpanId(): string {\n  if (typeof globalThis !== \"undefined\" && \"crypto\" in globalThis) {\n    return (globalThis as unknown as { crypto: { randomUUID(): string } }).crypto.randomUUID();\n  }\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function hookRoutes(eventBus: AgentEventBus): Hono {\n  const app = new Hono();\n\n  app.post(\"/hooks/:eventType\", async (c) => {\n    const eventType = c.req.param(\"eventType\");\n    if (!isClaudeCodeHookName(eventType)) {\n      return c.json({ error: `unknown hook event: ${eventType}` }, 400);\n    }\n\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const sessionId = typeof body.session_id === \"string\" ? body.session_id : \"unknown\";\n\n    // Runner correlation: when a ClaudeCodeRunner spawned this CC session it\n    // tags every hook POST with `x-ap-runner-correlation-id`. We preserve the\n    // raw hook (PreCompact, PermissionRequest, etc. give value the runner\n    // doesn't emit) but SKIP deriving `agent.tool.start`/`agent.tool.end`\n    // events to avoid double-counting alongside the runner's own tool events.\n    const runnerCorrelationId =\n      c.req.header(\"x-ap-runner-correlation-id\") ?? undefined;\n\n    const hookEvent: ClaudeCodeHookEvent = {\n      type: \"claude_code.hook\",\n      traceId: sessionId,\n      runId: sessionId,\n      spanId: newSpanId(),\n      timestamp: new Date(),\n      hookName: eventType,\n      sessionId,\n      transcriptPath:\n        typeof body.transcript_path === \"string\" ? body.transcript_path : undefined,\n      cwd: typeof body.cwd === \"string\" ? body.cwd : undefined,\n      permissionMode:\n        typeof body.permission_mode === \"string\" ? body.permission_mode : undefined,\n      toolName: typeof body.tool_name === \"string\" ? body.tool_name : undefined,\n      toolInput: body.tool_input,\n      toolResponse: body.tool_response,\n      toolUseId: typeof body.tool_use_id === \"string\" ? body.tool_use_id : undefined,\n      payload: body,\n      ...(runnerCorrelationId ? { runnerCorrelationId } : {}),\n    };\n\n    await eventBus.publish(hookEvent);\n\n    if (!runnerCorrelationId) {\n      const derived = mapClaudeCodeHookToAgentEvents(hookEvent);\n      for (const e of derived) {\n        await eventBus.publish(e);\n      }\n    }\n\n    return c.json({ ok: true });\n  });\n\n  return app;\n}\n"],"mappings":"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","names":["Hono","Hono","Hono","Hono","Hono","Hono","Hono"]}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@agentic-patterns/server",
+  "version": "0.1.0",
+  "description": "Hono HTTP server for agentic-patterns agents — routes, SSE streaming, admin API",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pattern-stack/agentic-patterns-ts.git",
+    "directory": "packages/agent-server"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "agents",
+    "llm",
+    "ai",
+    "server",
+    "hono",
+    "sse"
+  ],
+  "homepage": "https://github.com/pattern-stack/agentic-patterns-ts",
+  "bugs": "https://github.com/pattern-stack/agentic-patterns-ts/issues",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "hono": "^4.0.0",
+    "@agentic-patterns/core": "0.1.0",
+    "@agentic-patterns/runtime": "0.1.0"
+  },
+  "devDependencies": {
+    "@hono/node-server": "^1.13.0",
+    "@types/node": "^25.6.0",
+    "tsup": "^8.3.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "zod": "^3.23.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.23.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "biome check src/",
+    "demo": "tsx examples/live-demo.ts",
+    "dev": "tsx --watch examples/live-demo.ts"
+  }
+}