@graphorin/server 0.5.0

package/dist/routes/mcp.d.ts

@@ -0,0 +1,32 @@
+import { ServerVariables } from "../internal/context.js";
+import { Hono } from "hono";
+
+//#region src/routes/mcp.d.ts
+
+/**
+ * @stable
+ */
+interface McpApi {
+  list(): Promise<ReadonlyArray<unknown>>;
+  register(input: {
+    readonly id: string;
+    readonly transport: string;
+    readonly url?: string;
+  }): Promise<unknown>;
+  remove(id: string): Promise<boolean>;
+}
+/**
+ * @stable
+ */
+interface McpRoutesDeps {
+  readonly mcp: McpApi;
+}
+/**
+ * @stable
+ */
+declare function createMcpRoutes(deps: McpRoutesDeps): Hono<{
+  Variables: ServerVariables;
+}>;
+//#endregion
+export { McpApi, McpRoutesDeps, createMcpRoutes };
+//# sourceMappingURL=mcp.d.ts.map

package/dist/routes/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","names":[],"sources":["../../src/routes/mcp.ts"],"sourcesContent":[],"mappings":";;;;;AAgDA;;;AAAsD,UA5BrC,MAAA,CA4BqC;EAAI,IAAA,EAAA,EA3BhD,OA2BgD,CA3BxC,aA2BwC,CAAA,OAAA,CAAA,CAAA;;;;;MAtBpD;sBACgB;;;;;UAcL,aAAA;gBACD;;;;;iBAMA,eAAA,OAAsB,gBAAgB;aAAkB"}

package/dist/routes/mcp.js

@@ -0,0 +1,61 @@
+import { createScopeMiddleware } from "../middleware/scope.js";
+import { Hono } from "hono";
+import { z } from "zod";
+
+//#region src/routes/mcp.ts
+const RegisterBodySchema = z.object({
+	id: z.string().min(1),
+	transport: z.enum([
+		"stdio",
+		"streamable-http",
+		"sse"
+	]),
+	url: z.string().min(1).optional()
+}).strict();
+/**
+* @stable
+*/
+function createMcpRoutes(deps) {
+	const app = new Hono();
+	app.get("/servers", createScopeMiddleware("mcp:admin"), async (c) => {
+		return c.json({ servers: await deps.mcp.list() });
+	});
+	app.post("/servers", createScopeMiddleware("mcp:admin"), async (c) => {
+		const parsed = RegisterBodySchema.safeParse(await safelyParseJson(c));
+		if (!parsed.success) return c.json({
+			error: "config-invalid",
+			message: "Invalid MCP server body.",
+			issues: parsed.error.issues.map((i) => ({
+				path: i.path,
+				message: i.message
+			}))
+		}, 400);
+		const payload = {
+			id: parsed.data.id,
+			transport: parsed.data.transport
+		};
+		if (parsed.data.url !== void 0) payload.url = parsed.data.url;
+		const out = await deps.mcp.register(payload);
+		return c.json({ server: out }, 201);
+	});
+	app.delete("/servers/:id", createScopeMiddleware("mcp:admin"), async (c) => {
+		const id = c.req.param("id");
+		if (!await deps.mcp.remove(id)) return c.json({
+			error: "mcp-server-not-found",
+			message: `MCP server '${id}' not found.`
+		}, 404);
+		return c.body(null, 204);
+	});
+	return app;
+}
+async function safelyParseJson(c) {
+	try {
+		return await c.req.json();
+	} catch {
+		return {};
+	}
+}
+
+//#endregion
+export { createMcpRoutes };
+//# sourceMappingURL=mcp.js.map

