@beacon-build/sdk 1.15.0

package/dist/manifest.js

@@ -0,0 +1,700 @@
+/**
+ * SDK Endpoint Manifest — F224
+ *
+ * Maps every (method, path) tuple from the beacon OpenAPI spec to an SDK method.
+ * Used by the OpenAPI coverage test to prevent drift between API and SDK.
+ *
+ * INV-3: every (method, path) in /api/openapi-generated.json must appear either
+ * in SDK_MANIFEST or SDK_NEGATIVE_LIST.
+ * INV-11: handwritten, not code-generated. Maintain this file when adding new API endpoints.
+ */
+export const SDK_MANIFEST = [
+    // ── Auth ──────────────────────────────────────────────────────────────────
+    { method: 'POST', path: '/api/auth/login', sdkPath: 'auth.login', authMode: 'public' },
+    { method: 'POST', path: '/api/auth/register', sdkPath: 'auth.register', authMode: 'public' },
+    { method: 'POST', path: '/api/auth/refresh', sdkPath: 'auth.refresh', authMode: 'public' },
+    { method: 'POST', path: '/api/auth/logout', sdkPath: 'auth.logout', authMode: 'public' },
+    { method: 'GET', path: '/api/auth/me', sdkPath: 'auth.me', authMode: 'public' },
+    // ── Users ─────────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/users', sdkPath: 'admin.users.list', authMode: 'admin' },
+    { method: 'GET', path: '/api/v1/users/me', sdkPath: 'admin.users.me', authMode: 'admin' },
+    {
+        method: 'PATCH',
+        path: '/api/v1/users/me',
+        sdkPath: 'admin.users.updateProfile',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/users/me/avatar',
+        sdkPath: 'admin.users.uploadAvatar',
+        authMode: 'admin',
+        notes: 'multipart/form-data',
+    },
+    {
+        method: 'DELETE',
+        path: '/api/v1/users/me/avatar',
+        sdkPath: 'admin.users.deleteAvatar',
+        authMode: 'admin',
+    },
+    // ── Organizations ─────────────────────────────────────────────────────────
+    {
+        method: 'GET',
+        path: '/api/v1/organizations',
+        sdkPath: 'admin.organizations.list',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/organizations',
+        sdkPath: 'admin.organizations.create',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/organizations/{slug}',
+        sdkPath: 'admin.organizations.get',
+        authMode: 'admin',
+    },
+    {
+        method: 'PATCH',
+        path: '/api/v1/organizations/{slug}',
+        sdkPath: 'admin.organizations.update',
+        authMode: 'admin',
+    },
+    {
+        method: 'DELETE',
+        path: '/api/v1/organizations/{slug}',
+        sdkPath: 'admin.organizations.delete',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/organizations/{slug}/members',
+        sdkPath: 'admin.organizations.addMember',
+        authMode: 'admin',
+    },
+    {
+        method: 'DELETE',
+        path: '/api/v1/organizations/{slug}/members/{userId}',
+        sdkPath: 'admin.organizations.removeMember',
+        authMode: 'admin',
+    },
+    // ── Projects ──────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/projects', sdkPath: 'admin.projects.list', authMode: 'admin' },
+    {
+        method: 'GET',
+        path: '/api/v1/projects/{slug}',
+        sdkPath: 'admin.projects.get',
+        authMode: 'admin',
+    },
+    {
+        method: 'DELETE',
+        path: '/api/v1/projects/{slug}',
+        sdkPath: 'admin.projects.delete',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/projects/upsert',
+        sdkPath: 'ops.projects.upsert',
+        authMode: 'ops',
+    },
+    // ── Agents ────────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/agents', sdkPath: 'admin.agents.list', authMode: 'admin' },
+    { method: 'POST', path: '/api/v1/agents', sdkPath: 'admin.agents.create', authMode: 'admin' },
+    {
+        method: 'GET',
+        path: '/api/v1/agents/active',
+        sdkPath: 'admin.agents.listActive',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/agents/by-alias',
+        sdkPath: 'admin.agents.byAlias',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/agents/active-session',
+        sdkPath: 'admin.agents.getActiveSession',
+        authMode: 'admin',
+    },
+    { method: 'GET', path: '/api/v1/agents/{id}', sdkPath: 'admin.agents.get', authMode: 'admin' },
+    {
+        method: 'PATCH',
+        path: '/api/v1/agents/{id}',
+        sdkPath: 'admin.agents.rename',
+        authMode: 'admin',
+    },
+    {
+        method: 'PATCH',
+        path: '/api/v1/agents/{id}/identity',
+        sdkPath: 'admin.agents.updateIdentity',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/agents/{id}/config',
+        sdkPath: 'admin.agents.configGetAll',
+        authMode: 'admin',
+    },
+    {
+        method: 'PATCH',
+        path: '/api/v1/agents/{id}/config',
+        sdkPath: 'admin.agents.configSet',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/agents/resolve-affinity',
+        sdkPath: 'admin.agents.resolveAffinity',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/agents/upsert',
+        sdkPath: 'ops.agents.upsert',
+        authMode: 'ops',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/agent-token',
+        sdkPath: 'admin.agents.issueToken',
+        authMode: 'admin',
+    },
+    // ── Assets ────────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/assets', sdkPath: 'admin.assets.list', authMode: 'admin' },
+    {
+        method: 'POST',
+        path: '/api/v1/assets',
+        sdkPath: 'admin.assets.upload',
+        authMode: 'admin',
+        notes: 'multipart/form-data',
+    },
+    {
+        method: 'DELETE',
+        path: '/api/v1/assets/{id}',
+        sdkPath: 'admin.assets.delete',
+        authMode: 'admin',
+    },
+    // ── Tasks (Admin) ─────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/tasks', sdkPath: 'admin.tasks.list', authMode: 'admin' },
+    { method: 'GET', path: '/api/v1/tasks/{id}', sdkPath: 'admin.tasks.get', authMode: 'admin' },
+    {
+        method: 'PATCH',
+        path: '/api/v1/tasks/{id}',
+        sdkPath: 'admin.tasks.update',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/tasks/{id}/cancel',
+        sdkPath: 'admin.tasks.cancel',
+        authMode: 'admin',
+    },
+    { method: 'POST', path: '/api/v1/tasks', sdkPath: 'ops.tasks.create', authMode: 'ops' },
+    {
+        method: 'POST',
+        path: '/api/v1/tasks/{id}/complete',
+        sdkPath: 'ops.tasks.complete',
+        authMode: 'ops',
+    },
+    // ── Documents ─────────────────────────────────────────────────────────────
+    {
+        method: 'GET',
+        path: '/api/v1/documents',
+        sdkPath: 'admin.documents.list',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/documents/get',
+        sdkPath: 'admin.documents.get',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/documents/upsert',
+        sdkPath: 'admin.documents.upsert',
+        authMode: 'admin',
+    },
+    {
+        method: 'DELETE',
+        path: '/api/v1/documents/{id}',
+        sdkPath: 'admin.documents.delete',
+        authMode: 'admin',
+    },
+    // ── Memories ──────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/memories', sdkPath: 'admin.memories.list', authMode: 'admin' },
+    {
+        method: 'POST',
+        path: '/api/v1/memories',
+        sdkPath: 'admin.memories.upsert',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/memories/for-session',
+        sdkPath: 'admin.memories.findForSession',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/memories/search-by-vector',
+        sdkPath: 'admin.memories.searchByVector',
+        authMode: 'admin',
+    },
+    {
+        method: 'DELETE',
+        path: '/api/v1/memories/{id}',
+        sdkPath: 'admin.memories.delete',
+        authMode: 'admin',
+    },
+    {
+        method: 'DELETE',
+        path: '/api/v1/memories/by-key',
+        sdkPath: 'admin.memories.deleteByKey',
+        authMode: 'admin',
+    },
+    // ── Alerts ────────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/alerts', sdkPath: 'admin.alerts.list', authMode: 'admin' },
+    // ── Usage ─────────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/usage', sdkPath: 'admin.usage.list', authMode: 'admin' },
+    {
+        method: 'GET',
+        path: '/api/v1/usage/summary',
+        sdkPath: 'admin.usage.summary',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/usage/workflows',
+        sdkPath: 'ops.usageWorkflows.log',
+        authMode: 'ops',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/usage/workflows',
+        sdkPath: 'ops.usageWorkflows.list',
+        authMode: 'ops',
+    },
+    // ── Sessions ──────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/sessions', sdkPath: 'admin.sessions.list', authMode: 'admin' },
+    {
+        method: 'GET',
+        path: '/api/v1/sessions/{id}',
+        sdkPath: 'admin.sessions.get',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/sessions/by-key',
+        sdkPath: 'admin.sessions.byKey',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/sessions/by-external',
+        sdkPath: 'admin.sessions.byExternal',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/sessions/{id}/tool-calls',
+        sdkPath: 'admin.sessions.toolCallSummary',
+        authMode: 'admin',
+    },
+    { method: 'POST', path: '/api/v1/sessions', sdkPath: 'ops.sessions.create', authMode: 'ops' },
+    {
+        method: 'POST',
+        path: '/api/v1/sessions/{id}/heartbeat',
+        sdkPath: 'ops.sessions.heartbeat',
+        authMode: 'ops',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/sessions/{id}/terminate',
+        sdkPath: 'ops.sessions.terminate',
+        authMode: 'ops',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/sessions/terminate-by-agent',
+        sdkPath: 'ops.sessions.terminateByAgent',
+        authMode: 'ops',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/sessions/{id}/external-id',
+        sdkPath: 'ops.sessions.registerExternalId',
+        authMode: 'ops',
+    },
+    // ── Tool Calls ────────────────────────────────────────────────────────────
+    {
+        method: 'POST',
+        path: '/api/v1/tool-calls',
+        sdkPath: 'admin.toolCalls.create',
+        authMode: 'admin',
+    },
+    {
+        method: 'PATCH',
+        path: '/api/v1/tool-calls/{id}',
+        sdkPath: 'admin.toolCalls.updateStatus',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/tool-calls/set-message-id',
+        sdkPath: 'admin.toolCalls.setMessageId',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/tool-calls/by-session/{id}',
+        sdkPath: 'admin.toolCalls.findBySession',
+        authMode: 'admin',
+    },
+    // ── Planning ──────────────────────────────────────────────────────────────
+    {
+        method: 'GET',
+        path: '/api/v1/planning/velocity',
+        sdkPath: 'admin.planning.velocity',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/planning/timesheet',
+        sdkPath: 'admin.planning.timesheet',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/planning/roadmap',
+        sdkPath: 'admin.planning.roadmap',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/planning/project-log',
+        sdkPath: 'admin.planning.projectLog',
+        authMode: 'admin',
+    },
+    // ── Conversation Messages ─────────────────────────────────────────────────
+    {
+        method: 'GET',
+        path: '/api/v1/conversation-messages',
+        sdkPath: 'admin.conversationMessages.listBySession',
+        authMode: 'admin',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/conversation-messages/{id}',
+        sdkPath: 'admin.conversationMessages.get',
+        authMode: 'admin',
+    },
+    {
+        method: 'DELETE',
+        path: '/api/v1/conversation-messages/{id}',
+        sdkPath: 'admin.conversationMessages.delete',
+        authMode: 'admin',
+    },
+    {
+        method: 'PATCH',
+        path: '/api/v1/conversation-messages/{id}/tokens',
+        sdkPath: 'admin.conversationMessages.updateTokens',
+        authMode: 'admin',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/conversation-messages',
+        sdkPath: 'ops.conversationMessages.create',
+        authMode: 'ops',
+    },
+    // ── DB Info ───────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/db/stats', sdkPath: 'admin.db.stats', authMode: 'admin' },
+    {
+        method: 'GET',
+        path: '/api/v1/db/migrations',
+        sdkPath: 'admin.db.migrations',
+        authMode: 'admin',
+    },
+    // ── Board Messages (Admin read, deprecated F114) ───────────────────────────
+    {
+        method: 'GET',
+        path: '/api/v1/board-messages',
+        sdkPath: 'admin.boardMessages.list',
+        authMode: 'admin',
+        notes: '@deprecated F114',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/board-messages',
+        sdkPath: 'ops.boardMessages.post',
+        authMode: 'ops',
+        notes: '@deprecated F114',
+    },
+    // ── GitHub Proxy ──────────────────────────────────────────────────────────
+    {
+        method: 'POST',
+        path: '/api/v1/github/proxy',
+        sdkPath: 'admin.github.proxy',
+        authMode: 'admin',
+    },
+    // ── Realtime ──────────────────────────────────────────────────────────────
+    {
+        method: 'POST',
+        path: '/api/v1/realtime/notify',
+        sdkPath: 'ops.realtime.notify',
+        authMode: 'ops',
+    },
+    // ── Ops DB ────────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/ops/db/stats', sdkPath: 'ops.db.stats', authMode: 'ops' },
+    {
+        method: 'GET',
+        path: '/api/v1/ops/db/migrations',
+        sdkPath: 'ops.db.migrations',
+        authMode: 'ops',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/ops/db/migration-status',
+        sdkPath: 'ops.db.migrationStatus',
+        authMode: 'ops',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/ops/db/migrate',
+        sdkPath: 'ops.db.migrate',
+        authMode: 'ops',
+        notes: 'SSE',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/ops/db/seed',
+        sdkPath: 'ops.db.seed',
+        authMode: 'ops',
+        notes: 'SSE',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/ops/db/reset',
+        sdkPath: 'ops.db.reset',
+        authMode: 'ops',
+        notes: 'SSE',
+    },
+    // ── Ops Storage ───────────────────────────────────────────────────────────
+    {
+        method: 'GET',
+        path: '/api/v1/ops/storage/buckets',
+        sdkPath: 'ops.storage.buckets',
+        authMode: 'ops',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/ops/storage/{bucket}',
+        sdkPath: 'ops.storage.list',
+        authMode: 'ops',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/ops/storage/{bucket}/upload',
+        sdkPath: 'ops.storage.upload',
+        authMode: 'ops',
+        notes: 'multipart/form-data',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/ops/storage/{bucket}/{key}',
+        sdkPath: 'ops.storage.download',
+        authMode: 'ops',
+        notes: 'binary',
+    },
+    {
+        method: 'DELETE',
+        path: '/api/v1/ops/storage/{bucket}/{key}',
+        sdkPath: 'ops.storage.delete',
+        authMode: 'ops',
+    },
+    // ── Ops Northflank ────────────────────────────────────────────────────────
+    {
+        method: 'GET',
+        path: '/api/v1/ops/services',
+        sdkPath: 'ops.northflank.listServices',
+        authMode: 'ops',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/ops/services/{id}',
+        sdkPath: 'ops.northflank.getService',
+        authMode: 'ops',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/ops/services/{id}/restart',
+        sdkPath: 'ops.northflank.restartService',
+        authMode: 'ops',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/ops/services/{id}/logs',
+        sdkPath: 'ops.northflank.streamLogs',
+        authMode: 'ops',
+        notes: 'SSE',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/ops/jobs/run',
+        sdkPath: 'ops.northflank.runJob',
+        authMode: 'ops',
+        notes: 'SSE',
+    },
+    {
+        method: 'GET',
+        path: '/api/v1/ops/jobs',
+        sdkPath: 'ops.northflank.listJobs',
+        authMode: 'ops',
+    },
+    // ── Ops MQ ────────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/ops/mq/stats', sdkPath: 'ops.mq.stats', authMode: 'ops' },
+    {
+        method: 'POST',
+        path: '/api/v1/ops/mq/{queue}/drain',
+        sdkPath: 'ops.mq.drain',
+        authMode: 'ops',
+    },
+    {
+        method: 'POST',
+        path: '/api/v1/ops/mq/{queue}/retry-failed',
+        sdkPath: 'ops.mq.retryFailed',
+        authMode: 'ops',
+    },
+    // ── Ops Logs ──────────────────────────────────────────────────────────────
+    { method: 'GET', path: '/api/v1/ops/logs', sdkPath: 'ops.logs.search', authMode: 'ops' },
+    // ── Agent Tasks (/api/agent/v1/*) ─────────────────────────────────────────
+    {
+        method: 'POST',
+        path: '/api/agent/v1/tasks/next',
+        sdkPath: 'agent.tasks.next',
+        authMode: 'agent',
+    },
+    { method: 'GET', path: '/api/agent/v1/tasks', sdkPath: 'agent.tasks.list', authMode: 'agent' },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/tasks',
+        sdkPath: 'agent.tasks.create',
+        authMode: 'agent',
+    },
+    {
+        method: 'GET',
+        path: '/api/agent/v1/tasks/{ref}',
+        sdkPath: 'agent.tasks.get',
+        authMode: 'agent',
+    },
+    {
+        method: 'PATCH',
+        path: '/api/agent/v1/tasks/{ref}',
+        sdkPath: 'agent.tasks.update',
+        authMode: 'agent',
+    },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/tasks/{ref}/log',
+        sdkPath: 'agent.tasks.log',
+        authMode: 'agent',
+    },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/tasks/{ref}/claim',
+        sdkPath: 'agent.tasks.claim',
+        authMode: 'agent',
+    },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/tasks/{ref}/complete',
+        sdkPath: 'agent.tasks.complete',
+        authMode: 'agent',
+    },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/tasks/{ref}/fail',
+        sdkPath: 'agent.tasks.fail',
+        authMode: 'agent',
+    },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/tasks/{ref}/cancel',
+        sdkPath: 'agent.tasks.cancel',
+        authMode: 'agent',
+    },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/tasks/{ref}/reassign',
+        sdkPath: 'agent.tasks.reassign',
+        authMode: 'agent',
+    },
+    // ── Agent Messaging (/api/agent/v1/*) ─────────────────────────────────────
+    {
+        method: 'GET',
+        path: '/api/agent/v1/messages/inbox',
+        sdkPath: 'agent.messaging.inbox',
+        authMode: 'agent',
+    },
+    {
+        method: 'GET',
+        path: '/api/agent/v1/messages/threads/{id}',
+        sdkPath: 'agent.messaging.thread',
+        authMode: 'agent',
+    },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/messages',
+        sdkPath: 'agent.messaging.send',
+        authMode: 'agent',
+    },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/messages/threads/{id}/reply',
+        sdkPath: 'agent.messaging.reply',
+        authMode: 'agent',
+    },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/messages/threads/{id}/ack',
+        sdkPath: 'agent.messaging.acknowledge',
+        authMode: 'agent',
+    },
+    {
+        method: 'POST',
+        path: '/api/agent/v1/messages/threads/{id}/claim',
+        sdkPath: 'agent.messaging.claim',
+        authMode: 'agent',
+    },
+];
+export const SDK_NEGATIVE_LIST = [
+    {
+        method: 'GET',
+        path: '/api/auth/google',
+        reason: 'OAuth browser redirect flow — no SDK use case',
+    },
+    {
+        method: 'GET',
+        path: '/api/auth/google/callback',
+        reason: 'OAuth browser redirect flow — no SDK use case',
+    },
+    { method: 'GET', path: '/api/health', reason: 'Internal health probe' },
+    { method: 'GET', path: '/api/v1/probe/{...}', reason: 'Internal probe' },
+    {
+        method: 'GET',
+        path: '/api/openapi-generated.json',
+        reason: 'OpenAPI spec endpoint — consumed by coverage test, not SDK',
+    },
+    { method: 'GET', path: '/api/docs', reason: 'Swagger UI — browser only' },
+    {
+        method: 'GET',
+        path: '/api/v1/realtime/subscribe',
+        reason: 'SSE subscription — use RealtimeSdkClient (F141) directly',
+    },
+];
+//# sourceMappingURL=manifest.js.map