@undefineds.co/xpod 0.3.48 → 0.3.49

package/dist/api/handlers/ChatKitV1Handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatKitV1Handler.js","sourceRoot":"","sources":["../../../src/api/handlers/ChatKitV1Handler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ChatKit v1 (OpenAI-compatible) routes.\n *\n * This is a REST wrapper around our internal ChatKit store/service so that\n * clients expecting `/v1/chatkit/...` can work without speaking the single\n * `/v1/chatkit` protocol endpoint.\n *\n * Notes:\n * - We accept (but do not require) `OpenAI-Beta: chatkit_beta=v1`.\n * - Auth is handled by ApiServer middleware (same as other API routes).\n */\n\nimport type { ApiServer } from '../ApiServer';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport type { StoreContext, ChatKitStore } from '../chatkit/store';\nimport type { Page, ThreadItem, ThreadMetadata, ThreadRef } from '../chatkit/types';\nimport { toThreadRef } from '../chatkit/types';\nimport { getWebId, getAccountId } from '../auth/AuthContext';\n\nexport interface ChatKitV1HandlerOptions {\n  store: ChatKitStore<StoreContext>;\n}\n\ntype ChatKitThreadObject = ThreadMetadata & { object: 'chatkit.thread' };\ntype ChatKitThreadItemObject = ThreadItem & { object: 'chatkit.thread_item' };\n\nexport function registerChatKitV1Routes(server: ApiServer, options: ChatKitV1HandlerOptions): void {\n  const { store } = options;\n\n  const buildContext = (request: AuthenticatedRequest): StoreContext => {\n    const auth = request.auth;\n    const userId = auth ? (getWebId(auth) ?? getAccountId(auth) ?? 'anonymous') : 'anonymous';\n    return { userId, auth };\n  };\n\n  // GET /v1/chatkit/threads\n  server.get('/v1/chatkit/threads', async (request, response) => {\n    const url = new URL(request.url ?? '', `http://${request.headers.host}`);\n    const limit = parseOptionalInt(url.searchParams.get('limit')) ?? 20;\n    const after = url.searchParams.get('after') ?? undefined;\n    const order = (url.searchParams.get('order') ?? 'desc') as 'asc' | 'desc';\n\n    const page = await store.loadThreads(limit, after, order, buildContext(request));\n    const data: ChatKitThreadObject[] = page.data.map((t) => ({ ...t, object: 'chatkit.thread' }));\n\n    sendJson(response, 200, {\n      object: 'list',\n      data,\n      has_more: page.has_more,\n      after: page.after,\n    });\n  });\n\n  // GET /v1/chatkit/threads/:thread_id\n  server.get('/v1/chatkit/threads/:thread_id', async (request, response, params) => {\n    const threadRef = getThreadRefFromRequest(request, response, params.thread_id);\n    if (!threadRef) {\n      return;\n    }\n    const ctx = buildContext(request);\n    const thread = await store.loadThread(threadRef, ctx);\n    const items = await store.loadThreadItems(threadRef, undefined, 50, 'asc', ctx);\n\n    sendJson(response, 200, {\n      ...thread,\n      object: 'chatkit.thread',\n      items: {\n        ...items,\n        object: 'list',\n        data: items.data.map((it) => ({ ...it, object: 'chatkit.thread_item' })),\n      },\n    });\n  });\n\n  // DELETE /v1/chatkit/threads/:thread_id\n  server.delete('/v1/chatkit/threads/:thread_id', async (request, response, params) => {\n    const threadRef = getThreadRefFromRequest(request, response, params.thread_id);\n    if (!threadRef) {\n      return;\n    }\n    await store.deleteThread(threadRef, buildContext(request));\n    // OpenAI style: return a success object (keep simple)\n    sendJson(response, 200, { success: true });\n  });\n\n  // GET /v1/chatkit/threads/:thread_id/items\n  server.get('/v1/chatkit/threads/:thread_id/items', async (request, response, params) => {\n    const url = new URL(request.url ?? '', `http://${request.headers.host}`);\n    const threadRef = getThreadRefFromRequest(request, response, params.thread_id);\n    if (!threadRef) {\n      return;\n    }\n    const limit = parseOptionalInt(url.searchParams.get('limit')) ?? 50;\n    const after = url.searchParams.get('after') ?? undefined;\n    const order = (url.searchParams.get('order') ?? 'asc') as 'asc' | 'desc';\n\n    const page = await store.loadThreadItems(\n      threadRef,\n      after,\n      limit,\n      order,\n      buildContext(request),\n    );\n    const data: ChatKitThreadItemObject[] = page.data.map((it) => ({ ...it, object: 'chatkit.thread_item' }));\n\n    sendJson(response, 200, {\n      object: 'list',\n      data,\n      has_more: page.has_more,\n      after: page.after,\n    });\n  });\n}\n\nfunction parseOptionalInt(value: string | null): number | undefined {\n  if (!value) {\n    return undefined;\n  }\n  const n = Number.parseInt(value, 10);\n  return Number.isFinite(n) ? n : undefined;\n}\n\nfunction getThreadRefFromRequest(\n  request: AuthenticatedRequest,\n  response: any,\n  rawThreadId: string,\n): ThreadRef | null {\n  const url = new URL(request.url ?? '', `http://${request.headers.host}`);\n  try {\n    return toThreadRef({\n      thread_id: decodeURIComponent(rawThreadId),\n      chat_id: url.searchParams.get('chat_id') ?? undefined,\n    });\n  } catch (error) {\n    sendJson(response, 400, {\n      error: error instanceof Error ? error.message : 'Invalid thread reference',\n    });\n    return null;\n  }\n}\n\nfunction sendJson(response: any, status: number, data: unknown): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify(data));\n}\n"]}
+{"version":3,"file":"ChatKitV1Handler.js","sourceRoot":"","sources":["../../../src/api/handlers/ChatKitV1Handler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ChatKit v1 (OpenAI-compatible) routes.\n *\n * This is a REST wrapper around our internal ChatKit store/service so that\n * clients expecting `/v1/chatkit/...` can work without speaking the single\n * `/v1/chatkit` protocol endpoint.\n *\n * Notes:\n * - We accept (but do not require) `OpenAI-Beta: chatkit_beta=v1`.\n * - Auth is handled by ApiServer middleware (same as other API routes).\n */\n\nimport type { ApiServer } from '../ApiServer';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport type { StoreContext, ChatKitStore } from '../chatkit/store';\nimport type { Page, ThreadItem, ThreadMetadata, ThreadRef } from '../chatkit/types';\nimport { toThreadRef } from '../chatkit/types';\nimport { getWebId, getAccountId } from '../auth/AuthContext';\n\nexport interface ChatKitV1HandlerOptions {\n  store: ChatKitStore<StoreContext>;\n}\n\ntype ChatKitThreadObject = ThreadMetadata & { object: 'chatkit.thread' };\ntype ChatKitThreadItemObject = ThreadItem & { object: 'chatkit.thread_item' };\n\nexport function registerChatKitV1Routes(server: ApiServer, options: ChatKitV1HandlerOptions): void {\n  const { store } = options;\n\n  const buildContext = (request: AuthenticatedRequest): StoreContext => {\n    const auth = request.auth;\n    const userId = auth ? (getWebId(auth) ?? getAccountId(auth) ?? 'anonymous') : 'anonymous';\n    return { userId, auth };\n  };\n\n  // GET /v1/chatkit/threads\n  server.get('/v1/chatkit/threads', async (request, response) => {\n    const url = new URL(request.url ?? '', `http://${request.headers.host}`);\n    const limit = parseOptionalInt(url.searchParams.get('limit')) ?? 20;\n    const after = url.searchParams.get('after') ?? undefined;\n    const order = (url.searchParams.get('order') ?? 'desc') as 'asc' | 'desc';\n\n    const page = await store.loadThreads(limit, after, order, buildContext(request));\n    const data: ChatKitThreadObject[] = page.data.map((t) => ({ ...t, object: 'chatkit.thread' }));\n\n    sendJson(response, 200, {\n      object: 'list',\n      data,\n      has_more: page.has_more,\n      after: page.after,\n    });\n  });\n\n  // GET /v1/chatkit/threads/:thread_id\n  server.get('/v1/chatkit/threads/:thread_id', async (request, response, params) => {\n    const threadRef = getThreadRefFromRequest(request, response, params.thread_id);\n    if (!threadRef) {\n      return;\n    }\n    const ctx = buildContext(request);\n    const thread = await store.loadThread(threadRef, ctx);\n    const items = await store.loadThreadItems(threadRef, undefined, 50, 'asc', ctx);\n\n    sendJson(response, 200, {\n      ...thread,\n      object: 'chatkit.thread',\n      items: {\n        ...items,\n        object: 'list',\n        data: items.data.map((it) => ({ ...it, object: 'chatkit.thread_item' })),\n      },\n    });\n  });\n\n  // DELETE /v1/chatkit/threads/:thread_id\n  server.delete('/v1/chatkit/threads/:thread_id', async (request, response, params) => {\n    const threadRef = getThreadRefFromRequest(request, response, params.thread_id);\n    if (!threadRef) {\n      return;\n    }\n    await store.deleteThread(threadRef, buildContext(request));\n    // OpenAI style: return a success object (keep simple)\n    sendJson(response, 200, { success: true });\n  });\n\n  // GET /v1/chatkit/threads/:thread_id/items\n  server.get('/v1/chatkit/threads/:thread_id/items', async (request, response, params) => {\n    const url = new URL(request.url ?? '', `http://${request.headers.host}`);\n    const threadRef = getThreadRefFromRequest(request, response, params.thread_id);\n    if (!threadRef) {\n      return;\n    }\n    const limit = parseOptionalInt(url.searchParams.get('limit')) ?? 50;\n    const after = url.searchParams.get('after') ?? undefined;\n    const order = (url.searchParams.get('order') ?? 'asc') as 'asc' | 'desc';\n\n    const page = await store.loadThreadItems(\n      threadRef,\n      after,\n      limit,\n      order,\n      buildContext(request),\n    );\n    const data: ChatKitThreadItemObject[] = page.data.map((it) => ({ ...it, object: 'chatkit.thread_item' }));\n\n    sendJson(response, 200, {\n      object: 'list',\n      data,\n      has_more: page.has_more,\n      after: page.after,\n    });\n  });\n}\n\nfunction parseOptionalInt(value: string | null): number | undefined {\n  if (!value) {\n    return undefined;\n  }\n  const n = Number.parseInt(value, 10);\n  return Number.isFinite(n) ? n : undefined;\n}\n\nfunction getThreadRefFromRequest(\n  request: AuthenticatedRequest,\n  response: any,\n  rawThreadId: string,\n): ThreadRef | null {\n  void request;\n  try {\n    return toThreadRef({\n      thread_id: decodeURIComponent(rawThreadId),\n    });\n  } catch (error) {\n    sendJson(response, 400, {\n      error: error instanceof Error ? error.message : 'Invalid thread reference',\n    });\n    return null;\n  }\n}\n\nfunction sendJson(response: any, status: number, data: unknown): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify(data));\n}\n"]}

package/dist/api/handlers/CoordinationHandler.d.ts

@@ -0,0 +1,6 @@
+import type { ApiServer } from '../ApiServer';
+import type { ClientReconcilerCoordinator } from '../reconciler';
+export interface CoordinationHandlerOptions {
+    clientReconcilerCoordinator: ClientReconcilerCoordinator;
+}
+export declare function registerCoordinationRoutes(server: ApiServer, options: CoordinationHandlerOptions): void;

package/dist/api/handlers/CoordinationHandler.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCoordinationRoutes = registerCoordinationRoutes;
+const AuthContext_1 = require("../auth/AuthContext");
+function registerCoordinationRoutes(server, options) {
+    const { clientReconcilerCoordinator } = options;
+    server.post('/v1/clients/heartbeat', async (request, response) => {
+        try {
+            const user = authenticatedUser(request);
+            const body = await readJson(request) ?? {};
+            const client = await clientReconcilerCoordinator.upsertClientCapability({
+                clientId: requireString(body.clientId, 'clientId'),
+                kind: requireString(body.kind, 'kind'),
+                user,
+                canCoordinateClientOwnedThread: body.canCoordinateClientOwnedThread === true,
+                canRunAgent: body.canRunAgent === true,
+                workspaces: Array.isArray(body.workspaces) ? body.workspaces.filter((item) => typeof item === 'string') : [],
+            });
+            sendJson(response, 200, { client });
+        }
+        catch (error) {
+            sendJson(response, statusForError(error), { error: formatError(error) });
+        }
+    });
+    server.post('/v1/threads/coordination/lease', async (request, response) => {
+        try {
+            const ownerUser = authenticatedUser(request);
+            const body = await readJson(request) ?? {};
+            const thread = requireThread(body.thread);
+            const requesterClientId = typeof body.clientId === 'string' ? body.clientId : undefined;
+            const lease = await clientReconcilerCoordinator.activate({
+                thread,
+                ownerUser,
+                requesterClientId,
+            });
+            sendJson(response, 200, {
+                lease: lease ?? null,
+                isOwner: Boolean(lease && requesterClientId && lease.ownerClientId === requesterClientId),
+            });
+        }
+        catch (error) {
+            sendJson(response, statusForError(error), { error: formatError(error) });
+        }
+    });
+    server.post('/v1/threads/coordination/lease/release', async (request, response) => {
+        try {
+            const ownerUser = authenticatedUser(request);
+            const body = await readJson(request) ?? {};
+            const released = await clientReconcilerCoordinator.releaseLease({
+                thread: requireThread(body.thread),
+                ownerUser,
+                clientId: requireString(body.clientId, 'clientId'),
+            });
+            sendJson(response, 200, { released });
+        }
+        catch (error) {
+            sendJson(response, statusForError(error), { error: formatError(error) });
+        }
+    });
+}
+function authenticatedUser(request) {
+    const auth = request.auth;
+    if (!auth) {
+        throw forbidden('Authenticated user is required');
+    }
+    const user = (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth);
+    if (!user) {
+        throw forbidden('Solid user authentication is required');
+    }
+    return user;
+}
+async function readJson(request) {
+    const chunks = [];
+    for await (const chunk of request) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    const raw = Buffer.concat(chunks).toString('utf8').trim();
+    if (!raw) {
+        return undefined;
+    }
+    return JSON.parse(raw);
+}
+function requireString(value, field) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error(`${field} is required`);
+    }
+    return value.trim();
+}
+function requireThread(value) {
+    const uri = requireString(value, 'thread');
+    if (!/^(https?:\/\/|urn:)/u.test(uri)) {
+        throw new Error('thread must be an absolute http(s) or urn URI');
+    }
+    return uri;
+}
+function forbidden(message) {
+    const error = new Error(message);
+    error.statusCode = 403;
+    return error;
+}
+function statusForError(error) {
+    if (error && typeof error === 'object' && 'statusCode' in error && typeof error.statusCode === 'number') {
+        return error.statusCode;
+    }
+    return 400;
+}
+function sendJson(response, status, data) {
+    response.statusCode = status;
+    response.setHeader('Content-Type', 'application/json');
+    response.end(JSON.stringify(data));
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=CoordinationHandler.js.map

package/dist/api/handlers/CoordinationHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoordinationHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/CoordinationHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ServerResponse } from 'node:http';\nimport type { ApiServer } from '../ApiServer';\nimport { getAccountId, getWebId } from '../auth/AuthContext';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport type { ClientReconcilerCoordinator } from '../reconciler';\n\nexport interface CoordinationHandlerOptions {\n  clientReconcilerCoordinator: ClientReconcilerCoordinator;\n}\n\nexport function registerCoordinationRoutes(server: ApiServer, options: CoordinationHandlerOptions): void {\n  const { clientReconcilerCoordinator } = options;\n\n  server.post('/v1/clients/heartbeat', async (request, response) => {\n    try {\n      const user = authenticatedUser(request);\n      const body = await readJson<Record<string, unknown>>(request) ?? {};\n      const client = await clientReconcilerCoordinator.upsertClientCapability({\n        clientId: requireString(body.clientId, 'clientId'),\n        kind: requireString(body.kind, 'kind') as any,\n        user,\n        canCoordinateClientOwnedThread: body.canCoordinateClientOwnedThread === true,\n        canRunAgent: body.canRunAgent === true,\n        workspaces: Array.isArray(body.workspaces) ? body.workspaces.filter((item): item is string => typeof item === 'string') : [],\n      });\n      sendJson(response, 200, { client });\n    } catch (error) {\n      sendJson(response, statusForError(error), { error: formatError(error) });\n    }\n  });\n\n  server.post('/v1/threads/coordination/lease', async (request, response) => {\n    try {\n      const ownerUser = authenticatedUser(request);\n      const body = await readJson<Record<string, unknown>>(request) ?? {};\n      const thread = requireThread(body.thread);\n      const requesterClientId = typeof body.clientId === 'string' ? body.clientId : undefined;\n      const lease = await clientReconcilerCoordinator.activate({\n        thread,\n        ownerUser,\n        requesterClientId,\n      });\n      sendJson(response, 200, {\n        lease: lease ?? null,\n        isOwner: Boolean(lease && requesterClientId && lease.ownerClientId === requesterClientId),\n      });\n    } catch (error) {\n      sendJson(response, statusForError(error), { error: formatError(error) });\n    }\n  });\n\n  server.post('/v1/threads/coordination/lease/release', async (request, response) => {\n    try {\n      const ownerUser = authenticatedUser(request);\n      const body = await readJson<Record<string, unknown>>(request) ?? {};\n      const released = await clientReconcilerCoordinator.releaseLease({\n        thread: requireThread(body.thread),\n        ownerUser,\n        clientId: requireString(body.clientId, 'clientId'),\n      });\n      sendJson(response, 200, { released });\n    } catch (error) {\n      sendJson(response, statusForError(error), { error: formatError(error) });\n    }\n  });\n}\n\nfunction authenticatedUser(request: AuthenticatedRequest): string {\n  const auth = request.auth;\n  if (!auth) {\n    throw forbidden('Authenticated user is required');\n  }\n  const user = getWebId(auth) ?? getAccountId(auth);\n  if (!user) {\n    throw forbidden('Solid user authentication is required');\n  }\n  return user;\n}\n\nasync function readJson<T>(request: AuthenticatedRequest): Promise<T | undefined> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of request) {\n    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n  }\n  const raw = Buffer.concat(chunks).toString('utf8').trim();\n  if (!raw) {\n    return undefined;\n  }\n  return JSON.parse(raw) as T;\n}\n\nfunction requireString(value: unknown, field: string): string {\n  if (typeof value !== 'string' || value.trim().length === 0) {\n    throw new Error(`${field} is required`);\n  }\n  return value.trim();\n}\n\nfunction requireThread(value: unknown): string {\n  const uri = requireString(value, 'thread');\n  if (!/^(https?:\\/\\/|urn:)/u.test(uri)) {\n    throw new Error('thread must be an absolute http(s) or urn URI');\n  }\n  return uri;\n}\n\nfunction forbidden(message: string): Error {\n  const error = new Error(message) as Error & { statusCode?: number };\n  error.statusCode = 403;\n  return error;\n}\n\nfunction statusForError(error: unknown): number {\n  if (error && typeof error === 'object' && 'statusCode' in error && typeof (error as { statusCode?: unknown }).statusCode === 'number') {\n    return (error as { statusCode: number }).statusCode;\n  }\n  return 400;\n}\n\nfunction sendJson(response: ServerResponse, status: number, data: unknown): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify(data));\n}\n\nfunction formatError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"]}