package/dist/routes/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","names":["payload: { id: string; transport: string; url?: string }"],"sources":["../../src/routes/mcp.ts"],"sourcesContent":["/**\n * MCP server-management REST routes.\n *\n *   GET    /mcp/servers                (scope `mcp:admin`)\n *   POST   /mcp/servers                (idempotent; scope `mcp:admin`)\n *   DELETE /mcp/servers/:id            (scope `mcp:admin`)\n *\n * @packageDocumentation\n */\n\nimport type { Context } from 'hono';\nimport { Hono } from 'hono';\nimport { z } from 'zod';\n\nimport type { ServerVariables } from '../internal/context.js';\nimport { createScopeMiddleware } from '../middleware/scope.js';\n\n/**\n * @stable\n */\nexport interface McpApi {\n  list(): Promise<ReadonlyArray<unknown>>;\n  register(input: {\n    readonly id: string;\n    readonly transport: string;\n    readonly url?: string;\n  }): Promise<unknown>;\n  remove(id: string): Promise<boolean>;\n}\n\nconst RegisterBodySchema = z\n  .object({\n    id: z.string().min(1),\n    transport: z.enum(['stdio', 'streamable-http', 'sse']),\n    url: z.string().min(1).optional(),\n  })\n  .strict();\n\n/**\n * @stable\n */\nexport interface McpRoutesDeps {\n  readonly mcp: McpApi;\n}\n\n/**\n * @stable\n */\nexport function createMcpRoutes(deps: McpRoutesDeps): Hono<{ Variables: ServerVariables }> {\n  const app = new Hono<{ Variables: ServerVariables }>();\n\n  app.get('/servers', createScopeMiddleware('mcp:admin'), async (c) => {\n    return c.json({ servers: await deps.mcp.list() });\n  });\n\n  app.post('/servers', createScopeMiddleware('mcp:admin'), async (c) => {\n    const parsed = RegisterBodySchema.safeParse(await safelyParseJson(c));\n    if (!parsed.success) {\n      return c.json(\n        {\n          error: 'config-invalid',\n          message: 'Invalid MCP server body.',\n          issues: parsed.error.issues.map((i) => ({ path: i.path, message: i.message })),\n        },\n        400,\n      );\n    }\n    const payload: { id: string; transport: string; url?: string } = {\n      id: parsed.data.id,\n      transport: parsed.data.transport,\n    };\n    if (parsed.data.url !== undefined) payload.url = parsed.data.url;\n    const out = await deps.mcp.register(payload);\n    return c.json({ server: out }, 201);\n  });\n\n  app.delete('/servers/:id', createScopeMiddleware('mcp:admin'), async (c) => {\n    const id = c.req.param('id');\n    const removed = await deps.mcp.remove(id);\n    if (!removed)\n      return c.json(\n        { error: 'mcp-server-not-found', message: `MCP server '${id}' not found.` },\n        404,\n      );\n    return c.body(null, 204);\n  });\n\n  return app;\n}\n\nasync function safelyParseJson(c: Context<{ Variables: ServerVariables }>): Promise<unknown> {\n  try {\n    return await c.req.json();\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;;;;AA8BA,MAAM,qBAAqB,EACxB,OAAO;CACN,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;CACrB,WAAW,EAAE,KAAK;EAAC;EAAS;EAAmB;EAAM,CAAC;CACtD,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CAClC,CAAC,CACD,QAAQ;;;;AAYX,SAAgB,gBAAgB,MAA2D;CACzF,MAAM,MAAM,IAAI,MAAsC;AAEtD,KAAI,IAAI,YAAY,sBAAsB,YAAY,EAAE,OAAO,MAAM;AACnE,SAAO,EAAE,KAAK,EAAE,SAAS,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;GACjD;AAEF,KAAI,KAAK,YAAY,sBAAsB,YAAY,EAAE,OAAO,MAAM;EACpE,MAAM,SAAS,mBAAmB,UAAU,MAAM,gBAAgB,EAAE,CAAC;AACrE,MAAI,CAAC,OAAO,QACV,QAAO,EAAE,KACP;GACE,OAAO;GACP,SAAS;GACT,QAAQ,OAAO,MAAM,OAAO,KAAK,OAAO;IAAE,MAAM,EAAE;IAAM,SAAS,EAAE;IAAS,EAAE;GAC/E,EACD,IACD;EAEH,MAAMA,UAA2D;GAC/D,IAAI,OAAO,KAAK;GAChB,WAAW,OAAO,KAAK;GACxB;AACD,MAAI,OAAO,KAAK,QAAQ,OAAW,SAAQ,MAAM,OAAO,KAAK;EAC7D,MAAM,MAAM,MAAM,KAAK,IAAI,SAAS,QAAQ;AAC5C,SAAO,EAAE,KAAK,EAAE,QAAQ,KAAK,EAAE,IAAI;GACnC;AAEF,KAAI,OAAO,gBAAgB,sBAAsB,YAAY,EAAE,OAAO,MAAM;EAC1E,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK;AAE5B,MAAI,CADY,MAAM,KAAK,IAAI,OAAO,GAAG,CAEvC,QAAO,EAAE,KACP;GAAE,OAAO;GAAwB,SAAS,eAAe,GAAG;GAAe,EAC3E,IACD;AACH,SAAO,EAAE,KAAK,MAAM,IAAI;GACxB;AAEF,QAAO;;AAGT,eAAe,gBAAgB,GAA8D;AAC3F,KAAI;AACF,SAAO,MAAM,EAAE,IAAI,MAAM;SACnB;AACN,SAAO,EAAE"}

package/dist/routes/memory.d.ts

@@ -0,0 +1,141 @@
+import { ServerVariables } from "../internal/context.js";
+import { Hono } from "hono";
+import { z } from "zod";
+
+//#region src/routes/memory.d.ts
+
+declare const SearchBodySchema: z.ZodObject<{
+  scope: z.ZodObject<{
+    userId: z.ZodString;
+    agentId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+  }, "strict", z.ZodTypeAny, {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  }, {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  }>;
+  query: z.ZodString;
+  topK: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+  scope: {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  };
+  query: string;
+  topK?: number | undefined;
+}, {
+  scope: {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  };
+  query: string;
+  topK?: number | undefined;
+}>;
+declare const RememberBodySchema: z.ZodObject<{
+  scope: z.ZodObject<{
+    userId: z.ZodString;
+    agentId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+  }, "strict", z.ZodTypeAny, {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  }, {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  }>;
+  text: z.ZodString;
+  sensitivity: z.ZodOptional<z.ZodEnum<["public", "internal", "secret"]>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+  scope: {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  };
+  text: string;
+  sensitivity?: "public" | "internal" | "secret" | undefined;
+  metadata?: Record<string, unknown> | undefined;
+}, {
+  scope: {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  };
+  text: string;
+  sensitivity?: "public" | "internal" | "secret" | undefined;
+  metadata?: Record<string, unknown> | undefined;
+}>;
+declare const BlockBodySchema: z.ZodObject<{
+  scope: z.ZodObject<{
+    userId: z.ZodString;
+    agentId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+  }, "strict", z.ZodTypeAny, {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  }, {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  }>;
+  label: z.ZodString;
+  body: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+  scope: {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  };
+  label: string;
+  body: string;
+}, {
+  scope: {
+    userId: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+  };
+  label: string;
+  body: string;
+}>;
+/**
+ * @stable
+ */
+interface MemoryApi {
+  search(input: z.infer<typeof SearchBodySchema>): Promise<ReadonlyArray<unknown>>;
+  remember(input: z.infer<typeof RememberBodySchema>): Promise<{
+    readonly factId: string;
+  }>;
+  forget(scope: {
+    readonly userId: string;
+  }, factId: string): Promise<boolean>;
+  upsertBlock(input: z.infer<typeof BlockBodySchema>): Promise<{
+    readonly label: string;
+  }>;
+  deleteBlock(scope: {
+    readonly userId: string;
+  }, label: string): Promise<boolean>;
+}
+/**
+ * @stable
+ */
+interface MemoryRoutesDeps {
+  readonly memory: MemoryApi;
+}
+/**
+ * @stable
+ */
+declare function createMemoryRoutes(deps: MemoryRoutesDeps): Hono<{
+  Variables: ServerVariables;
+}>;
+//#endregion
+export { MemoryApi, MemoryRoutesDeps, createMemoryRoutes };
+//# sourceMappingURL=memory.d.ts.map

package/dist/routes/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","names":[],"sources":["../../src/routes/memory.ts"],"sourcesContent":[],"mappings":";;;;;;cA6BM,kBAAgB,CAAA,CAAA;EAAA,KAAA,aAAA,CAAA;IAAA,MAAA,aAAA;IAQhB,OAAA,eAOK,YAAA,CAAA;;;;;;;;;;;;;;;;;;EAPa,CAAA;EAAA,KAAA,EAAA,MAAA;EASlB,IAAA,CAAA,EAAA,MAAA,GAAA,SAMK;;;;;;;;;;cAfL,oBAAkB,CAAA,CAAA;EASH,KAAA,aAAA,CAAA;IAAA,MAAA,aAAA;IAWJ,OAAA,eAAS,YAAA,CAAA;IACK,SAAA,eAAA,YAAA,CAAA;EAAb,CAAA,EAAA,QAAA,cAAA,EAAA;IAAyC,MAAA,EAAA,MAAA;IAAR,OAAA,CAAA,EAAA,MAAA,GAAA,SAAA;IAClB,SAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAb,CAAA,EAAA;IAAmC,MAAA,EAAA,MAAA;IACO,OAAA,CAAA,EAAA,MAAA,GAAA,SAAA;IAC1B,SAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAb,CAAA,CAAA;EAAgC,IAAA,aAAA;EACW,WAAA,eAAA,UAAA,CAAA,CAAA,QAAA,EAAA,UAAA,EAAA,QAAA,CAAA,CAAA,CAAA;EAAO,QAAA,eAAA,YAAA,YAAA,cAAA,CAAA,CAAA;AAMzE,CAAA,EAAA,QAAiB,cAAgB,EAAA;EAOjB,KAAA,EAAA;IAAyB,MAAA,EAAA,MAAA;IAAqC,OAAA,CAAA,EAAA,MAAA,GAAA,SAAA;IAAlB,SAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAI,CAAA;;;;;;;;;;;;;;cA7B1D,iBAAe,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAWJ,SAAA;gBACD,CAAA,CAAE,aAAa,oBAAoB,QAAQ;kBACzC,CAAA,CAAE,aAAa,sBAAsB;;;;;sBACO;qBACzC,CAAA,CAAE,aAAa,mBAAmB;;;;;qBACW;;;;;UAMjD,gBAAA;mBACE;;;;;iBAMH,kBAAA,OAAyB,mBAAmB;aAAkB"}

package/dist/routes/memory.js

@@ -0,0 +1,102 @@
+import { createScopeMiddleware } from "../middleware/scope.js";
+import { Hono } from "hono";
+import { z } from "zod";
+
+//#region src/routes/memory.ts
+const ScopeSchema = z.object({
+	userId: z.string().min(1),
+	agentId: z.string().min(1).optional(),
+	sessionId: z.string().min(1).optional()
+}).strict();
+const SearchBodySchema = z.object({
+	scope: ScopeSchema,
+	query: z.string().min(1),
+	topK: z.number().int().positive().max(200).optional()
+}).strict();
+const RememberBodySchema = z.object({
+	scope: ScopeSchema,
+	text: z.string().min(1),
+	sensitivity: z.enum([
+		"public",
+		"internal",
+		"secret"
+	]).optional(),
+	metadata: z.record(z.string(), z.unknown()).optional()
+}).strict();
+const BlockBodySchema = z.object({
+	scope: ScopeSchema,
+	label: z.string().min(1),
+	body: z.string()
+}).strict();
+/**
+* @stable
+*/
+function createMemoryRoutes(deps) {
+	const app = new Hono();
+	app.post("/search", createScopeMiddleware("memory:read"), async (c) => {
+		const parsed = SearchBodySchema.safeParse(await safelyParseJson(c));
+		if (!parsed.success) return invalid(c, parsed.error.issues);
+		const hits = await deps.memory.search(parsed.data);
+		return c.json({ hits });
+	});
+	app.post("/facts", createScopeMiddleware("memory:write"), async (c) => {
+		const parsed = RememberBodySchema.safeParse(await safelyParseJson(c));
+		if (!parsed.success) return invalid(c, parsed.error.issues);
+		const out = await deps.memory.remember(parsed.data);
+		return c.json({ fact: out }, 201);
+	});
+	app.delete("/facts/:id", createScopeMiddleware("memory:write"), async (c) => {
+		const id = c.req.param("id");
+		const userId = c.req.query("userId");
+		if (userId === void 0 || userId.length === 0) return c.json({
+			error: "config-invalid",
+			message: "Query parameter `userId` is required."
+		}, 400);
+		if (!await deps.memory.forget({ userId }, id)) return c.json({
+			error: "fact-not-found",
+			message: `Fact '${id}' not found.`
+		}, 404);
+		return c.body(null, 204);
+	});
+	app.post("/blocks", createScopeMiddleware("memory:write"), async (c) => {
+		const parsed = BlockBodySchema.safeParse(await safelyParseJson(c));
+		if (!parsed.success) return invalid(c, parsed.error.issues);
+		const out = await deps.memory.upsertBlock(parsed.data);
+		return c.json({ block: out }, 201);
+	});
+	app.delete("/blocks/:label", createScopeMiddleware("memory:write"), async (c) => {
+		const label = c.req.param("label");
+		const userId = c.req.query("userId");
+		if (userId === void 0 || userId.length === 0) return c.json({
+			error: "config-invalid",
+			message: "Query parameter `userId` is required."
+		}, 400);
+		if (!await deps.memory.deleteBlock({ userId }, label)) return c.json({
+			error: "block-not-found",
+			message: `Block '${label}' not found.`
+		}, 404);
+		return c.body(null, 204);
+	});
+	return app;
+}
+function invalid(c, issues) {
+	return c.json({
+		error: "config-invalid",
+		message: "Invalid request body.",
+		issues: issues.map((i) => ({
+			path: i.path,
+			message: i.message
+		}))
+	}, 400);
+}
+async function safelyParseJson(c) {
+	try {
+		return await c.req.json();
+	} catch {
+		return {};
+	}
+}
+
+//#endregion
+export { createMemoryRoutes };
+//# sourceMappingURL=memory.js.map

package/dist/routes/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","names":[],"sources":["../../src/routes/memory.ts"],"sourcesContent":["/**\n * Memory REST routes. The handlers delegate to a structurally-typed\n * `MemoryApi` provided by the operator (in practice, a thin shim\n * around `@graphorin/memory.createMemory({...})`).\n *\n *   POST   /memory/search              (scope `memory:read`)\n *   POST   /memory/facts               (idempotent; scope `memory:write`)\n *   DELETE /memory/facts/:id           (scope `memory:write`)\n *   POST   /memory/blocks              (idempotent; scope `memory:write`)\n *   DELETE /memory/blocks/:label       (scope `memory:write`)\n *\n * @packageDocumentation\n */\n\nimport type { Context } from 'hono';\nimport { Hono } from 'hono';\nimport { z } from 'zod';\n\nimport type { ServerVariables } from '../internal/context.js';\nimport { createScopeMiddleware } from '../middleware/scope.js';\n\nconst ScopeSchema = z\n  .object({\n    userId: z.string().min(1),\n    agentId: z.string().min(1).optional(),\n    sessionId: z.string().min(1).optional(),\n  })\n  .strict();\n\nconst SearchBodySchema = z\n  .object({\n    scope: ScopeSchema,\n    query: z.string().min(1),\n    topK: z.number().int().positive().max(200).optional(),\n  })\n  .strict();\n\nconst RememberBodySchema = z\n  .object({\n    scope: ScopeSchema,\n    text: z.string().min(1),\n    sensitivity: z.enum(['public', 'internal', 'secret']).optional(),\n    metadata: z.record(z.string(), z.unknown()).optional(),\n  })\n  .strict();\n\nconst BlockBodySchema = z\n  .object({\n    scope: ScopeSchema,\n    label: z.string().min(1),\n    body: z.string(),\n  })\n  .strict();\n\n/**\n * @stable\n */\nexport interface MemoryApi {\n  search(input: z.infer<typeof SearchBodySchema>): Promise<ReadonlyArray<unknown>>;\n  remember(input: z.infer<typeof RememberBodySchema>): Promise<{ readonly factId: string }>;\n  forget(scope: { readonly userId: string }, factId: string): Promise<boolean>;\n  upsertBlock(input: z.infer<typeof BlockBodySchema>): Promise<{ readonly label: string }>;\n  deleteBlock(scope: { readonly userId: string }, label: string): Promise<boolean>;\n}\n\n/**\n * @stable\n */\nexport interface MemoryRoutesDeps {\n  readonly memory: MemoryApi;\n}\n\n/**\n * @stable\n */\nexport function createMemoryRoutes(deps: MemoryRoutesDeps): Hono<{ Variables: ServerVariables }> {\n  const app = new Hono<{ Variables: ServerVariables }>();\n\n  app.post('/search', createScopeMiddleware('memory:read'), async (c) => {\n    const parsed = SearchBodySchema.safeParse(await safelyParseJson(c));\n    if (!parsed.success) {\n      return invalid(c, parsed.error.issues);\n    }\n    const hits = await deps.memory.search(parsed.data);\n    return c.json({ hits });\n  });\n\n  app.post('/facts', createScopeMiddleware('memory:write'), async (c) => {\n    const parsed = RememberBodySchema.safeParse(await safelyParseJson(c));\n    if (!parsed.success) return invalid(c, parsed.error.issues);\n    const out = await deps.memory.remember(parsed.data);\n    return c.json({ fact: out }, 201);\n  });\n\n  app.delete('/facts/:id', createScopeMiddleware('memory:write'), async (c) => {\n    const id = c.req.param('id');\n    const userId = c.req.query('userId');\n    if (userId === undefined || userId.length === 0) {\n      return c.json(\n        { error: 'config-invalid', message: 'Query parameter `userId` is required.' },\n        400,\n      );\n    }\n    const removed = await deps.memory.forget({ userId }, id);\n    if (!removed)\n      return c.json({ error: 'fact-not-found', message: `Fact '${id}' not found.` }, 404);\n    return c.body(null, 204);\n  });\n\n  app.post('/blocks', createScopeMiddleware('memory:write'), async (c) => {\n    const parsed = BlockBodySchema.safeParse(await safelyParseJson(c));\n    if (!parsed.success) return invalid(c, parsed.error.issues);\n    const out = await deps.memory.upsertBlock(parsed.data);\n    return c.json({ block: out }, 201);\n  });\n\n  app.delete('/blocks/:label', createScopeMiddleware('memory:write'), async (c) => {\n    const label = c.req.param('label');\n    const userId = c.req.query('userId');\n    if (userId === undefined || userId.length === 0) {\n      return c.json(\n        { error: 'config-invalid', message: 'Query parameter `userId` is required.' },\n        400,\n      );\n    }\n    const removed = await deps.memory.deleteBlock({ userId }, label);\n    if (!removed)\n      return c.json({ error: 'block-not-found', message: `Block '${label}' not found.` }, 404);\n    return c.body(null, 204);\n  });\n\n  return app;\n}\n\nfunction invalid(c: Context<{ Variables: ServerVariables }>, issues: ReadonlyArray<z.ZodIssue>) {\n  return c.json(\n    {\n      error: 'config-invalid',\n      message: 'Invalid request body.',\n      issues: issues.map((i) => ({ path: i.path, message: i.message })),\n    },\n    400,\n  );\n}\n\nasync function safelyParseJson(c: Context<{ Variables: ServerVariables }>): Promise<unknown> {\n  try {\n    return await c.req.json();\n  } catch {\n    return {};\n  }\n}\n"],"mappings":"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"}

package/dist/routes/sessions.d.ts

@@ -0,0 +1,54 @@
+import { ServerVariables } from "../internal/context.js";
+import { Hono } from "hono";
+
+//#region src/routes/sessions.d.ts
+
+/**
+ * Minimal contract route handlers consume. Real deployments wire
+ * `@graphorin/sessions.SessionManager` in directly; tests pass a
+ * lighter stub.
+ *
+ * @stable
+ */
+interface SessionApi {
+  list(opts: {
+    readonly userId?: string;
+    readonly agentId?: string;
+  }): Promise<ReadonlyArray<unknown>>;
+  get(sessionId: string): Promise<unknown | null>;
+  create(input: {
+    readonly userId: string;
+    readonly agentId: string;
+    readonly sessionId?: string;
+    readonly title?: string;
+    readonly tags?: ReadonlyArray<string>;
+  }): Promise<unknown>;
+  remove(sessionId: string): Promise<boolean>;
+  listMessages(sessionId: string, opts: {
+    readonly limit?: number;
+  }): Promise<ReadonlyArray<unknown>>;
+  listHandoffs(sessionId: string): Promise<ReadonlyArray<unknown>>;
+  exportSession?(sessionId: string, opts: {
+    readonly includeAuditEntries?: boolean;
+    readonly hash?: boolean;
+  }): Promise<unknown>;
+  replaySession?(sessionId: string, opts: {
+    readonly raw?: boolean;
+    readonly fromMessageId?: string;
+  }): AsyncIterable<unknown>;
+}
+/**
+ * @stable
+ */
+interface SessionRoutesDeps {
+  readonly sessions: SessionApi;
+}
+/**
+ * @stable
+ */
+declare function createSessionRoutes(deps: SessionRoutesDeps): Hono<{
+  Variables: ServerVariables;
+}>;
+//#endregion
+export { SessionApi, SessionRoutesDeps, createSessionRoutes };
+//# sourceMappingURL=sessions.d.ts.map

package/dist/routes/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","names":[],"sources":["../../src/routes/sessions.ts"],"sourcesContent":[],"mappings":";;;;;AAkGA;AAOA;;;;;;UA1EiB,UAAA;;;;MAIX,QAAQ;0BACY;;;;;;oBAMN;MACd;6BACuB;;;MAIxB,QAAQ;mCACsB,QAAQ;;;;MAOtC;;;;MAIA;;;;;UAsCY,iBAAA;qBACI;;;;;iBAML,mBAAA,OAA0B,oBAAoB;aAAkB"}

package/dist/routes/sessions.js

@@ -0,0 +1,135 @@
+import { createScopeMiddleware } from "../middleware/scope.js";
+import { Hono } from "hono";
+import { z } from "zod";
+
+//#region src/routes/sessions.ts
+const CreateBodySchema = z.object({
+	userId: z.string().min(1),
+	agentId: z.string().min(1),
+	sessionId: z.string().min(1).optional(),
+	title: z.string().min(1).optional(),
+	tags: z.array(z.string()).optional()
+}).strict();
+const MessagesQuerySchema = z.object({ limit: z.coerce.number().int().positive().max(1e3).optional() }).strict();
+const ExportBodySchema = z.object({
+	includeAuditEntries: z.boolean().optional(),
+	hash: z.boolean().optional()
+}).strict().default({});
+z.object({
+	raw: z.boolean().optional(),
+	fromMessageId: z.string().min(1).optional()
+}).strict().default({});
+/**
+* @stable
+*/
+function createSessionRoutes(deps) {
+	const app = new Hono();
+	app.get("/", createScopeMiddleware("sessions:read"), async (c) => {
+		const userId = c.req.query("userId");
+		const agentId = c.req.query("agentId");
+		const filter = {};
+		if (userId !== void 0 && userId.length > 0) filter.userId = userId;
+		if (agentId !== void 0 && agentId.length > 0) filter.agentId = agentId;
+		const list = await deps.sessions.list(filter);
+		return c.json({ sessions: list });
+	});
+	app.post("/", createScopeMiddleware("sessions:write"), async (c) => {
+		const parsed = CreateBodySchema.safeParse(await safelyParseJson(c));
+		if (!parsed.success) return c.json({
+			error: "config-invalid",
+			message: "Invalid session body.",
+			issues: parsed.error.issues.map((i) => ({
+				path: i.path,
+				message: i.message
+			}))
+		}, 400);
+		const session = await deps.sessions.create({
+			userId: parsed.data.userId,
+			agentId: parsed.data.agentId,
+			...parsed.data.sessionId !== void 0 ? { sessionId: parsed.data.sessionId } : {},
+			...parsed.data.title !== void 0 ? { title: parsed.data.title } : {},
+			...parsed.data.tags !== void 0 ? { tags: parsed.data.tags } : {}
+		});
+		return c.json({ session }, 201);
+	});
+	app.get("/:id", createScopeMiddleware("sessions:read"), async (c) => {
+		const id = c.req.param("id");
+		const session = await deps.sessions.get(id);
+		if (session === null) return c.json({
+			error: "session-not-found",
+			message: `Session '${id}' not found.`
+		}, 404);
+		return c.json({ session });
+	});
+	app.delete("/:id", createScopeMiddleware("sessions:write"), async (c) => {
+		const id = c.req.param("id");
+		if (!await deps.sessions.remove(id)) return c.json({
+			error: "session-not-found",
+			message: `Session '${id}' not found.`
+		}, 404);
+		return c.body(null, 204);
+	});
+	app.get("/:id/messages", createScopeMiddleware("sessions:read"), async (c) => {
+		const id = c.req.param("id");
+		const parsed = MessagesQuerySchema.safeParse({ limit: c.req.query("limit") });
+		if (!parsed.success) return c.json({
+			error: "config-invalid",
+			message: "Invalid messages query.",
+			issues: parsed.error.issues.map((i) => ({
+				path: i.path,
+				message: i.message
+			}))
+		}, 400);
+		const opts = {};
+		if (parsed.data.limit !== void 0) opts.limit = parsed.data.limit;
+		const messages = await deps.sessions.listMessages(id, opts);
+		return c.json({
+			sessionId: id,
+			messages
+		});
+	});
+	app.get("/:id/handoffs", createScopeMiddleware("sessions:read"), async (c) => {
+		const id = c.req.param("id");
+		const handoffs = await deps.sessions.listHandoffs(id);
+		return c.json({
+			sessionId: id,
+			handoffs
+		});
+	});
+	app.post("/:id/export", createScopeMiddleware("sessions:export"), async (c) => {
+		const id = c.req.param("id");
+		if (deps.sessions.exportSession === void 0) return c.json({
+			error: "session-export-unsupported",
+			message: "Export is not enabled."
+		}, 400);
+		const parsed = ExportBodySchema.safeParse(await safelyParseJson(c));
+		if (!parsed.success) return c.json({
+			error: "config-invalid",
+			message: "Invalid export body.",
+			issues: parsed.error.issues.map((i) => ({
+				path: i.path,
+				message: i.message
+			}))
+		}, 400);
+		const exportOpts = {};
+		if (parsed.data.includeAuditEntries !== void 0) exportOpts.includeAuditEntries = parsed.data.includeAuditEntries;
+		if (parsed.data.hash !== void 0) exportOpts.hash = parsed.data.hash;
+		const result = await deps.sessions.exportSession(id, exportOpts);
+		return c.json({
+			sessionId: id,
+			export: result
+		});
+	});
+	return app;
+}
+async function safelyParseJson(c) {
+	try {
+		return await c.req.json();
+	} catch {
+		return {};
+	}
+}
+
+//#endregion
+export { createSessionRoutes };
+//# sourceMappingURL=sessions.js.map

package/dist/routes/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","names":["filter: { userId?: string; agentId?: string }","opts: { limit?: number }","exportOpts: { includeAuditEntries?: boolean; hash?: boolean }"],"sources":["../../src/routes/sessions.ts"],"sourcesContent":["/**\n * Session REST routes. Delegates to a structurally-typed `SessionApi`\n * supplied by the operator (in practice, the `@graphorin/sessions`\n * package's `SessionManager`); the contract is intentionally open so\n * tests can stub it without dragging the full sessions facade in.\n *\n *   GET    /sessions                     (scope `sessions:read`)\n *   GET    /sessions/:id                 (scope `sessions:read`)\n *   POST   /sessions                     (idempotent; scope `sessions:write`)\n *   DELETE /sessions/:id                 (scope `sessions:write`)\n *   GET    /sessions/:id/messages        (scope `sessions:read`)\n *   GET    /sessions/:id/handoffs        (scope `sessions:read`)\n *   POST   /sessions/:id/export          (scope `sessions:export`)\n *\n * @packageDocumentation\n */\n\nimport type { Context } from 'hono';\nimport { Hono } from 'hono';\nimport { z } from 'zod';\n\nimport type { ServerVariables } from '../internal/context.js';\nimport { createScopeMiddleware } from '../middleware/scope.js';\n\n/**\n * Minimal contract route handlers consume. Real deployments wire\n * `@graphorin/sessions.SessionManager` in directly; tests pass a\n * lighter stub.\n *\n * @stable\n */\nexport interface SessionApi {\n  list(opts: {\n    readonly userId?: string;\n    readonly agentId?: string;\n  }): Promise<ReadonlyArray<unknown>>;\n  get(sessionId: string): Promise<unknown | null>;\n  create(input: {\n    readonly userId: string;\n    readonly agentId: string;\n    readonly sessionId?: string;\n    readonly title?: string;\n    readonly tags?: ReadonlyArray<string>;\n  }): Promise<unknown>;\n  remove(sessionId: string): Promise<boolean>;\n  listMessages(\n    sessionId: string,\n    opts: { readonly limit?: number },\n  ): Promise<ReadonlyArray<unknown>>;\n  listHandoffs(sessionId: string): Promise<ReadonlyArray<unknown>>;\n  exportSession?(\n    sessionId: string,\n    opts: {\n      readonly includeAuditEntries?: boolean;\n      readonly hash?: boolean;\n    },\n  ): Promise<unknown>;\n  replaySession?(\n    sessionId: string,\n    opts: { readonly raw?: boolean; readonly fromMessageId?: string },\n  ): AsyncIterable<unknown>;\n}\n\nconst CreateBodySchema = z\n  .object({\n    userId: z.string().min(1),\n    agentId: z.string().min(1),\n    sessionId: z.string().min(1).optional(),\n    title: z.string().min(1).optional(),\n    tags: z.array(z.string()).optional(),\n  })\n  .strict();\n\nconst MessagesQuerySchema = z\n  .object({\n    limit: z.coerce.number().int().positive().max(1000).optional(),\n  })\n  .strict();\n\nconst ExportBodySchema = z\n  .object({\n    includeAuditEntries: z.boolean().optional(),\n    hash: z.boolean().optional(),\n  })\n  .strict()\n  .default({});\n\nconst _ReplayBodySchema = z\n  .object({\n    raw: z.boolean().optional(),\n    fromMessageId: z.string().min(1).optional(),\n  })\n  .strict()\n  .default({});\n\n/**\n * @stable\n */\nexport interface SessionRoutesDeps {\n  readonly sessions: SessionApi;\n}\n\n/**\n * @stable\n */\nexport function createSessionRoutes(deps: SessionRoutesDeps): Hono<{ Variables: ServerVariables }> {\n  const app = new Hono<{ Variables: ServerVariables }>();\n\n  app.get('/', createScopeMiddleware('sessions:read'), async (c) => {\n    const userId = c.req.query('userId');\n    const agentId = c.req.query('agentId');\n    const filter: { userId?: string; agentId?: string } = {};\n    if (userId !== undefined && userId.length > 0) filter.userId = userId;\n    if (agentId !== undefined && agentId.length > 0) filter.agentId = agentId;\n    const list = await deps.sessions.list(filter);\n    return c.json({ sessions: list });\n  });\n\n  app.post('/', createScopeMiddleware('sessions:write'), async (c) => {\n    const parsed = CreateBodySchema.safeParse(await safelyParseJson(c));\n    if (!parsed.success) {\n      return c.json(\n        {\n          error: 'config-invalid',\n          message: 'Invalid session body.',\n          issues: parsed.error.issues.map((i) => ({ path: i.path, message: i.message })),\n        },\n        400,\n      );\n    }\n    const session = await deps.sessions.create({\n      userId: parsed.data.userId,\n      agentId: parsed.data.agentId,\n      ...(parsed.data.sessionId !== undefined ? { sessionId: parsed.data.sessionId } : {}),\n      ...(parsed.data.title !== undefined ? { title: parsed.data.title } : {}),\n      ...(parsed.data.tags !== undefined ? { tags: parsed.data.tags } : {}),\n    });\n    return c.json({ session }, 201);\n  });\n\n  app.get('/:id', createScopeMiddleware('sessions:read'), async (c) => {\n    const id = c.req.param('id');\n    const session = await deps.sessions.get(id);\n    if (session === null) {\n      return c.json({ error: 'session-not-found', message: `Session '${id}' not found.` }, 404);\n    }\n    return c.json({ session });\n  });\n\n  app.delete('/:id', createScopeMiddleware('sessions:write'), async (c) => {\n    const id = c.req.param('id');\n    const removed = await deps.sessions.remove(id);\n    if (!removed) {\n      return c.json({ error: 'session-not-found', message: `Session '${id}' not found.` }, 404);\n    }\n    return c.body(null, 204);\n  });\n\n  app.get('/:id/messages', createScopeMiddleware('sessions:read'), async (c) => {\n    const id = c.req.param('id');\n    const parsed = MessagesQuerySchema.safeParse({ limit: c.req.query('limit') });\n    if (!parsed.success) {\n      return c.json(\n        {\n          error: 'config-invalid',\n          message: 'Invalid messages query.',\n          issues: parsed.error.issues.map((i) => ({ path: i.path, message: i.message })),\n        },\n        400,\n      );\n    }\n    const opts: { limit?: number } = {};\n    if (parsed.data.limit !== undefined) opts.limit = parsed.data.limit;\n    const messages = await deps.sessions.listMessages(id, opts);\n    return c.json({ sessionId: id, messages });\n  });\n\n  app.get('/:id/handoffs', createScopeMiddleware('sessions:read'), async (c) => {\n    const id = c.req.param('id');\n    const handoffs = await deps.sessions.listHandoffs(id);\n    return c.json({ sessionId: id, handoffs });\n  });\n\n  app.post('/:id/export', createScopeMiddleware('sessions:export'), async (c) => {\n    const id = c.req.param('id');\n    if (deps.sessions.exportSession === undefined) {\n      return c.json(\n        { error: 'session-export-unsupported', message: 'Export is not enabled.' },\n        400,\n      );\n    }\n    const parsed = ExportBodySchema.safeParse(await safelyParseJson(c));\n    if (!parsed.success) {\n      return c.json(\n        {\n          error: 'config-invalid',\n          message: 'Invalid export body.',\n          issues: parsed.error.issues.map((i) => ({ path: i.path, message: i.message })),\n        },\n        400,\n      );\n    }\n    const exportOpts: { includeAuditEntries?: boolean; hash?: boolean } = {};\n    if (parsed.data.includeAuditEntries !== undefined) {\n      exportOpts.includeAuditEntries = parsed.data.includeAuditEntries;\n    }\n    if (parsed.data.hash !== undefined) exportOpts.hash = parsed.data.hash;\n    const result = await deps.sessions.exportSession(id, exportOpts);\n    return c.json({ sessionId: id, export: result });\n  });\n\n  // IP-14: the session-replay route lives in `replay/routes.ts` (the\n  // scope-laddered, audit-backed implementation). The Phase-14a stub\n  // that lived here SHADOWED it (mounted earlier on the same path)\n  // while advertising a `session:<id>/replay` subject the WS grammar\n  // cannot parse — deleted.\n\n  return app;\n}\n\nasync function safelyParseJson(c: Context<{ Variables: ServerVariables }>): Promise<unknown> {\n  try {\n    return await c.req.json();\n  } catch {\n    return {};\n  }\n}\n"],"mappings":"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"}

package/dist/routes/skills.d.ts

@@ -0,0 +1,34 @@
+import { ServerVariables } from "../internal/context.js";
+import { Hono } from "hono";
+
+//#region src/routes/skills.d.ts
+
+/**
+ * @stable
+ */
+interface SkillsApi {
+  list(): Promise<ReadonlyArray<{
+    readonly name: string;
+    readonly version?: string;
+  }>>;
+  get(name: string): Promise<unknown | null>;
+  install(input: {
+    readonly source: string;
+    readonly trust?: 'verified' | 'unverified';
+  }): Promise<unknown>;
+}
+/**
+ * @stable
+ */
+interface SkillsRoutesDeps {
+  readonly skills: SkillsApi;
+}
+/**
+ * @stable
+ */
+declare function createSkillsRoutes(deps: SkillsRoutesDeps): Hono<{
+  Variables: ServerVariables;
+}>;
+//#endregion
+export { SkillsApi, SkillsRoutesDeps, createSkillsRoutes };
+//# sourceMappingURL=skills.d.ts.map

package/dist/routes/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","names":[],"sources":["../../src/routes/skills.ts"],"sourcesContent":[],"mappings":";;;;;AA8CA;;;AAA4D,UA1B3C,SAAA,CA0B2C;EAAI,IAAA,EAAA,EAzBtD,OAyBsD,CAzB9C,aAyB8C,CAAA;;;;qBAxB3C;;;;MAIf;;;;;UAaW,gBAAA;mBACE;;;;;iBAMH,kBAAA,OAAyB,mBAAmB;aAAkB"}