@becklabs/beck-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,135 @@
+# @becklabs/beck-mcp-server
+
+MCP (Model Context Protocol) server for Beck project management. This enables Claude Code to work directly on Beck documents, epics, and tasks.
+
+## Features
+
+**Identity & workspaces**
+- **whoami** — Token identity
+- **list_workspaces** — Discover workspaces this token can see (org-scoped; not a default)
+- **create_workspace** — Create a workspace (default: only if the human asked)
+
+**Documents**
+- **list_documents** / **read_document** / **create_document** / **write_document** — Planning corpus (etag required on write)
+- **delete_document** / **list_document_versions** / **restore_document** — Etag-guarded delete and version restore
+
+**Epics & Plan it**
+- **list_epics** / **get_epic** — Spec, last-plan provenance, tasks, suggested breakdown
+- **plan_it** — Snapshot docs into epics and break down tasks (a human imports)
+- **link_epic_github** / **get_epic_github** — Manual branch / PR on an epic
+
+**Tasks**
+- **list_tasks** — Filter by status, epic, assignee, or icebox
+- **get_task** / **get_task_context** — Details plus comments, spec, related work
+- **recommend_task** — What to work on next
+- **start_task** / **finish_task** — Claim and submit for review
+- **accept_task** / **reject_task** — Complete or send back (default: only if the human asked you to review)
+- **update_task** — Title, type, points, tags, epic, description, blocked, criteria, files
+- **set_relevant_files** — Files that matter for the next session
+- **add_comment** / **list_comments**
+- **log_progress** / **list_progress** — Structured work logs
+
+**Resources**
+- `beck://skill.md` and `beck://llms.txt` — live agent pack
+- `beck://workspace/{id}/document/{path}` — document bodies
+
+## Installation
+
+### For Claude Code
+
+**Option 1: CLI Command (Recommended)**
+
+```bash
+claude mcp add beck --transport stdio \
+  -e BECK_API_TOKEN=beck_your_token_here \
+  -e BECK_API_URL=https://beck.bot \
+  --scope user -- npx -y @becklabs/beck-mcp-server
+```
+
+**Option 2: Manual Configuration**
+
+Add to your `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "beck": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@becklabs/beck-mcp-server"],
+      "env": {
+        "BECK_API_TOKEN": "beck_your_token_here",
+        "BECK_API_URL": "https://beck.bot"
+      }
+    }
+  }
+}
+```
+
+After setup, restart Claude Code and run `/mcp` to verify the server is connected.
+
+### Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `BECK_API_TOKEN` | Yes | - | API token from Beck (Settings > API Tokens) |
+| `BECK_API_URL` | No | `https://beck.bot` | Beck instance URL |
+
+## Usage
+
+Agents should read `https://beck.bot/llms.txt` and `https://beck.bot/skill.md` first (also available as MCP resources). Those are canonical; a locally installed skill copy goes stale.
+
+Typical start: the human pastes a prompt from Documents → Point an agent (workspace name + id). Then:
+
+1. **Bind**: use only that workspace. `list_workspaces` and ask if none was named. `create_workspace` only if they asked.
+2. **Plan**: `list_documents` → create `prd` if missing → `write_document` with etag
+3. **Plan it** when asked. `get_epic` to re-read the snapshot spec. A human imports tasks unless they asked you to.
+4. **Execute**: `start_task` → work → `log_progress` → `finish_task`. `accept_task` / `reject_task` only if they asked you to review.
+
+Defaults live in `/skill.md`, not in access control. The human's prompt overrides those defaults. The tools always exist.
+
+## Development
+
+```bash
+# From this package directory
+npx tsc --project tsconfig.json
+
+# Or from the repo root
+pnpm --filter @becklabs/beck-mcp-server build
+
+# Run locally
+BECK_API_TOKEN=beck_xxx node dist/index.js
+```
+
+After changing `src/`, rebuild `dist/` — that is what the stdio server runs. Do not run `pnpm build` from this folder; the workspace script builds the Next.js app.
+
+## API Reference
+
+The MCP server wraps the Beck REST API:
+
+- `GET /api/v1/me` - Token identity
+- `GET /api/v1/workspaces` - List workspaces
+- `POST /api/v1/workspaces` - Create a workspace
+- `GET /api/v1/workspaces/:id/tasks` - List tasks
+- `GET /api/v1/workspaces/:id/recommend` - Recommend next task
+- `GET /api/v1/workspaces/:id/documents` - List documents
+- `GET/PUT/DELETE /api/v1/workspaces/:id/documents/:path` - Read / write / delete
+- `GET /api/v1/workspaces/:id/documents/:path/versions` - Version history
+- `POST /api/v1/workspaces/:id/documents/:path/restore` - Restore a version
+- `GET /api/v1/workspaces/:id/epics` - List epics
+- `POST /api/v1/workspaces/:id/plan` - Plan it
+- `GET /api/v1/epics/:id` - Get epic
+- `GET/PATCH /api/v1/epics/:id/github` - Epic GitHub link
+- `GET /api/v1/tasks/:id` - Get task
+- `GET /api/v1/tasks/:id/context` - Task context
+- `POST /api/v1/tasks/:id/start` - Start task
+- `POST /api/v1/tasks/:id/finish` - Finish task
+- `POST /api/v1/tasks/:id/accept` - Accept review
+- `POST /api/v1/tasks/:id/reject` - Reject review (`reason` required)
+- `PATCH /api/v1/tasks/:id` - Update task
+- `GET/POST /api/v1/tasks/:id/comments` - Comments
+- `GET/POST /api/v1/tasks/:id/progress` - Progress updates
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,151 @@
+import type { Task, Workspace, Comment, TaskContext, ProgressUpdate, TaskRecommendation, Document, DocumentVersion, EpicDetail, EpicSummary, Me } from "./types.js";
+export interface BeckClientConfig {
+    apiUrl: string;
+    apiToken: string;
+}
+/**
+ * Client for the Beck REST API
+ */
+export declare class BeckAPIClient {
+    private baseUrl;
+    private token;
+    constructor(config: BeckClientConfig);
+    private request;
+    /**
+     * List all workspaces accessible by the authenticated user
+     */
+    listWorkspaces(): Promise<Workspace[]>;
+    createWorkspace(input: {
+        name: string;
+        description?: string;
+    }): Promise<{
+        id: string;
+    }>;
+    /**
+     * List tasks in a workspace
+     */
+    listTasks(workspaceId: string, options?: {
+        status?: "not_started" | "started" | "ready_for_review" | "completed";
+        epicId?: string;
+        assigneeId?: string;
+        isIcebox?: boolean;
+    }): Promise<Task[]>;
+    /**
+     * Get a single task by ID
+     */
+    getTask(taskId: string): Promise<Task>;
+    /**
+     * Start working on a task
+     */
+    startTask(taskId: string): Promise<Task>;
+    /**
+     * Submit a task for review
+     */
+    finishTask(taskId: string): Promise<Task>;
+    acceptTask(taskId: string): Promise<Task>;
+    rejectTask(taskId: string, reason: string): Promise<Task>;
+    /**
+     * Update a task
+     */
+    updateTask(taskId: string, updates: {
+        title?: string;
+        description?: string;
+        type?: "feature" | "bug" | "chore";
+        status?: "not_started" | "started" | "ready_for_review" | "completed";
+        points?: number;
+        isBlocked?: boolean;
+        blockedReason?: string;
+        isDelivered?: boolean;
+        acceptanceCriteria?: Array<{
+            text: string;
+            completed: boolean;
+        }>;
+        tags?: string[];
+        relevantFiles?: Array<{
+            path: string;
+            purpose?: string;
+        }>;
+        epicId?: string | null;
+    }): Promise<{
+        id: string;
+    }>;
+    /**
+     * List comments on a task
+     */
+    listComments(taskId: string): Promise<Comment[]>;
+    /**
+     * Add a comment to a task
+     */
+    addComment(taskId: string, content: string): Promise<string>;
+    /**
+     * Get rich context for a task (for starting work)
+     * Includes task details, epic with spec, related tasks, comments, and activity
+     */
+    getTaskContext(taskId: string): Promise<TaskContext>;
+    /**
+     * List progress updates for a task
+     */
+    listProgressUpdates(taskId: string): Promise<ProgressUpdate[]>;
+    /**
+     * Log a structured progress update
+     */
+    logProgress(taskId: string, progress: {
+        whatAttempted: string;
+        whatSucceeded?: string;
+        whatFailed?: string;
+        questions?: string[];
+        blockers?: string[];
+    }): Promise<string>;
+    /**
+     * Link a GitHub branch or PR to an epic
+     */
+    linkEpicGithub(epicId: string, options: {
+        branch?: string;
+        prUrl?: string;
+    }): Promise<void>;
+    /**
+     * Get GitHub info for an epic
+     */
+    getEpicGithub(epicId: string): Promise<{
+        githubBranch: string | null;
+        githubPrUrl: string | null;
+    }>;
+    getMe(): Promise<Me>;
+    getEpic(epicId: string): Promise<EpicDetail>;
+    deleteDocument(workspaceId: string, path: string, etag: string): Promise<void>;
+    listDocumentVersions(workspaceId: string, path: string): Promise<{
+        documentId: string;
+        path: string;
+        versions: DocumentVersion[];
+    }>;
+    restoreDocument(workspaceId: string, path: string, input: {
+        versionId: string;
+        etag: string;
+    }): Promise<Document>;
+    listDocuments(workspaceId: string): Promise<Document[]>;
+    getDocument(workspaceId: string, path: string): Promise<Document>;
+    createDocument(workspaceId: string, input: {
+        path: string;
+        title?: string;
+        body?: string;
+    }): Promise<Document>;
+    writeDocument(workspaceId: string, path: string, input: {
+        title?: string;
+        body?: string;
+        path?: string;
+        etag: string;
+    }): Promise<Document>;
+    listEpics(workspaceId: string): Promise<EpicSummary[]>;
+    planIt(workspaceId: string, input: {
+        documentIds?: string[];
+        paths?: string[];
+        epicIds?: string[];
+        title?: string;
+        runBreakdown?: boolean;
+    }): Promise<unknown>;
+    recommendTasks(workspaceId: string, options?: {
+        epicId?: string;
+        limit?: number;
+    }): Promise<TaskRecommendation[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,217 @@
+/**
+ * Client for the Beck REST API
+ */
+export class BeckAPIClient {
+    baseUrl;
+    token;
+    constructor(config) {
+        // Remove trailing slash from URL
+        this.baseUrl = config.apiUrl.replace(/\/$/, "");
+        this.token = config.apiToken;
+    }
+    async request(method, path, body, extraHeaders) {
+        const url = `${this.baseUrl}${path}`;
+        const response = await fetch(url, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                "Content-Type": "application/json",
+                ...extraHeaders,
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errorBody = await response.json().catch(() => ({
+                error: `HTTP ${response.status}: ${response.statusText}`,
+            }));
+            throw new Error(errorBody.error || `Request failed: ${response.status}`);
+        }
+        // Handle 204 No Content
+        if (response.status === 204) {
+            return {};
+        }
+        return response.json();
+    }
+    // ============ Workspaces ============
+    /**
+     * List all workspaces accessible by the authenticated user
+     */
+    async listWorkspaces() {
+        const response = await this.request("GET", "/api/v1/workspaces");
+        return response.workspaces;
+    }
+    async createWorkspace(input) {
+        return this.request("POST", "/api/v1/workspaces", input);
+    }
+    // ============ Tasks ============
+    /**
+     * List tasks in a workspace
+     */
+    async listTasks(workspaceId, options) {
+        const params = new URLSearchParams();
+        if (options?.status)
+            params.set("status", options.status);
+        if (options?.epicId)
+            params.set("epicId", options.epicId);
+        if (options?.assigneeId)
+            params.set("assigneeId", options.assigneeId);
+        if (options?.isIcebox)
+            params.set("isIcebox", "true");
+        const query = params.toString();
+        const path = `/api/v1/workspaces/${workspaceId}/tasks${query ? `?${query}` : ""}`;
+        const response = await this.request("GET", path);
+        return response.tasks;
+    }
+    /**
+     * Get a single task by ID
+     */
+    async getTask(taskId) {
+        const response = await this.request("GET", `/api/v1/tasks/${taskId}`);
+        return response.task;
+    }
+    /**
+     * Start working on a task
+     */
+    async startTask(taskId) {
+        const response = await this.request("POST", `/api/v1/tasks/${taskId}/start`);
+        return response.task;
+    }
+    /**
+     * Submit a task for review
+     */
+    async finishTask(taskId) {
+        const response = await this.request("POST", `/api/v1/tasks/${taskId}/finish`);
+        return response.task;
+    }
+    async acceptTask(taskId) {
+        const response = await this.request("POST", `/api/v1/tasks/${taskId}/accept`);
+        return response.task;
+    }
+    async rejectTask(taskId, reason) {
+        const response = await this.request("POST", `/api/v1/tasks/${taskId}/reject`, { reason });
+        return response.task;
+    }
+    /**
+     * Update a task
+     */
+    async updateTask(taskId, updates) {
+        return this.request("PATCH", `/api/v1/tasks/${taskId}`, updates);
+    }
+    // ============ Comments ============
+    /**
+     * List comments on a task
+     */
+    async listComments(taskId) {
+        const response = await this.request("GET", `/api/v1/tasks/${taskId}/comments`);
+        return response.comments;
+    }
+    /**
+     * Add a comment to a task
+     */
+    async addComment(taskId, content) {
+        const response = await this.request("POST", `/api/v1/tasks/${taskId}/comments`, { content });
+        return response.id;
+    }
+    // ============ Task Context ============
+    /**
+     * Get rich context for a task (for starting work)
+     * Includes task details, epic with spec, related tasks, comments, and activity
+     */
+    async getTaskContext(taskId) {
+        return this.request("GET", `/api/v1/tasks/${taskId}/context`);
+    }
+    // ============ Progress Updates ============
+    /**
+     * List progress updates for a task
+     */
+    async listProgressUpdates(taskId) {
+        const response = await this.request("GET", `/api/v1/tasks/${taskId}/progress`);
+        return response.progressUpdates;
+    }
+    /**
+     * Log a structured progress update
+     */
+    async logProgress(taskId, progress) {
+        const response = await this.request("POST", `/api/v1/tasks/${taskId}/progress`, progress);
+        return response.id;
+    }
+    // ============ Epic GitHub Integration ============
+    /**
+     * Link a GitHub branch or PR to an epic
+     */
+    async linkEpicGithub(epicId, options) {
+        await this.request("PATCH", `/api/v1/epics/${epicId}/github`, options);
+    }
+    /**
+     * Get GitHub info for an epic
+     */
+    async getEpicGithub(epicId) {
+        return this.request("GET", `/api/v1/epics/${epicId}/github`);
+    }
+    async getMe() {
+        return this.request("GET", "/api/v1/me");
+    }
+    async getEpic(epicId) {
+        const response = await this.request("GET", `/api/v1/epics/${epicId}`);
+        return response.epic;
+    }
+    async deleteDocument(workspaceId, path, etag) {
+        if (!etag) {
+            throw new Error("etag is required to delete a document. Read the document first and pass its etag.");
+        }
+        const encoded = path.split("/").map(encodeURIComponent).join("/");
+        await this.request("DELETE", `/api/v1/workspaces/${workspaceId}/documents/${encoded}`, undefined, { "If-Match": etag });
+    }
+    async listDocumentVersions(workspaceId, path) {
+        const encoded = path.split("/").map(encodeURIComponent).join("/");
+        return this.request("GET", `/api/v1/workspaces/${workspaceId}/documents/${encoded}/versions`);
+    }
+    async restoreDocument(workspaceId, path, input) {
+        if (!input.etag) {
+            throw new Error("etag is required to restore a document. Read the document first and pass its etag.");
+        }
+        const encoded = path.split("/").map(encodeURIComponent).join("/");
+        const response = await this.request("POST", `/api/v1/workspaces/${workspaceId}/documents/${encoded}/restore`, { versionId: input.versionId }, { "If-Match": input.etag });
+        return response.document;
+    }
+    async listDocuments(workspaceId) {
+        const response = await this.request("GET", `/api/v1/workspaces/${workspaceId}/documents`);
+        return response.documents;
+    }
+    async getDocument(workspaceId, path) {
+        const encoded = path.split("/").map(encodeURIComponent).join("/");
+        const response = await this.request("GET", `/api/v1/workspaces/${workspaceId}/documents/${encoded}`);
+        return response.document;
+    }
+    async createDocument(workspaceId, input) {
+        const response = await this.request("POST", `/api/v1/workspaces/${workspaceId}/documents`, input);
+        return response.document;
+    }
+    async writeDocument(workspaceId, path, input) {
+        if (!input.etag) {
+            throw new Error("etag is required to write a document. Read the document first and pass its etag.");
+        }
+        const encoded = path.split("/").map(encodeURIComponent).join("/");
+        const response = await this.request("PUT", `/api/v1/workspaces/${workspaceId}/documents/${encoded}`, { title: input.title, body: input.body, path: input.path }, { "If-Match": input.etag });
+        return response.document;
+    }
+    async listEpics(workspaceId) {
+        const response = await this.request("GET", `/api/v1/workspaces/${workspaceId}/epics`);
+        return response.epics;
+    }
+    async planIt(workspaceId, input) {
+        return this.request("POST", `/api/v1/workspaces/${workspaceId}/plan`, input);
+    }
+    async recommendTasks(workspaceId, options) {
+        const params = new URLSearchParams();
+        if (options?.epicId)
+            params.set("epicId", options.epicId);
+        if (options?.limit)
+            params.set("limit", String(options.limit));
+        const query = params.toString();
+        const path = `/api/v1/workspaces/${workspaceId}/recommend${query ? `?${query}` : ""}`;
+        const response = await this.request("GET", path);
+        return response.recommendations;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListResourceTemplatesRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { BeckAPIClient } from "./client.js";
+import { listResources, readResource, RESOURCE_TEMPLATES } from "./resources.js";
+import { TOOLS, handleToolCall } from "./tools/index.js";
+// Configuration from environment variables
+const BECK_API_URL = process.env.BECK_API_URL || "https://beck.bot";
+const BECK_API_TOKEN = process.env.BECK_API_TOKEN;
+if (!BECK_API_TOKEN) {
+    console.error("Error: BECK_API_TOKEN environment variable is required");
+    console.error("");
+    console.error("To configure the Beck MCP server:");
+    console.error("1. Generate an API token in Beck (Settings > API Tokens)");
+    console.error("2. Set the environment variable:");
+    console.error("   export BECK_API_TOKEN=beck_your_token_here");
+    console.error("");
+    console.error("Optional: Set BECK_API_URL for self-hosted instances");
+    process.exit(1);
+}
+// Initialize the Beck API client
+const beckClient = new BeckAPIClient({
+    apiUrl: BECK_API_URL,
+    apiToken: BECK_API_TOKEN,
+});
+// Create the MCP server
+const server = new Server({
+    name: "beck-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    return handleToolCall(beckClient, name, args || {});
+});
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return { resources: await listResources(beckClient, BECK_API_URL) };
+});
+server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+    return { resourceTemplates: RESOURCE_TEMPLATES };
+});
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const content = await readResource(beckClient, BECK_API_URL, request.params.uri);
+    return { contents: [content] };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log startup info to stderr (not stdout, which is for MCP protocol)
+    console.error("Beck MCP Server started");
+    console.error(`API URL: ${BECK_API_URL}`);
+    console.error(`Token: ${BECK_API_TOKEN.substring(0, 12)}...`);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/resources.d.ts

@@ -0,0 +1,18 @@
+import type { Resource, ResourceTemplate } from "@modelcontextprotocol/sdk/types.js";
+import type { BeckAPIClient } from "./client.js";
+export declare const SKILL_URI = "beck://skill.md";
+export declare const LLMS_URI = "beck://llms.txt";
+export declare const RESOURCE_TEMPLATES: ResourceTemplate[];
+export declare function staticResources(origin: string): Resource[];
+export declare function documentResourceUri(workspaceId: string, path: string): string;
+export declare function parseDocumentResourceUri(uri: string): {
+    workspaceId: string;
+    path: string;
+} | null;
+export declare function listResources(client: BeckAPIClient, origin: string): Promise<Resource[]>;
+export declare function readResource(client: BeckAPIClient, origin: string, uri: string): Promise<{
+    uri: string;
+    mimeType: string;
+    text: string;
+}>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,SAAS,oBAAoB,CAAC;AAC3C,eAAO,MAAM,QAAQ,oBAAoB,CAAC;AAE1C,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EAQhD,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAe1D;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GACV;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO9C;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,QAAQ,EAAE,CAAC,CAmBrB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkC1D"}