package/dist/api/handlers/MatrixHandler.d.ts

@@ -3,4 +3,15 @@ import type { MatrixStore } from '../matrix/types';
 export interface MatrixHandlerOptions {
     store: MatrixStore;
 }
+/**
+ * Register the Matrix Client-Server compatibility adapter.
+ *
+ * Keep these externally visible routes Matrix-shaped:
+ * - `/.well-known/matrix/client` is public discovery.
+ * - `/_matrix/client/...` is Matrix's protocol namespace.
+ *
+ * Do not mount this adapter under `/api` or `/matrix`; first-party Xpod
+ * clients should use Xpod-owned chat/message APIs, while Matrix clients need
+ * the standard route shape to interoperate with existing SDKs.
+ */
 export declare function registerMatrixRoutes(server: ApiServer, options: MatrixHandlerOptions): void;

package/dist/api/handlers/MatrixHandler.js

@@ -2,8 +2,26 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerMatrixRoutes = registerMatrixRoutes;
 const AuthContext_1 = require("../auth/AuthContext");
+/**
+ * Register the Matrix Client-Server compatibility adapter.
+ *
+ * Keep these externally visible routes Matrix-shaped:
+ * - `/.well-known/matrix/client` is public discovery.
+ * - `/_matrix/client/...` is Matrix's protocol namespace.
+ *
+ * Do not mount this adapter under `/api` or `/matrix`; first-party Xpod
+ * clients should use Xpod-owned chat/message APIs, while Matrix clients need
+ * the standard route shape to interoperate with existing SDKs.
+ */
 function registerMatrixRoutes(server, options) {
     const { store } = options;
+    server.get('/.well-known/matrix/client', async (request, response) => {
+        sendJson(response, 200, {
+            'm.homeserver': {
+                base_url: requestBaseUrl(request),
+            },
+        });
+    }, { public: true });
     server.get('/_matrix/client/versions', async (_request, response) => {
         sendJson(response, 200, {
             versions: [
@@ -35,6 +53,19 @@ function registerMatrixRoutes(server, options) {
     server.post('/_matrix/client/v3/login', async (_request, response) => {
         sendMatrixError(response, 501, 'M_UNRECOGNIZED', 'Matrix-native login is not implemented; use Solid/OIDC API authentication.');
     }, { public: true });
+    server.get('/_matrix/client/v3/account/whoami', async (request, response) => {
+        try {
+            const account = await store.getAccount(buildContext(request));
+            sendJson(response, 200, {
+                user_id: account.userId,
+                ...(account.deviceId ? { device_id: account.deviceId } : {}),
+                is_guest: false,
+            });
+        }
+        catch (error) {
+            sendMatrixError(response, 400, 'M_UNKNOWN', formatError(error));
+        }
+    });
     server.post('/_matrix/client/v3/createRoom', async (request, response) => {
         try {
             const body = await readJson(request);
@@ -55,6 +86,55 @@ function registerMatrixRoutes(server, options) {
             sendMatrixError(response, 400, 'M_BAD_JSON', formatError(error));
         }
     });
+    server.get('/_matrix/client/v3/joined_rooms', async (request, response) => {
+        try {
+            const joinedRooms = await store.listJoinedRooms(buildContext(request));
+            sendJson(response, 200, { joined_rooms: joinedRooms });
+        }
+        catch (error) {
+            sendMatrixError(response, 400, 'M_UNKNOWN', formatError(error));
+        }
+    });
+    server.post('/_matrix/client/v3/join/:roomIdOrAlias', async (request, response, params) => {
+        try {
+            const result = await store.joinRoom(decodeURIComponent(params.roomIdOrAlias), buildContext(request));
+            sendJson(response, 200, { room_id: result.roomId });
+        }
+        catch (error) {
+            sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));
+        }
+    });
+    server.post('/_matrix/client/v3/rooms/:roomId/join', async (request, response, params) => {
+        try {
+            const result = await store.joinRoom(decodeURIComponent(params.roomId), buildContext(request));
+            sendJson(response, 200, { room_id: result.roomId });
+        }
+        catch (error) {
+            sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));
+        }
+    });
+    server.post('/_matrix/client/v3/rooms/:roomId/invite', async (request, response, params) => {
+        try {
+            const body = await readJson(request);
+            if (!body || typeof body.user_id !== 'string' || body.user_id.length === 0) {
+                throw new Error('Invite requires user_id');
+            }
+            await store.inviteUser(decodeURIComponent(params.roomId), body.user_id, buildContext(request));
+            sendJson(response, 200, {});
+        }
+        catch (error) {
+            sendMatrixError(response, 400, 'M_BAD_JSON', formatError(error));
+        }
+    });
+    server.post('/_matrix/client/v3/rooms/:roomId/leave', async (request, response, params) => {
+        try {
+            await store.leaveRoom(decodeURIComponent(params.roomId), buildContext(request));
+            sendJson(response, 200, {});
+        }
+        catch (error) {
+            sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));
+        }
+    });
     server.get('/_matrix/client/v3/sync', async (request, response) => {
         try {
             const url = new URL(request.url ?? '', `http://${request.headers.host ?? 'localhost'}`);
@@ -82,6 +162,15 @@ function registerMatrixRoutes(server, options) {
             sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));
         }
     });
+    server.get('/_matrix/client/v3/rooms/:roomId/members', async (request, response, params) => {
+        try {
+            const members = await store.getMembers(decodeURIComponent(params.roomId), buildContext(request));
+            sendJson(response, 200, { chunk: members });
+        }
+        catch (error) {
+            sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));
+        }
+    });
     server.get('/_matrix/client/v3/rooms/:roomId/event/:eventId', async (request, response, params) => {
         try {
             const event = await store.getEvent(decodeURIComponent(params.roomId), decodeURIComponent(params.eventId), buildContext(request));
@@ -97,6 +186,12 @@ function registerMatrixRoutes(server, options) {
     server.get('/_matrix/client/v3/rooms/:roomId/state/:eventType/:stateKey', async (request, response, params) => {
         await sendState(request, response, params, decodeURIComponent(params.stateKey ?? ''));
     });
+    server.put('/_matrix/client/v3/rooms/:roomId/state/:eventType', async (request, response, params) => {
+        await putState(request, response, params, '');
+    });
+    server.put('/_matrix/client/v3/rooms/:roomId/state/:eventType/:stateKey', async (request, response, params) => {
+        await putState(request, response, params, decodeURIComponent(params.stateKey ?? ''));
+    });
     async function sendState(request, response, params, stateKey) {
         try {
             const state = await store.getState(decodeURIComponent(params.roomId), decodeURIComponent(params.eventType), stateKey, buildContext(request));
@@ -106,11 +201,24 @@ function registerMatrixRoutes(server, options) {
             sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));
         }
     }
+    async function putState(request, response, params, stateKey) {
+        try {
+            const content = await readJson(request);
+            const event = await store.setState(decodeURIComponent(params.roomId), decodeURIComponent(params.eventType), stateKey, content ?? {}, buildContext(request));
+            sendJson(response, 200, { event_id: event.eventId });
+        }
+        catch (error) {
+            sendMatrixError(response, 400, 'M_BAD_JSON', formatError(error));
+        }
+    }
 }
 function buildContext(request) {
     const auth = request.auth;
-    const userId = auth ? (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth) ?? 'anonymous' : 'anonymous';
-    return { userId, auth };
+    const webId = auth ? (0, AuthContext_1.getWebId)(auth) : undefined;
+    if (!webId) {
+        throw new Error('Matrix API requires Solid WebID authentication');
+    }
+    return { webId, auth };
 }
 async function readJson(request) {
     const chunks = [];
@@ -130,6 +238,16 @@ function parseOptionalNumber(value) {
     const parsed = Number.parseInt(value, 10);
     return Number.isFinite(parsed) ? parsed : undefined;
 }
+function requestBaseUrl(request) {
+    const forwardedProto = headerValue(request.headers['x-forwarded-proto']);
+    const forwardedHost = headerValue(request.headers['x-forwarded-host']);
+    const proto = forwardedProto?.split(',')[0]?.trim() || 'http';
+    const host = forwardedHost?.split(',')[0]?.trim() || request.headers.host || 'localhost';
+    return `${proto}://${host}`;
+}
+function headerValue(value) {
+    return Array.isArray(value) ? value[0] : value;
+}
 function sendJson(response, status, data) {
     response.statusCode = status;
     response.setHeader('Content-Type', 'application/json');

package/dist/api/handlers/MatrixHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"MatrixHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/MatrixHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ServerResponse } from 'node:http';\nimport type { ApiServer } from '../ApiServer';\nimport { getAccountId, getWebId } from '../auth/AuthContext';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport type { MatrixCreateRoomRequest, MatrixStore, MatrixStoreContext } from '../matrix/types';\n\nexport interface MatrixHandlerOptions {\n  store: MatrixStore;\n}\n\nexport function registerMatrixRoutes(server: ApiServer, options: MatrixHandlerOptions): void {\n  const { store } = options;\n\n  server.get('/_matrix/client/versions', async (_request, response) => {\n    sendJson(response, 200, {\n      versions: [\n        'r0.6.1',\n        'v1.1',\n        'v1.2',\n        'v1.3',\n        'v1.4',\n        'v1.5',\n        'v1.6',\n        'v1.7',\n        'v1.8',\n        'v1.9',\n        'v1.10',\n        'v1.11',\n      ],\n      unstable_features: {\n        'co.undefineds.matrix.pod_storage': true,\n      },\n    });\n  }, { public: true });\n\n  server.get('/_matrix/client/v3/login', async (_request, response) => {\n    sendJson(response, 200, {\n      flows: [\n        { type: 'm.login.token' },\n      ],\n    });\n  }, { public: true });\n\n  server.post('/_matrix/client/v3/login', async (_request, response) => {\n    sendMatrixError(response, 501, 'M_UNRECOGNIZED', 'Matrix-native login is not implemented; use Solid/OIDC API authentication.');\n  }, { public: true });\n\n  server.post('/_matrix/client/v3/createRoom', async (request, response) => {\n    try {\n      const body = await readJson<MatrixCreateRoomRequest>(request);\n      const room = await store.createRoom(body ?? {}, buildContext(request));\n      sendJson(response, 200, { room_id: room.roomId });\n    } catch (error) {\n      sendMatrixError(response, 400, 'M_BAD_JSON', formatError(error));\n    }\n  });\n\n  server.put('/_matrix/client/v3/rooms/:roomId/send/:eventType/:txnId', async (request, response, params) => {\n    try {\n      const content = await readJson<Record<string, unknown>>(request);\n      const event = await store.sendEvent(\n        decodeURIComponent(params.roomId),\n        decodeURIComponent(params.eventType),\n        decodeURIComponent(params.txnId),\n        content ?? {},\n        buildContext(request),\n      );\n      sendJson(response, 200, { event_id: event.eventId });\n    } catch (error) {\n      sendMatrixError(response, 400, 'M_BAD_JSON', formatError(error));\n    }\n  });\n\n  server.get('/_matrix/client/v3/sync', async (request, response) => {\n    try {\n      const url = new URL(request.url ?? '', `http://${request.headers.host ?? 'localhost'}`);\n      const sync = await store.sync(buildContext(request), {\n        since: url.searchParams.get('since') ?? undefined,\n        limit: parseOptionalNumber(url.searchParams.get('limit')),\n      });\n      sendJson(response, 200, sync);\n    } catch (error) {\n      sendMatrixError(response, 400, 'M_UNKNOWN', formatError(error));\n    }\n  });\n\n  server.get('/_matrix/client/v3/rooms/:roomId/messages', async (request, response, params) => {\n    try {\n      const url = new URL(request.url ?? '', `http://${request.headers.host ?? 'localhost'}`);\n      const messages = await store.listMessages(decodeURIComponent(params.roomId), buildContext(request), {\n        from: url.searchParams.get('from') ?? undefined,\n        dir: url.searchParams.get('dir') === 'f' ? 'f' : 'b',\n        limit: parseOptionalNumber(url.searchParams.get('limit')),\n      });\n      sendJson(response, 200, messages);\n    } catch (error) {\n      sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));\n    }\n  });\n\n  server.get('/_matrix/client/v3/rooms/:roomId/event/:eventId', async (request, response, params) => {\n    try {\n      const event = await store.getEvent(\n        decodeURIComponent(params.roomId),\n        decodeURIComponent(params.eventId),\n        buildContext(request),\n      );\n      sendJson(response, 200, event);\n    } catch (error) {\n      sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));\n    }\n  });\n\n  server.get('/_matrix/client/v3/rooms/:roomId/state/:eventType', async (request, response, params) => {\n    await sendState(request, response, params, '');\n  });\n\n  server.get('/_matrix/client/v3/rooms/:roomId/state/:eventType/:stateKey', async (request, response, params) => {\n    await sendState(request, response, params, decodeURIComponent(params.stateKey ?? ''));\n  });\n\n  async function sendState(\n    request: AuthenticatedRequest,\n    response: ServerResponse,\n    params: Record<string, string>,\n    stateKey: string,\n  ): Promise<void> {\n    try {\n      const state = await store.getState(\n        decodeURIComponent(params.roomId),\n        decodeURIComponent(params.eventType),\n        stateKey,\n        buildContext(request),\n      );\n      sendJson(response, 200, state);\n    } catch (error) {\n      sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));\n    }\n  }\n}\n\nfunction buildContext(request: AuthenticatedRequest): MatrixStoreContext {\n  const auth = request.auth;\n  const userId = auth ? getWebId(auth) ?? getAccountId(auth) ?? 'anonymous' : 'anonymous';\n  return { userId, auth };\n}\n\nasync function readJson<T>(request: AuthenticatedRequest): Promise<T | undefined> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of request) {\n    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n  }\n  const raw = Buffer.concat(chunks).toString('utf8').trim();\n  if (!raw) {\n    return undefined;\n  }\n  return JSON.parse(raw) as T;\n}\n\nfunction parseOptionalNumber(value: string | null): number | undefined {\n  if (!value) {\n    return undefined;\n  }\n  const parsed = Number.parseInt(value, 10);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction sendJson(response: ServerResponse, status: number, data: unknown): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify(data));\n}\n\nfunction sendMatrixError(response: ServerResponse, status: number, errcode: string, error: string): void {\n  sendJson(response, status, { errcode, error });\n}\n\nfunction formatError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"]}
+{"version":3,"file":"MatrixHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/MatrixHandler.ts"],"names":[],"mappings":";;AAqBA,oDA6OC;AAhQD,qDAA+C;AAQ/C;;;;;;;;;;GAUG;AACH,SAAgB,oBAAoB,CAAC,MAAiB,EAAE,OAA6B;IACnF,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAE1B,MAAM,CAAC,GAAG,CAAC,4BAA4B,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QACnE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;YACtB,cAAc,EAAE;gBACd,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC;aAClC;SACF,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAErB,MAAM,CAAC,GAAG,CAAC,0BAA0B,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;QAClE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;YACtB,QAAQ,EAAE;gBACR,QAAQ;gBACR,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,OAAO;gBACP,OAAO;aACR;YACD,iBAAiB,EAAE;gBACjB,kCAAkC,EAAE,IAAI;aACzC;SACF,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAErB,MAAM,CAAC,GAAG,CAAC,0BAA0B,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;QAClE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;YACtB,KAAK,EAAE;gBACL,EAAE,IAAI,EAAE,eAAe,EAAE;aAC1B;SACF,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAErB,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;QACnE,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE,4EAA4E,CAAC,CAAC;IACjI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAErB,MAAM,CAAC,GAAG,CAAC,mCAAmC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YAC9D,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,OAAO,EAAE,OAAO,CAAC,MAAM;gBACvB,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QACvE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAA0B,OAAO,CAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YACvE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,yDAAyD,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACxG,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAA0B,OAAO,CAAC,CAAC;YACjE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,SAAS,CACjC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EACjC,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,EACpC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAChC,OAAO,IAAI,EAAE,EACb,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;YACF,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,iCAAiC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QACxE,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YACvE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACxF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YACrG,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACvF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YAC9F,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACzF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAwB,OAAO,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3E,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/F,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACxF,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YAChF,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QAChE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,UAAU,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;YACxF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE;gBACnD,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS;gBACjD,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;aAC1D,CAAC,CAAC;YACH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,2CAA2C,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC1F,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,UAAU,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;YACxF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE;gBAClG,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS;gBAC/C,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;gBACpD,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;aAC1D,CAAC,CAAC;YACH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,0CAA0C,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACzF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YACjG,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,iDAAiD,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAChG,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,CAChC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EACjC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,EAClC,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;YACF,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,mDAAmD,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAClG,MAAM,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,6DAA6D,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC5G,MAAM,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,mDAAmD,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAClG,MAAM,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,6DAA6D,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC5G,MAAM,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,KAAK,UAAU,SAAS,CACtB,OAA6B,EAC7B,QAAwB,EACxB,MAA8B,EAC9B,QAAgB;QAEhB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,CAChC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EACjC,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,EACpC,QAAQ,EACR,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;YACF,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,KAAK,UAAU,QAAQ,CACrB,OAA6B,EAC7B,QAAwB,EACxB,MAA8B,EAC9B,QAAgB;QAEhB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAA0B,OAAO,CAAC,CAAC;YACjE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,CAChC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EACjC,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,EACpC,QAAQ,EACR,OAAO,IAAI,EAAE,EACb,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;YACF,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,OAA6B;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAA,sBAAQ,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,QAAQ,CAAI,OAA6B;IACtD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;AAC9B,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAoB;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,SAAS,cAAc,CAAC,OAA6B;IACnD,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;IAC9D,MAAM,IAAI,GAAG,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzF,OAAO,GAAG,KAAK,MAAM,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,WAAW,CAAC,KAAoC;IACvD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,QAAwB,EAAE,MAAc,EAAE,IAAa;IACvE,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IACvD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,eAAe,CAAC,QAAwB,EAAE,MAAc,EAAE,OAAe,EAAE,KAAa;IAC/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC","sourcesContent":["import type { ServerResponse } from 'node:http';\nimport type { ApiServer } from '../ApiServer';\nimport { getWebId } from '../auth/AuthContext';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport type { MatrixCreateRoomRequest, MatrixStore, MatrixStoreContext } from '../matrix/types';\n\nexport interface MatrixHandlerOptions {\n  store: MatrixStore;\n}\n\n/**\n * Register the Matrix Client-Server compatibility adapter.\n *\n * Keep these externally visible routes Matrix-shaped:\n * - `/.well-known/matrix/client` is public discovery.\n * - `/_matrix/client/...` is Matrix's protocol namespace.\n *\n * Do not mount this adapter under `/api` or `/matrix`; first-party Xpod\n * clients should use Xpod-owned chat/message APIs, while Matrix clients need\n * the standard route shape to interoperate with existing SDKs.\n */\nexport function registerMatrixRoutes(server: ApiServer, options: MatrixHandlerOptions): void {\n  const { store } = options;\n\n  server.get('/.well-known/matrix/client', async (request, response) => {\n    sendJson(response, 200, {\n      'm.homeserver': {\n        base_url: requestBaseUrl(request),\n      },\n    });\n  }, { public: true });\n\n  server.get('/_matrix/client/versions', async (_request, response) => {\n    sendJson(response, 200, {\n      versions: [\n        'r0.6.1',\n        'v1.1',\n        'v1.2',\n        'v1.3',\n        'v1.4',\n        'v1.5',\n        'v1.6',\n        'v1.7',\n        'v1.8',\n        'v1.9',\n        'v1.10',\n        'v1.11',\n      ],\n      unstable_features: {\n        'co.undefineds.matrix.pod_storage': true,\n      },\n    });\n  }, { public: true });\n\n  server.get('/_matrix/client/v3/login', async (_request, response) => {\n    sendJson(response, 200, {\n      flows: [\n        { type: 'm.login.token' },\n      ],\n    });\n  }, { public: true });\n\n  server.post('/_matrix/client/v3/login', async (_request, response) => {\n    sendMatrixError(response, 501, 'M_UNRECOGNIZED', 'Matrix-native login is not implemented; use Solid/OIDC API authentication.');\n  }, { public: true });\n\n  server.get('/_matrix/client/v3/account/whoami', async (request, response) => {\n    try {\n      const account = await store.getAccount(buildContext(request));\n      sendJson(response, 200, {\n        user_id: account.userId,\n        ...(account.deviceId ? { device_id: account.deviceId } : {}),\n        is_guest: false,\n      });\n    } catch (error) {\n      sendMatrixError(response, 400, 'M_UNKNOWN', formatError(error));\n    }\n  });\n\n  server.post('/_matrix/client/v3/createRoom', async (request, response) => {\n    try {\n      const body = await readJson<MatrixCreateRoomRequest>(request);\n      const room = await store.createRoom(body ?? {}, buildContext(request));\n      sendJson(response, 200, { room_id: room.roomId });\n    } catch (error) {\n      sendMatrixError(response, 400, 'M_BAD_JSON', formatError(error));\n    }\n  });\n\n  server.put('/_matrix/client/v3/rooms/:roomId/send/:eventType/:txnId', async (request, response, params) => {\n    try {\n      const content = await readJson<Record<string, unknown>>(request);\n      const event = await store.sendEvent(\n        decodeURIComponent(params.roomId),\n        decodeURIComponent(params.eventType),\n        decodeURIComponent(params.txnId),\n        content ?? {},\n        buildContext(request),\n      );\n      sendJson(response, 200, { event_id: event.eventId });\n    } catch (error) {\n      sendMatrixError(response, 400, 'M_BAD_JSON', formatError(error));\n    }\n  });\n\n  server.get('/_matrix/client/v3/joined_rooms', async (request, response) => {\n    try {\n      const joinedRooms = await store.listJoinedRooms(buildContext(request));\n      sendJson(response, 200, { joined_rooms: joinedRooms });\n    } catch (error) {\n      sendMatrixError(response, 400, 'M_UNKNOWN', formatError(error));\n    }\n  });\n\n  server.post('/_matrix/client/v3/join/:roomIdOrAlias', async (request, response, params) => {\n    try {\n      const result = await store.joinRoom(decodeURIComponent(params.roomIdOrAlias), buildContext(request));\n      sendJson(response, 200, { room_id: result.roomId });\n    } catch (error) {\n      sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));\n    }\n  });\n\n  server.post('/_matrix/client/v3/rooms/:roomId/join', async (request, response, params) => {\n    try {\n      const result = await store.joinRoom(decodeURIComponent(params.roomId), buildContext(request));\n      sendJson(response, 200, { room_id: result.roomId });\n    } catch (error) {\n      sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));\n    }\n  });\n\n  server.post('/_matrix/client/v3/rooms/:roomId/invite', async (request, response, params) => {\n    try {\n      const body = await readJson<{ user_id?: unknown }>(request);\n      if (!body || typeof body.user_id !== 'string' || body.user_id.length === 0) {\n        throw new Error('Invite requires user_id');\n      }\n      await store.inviteUser(decodeURIComponent(params.roomId), body.user_id, buildContext(request));\n      sendJson(response, 200, {});\n    } catch (error) {\n      sendMatrixError(response, 400, 'M_BAD_JSON', formatError(error));\n    }\n  });\n\n  server.post('/_matrix/client/v3/rooms/:roomId/leave', async (request, response, params) => {\n    try {\n      await store.leaveRoom(decodeURIComponent(params.roomId), buildContext(request));\n      sendJson(response, 200, {});\n    } catch (error) {\n      sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));\n    }\n  });\n\n  server.get('/_matrix/client/v3/sync', async (request, response) => {\n    try {\n      const url = new URL(request.url ?? '', `http://${request.headers.host ?? 'localhost'}`);\n      const sync = await store.sync(buildContext(request), {\n        since: url.searchParams.get('since') ?? undefined,\n        limit: parseOptionalNumber(url.searchParams.get('limit')),\n      });\n      sendJson(response, 200, sync);\n    } catch (error) {\n      sendMatrixError(response, 400, 'M_UNKNOWN', formatError(error));\n    }\n  });\n\n  server.get('/_matrix/client/v3/rooms/:roomId/messages', async (request, response, params) => {\n    try {\n      const url = new URL(request.url ?? '', `http://${request.headers.host ?? 'localhost'}`);\n      const messages = await store.listMessages(decodeURIComponent(params.roomId), buildContext(request), {\n        from: url.searchParams.get('from') ?? undefined,\n        dir: url.searchParams.get('dir') === 'f' ? 'f' : 'b',\n        limit: parseOptionalNumber(url.searchParams.get('limit')),\n      });\n      sendJson(response, 200, messages);\n    } catch (error) {\n      sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));\n    }\n  });\n\n  server.get('/_matrix/client/v3/rooms/:roomId/members', async (request, response, params) => {\n    try {\n      const members = await store.getMembers(decodeURIComponent(params.roomId), buildContext(request));\n      sendJson(response, 200, { chunk: members });\n    } catch (error) {\n      sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));\n    }\n  });\n\n  server.get('/_matrix/client/v3/rooms/:roomId/event/:eventId', async (request, response, params) => {\n    try {\n      const event = await store.getEvent(\n        decodeURIComponent(params.roomId),\n        decodeURIComponent(params.eventId),\n        buildContext(request),\n      );\n      sendJson(response, 200, event);\n    } catch (error) {\n      sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));\n    }\n  });\n\n  server.get('/_matrix/client/v3/rooms/:roomId/state/:eventType', async (request, response, params) => {\n    await sendState(request, response, params, '');\n  });\n\n  server.get('/_matrix/client/v3/rooms/:roomId/state/:eventType/:stateKey', async (request, response, params) => {\n    await sendState(request, response, params, decodeURIComponent(params.stateKey ?? ''));\n  });\n\n  server.put('/_matrix/client/v3/rooms/:roomId/state/:eventType', async (request, response, params) => {\n    await putState(request, response, params, '');\n  });\n\n  server.put('/_matrix/client/v3/rooms/:roomId/state/:eventType/:stateKey', async (request, response, params) => {\n    await putState(request, response, params, decodeURIComponent(params.stateKey ?? ''));\n  });\n\n  async function sendState(\n    request: AuthenticatedRequest,\n    response: ServerResponse,\n    params: Record<string, string>,\n    stateKey: string,\n  ): Promise<void> {\n    try {\n      const state = await store.getState(\n        decodeURIComponent(params.roomId),\n        decodeURIComponent(params.eventType),\n        stateKey,\n        buildContext(request),\n      );\n      sendJson(response, 200, state);\n    } catch (error) {\n      sendMatrixError(response, 404, 'M_NOT_FOUND', formatError(error));\n    }\n  }\n\n  async function putState(\n    request: AuthenticatedRequest,\n    response: ServerResponse,\n    params: Record<string, string>,\n    stateKey: string,\n  ): Promise<void> {\n    try {\n      const content = await readJson<Record<string, unknown>>(request);\n      const event = await store.setState(\n        decodeURIComponent(params.roomId),\n        decodeURIComponent(params.eventType),\n        stateKey,\n        content ?? {},\n        buildContext(request),\n      );\n      sendJson(response, 200, { event_id: event.eventId });\n    } catch (error) {\n      sendMatrixError(response, 400, 'M_BAD_JSON', formatError(error));\n    }\n  }\n}\n\nfunction buildContext(request: AuthenticatedRequest): MatrixStoreContext {\n  const auth = request.auth;\n  const webId = auth ? getWebId(auth) : undefined;\n  if (!webId) {\n    throw new Error('Matrix API requires Solid WebID authentication');\n  }\n  return { webId, auth };\n}\n\nasync function readJson<T>(request: AuthenticatedRequest): Promise<T | undefined> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of request) {\n    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n  }\n  const raw = Buffer.concat(chunks).toString('utf8').trim();\n  if (!raw) {\n    return undefined;\n  }\n  return JSON.parse(raw) as T;\n}\n\nfunction parseOptionalNumber(value: string | null): number | undefined {\n  if (!value) {\n    return undefined;\n  }\n  const parsed = Number.parseInt(value, 10);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction requestBaseUrl(request: AuthenticatedRequest): string {\n  const forwardedProto = headerValue(request.headers['x-forwarded-proto']);\n  const forwardedHost = headerValue(request.headers['x-forwarded-host']);\n  const proto = forwardedProto?.split(',')[0]?.trim() || 'http';\n  const host = forwardedHost?.split(',')[0]?.trim() || request.headers.host || 'localhost';\n  return `${proto}://${host}`;\n}\n\nfunction headerValue(value: string | string[] | undefined): string | undefined {\n  return Array.isArray(value) ? value[0] : value;\n}\n\nfunction sendJson(response: ServerResponse, status: number, data: unknown): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify(data));\n}\n\nfunction sendMatrixError(response: ServerResponse, status: number, errcode: string, error: string): void {\n  sendJson(response, status, { errcode, error });\n}\n\nfunction formatError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"]}

package/dist/api/handlers/RunHandler.js

@@ -13,8 +13,16 @@ function registerRunRoutes(server, options) {
     server.get('/v1/runs', async (request, response) => {
         try {
             const url = new URL(request.url ?? '', `http://${request.headers.host ?? 'localhost'}`);
-            const runs = await runStore.listRuns(parseRunListOptions(url), buildStoreContext(request));
-            sendJson(response, 200, { runs });
+            const { storeOptions, commandKind } = parseRunListRequest(url);
+            const requestedLimit = storeOptions.limit;
+            let runs = await runStore.listRuns(commandKind ? { ...storeOptions, limit: undefined } : storeOptions, buildStoreContext(request));
+            if (commandKind) {
+                runs = runs.filter((run) => (0, store_1.deriveRunCommandProjection)(run.id)?.commandKind === commandKind);
+            }
+            if (requestedLimit) {
+                runs = runs.slice(0, requestedLimit);
+            }
+            sendJson(response, 200, { runs: runs.map(projectRunForApi) });
         }
         catch (error) {
             logger.error(`Failed to list runs: ${error}`);
@@ -24,7 +32,7 @@ function registerRunRoutes(server, options) {
     server.get('/v1/runs/:runId', async (request, response, params) => {
         try {
             const run = await runStore.loadRun(decodeURIComponent(params.runId), buildStoreContext(request));
-            sendJson(response, 200, { run });
+            sendJson(response, 200, { run: projectRunForApi(run) });
         }
         catch (error) {
             logger.error(`Failed to load run: ${error}`);
@@ -34,7 +42,7 @@ function registerRunRoutes(server, options) {
     server.get('/v1/runs/:runId/steps', async (request, response, params) => {
         try {
             const steps = await runStore.loadRunSteps(decodeURIComponent(params.runId), buildStoreContext(request));
-            sendJson(response, 200, { steps });
+            sendJson(response, 200, { steps: steps.map(projectRunStepForApi) });
         }
         catch (error) {
             logger.error(`Failed to load run steps: ${error}`);
@@ -59,12 +67,8 @@ function registerRunRoutes(server, options) {
                 id: (0, store_1.generateRunStepResourceId)({
                     key: (0, types_1.generateId)('run-step'),
                     runId: run.id,
-                    commandKind: run.commandKind,
-                    surfaceId: run.surfaceId,
                     createdAt: now,
                 }),
-                commandKind: run.commandKind,
-                surfaceId: run.surfaceId,
                 runId: run.id,
                 run: resolveRunResource(run, context),
                 type: schema_1.RunStepType.CANCEL_REQUESTED,
@@ -72,7 +76,7 @@ function registerRunRoutes(server, options) {
                 data: { status: run.status },
                 createdAt: now,
             }, context);
-            sendJson(response, 200, { run });
+            sendJson(response, 200, { run: projectRunForApi(run) });
         }
         catch (error) {
             logger.error(`Failed to cancel run: ${error}`);
@@ -80,18 +84,32 @@ function registerRunRoutes(server, options) {
         }
     });
 }
-function parseRunListOptions(url) {
+function projectRunForApi(run) {
+    return {
+        ...run,
+        ...(0, store_1.deriveRunCommandProjection)(run.id),
+    };
+}
+function projectRunStepForApi(step) {
+    return {
+        ...step,
+        ...(0, store_1.deriveRunCommandProjection)(step.runId || step.id),
+    };
+}
+function parseRunListRequest(url) {
     const workspace = url.searchParams.get('workspace') ?? undefined;
     if (workspace && !(0, types_2.isWorkspaceRef)(workspace)) {
         throw new Error('workspace must be an http(s):// or file:// workspace reference');
     }
     return {
-        task: url.searchParams.get('task') ?? undefined,
-        thread: url.searchParams.get('thread') ?? undefined,
-        workspace,
+        storeOptions: {
+            task: url.searchParams.get('task') ?? undefined,
+            thread: url.searchParams.get('thread') ?? undefined,
+            workspace,
+            status: parseRunStatus(url.searchParams.get('status')),
+            limit: parseOptionalNumber(url.searchParams.get('limit')),
+        },
         commandKind: parseCommandKind(url.searchParams.get('commandKind')),
-        status: parseRunStatus(url.searchParams.get('status')),
-        limit: parseOptionalNumber(url.searchParams.get('limit')),
     };
 }
 function parseCommandKind(value) {