[ { "path": ".env.example", "content": "# OAuth Credentials\n# Copy this file to .env and fill in your values\n\n# GitHub OAuth App credentials\n# Create at: https://github.com/settings/developers\nGITHUB_CLIENT_ID=your_github_client_id\nGITHUB_CLIENT_SECRET=your_github_client_secret\n\n# Google OAuth credentials\n# Create at: https://console.cloud.google.com/apis/credentials\nGOOGLE_CLIENT_ID=your_google_client_id\nGOOGLE_CLIENT_SECRET=your_google_client_secret\n\n# Encryption key for stored credentials (min 32 characters)\n# Generate with: openssl rand -base64 32\nENCRYPTION_KEY=your_encryption_key_min_32_chars\n" }, { "path": ".gitignore", "content": "# Logs\nlogs\n*.log\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\npnpm-debug.log*\nlerna-debug.log*\n\nnode_modules\ndist\ndist-ssr\n*.local\n\n# Editor directories and files\n.vscode/*\n!.vscode/extensions.json\n.idea\n.DS_Store\n*.suo\n*.ntvs*\n*.njsproj\n*.sln\n*.sw?\n\n# wrangler files\n.wrangler\n.dev.vars*\n!.dev.vars.example\n\n# Environment files (secrets)\n.env\n.env.local\n.env.*.local\n!.env.example\n\n# Claude Code state\n.claude/\n" }, { "path": "Dockerfile", "content": "FROM docker.io/cloudflare/sandbox:0.6.7\n\n# Install Claude Code CLI\nRUN npm install -g @anthropic-ai/claude-code\n\n# Longer timeout for Claude Code operations\nENV COMMAND_TIMEOUT_MS=300000\n\n# Port 3000 is used by the sandbox SDK internally\nEXPOSE 3000\n" }, { "path": "LICENSE", "content": " Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to the Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n Copyright 2025 Phillip Jones\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n" }, { "path": "README.md", "content": "# Weft\n\nTask management, but AI agents do your tasks.\n\n![Weft Screenshot](assets/screenshot.png)\n\n## What is Weft?\n\nWeft is a personal task board where AI agents work on your tasks. Create a task, assign it to an agent, and it gets to work. Agents can read your emails, draft responses, update spreadsheets, create PRs, and write code.\n\nRun as many agents in parallel as you want. Schedule recurring tasks to run daily or weekly. Get notified when tasks complete or need your approval. All actions that mutate state (sending emails, creating PRs, modifying documents) require your approval before committing.\n\n**Built-in integrations:**\n- Gmail (read, draft, send)\n- Google Docs (create, edit)\n- Google Sheets (create, update)\n- GitHub (issues, PRs, code)\n- [Cloudflare Sandbox](https://developers.cloudflare.com/sandbox/) (isolated containers for code execution and coding agents)\n- [Remote MCP servers](https://modelcontextprotocol.io/) (bring your own tools)\n\n**Self-hosted and private.** Deploy to your own Cloudflare account. Your data stays in your account.\n\n## Architecture\n\nWeft runs entirely on [Cloudflare's Developer Platform](https://workers.cloudflare.com/):\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│ │\n│ Browser ◄──────► Worker ◄──────► Durable Objects ◄──────► Workflows │\n│ │ (HTTP) (BoardDO, UserDO) (AgentWorkflow)\n│ │ │ │ │\n│ │ │ ▼ │\n│ └─────── WebSocket ──────────────────►│ ┌────────────┐ │\n│ (real-time updates) │ Anthropic │ │\n│ │ + Tools │ │\n│ └────────────┘ │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n| Component | Purpose |\n|-----------|---------|\n| **[Workers](https://developers.cloudflare.com/workers/)** | HTTP routing, auth, serves React frontend |\n| **[Durable Objects](https://developers.cloudflare.com/durable-objects/)** | Persistent state (boards, tasks, credentials) and real-time WebSocket updates |\n| **[Workflows](https://developers.cloudflare.com/workflows/)** | Durable agent loop with automatic checkpointing and retry |\n\n## Setup\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) 18+\n- [Docker](https://docs.docker.com/desktop/) running (required for [Cloudflare Sandboxes](https://developers.cloudflare.com/sandbox/))\n- [Cloudflare account](https://dash.cloudflare.com/sign-up) with [Workers Paid plan](https://developers.cloudflare.com/workers/platform/pricing/)\n- OAuth credentials for integrations you want to use:\n - [Google](#google-gmail-docs-sheets) for Gmail/Docs/Sheets\n - [GitHub](#github) for GitHub\n\n### 1. Clone and install\n\n```bash\ngit clone https://github.com/jonesphillip/weft.git\ncd weft\nnpm install\n```\n\n### 2. Configure environment\n\nCopy the example environment file:\n\n```bash\ncp .env.example .env\n```\n\nEdit `.env` with your secrets:\n\n```bash\n# Encryption key for stored credentials (generate with: openssl rand -base64 32)\nENCRYPTION_KEY=your-generated-key\n\n# OAuth credentials (add the ones you need)\nGOOGLE_CLIENT_ID=...\nGOOGLE_CLIENT_SECRET=...\nGITHUB_CLIENT_ID=...\nGITHUB_CLIENT_SECRET=...\n```\n\nSee [Setting up OAuth credentials](#setting-up-oauth-credentials) for detailed instructions on creating Google and GitHub OAuth apps.\n\n### 3. Run locally\n\n```bash\nnpm run dev\n```\n\nThis starts both the Vite dev server (frontend) and Wrangler (worker). Open http://localhost:5174.\n\nBy default, Weft runs without authentication. Boards and tasks are stored under the user defined by `USER_ID` in `wrangler.jsonc`.\n\n### 4. Configure your board\n\nAfter creating your first board, go to **Settings** and add your [Anthropic API key](https://console.anthropic.com/). This key is stored per-board and is required for agents to run.\n\n### 5. Deploy to Cloudflare\n\nSet your secrets (only set the ones you need):\n\n| Secret | Required | Description |\n|--------|----------|-------------|\n| `ENCRYPTION_KEY` | Yes | Encrypts stored credentials. Generate with `openssl rand -base64 32` |\n| `GOOGLE_CLIENT_ID` | For Google integrations | From [Google Cloud Console](#google-gmail-docs-sheets) |\n| `GOOGLE_CLIENT_SECRET` | For Google integrations | From [Google Cloud Console](#google-gmail-docs-sheets) |\n| `GITHUB_CLIENT_ID` | For GitHub integration | From [GitHub Developer Settings](#github) |\n| `GITHUB_CLIENT_SECRET` | For GitHub integration | From [GitHub Developer Settings](#github) |\n\n```bash\nnpx wrangler secret put ENCRYPTION_KEY --env production\nnpx wrangler secret put GOOGLE_CLIENT_ID --env production\nnpx wrangler secret put GOOGLE_CLIENT_SECRET --env production\nnpx wrangler secret put GITHUB_CLIENT_ID --env production\nnpx wrangler secret put GITHUB_CLIENT_SECRET --env production\n\nnpm run deploy:prod\n```\n\n### 6. Configure authentication\n\nAuthentication is controlled by the `AUTH_MODE` variable in `wrangler.jsonc`:\n\n| AUTH_MODE | Description | Use case |\n|-----------|-------------|----------|\n| `none` | No authentication. Uses `USER_ID`/`USER_EMAIL` from config as singleton user. | Personal/single-user deployments |\n| `access` | Cloudflare Access JWT verification. Requires `ACCESS_AUD`/`ACCESS_TEAM` secrets. | Multi-user or login-protected deployments |\n\nBy default, `AUTH_MODE` is set to `\"none\"` for both development and production.\n\n#### Enabling Cloudflare Access authentication\n\nFor multi-user deployments or if you want login protection, enable [Cloudflare Access](https://developers.cloudflare.com/cloudflare-one/applications/configure-apps/):\n\n1. In the Cloudflare dashboard, go to **Zero Trust > Access > Applications**\n2. Create a new **Self-hosted application** with your Weft URL\n3. Add an **Access policy** (e.g., allow only your email address)\n4. After saving, find the **Application Audience (AUD) Tag** in the application settings\n5. Your **team name** is in your Zero Trust dashboard URL: `https://.cloudflareaccess.com`\n\nSet the secrets:\n\n```bash\nnpx wrangler secret put ACCESS_AUD --env production\nnpx wrangler secret put ACCESS_TEAM --env production\n```\n\nThen in `wrangler.jsonc`, change `AUTH_MODE` to `\"access\"` in the production environment:\n\n```jsonc\n\"env\": {\n \"production\": {\n \"vars\": {\n \"AUTH_MODE\": \"access\",\n // ...\n }\n }\n}\n```\n\n## Project Structure\n\n```\nworker/\n├── index.ts # HTTP routing and auth\n├── handlers/ # Request handlers\n├── services/ # Business logic\n├── workflows/ # Cloudflare Workflows (agent loop)\n├── mcp/ # MCP server registry\n├── google/ # Google integrations (Gmail, Docs, Sheets)\n└── github/ # GitHub integration\n\nsrc/\n├── components/ # React components\n├── context/ # React context providers\n├── hooks/ # Custom hooks\n└── api/ # API client\n```\n\n## Scheduled Tasks\n\nTasks can be configured to run on a schedule (daily, weekly, or cron). When a scheduled task runs, it operates differently from regular tasks:\n\n

\n \"Scheduled\n

\n\n1. A Durable Object alarm triggers at the scheduled time\n2. The parent agent runs with read-only tool access. It cannot send emails, create PRs, or modify anything directly.\n3. The parent agent calls `create_task` to fork child tasks for each piece of work it finds\n4. Each child task gets its own agent context with full tool access and runs until it needs human approval\n\nThis separation means scheduled agents can analyze your inbox or repos overnight, but actual changes still require your review.\n\n| Schedule Type | Example |\n|--------------|---------|\n| Daily | 8:00 AM in your timezone |\n| Weekly | Monday and Thursday at 9:00 AM |\n| Custom | Cron expression (`0 */6 * * *`) |\n\n## Adding Tools to Your Board\n\n

\n \"Board\n

\n\nEach board has its own configuration in **Settings**, organized into tabs:\n\n- **Credentials** - Add your Anthropic API key (required for agents) and connect OAuth accounts like Google and GitHub.\n- **Integrations** - Enable built-in tools (Gmail, Docs, Sheets, GitHub) or add any [remote MCP server](https://modelcontextprotocol.io/) for custom tools.\n\n## Building New Integrations\n\nTo add a built-in integration, Weft uses a registry-driven architecture:\n\n1. Create your MCP server in `worker/` (see `worker/google/GmailMCP.ts` for example)\n2. Register it in `worker/mcp/AccountMCPRegistry.ts`\n3. Add OAuth handler if needed in `worker/handlers/oauth.ts`\n\nThe registry defines tool schemas, OAuth configuration, and workflow guidance—no changes needed to the agent workflow itself.\n\n## Setting up OAuth credentials\n\n### Google (Gmail, Docs, Sheets)\n\n1. Go to the [Google Cloud Console](https://console.cloud.google.com/)\n2. Create a new project or select an existing one\n3. Go to **APIs & Services > Library** and enable the Gmail API, Google Docs API, and Google Sheets API\n4. Go to **APIs & Services > OAuth consent screen** and configure it (External is fine, add yourself as a test user)\n5. Go to **APIs & Services > Credentials**\n6. Click **Create Credentials > OAuth client ID**\n7. Select **Web application**\n8. Add authorized JavaScript origins:\n - `http://localhost:5174` (development)\n - `https://weft..workers.dev` (production)\n9. Add authorized redirect URIs:\n - `http://localhost:5174/google/callback` (development)\n - `https://weft..workers.dev/google/callback` (production)\n10. Copy the Client ID and Client Secret to your `.env` file\n\n### GitHub\n\n1. Go to [GitHub Developer Settings](https://github.com/settings/developers)\n2. Click **New OAuth App**\n3. Set the homepage URL to your Weft deployment\n4. Set the authorization callback URL:\n - `http://localhost:5174/github/callback` (development)\n - `https://weft..workers.dev/github/callback` (production)\n5. Copy the Client ID and Client Secret to your `.env` file\n\n## License\n\nApache License 2.0 - see [LICENSE](LICENSE)\n" }, { "path": "eslint.config.js", "content": "import js from '@eslint/js'\nimport globals from 'globals'\nimport reactHooks from 'eslint-plugin-react-hooks'\nimport reactRefresh from 'eslint-plugin-react-refresh'\nimport tseslint from 'typescript-eslint'\nimport { globalIgnores } from 'eslint/config'\n\nexport default tseslint.config([\n globalIgnores(['dist']),\n {\n files: ['**/*.{ts,tsx}'],\n extends: [\n js.configs.recommended,\n tseslint.configs.recommended,\n reactRefresh.configs.vite,\n ],\n plugins: {\n 'react-hooks': reactHooks,\n },\n rules: {\n // Standard react-hooks rules (without experimental compiler rules)\n 'react-hooks/rules-of-hooks': 'error',\n 'react-hooks/exhaustive-deps': 'warn',\n // Allow underscore-prefixed unused vars (convention for intentionally unused params)\n '@typescript-eslint/no-unused-vars': ['error', {\n argsIgnorePattern: '^_',\n varsIgnorePattern: '^_',\n }],\n },\n languageOptions: {\n ecmaVersion: 2020,\n globals: globals.browser,\n },\n },\n])\n" }, { "path": "index.html", "content": "\n\n \n \n \n \n Weft\n \n \n \n \n \n
\n \n \n\n" }, { "path": "package.json", "content": "{\n\t\"name\": \"weft\",\n\t\"private\": true,\n\t\"version\": \"0.0.0\",\n\t\"type\": \"module\",\n\t\"scripts\": {\n\t\t\"dev\": \"vite\",\n\t\t\"dev:wrangler\": \"wrangler dev\",\n\t\t\"build\": \"tsc -b && vite build\",\n\t\t\"lint\": \"eslint .\",\n\t\t\"preview\": \"npm run build && vite preview\",\n\t\t\"deploy\": \"npm run build && wrangler deploy\",\n\t\t\"deploy:prod\": \"CLOUDFLARE_ENV=production npm run build && wrangler deploy --env production\",\n\t\t\"cf-typegen\": \"wrangler types\",\n\t\t\"test\": \"vitest\",\n\t\t\"test:run\": \"vitest run\",\n\t\t\"test:coverage\": \"vitest run --coverage\",\n\t\t\"test:integration\": \"vitest run --config vitest.config.workers.ts\"\n\t},\n\t\"dependencies\": {\n\t\t\"@anthropic-ai/sdk\": \"^0.71.2\",\n\t\t\"@cloudflare/sandbox\": \"^0.6.7\",\n\t\t\"jose\": \"^6.1.3\",\n\t\t\"react\": \"^19.1.1\",\n\t\t\"react-dom\": \"^19.1.1\",\n\t\t\"react-router-dom\": \"^7.11.0\",\n\t\t\"zod\": \"^4.3.4\"\n\t},\n\t\"devDependencies\": {\n\t\t\"@cloudflare/vite-plugin\": \"^1.13.13\",\n\t\t\"@cloudflare/vitest-pool-workers\": \"^0.11.1\",\n\t\t\"@eslint/js\": \"^9.33.0\",\n\t\t\"@types/react\": \"^19.1.10\",\n\t\t\"@types/react-dom\": \"^19.1.7\",\n\t\t\"@vitejs/plugin-react-swc\": \"^4.0.0\",\n\t\t\"@vitest/coverage-v8\": \"3.2\",\n\t\t\"eslint\": \"^9.33.0\",\n\t\t\"eslint-plugin-react-hooks\": \"^7.0.1\",\n\t\t\"eslint-plugin-react-refresh\": \"^0.4.20\",\n\t\t\"globals\": \"^17.0.0\",\n\t\t\"typescript\": \"^5.9.3\",\n\t\t\"typescript-eslint\": \"^8.39.1\",\n\t\t\"vite\": \"^7.1.2\",\n\t\t\"vitest\": \"3.2\",\n\t\t\"wrangler\": \"^4.54.0\"\n\t}\n}\n" }, { "path": "src/App.css", "content": ".app {\n min-height: 100vh;\n display: flex;\n flex-direction: column;\n}\n\n.app-main {\n flex: 1;\n display: flex;\n overflow: hidden;\n}\n\n/* Auth loading state */\n.app-loading {\n min-height: 100vh;\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n gap: var(--space-3);\n color: var(--color-text-muted);\n font-family: var(--font-mono);\n}\n\n.app-loading-spinner {\n width: 32px;\n height: 32px;\n border: 3px solid var(--color-border-default);\n border-top-color: var(--color-accent-primary);\n border-radius: 50%;\n animation: spin 1s linear infinite;\n}\n\n@keyframes spin {\n to { transform: rotate(360deg); }\n}\n\n/* Auth error state */\n.app-error {\n min-height: 100vh;\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n gap: var(--space-2);\n padding: var(--space-6);\n text-align: center;\n}\n\n.app-error h1 {\n font-size: 20px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n.app-error p {\n color: var(--color-text-muted);\n font-family: var(--font-mono);\n font-size: 14px;\n}\n" }, { "path": "src/App.tsx", "content": "import { useState, useEffect, useCallback } from 'react';\nimport { BrowserRouter, Routes, Route, Navigate, useLocation } from 'react-router-dom';\nimport { BoardProvider, useBoard } from './context/BoardContext';\nimport { ToastProvider } from './context/ToastContext';\nimport { AuthProvider, useAuth } from './context/AuthContext';\nimport { Header } from './components/Header/Header';\nimport { Home } from './components/Home/Home';\nimport { Board } from './components/Board/Board';\nimport { GitHubCallback } from './components/GitHubCallback';\nimport { GoogleCallback } from './components/GoogleCallback';\nimport { MCPOAuthCallback } from './components/MCP/MCPOAuthCallback';\nimport { CommandPalette } from './components/CommandPalette';\nimport { ToastContainer, WorkflowToastListener } from './components/Toast';\nimport { ErrorBoundary } from './components/common';\nimport './App.css';\n\n// Full-page callback routes (no header/layout)\nconst CALLBACK_ROUTES = ['/github/callback', '/google/callback', '/mcp/oauth/callback'];\n\nfunction AuthGate({ children }: { children: React.ReactNode }) {\n const { isLoading, error } = useAuth();\n\n if (isLoading) {\n return (\n
\n
\n

Loading...

\n
\n );\n }\n\n if (error) {\n return (\n
\n

Authentication Required

\n

{error}

\n
\n );\n }\n\n return <>{children};\n}\n\nfunction AppContent() {\n const [paletteOpen, setPaletteOpen] = useState(false);\n const { activeBoard, setAddingToColumn } = useBoard();\n const location = useLocation();\n\n const handleNewTask = useCallback((columnIndex: number) => {\n if (activeBoard && activeBoard.columns[columnIndex]) {\n setAddingToColumn(activeBoard.columns[columnIndex].id);\n }\n }, [activeBoard, setAddingToColumn]);\n\n useEffect(() => {\n const handleKeyDown = (e: KeyboardEvent) => {\n // Don't trigger if in an input or textarea\n const target = e.target as HTMLElement;\n const isInput = target.tagName === 'INPUT' || target.tagName === 'TEXTAREA' || target.isContentEditable;\n\n // Cmd/Ctrl + K - open command palette\n if ((e.metaKey || e.ctrlKey) && e.key === 'k') {\n e.preventDefault();\n setPaletteOpen(true);\n return;\n }\n\n // Escape - close palette\n if (e.key === 'Escape' && paletteOpen) {\n setPaletteOpen(false);\n return;\n }\n\n // Shortcuts that only work when not in an input\n if (!isInput && !paletteOpen) {\n // n - new task in first column\n if (e.key === 'n' && activeBoard) {\n e.preventDefault();\n handleNewTask(0);\n return;\n }\n\n // 1, 2, 3 - new task in column 1, 2, or 3\n if (['1', '2', '3'].includes(e.key) && activeBoard) {\n const colIndex = parseInt(e.key) - 1;\n if (activeBoard.columns[colIndex]) {\n e.preventDefault();\n handleNewTask(colIndex);\n }\n return;\n }\n }\n };\n\n window.addEventListener('keydown', handleKeyDown);\n return () => window.removeEventListener('keydown', handleKeyDown);\n }, [paletteOpen, activeBoard, handleNewTask]);\n\n // Render full-page callbacks without the app layout\n const isCallbackRoute = CALLBACK_ROUTES.includes(location.pathname);\n if (isCallbackRoute) {\n return (\n \n } />\n } />\n } />\n \n );\n }\n\n return (\n <>\n
\n
\n
\n \n } />\n } />\n } />\n \n
\n
\n\n setPaletteOpen(false)}\n onNewTask={handleNewTask}\n />\n\n {/* Toast notifications */}\n \n \n \n );\n}\n\nfunction App() {\n return (\n \n \n \n \n \n \n \n \n \n \n \n \n \n );\n}\n\nexport default App;\n" }, { "path": "src/api/client.ts", "content": "import type {\n Board,\n Column,\n Task,\n ApiResponse,\n TaskPriority,\n BoardCredential,\n MCPServer,\n MCPTool,\n WorkflowPlan,\n WorkflowLog,\n User,\n ScheduleConfig,\n ScheduledRun,\n} from '../types';\n\nconst API_BASE = '/api';\n\n// ============================================\n// AUTH\n// ============================================\n\nexport async function getMe(): Promise> {\n const response = await fetch(`${API_BASE}/me`);\n return response.json();\n}\n\nasync function request(\n path: string,\n options: RequestInit = {}\n): Promise> {\n const response = await fetch(`${API_BASE}${path}`, {\n headers: {\n 'Content-Type': 'application/json',\n ...options.headers,\n },\n ...options,\n });\n\n const data = await response.json();\n\n if (!response.ok) {\n // Server returns { success: false, error: { code, message } }\n const errorObj = data.error || {};\n return {\n success: false,\n error: {\n code: errorObj.code || String(response.status),\n message: errorObj.message || 'Request failed',\n },\n };\n }\n\n return data;\n}\n\n// ============================================\n// BOARDS\n// ============================================\n\nexport interface BoardWithDetails extends Board {\n columns: Column[];\n tasks: Task[];\n}\n\nexport async function getBoards(): Promise> {\n return request('/boards');\n}\n\nexport async function getBoard(id: string): Promise> {\n return request(`/boards/${id}`);\n}\n\nexport async function createBoard(name: string): Promise> {\n return request('/boards', {\n method: 'POST',\n body: JSON.stringify({ name }),\n });\n}\n\nexport async function updateBoard(\n id: string,\n data: { name?: string }\n): Promise> {\n return request(`/boards/${id}`, {\n method: 'PUT',\n body: JSON.stringify(data),\n });\n}\n\nexport async function deleteBoard(id: string): Promise> {\n return request(`/boards/${id}`, {\n method: 'DELETE',\n });\n}\n\n// ============================================\n// COLUMNS\n// ============================================\n\nexport async function createColumn(\n boardId: string,\n name: string\n): Promise> {\n return request(`/boards/${boardId}/columns`, {\n method: 'POST',\n body: JSON.stringify({ name }),\n });\n}\n\nexport async function updateColumn(\n boardId: string,\n id: string,\n data: { name?: string; position?: number }\n): Promise> {\n return request(`/boards/${boardId}/columns/${id}`, {\n method: 'PUT',\n body: JSON.stringify(data),\n });\n}\n\nexport async function deleteColumn(boardId: string, id: string): Promise> {\n return request(`/boards/${boardId}/columns/${id}`, {\n method: 'DELETE',\n });\n}\n\n// ============================================\n// TASKS\n// ============================================\n\nexport async function createTask(\n boardId: string,\n data: {\n columnId: string;\n title: string;\n description?: string;\n priority?: TaskPriority;\n }\n): Promise> {\n return request(`/boards/${boardId}/tasks`, {\n method: 'POST',\n body: JSON.stringify(data),\n });\n}\n\nexport async function getTask(boardId: string, id: string): Promise> {\n return request(`/boards/${boardId}/tasks/${id}`);\n}\n\nexport async function updateTask(\n boardId: string,\n id: string,\n data: {\n title?: string;\n description?: string;\n priority?: TaskPriority;\n scheduleConfig?: ScheduleConfig | null;\n }\n): Promise> {\n return request(`/boards/${boardId}/tasks/${id}`, {\n method: 'PUT',\n body: JSON.stringify(data),\n });\n}\n\nexport async function deleteTask(boardId: string, id: string): Promise> {\n return request(`/boards/${boardId}/tasks/${id}`, {\n method: 'DELETE',\n });\n}\n\nexport async function moveTask(\n boardId: string,\n id: string,\n columnId: string,\n position: number\n): Promise> {\n return request(`/boards/${boardId}/tasks/${id}/move`, {\n method: 'POST',\n body: JSON.stringify({ columnId, position }),\n });\n}\n\n// ============================================\n// CREDENTIALS\n// ============================================\n\nexport async function getCredentials(\n boardId: string\n): Promise> {\n return request(`/boards/${boardId}/credentials`);\n}\n\nexport async function createCredential(\n boardId: string,\n data: {\n type: 'github_oauth' | 'google_oauth' | 'anthropic_api_key';\n name: string;\n value: string;\n metadata?: Record;\n }\n): Promise> {\n return request(`/boards/${boardId}/credentials`, {\n method: 'POST',\n body: JSON.stringify(data),\n });\n}\n\nexport async function deleteCredential(\n boardId: string,\n credentialId: string\n): Promise> {\n return request(`/boards/${boardId}/credentials/${credentialId}`, {\n method: 'DELETE',\n });\n}\n\n// ============================================\n// GITHUB\n// ============================================\n\nexport interface GitHubRepo {\n id: number;\n name: string;\n fullName: string;\n owner: string;\n private: boolean;\n defaultBranch: string;\n description: string | null;\n}\n\nexport async function getGitHubOAuthUrl(\n boardId: string\n): Promise> {\n return request<{ url: string }>(`/github/oauth/url?boardId=${encodeURIComponent(boardId)}`);\n}\n\nexport async function getGitHubRepos(\n boardId: string\n): Promise> {\n return request(`/boards/${boardId}/github/repos`);\n}\n\n// ============================================\n// GOOGLE\n// ============================================\n\nexport async function getGoogleOAuthUrl(\n boardId: string\n): Promise> {\n return request<{ url: string }>(`/google/oauth/url?boardId=${encodeURIComponent(boardId)}`);\n}\n\n// ============================================\n// MCP SERVERS\n// ============================================\n\nexport async function getMCPServers(\n boardId: string\n): Promise> {\n return request(`/boards/${boardId}/mcp-servers`);\n}\n\nexport async function getMCPServer(\n boardId: string,\n serverId: string\n): Promise> {\n return request(`/boards/${boardId}/mcp-servers/${serverId}`);\n}\n\nexport async function createMCPServer(\n boardId: string,\n data: {\n name: string;\n type: 'remote' | 'hosted';\n endpoint?: string;\n authType?: 'none' | 'oauth' | 'api_key' | 'bearer';\n credentialId?: string;\n transportType?: 'streamable-http' | 'sse';\n }\n): Promise> {\n return request(`/boards/${boardId}/mcp-servers`, {\n method: 'POST',\n body: JSON.stringify(data),\n });\n}\n\nexport async function updateMCPServer(\n boardId: string,\n serverId: string,\n data: {\n name?: string;\n endpoint?: string;\n authType?: 'none' | 'oauth' | 'api_key' | 'bearer';\n credentialId?: string;\n transportType?: 'streamable-http' | 'sse';\n enabled?: boolean;\n status?: 'connected' | 'disconnected' | 'error';\n }\n): Promise> {\n return request(`/boards/${boardId}/mcp-servers/${serverId}`, {\n method: 'PUT',\n body: JSON.stringify(data),\n });\n}\n\nexport async function deleteMCPServer(\n boardId: string,\n serverId: string\n): Promise> {\n return request(`/boards/${boardId}/mcp-servers/${serverId}`, {\n method: 'DELETE',\n });\n}\n\nexport async function getMCPServerTools(\n boardId: string,\n serverId: string\n): Promise> {\n return request(`/boards/${boardId}/mcp-servers/${serverId}/tools`);\n}\n\nexport async function connectMCPServer(\n boardId: string,\n serverId: string\n): Promise }>> {\n return request<{ status: string; toolCount: number; tools: Array<{ name: string; description?: string }> }>(\n `/boards/${boardId}/mcp-servers/${serverId}/connect`,\n { method: 'POST' }\n );\n}\n\nexport async function cacheMCPServerTools(\n boardId: string,\n serverId: string,\n tools: Array<{\n name: string;\n description?: string;\n inputSchema: object;\n }>\n): Promise> {\n return request(`/boards/${boardId}/mcp-servers/${serverId}/tools`, {\n method: 'PUT',\n body: JSON.stringify({ tools }),\n });\n}\n\n/**\n * Create an account-based MCP server (e.g., Gmail, Google Docs)\n * Uses the AccountMCPRegistry to create and initialize the MCP\n */\nexport async function createAccountMCP(\n boardId: string,\n accountId: string,\n mcpId: string\n): Promise> {\n return request(`/boards/${boardId}/mcp-servers/account`, {\n method: 'POST',\n body: JSON.stringify({ accountId, mcpId }),\n });\n}\n\n// ============================================\n// MCP OAUTH\n// ============================================\n\n/**\n * Discover OAuth endpoints for a remote MCP server\n */\nexport async function discoverMCPOAuth(\n boardId: string,\n serverId: string\n): Promise> {\n return request(`/boards/${boardId}/mcp-servers/${serverId}/oauth/discover`, {\n method: 'POST',\n });\n}\n\n/**\n * Get OAuth authorization URL for a remote MCP server\n */\nexport async function getMCPOAuthUrl(\n boardId: string,\n serverId: string,\n redirectUri: string\n): Promise> {\n const params = new URLSearchParams({ redirectUri });\n return request(`/boards/${boardId}/mcp-servers/${serverId}/oauth/url?${params.toString()}`);\n}\n\n/**\n * Exchange OAuth authorization code for tokens\n */\nexport async function exchangeMCPOAuthCode(\n boardId: string,\n serverId: string,\n code: string,\n state: string,\n redirectUri: string\n): Promise> {\n return request(`/boards/${boardId}/mcp-servers/${serverId}/oauth/exchange`, {\n method: 'POST',\n body: JSON.stringify({ code, state, redirectUri }),\n });\n}\n\n// ============================================\n// WORKFLOW PLANS\n// ============================================\n\nexport async function getBoardWorkflowPlans(\n boardId: string\n): Promise> {\n return request(`/boards/${boardId}/workflow-plans`);\n}\n\nexport async function getTaskWorkflowPlan(\n boardId: string,\n taskId: string\n): Promise> {\n return request(`/boards/${boardId}/tasks/${taskId}/plan`);\n}\n\nexport async function createWorkflowPlan(\n boardId: string,\n taskId: string,\n data: {\n summary?: string;\n generatedCode?: string;\n steps?: object[];\n }\n): Promise> {\n return request(`/boards/${boardId}/tasks/${taskId}/plan`, {\n method: 'POST',\n body: JSON.stringify(data),\n });\n}\n\nexport async function getWorkflowPlan(\n boardId: string,\n planId: string\n): Promise> {\n return request(`/boards/${boardId}/plans/${planId}`);\n}\n\nexport async function updateWorkflowPlan(\n boardId: string,\n planId: string,\n data: {\n status?: string;\n summary?: string;\n generatedCode?: string;\n steps?: object[];\n currentStepIndex?: number;\n checkpointData?: object;\n }\n): Promise> {\n return request(`/boards/${boardId}/plans/${planId}`, {\n method: 'PUT',\n body: JSON.stringify(data),\n });\n}\n\nexport async function deleteWorkflowPlan(\n boardId: string,\n planId: string\n): Promise> {\n return request(`/boards/${boardId}/plans/${planId}`, {\n method: 'DELETE',\n });\n}\n\nexport async function approveWorkflowPlan(\n boardId: string,\n planId: string\n): Promise> {\n return request(`/boards/${boardId}/plans/${planId}/approve`, {\n method: 'POST',\n });\n}\n\nexport async function cancelWorkflow(\n boardId: string,\n planId: string\n): Promise> {\n return request(`/boards/${boardId}/plans/${planId}/cancel`, {\n method: 'POST',\n });\n}\n\nexport async function resolveWorkflowCheckpoint(\n boardId: string,\n planId: string,\n data: {\n action: 'approve' | 'request_changes' | 'cancel';\n data?: object;\n feedback?: string;\n }\n): Promise> {\n return request(`/boards/${boardId}/plans/${planId}/checkpoint`, {\n method: 'POST',\n body: JSON.stringify(data),\n });\n}\n\nexport async function getWorkflowLogs(\n boardId: string,\n planId: string,\n options?: { limit?: number; offset?: number }\n): Promise> {\n const params = new URLSearchParams();\n if (options?.limit) params.set('limit', String(options.limit));\n if (options?.offset) params.set('offset', String(options.offset));\n const query = params.toString() ? `?${params.toString()}` : '';\n return request(`/boards/${boardId}/plans/${planId}/logs${query}`);\n}\n\nexport async function generateWorkflowPlan(\n boardId: string,\n taskId: string\n): Promise> {\n return request(`/boards/${boardId}/tasks/${taskId}/generate-plan`, {\n method: 'POST',\n });\n}\n\n// ============================================\n// LINK METADATA (for link pills)\n// ============================================\n\nexport interface LinkMetadata {\n type: 'google_doc' | 'google_sheet' | 'github_pr' | 'github_issue' | 'github_repo';\n title: string;\n id: string;\n}\n\nexport async function getLinkMetadata(\n boardId: string,\n url: string\n): Promise> {\n return request(`/boards/${boardId}/links/metadata`, {\n method: 'POST',\n body: JSON.stringify({ url }),\n });\n}\n\n// ============================================\n// SCHEDULED TASKS\n// ============================================\n\n/**\n * Get scheduled tasks for a board\n */\nexport async function getScheduledTasks(\n boardId: string\n): Promise> {\n return request(`/boards/${boardId}/scheduled-tasks`);\n}\n\n/**\n * Get scheduled runs for a task\n */\nexport async function getScheduledRuns(\n boardId: string,\n taskId: string,\n limit?: number\n): Promise> {\n const params = limit ? `?limit=${limit}` : '';\n return request(`/boards/${boardId}/tasks/${taskId}/runs${params}`);\n}\n\n/**\n * Get child tasks for a scheduled run\n */\nexport async function getRunTasks(\n boardId: string,\n runId: string\n): Promise> {\n return request(`/boards/${boardId}/runs/${runId}/tasks`);\n}\n\n/**\n * Delete a scheduled run from history\n */\nexport async function deleteScheduledRun(\n boardId: string,\n runId: string\n): Promise> {\n return request(`/boards/${boardId}/runs/${runId}`, {\n method: 'DELETE',\n });\n}\n\n/**\n * Get child tasks for a parent scheduled task\n */\nexport async function getChildTasks(\n boardId: string,\n parentTaskId: string\n): Promise> {\n return request(`/boards/${boardId}/tasks/${parentTaskId}/children`);\n}\n\n/**\n * Trigger a scheduled run manually (\"Run Now\")\n */\nexport async function triggerScheduledRun(\n boardId: string,\n taskId: string\n): Promise> {\n return request<{ runId: string }>(`/boards/${boardId}/tasks/${taskId}/run`, {\n method: 'POST',\n });\n}\n\n" }, { "path": "src/components/Approval/Approval.css", "content": "/**\n * Approval View Styles\n *\n * Shared styles for all approval view components.\n * These styles are used by both DefaultApproval and specialized views.\n */\n\n/* Base approval card */\n.approval-card {\n display: flex;\n flex-direction: column;\n gap: var(--space-4);\n}\n\n/* Header with icon and action title */\n.approval-header {\n display: flex;\n align-items: center;\n gap: var(--space-3);\n padding-bottom: var(--space-3);\n border-bottom: 1px solid var(--color-border-default);\n}\n\n.approval-icon {\n flex-shrink: 0;\n color: var(--color-text-secondary);\n}\n\n.approval-title {\n font-size: 15px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n/* Field display (key-value pairs) */\n.approval-fields {\n display: flex;\n flex-direction: column;\n gap: var(--space-4);\n}\n\n.approval-field {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.approval-field-label {\n font-size: 12px;\n font-weight: 500;\n color: var(--color-text-secondary);\n}\n\n.approval-field-value {\n padding: var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n font-size: 13px;\n line-height: 1.5;\n color: var(--color-text-primary);\n white-space: pre-wrap;\n word-break: break-word;\n max-height: 200px;\n overflow-y: auto;\n}\n\n/* Actions (approve/reject buttons) */\n.approval-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-4);\n border-top: 1px solid var(--color-border-default);\n}\n\n/* Generic label styling */\n.approval-label {\n font-size: 12px;\n font-weight: 500;\n color: var(--color-text-muted);\n margin-right: var(--space-2);\n}\n\n/* ============================================\n * GitHub Write File Approval Styles\n * ============================================ */\n\n.approval-github-write .approval-file-info {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.approval-github-write .approval-file-path {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n background: var(--color-success-subtle);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n}\n\n.approval-github-write .approval-file-path-icon {\n color: var(--color-success-text);\n font-weight: 600;\n font-size: 14px;\n}\n\n.approval-github-write .approval-file-path code {\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-primary);\n}\n\n.approval-github-write .approval-file-branch,\n.approval-github-write .approval-file-message {\n display: flex;\n align-items: baseline;\n gap: var(--space-2);\n padding: var(--space-1) 0;\n font-size: 13px;\n}\n\n.approval-github-write .approval-file-branch code {\n font-family: var(--font-mono);\n padding: var(--space-1) var(--space-2);\n background: var(--color-bg-secondary);\n border-radius: var(--radius-sm);\n font-size: 12px;\n}\n\n/* Code preview section */\n.approval-code-preview {\n display: flex;\n flex-direction: column;\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n overflow: hidden;\n}\n\n.approval-code-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-secondary);\n border-bottom: 1px solid var(--color-border-default);\n font-size: 12px;\n font-weight: 500;\n color: var(--color-text-secondary);\n}\n\n.approval-code-lines {\n font-size: 11px;\n color: var(--color-text-muted);\n font-weight: normal;\n}\n\n.approval-code-content {\n max-height: 400px;\n overflow: auto;\n background: var(--color-bg-primary);\n}\n\n.approval-code-content pre {\n margin: 0;\n padding: var(--space-3);\n}\n\n.approval-code-content code {\n font-family: var(--font-mono);\n font-size: 12px;\n line-height: 1.5;\n color: var(--color-text-primary);\n white-space: pre;\n tab-size: 2;\n}\n\n/* ============================================\n * Short Field Comments\n * ============================================ */\n\n.approval-field-short {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n/* Editable field (input with comment support) */\n.approval-field-editable {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.approval-field-header {\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: var(--space-2);\n}\n\n/* Editable field label - fixed width, left-aligned */\n.approval-field-editable .approval-field-label {\n width: 60px;\n flex-shrink: 0;\n text-align: left;\n}\n\n/* Editable field input */\n.approval-field-input {\n flex: 1;\n padding: var(--space-2);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-primary);\n}\n\n.approval-field-input:focus {\n outline: none;\n border-color: var(--color-accent-primary);\n}\n\n.approval-field-input::placeholder {\n color: var(--color-text-muted);\n}\n\n.approval-field-input:disabled {\n opacity: 0.6;\n cursor: not-allowed;\n}\n\n/* Show add comment on hover for editable fields */\n.approval-field-editable:hover .approval-field-add-comment {\n opacity: 1;\n}\n\n.approval-field-add-comment {\n padding: 2px 8px;\n background: none;\n border: none;\n border-radius: var(--radius-sm);\n font-size: 11px;\n color: var(--color-text-muted);\n cursor: pointer;\n opacity: 0;\n transition: all 0.15s ease;\n}\n\n.approval-field-short:hover .approval-field-add-comment {\n opacity: 1;\n}\n\n.approval-field-add-comment:hover {\n color: var(--color-accent-primary);\n background: var(--color-bg-secondary);\n}\n\n/* Field comment input */\n.approval-field-comment-input {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n padding: var(--space-2);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-accent-primary);\n border-radius: var(--radius-md);\n}\n\n.approval-field-comment-input input {\n width: 100%;\n padding: var(--space-2);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n font-family: inherit;\n font-size: 13px;\n color: var(--color-text-primary);\n}\n\n.approval-field-comment-input input:focus {\n outline: none;\n border-color: var(--color-accent-primary);\n}\n\n.approval-field-comment-input input::placeholder {\n color: var(--color-text-muted);\n}\n\n.approval-field-comment-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n}\n\n.approval-field-comment-actions button {\n padding: 4px 10px;\n border: none;\n border-radius: var(--radius-sm);\n font-size: 12px;\n cursor: pointer;\n background: transparent;\n color: var(--color-text-muted);\n}\n\n.approval-field-comment-actions button:hover:not(:disabled) {\n color: var(--color-text-primary);\n}\n\n.approval-field-comment-actions button.primary {\n background: var(--color-accent-primary);\n color: white;\n}\n\n.approval-field-comment-actions button.primary:hover:not(:disabled) {\n opacity: 0.9;\n}\n\n.approval-field-comment-actions button:disabled {\n opacity: 0.4;\n cursor: default;\n}\n\n/* Existing field comment */\n.approval-field-comment {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-left: 3px solid #3b82f6;\n border-radius: var(--radius-sm);\n font-size: 12px;\n}\n\n.approval-field-comment-content {\n flex: 1;\n color: var(--color-text-primary);\n}\n\n.approval-field-comment-edit,\n.approval-field-comment-remove {\n padding: 2px 6px;\n border: none;\n border-radius: var(--radius-sm);\n background: transparent;\n font-size: 11px;\n color: var(--color-text-muted);\n cursor: pointer;\n opacity: 0;\n transition: all 0.15s ease;\n}\n\n.approval-field-comment:hover .approval-field-comment-edit,\n.approval-field-comment:hover .approval-field-comment-remove {\n opacity: 1;\n}\n\n.approval-field-comment-edit:hover {\n color: var(--color-accent-primary);\n background: var(--color-bg-tertiary);\n}\n\n.approval-field-comment-remove:hover {\n color: #ef4444;\n background: rgba(239, 68, 68, 0.1);\n}\n\n/* ============================================\n * Approval Footer (shared component)\n * ============================================ */\n\n.approval-footer {\n display: flex;\n flex-direction: column;\n gap: var(--space-3);\n padding-top: var(--space-3);\n border-top: 1px solid var(--color-border-default);\n}\n\n/* Footer actions */\n.approval-footer-actions {\n display: flex;\n justify-content: space-between;\n align-items: center;\n}\n\n.approval-footer-primary-actions {\n display: flex;\n gap: var(--space-2);\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .approval-card {\n gap: var(--space-3);\n }\n\n .approval-header {\n padding-bottom: var(--space-2);\n }\n\n .approval-title {\n font-size: 14px;\n }\n\n .approval-fields {\n gap: var(--space-3);\n }\n\n .approval-field-value {\n max-height: 150px;\n font-size: 14px;\n }\n\n /* Main approval actions - stack with primary on top */\n .approval-actions {\n flex-direction: column-reverse;\n gap: var(--space-2);\n }\n\n .approval-actions > * {\n width: 100%;\n }\n\n /* Footer actions - stack */\n .approval-footer-actions {\n flex-direction: column-reverse;\n gap: var(--space-3);\n }\n\n .approval-footer-primary-actions {\n flex-direction: column-reverse;\n width: 100%;\n gap: var(--space-2);\n }\n\n .approval-footer-primary-actions > * {\n width: 100%;\n }\n\n /* Code preview */\n .approval-code-content {\n max-height: 250px;\n }\n\n .approval-code-content code {\n font-size: 11px;\n }\n\n /* Always show comment buttons on mobile */\n .approval-field-add-comment {\n opacity: 1;\n }\n\n .approval-field-comment-edit,\n .approval-field-comment-remove {\n opacity: 1;\n }\n\n /* Field input */\n .approval-field-input {\n font-size: 16px; /* Prevent iOS zoom */\n }\n\n .approval-field-comment-input input {\n font-size: 16px;\n }\n}\n" }, { "path": "src/components/Approval/ApprovalFooter.tsx", "content": "/**\n * Approval Footer\n *\n * Shared footer for all approval views with three actions:\n * - Cancel (abort workflow)\n * - Request Changes (send feedback, agent iterates)\n * - Approve (accept as-is)\n *\n * Feedback is now collected inline on fields, not in a general textarea.\n */\n\nimport { Button } from '../common';\n\ninterface ApprovalFooterProps {\n onApprove: () => void;\n onRequestChanges: () => void;\n onCancel: () => void;\n isLoading: boolean;\n approveLabel?: string;\n approveDisabled?: boolean;\n commentCount?: number;\n requestChangesLabel?: string;\n requestChangesDisabled?: boolean;\n requestChangesDisabledTitle?: string;\n}\n\nexport function ApprovalFooter({\n onApprove,\n onRequestChanges,\n onCancel,\n isLoading,\n approveLabel = 'Approve',\n approveDisabled = false,\n commentCount = 0,\n requestChangesLabel,\n requestChangesDisabled,\n requestChangesDisabledTitle,\n}: ApprovalFooterProps) {\n const hasComments = commentCount > 0;\n const computedRequestChangesLabel = requestChangesLabel || (hasComments\n ? `Request Changes (${commentCount})`\n : 'Request Changes');\n const isRequestChangesDisabled = requestChangesDisabled ?? !hasComments;\n const requestChangesTitle = requestChangesDisabledTitle ?? (!hasComments ? 'Add comments to request changes' : undefined);\n\n return (\n
\n
\n \n Reject\n \n\n
\n \n {isLoading ? 'Sending...' : computedRequestChangesLabel}\n \n \n {isLoading ? 'Processing...' : approveLabel}\n \n
\n
\n
\n );\n}\n" }, { "path": "src/components/Approval/ApprovalViewRegistry.tsx", "content": "/**\n * Approval View Registry\n *\n * Maps MCP tool names to specialized approval view components.\n * This allows different tools to have tool-specific approval UIs.\n */\n\nimport { DefaultApproval } from './DefaultApproval';\nimport { EmailApproval } from './EmailApproval';\nimport { GitHubPRApproval } from './GitHubPRApproval';\nimport { GitHubPRReviewApproval } from './GitHubPRReviewApproval';\nimport { GoogleDocsApproval } from './GoogleDocsApproval';\nimport { GoogleSheetsApproval } from './GoogleSheetsApproval';\n\n/**\n * Props passed to all approval view components\n */\nexport interface ApprovalViewProps {\n tool: string;\n action: string;\n data: Record;\n toolResults?: Record;\n onApprove: (responseData?: Record) => void;\n onRequestChanges: (feedback: string) => void;\n onCancel: () => void;\n isLoading: boolean;\n}\n\ntype ApprovalViewComponent = React.FC;\n\n/**\n * Registry mapping tool names to their approval view components\n */\nconst APPROVAL_VIEW_REGISTRY: Record = {\n 'GitHub__createPullRequest': GitHubPRApproval,\n 'GitHub__create_pr': GitHubPRApproval,\n 'Sandbox__createPullRequest': GitHubPRApproval,\n 'GitHub__submitPullRequestReview': GitHubPRReviewApproval,\n 'GitHub__submit_pr_review': GitHubPRReviewApproval,\n 'Gmail__sendEmail': EmailApproval,\n 'Gmail__createDraft': EmailApproval,\n 'Google_Docs__createDocument': GoogleDocsApproval,\n 'Google_Docs__appendToDocument': GoogleDocsApproval,\n 'Google_Docs__replaceDocumentContent': GoogleDocsApproval,\n 'Google_Sheets__createSpreadsheet': GoogleSheetsApproval,\n 'Google_Sheets__appendRows': GoogleSheetsApproval,\n 'Google_Sheets__updateCells': GoogleSheetsApproval,\n 'Google_Sheets__replaceSheetContent': GoogleSheetsApproval,\n};\n\n/**\n * Get the approval view component for a given tool name\n * Falls back to DefaultApproval if no specialized view exists\n */\nexport function getApprovalView(toolName: string): ApprovalViewComponent {\n return APPROVAL_VIEW_REGISTRY[toolName] || DefaultApproval;\n}\n" }, { "path": "src/components/Approval/DefaultApproval.tsx", "content": "/**\n * Default Approval View\n *\n * Generic key-value display for tool approvals.\n * Uses CommentableText for multi-line text fields to allow inline comments.\n * Short fields get a simple \"add comment\" button on hover.\n * Used as fallback when no specialized view exists.\n */\n\nimport { useState } from 'react';\nimport { McpIcon, getIconTypeFromTool } from '../common';\nimport { ApprovalFooter } from './ApprovalFooter';\nimport { CommentableText, formatTextComments } from '../CommentableText/CommentableText';\nimport { useFieldComments } from '../../hooks';\nimport type { TextComment } from '../../types';\nimport type { ApprovalViewProps } from './ApprovalViewRegistry';\nimport './Approval.css';\n\n// Tool-specific configuration for approval UI\nconst TOOL_CONFIG: Record;\n commentableFields?: string[]; // Fields that support line-level comments\n editableFields?: string[]; // Fields that are editable (with comment support)\n}> = {\n 'Google_Docs__createDocument': {\n label: 'Create Document',\n buttonLabel: 'Create Document',\n fieldLabels: { title: 'Document Name', content: 'Content' },\n commentableFields: ['content'],\n editableFields: ['title'],\n },\n 'Gmail__sendMessage': {\n label: 'Send Email',\n buttonLabel: 'Send Email',\n fieldLabels: { to: 'To', subject: 'Subject', body: 'Message', cc: 'CC', bcc: 'BCC' },\n commentableFields: ['body'],\n },\n 'Gmail__createDraft': {\n label: 'Create Draft',\n buttonLabel: 'Save Draft',\n fieldLabels: { to: 'To', subject: 'Subject', body: 'Message', cc: 'CC', bcc: 'BCC' },\n commentableFields: ['body'],\n },\n 'Sandbox__runCode': {\n label: 'Run Code',\n buttonLabel: 'Run Code',\n fieldLabels: { code: 'Code', language: 'Language' },\n commentableFields: ['code'],\n },\n};\n\n// Get tool config with fallback to generic labels\nfunction getToolConfig(toolName: string) {\n return TOOL_CONFIG[toolName] || {\n label: 'Execute Action',\n buttonLabel: 'Continue',\n fieldLabels: {},\n };\n}\n\n// Get field label with tool-specific mapping\nfunction getFieldLabel(toolName: string, fieldKey: string): string {\n const config = TOOL_CONFIG[toolName];\n if (config?.fieldLabels[fieldKey]) {\n return config.fieldLabels[fieldKey];\n }\n // Fallback: convert camelCase to Title Case\n return fieldKey\n .replace(/([A-Z])/g, ' $1')\n .replace(/_/g, ' ')\n .trim()\n .replace(/^\\w/, c => c.toUpperCase());\n}\n\n// Text comments state keyed by field name (for multi-line fields)\ninterface TextCommentsMap {\n [fieldKey: string]: TextComment[];\n}\n\nexport function DefaultApproval({\n tool,\n action,\n data,\n onApprove,\n onRequestChanges,\n onCancel,\n isLoading,\n}: ApprovalViewProps) {\n const toolConfig = getToolConfig(tool);\n const iconType = getIconTypeFromTool(tool);\n\n // Text comments for multi-line fields (CommentableText)\n const [textComments, setTextComments] = useState({});\n\n // Field comments using shared hook\n const {\n commentingField,\n commentInput,\n setCommentInput,\n startFieldComment,\n editFieldComment,\n submitFieldComment,\n cancelFieldComment,\n removeFieldComment,\n getFieldComment,\n commentCount: fieldCommentCount,\n } = useFieldComments();\n\n // Edited field values (for editable fields)\n const [editedValues, setEditedValues] = useState>({});\n\n // Wrap hook functions to match expected signatures\n const handleStartFieldComment = (fieldKey: string) => startFieldComment(fieldKey);\n const handleEditFieldComment = (fieldKey: string, content: string) => editFieldComment(fieldKey, content);\n const handleSubmitFieldComment = (fieldKey: string, fieldLabel: string) => submitFieldComment(fieldKey, fieldLabel);\n const handleCancelFieldComment = () => cancelFieldComment();\n const handleRemoveFieldComment = (fieldKey: string) => removeFieldComment(fieldKey);\n\n // Extract fields to display from data\n const fields: Array<{ key: string; label: string; value: string; isCommentable: boolean; isEditable: boolean }> = [];\n\n // Handle case where data might be a JSON string instead of object\n let dataObj = data;\n if (typeof dataObj === 'string') {\n try {\n dataObj = JSON.parse(dataObj);\n } catch {\n dataObj = {};\n }\n }\n\n const commentableFields = toolConfig.commentableFields || [];\n const editableFields = toolConfig.editableFields || [];\n\n if (dataObj && typeof dataObj === 'object') {\n Object.entries(dataObj as Record).forEach(([key, value]) => {\n // Convert non-string values to readable strings\n const displayValue = typeof value === 'string'\n ? value\n : typeof value === 'object'\n ? JSON.stringify(value, null, 2)\n : String(value);\n if (displayValue.length > 0) {\n fields.push({\n key,\n label: getFieldLabel(tool, key),\n value: displayValue,\n isCommentable: commentableFields.includes(key),\n isEditable: editableFields.includes(key),\n });\n }\n });\n }\n\n // Handler for editable field changes\n const handleEditableChange = (fieldKey: string, newValue: string) => {\n setEditedValues((prev) => ({ ...prev, [fieldKey]: newValue }));\n };\n\n // Get current value for an editable field\n const getEditableValue = (field: { key: string; value: string }) => {\n return editedValues[field.key] ?? field.value;\n };\n\n // Text comment handlers (for multi-line fields)\n const handleAddTextComment = (fieldKey: string, comment: Omit) => {\n const newComment: TextComment = {\n ...comment,\n id: `comment-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n };\n setTextComments((prev) => ({\n ...prev,\n [fieldKey]: [...(prev[fieldKey] || []), newComment],\n }));\n };\n\n const handleRemoveTextComment = (fieldKey: string, commentId: string) => {\n setTextComments((prev) => ({\n ...prev,\n [fieldKey]: (prev[fieldKey] || []).filter((c) => c.id !== commentId),\n }));\n };\n\n // Get total comment count\n const textCommentCount = Object.values(textComments).reduce((sum, arr) => sum + arr.length, 0);\n const totalComments = textCommentCount + fieldCommentCount;\n\n // Format all comments as feedback\n const formatAllFeedback = (): string => {\n const sections: string[] = [];\n\n for (const field of fields) {\n if (field.isCommentable) {\n // Multi-line field - format text comments\n const comments = textComments[field.key] || [];\n if (comments.length > 0) {\n sections.push(`[${field.label}]\\n${formatTextComments(comments)}`);\n }\n } else {\n // Short field - format field comment\n const comment = getFieldComment(field.key);\n if (comment) {\n sections.push(`[${field.label}]: \"${comment.content}\"`);\n }\n }\n }\n\n return sections.join('\\n\\n');\n };\n\n const handleRequestChanges = () => {\n const feedback = formatAllFeedback();\n onRequestChanges(feedback);\n };\n\n return (\n
\n {/* Header with icon and action */}\n
\n \n \n {action || toolConfig.label}\n \n
\n\n {/* Fields */}\n
\n {fields.map((field) => {\n const existingComment = getFieldComment(field.key);\n const isCommenting = commentingField === field.key;\n\n return (\n
\n {field.isCommentable ? (\n handleAddTextComment(field.key, comment)}\n onRemoveComment={(id) => handleRemoveTextComment(field.key, id)}\n disabled={isLoading}\n />\n ) : field.isEditable ? (\n /* Editable field with input + comment support */\n
\n
\n \n handleEditableChange(field.key, e.target.value)}\n disabled={isLoading}\n placeholder={`Enter ${field.label.toLowerCase()}...`}\n />\n {!isCommenting && !existingComment && !isLoading && (\n handleStartFieldComment(field.key)}\n title=\"Add comment\"\n >\n + comment\n \n )}\n
\n\n {/* Comment input */}\n {isCommenting && (\n
\n setCommentInput(e.target.value)}\n placeholder=\"Add your feedback...\"\n autoFocus\n onKeyDown={(e) => {\n if (e.key === 'Enter' && commentInput.trim()) {\n handleSubmitFieldComment(field.key, field.label);\n } else if (e.key === 'Escape') {\n handleCancelFieldComment();\n }\n }}\n />\n
\n \n handleSubmitFieldComment(field.key, field.label)}\n disabled={!commentInput.trim()}\n className=\"primary\"\n >\n Add Comment\n \n
\n
\n )}\n\n {/* Existing comment */}\n {existingComment && !isCommenting && (\n
\n {existingComment.content}\n handleEditFieldComment(field.key, existingComment.content)}\n title=\"Edit comment\"\n >\n Edit\n \n handleRemoveFieldComment(field.key)}\n title=\"Remove comment\"\n >\n ×\n \n
\n )}\n
\n ) : (\n /* Read-only field with comment support */\n
\n
\n \n {!isCommenting && !existingComment && !isLoading && (\n handleStartFieldComment(field.key)}\n title=\"Add comment\"\n >\n + comment\n \n )}\n
\n
{field.value}
\n\n {/* Comment input */}\n {isCommenting && (\n
\n setCommentInput(e.target.value)}\n placeholder=\"Add your feedback...\"\n autoFocus\n onKeyDown={(e) => {\n if (e.key === 'Enter' && commentInput.trim()) {\n handleSubmitFieldComment(field.key, field.label);\n } else if (e.key === 'Escape') {\n handleCancelFieldComment();\n }\n }}\n />\n
\n \n handleSubmitFieldComment(field.key, field.label)}\n disabled={!commentInput.trim()}\n className=\"primary\"\n >\n Add Comment\n \n
\n
\n )}\n\n {/* Existing comment */}\n {existingComment && !isCommenting && (\n
\n {existingComment.content}\n handleEditFieldComment(field.key, existingComment.content)}\n title=\"Edit comment\"\n >\n Edit\n \n handleRemoveFieldComment(field.key)}\n title=\"Remove comment\"\n >\n ×\n \n
\n )}\n
\n )}\n
\n );\n })}\n
\n\n {/* Footer with actions */}\n {\n // Pass back any edited field values\n if (Object.keys(editedValues).length > 0) {\n onApprove(editedValues);\n } else {\n onApprove();\n }\n }}\n onRequestChanges={handleRequestChanges}\n onCancel={onCancel}\n isLoading={isLoading}\n approveLabel={toolConfig.buttonLabel}\n commentCount={totalComments}\n />\n
\n );\n}\n" }, { "path": "src/components/Approval/EmailApproval.css", "content": "/**\n * Email Approval View Styles\n *\n * Email-client style layout for Gmail send/draft approvals.\n */\n\n.email-approval-view {\n display: flex;\n flex-direction: column;\n height: 100%;\n min-height: 400px;\n}\n\n/* Header */\n.email-approval-header {\n display: flex;\n align-items: center;\n gap: var(--space-3);\n padding: var(--space-3) var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n background: var(--color-bg-secondary);\n}\n\n.email-approval-header h3 {\n margin: 0;\n font-size: 15px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n/* Recipients Section */\n.email-approval-recipients {\n display: flex;\n flex-direction: column;\n padding: var(--space-3) var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n background: var(--color-bg-primary);\n}\n\n.email-recipient-field {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n}\n\n.email-recipient-field + .email-recipient-field {\n margin-top: var(--space-2);\n}\n\n.email-recipient-row {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n min-height: 28px;\n}\n\n.email-recipient-label {\n width: 60px;\n flex-shrink: 0;\n font-size: 12px;\n font-weight: 500;\n color: var(--color-text-muted);\n text-align: left;\n}\n\n.email-recipient-input {\n flex: 1;\n padding: var(--space-1) var(--space-2);\n font-size: 13px;\n font-family: var(--font-mono);\n color: var(--color-text-primary);\n background: transparent;\n border: 1px solid transparent;\n border-radius: var(--radius-sm);\n transition: border-color 0.15s, background 0.15s;\n}\n\n.email-recipient-input:hover {\n background: var(--color-bg-secondary);\n border-color: var(--color-border-default);\n}\n\n.email-recipient-input:focus {\n outline: none;\n background: var(--color-bg-primary);\n border-color: var(--color-border-focus);\n}\n\n.email-recipient-input:disabled {\n color: var(--color-text-muted);\n cursor: not-allowed;\n}\n\n.email-recipient-add-comment {\n padding: 2px 8px;\n font-size: 11px;\n color: var(--color-text-muted);\n background: transparent;\n border: none;\n border-radius: var(--radius-sm);\n cursor: pointer;\n opacity: 0;\n transition: opacity 0.15s, background 0.15s;\n}\n\n.email-recipient-row:hover .email-recipient-add-comment {\n opacity: 1;\n}\n\n.email-recipient-add-comment:hover {\n background: var(--color-bg-tertiary);\n color: var(--color-text-secondary);\n}\n\n/* Field comment input */\n.email-recipient-comment-input {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n padding: var(--space-2);\n margin-left: 48px;\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n}\n\n.email-recipient-comment-input input {\n padding: var(--space-2);\n font-size: 13px;\n color: var(--color-text-primary);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n}\n\n.email-recipient-comment-input input:focus {\n outline: none;\n border-color: var(--color-border-focus);\n}\n\n.email-recipient-comment-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n}\n\n.email-recipient-comment-actions button {\n padding: 4px 10px;\n font-size: 12px;\n border-radius: var(--radius-sm);\n cursor: pointer;\n border: none;\n}\n\n.email-recipient-comment-actions button:first-child {\n background: transparent;\n color: var(--color-text-secondary);\n}\n\n.email-recipient-comment-actions button:first-child:hover {\n background: var(--color-bg-tertiary);\n}\n\n.email-recipient-comment-actions button.primary {\n background: var(--color-accent-primary);\n color: white;\n font-weight: 500;\n}\n\n.email-recipient-comment-actions button.primary:hover:not(:disabled) {\n opacity: 0.9;\n}\n\n.email-recipient-comment-actions button.primary:disabled {\n opacity: 0.4;\n cursor: not-allowed;\n}\n\n/* Existing field comment */\n.email-recipient-comment {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n margin-left: 68px;\n margin-top: var(--space-1);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-left: 3px solid #3b82f6;\n border-radius: var(--radius-md);\n font-size: 13px;\n box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05);\n}\n\n.email-recipient-comment-content {\n flex: 1;\n color: var(--color-text-primary);\n}\n\n.email-recipient-comment-edit,\n.email-recipient-comment-remove {\n padding: 2px 6px;\n font-size: 11px;\n background: transparent;\n border: none;\n border-radius: var(--radius-sm);\n cursor: pointer;\n color: var(--color-text-muted);\n}\n\n.email-recipient-comment-edit:hover,\n.email-recipient-comment-remove:hover {\n background: var(--color-bg-tertiary);\n color: var(--color-text-secondary);\n}\n\n/* Subject Section */\n.email-approval-subject {\n padding: var(--space-3) var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n background: var(--color-bg-primary);\n}\n\n.email-approval-subject .email-recipient-input {\n font-weight: 600;\n}\n\n/* Body Section */\n.email-approval-body {\n flex: 1;\n min-height: 0; /* Required for flex child to scroll */\n display: flex;\n flex-direction: column;\n padding: var(--space-3) var(--space-4);\n background: var(--color-bg-primary);\n}\n\n.email-approval-body .commentable-text {\n flex: 1;\n min-height: 0;\n display: flex;\n flex-direction: column;\n}\n\n.email-approval-body .commentable-text-content {\n flex: 1;\n min-height: 0;\n overflow-y: auto;\n}\n\n/* Footer override for edge-to-edge layout */\n.email-approval-view .approval-footer {\n padding: var(--space-3) var(--space-4);\n}\n" }, { "path": "src/components/Approval/EmailApproval.tsx", "content": "/**\n * Email Approval View\n *\n * Dedicated approval view for Gmail send/draft operations.\n * Displays email in familiar email-client style layout with\n * editable subject and commentable body.\n */\n\nimport { useState } from 'react';\nimport { McpIcon } from '../common';\nimport { ApprovalFooter } from './ApprovalFooter';\nimport { CommentableText, formatTextComments } from '../CommentableText/CommentableText';\nimport { useFieldComments, type FieldComment } from '../../hooks';\nimport type { TextComment } from '../../types';\nimport type { ApprovalViewProps } from './ApprovalViewRegistry';\nimport './EmailApproval.css';\n\ninterface EmailApprovalData {\n to?: string;\n cc?: string;\n bcc?: string;\n subject?: string;\n body?: string;\n}\n\nexport function EmailApproval({\n action,\n data,\n onApprove,\n onRequestChanges,\n onCancel,\n isLoading,\n}: ApprovalViewProps) {\n // Parse email data - handle JSON string case\n let emailData: EmailApprovalData = {};\n if (typeof data === 'string') {\n try {\n emailData = JSON.parse(data);\n } catch {\n emailData = {};\n }\n } else {\n emailData = data as EmailApprovalData;\n }\n\n const {\n to: proposedTo = '',\n cc: proposedCc = '',\n bcc: proposedBcc = '',\n subject: proposedSubject = '',\n body = '',\n } = emailData;\n\n // Editable fields\n const [emailTo, setEmailTo] = useState(proposedTo);\n const [emailCc, setEmailCc] = useState(proposedCc);\n const [emailBcc, setEmailBcc] = useState(proposedBcc);\n const [emailSubject, setEmailSubject] = useState(proposedSubject);\n\n // Body comments (line-level via CommentableText)\n const [bodyComments, setBodyComments] = useState([]);\n\n // Field comments using shared hook\n const {\n fieldComments,\n commentingField,\n commentInput,\n setCommentInput,\n startFieldComment,\n editFieldComment,\n submitFieldComment,\n cancelFieldComment,\n removeFieldComment,\n getFieldComment,\n commentCount: fieldCommentCount,\n } = useFieldComments();\n\n // Body comment handlers\n const handleAddBodyComment = (comment: Omit) => {\n const newComment: TextComment = {\n ...comment,\n id: `comment-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n };\n setBodyComments((prev) => [...prev, newComment]);\n };\n\n const handleRemoveBodyComment = (id: string) => {\n setBodyComments((prev) => prev.filter((c) => c.id !== id));\n };\n\n // Wrapper functions for the hook (to match component expectations)\n const handleStartFieldComment = (fieldKey: string) => startFieldComment(fieldKey);\n const handleEditFieldComment = (fieldKey: string, content: string) => editFieldComment(fieldKey, content);\n const handleSubmitFieldComment = (fieldKey: string, fieldLabel: string) => submitFieldComment(fieldKey, fieldLabel);\n const handleCancelFieldComment = () => cancelFieldComment();\n const handleRemoveFieldComment = (fieldKey: string) => removeFieldComment(fieldKey);\n\n // Total comments count\n const totalComments = bodyComments.length + fieldCommentCount;\n\n // Format all comments as feedback\n const formatAllFeedback = (): string => {\n const sections: string[] = [];\n\n // Field comments\n for (const fc of fieldComments) {\n sections.push(`[${fc.fieldLabel}]: \"${fc.content}\"`);\n }\n\n // Body comments\n if (bodyComments.length > 0) {\n sections.push(`[Message Body]\\n${formatTextComments(bodyComments)}`);\n }\n\n return sections.join('\\n\\n');\n };\n\n const handleApprove = () => {\n // Pass back edited fields\n (onApprove as (responseData?: Record) => void)({\n to: emailTo.trim() || proposedTo,\n cc: emailCc.trim() || undefined,\n bcc: emailBcc.trim() || undefined,\n subject: emailSubject.trim() || proposedSubject,\n });\n };\n\n const handleRequestChanges = () => {\n const feedback = formatAllFeedback();\n onRequestChanges(feedback);\n };\n\n // Determine action label\n const isSend = action?.toLowerCase().includes('send');\n const approveLabel = isSend ? 'Send Email' : 'Save Draft';\n\n return (\n
\n {/* Header */}\n
\n \n

{action || (isSend ? 'Send Email' : 'Create Draft')}

\n
\n\n {/* Recipients Section */}\n
\n handleStartFieldComment('to')}\n onCommentChange={setCommentInput}\n onSubmitComment={() => handleSubmitFieldComment('to', 'To')}\n onCancelComment={handleCancelFieldComment}\n onEditComment={(content) => handleEditFieldComment('to', content)}\n onRemoveComment={() => handleRemoveFieldComment('to')}\n disabled={isLoading}\n />\n {(emailCc || proposedCc) && (\n handleStartFieldComment('cc')}\n onCommentChange={setCommentInput}\n onSubmitComment={() => handleSubmitFieldComment('cc', 'CC')}\n onCancelComment={handleCancelFieldComment}\n onEditComment={(content) => handleEditFieldComment('cc', content)}\n onRemoveComment={() => handleRemoveFieldComment('cc')}\n disabled={isLoading}\n />\n )}\n {(emailBcc || proposedBcc) && (\n handleStartFieldComment('bcc')}\n onCommentChange={setCommentInput}\n onSubmitComment={() => handleSubmitFieldComment('bcc', 'BCC')}\n onCancelComment={handleCancelFieldComment}\n onEditComment={(content) => handleEditFieldComment('bcc', content)}\n onRemoveComment={() => handleRemoveFieldComment('bcc')}\n disabled={isLoading}\n />\n )}\n
\n\n {/* Subject (editable with comment) */}\n
\n handleStartFieldComment('subject')}\n onCommentChange={setCommentInput}\n onSubmitComment={() => handleSubmitFieldComment('subject', 'Subject')}\n onCancelComment={handleCancelFieldComment}\n onEditComment={(content) => handleEditFieldComment('subject', content)}\n onRemoveComment={() => handleRemoveFieldComment('subject')}\n disabled={isLoading}\n />\n
\n\n {/* Body (commentable) */}\n
\n \n
\n\n {/* Footer */}\n \n
\n );\n}\n\n/**\n * Recipient field with comment support\n */\ninterface RecipientFieldProps {\n label: string;\n value: string;\n onChange: (value: string) => void;\n fieldKey: string;\n isCommenting: boolean;\n existingComment?: FieldComment;\n commentInput: string;\n onStartComment: () => void;\n onCommentChange: (value: string) => void;\n onSubmitComment: () => void;\n onCancelComment: () => void;\n onEditComment: (content: string) => void;\n onRemoveComment: () => void;\n disabled: boolean;\n}\n\nfunction RecipientField({\n label,\n value,\n onChange,\n isCommenting,\n existingComment,\n commentInput,\n onStartComment,\n onCommentChange,\n onSubmitComment,\n onCancelComment,\n onEditComment,\n onRemoveComment,\n disabled,\n}: RecipientFieldProps) {\n return (\n
\n
\n {label}:\n onChange(e.target.value)}\n disabled={disabled}\n placeholder={`Enter ${label.toLowerCase()}...`}\n />\n {!isCommenting && !existingComment && !disabled && (\n \n + comment\n \n )}\n
\n\n {/* Comment input */}\n {isCommenting && (\n
\n onCommentChange(e.target.value)}\n placeholder=\"Add your feedback...\"\n autoFocus\n onKeyDown={(e) => {\n if (e.key === 'Enter' && commentInput.trim()) {\n onSubmitComment();\n } else if (e.key === 'Escape') {\n onCancelComment();\n }\n }}\n />\n
\n \n \n Add Comment\n \n
\n
\n )}\n\n {/* Existing comment */}\n {existingComment && !isCommenting && (\n
\n {existingComment.content}\n onEditComment(existingComment.content)}\n title=\"Edit comment\"\n >\n Edit\n \n \n ×\n \n
\n )}\n
\n );\n}\n" }, { "path": "src/components/Approval/GitHubPRApproval.css", "content": "/**\n * GitHub PR Approval View Styles\n *\n * Full-width diff viewer layout for PR approval.\n * Similar to ExecutionReviewView but integrated as an approval component.\n */\n\n.pr-approval-view {\n display: flex;\n flex-direction: column;\n height: 100%;\n min-height: 500px;\n}\n\n/* Header */\n.pr-approval-header {\n display: flex;\n align-items: flex-start;\n gap: var(--space-4);\n padding: var(--space-3) var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n background: var(--color-bg-secondary);\n}\n\n.pr-approval-title {\n flex: 1;\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.pr-approval-title-row {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.pr-approval-title h3 {\n margin: 0;\n font-size: 15px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n.pr-approval-repo {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n font-size: 12px;\n color: var(--color-text-secondary);\n}\n\n.pr-approval-repo code {\n font-family: var(--font-mono);\n padding: 2px 6px;\n background: var(--color-bg-tertiary);\n border-radius: var(--radius-sm);\n}\n\n.pr-approval-branch-arrow {\n color: var(--color-text-muted);\n}\n\n.pr-approval-branch-into {\n color: var(--color-text-muted);\n}\n\n.pr-approval-branch {\n color: var(--color-primary);\n}\n\n.pr-approval-stats {\n display: flex;\n gap: var(--space-3);\n font-family: var(--font-mono);\n font-size: 12px;\n}\n\n.pr-approval-stats .stat-files {\n color: var(--color-text-secondary);\n}\n\n.pr-approval-stats .stat-additions {\n color: #22c55e;\n}\n\n.pr-approval-stats .stat-deletions {\n color: #ef4444;\n}\n\n/* Content */\n.pr-approval-content {\n flex: 1;\n display: flex;\n overflow: hidden;\n min-height: 0;\n}\n\n/* Empty state when no diff */\n.pr-approval-content-empty {\n flex: 0;\n min-height: 120px;\n}\n\n.pr-approval-empty {\n flex: 1;\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n gap: var(--space-2);\n padding: var(--space-4);\n color: var(--color-text-muted);\n}\n\n.pr-approval-empty-icon {\n width: 32px;\n height: 32px;\n display: flex;\n align-items: center;\n justify-content: center;\n border-radius: 50%;\n background: var(--color-warning-subtle);\n color: var(--color-warning-text);\n font-weight: 600;\n font-size: 16px;\n}\n\n.pr-approval-empty-title {\n font-size: 14px;\n font-weight: 500;\n color: var(--color-text-secondary);\n}\n\n.pr-approval-empty-message {\n font-size: 12px;\n color: var(--color-text-muted);\n text-align: center;\n max-width: 300px;\n}\n\n.pr-approval-sidebar {\n width: 220px;\n border-right: 1px solid var(--color-border-default);\n overflow-y: auto;\n background: var(--color-bg-secondary);\n}\n\n.pr-approval-diff {\n flex: 1;\n overflow-y: auto;\n padding: var(--space-3);\n}\n\n/* Footer */\n.pr-approval-footer {\n padding: var(--space-3) var(--space-4);\n border-top: 1px solid var(--color-border-default);\n background: var(--color-bg-secondary);\n}\n\n.pr-approval-form {\n display: flex;\n flex-direction: column;\n gap: var(--space-3);\n}\n\n.pr-approval-form-fields {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.pr-approval-form-body {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n}\n\n.pr-approval-textarea {\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-primary);\n resize: vertical;\n min-height: 60px;\n}\n\n.pr-approval-textarea:focus {\n outline: none;\n border-color: var(--color-border-focus);\n}\n\n.pr-approval-textarea:disabled {\n background: var(--color-bg-tertiary);\n color: var(--color-text-muted);\n cursor: not-allowed;\n}\n\n/* Agent feedback (collapsible) */\n.pr-approval-agent-feedback {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.pr-approval-agent-feedback-bar {\n display: flex;\n align-items: center;\n justify-content: space-between;\n}\n\n.pr-approval-agent-feedback-label {\n font-size: 11px;\n text-transform: uppercase;\n letter-spacing: 0.03em;\n color: var(--color-text-muted);\n}\n\n.pr-approval-agent-feedback-dismiss {\n border: none;\n background: transparent;\n font-size: 12px;\n color: var(--color-text-muted);\n cursor: pointer;\n padding: 0;\n}\n\n.pr-approval-agent-feedback-dismiss:hover {\n color: var(--color-text-primary);\n}\n\n.pr-approval-agent-feedback-count {\n font-weight: 400;\n}\n\n.pr-approval-add-note-link {\n align-self: flex-start;\n border: none;\n background: transparent;\n font-size: 12px;\n color: var(--color-text-muted);\n cursor: pointer;\n padding: 0;\n}\n\n.pr-approval-add-note-link:hover {\n color: var(--color-text-primary);\n}\n\n.pr-approval-agent-textarea {\n width: 100%;\n padding: var(--space-2) var(--space-3);\n border: 1px dashed var(--color-border-default);\n border-radius: var(--radius-md);\n background: var(--color-bg-primary);\n color: var(--color-text-primary);\n font-size: 13px;\n font-family: var(--font-mono);\n resize: vertical;\n}\n\n.pr-approval-agent-textarea:focus {\n outline: none;\n border-color: var(--color-border-focus);\n}\n\n.pr-approval-agent-textarea:disabled {\n opacity: 0.6;\n cursor: not-allowed;\n}\n" }, { "path": "src/components/Approval/GitHubPRApproval.tsx", "content": "/**\n * GitHub PR Approval View\n *\n * Full diff viewer for approving pull request creation.\n * Shows the complete diff with file tree, editable PR title/body.\n */\n\nimport { useState, useRef, useMemo } from 'react';\nimport { Input, McpIcon } from '../common';\nimport { ApprovalFooter } from './ApprovalFooter';\nimport { DiffViewer, FileTree } from '../DiffViewer/DiffViewer';\nimport { parseDiff } from '../../utils/diffParser';\nimport type { ApprovalViewProps } from './ApprovalViewRegistry';\nimport type { DiffComment } from '../../types';\nimport './GitHubPRApproval.css';\n\ninterface PRApprovalData {\n owner?: string;\n repo?: string;\n baseBranch?: string; // GitHub tool\n headBranch?: string;\n base?: string; // Sandbox tool\n branch?: string;\n title?: string;\n body?: string;\n diff?: string;\n stats?: {\n files?: number;\n additions?: number;\n deletions?: number;\n };\n}\n\nexport function GitHubPRApproval({\n action,\n data,\n toolResults,\n onApprove,\n onRequestChanges,\n onCancel,\n isLoading,\n}: ApprovalViewProps) {\n const diffViewerRef = useRef(null);\n const [comments, setComments] = useState([]);\n\n // Parse data - handle JSON string case\n let prData: PRApprovalData = {};\n if (typeof data === 'string') {\n try {\n prData = JSON.parse(data);\n } catch {\n prData = {};\n }\n } else {\n prData = data as PRApprovalData;\n }\n\n // Prefer cached getDiff result for diff/stats (agent may truncate large diffs)\n const diffResult = toolResults?.['Sandbox__getDiff'] as PRApprovalData | undefined;\n if (diffResult) {\n if (diffResult.diff) prData.diff = diffResult.diff;\n if (diffResult.stats) prData.stats = diffResult.stats;\n }\n\n const {\n owner = '',\n repo = '',\n baseBranch,\n headBranch,\n base,\n branch,\n title: proposedTitle = '',\n body: proposedBody = '',\n diff = '',\n stats,\n } = prData;\n\n const targetBranch = baseBranch || base || 'main';\n const sourceBranch = headBranch || branch || '';\n\n // Parse the diff content\n const files = useMemo(() => parseDiff(diff), [diff]);\n\n // Editable PR title and body\n const [prTitle, setPrTitle] = useState(proposedTitle);\n const [prBody, setPrBody] = useState(proposedBody);\n const [selectedFile, setSelectedFile] = useState(\n files.length > 0 ? files[0].path : undefined\n );\n const [showAgentFeedback, setShowAgentFeedback] = useState(false);\n const [revisionNote, setRevisionNote] = useState('');\n\n // Calculate stats from parsed diff if not provided\n const totalFiles = stats?.files ?? files.length;\n const totalAdditions = stats?.additions ?? files.reduce((sum, f) => sum + f.additions, 0);\n const totalDeletions = stats?.deletions ?? files.reduce((sum, f) => sum + f.deletions, 0);\n\n const handleFileSelect = (path: string) => {\n setSelectedFile(path);\n // Scroll the file into view in the diff viewer\n if (diffViewerRef.current) {\n const fileElement = diffViewerRef.current.querySelector(`[data-file-path=\"${CSS.escape(path)}\"]`);\n if (fileElement) {\n fileElement.scrollIntoView({ behavior: 'smooth', block: 'start' });\n }\n }\n };\n\n // Comment handlers for diff\n const handleAddComment = (comment: Omit) => {\n const newComment: DiffComment = {\n ...comment,\n id: `comment-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n };\n setComments((prev) => [...prev, newComment]);\n };\n\n const handleRemoveComment = (id: string) => {\n setComments((prev) => prev.filter((c) => c.id !== id));\n };\n\n // Format comments as feedback for the agent\n const formatCommentsFeedback = (): string => {\n if (comments.length === 0) return '';\n\n const lines: string[] = ['DIFF COMMENTS:'];\n\n // Group by file\n const byFile = comments.reduce((acc, c) => {\n if (!acc[c.filePath]) acc[c.filePath] = [];\n acc[c.filePath].push(c);\n return acc;\n }, {} as Record);\n\n for (const [filePath, fileComments] of Object.entries(byFile)) {\n lines.push(`\\nFile: ${filePath}`);\n for (const c of fileComments) {\n const lineRef = c.endLine && c.endLine !== c.lineNumber\n ? `Lines ${c.lineNumber}-${c.endLine}`\n : `Line ${c.lineNumber}`;\n lines.push(` ${lineRef}: \"${c.content}\"`);\n }\n }\n\n return lines.join('\\n');\n };\n\n const handleApprove = () => {\n // Pass back user-edited title/body\n (onApprove as (responseData?: Record) => void)({\n title: prTitle.trim() || proposedTitle,\n body: prBody.trim(),\n });\n };\n\n const hasRevisionNote = revisionNote.trim().length > 0;\n const hasComments = comments.length > 0;\n\n const handleReviseOrExpand = () => {\n // If expanded or has comments: send immediately\n if (showAgentFeedback || hasComments) {\n handleRequestChanges();\n return;\n }\n // Otherwise expand the feedback textarea\n setShowAgentFeedback(true);\n };\n\n const handleRequestChanges = () => {\n const parts: string[] = [];\n if (revisionNote.trim()) {\n parts.push(revisionNote.trim());\n }\n const commentsFeedback = formatCommentsFeedback();\n if (commentsFeedback) {\n parts.push(commentsFeedback);\n }\n onRequestChanges(parts.join('\\n\\n'));\n };\n\n const reviseLabel = showAgentFeedback\n ? 'Send to Agent'\n : hasComments\n ? `Send to Agent (${comments.length})`\n : 'Revise with Agent';\n\n const reviseDisabled = showAgentFeedback\n ? !hasRevisionNote && !hasComments\n : false;\n\n return (\n
\n {/* Header */}\n
\n
\n
\n \n

{action || 'Create Pull Request'}

\n
\n
\n {owner && repo && <>{owner}/{repo}←}\n {sourceBranch}\n into\n {targetBranch}\n
\n
\n
\n {totalFiles} files\n +{totalAdditions}\n -{totalDeletions}\n
\n
\n\n {/* Content */}\n
\n {files.length === 0 ? (\n
\n
!
\n
No diff provided
\n
\n The agent should use Sandbox to make changes and include the diff in the approval request.\n
\n
\n ) : (\n <>\n {/* Sidebar */}\n
\n \n
\n\n {/* Diff View */}\n
\n \n
\n \n )}\n
\n\n {/* Footer with PR form */}\n
\n
\n
\n setPrTitle(e.target.value)}\n placeholder=\"Enter PR title...\"\n disabled={isLoading}\n />\n
\n \n setPrBody(e.target.value)}\n placeholder=\"Describe the changes...\"\n rows={3}\n disabled={isLoading}\n />\n
\n
\n\n {showAgentFeedback && (\n
\n
\n \n Agent feedback\n {hasComments && · {comments.length} inline comment{comments.length !== 1 ? 's' : ''} included}\n \n { setShowAgentFeedback(false); setRevisionNote(''); }}\n >\n Cancel\n \n
\n setRevisionNote(e.target.value)}\n placeholder=\"Tell the agent what to change...\"\n rows={2}\n autoFocus\n disabled={isLoading}\n />\n
\n )}\n\n {!showAgentFeedback && hasComments && (\n setShowAgentFeedback(true)}\n >\n + Add general feedback\n \n )}\n\n \n
\n
\n
\n );\n}\n" }, { "path": "src/components/Approval/GitHubPRReviewApproval.css", "content": ".pr-review-approval-view {\n display: flex;\n flex-direction: column;\n height: 100%;\n min-height: 520px;\n}\n\n.pr-review-approval-header {\n display: flex;\n align-items: flex-start;\n justify-content: space-between;\n gap: var(--space-4);\n padding: var(--space-3) var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n background: var(--color-bg-secondary);\n}\n\n.pr-review-approval-title {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n min-width: 0;\n}\n\n.pr-review-approval-title-row {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.pr-review-approval-title-row h3 {\n margin: 0;\n font-size: 15px;\n font-weight: 600;\n}\n\n.pr-review-approval-pr-title {\n font-size: 13px;\n color: var(--color-text-primary);\n}\n\n.pr-review-approval-meta {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n flex-wrap: wrap;\n font-size: 12px;\n color: var(--color-text-secondary);\n}\n\n.pr-review-repo-code,\n.pr-review-branch-code {\n font-family: var(--font-mono);\n padding: 2px 6px;\n border-radius: var(--radius-sm);\n background: var(--color-bg-tertiary);\n}\n\n.pr-review-approval-branch-arrow {\n color: var(--color-text-muted);\n}\n\n.pr-review-approval-branch-into {\n color: var(--color-text-muted);\n}\n\n.pr-review-approval-author {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n font-size: 12px;\n color: var(--color-text-secondary);\n}\n\n.pr-review-author-label {\n color: var(--color-text-muted);\n}\n\n.pr-review-author-handle {\n color: var(--color-text-primary);\n font-weight: 500;\n}\n\n.pr-review-approval-stats {\n display: flex;\n gap: var(--space-3);\n font-family: var(--font-mono);\n font-size: 12px;\n white-space: nowrap;\n}\n\n.pr-review-approval-stats .stat-files {\n color: var(--color-text-secondary);\n}\n\n.pr-review-approval-stats .stat-additions {\n color: #22c55e;\n}\n\n.pr-review-approval-stats .stat-deletions {\n color: #ef4444;\n}\n\n.pr-review-approval-stats .stat-comments {\n color: var(--color-text-primary);\n}\n\n.pr-review-approval-content {\n flex: 1;\n min-height: 0;\n display: flex;\n flex-direction: column;\n}\n\n.pr-review-approval-main {\n flex: 1;\n min-height: 0;\n display: grid;\n grid-template-columns: 260px minmax(0, 1fr);\n}\n\n.pr-review-approval-main-empty {\n grid-template-columns: minmax(0, 1fr);\n}\n\n.pr-review-approval-files {\n border-right: 1px solid var(--color-border-default);\n background: var(--color-bg-secondary);\n overflow-y: auto;\n display: flex;\n flex-direction: column;\n}\n\n.pr-review-approval-diff {\n min-width: 0;\n overflow-y: auto;\n padding: var(--space-3);\n}\n\n/* ── Footer ── */\n\n.pr-review-approval-footer {\n border-top: 1px solid var(--color-border-default);\n background: var(--color-bg-secondary);\n padding: var(--space-3) var(--space-4);\n display: flex;\n flex-direction: column;\n gap: var(--space-3);\n}\n\n.pr-review-footer-top {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n/* Decision pill buttons */\n\n.pr-review-decision-pills {\n display: flex;\n width: fit-content;\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n overflow: hidden;\n}\n\n.pr-review-decision-pill {\n padding: 6px 12px;\n font-size: 12px;\n font-weight: 500;\n border: none;\n background: var(--color-bg-primary);\n color: var(--color-text-secondary);\n cursor: pointer;\n transition: background-color 0.15s, color 0.15s;\n white-space: nowrap;\n}\n\n.pr-review-decision-pill:not(:last-child) {\n border-right: 1px solid var(--color-border-default);\n}\n\n.pr-review-decision-pill:hover:not(.active):not(:disabled) {\n background: var(--color-bg-tertiary);\n}\n\n.pr-review-decision-pill.active {\n background: var(--color-accent-primary);\n color: #fff;\n}\n\n.pr-review-decision-pill:disabled {\n opacity: 0.6;\n cursor: not-allowed;\n}\n\n/* Review body textarea (posted to PR) */\n\n.pr-review-body-textarea {\n flex: 1;\n min-width: 0;\n padding: var(--space-2) var(--space-3);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n background: var(--color-bg-primary);\n color: var(--color-text-primary);\n font-size: 13px;\n resize: vertical;\n}\n\n.pr-review-body-textarea:focus {\n outline: none;\n border-color: var(--color-border-focus);\n}\n\n.pr-review-body-textarea:disabled {\n opacity: 0.6;\n cursor: not-allowed;\n}\n\n/* Agent feedback (collapsible) */\n\n.pr-review-agent-feedback {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.pr-review-agent-feedback-bar {\n display: flex;\n align-items: center;\n justify-content: space-between;\n}\n\n.pr-review-agent-feedback-label {\n font-size: 11px;\n text-transform: uppercase;\n letter-spacing: 0.03em;\n color: var(--color-text-muted);\n}\n\n.pr-review-agent-feedback-dismiss {\n border: none;\n background: transparent;\n font-size: 12px;\n color: var(--color-text-muted);\n cursor: pointer;\n padding: 0;\n}\n\n.pr-review-agent-feedback-dismiss:hover {\n color: var(--color-text-primary);\n}\n\n.pr-review-textarea {\n width: 100%;\n padding: var(--space-2) var(--space-3);\n border: 1px dashed var(--color-border-default);\n border-radius: var(--radius-md);\n background: var(--color-bg-primary);\n color: var(--color-text-primary);\n font-size: 13px;\n font-family: var(--font-mono);\n resize: vertical;\n}\n\n.pr-review-textarea:focus {\n outline: none;\n border-color: var(--color-border-focus);\n}\n\n.pr-review-textarea:disabled {\n opacity: 0.6;\n cursor: not-allowed;\n}\n\n.pr-review-approval-empty {\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n gap: var(--space-2);\n height: 100%;\n color: var(--color-text-muted);\n}\n\n.pr-review-approval-empty-icon {\n width: 32px;\n height: 32px;\n display: flex;\n align-items: center;\n justify-content: center;\n border-radius: 50%;\n background: var(--color-warning-subtle);\n color: var(--color-warning-text);\n font-weight: 600;\n}\n\n.pr-review-approval-empty-title {\n font-size: 14px;\n color: var(--color-text-primary);\n}\n\n.pr-review-approval-empty-message {\n max-width: 320px;\n text-align: center;\n font-size: 12px;\n}\n\n@media (max-width: 1200px) {\n .pr-review-approval-main {\n grid-template-columns: 220px minmax(0, 1fr);\n }\n}\n\n@media (max-width: 900px) {\n .pr-review-approval-main {\n display: flex;\n flex-direction: column;\n }\n\n .pr-review-approval-files {\n border-right: none;\n border-top: 1px solid var(--color-border-default);\n }\n\n .pr-review-decision-pills {\n align-self: stretch;\n }\n\n .pr-review-decision-pill {\n flex: 1;\n text-align: center;\n }\n}\n" }, { "path": "src/components/Approval/GitHubPRReviewApproval.tsx", "content": "/**\n * GitHub PR Review Approval View\n *\n * Review-focused approval UI for posting PR reviews:\n * - Shows PR metadata and author\n * - Displays full diff with inline notes\n * - Supports review decision, summary, comments, and suggestions\n * - Supports \"Revise Review\" loop with revision notes\n */\n\nimport { useMemo, useRef, useState } from 'react';\nimport { McpIcon } from '../common';\nimport { ApprovalFooter } from './ApprovalFooter';\nimport { DiffViewer, FileTree } from '../DiffViewer/DiffViewer';\nimport { parseDiff } from '../../utils/diffParser';\nimport type { ApprovalViewProps } from './ApprovalViewRegistry';\nimport type { DiffComment } from '../../types';\nimport './GitHubPRReviewApproval.css';\n\ntype ReviewDecision = 'APPROVE' | 'REQUEST_CHANGES' | 'COMMENT';\ntype ReviewCommentSide = 'LEFT' | 'RIGHT';\n\ninterface ReviewCommentDraft {\n path: string;\n line: number;\n side: ReviewCommentSide;\n body?: string;\n startLine?: number;\n startSide?: ReviewCommentSide;\n suggestion?: string;\n}\n\ninterface PRReviewApprovalData {\n owner?: string;\n repo?: string;\n pullNumber?: number;\n prTitle?: string;\n title?: string;\n author?: string;\n authorLogin?: string;\n baseBranch?: string;\n headBranch?: string;\n base?: string;\n head?: string;\n diff?: string;\n stats?: {\n files?: number;\n additions?: number;\n deletions?: number;\n };\n event?: ReviewDecision;\n body?: string;\n comments?: ReviewCommentDraft[];\n}\n\nfunction serializeComments(comments: DiffComment[]): string {\n const normalized = comments.map((comment) => ({\n filePath: comment.filePath,\n lineNumber: comment.lineNumber,\n endLine: comment.endLine ?? null,\n lineType: comment.lineType,\n content: comment.content.trim(),\n kind: comment.kind || 'comment',\n suggestion: (comment.suggestion || '').trimEnd(),\n }));\n return JSON.stringify(normalized);\n}\n\n/** Strip wrapping code fences the agent may add — our backend already wraps in ```suggestion. */\nfunction stripCodeFences(text: string): string {\n return text.replace(/^```\\w*\\n?/, '').replace(/\\n?```\\s*$/, '');\n}\n\nfunction toDiffComment(comment: ReviewCommentDraft): DiffComment {\n const rawSuggestion = comment.suggestion?.trimEnd();\n const cleanSuggestion = rawSuggestion ? stripCodeFences(rawSuggestion) : undefined;\n const isSuggestion = !!cleanSuggestion;\n const lineType = comment.side === 'LEFT' ? 'deletion' : 'addition';\n const startLine = comment.startLine ?? comment.line;\n const endLine = comment.line;\n const fallbackContent = isSuggestion ? 'Suggested change' : 'Review note';\n\n return {\n id: `comment-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n filePath: comment.path,\n lineNumber: Math.min(startLine, endLine),\n endLine: startLine !== endLine ? Math.max(startLine, endLine) : undefined,\n lineType,\n content: comment.body?.trim() || fallbackContent,\n kind: isSuggestion ? 'suggestion' : 'comment',\n suggestion: cleanSuggestion,\n };\n}\n\nfunction toReviewComment(comment: DiffComment): ReviewCommentDraft | null {\n const side: ReviewCommentSide = comment.lineType === 'deletion' ? 'LEFT' : 'RIGHT';\n const startLine = comment.lineNumber;\n const endLine = comment.endLine ?? comment.lineNumber;\n const normalizedStartLine = Math.min(startLine, endLine);\n const normalizedEndLine = Math.max(startLine, endLine);\n const baseBody = comment.content.trim();\n const suggestion = comment.kind === 'suggestion' ? (comment.suggestion?.trimEnd() || '') : undefined;\n\n if (!baseBody && !suggestion) {\n return null;\n }\n\n // GitHub suggestions are only supported on RIGHT side comments.\n if (comment.kind === 'suggestion' && side === 'LEFT') {\n return {\n path: comment.filePath,\n line: normalizedEndLine,\n side,\n startLine: normalizedStartLine !== normalizedEndLine ? normalizedStartLine : undefined,\n startSide: normalizedStartLine !== normalizedEndLine ? side : undefined,\n body: [baseBody, suggestion].filter(Boolean).join('\\n\\n'),\n };\n }\n\n return {\n path: comment.filePath,\n line: normalizedEndLine,\n side,\n startLine: normalizedStartLine !== normalizedEndLine ? normalizedStartLine : undefined,\n startSide: normalizedStartLine !== normalizedEndLine ? side : undefined,\n body: baseBody,\n suggestion,\n };\n}\n\nfunction formatLineRef(comment: DiffComment): string {\n if (comment.endLine && comment.endLine !== comment.lineNumber) {\n return `L${comment.lineNumber}-${comment.endLine}`;\n }\n return `L${comment.lineNumber}`;\n}\n\nexport function GitHubPRReviewApproval({\n action,\n data,\n toolResults,\n onApprove,\n onRequestChanges,\n onCancel,\n isLoading,\n}: ApprovalViewProps) {\n const diffViewerRef = useRef(null);\n\n let reviewData: PRReviewApprovalData = {};\n if (typeof data === 'string') {\n try {\n reviewData = JSON.parse(data);\n } catch {\n reviewData = {};\n }\n } else {\n reviewData = data as PRReviewApprovalData;\n }\n\n // Prefer cached getPullRequest result for diff/stats (agent may truncate large diffs)\n const prResult = toolResults?.['GitHub__getPullRequest'] as PRReviewApprovalData | undefined;\n if (prResult) {\n if (prResult.diff) reviewData.diff = prResult.diff;\n if (prResult.stats) reviewData.stats = prResult.stats;\n if (!reviewData.author && prResult.author) reviewData.author = prResult.author;\n if (!reviewData.baseBranch && prResult.base) reviewData.baseBranch = prResult.base;\n if (!reviewData.headBranch && prResult.head) reviewData.headBranch = prResult.head;\n }\n\n const {\n owner = '',\n repo = '',\n pullNumber,\n prTitle = reviewData.title || '',\n author = reviewData.authorLogin || reviewData.author || '',\n baseBranch,\n headBranch,\n base = 'main',\n head = '',\n diff = '',\n stats,\n event = 'COMMENT',\n body = '',\n comments: proposedComments = [],\n } = reviewData;\n\n const files = useMemo(() => parseDiff(diff), [diff]);\n\n const [selectedFile, setSelectedFile] = useState(\n files.length > 0 ? files[0].path : undefined\n );\n const [reviewDecision, setReviewDecision] = useState(event);\n const [reviewBody, setReviewBody] = useState(body);\n const [revisionNote, setRevisionNote] = useState('');\n const [showAgentFeedback, setShowAgentFeedback] = useState(false);\n const [activeInlineNoteId, setActiveInlineNoteId] = useState(null);\n const [comments, setComments] = useState(\n proposedComments.map(toDiffComment)\n );\n const initialCommentsSnapshot = useMemo(\n () => serializeComments(proposedComments.map(toDiffComment)),\n [proposedComments]\n );\n\n const totalFiles = stats?.files ?? files.length;\n const totalAdditions = stats?.additions ?? files.reduce((sum, f) => sum + f.additions, 0);\n const totalDeletions = stats?.deletions ?? files.reduce((sum, f) => sum + f.deletions, 0);\n const noteCountsByFile = useMemo(() => {\n const counts: Record = {};\n for (const comment of comments) {\n counts[comment.filePath] = (counts[comment.filePath] || 0) + 1;\n }\n return counts;\n }, [comments]);\n\n const hasRevisionNote = revisionNote.trim().length > 0;\n const commentsChanged = serializeComments(comments) !== initialCommentsSnapshot;\n\n const handleFileSelect = (path: string) => {\n setSelectedFile(path);\n if (diffViewerRef.current) {\n const fileElement = diffViewerRef.current.querySelector(`[data-file-path=\"${CSS.escape(path)}\"]`);\n if (fileElement) {\n fileElement.scrollIntoView({ behavior: 'smooth', block: 'start' });\n }\n }\n };\n\n const handleAddComment = (comment: Omit) => {\n const next: DiffComment = {\n ...comment,\n id: `comment-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n kind: comment.kind || 'comment',\n };\n setComments((prev) => [...prev, next]);\n setActiveInlineNoteId(next.id);\n };\n\n const handleRemoveComment = (id: string) => {\n setComments((prev) => prev.filter((c) => c.id !== id));\n setActiveInlineNoteId((prev) => (prev === id ? null : prev));\n };\n\n const handleApprove = () => {\n const reviewComments = comments\n .map(toReviewComment)\n .filter((comment): comment is ReviewCommentDraft => comment !== null);\n\n onApprove({\n owner,\n repo,\n pullNumber,\n event: reviewDecision,\n body: reviewBody.trim(),\n comments: reviewComments,\n });\n };\n\n const handleReviseOrExpand = () => {\n if (!showAgentFeedback) {\n setShowAgentFeedback(true);\n return;\n }\n handleReviseReview();\n };\n\n const handleReviseReview = () => {\n const lines: string[] = ['REVISE REVIEW:'];\n\n if (revisionNote.trim()) {\n lines.push('\\nGeneral revision notes:');\n lines.push(revisionNote.trim());\n }\n\n if (commentsChanged && comments.length > 0) {\n lines.push('\\nUser-edited inline review notes:');\n for (const comment of comments) {\n const typeLabel = comment.kind === 'suggestion' ? 'Suggestion' : 'Comment';\n const location = `${comment.filePath} ${formatLineRef(comment)}`;\n lines.push(`- [${typeLabel}] ${location}: \"${comment.content.trim()}\"`);\n if (comment.kind === 'suggestion' && comment.suggestion?.trim()) {\n lines.push(` Suggested change: \"${comment.suggestion.trim()}\"`);\n }\n }\n }\n\n onRequestChanges(lines.join('\\n'));\n };\n\n return (\n
\n
\n
\n
\n \n

{action || 'Review Pull Request'}

\n
\n
{prTitle || 'Pull Request'}
\n
\n {owner && repo && (\n \n {owner}/{repo}\n {typeof pullNumber === 'number' ? ` PR #${pullNumber}` : ''}\n \n )}\n ←\n {headBranch || head || 'feature'}\n into\n {baseBranch || base || 'main'}\n
\n {author && (\n
\n Author\n @{author}\n
\n )}\n
\n
\n {totalFiles} files\n +{totalAdditions}\n -{totalDeletions}\n {comments.length} notes\n
\n
\n\n
\n
\n {files.length > 0 && (\n
\n \n
\n )}\n\n
\n {files.length === 0 ? (\n
\n
!
\n
No diff provided
\n
\n Include a unified diff in the approval payload to review inline comments and suggestions.\n
\n
\n ) : (\n \n )}\n
\n
\n\n
\n\n
\n
\n
\n {(['COMMENT', 'REQUEST_CHANGES', 'APPROVE'] as const).map((value) => (\n setReviewDecision(value)}\n disabled={isLoading}\n >\n {value === 'COMMENT' ? 'Comment' : value === 'REQUEST_CHANGES' ? 'Request Changes' : 'Approve'}\n \n ))}\n
\n setReviewBody(e.target.value)}\n placeholder=\"Review comment (posted to the pull request)...\"\n rows={4}\n disabled={isLoading}\n />\n
\n\n {showAgentFeedback && (\n
\n
\n Agent feedback\n { setShowAgentFeedback(false); setRevisionNote(''); }}\n >\n Cancel\n \n
\n setRevisionNote(e.target.value)}\n placeholder=\"Tell the agent how to revise this review...\"\n rows={2}\n autoFocus\n disabled={isLoading}\n />\n
\n )}\n\n \n
\n
\n );\n}\n" }, { "path": "src/components/Approval/GoogleDocsApproval.css", "content": "/**\n * Google Docs Approval View Styles\n *\n * Full-width side-by-side diff layout for document approval.\n * Similar to GitHubPRApproval but styled for prose content.\n */\n\n.docs-approval-view {\n display: flex;\n flex-direction: column;\n height: 100%;\n min-height: 500px;\n}\n\n/* Header */\n.docs-approval-header {\n display: flex;\n align-items: flex-start;\n justify-content: space-between;\n gap: var(--space-4);\n padding: var(--space-3) var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n background: var(--color-bg-secondary);\n}\n\n.docs-approval-title {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.docs-approval-title-row {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.docs-approval-title h3 {\n margin: 0;\n font-size: 15px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n.docs-approval-doc-info {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n font-size: 13px;\n}\n\n.docs-approval-doc-name {\n color: var(--color-text-secondary);\n font-weight: 500;\n}\n\n/* Editable title (for create document) */\n.docs-approval-editable-title {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.docs-approval-title-label {\n font-size: 11px;\n font-weight: 600;\n color: var(--color-text-muted);\n text-transform: uppercase;\n letter-spacing: 0.5px;\n}\n\n.docs-approval-title-input-row {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.docs-approval-title-input {\n flex: 1;\n min-width: 400px;\n padding: var(--space-2) var(--space-3);\n font-size: 14px;\n font-weight: 500;\n color: var(--color-text-primary);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n transition: border-color 0.15s;\n}\n\n.docs-approval-title-input:focus {\n outline: none;\n border-color: var(--color-accent-primary);\n}\n\n.docs-approval-title-input:disabled {\n opacity: 0.6;\n cursor: not-allowed;\n}\n\n.docs-approval-add-comment {\n padding: 4px 8px;\n font-size: 11px;\n color: var(--color-text-muted);\n background: transparent;\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n cursor: pointer;\n white-space: nowrap;\n transition: all 0.15s;\n}\n\n.docs-approval-add-comment:hover {\n color: var(--color-text-primary);\n border-color: var(--color-text-muted);\n}\n\n.docs-approval-title-comment-input {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-accent-primary);\n border-radius: var(--radius-sm);\n}\n\n.docs-approval-title-comment-input input {\n flex: 1;\n padding: var(--space-1) var(--space-2);\n font-size: 13px;\n color: var(--color-text-primary);\n background: transparent;\n border: none;\n}\n\n.docs-approval-title-comment-input input:focus {\n outline: none;\n}\n\n.docs-approval-title-comment-actions {\n display: flex;\n gap: var(--space-1);\n}\n\n.docs-approval-title-comment-actions button {\n padding: 4px 8px;\n font-size: 11px;\n border-radius: var(--radius-sm);\n cursor: pointer;\n border: none;\n}\n\n.docs-approval-title-comment-actions button:first-child {\n background: transparent;\n color: var(--color-text-muted);\n}\n\n.docs-approval-title-comment-actions button:first-child:hover {\n color: var(--color-text-primary);\n}\n\n.docs-approval-title-comment-actions button.primary {\n background: var(--color-accent-primary);\n color: white;\n}\n\n.docs-approval-title-comment-actions button.primary:disabled {\n opacity: 0.4;\n cursor: default;\n}\n\n.docs-approval-title-comment {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-left: 3px solid #3b82f6;\n border-radius: var(--radius-sm);\n font-size: 13px;\n}\n\n.docs-approval-title-comment-content {\n flex: 1;\n color: var(--color-text-primary);\n}\n\n.docs-approval-title-comment-edit,\n.docs-approval-title-comment-remove {\n padding: 2px 6px;\n font-size: 11px;\n background: transparent;\n border: none;\n color: var(--color-text-muted);\n cursor: pointer;\n border-radius: var(--radius-sm);\n}\n\n.docs-approval-title-comment-edit:hover {\n color: var(--color-accent-primary);\n}\n\n.docs-approval-title-comment-remove:hover {\n color: #ef4444;\n background: rgba(239, 68, 68, 0.1);\n}\n\n.docs-approval-stats {\n display: flex;\n gap: var(--space-3);\n font-size: 12px;\n}\n\n.docs-approval-stats .stat-current {\n color: var(--color-text-muted);\n}\n\n.docs-approval-stats .stat-additions {\n color: #22c55e;\n}\n\n/* Content - side by side */\n.docs-approval-content {\n flex: 1;\n display: grid;\n grid-template-columns: 1fr 1fr;\n overflow: hidden;\n min-height: 0;\n}\n\n/* Single panel mode (for create) */\n.docs-approval-content-single {\n grid-template-columns: 1fr;\n}\n\n.docs-approval-content-single .docs-approval-panel {\n border-right: none;\n}\n\n.docs-approval-content-single .docs-paragraph-content {\n font-size: 15px;\n line-height: 1.7;\n padding: var(--space-2) var(--space-4);\n}\n\n.docs-approval-content-single .docs-paragraph-added {\n background: transparent;\n}\n\n.docs-approval-content-single .docs-paragraph-added:hover {\n background: rgba(59, 130, 246, 0.06);\n}\n\n/* Panels */\n.docs-approval-panel {\n display: flex;\n flex-direction: column;\n overflow: hidden;\n border-right: 1px solid var(--color-border-default);\n}\n\n.docs-approval-panel:last-child {\n border-right: none;\n}\n\n.docs-approval-panel-header {\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-tertiary);\n border-bottom: 1px solid var(--color-border-default);\n flex-shrink: 0;\n}\n\n.docs-approval-panel-label {\n font-size: 11px;\n font-weight: 600;\n color: var(--color-text-muted);\n text-transform: uppercase;\n letter-spacing: 0.5px;\n}\n\n.docs-approval-panel-current .docs-approval-panel-header {\n background: rgba(239, 68, 68, 0.05);\n}\n\n.docs-approval-panel-after .docs-approval-panel-header {\n background: rgba(34, 197, 94, 0.05);\n}\n\n.docs-approval-panel-after .docs-approval-panel-label {\n color: #22c55e;\n}\n\n.docs-approval-panel-body {\n flex: 1;\n overflow-y: auto;\n background: var(--color-bg-primary);\n}\n\n.docs-approval-empty-panel {\n color: var(--color-text-muted);\n font-style: italic;\n font-size: 13px;\n padding: var(--space-4);\n text-align: center;\n}\n\n/* Paragraphs - continuous like CommentableText */\n.docs-paragraph-wrapper {\n display: flex;\n flex-direction: column;\n}\n\n.docs-paragraph {\n display: flex;\n align-items: flex-start;\n min-height: 28px;\n line-height: 1.5;\n user-select: none;\n cursor: pointer;\n}\n\n.docs-paragraph:hover {\n background: rgba(59, 130, 246, 0.06);\n}\n\n.docs-paragraph:hover .docs-comment-indicator.can-comment {\n opacity: 1;\n}\n\n.docs-paragraph.selected {\n background: rgba(59, 130, 246, 0.12);\n}\n\n.docs-paragraph-content {\n flex: 1;\n padding: var(--space-1) var(--space-3);\n font-family: var(--font-sans);\n font-size: 14px;\n color: var(--color-text-primary);\n white-space: pre-wrap;\n word-wrap: break-word;\n}\n\n/* Comment indicator column */\n.docs-comment-indicator {\n width: 28px;\n flex-shrink: 0;\n display: flex;\n align-items: center;\n justify-content: center;\n font-size: 14px;\n font-weight: 600;\n color: var(--color-text-muted);\n opacity: 0;\n transition: opacity 0.15s;\n}\n\n.docs-comment-indicator.has-comment {\n opacity: 1;\n color: var(--color-accent-primary);\n}\n\n/* Diff status styling */\n.docs-paragraph-added {\n background: rgba(34, 197, 94, 0.08);\n}\n\n.docs-paragraph-added:hover {\n background: rgba(34, 197, 94, 0.14);\n}\n\n.docs-paragraph-added .docs-comment-indicator {\n color: #22c55e;\n}\n\n.docs-paragraph-removed {\n background: rgba(239, 68, 68, 0.08);\n}\n\n.docs-paragraph-removed:hover {\n background: rgba(239, 68, 68, 0.12);\n}\n\n.docs-paragraph-removed .docs-paragraph-content {\n text-decoration: line-through;\n color: var(--color-text-muted);\n}\n\n.docs-paragraph-removed .docs-comment-indicator {\n color: #ef4444;\n}\n\n/* Diff marker for removed items (left side only) */\n.docs-diff-marker {\n width: 28px;\n flex-shrink: 0;\n display: flex;\n align-items: center;\n justify-content: center;\n font-size: 14px;\n font-weight: 600;\n color: #ef4444;\n}\n\n/* Comment input - matches CommentableText style */\n.docs-comment-input {\n margin: var(--space-2) var(--space-3);\n padding: var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-accent-primary);\n border-left: 3px solid var(--color-accent-primary);\n border-radius: var(--radius-sm);\n box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);\n}\n\n.docs-comment-input textarea {\n width: 100%;\n padding: var(--space-2);\n font-family: var(--font-sans);\n font-size: 13px;\n line-height: 1.4;\n border: none;\n background: transparent;\n color: var(--color-text-primary);\n resize: none;\n min-height: 48px;\n}\n\n.docs-comment-input textarea::placeholder {\n color: var(--color-text-muted);\n}\n\n.docs-comment-input textarea:focus {\n outline: none;\n}\n\n.docs-comment-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-2);\n border-top: 1px solid var(--color-border-default);\n}\n\n.docs-comment-actions button {\n padding: 4px 10px;\n font-size: 12px;\n border-radius: var(--radius-sm);\n cursor: pointer;\n transition: all 0.15s ease;\n border: none;\n}\n\n.docs-comment-actions button:first-child {\n background: transparent;\n color: var(--color-text-muted);\n}\n\n.docs-comment-actions button:first-child:hover {\n color: var(--color-text-primary);\n}\n\n.docs-comment-actions button.primary {\n background: var(--color-accent-primary);\n color: white;\n font-weight: 500;\n}\n\n.docs-comment-actions button.primary:hover:not(:disabled) {\n opacity: 0.9;\n}\n\n.docs-comment-actions button.primary:disabled {\n opacity: 0.4;\n cursor: default;\n}\n\n/* Existing comment display - matches CommentableText style */\n.docs-comment {\n position: relative;\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n margin: var(--space-2) var(--space-3);\n padding: var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-left: 3px solid #3b82f6;\n border-radius: var(--radius-sm);\n box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05);\n}\n\n.docs-comment-paras {\n flex-shrink: 0;\n font-size: 10px;\n color: var(--color-text-muted);\n padding: 2px 8px;\n background: rgba(59, 130, 246, 0.1);\n border-radius: 10px;\n align-self: flex-start;\n}\n\n.docs-comment-content {\n flex: 1;\n font-size: 13px;\n color: var(--color-text-primary);\n line-height: 1.5;\n white-space: pre-wrap;\n word-break: break-word;\n}\n\n.docs-comment-remove {\n position: absolute;\n top: var(--space-2);\n right: var(--space-2);\n flex-shrink: 0;\n width: 20px;\n height: 20px;\n padding: 0;\n display: flex;\n align-items: center;\n justify-content: center;\n background: transparent;\n border: none;\n color: var(--color-text-muted);\n cursor: pointer;\n font-size: 14px;\n border-radius: var(--radius-sm);\n opacity: 0;\n transition: all 0.15s ease;\n}\n\n.docs-comment:hover .docs-comment-remove {\n opacity: 1;\n}\n\n.docs-comment-remove:hover {\n background: rgba(239, 68, 68, 0.15);\n color: #ef4444;\n}\n\n/* Footer override for full-width layout */\n.docs-approval-view .approval-footer {\n padding: var(--space-3) var(--space-4);\n}\n" }, { "path": "src/components/Approval/GoogleDocsApproval.tsx", "content": "/**\n * Google Docs Approval View\n *\n * For createDocument: Single-panel document preview with commenting support.\n * For append/replace: Side-by-side document diff with paragraph-level diff highlighting.\n *\n * Used for: createDocument, appendToDocument, replaceDocumentContent\n */\n\nimport { useState, useCallback, useRef } from 'react';\nimport { McpIcon } from '../common';\nimport { ApprovalFooter } from './ApprovalFooter';\nimport { useTitleEdit } from '../../hooks';\nimport type { ApprovalViewProps } from './ApprovalViewRegistry';\nimport './GoogleDocsApproval.css';\n\ninterface GoogleDocsApprovalData {\n documentId?: string;\n title?: string;\n currentContent?: string;\n newContent?: string;\n content?: string;\n action?: 'append' | 'replace';\n url?: string;\n}\n\ninterface TextComment {\n id: string;\n paragraphStart: number;\n paragraphEnd: number;\n side: 'left' | 'right';\n content: string;\n}\n\ninterface ParagraphSelection {\n startIndex: number;\n endIndex: number;\n side: 'left' | 'right';\n}\n\nexport function GoogleDocsApproval({\n action,\n data,\n onApprove,\n onRequestChanges,\n onCancel,\n isLoading,\n}: ApprovalViewProps) {\n const [comments, setComments] = useState([]);\n const [selection, setSelection] = useState(null);\n const [isDragging, setIsDragging] = useState(false);\n const [showCommentInput, setShowCommentInput] = useState(false);\n const [commentText, setCommentText] = useState('');\n const dragStartRef = useRef<{ index: number; side: 'left' | 'right' } | null>(null);\n\n // Editable title (for create document) - using shared hook\n const {\n editedTitle,\n setEditedTitle,\n titleComment,\n showTitleCommentInput,\n titleCommentText,\n handleStartTitleComment,\n handleEditTitleComment,\n handleAddTitleComment,\n handleCancelTitleComment,\n handleRemoveTitleComment,\n setTitleCommentText,\n } = useTitleEdit();\n\n // Parse data\n let docData: GoogleDocsApprovalData = {};\n if (typeof data === 'string') {\n try {\n docData = JSON.parse(data);\n } catch {\n docData = {};\n }\n } else {\n docData = data as GoogleDocsApprovalData;\n }\n\n const {\n title = 'Untitled Document',\n currentContent = '',\n newContent = docData.content || '',\n action: docAction,\n } = docData;\n\n // Detect mode: create (no currentContent), append, or replace\n const isCreate = !currentContent && !docAction;\n const isAppend = docAction === 'append';\n const actionLabel = isCreate\n ? 'Create Document'\n : isAppend\n ? 'Append to Document'\n : 'Replace Document Content';\n\n // Split content into paragraphs for diff display\n const currentParagraphs = currentContent.split(/\\n\\n+/).filter(p => p.trim());\n const newParagraphs = newContent.split(/\\n\\n+/).filter(p => p.trim());\n\n // For append, combine current + new\n const afterParagraphs = isAppend\n ? [...currentParagraphs, ...newParagraphs]\n : newParagraphs;\n\n // Simple diff: mark paragraphs as added, removed, or unchanged\n const getDiffStatus = (para: string, side: 'left' | 'right'): 'added' | 'removed' | 'unchanged' => {\n if (side === 'left') {\n if (isAppend) return 'unchanged';\n const existsInNew = newParagraphs.some(p => p.trim() === para.trim());\n return existsInNew ? 'unchanged' : 'removed';\n } else {\n if (isAppend) {\n const isFromCurrent = currentParagraphs.some(p => p.trim() === para.trim());\n return isFromCurrent ? 'unchanged' : 'added';\n }\n const existsInCurrent = currentParagraphs.some(p => p.trim() === para.trim());\n return existsInCurrent ? 'unchanged' : 'added';\n }\n };\n\n // Selection handlers (like CommentableText) - only for right side\n const handleParagraphMouseDown = useCallback((index: number, side: 'left' | 'right', e: React.MouseEvent) => {\n if (isLoading || side === 'left') return; // Only allow comments on \"After Changes\" side\n e.preventDefault();\n\n dragStartRef.current = { index, side };\n setIsDragging(true);\n setSelection({ startIndex: index, endIndex: index, side });\n setShowCommentInput(false);\n }, [isLoading]);\n\n const handleParagraphMouseEnter = useCallback((index: number, side: 'left' | 'right') => {\n if (!isDragging || !dragStartRef.current || dragStartRef.current.side !== side) return;\n\n const start = dragStartRef.current.index;\n setSelection({\n startIndex: Math.min(start, index),\n endIndex: Math.max(start, index),\n side,\n });\n }, [isDragging]);\n\n const handleMouseUp = useCallback(() => {\n if (isDragging && selection) {\n setShowCommentInput(true);\n }\n setIsDragging(false);\n dragStartRef.current = null;\n }, [isDragging, selection]);\n\n const handleAddComment = () => {\n if (!selection || !commentText.trim()) return;\n\n const newComment: TextComment = {\n id: `comment-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n paragraphStart: selection.startIndex,\n paragraphEnd: selection.endIndex,\n side: selection.side,\n content: commentText.trim(),\n };\n setComments(prev => [...prev, newComment]);\n setSelection(null);\n setShowCommentInput(false);\n setCommentText('');\n };\n\n const handleRemoveComment = (id: string) => {\n setComments(prev => prev.filter(c => c.id !== id));\n };\n\n const handleCancelComment = () => {\n setSelection(null);\n setShowCommentInput(false);\n setCommentText('');\n };\n\n // Check if paragraph is in selection\n const isParagraphSelected = (index: number, side: 'left' | 'right') => {\n if (!selection || selection.side !== side) return false;\n return index >= selection.startIndex && index <= selection.endIndex;\n };\n\n // Check if paragraph has a comment\n const hasComment = useCallback((index: number, side: 'left' | 'right') => {\n return comments.some(c =>\n c.side === side && index >= c.paragraphStart && index <= c.paragraphEnd\n );\n }, [comments]);\n\n // Get comments that end on a specific paragraph\n const getCommentsEndingAt = (index: number, side: 'left' | 'right') => {\n return comments.filter(c => c.paragraphEnd === index && c.side === side);\n };\n\n // Format comments as feedback\n const formatCommentsFeedback = (): string => {\n const hasTitleComment = titleComment !== null;\n const hasParaComments = comments.length > 0;\n\n if (!hasTitleComment && !hasParaComments) return '';\n\n const lines: string[] = ['DOCUMENT COMMENTS:'];\n\n // Title comment\n if (hasTitleComment) {\n lines.push(`\\n[Document Title]: \"${titleComment}\"`);\n }\n\n // Paragraph comments\n for (const c of comments) {\n const sideLabel = c.side === 'left' ? 'Current' : 'New';\n const paraRef = c.paragraphEnd !== c.paragraphStart\n ? `Paragraphs ${c.paragraphStart + 1}-${c.paragraphEnd + 1}`\n : `Paragraph ${c.paragraphStart + 1}`;\n lines.push(`\\n[${sideLabel} - ${paraRef}]: \"${c.content}\"`);\n }\n return lines.join('\\n');\n };\n\n const handleApprove = () => {\n // Pass back edited title if changed (for create document)\n if (isCreate && editedTitle !== null && editedTitle !== title) {\n onApprove({ title: editedTitle });\n } else {\n onApprove();\n }\n };\n\n const handleRequestChanges = () => {\n const feedback = formatCommentsFeedback();\n onRequestChanges(feedback);\n };\n\n // Render a single panel\n const renderPanel = (paragraphs: string[], side: 'left' | 'right', emptyMessage: string) => (\n \n {!isCreate && (\n
\n \n {side === 'left' ? 'Current' : 'After Changes'}\n \n
\n )}\n
\n {paragraphs.length === 0 ? (\n
{emptyMessage}
\n ) : (\n paragraphs.map((para, idx) => {\n const status = getDiffStatus(para, side);\n const isSelected = isParagraphSelected(idx, side);\n const paragraphHasComment = hasComment(idx, side);\n const paragraphComments = getCommentsEndingAt(idx, side);\n const showInputAfterPara = showCommentInput && selection?.endIndex === idx && selection?.side === side;\n\n return (\n
\n handleParagraphMouseDown(idx, side, e)}\n onMouseEnter={() => handleParagraphMouseEnter(idx, side)}\n >\n {para}\n {side === 'right' && (\n \n {status === 'added' ? '+' : '+'}\n \n )}\n {side === 'left' && status === 'removed' && (\n −\n )}\n
\n\n {/* Comment input */}\n {showInputAfterPara && (\n
\n setCommentText(e.target.value)}\n placeholder={selection && selection.startIndex !== selection.endIndex\n ? `Add feedback on paragraphs ${selection.startIndex + 1}-${selection.endIndex + 1}...`\n : 'Add your feedback on this paragraph...'\n }\n autoFocus\n onMouseDown={(e) => e.stopPropagation()}\n onKeyDown={(e) => {\n if (e.key === 'Enter' && e.metaKey) handleAddComment();\n if (e.key === 'Escape') handleCancelComment();\n }}\n />\n
\n \n \n Add Comment\n \n
\n
\n )}\n\n {/* Existing comments that end on this paragraph */}\n {paragraphComments.map(comment => (\n
\n {comment.paragraphEnd !== comment.paragraphStart && (\n \n Paragraphs {comment.paragraphStart + 1}-{comment.paragraphEnd + 1}\n \n )}\n {comment.content}\n { e.stopPropagation(); handleRemoveComment(comment.id); }}\n title=\"Remove comment\"\n >\n ×\n \n
\n ))}\n
\n );\n })\n )}\n
\n \n );\n\n return (\n
\n {/* Header */}\n
\n
\n
\n \n

{action || actionLabel}

\n
\n {isCreate ? (\n /* Editable title for create document */\n
\n \n
\n setEditedTitle(e.target.value)}\n disabled={isLoading}\n placeholder=\"Enter document title...\"\n />\n {!showTitleCommentInput && !titleComment && !isLoading && (\n \n + comment\n \n )}\n
\n\n {/* Title comment input */}\n {showTitleCommentInput && (\n
\n setTitleCommentText(e.target.value)}\n placeholder=\"Add feedback on the document title...\"\n autoFocus\n onKeyDown={(e) => {\n if (e.key === 'Enter' && titleCommentText.trim()) handleAddTitleComment();\n if (e.key === 'Escape') handleCancelTitleComment();\n }}\n />\n
\n \n \n Add\n \n
\n
\n )}\n\n {/* Existing title comment */}\n {titleComment && !showTitleCommentInput && (\n
\n {titleComment}\n \n Edit\n \n \n ×\n \n
\n )}\n
\n ) : (\n /* Read-only title for mutate operations */\n
\n {title}\n
\n )}\n
\n
\n {!isCreate && currentParagraphs.length > 0 && (\n {currentParagraphs.length} current\n )}\n {isCreate ? (\n {newParagraphs.length} paragraphs\n ) : isAppend ? (\n +{newParagraphs.length} new\n ) : (\n {afterParagraphs.length} after\n )}\n
\n
\n\n {/* Content - single panel for create, side by side for diff */}\n
\n {!isCreate && renderPanel(currentParagraphs, 'left', 'Empty document')}\n {renderPanel(isCreate ? newParagraphs : afterParagraphs, 'right', 'No content')}\n
\n\n {/* Footer */}\n \n
\n );\n}\n" }, { "path": "src/components/Approval/GoogleSheetsApproval.css", "content": "/**\n * Google Sheets Approval View Styles\n *\n * Row-based diff layout for spreadsheet approval.\n * Shows data in table format with cell columns.\n */\n\n.sheets-approval-view {\n display: flex;\n flex-direction: column;\n height: 100%;\n min-height: 500px;\n}\n\n/* Header */\n.sheets-approval-header {\n display: flex;\n align-items: flex-start;\n justify-content: space-between;\n gap: var(--space-4);\n padding: var(--space-3) var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n background: var(--color-bg-secondary);\n}\n\n.sheets-approval-title {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.sheets-approval-title-row {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.sheets-approval-title h3 {\n margin: 0;\n font-size: 15px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n.sheets-approval-doc-info {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n font-size: 13px;\n}\n\n.sheets-approval-doc-name {\n color: var(--color-text-secondary);\n font-weight: 500;\n}\n\n.sheets-approval-sheet-name {\n color: var(--color-text-muted);\n}\n\n/* Editable title (for create spreadsheet) */\n.sheets-approval-editable-title {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n width: 450px;\n}\n\n.sheets-approval-title-label {\n font-size: 12px;\n color: var(--color-text-muted);\n font-weight: 500;\n}\n\n.sheets-approval-title-input-row {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.sheets-approval-title-input {\n flex: 1;\n padding: var(--space-2) var(--space-3);\n font-size: 14px;\n font-weight: 500;\n color: var(--color-text-primary);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n width: 100%;\n}\n\n.sheets-approval-title-input:focus {\n outline: none;\n border-color: var(--color-accent-primary);\n box-shadow: 0 0 0 2px rgba(59, 130, 246, 0.15);\n}\n\n.sheets-approval-title-input:disabled {\n opacity: 0.6;\n cursor: not-allowed;\n}\n\n.sheets-approval-add-comment {\n padding: 4px 8px;\n font-size: 11px;\n color: var(--color-text-muted);\n background: transparent;\n border: none;\n cursor: pointer;\n opacity: 0;\n transition: opacity 0.15s;\n}\n\n.sheets-approval-title-input-row:hover .sheets-approval-add-comment {\n opacity: 1;\n}\n\n.sheets-approval-add-comment:hover {\n color: var(--color-accent-primary);\n}\n\n/* Title comment input */\n.sheets-approval-title-comment-input {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-accent-primary);\n border-left: 3px solid var(--color-accent-primary);\n border-radius: var(--radius-sm);\n}\n\n.sheets-approval-title-comment-input input {\n width: 100%;\n padding: var(--space-2);\n font-size: 13px;\n border: none;\n background: transparent;\n color: var(--color-text-primary);\n}\n\n.sheets-approval-title-comment-input input:focus {\n outline: none;\n}\n\n.sheets-approval-title-comment-input input::placeholder {\n color: var(--color-text-muted);\n}\n\n.sheets-approval-title-comment-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n}\n\n.sheets-approval-title-comment-actions button {\n padding: 4px 10px;\n font-size: 12px;\n border-radius: var(--radius-sm);\n cursor: pointer;\n transition: all 0.15s ease;\n border: none;\n}\n\n.sheets-approval-title-comment-actions button:first-child {\n background: transparent;\n color: var(--color-text-muted);\n}\n\n.sheets-approval-title-comment-actions button:first-child:hover {\n color: var(--color-text-primary);\n}\n\n.sheets-approval-title-comment-actions button.primary {\n background: var(--color-accent-primary);\n color: white;\n font-weight: 500;\n}\n\n.sheets-approval-title-comment-actions button.primary:hover:not(:disabled) {\n opacity: 0.9;\n}\n\n.sheets-approval-title-comment-actions button.primary:disabled {\n opacity: 0.4;\n cursor: default;\n}\n\n/* Existing title comment */\n.sheets-approval-title-comment {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-left: 3px solid #3b82f6;\n border-radius: var(--radius-sm);\n font-size: 13px;\n}\n\n.sheets-approval-title-comment-content {\n flex: 1;\n color: var(--color-text-primary);\n}\n\n.sheets-approval-title-comment-edit,\n.sheets-approval-title-comment-remove {\n padding: 2px 6px;\n font-size: 11px;\n background: transparent;\n border: none;\n color: var(--color-text-muted);\n cursor: pointer;\n opacity: 0;\n transition: opacity 0.15s;\n}\n\n.sheets-approval-title-comment:hover .sheets-approval-title-comment-edit,\n.sheets-approval-title-comment:hover .sheets-approval-title-comment-remove {\n opacity: 1;\n}\n\n.sheets-approval-title-comment-edit:hover {\n color: var(--color-accent-primary);\n}\n\n.sheets-approval-title-comment-remove:hover {\n color: #ef4444;\n}\n\n.sheets-approval-stats {\n display: flex;\n gap: var(--space-3);\n font-size: 12px;\n}\n\n.sheets-approval-stats .stat-current {\n color: var(--color-text-muted);\n}\n\n.sheets-approval-stats .stat-additions {\n color: #22c55e;\n}\n\n.sheets-approval-stats .stat-deletions {\n color: #ef4444;\n}\n\n/* Content - side by side */\n.sheets-approval-content {\n flex: 1;\n display: grid;\n grid-template-columns: 1fr 1fr;\n overflow: hidden;\n min-height: 0;\n}\n\n.sheets-approval-content.single-panel {\n grid-template-columns: 1fr;\n}\n\n/* Panels */\n.sheets-approval-panel {\n display: flex;\n flex-direction: column;\n overflow: hidden;\n border-right: 1px solid var(--color-border-default);\n}\n\n.sheets-approval-panel:last-child {\n border-right: none;\n}\n\n.sheets-approval-panel-header {\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-tertiary);\n border-bottom: 1px solid var(--color-border-default);\n flex-shrink: 0;\n}\n\n.sheets-approval-panel-label {\n font-size: 11px;\n font-weight: 600;\n color: var(--color-text-muted);\n text-transform: uppercase;\n letter-spacing: 0.5px;\n}\n\n.sheets-approval-panel-current .sheets-approval-panel-header {\n background: rgba(239, 68, 68, 0.05);\n}\n\n.sheets-approval-panel-after .sheets-approval-panel-header {\n background: rgba(34, 197, 94, 0.05);\n}\n\n.sheets-approval-panel-after .sheets-approval-panel-label {\n color: #22c55e;\n}\n\n.sheets-approval-panel-body {\n flex: 1;\n overflow: auto;\n background: var(--color-bg-primary);\n}\n\n.sheets-approval-empty-panel {\n color: var(--color-text-muted);\n font-style: italic;\n font-size: 13px;\n padding: var(--space-4);\n text-align: center;\n}\n\n/* Table */\n.sheets-table {\n display: flex;\n flex-direction: column;\n}\n\n/* Rows */\n.sheets-row-wrapper {\n display: flex;\n flex-direction: column;\n}\n\n.sheets-row {\n display: flex;\n align-items: stretch;\n min-height: 32px;\n border-bottom: 1px solid var(--color-border-default);\n user-select: none;\n cursor: pointer;\n}\n\n.sheets-row:hover {\n background: rgba(59, 130, 246, 0.06);\n}\n\n.sheets-row:hover .sheets-comment-indicator.can-comment {\n opacity: 1;\n}\n\n.sheets-row.selected {\n background: rgba(59, 130, 246, 0.12);\n}\n\n/* Row number */\n.sheets-row-number {\n width: 40px;\n flex-shrink: 0;\n display: flex;\n align-items: center;\n justify-content: center;\n font-size: 11px;\n color: var(--color-text-muted);\n background: var(--color-bg-tertiary);\n border-right: 1px solid var(--color-border-default);\n}\n\n/* Cells container */\n.sheets-row-cells {\n flex: 1;\n display: flex;\n min-width: 0;\n}\n\n/* Individual cell */\n.sheets-cell {\n flex: 1;\n min-width: 80px;\n max-width: 200px;\n padding: var(--space-2) var(--space-2);\n font-family: var(--font-mono);\n font-size: 12px;\n color: var(--color-text-primary);\n border-right: 1px solid var(--color-border-default);\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.sheets-cell:last-child {\n border-right: none;\n}\n\n/* Comment indicator */\n.sheets-comment-indicator {\n width: 28px;\n flex-shrink: 0;\n display: flex;\n align-items: center;\n justify-content: center;\n font-size: 14px;\n font-weight: 600;\n color: var(--color-text-muted);\n opacity: 0;\n transition: opacity 0.15s;\n}\n\n.sheets-comment-indicator.has-comment {\n opacity: 1;\n color: var(--color-accent-primary);\n}\n\n/* Placeholder rows for padding (to align both sides) */\n.sheets-row-placeholder {\n background: var(--color-bg-secondary);\n opacity: 0.5;\n cursor: default;\n}\n\n.sheets-row-placeholder:hover {\n background: var(--color-bg-secondary);\n}\n\n.sheets-row-placeholder .sheets-row-number {\n color: var(--color-text-muted);\n opacity: 0.5;\n}\n\n.sheets-row-placeholder .sheets-cell {\n color: transparent;\n}\n\n/* Diff status styling */\n.sheets-row-added {\n background: rgba(34, 197, 94, 0.08);\n}\n\n.sheets-row-added:hover {\n background: rgba(34, 197, 94, 0.14);\n}\n\n.sheets-row-added .sheets-comment-indicator {\n color: #22c55e;\n}\n\n.sheets-row-added .sheets-row-number {\n background: rgba(34, 197, 94, 0.12);\n color: #22c55e;\n}\n\n.sheets-row-removed {\n background: rgba(239, 68, 68, 0.08);\n}\n\n.sheets-row-removed:hover {\n background: rgba(239, 68, 68, 0.12);\n}\n\n.sheets-row-removed .sheets-cell {\n text-decoration: line-through;\n color: var(--color-text-muted);\n}\n\n.sheets-row-removed .sheets-row-number {\n background: rgba(239, 68, 68, 0.12);\n color: #ef4444;\n}\n\n/* Diff marker for removed rows */\n.sheets-diff-marker {\n width: 28px;\n flex-shrink: 0;\n display: flex;\n align-items: center;\n justify-content: center;\n font-size: 14px;\n font-weight: 600;\n color: #ef4444;\n}\n\n/* Comment input */\n.sheets-comment-input {\n margin: var(--space-2) var(--space-3);\n padding: var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-accent-primary);\n border-left: 3px solid var(--color-accent-primary);\n border-radius: var(--radius-sm);\n box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);\n}\n\n.sheets-comment-input textarea {\n width: 100%;\n padding: var(--space-2);\n font-family: var(--font-sans);\n font-size: 13px;\n line-height: 1.4;\n border: none;\n background: transparent;\n color: var(--color-text-primary);\n resize: none;\n min-height: 48px;\n}\n\n.sheets-comment-input textarea::placeholder {\n color: var(--color-text-muted);\n}\n\n.sheets-comment-input textarea:focus {\n outline: none;\n}\n\n.sheets-comment-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-2);\n border-top: 1px solid var(--color-border-default);\n}\n\n.sheets-comment-actions button {\n padding: 4px 10px;\n font-size: 12px;\n border-radius: var(--radius-sm);\n cursor: pointer;\n transition: all 0.15s ease;\n border: none;\n}\n\n.sheets-comment-actions button:first-child {\n background: transparent;\n color: var(--color-text-muted);\n}\n\n.sheets-comment-actions button:first-child:hover {\n color: var(--color-text-primary);\n}\n\n.sheets-comment-actions button.primary {\n background: var(--color-accent-primary);\n color: white;\n font-weight: 500;\n}\n\n.sheets-comment-actions button.primary:hover:not(:disabled) {\n opacity: 0.9;\n}\n\n.sheets-comment-actions button.primary:disabled {\n opacity: 0.4;\n cursor: default;\n}\n\n/* Existing comment display */\n.sheets-comment {\n position: relative;\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n margin: var(--space-2) var(--space-3);\n padding: var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-left: 3px solid #3b82f6;\n border-radius: var(--radius-sm);\n box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05);\n}\n\n.sheets-comment-rows {\n flex-shrink: 0;\n font-size: 10px;\n color: var(--color-text-muted);\n padding: 2px 8px;\n background: rgba(59, 130, 246, 0.1);\n border-radius: 10px;\n align-self: flex-start;\n}\n\n.sheets-comment-content {\n flex: 1;\n font-size: 13px;\n color: var(--color-text-primary);\n line-height: 1.5;\n white-space: pre-wrap;\n word-break: break-word;\n}\n\n.sheets-comment-remove {\n position: absolute;\n top: var(--space-2);\n right: var(--space-2);\n flex-shrink: 0;\n width: 20px;\n height: 20px;\n padding: 0;\n display: flex;\n align-items: center;\n justify-content: center;\n background: transparent;\n border: none;\n color: var(--color-text-muted);\n cursor: pointer;\n font-size: 14px;\n border-radius: var(--radius-sm);\n opacity: 0;\n transition: all 0.15s ease;\n}\n\n.sheets-comment:hover .sheets-comment-remove {\n opacity: 1;\n}\n\n.sheets-comment-remove:hover {\n background: rgba(239, 68, 68, 0.15);\n color: #ef4444;\n}\n\n/* Footer override */\n.sheets-approval-view .approval-footer {\n padding: var(--space-3) var(--space-4);\n}\n" }, { "path": "src/components/Approval/GoogleSheetsApproval.tsx", "content": "/**\n * Google Sheets Approval View\n *\n * Row-based diff for approving Google Sheets changes.\n * Shows current rows vs new rows with diff highlighting.\n *\n * Used for: appendRows, updateCells, replaceSheetContent\n * Note: createSpreadsheet shows new content only (no diff)\n */\n\nimport { useState, useCallback, useRef, useEffect } from 'react';\nimport { McpIcon } from '../common';\nimport { ApprovalFooter } from './ApprovalFooter';\nimport { useTitleEdit } from '../../hooks';\nimport type { ApprovalViewProps } from './ApprovalViewRegistry';\nimport './GoogleSheetsApproval.css';\n\ninterface GoogleSheetsApprovalData {\n spreadsheetId?: string;\n title?: string;\n sheetName?: string;\n currentData?: string[][];\n currentRows?: string[][]; // Alternative name for currentData\n newData?: string[][];\n newRows?: string[][]; // Alternative name for newData\n data?: string[][];\n rows?: string[][];\n range?: string;\n action?: 'create' | 'append' | 'update' | 'replace';\n url?: string;\n}\n\ninterface RowComment {\n id: string;\n rowStart: number;\n rowEnd: number;\n side: 'left' | 'right';\n content: string;\n}\n\ninterface RowSelection {\n startIndex: number;\n endIndex: number;\n side: 'left' | 'right';\n}\n\nexport function GoogleSheetsApproval({\n tool,\n action,\n data,\n onApprove,\n onRequestChanges,\n onCancel,\n isLoading,\n}: ApprovalViewProps) {\n const [comments, setComments] = useState([]);\n const [selection, setSelection] = useState(null);\n const [isDragging, setIsDragging] = useState(false);\n const [showCommentInput, setShowCommentInput] = useState(false);\n const [commentText, setCommentText] = useState('');\n const dragStartRef = useRef<{ index: number; side: 'left' | 'right' } | null>(null);\n\n // Editable title (for create spreadsheet) - using shared hook\n const {\n editedTitle,\n setEditedTitle,\n titleComment,\n showTitleCommentInput,\n titleCommentText,\n handleStartTitleComment,\n handleEditTitleComment,\n handleAddTitleComment,\n handleCancelTitleComment,\n handleRemoveTitleComment,\n setTitleCommentText,\n } = useTitleEdit();\n\n // Refs for synchronized scrolling\n const leftPanelRef = useRef(null);\n const rightPanelRef = useRef(null);\n const isScrollingRef = useRef(false);\n\n // Synchronized scroll handler\n const handleScroll = useCallback((source: 'left' | 'right') => {\n if (isScrollingRef.current) return;\n\n const sourcePanel = source === 'left' ? leftPanelRef.current : rightPanelRef.current;\n const targetPanel = source === 'left' ? rightPanelRef.current : leftPanelRef.current;\n\n if (!sourcePanel || !targetPanel) return;\n\n isScrollingRef.current = true;\n targetPanel.scrollTop = sourcePanel.scrollTop;\n\n // Reset flag after scroll completes\n requestAnimationFrame(() => {\n isScrollingRef.current = false;\n });\n }, []);\n\n // Attach scroll listeners\n useEffect(() => {\n const leftPanel = leftPanelRef.current;\n const rightPanel = rightPanelRef.current;\n\n const onLeftScroll = () => handleScroll('left');\n const onRightScroll = () => handleScroll('right');\n\n leftPanel?.addEventListener('scroll', onLeftScroll);\n rightPanel?.addEventListener('scroll', onRightScroll);\n\n return () => {\n leftPanel?.removeEventListener('scroll', onLeftScroll);\n rightPanel?.removeEventListener('scroll', onRightScroll);\n };\n }, [handleScroll]);\n\n // Parse data\n let sheetData: GoogleSheetsApprovalData = {};\n if (typeof data === 'string') {\n try {\n sheetData = JSON.parse(data);\n } catch {\n sheetData = {};\n }\n } else {\n sheetData = data as GoogleSheetsApprovalData;\n }\n\n const {\n title = 'Untitled Spreadsheet',\n sheetName = 'Sheet1',\n action: sheetAction,\n } = sheetData;\n\n // Accept multiple field names for current/new data\n const currentData = sheetData.currentData || sheetData.currentRows || [];\n const newData = sheetData.newData || sheetData.newRows || sheetData.data || sheetData.rows || [];\n\n // Infer action from tool name if not explicitly provided\n const inferredAction = sheetAction || (\n tool.includes('createSpreadsheet') ? 'create' :\n tool.includes('appendRows') ? 'append' :\n tool.includes('updateCells') ? 'update' :\n 'replace'\n );\n\n const isCreate = inferredAction === 'create';\n const isAppend = inferredAction === 'append';\n const isUpdate = inferredAction === 'update';\n const showSinglePanel = isCreate || (isAppend && currentData.length === 0);\n\n const actionLabel = isCreate\n ? 'Create Spreadsheet'\n : isAppend\n ? 'Append Rows'\n : isUpdate\n ? 'Update Cells'\n : 'Replace Sheet Content';\n\n // For append, combine current + new rows\n const afterRows = isAppend ? [...currentData, ...newData] : newData;\n\n // Get max columns for consistent table width\n const maxCols = Math.max(\n ...currentData.map(r => r.length),\n ...afterRows.map(r => r.length),\n 1\n );\n\n // Normalize row to have consistent column count\n const normalizeRow = (row: string[]): string[] => {\n const normalized = [...row];\n while (normalized.length < maxCols) {\n normalized.push('');\n }\n return normalized;\n };\n\n // Compare two rows for equality\n const rowsEqual = (a: string[], b: string[]): boolean => {\n const normA = normalizeRow(a);\n const normB = normalizeRow(b);\n return normA.every((cell, i) => cell === normB[i]);\n };\n\n // Get diff status for a row\n const getDiffStatus = (row: string[], rowIndex: number, side: 'left' | 'right'): 'added' | 'removed' | 'unchanged' => {\n if (side === 'left') {\n if (isAppend || isCreate) return 'unchanged';\n // Check if this row exists in new data\n const existsInNew = newData.some(newRow => rowsEqual(row, newRow));\n return existsInNew ? 'unchanged' : 'removed';\n } else {\n if (isAppend) {\n // In append mode, rows from current are unchanged, new rows are added\n if (rowIndex < currentData.length) return 'unchanged';\n return 'added';\n }\n if (isCreate) {\n return 'added';\n }\n // For replace/update, check if row exists in current\n const existsInCurrent = currentData.some(currRow => rowsEqual(row, currRow));\n return existsInCurrent ? 'unchanged' : 'added';\n }\n };\n\n // Selection handlers - only for right side\n const handleRowMouseDown = useCallback((index: number, side: 'left' | 'right', e: React.MouseEvent) => {\n if (isLoading || side === 'left') return;\n e.preventDefault();\n\n dragStartRef.current = { index, side };\n setIsDragging(true);\n setSelection({ startIndex: index, endIndex: index, side });\n setShowCommentInput(false);\n }, [isLoading]);\n\n const handleRowMouseEnter = useCallback((index: number, side: 'left' | 'right') => {\n if (!isDragging || !dragStartRef.current || dragStartRef.current.side !== side) return;\n\n const start = dragStartRef.current.index;\n setSelection({\n startIndex: Math.min(start, index),\n endIndex: Math.max(start, index),\n side,\n });\n }, [isDragging]);\n\n const handleMouseUp = useCallback(() => {\n if (isDragging && selection) {\n setShowCommentInput(true);\n }\n setIsDragging(false);\n dragStartRef.current = null;\n }, [isDragging, selection]);\n\n const handleAddComment = () => {\n if (!selection || !commentText.trim()) return;\n\n const newComment: RowComment = {\n id: `comment-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n rowStart: selection.startIndex,\n rowEnd: selection.endIndex,\n side: selection.side,\n content: commentText.trim(),\n };\n setComments(prev => [...prev, newComment]);\n setSelection(null);\n setShowCommentInput(false);\n setCommentText('');\n };\n\n const handleRemoveComment = (id: string) => {\n setComments(prev => prev.filter(c => c.id !== id));\n };\n\n const handleCancelComment = () => {\n setSelection(null);\n setShowCommentInput(false);\n setCommentText('');\n };\n\n const isRowSelected = (index: number, side: 'left' | 'right') => {\n if (!selection || selection.side !== side) return false;\n return index >= selection.startIndex && index <= selection.endIndex;\n };\n\n const hasComment = useCallback((index: number, side: 'left' | 'right') => {\n return comments.some(c =>\n c.side === side && index >= c.rowStart && index <= c.rowEnd\n );\n }, [comments]);\n\n const getCommentsEndingAt = (index: number, side: 'left' | 'right') => {\n return comments.filter(c => c.rowEnd === index && c.side === side);\n };\n\n const formatCommentsFeedback = (): string => {\n const hasTitleComment = titleComment !== null;\n const hasRowComments = comments.length > 0;\n\n if (!hasTitleComment && !hasRowComments) return '';\n\n const lines: string[] = ['SPREADSHEET COMMENTS:'];\n\n // Title comment\n if (hasTitleComment) {\n lines.push(`\\n[Spreadsheet Name]: \"${titleComment}\"`);\n }\n\n // Row comments\n for (const c of comments) {\n const sideLabel = c.side === 'left' ? 'Current' : 'New';\n const rowRef = c.rowEnd !== c.rowStart\n ? `Rows ${c.rowStart + 1}-${c.rowEnd + 1}`\n : `Row ${c.rowStart + 1}`;\n lines.push(`\\n[${sideLabel} - ${rowRef}]: \"${c.content}\"`);\n }\n return lines.join('\\n');\n };\n\n const handleApprove = () => {\n // Pass back edited title if changed (for create spreadsheet)\n if (isCreate && editedTitle !== null && editedTitle !== title) {\n onApprove({ title: editedTitle });\n } else {\n onApprove();\n }\n };\n\n const handleRequestChanges = () => {\n const feedback = formatCommentsFeedback();\n onRequestChanges(feedback);\n };\n\n // Render a single row\n const renderRow = (row: string[], rowIndex: number, side: 'left' | 'right') => {\n const status = getDiffStatus(row, rowIndex, side);\n const isSelected = isRowSelected(rowIndex, side);\n const rowHasComment = hasComment(rowIndex, side);\n const rowComments = getCommentsEndingAt(rowIndex, side);\n const showInputAfterRow = showCommentInput && selection?.endIndex === rowIndex && selection?.side === side;\n const normalizedRow = normalizeRow(row);\n\n return (\n
\n handleRowMouseDown(rowIndex, side, e)}\n onMouseEnter={() => handleRowMouseEnter(rowIndex, side)}\n >\n {rowIndex + 1}\n
\n {normalizedRow.map((cell, cellIndex) => (\n \n {cell || '\\u00A0'}\n \n ))}\n
\n {side === 'right' && (\n \n +\n \n )}\n {side === 'left' && status === 'removed' && (\n −\n )}\n
\n\n {/* Comment input */}\n {showInputAfterRow && (\n
\n setCommentText(e.target.value)}\n placeholder={selection && selection.startIndex !== selection.endIndex\n ? `Add feedback on rows ${selection.startIndex + 1}-${selection.endIndex + 1}...`\n : 'Add your feedback on this row...'\n }\n autoFocus\n onMouseDown={(e) => e.stopPropagation()}\n onKeyDown={(e) => {\n if (e.key === 'Enter' && e.metaKey) handleAddComment();\n if (e.key === 'Escape') handleCancelComment();\n }}\n />\n
\n \n \n Add Comment\n \n
\n
\n )}\n\n {/* Existing comments */}\n {rowComments.map(comment => (\n
\n {comment.rowEnd !== comment.rowStart && (\n \n Rows {comment.rowStart + 1}-{comment.rowEnd + 1}\n \n )}\n {comment.content}\n { e.stopPropagation(); handleRemoveComment(comment.id); }}\n title=\"Remove comment\"\n >\n ×\n \n
\n ))}\n \n );\n };\n\n // Calculate max rows for padding (so both sides have same height in diff view)\n const maxRows = Math.max(currentData.length, afterRows.length);\n\n // Render placeholder row for padding\n const renderPlaceholderRow = (rowIndex: number) => (\n
\n
\n {rowIndex + 1}\n
\n {Array.from({ length: maxCols }, (_, i) => (\n {'\\u00A0'}\n ))}\n
\n
\n
\n );\n\n // Render a panel\n const renderPanel = (\n rows: string[][],\n side: 'left' | 'right',\n emptyMessage: string,\n panelRef?: React.RefObject\n ) => {\n // Calculate how many placeholder rows to add\n const placeholderCount = !showSinglePanel ? maxRows - rows.length : 0;\n\n return (\n \n
\n \n {side === 'left' ? 'Current' : showSinglePanel ? 'New Content' : 'After Changes'}\n \n
\n
\n {rows.length === 0 && placeholderCount === 0 ? (\n
{emptyMessage}
\n ) : (\n
\n {rows.map((row, idx) => renderRow(row, idx, side))}\n {/* Add placeholder rows to match the other side's height */}\n {placeholderCount > 0 && Array.from({ length: placeholderCount }, (_, i) =>\n renderPlaceholderRow(rows.length + i)\n )}\n
\n )}\n
\n \n );\n };\n\n // Count stats\n const addedRows = afterRows.filter((row, idx) => getDiffStatus(row, idx, 'right') === 'added').length;\n const removedRows = currentData.filter((row, idx) => getDiffStatus(row, idx, 'left') === 'removed').length;\n\n return (\n
\n {/* Header */}\n
\n
\n
\n \n

{action || actionLabel}

\n
\n {isCreate ? (\n /* Editable title for create spreadsheet */\n
\n \n
\n setEditedTitle(e.target.value)}\n disabled={isLoading}\n placeholder=\"Enter spreadsheet name...\"\n />\n {!showTitleCommentInput && !titleComment && !isLoading && (\n \n + comment\n \n )}\n
\n\n {/* Title comment input */}\n {showTitleCommentInput && (\n
\n setTitleCommentText(e.target.value)}\n placeholder=\"Add feedback on the spreadsheet name...\"\n autoFocus\n onKeyDown={(e) => {\n if (e.key === 'Enter' && titleCommentText.trim()) handleAddTitleComment();\n if (e.key === 'Escape') handleCancelTitleComment();\n }}\n />\n
\n \n \n Add\n \n
\n
\n )}\n\n {/* Existing title comment */}\n {titleComment && !showTitleCommentInput && (\n
\n {titleComment}\n \n Edit\n \n \n ×\n \n
\n )}\n
\n ) : (\n /* Read-only title for mutate operations */\n
\n {title}\n {sheetName && sheetName !== 'Sheet1' && (\n / {sheetName}\n )}\n
\n )}\n
\n
\n {!showSinglePanel && currentData.length > 0 && (\n {currentData.length} rows\n )}\n {addedRows > 0 && (\n +{addedRows} rows\n )}\n {removedRows > 0 && (\n -{removedRows} rows\n )}\n
\n
\n\n {/* Content */}\n
\n {!showSinglePanel && renderPanel(currentData, 'left', 'Empty sheet', leftPanelRef)}\n {renderPanel(afterRows, 'right', 'No data', rightPanelRef)}\n
\n\n {/* Footer */}\n \n
\n );\n}\n" }, { "path": "src/components/Approval/index.ts", "content": "/**\n * Approval Views Module\n *\n * Composable approval views for different MCP tools.\n */\n\nexport { getApprovalView } from './ApprovalViewRegistry';\nexport type { ApprovalViewProps } from './ApprovalViewRegistry';\nexport { DefaultApproval } from './DefaultApproval';\nexport { GitHubPRApproval } from './GitHubPRApproval';\nexport { GitHubPRReviewApproval } from './GitHubPRReviewApproval';\n" }, { "path": "src/components/Board/Board.css", "content": ".board {\n flex: 1;\n display: flex;\n overflow-x: auto;\n padding: var(--space-4);\n background: var(--color-bg-secondary);\n}\n\n.board-columns {\n display: flex;\n gap: var(--column-gap);\n align-items: flex-start;\n}\n\n.column-wrapper {\n display: flex;\n}\n\n/* Add Column Button */\n.add-column-btn {\n display: flex;\n align-items: flex-start;\n justify-content: center;\n width: 28px;\n min-width: 28px;\n padding-top: 14px;\n align-self: stretch;\n min-height: 80px;\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n font-family: var(--font-mono);\n color: var(--color-text-muted);\n cursor: pointer;\n transition: all var(--transition-fast);\n opacity: 0.3;\n}\n\n.add-column-btn:hover {\n opacity: 1;\n color: var(--color-accent-primary);\n background: var(--color-accent-muted);\n}\n\n.add-column-icon {\n font-size: 16px;\n line-height: 1;\n}\n\n/* Loading State */\n.board-loading {\n flex: 1;\n display: flex;\n align-items: center;\n justify-content: center;\n background: var(--color-bg-secondary);\n}\n\n.loading-text {\n font-size: 14px;\n color: var(--color-text-muted);\n}\n\n.loading-text::after {\n content: '';\n animation: dots 1.5s infinite;\n}\n\n@keyframes dots {\n 0%, 20% { content: ''; }\n 40% { content: '.'; }\n 60% { content: '..'; }\n 80%, 100% { content: '...'; }\n}\n\n/* Empty State */\n.board-empty {\n flex: 1;\n display: flex;\n align-items: center;\n justify-content: center;\n background: var(--color-bg-secondary);\n}\n\n.empty-content {\n text-align: center;\n max-width: 320px;\n}\n\n.empty-icon {\n display: block;\n font-size: 32px;\n color: var(--color-text-muted);\n margin-bottom: var(--space-4);\n}\n\n.empty-title {\n font-size: 16px;\n font-weight: 600;\n color: var(--color-text-primary);\n margin-bottom: var(--space-2);\n}\n\n.empty-text {\n font-size: 14px;\n color: var(--color-text-muted);\n line-height: 1.5;\n}\n\n/* ============================================\n Mobile Styles - Horizontal Snap Scrolling\n ============================================ */\n@media (max-width: 767px) {\n .board {\n padding: var(--space-2) 0;\n overflow-x: auto;\n overflow-y: hidden;\n scroll-snap-type: x mandatory;\n scroll-behavior: smooth;\n -webkit-overflow-scrolling: touch;\n /* Hide scrollbar but keep functionality */\n scrollbar-width: none;\n -ms-overflow-style: none;\n }\n\n .board::-webkit-scrollbar {\n display: none;\n }\n\n .board-columns {\n gap: 0;\n padding: 0 var(--space-mobile-gutter);\n }\n\n .column-wrapper {\n flex: 0 0 auto;\n width: var(--mobile-column-width);\n scroll-snap-align: center;\n scroll-snap-stop: always;\n padding: 0 var(--space-1);\n }\n\n /* Add column button - full card style */\n .add-column-btn {\n flex: 0 0 auto;\n width: var(--mobile-column-width);\n min-width: var(--mobile-column-width);\n min-height: 120px;\n margin-right: var(--space-mobile-gutter);\n scroll-snap-align: center;\n opacity: 0.6;\n border: 2px dashed var(--color-border-default);\n background: var(--color-bg-tertiary);\n padding-top: var(--space-6);\n align-items: flex-start;\n }\n\n .add-column-btn:active {\n opacity: 1;\n background: var(--color-accent-muted);\n border-color: var(--color-accent-primary);\n }\n\n .add-column-icon {\n font-size: 24px;\n }\n\n /* Empty/loading states */\n .board-empty,\n .board-loading {\n padding: var(--space-4);\n }\n\n .empty-content {\n max-width: 100%;\n padding: 0 var(--space-4);\n }\n}\n" }, { "path": "src/components/Board/Board.tsx", "content": "import { useEffect, useState, useCallback, type DragEvent } from 'react';\nimport { useParams } from 'react-router-dom';\nimport { useBoard } from '../../context/BoardContext';\nimport { Column } from '../Column/Column';\nimport './Board.css';\n\nexport function Board() {\n const { boardId } = useParams<{ boardId: string }>();\n const { activeBoard, loading, loadBoard, createColumn, columnDragState, setColumnDragState, moveColumn } = useBoard();\n const [newColumnId, setNewColumnId] = useState(null);\n const [dropTargetIndex, setDropTargetIndex] = useState(null);\n\n // Load board from URL param on mount or when boardId changes\n useEffect(() => {\n if (boardId && boardId !== activeBoard?.id) {\n loadBoard(boardId);\n }\n }, [boardId, activeBoard?.id, loadBoard]);\n\n // Clear newColumnId after it's been used to trigger edit mode\n useEffect(() => {\n if (newColumnId) {\n const timer = setTimeout(() => setNewColumnId(null), 100);\n return () => clearTimeout(timer);\n }\n }, [newColumnId]);\n\n const handleAddColumn = useCallback(async () => {\n const column = await createColumn('New Column');\n if (column) {\n setNewColumnId(column.id);\n }\n }, [createColumn]);\n\n if (loading) {\n return (\n
\n Loading...\n
\n );\n }\n\n if (!activeBoard) {\n return (\n
\n
\n >_\n

No Board Selected

\n

\n Create a new board or select an existing one to get started.\n

\n
\n
\n );\n }\n\n const sortedColumns = [...activeBoard.columns].sort(\n (a, b) => a.position - b.position\n );\n\n const handleColumnDragStart = (columnId: string) => {\n setColumnDragState({ isDragging: true, columnId });\n };\n\n const handleColumnDragEnd = () => {\n setColumnDragState({ isDragging: false, columnId: null });\n setDropTargetIndex(null);\n };\n\n const handleColumnDragOver = (e: DragEvent, targetIndex: number) => {\n e.preventDefault();\n if (!columnDragState.isDragging || !columnDragState.columnId) return;\n\n const draggedColumnIndex = sortedColumns.findIndex(c => c.id === columnDragState.columnId);\n if (draggedColumnIndex === targetIndex) return;\n\n setDropTargetIndex(targetIndex);\n };\n\n const handleColumnDrop = async (e: DragEvent, targetIndex: number) => {\n e.preventDefault();\n const columnId = e.dataTransfer.getData('application/column');\n if (!columnId) return;\n\n const sourceIndex = sortedColumns.findIndex(c => c.id === columnId);\n if (sourceIndex === -1 || sourceIndex === targetIndex) return;\n\n await moveColumn(columnId, targetIndex);\n setDropTargetIndex(null);\n setColumnDragState({ isDragging: false, columnId: null });\n };\n\n return (\n
\n
\n {sortedColumns.map((column, index) => (\n handleColumnDragOver(e, index)}\n onDrop={(e) => handleColumnDrop(e, index)}\n >\n {} : undefined}\n onColumnDragStart={() => handleColumnDragStart(column.id)}\n onColumnDragEnd={handleColumnDragEnd}\n isColumnDragTarget={dropTargetIndex === index && columnDragState.columnId !== column.id}\n />\n
\n ))}\n \n
\n \n );\n}\n" }, { "path": "src/components/Column/Column.css", "content": ".column {\n width: var(--column-width);\n min-width: var(--column-width);\n background: var(--color-bg-tertiary);\n border: 1px solid var(--color-border-subtle);\n border-radius: var(--border-radius);\n display: flex;\n flex-direction: column;\n max-height: calc(100vh - var(--header-height) - var(--space-8));\n transition: border-color var(--transition-fast), box-shadow var(--transition-fast);\n}\n\n.column-drag-over {\n border-color: var(--color-accent-primary);\n box-shadow: 0 0 0 1px var(--color-accent-muted);\n}\n\n.column-drop-target {\n border-color: var(--color-accent-primary);\n border-style: dashed;\n}\n\n.column[draggable=\"true\"] {\n cursor: grab;\n}\n\n.column[draggable=\"true\"]:active {\n cursor: grabbing;\n}\n\n/* Header */\n.column-header {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-3);\n border-bottom: 1px solid var(--color-border-subtle);\n}\n\n.column-prompt {\n color: var(--color-text-muted);\n font-weight: 500;\n}\n\n.column-name {\n font-size: 13px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n.column-name {\n cursor: pointer;\n padding: 2px 4px;\n margin: -2px -4px;\n border-radius: var(--border-radius);\n transition: background var(--transition-fast);\n}\n\n.column-name:hover {\n background: var(--color-bg-secondary);\n}\n\n.column-name-input {\n font-size: 13px;\n font-weight: 600;\n font-family: var(--font-mono);\n color: var(--color-text-primary);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-accent-primary);\n border-radius: var(--border-radius);\n padding: 2px 4px;\n margin: -3px -5px;\n outline: none;\n min-width: 80px;\n flex: 1;\n}\n\n.column-count {\n font-size: 12px;\n color: var(--color-text-muted);\n background: var(--color-bg-secondary);\n padding: 2px 6px;\n border-radius: var(--border-radius);\n}\n\n/* Column Menu */\n.column-menu-wrapper {\n position: relative;\n margin-left: auto;\n}\n\n.column-menu-btn {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 24px;\n height: 24px;\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n color: var(--color-text-muted);\n cursor: pointer;\n font-size: 14px;\n transition: all var(--transition-fast);\n opacity: 0;\n}\n\n.column-header:hover .column-menu-btn,\n.column-menu-btn:focus {\n opacity: 1;\n}\n\n.column-menu-btn:hover {\n background: var(--color-bg-secondary);\n color: var(--color-text-primary);\n}\n\n.column-menu {\n position: absolute;\n top: 100%;\n right: 0;\n margin-top: 4px;\n min-width: 120px;\n background: var(--color-bg-elevated);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n box-shadow: var(--shadow-md);\n z-index: 100;\n padding: var(--space-1);\n}\n\n.column-menu-item {\n display: block;\n width: 100%;\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-primary);\n text-align: left;\n cursor: pointer;\n transition: background var(--transition-fast);\n}\n\n.column-menu-item:hover {\n background: var(--color-bg-secondary);\n}\n\n.column-menu-item-danger {\n color: var(--color-danger);\n}\n\n.column-menu-item-danger:hover {\n background: rgba(239, 68, 68, 0.1);\n}\n\n.column-menu-confirm {\n padding: var(--space-2);\n}\n\n.column-menu-confirm-text {\n display: block;\n font-size: 12px;\n color: var(--color-text-secondary);\n margin-bottom: var(--space-2);\n}\n\n.column-menu-confirm-actions {\n display: flex;\n gap: var(--space-1);\n}\n\n/* Tasks List */\n.column-tasks {\n flex: 1;\n overflow-y: auto;\n padding: var(--space-2);\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n/* Add Button */\n.column-add-btn {\n display: flex;\n align-items: center;\n width: 100%;\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: 1px dashed var(--color-border-default);\n border-radius: var(--border-radius);\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-muted);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.column-add-btn:hover {\n border-color: var(--color-accent-primary);\n color: var(--color-accent-primary);\n background: var(--color-accent-muted);\n}\n\n/* Add Form */\n.column-add-form {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n padding: var(--space-2);\n background: var(--color-bg-elevated);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n}\n\n.column-add-actions {\n display: flex;\n gap: var(--space-2);\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .column {\n width: 100%;\n min-width: 100%;\n max-height: calc(100vh - var(--header-height) - var(--space-4));\n max-height: calc(100dvh - var(--header-height) - var(--space-4));\n }\n\n /* Disable drag cursor on mobile */\n .column[draggable=\"true\"] {\n cursor: default;\n }\n\n .column[draggable=\"true\"]:active {\n cursor: default;\n }\n\n /* Column header */\n .column-header {\n padding: var(--space-3);\n min-height: var(--touch-target-min);\n }\n\n .column-name {\n font-size: 14px;\n padding: var(--space-2);\n margin: calc(-1 * var(--space-2));\n }\n\n .column-name-input {\n font-size: 16px; /* Prevent iOS zoom */\n min-height: var(--touch-target-min);\n }\n\n /* Always show menu button on mobile */\n .column-menu-btn {\n opacity: 1;\n width: var(--touch-target-min);\n height: var(--touch-target-min);\n font-size: 18px;\n }\n\n .column-menu {\n min-width: 160px;\n }\n\n .column-menu-item {\n min-height: var(--touch-target-min);\n padding: var(--space-3);\n font-size: 14px;\n }\n\n .column-menu-confirm-actions {\n flex-direction: row;\n gap: var(--space-2);\n }\n\n .column-menu-confirm-actions .column-menu-item {\n flex: 1;\n text-align: center;\n }\n\n /* Tasks list */\n .column-tasks {\n padding: var(--space-2) var(--space-3);\n gap: var(--space-3);\n }\n\n /* Add task button */\n .column-add-btn {\n min-height: var(--touch-target-min);\n padding: var(--space-3);\n font-size: 14px;\n }\n\n /* Add form */\n .column-add-form {\n padding: var(--space-3);\n gap: var(--space-3);\n }\n\n .column-add-actions {\n gap: var(--space-3);\n }\n}\n" }, { "path": "src/components/Column/Column.tsx", "content": "import { useState, useEffect, useRef, type DragEvent } from 'react';\nimport type { Column as ColumnType } from '../../types';\nimport { useBoard } from '../../context/BoardContext';\nimport { useIsMobile } from '../../hooks';\nimport { TaskCard } from '../Task/TaskCard';\nimport { Button, Input } from '../common';\nimport './Column.css';\n\ninterface ColumnProps {\n column: ColumnType;\n onStartEdit?: () => void;\n onColumnDragStart?: (e: DragEvent) => void;\n onColumnDragEnd?: () => void;\n isColumnDragTarget?: boolean;\n}\n\nexport function Column({ column, onStartEdit, onColumnDragStart, onColumnDragEnd, isColumnDragTarget }: ColumnProps) {\n const { getTasksByColumn, createTask, moveTask, setDragState, dragState, addingToColumn, setAddingToColumn, updateColumn, deleteColumn } = useBoard();\n const isMobile = useIsMobile();\n const [newTaskTitle, setNewTaskTitle] = useState('');\n const [isDragOver, setIsDragOver] = useState(false);\n const [isEditingName, setIsEditingName] = useState(false);\n const [editedName, setEditedName] = useState(column.name);\n const [showMenu, setShowMenu] = useState(false);\n const [confirmingDelete, setConfirmingDelete] = useState(false);\n const inputRef = useRef(null);\n const nameInputRef = useRef(null);\n const menuRef = useRef(null);\n\n const isAdding = addingToColumn === column.id;\n const tasks = getTasksByColumn(column.id);\n\n // Focus input when triggered by keyboard shortcut\n useEffect(() => {\n if (isAdding && inputRef.current) {\n inputRef.current.focus();\n }\n }, [isAdding]);\n\n // Focus name input when editing\n useEffect(() => {\n if (isEditingName && nameInputRef.current) {\n nameInputRef.current.focus();\n nameInputRef.current.select();\n }\n }, [isEditingName]);\n\n // Trigger edit mode from parent (for new columns)\n useEffect(() => {\n if (onStartEdit) {\n setIsEditingName(true);\n setEditedName(column.name);\n }\n }, [onStartEdit, column.name]);\n\n // Close menu when clicking outside\n useEffect(() => {\n const handleClickOutside = (e: MouseEvent) => {\n if (menuRef.current && !menuRef.current.contains(e.target as Node)) {\n setShowMenu(false);\n setConfirmingDelete(false);\n }\n };\n\n if (showMenu) {\n document.addEventListener('mousedown', handleClickOutside);\n }\n return () => document.removeEventListener('mousedown', handleClickOutside);\n }, [showMenu]);\n\n const handleSaveName = async () => {\n const trimmed = editedName.trim();\n if (trimmed && trimmed !== column.name) {\n await updateColumn(column.id, { name: trimmed });\n }\n setIsEditingName(false);\n setEditedName(column.name);\n };\n\n const handleCancelEdit = () => {\n setIsEditingName(false);\n setEditedName(column.name);\n };\n\n const handleDeleteColumn = async () => {\n await deleteColumn(column.id);\n setShowMenu(false);\n setConfirmingDelete(false);\n };\n\n const setIsAdding = (value: boolean) => {\n setAddingToColumn(value ? column.id : null);\n };\n\n const handleAddTask = async () => {\n if (newTaskTitle.trim()) {\n await createTask(column.id, newTaskTitle.trim());\n setNewTaskTitle('');\n setIsAdding(false);\n }\n };\n\n const handleDragOver = (e: DragEvent) => {\n e.preventDefault();\n e.dataTransfer.dropEffect = 'move';\n if (!isDragOver) setIsDragOver(true);\n };\n\n const handleDragLeave = (e: DragEvent) => {\n // Only set to false if we're leaving the column entirely\n if (!e.currentTarget.contains(e.relatedTarget as Node)) {\n setIsDragOver(false);\n }\n };\n\n const handleDrop = async (e: DragEvent) => {\n e.preventDefault();\n setIsDragOver(false);\n\n const taskId = e.dataTransfer.getData('text/plain');\n if (taskId) {\n // Handle both cross-column moves and same-column drops to end\n // For same-column, calculate position accounting for the dragged item\n const isSameColumn = dragState.sourceColumnId === column.id;\n const draggedTask = tasks.find(t => t.id === taskId);\n const draggedIndex = draggedTask ? tasks.indexOf(draggedTask) : -1;\n\n // Target position is end of list, but if same column and item was before end,\n // the effective end position is one less (since the dragged item leaves a gap)\n let targetPosition = tasks.length;\n if (isSameColumn && draggedIndex >= 0) {\n targetPosition = tasks.length - 1;\n }\n\n // Only move if actually changing position\n if (!isSameColumn || draggedIndex !== targetPosition) {\n await moveTask(taskId, column.id, targetPosition);\n }\n }\n\n setDragState({ isDragging: false, taskId: null, sourceColumnId: null });\n };\n\n return (\n {\n // Prevent column drag if editing name\n if (isEditingName) {\n e.preventDefault();\n return;\n }\n e.dataTransfer.setData('application/column', column.id);\n e.dataTransfer.effectAllowed = 'move';\n onColumnDragStart?.(e);\n }}\n onDragEnd={onColumnDragEnd}\n onDragOver={handleDragOver}\n onDragLeave={handleDragLeave}\n onDrop={handleDrop}\n >\n
\n >\n {isEditingName ? (\n setEditedName(e.target.value)}\n onKeyDown={(e) => {\n if (e.key === 'Enter') handleSaveName();\n if (e.key === 'Escape') handleCancelEdit();\n }}\n onBlur={handleSaveName}\n />\n ) : (\n {\n setIsEditingName(true);\n setEditedName(column.name);\n }}\n title=\"Click to rename\"\n >\n {column.name}\n \n )}\n {tasks.length}\n\n
\n setShowMenu(!showMenu)}\n aria-label=\"Column options\"\n >\n ⋮\n \n {showMenu && (\n
\n {confirmingDelete ? (\n
\n \n {tasks.length > 0\n ? `Delete column and ${tasks.length} task${tasks.length === 1 ? '' : 's'}?`\n : 'Delete empty column?'}\n \n
\n \n Delete\n \n setConfirmingDelete(false)}\n >\n Cancel\n \n
\n
\n ) : (\n <>\n {\n setShowMenu(false);\n setIsEditingName(true);\n setEditedName(column.name);\n }}\n >\n Rename\n \n setConfirmingDelete(true)}\n >\n Delete\n \n \n )}\n
\n )}\n
\n
\n\n
\n {tasks.map((task, index) => (\n \n ))}\n\n {isAdding ? (\n
\n setNewTaskTitle(e.target.value)}\n onKeyDown={(e) => {\n if (e.key === 'Enter') handleAddTask();\n if (e.key === 'Escape') {\n setIsAdding(false);\n setNewTaskTitle('');\n }\n }}\n autoFocus\n />\n
\n \n {\n setIsAdding(false);\n setNewTaskTitle('');\n }}\n >\n Cancel\n \n
\n
\n ) : (\n \n )}\n
\n \n );\n}\n" }, { "path": "src/components/CommandPalette/CommandPalette.css", "content": ".palette-overlay {\n position: fixed;\n inset: 0;\n background: rgba(0, 0, 0, 0.4);\n display: flex;\n justify-content: center;\n align-items: flex-start;\n padding-top: 15vh;\n z-index: 1000;\n animation: fadeIn 0.1s ease-out;\n}\n\n@keyframes fadeIn {\n from { opacity: 0; }\n to { opacity: 1; }\n}\n\n.palette {\n width: 100%;\n max-width: 520px;\n height: fit-content;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n box-shadow: var(--shadow-lg);\n overflow: hidden;\n animation: slideDown 0.15s ease-out;\n}\n\n@keyframes slideDown {\n from {\n opacity: 0;\n transform: translateY(-10px);\n }\n to {\n opacity: 1;\n transform: translateY(0);\n }\n}\n\n.palette-input-wrapper {\n display: flex;\n align-items: center;\n padding: var(--space-3) var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n gap: var(--space-2);\n}\n\n.palette-prompt {\n color: var(--color-accent-primary);\n font-family: var(--font-mono);\n font-weight: 600;\n}\n\n.palette-input {\n flex: 1;\n background: transparent;\n border: none;\n outline: none;\n font-family: var(--font-mono);\n font-size: 14px;\n color: var(--color-text-primary);\n}\n\n.palette-input::placeholder {\n color: var(--color-text-muted);\n}\n\n.palette-results {\n max-height: 320px;\n overflow-y: auto;\n overflow-x: hidden;\n}\n\n.palette-empty {\n padding: var(--space-4);\n text-align: center;\n color: var(--color-text-muted);\n font-size: 13px;\n}\n\n.palette-item {\n display: grid;\n grid-template-columns: 20px 1fr;\n align-items: center;\n gap: var(--space-3);\n width: 100%;\n padding: var(--space-2) var(--space-4);\n background: transparent;\n border: none;\n font-family: var(--font-mono);\n text-align: left;\n cursor: pointer;\n transition: background var(--transition-fast);\n}\n\n.palette-item:hover,\n.palette-item.selected {\n background: var(--color-bg-tertiary);\n}\n\n.palette-item.selected {\n background: var(--color-accent-muted);\n}\n\n.palette-item-icon {\n width: 20px;\n height: 20px;\n display: flex;\n align-items: center;\n justify-content: center;\n font-size: 14px;\n font-weight: 600;\n background: transparent;\n overflow: hidden;\n}\n\n.palette-item-icon.board,\n.palette-item-icon.action {\n color: var(--color-accent-primary);\n}\n\n.palette-item-icon.task {\n color: var(--color-text-muted);\n}\n\n.palette-item-content {\n flex: 1 1 0%;\n display: flex;\n flex-direction: column;\n gap: 2px;\n min-width: 0;\n overflow: hidden;\n}\n\n.palette-item-title {\n font-size: 13px;\n color: var(--color-text-primary);\n white-space: nowrap;\n overflow: hidden;\n text-overflow: ellipsis;\n}\n\n.palette-item-subtitle {\n font-size: 11px;\n color: var(--color-text-muted);\n}\n\n.palette-footer {\n display: flex;\n gap: var(--space-4);\n padding: var(--space-2) var(--space-4);\n background: var(--color-bg-secondary);\n border-top: 1px solid var(--color-border-default);\n}\n\n.palette-hint {\n display: flex;\n align-items: center;\n gap: var(--space-1);\n font-size: 11px;\n color: var(--color-text-muted);\n}\n\n.palette-hint kbd {\n padding: 2px 5px;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: 3px;\n font-family: var(--font-mono);\n font-size: 10px;\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .palette-overlay {\n padding-top: 0;\n align-items: stretch;\n }\n\n .palette {\n max-width: 100%;\n height: 100%;\n border-radius: 0;\n animation: none;\n display: flex;\n flex-direction: column;\n }\n\n .palette-input-wrapper {\n padding: var(--space-4);\n }\n\n .palette-input {\n font-size: 16px; /* Prevent iOS zoom */\n }\n\n .palette-results {\n max-height: none;\n flex: 1;\n overflow-y: auto;\n }\n\n .palette-item {\n padding: var(--space-3) var(--space-4);\n min-height: 48px;\n }\n\n .palette-footer {\n padding: var(--space-3) var(--space-4);\n padding-bottom: env(safe-area-inset-bottom, var(--space-3));\n }\n\n /* Hide keyboard hints on mobile */\n .palette-hint kbd {\n display: none;\n }\n}\n" }, { "path": "src/components/CommandPalette/CommandPalette.tsx", "content": "import { useState, useEffect, useRef, useCallback } from 'react';\nimport { useNavigate } from 'react-router-dom';\nimport { useBoard } from '../../context/BoardContext';\nimport './CommandPalette.css';\n\ninterface CommandPaletteProps {\n isOpen: boolean;\n onClose: () => void;\n onNewTask: (columnIndex: number) => void;\n}\n\ntype ResultItem = {\n id: string;\n type: 'board' | 'task' | 'action';\n title: string;\n subtitle?: string;\n action: () => void;\n};\n\nexport function CommandPalette({ isOpen, onClose, onNewTask }: CommandPaletteProps) {\n const navigate = useNavigate();\n const { boards, activeBoard } = useBoard();\n const [query, setQuery] = useState('');\n const [selectedIndex, setSelectedIndex] = useState(0);\n const inputRef = useRef(null);\n const listRef = useRef(null);\n\n const getResults = useCallback((): ResultItem[] => {\n const q = query.toLowerCase().trim();\n\n // Actions\n const actions: ResultItem[] = [\n {\n id: 'new-task-1',\n type: 'action',\n title: 'New task in first column',\n subtitle: activeBoard?.columns[0]?.name,\n action: () => { onNewTask(0); onClose(); },\n },\n ];\n\n if (activeBoard && activeBoard.columns.length > 1) {\n actions.push({\n id: 'new-task-2',\n type: 'action',\n title: 'New task in second column',\n subtitle: activeBoard.columns[1]?.name,\n action: () => { onNewTask(1); onClose(); },\n });\n }\n\n if (activeBoard && activeBoard.columns.length > 2) {\n actions.push({\n id: 'new-task-3',\n type: 'action',\n title: 'New task in third column',\n subtitle: activeBoard.columns[2]?.name,\n action: () => { onNewTask(2); onClose(); },\n });\n }\n\n // Boards\n const boardResults: ResultItem[] = boards.map((board) => ({\n id: `board-${board.id}`,\n type: 'board' as const,\n title: board.name,\n subtitle: board.id === activeBoard?.id ? 'Current board' : 'Switch to board',\n action: () => {\n navigate(`/board/${board.id}`);\n onClose();\n },\n }));\n\n // Tasks from active board\n const taskResults: ResultItem[] = activeBoard?.tasks.map((task) => {\n const column = activeBoard.columns.find((c) => c.id === task.columnId);\n return {\n id: `task-${task.id}`,\n type: 'task' as const,\n title: task.title,\n subtitle: column?.name || '',\n action: () => {\n // For now just close - could open task modal\n onClose();\n },\n };\n }) || [];\n\n // Filter by query\n if (q) {\n const filtered = [...actions, ...boardResults, ...taskResults].filter(\n (item) =>\n item.title.toLowerCase().includes(q) ||\n item.subtitle?.toLowerCase().includes(q)\n );\n return filtered;\n }\n\n // Default: show actions first, then boards\n return [...actions, ...boardResults.slice(0, 5)];\n }, [query, boards, activeBoard, navigate, onClose, onNewTask]);\n\n const results = getResults();\n\n useEffect(() => {\n if (isOpen) {\n setQuery('');\n setSelectedIndex(0);\n setTimeout(() => inputRef.current?.focus(), 10);\n }\n }, [isOpen]);\n\n useEffect(() => {\n if (selectedIndex >= results.length) {\n setSelectedIndex(Math.max(0, results.length - 1));\n }\n }, [results.length, selectedIndex]);\n\n // Scroll selected item into view\n useEffect(() => {\n if (listRef.current) {\n const selected = listRef.current.querySelector('.palette-item.selected');\n selected?.scrollIntoView({ block: 'nearest' });\n }\n }, [selectedIndex]);\n\n const handleKeyDown = (e: React.KeyboardEvent) => {\n switch (e.key) {\n case 'ArrowDown':\n e.preventDefault();\n setSelectedIndex((i) => Math.min(i + 1, results.length - 1));\n break;\n case 'ArrowUp':\n e.preventDefault();\n setSelectedIndex((i) => Math.max(i - 1, 0));\n break;\n case 'Enter':\n e.preventDefault();\n if (results[selectedIndex]) {\n results[selectedIndex].action();\n }\n break;\n case 'Escape':\n e.preventDefault();\n onClose();\n break;\n }\n };\n\n if (!isOpen) return null;\n\n return (\n
\n
e.stopPropagation()}>\n
\n >\n {\n setQuery(e.target.value);\n setSelectedIndex(0);\n }}\n onKeyDown={handleKeyDown}\n />\n
\n\n
\n {results.length === 0 ? (\n
No results found
\n ) : (\n results.map((item, index) => (\n item.action()}\n onMouseEnter={() => setSelectedIndex(index)}\n >\n \n {item.type === 'board' && '#'}\n {item.type === 'task' && '-'}\n {item.type === 'action' && '+'}\n \n \n {item.title}\n {item.subtitle && (\n {item.subtitle}\n )}\n \n \n ))\n )}\n
\n\n
\n \n ↑↓ navigate\n \n \n ↵ select\n \n \n esc close\n \n
\n
\n
\n );\n}\n" }, { "path": "src/components/CommandPalette/index.ts", "content": "export { CommandPalette } from './CommandPalette';\n" }, { "path": "src/components/CommentableText/CommentableText.css", "content": "/**\n * CommentableText Styles\n *\n * Styles for line-selectable text with inline comments.\n * Similar visual language to DiffViewer for consistency.\n */\n\n.commentable-text {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.commentable-text-label {\n font-size: 12px;\n font-weight: 500;\n color: var(--color-text-secondary);\n}\n\n.commentable-text-content {\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n overflow: hidden;\n background: var(--color-bg-primary);\n}\n\n.commentable-text-line-wrapper {\n display: flex;\n flex-direction: column;\n}\n\n.commentable-text-line {\n display: flex;\n line-height: 1.5;\n min-height: 24px;\n user-select: none;\n}\n\n.commentable-text-line.selectable {\n cursor: pointer;\n}\n\n.commentable-text-line.selectable:hover {\n background: rgba(59, 130, 246, 0.06);\n}\n\n.commentable-text-line.selectable:hover .commentable-text-comment-indicator.can-comment {\n opacity: 1;\n}\n\n.commentable-text-line.selected {\n background: rgba(59, 130, 246, 0.12);\n}\n\n.commentable-text-line.selected .commentable-text-line-number {\n background: rgba(59, 130, 246, 0.2);\n color: var(--color-text-primary);\n}\n\n.commentable-text-line-number {\n width: 40px;\n padding: 0 var(--space-2);\n text-align: right;\n font-size: 12px;\n font-family: var(--font-mono);\n color: var(--color-text-muted);\n background: var(--color-bg-secondary);\n flex-shrink: 0;\n}\n\n.commentable-text-line-content {\n flex: 1;\n padding: 0 var(--space-3);\n font-size: 13px;\n color: var(--color-text-primary);\n white-space: pre-wrap;\n word-break: break-word;\n}\n\n/* Comment indicator column */\n.commentable-text-comment-indicator {\n width: 28px;\n flex-shrink: 0;\n display: flex;\n align-items: center;\n justify-content: center;\n font-size: 14px;\n font-weight: 600;\n color: var(--color-text-muted);\n opacity: 0;\n transition: opacity 0.15s;\n}\n\n.commentable-text-comment-indicator.has-comment {\n opacity: 1;\n color: var(--color-accent-primary);\n}\n\n/* Comment input form */\n.commentable-text-comment-input {\n margin: var(--space-2) var(--space-3);\n margin-left: 56px;\n padding: var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-accent-primary);\n border-left: 3px solid var(--color-accent-primary);\n border-radius: var(--border-radius);\n box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);\n}\n\n.commentable-text-comment-textarea {\n width: 100%;\n padding: var(--space-2);\n background: transparent;\n border: none;\n font-family: inherit;\n font-size: 13px;\n color: var(--color-text-primary);\n resize: none;\n min-height: 36px;\n line-height: 1.4;\n}\n\n.commentable-text-comment-textarea::placeholder {\n color: var(--color-text-muted);\n}\n\n.commentable-text-comment-textarea:focus {\n outline: none;\n}\n\n.commentable-text-comment-actions {\n display: flex;\n justify-content: flex-end;\n align-items: center;\n gap: var(--space-2);\n padding-top: var(--space-2);\n border-top: 1px solid var(--color-border-default);\n}\n\n.commentable-text-comment-cancel {\n padding: 4px 10px;\n border: none;\n border-radius: var(--border-radius);\n font-size: 12px;\n background: transparent;\n color: var(--color-text-muted);\n cursor: pointer;\n transition: color 0.15s;\n}\n\n.commentable-text-comment-cancel:hover {\n color: var(--color-text-primary);\n}\n\n.commentable-text-comment-submit {\n padding: 4px 12px;\n border: none;\n border-radius: var(--border-radius);\n font-size: 12px;\n font-weight: 500;\n background: var(--color-accent-primary);\n color: white;\n cursor: pointer;\n transition: opacity 0.15s;\n}\n\n.commentable-text-comment-submit:hover:not(:disabled) {\n opacity: 0.9;\n}\n\n.commentable-text-comment-submit:disabled {\n opacity: 0.4;\n cursor: default;\n}\n\n/* Existing comment display - GitHub PR style */\n.commentable-text-comment {\n position: relative;\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n margin: var(--space-2) var(--space-3);\n margin-left: 56px;\n padding: var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-left: 3px solid #3b82f6;\n border-radius: var(--border-radius);\n box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05);\n}\n\n.commentable-text-comment-lines {\n flex-shrink: 0;\n font-size: 10px;\n color: var(--color-text-muted);\n font-family: var(--font-mono);\n padding: 2px 8px;\n background: rgba(59, 130, 246, 0.1);\n border-radius: 10px;\n align-self: flex-start;\n}\n\n.commentable-text-comment-content {\n flex: 1;\n font-size: 13px;\n color: var(--color-text-primary);\n line-height: 1.5;\n white-space: pre-wrap;\n word-break: break-word;\n}\n\n.commentable-text-comment-remove {\n position: absolute;\n top: var(--space-2);\n right: var(--space-2);\n flex-shrink: 0;\n width: 20px;\n height: 20px;\n padding: 0;\n border: none;\n border-radius: var(--border-radius);\n background: transparent;\n color: var(--color-text-muted);\n font-size: 14px;\n line-height: 1;\n cursor: pointer;\n opacity: 0;\n transition: all 0.15s;\n display: flex;\n align-items: center;\n justify-content: center;\n}\n\n.commentable-text-comment:hover .commentable-text-comment-remove {\n opacity: 1;\n}\n\n.commentable-text-comment-remove:hover {\n background: rgba(239, 68, 68, 0.15);\n color: #ef4444;\n}\n\n/* =============================================================================\n Prose Variant - Document-like display for emails and text content\n ============================================================================= */\n\n.commentable-text-prose .commentable-text-content {\n padding: var(--space-3);\n}\n\n.commentable-text-prose .commentable-text-line {\n min-height: auto;\n padding: var(--space-1) 0;\n}\n\n.commentable-text-prose .commentable-text-line-content {\n padding: var(--space-1) var(--space-2);\n font-family: var(--font-sans);\n font-size: 15px;\n line-height: 1.7;\n color: var(--color-text-primary);\n}\n\n.commentable-text-prose .commentable-text-line.selectable:hover {\n background: rgba(59, 130, 246, 0.04);\n border-radius: var(--radius-sm);\n}\n\n.commentable-text-prose .commentable-text-line.selected {\n background: rgba(59, 130, 246, 0.08);\n border-radius: var(--radius-sm);\n}\n\n/* Adjust comment input position for prose mode */\n.commentable-text-prose .commentable-text-comment-input {\n margin-left: var(--space-2);\n}\n\n/* Adjust existing comment position for prose mode */\n.commentable-text-prose .commentable-text-comment {\n margin-left: var(--space-2);\n}\n" }, { "path": "src/components/CommentableText/CommentableText.tsx", "content": "/**\n * CommentableText - Line-selectable text with inline comments\n *\n * Used for adding line-level comments to text content like\n * email bodies, PR descriptions, or any text being reviewed.\n * Similar interaction pattern to DiffViewer.\n */\n\nimport { useState, useRef, useCallback } from 'react';\nimport type { TextComment } from '../../types';\nimport './CommentableText.css';\n\nexport type { TextComment };\n\ninterface LineSelection {\n startLine: number;\n endLine: number;\n}\n\ninterface CommentableTextProps {\n content: string;\n label?: string;\n comments: TextComment[];\n onAddComment: (comment: Omit) => void;\n onRemoveComment: (id: string) => void;\n disabled?: boolean;\n /**\n * Display variant:\n * - 'code': Line numbers, monospace-ish layout (default)\n * - 'prose': No line numbers, document-like layout for emails/docs\n */\n variant?: 'code' | 'prose';\n}\n\nexport function CommentableText({\n content,\n label,\n comments,\n onAddComment,\n onRemoveComment,\n disabled = false,\n variant = 'code',\n}: CommentableTextProps) {\n const [selection, setSelection] = useState(null);\n const [isDragging, setIsDragging] = useState(false);\n const [showCommentInput, setShowCommentInput] = useState(false);\n const [commentText, setCommentText] = useState('');\n const dragStartRef = useRef(null);\n\n // Split content into lines or paragraphs based on variant\n // Prose mode splits by paragraph (double newline), code mode by line\n const lines = variant === 'prose'\n ? content.split(/\\n\\n+/).filter(p => p.trim())\n : content.split('\\n');\n\n const handleLineMouseDown = useCallback((lineNumber: number, e: React.MouseEvent) => {\n if (disabled) return;\n\n dragStartRef.current = lineNumber;\n setIsDragging(true);\n setSelection({\n startLine: lineNumber,\n endLine: lineNumber,\n });\n setShowCommentInput(false);\n\n // Prevent text selection during drag\n e.preventDefault();\n }, [disabled]);\n\n const handleLineMouseEnter = useCallback((lineNumber: number) => {\n if (!isDragging || dragStartRef.current === null) return;\n\n const start = dragStartRef.current;\n setSelection({\n startLine: Math.min(start, lineNumber),\n endLine: Math.max(start, lineNumber),\n });\n }, [isDragging]);\n\n const handleMouseUp = useCallback(() => {\n if (isDragging && selection) {\n setShowCommentInput(true);\n }\n setIsDragging(false);\n dragStartRef.current = null;\n }, [isDragging, selection]);\n\n const handleAddComment = () => {\n if (!selection || !commentText.trim()) return;\n\n onAddComment({\n lineStart: selection.startLine,\n lineEnd: selection.endLine,\n content: commentText.trim(),\n });\n\n setSelection(null);\n setShowCommentInput(false);\n setCommentText('');\n };\n\n const handleCancelComment = () => {\n setSelection(null);\n setShowCommentInput(false);\n setCommentText('');\n };\n\n const isLineSelected = (lineNumber: number) => {\n if (!selection) return false;\n return lineNumber >= selection.startLine && lineNumber <= selection.endLine;\n };\n\n // Check if a line has a comment (includes range check)\n const hasComment = useCallback((lineNumber: number) => {\n return comments.some((c) => {\n return lineNumber >= c.lineStart && lineNumber <= c.lineEnd;\n });\n }, [comments]);\n\n // Get comments that end on a specific line\n const getCommentsEndingAt = (lineNumber: number) => {\n return comments.filter((c) => c.lineEnd === lineNumber);\n };\n\n return (\n \n {label && }\n
\n {lines.map((line, index) => {\n const lineNumber = index + 1;\n const isSelected = isLineSelected(lineNumber);\n const lineHasComment = hasComment(lineNumber);\n const lineComments = getCommentsEndingAt(lineNumber);\n const showInputAfterLine = showCommentInput && selection?.endLine === lineNumber;\n\n return (\n
\n handleLineMouseDown(lineNumber, e)}\n onMouseEnter={disabled ? undefined : () => handleLineMouseEnter(lineNumber)}\n >\n {variant === 'code' && (\n {lineNumber}\n )}\n \n {line || '\\u00A0'}\n \n \n +\n \n
\n\n {/* Comment input - appears after selection end */}\n {showInputAfterLine && (\n
\n setCommentText(e.target.value)}\n placeholder={variant === 'prose'\n ? 'Add your feedback on this section...'\n : 'Add your feedback on the selected lines...'}\n rows={2}\n autoFocus\n onMouseDown={(e) => e.stopPropagation()}\n />\n
\n \n \n Add Comment\n \n
\n
\n )}\n\n {/* Existing comments that end on this line */}\n {lineComments.map((comment) => (\n
\n {comment.lineEnd !== comment.lineStart && (\n \n {variant === 'prose'\n ? `Paragraphs ${comment.lineStart}-${comment.lineEnd}`\n : `Lines ${comment.lineStart}-${comment.lineEnd}`}\n \n )}\n {comment.content}\n onRemoveComment(comment.id)}\n title=\"Remove comment\"\n >\n ×\n \n
\n ))}\n
\n );\n })}\n \n \n );\n}\n\n/**\n * Format text comments into a feedback string\n */\nexport function formatTextComments(comments: TextComment[]): string {\n if (comments.length === 0) return '';\n\n const lines: string[] = [];\n\n for (const c of comments) {\n const lineRef = c.lineEnd !== c.lineStart\n ? `Lines ${c.lineStart}-${c.lineEnd}`\n : `Line ${c.lineStart}`;\n lines.push(`${lineRef}: \"${c.content}\"`);\n }\n\n return lines.join('\\n');\n}\n" }, { "path": "src/components/DiffViewer/DiffViewer.css", "content": ".diff-viewer {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n font-family: var(--font-mono);\n font-size: 12px;\n}\n\n.diff-viewer-empty {\n padding: var(--space-4);\n text-align: center;\n color: var(--color-text-muted);\n}\n\n/* File */\n.diff-file {\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n overflow: hidden;\n}\n\n.diff-file.selected {\n border-color: var(--color-accent-primary);\n}\n\n.diff-file-header {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-secondary);\n cursor: pointer;\n user-select: none;\n}\n\n.diff-file-header:hover {\n background: var(--color-bg-tertiary);\n}\n\n.diff-file-toggle {\n font-size: 10px;\n color: var(--color-text-muted);\n}\n\n.diff-file-icon {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 16px;\n height: 16px;\n border-radius: 2px;\n font-size: 11px;\n font-weight: 600;\n}\n\n.diff-file-icon.added {\n background: rgba(34, 197, 94, 0.2);\n color: #22c55e;\n}\n\n.diff-file-icon.deleted {\n background: rgba(239, 68, 68, 0.2);\n color: #ef4444;\n}\n\n.diff-file-icon.modified {\n background: rgba(59, 130, 246, 0.2);\n color: #3b82f6;\n}\n\n.diff-file-icon.renamed {\n background: rgba(168, 85, 247, 0.2);\n color: #a855f7;\n}\n\n.diff-file-path {\n flex: 1;\n color: var(--color-text-primary);\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.diff-file-stats {\n display: flex;\n gap: var(--space-2);\n}\n\n.stat-additions {\n color: #22c55e;\n}\n\n.stat-deletions {\n color: #ef4444;\n}\n\n.diff-file-content {\n border-top: 1px solid var(--color-border-default);\n overflow-x: auto;\n}\n\n/* Hunk */\n.diff-hunk {\n border-bottom: 1px solid var(--color-border-default);\n min-width: fit-content;\n}\n\n.diff-hunk:last-child {\n border-bottom: none;\n}\n\n.diff-hunk-header {\n padding: var(--space-1) var(--space-3);\n background: var(--color-bg-tertiary);\n color: var(--color-text-muted);\n font-size: 11px;\n}\n\n.diff-hunk-lines {\n display: flex;\n flex-direction: column;\n min-width: fit-content;\n}\n\n/* Line */\n.diff-line {\n display: flex;\n line-height: 1.4;\n min-height: 20px;\n}\n\n.diff-line:hover {\n background: rgba(128, 128, 128, 0.1);\n}\n\n.diff-line-number {\n width: 40px;\n padding: 0 var(--space-2);\n text-align: right;\n color: var(--color-text-muted);\n background: var(--color-bg-secondary);\n user-select: none;\n flex-shrink: 0;\n}\n\n.diff-line-prefix {\n width: 16px;\n text-align: center;\n flex-shrink: 0;\n}\n\n.diff-line-content {\n flex: 1;\n padding-right: var(--space-2);\n white-space: pre-wrap;\n word-break: break-all;\n}\n\n.diff-line-content code {\n font-family: inherit;\n}\n\n.line-addition {\n background: rgba(34, 197, 94, 0.15);\n}\n\n.line-addition .diff-line-number {\n background: rgba(34, 197, 94, 0.2);\n color: #22c55e;\n}\n\n.line-addition .diff-line-prefix {\n color: #22c55e;\n}\n\n.line-deletion {\n background: rgba(239, 68, 68, 0.15);\n}\n\n.line-deletion .diff-line-number {\n background: rgba(239, 68, 68, 0.2);\n color: #ef4444;\n}\n\n.line-deletion .diff-line-prefix {\n color: #ef4444;\n}\n\n.line-context {\n background: var(--color-bg-primary);\n}\n\n/* Line selection */\n.diff-line {\n position: relative;\n user-select: none;\n}\n\n.diff-line.selectable {\n cursor: pointer;\n}\n\n/* Hover state for selectable lines - show a hint that they're commentable */\n.diff-line.selectable:hover {\n background: rgba(59, 130, 246, 0.08) !important;\n}\n\n.diff-line.selected {\n background: rgba(59, 130, 246, 0.12) !important;\n}\n\n.line-addition.selected {\n background: rgba(59, 130, 246, 0.18) !important;\n}\n\n.line-deletion.selected {\n background: rgba(59, 130, 246, 0.18) !important;\n}\n\n.diff-line.selected .diff-line-number {\n background: rgba(59, 130, 246, 0.25) !important;\n color: var(--color-text-primary) !important;\n}\n\n/* Comment indicator column - shows + on hover */\n.diff-line-comment-indicator {\n width: 24px;\n flex-shrink: 0;\n display: flex;\n align-items: center;\n justify-content: center;\n font-size: 14px;\n font-weight: 600;\n color: var(--color-text-muted);\n opacity: 0;\n transition: opacity 0.15s;\n}\n\n/* Show + on line hover */\n.diff-line.selectable:hover .diff-line-comment-indicator {\n opacity: 1;\n}\n\n/* Always show indicator on lines with comments */\n.diff-line-comment-indicator.has-comment {\n opacity: 1;\n color: var(--color-accent-primary);\n}\n\n/* Comment input form */\n.diff-comment-input {\n margin: var(--space-2) var(--space-3);\n margin-left: 96px;\n padding: var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-accent-primary);\n border-left: 3px solid var(--color-accent-primary);\n border-radius: var(--border-radius);\n box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);\n}\n\n.diff-comment-type {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n margin-bottom: var(--space-2);\n font-size: 12px;\n}\n\n.diff-comment-type label {\n color: var(--color-text-secondary);\n}\n\n.diff-comment-type select {\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n background: var(--color-bg-secondary);\n color: var(--color-text-primary);\n font-size: 12px;\n padding: 4px 8px;\n}\n\n.diff-comment-textarea {\n width: 100%;\n padding: var(--space-2);\n background: transparent;\n border: none;\n font-family: inherit;\n font-size: 13px;\n color: var(--color-text-primary);\n resize: none;\n min-height: 36px;\n line-height: 1.4;\n}\n\n.diff-comment-textarea::placeholder {\n color: var(--color-text-muted);\n}\n\n.diff-comment-textarea:focus {\n outline: none;\n}\n\n.diff-comment-suggestion {\n border-top: 1px solid var(--color-border-default);\n margin-top: var(--space-2);\n padding-top: var(--space-2);\n}\n\n.diff-comment-actions {\n display: flex;\n justify-content: flex-end;\n align-items: center;\n gap: var(--space-2);\n padding-top: var(--space-2);\n border-top: 1px solid var(--color-border-default);\n}\n\n.diff-comment-cancel {\n padding: 4px 10px;\n border: none;\n border-radius: var(--border-radius);\n font-size: 12px;\n background: transparent;\n color: var(--color-text-muted);\n cursor: pointer;\n transition: color 0.15s;\n}\n\n.diff-comment-cancel:hover {\n color: var(--color-text-primary);\n}\n\n.diff-comment-submit {\n padding: 4px 12px;\n border: none;\n border-radius: var(--border-radius);\n font-size: 12px;\n font-weight: 500;\n background: var(--color-accent-primary);\n color: white;\n cursor: pointer;\n transition: opacity 0.15s;\n}\n\n.diff-comment-submit:hover:not(:disabled) {\n opacity: 0.9;\n}\n\n.diff-comment-submit:disabled {\n opacity: 0.4;\n cursor: default;\n}\n\n/* Existing comment display */\n.diff-comment {\n position: relative;\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n margin: var(--space-2) var(--space-3);\n margin-left: 60px;\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-left: 2px solid var(--color-accent-primary);\n border-radius: var(--border-radius);\n}\n\n.diff-comment.active {\n background: rgba(59, 130, 246, 0.04);\n}\n\n.diff-comment-meta {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n font-size: 11px;\n color: var(--color-text-muted);\n}\n\n.diff-comment-badge {\n font-weight: 500;\n}\n\n.diff-comment-lines {\n font-family: var(--font-mono);\n font-size: 10px;\n}\n\n.diff-comment-content {\n flex: 1;\n font-size: 13px;\n font-family: inherit;\n color: var(--color-text-primary);\n line-height: 1.5;\n white-space: pre-wrap;\n word-break: break-word;\n}\n\n.diff-comment-codeblock {\n margin: var(--space-2) 0;\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-tertiary);\n border-radius: var(--border-radius);\n font-family: var(--font-mono);\n font-size: 12px;\n overflow-x: auto;\n white-space: pre;\n}\n\n.diff-comment-codeblock code {\n background: none;\n padding: 0;\n font-size: inherit;\n}\n\n.diff-comment-inline-code {\n padding: 1px 4px;\n background: var(--color-bg-tertiary);\n border-radius: 3px;\n font-family: var(--font-mono);\n font-size: 0.9em;\n}\n\n.diff-comment-suggestion-preview {\n font-size: 12px;\n font-family: var(--font-mono);\n color: var(--color-text-primary);\n background: var(--color-bg-tertiary);\n border-radius: var(--border-radius);\n padding: var(--space-2) var(--space-3);\n white-space: pre-wrap;\n}\n\n.diff-comment-remove {\n position: absolute;\n top: var(--space-2);\n right: var(--space-2);\n flex-shrink: 0;\n width: 20px;\n height: 20px;\n padding: 0;\n border: none;\n border-radius: var(--border-radius);\n background: transparent;\n color: var(--color-text-muted);\n font-size: 14px;\n line-height: 1;\n cursor: pointer;\n opacity: 0;\n transition: all 0.15s;\n display: flex;\n align-items: center;\n justify-content: center;\n}\n\n.diff-comment:hover .diff-comment-remove {\n opacity: 1;\n}\n\n.diff-comment-remove:hover {\n background: rgba(239, 68, 68, 0.15);\n color: #ef4444;\n}\n\n/* File Tree */\n.file-tree {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n font-family: var(--font-mono);\n}\n\n.file-tree-header {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding: var(--space-2);\n}\n\n.file-tree-title {\n font-size: 12px;\n font-weight: 500;\n color: var(--color-text-secondary);\n}\n\n.file-tree-count {\n font-size: 11px;\n padding: 2px 6px;\n background: var(--color-bg-tertiary);\n border-radius: 10px;\n color: var(--color-text-muted);\n}\n\n.file-tree-list {\n display: flex;\n flex-direction: column;\n}\n\n.file-tree-item {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-1) var(--space-2);\n background: transparent;\n border: none;\n font-family: inherit;\n font-size: 12px;\n color: var(--color-text-primary);\n text-align: left;\n cursor: pointer;\n border-radius: var(--border-radius);\n transition: background var(--transition-fast);\n}\n\n.file-tree-item:hover {\n background: var(--color-bg-tertiary);\n}\n\n.file-tree-item.selected {\n background: var(--color-accent-muted);\n}\n\n.file-tree-icon {\n flex-shrink: 0;\n font-weight: 600;\n}\n\n.file-tree-icon.added { color: #22c55e; }\n.file-tree-icon.deleted { color: #ef4444; }\n.file-tree-icon.modified { color: #3b82f6; }\n.file-tree-icon.renamed { color: #a855f7; }\n\n.file-tree-name {\n flex: 1;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.file-tree-stats {\n display: flex;\n gap: var(--space-1);\n font-size: 10px;\n align-items: center;\n}\n\n.file-tree-note-count {\n min-width: 16px;\n height: 16px;\n border-radius: 999px;\n padding: 0 5px;\n display: inline-flex;\n align-items: center;\n justify-content: center;\n background: rgba(59, 130, 246, 0.18);\n color: #1d4ed8;\n font-weight: 600;\n font-size: 10px;\n}\n" }, { "path": "src/components/DiffViewer/DiffViewer.tsx", "content": "import { useState, useRef, useCallback, useEffect, useMemo } from 'react';\nimport type { DiffFile, DiffHunk, DiffLine } from '../../utils/diffParser';\nimport type { DiffComment } from '../../types';\nimport './DiffViewer.css';\n\n/**\n * Lightweight markdown renderer for diff comments.\n * Supports: fenced code blocks, inline code, bold, italic.\n */\nfunction SimpleMarkdown({ text }: { text: string }) {\n const rendered = useMemo(() => {\n const parts: React.ReactNode[] = [];\n // Split on fenced code blocks first\n const codeBlockRe = /```(?:\\w*)\\n?([\\s\\S]*?)```/g;\n let lastIndex = 0;\n let match: RegExpExecArray | null;\n let key = 0;\n\n while ((match = codeBlockRe.exec(text)) !== null) {\n if (match.index > lastIndex) {\n parts.push(...renderInline(text.slice(lastIndex, match.index), key));\n key += 100;\n }\n parts.push(\n 
{match[1].replace(/\\n$/, '')}
\n );\n lastIndex = match.index + match[0].length;\n }\n if (lastIndex < text.length) {\n parts.push(...renderInline(text.slice(lastIndex), key));\n }\n return parts;\n }, [text]);\n\n return <>{rendered};\n}\n\nfunction renderInline(text: string, keyStart: number): React.ReactNode[] {\n // Process inline: **bold**, *italic*, `code`\n const inlineRe = /(\\*\\*(.+?)\\*\\*|\\*(.+?)\\*|`([^`]+?)`)/g;\n const parts: React.ReactNode[] = [];\n let lastIndex = 0;\n let match: RegExpExecArray | null;\n let key = keyStart;\n\n while ((match = inlineRe.exec(text)) !== null) {\n if (match.index > lastIndex) {\n parts.push({text.slice(lastIndex, match.index)});\n }\n if (match[2]) {\n parts.push({match[2]});\n } else if (match[3]) {\n parts.push({match[3]});\n } else if (match[4]) {\n parts.push({match[4]});\n }\n lastIndex = match.index + match[0].length;\n }\n if (lastIndex < text.length) {\n parts.push({text.slice(lastIndex)});\n }\n return parts;\n}\n\ninterface LineSelection {\n filePath: string;\n startLine: number;\n endLine: number;\n startType: 'addition' | 'deletion' | 'context';\n endType: 'addition' | 'deletion' | 'context';\n}\n\ninterface DiffViewerProps {\n files: DiffFile[];\n selectedFile?: string;\n onFileSelect?: (path: string) => void;\n comments?: DiffComment[];\n onAddComment?: (comment: Omit) => void;\n onRemoveComment?: (id: string) => void;\n activeCommentId?: string | null;\n commentMode?: 'comment-only' | 'comment-and-suggestion';\n}\n\nexport function DiffViewer({\n files,\n selectedFile,\n onFileSelect,\n comments = [],\n onAddComment,\n onRemoveComment,\n activeCommentId = null,\n commentMode = 'comment-only',\n}: DiffViewerProps) {\n const [expandedFiles, setExpandedFiles] = useState>(\n new Set(files.map((f) => f.path))\n );\n const [selection, setSelection] = useState(null);\n const [isDragging, setIsDragging] = useState(false);\n const [showCommentInput, setShowCommentInput] = useState(false);\n const [commentText, setCommentText] = useState('');\n const [commentKind, setCommentKind] = useState<'comment' | 'suggestion'>('comment');\n const [suggestionText, setSuggestionText] = useState('');\n const dragStartRef = useRef<{ filePath: string; line: number; type: string } | null>(null);\n\n const resetCommentForm = useCallback(() => {\n setSelection(null);\n setShowCommentInput(false);\n setCommentText('');\n setCommentKind('comment');\n setSuggestionText('');\n }, []);\n\n const handleLineMouseDown = useCallback((filePath: string, lineNumber: number, lineType: string, e: React.MouseEvent) => {\n if (lineType === 'context' || lineType === 'header') return;\n\n // Start tracking for potential drag\n dragStartRef.current = { filePath, line: lineNumber, type: lineType };\n setIsDragging(true);\n setSelection({\n filePath,\n startLine: lineNumber,\n endLine: lineNumber,\n startType: lineType as 'addition' | 'deletion' | 'context',\n endType: lineType as 'addition' | 'deletion' | 'context',\n });\n setShowCommentInput(false);\n setCommentKind('comment');\n setSuggestionText('');\n\n // Prevent text selection during drag\n e.preventDefault();\n }, []);\n\n const handleLineMouseEnter = useCallback((filePath: string, lineNumber: number, lineType: string) => {\n if (!isDragging || !dragStartRef.current) return;\n if (filePath !== dragStartRef.current.filePath) return;\n\n const start = dragStartRef.current.line;\n const isEndLine = lineNumber >= start;\n setSelection({\n filePath,\n startLine: Math.min(start, lineNumber),\n endLine: Math.max(start, lineNumber),\n startType: isEndLine ? dragStartRef.current.type as 'addition' | 'deletion' | 'context' : lineType as 'addition' | 'deletion' | 'context',\n endType: isEndLine ? lineType as 'addition' | 'deletion' | 'context' : dragStartRef.current.type as 'addition' | 'deletion' | 'context',\n });\n }, [isDragging]);\n\n const handleMouseUp = useCallback(() => {\n if (isDragging && selection) {\n setShowCommentInput(true);\n }\n setIsDragging(false);\n dragStartRef.current = null;\n }, [isDragging, selection]);\n\n const handleAddComment = () => {\n if (!selection || !onAddComment) return;\n\n const body = commentText.trim();\n const suggestion = suggestionText.trimEnd();\n const requiresSuggestion = commentMode === 'comment-and-suggestion' && commentKind === 'suggestion';\n\n if (!body && !suggestion) return;\n if (requiresSuggestion && !suggestion) return;\n\n onAddComment({\n filePath: selection.filePath,\n lineNumber: selection.startLine,\n endLine: selection.endLine,\n lineType: selection.startType,\n content: body,\n kind: commentKind,\n suggestion: requiresSuggestion ? suggestion : undefined,\n });\n\n resetCommentForm();\n };\n\n const handleCancelComment = () => {\n resetCommentForm();\n };\n\n const isLineSelected = (filePath: string, lineNumber: number) => {\n if (!selection || selection.filePath !== filePath) return false;\n return lineNumber >= selection.startLine && lineNumber <= selection.endLine;\n };\n\n // Check if a line has a comment (includes range check and type check)\n const hasComment = useCallback((filePath: string, lineNumber: number, lineType: string) => {\n return comments.some((c) => {\n if (c.filePath !== filePath) return false;\n if (c.lineType !== lineType) return false;\n const start = c.lineNumber;\n const end = c.endLine ?? c.lineNumber;\n return lineNumber >= start && lineNumber <= end;\n });\n }, [comments]);\n\n const toggleFile = (path: string) => {\n const newExpanded = new Set(expandedFiles);\n if (newExpanded.has(path)) {\n newExpanded.delete(path);\n } else {\n newExpanded.add(path);\n }\n setExpandedFiles(newExpanded);\n };\n\n // Ensure externally selected files are visible even if user previously collapsed them.\n useEffect(() => {\n if (!selectedFile) return;\n setExpandedFiles((prev) => {\n if (prev.has(selectedFile)) return prev;\n const next = new Set(prev);\n next.add(selectedFile);\n return next;\n });\n }, [selectedFile]);\n\n if (files.length === 0) {\n return (\n
\n No changes to display\n
\n );\n }\n\n const canComment = !!onAddComment;\n\n return (\n \n {files.map((file) => {\n const fileComments = comments.filter((c) => c.filePath === file.path);\n const showInputForFile = showCommentInput && selection?.filePath === file.path;\n\n return (\n \n {\n toggleFile(file.path);\n onFileSelect?.(file.path);\n }}\n >\n \n {expandedFiles.has(file.path) ? '▼' : '▶'}\n \n \n {file.action === 'added' && '+'}\n {file.action === 'deleted' && '-'}\n {file.action === 'modified' && '~'}\n {file.action === 'renamed' && '>'}\n \n \n {file.oldPath ? `${file.oldPath} → ${file.path}` : file.path}\n \n \n {file.additions > 0 && (\n +{file.additions}\n )}\n {file.deletions > 0 && (\n -{file.deletions}\n )}\n \n \n\n {expandedFiles.has(file.path) && (\n
\n {file.hunks.map((hunk, hunkIndex) => (\n \n ))}\n
\n )}\n \n );\n })}\n \n );\n}\n\ninterface DiffHunkViewProps {\n hunk: DiffHunk;\n filePath: string;\n comments: DiffComment[];\n activeCommentId?: string | null;\n selection: LineSelection | null;\n showCommentInput: boolean;\n commentText: string;\n commentKind: 'comment' | 'suggestion';\n suggestionText: string;\n commentMode: 'comment-only' | 'comment-and-suggestion';\n onCommentTextChange: (text: string) => void;\n onCommentKindChange: (kind: 'comment' | 'suggestion') => void;\n onSuggestionTextChange: (text: string) => void;\n onAddComment: () => void;\n onCancelComment: () => void;\n onRemoveComment?: (id: string) => void;\n onLineMouseDown?: (filePath: string, lineNumber: number, lineType: string, e: React.MouseEvent) => void;\n onLineMouseEnter?: (filePath: string, lineNumber: number, lineType: string) => void;\n isLineSelected: (filePath: string, lineNumber: number) => boolean;\n hasComment: (filePath: string, lineNumber: number, lineType: string) => boolean;\n}\n\nfunction DiffHunkView({\n hunk,\n filePath,\n comments,\n activeCommentId,\n selection,\n showCommentInput,\n commentText,\n commentKind,\n suggestionText,\n commentMode,\n onCommentTextChange,\n onCommentKindChange,\n onSuggestionTextChange,\n onAddComment,\n onCancelComment,\n onRemoveComment,\n onLineMouseDown,\n onLineMouseEnter,\n isLineSelected,\n hasComment,\n}: DiffHunkViewProps) {\n // Find where to show the comment input (after the last selected line)\n const selectionEndLine = selection?.filePath === filePath ? selection.endLine : null;\n const selectionEndType = selection?.filePath === filePath ? selection.endType : null;\n\n // Group comments by their end line AND type for display\n // Key format: \"lineNumber:lineType\" to handle same line numbers with different types\n const commentsByLineAndType = comments.reduce((acc, c) => {\n const key = `${c.endLine ?? c.lineNumber}:${c.lineType}`;\n if (!acc[key]) acc[key] = [];\n acc[key].push(c);\n return acc;\n }, {} as Record);\n\n return (\n
\n
{hunk.header}
\n
\n {hunk.lines.map((line, lineIndex) => {\n const lineNumber = line.newLineNumber ?? line.oldLineNumber ?? 0;\n const isSelected = isLineSelected(filePath, lineNumber);\n // Get comments matching both line number AND type\n const lineComments = commentsByLineAndType[`${lineNumber}:${line.type}`] || [];\n // Only show input after the specific line that matches both number AND type\n const showInputAfterThisLine = showCommentInput && selectionEndLine === lineNumber && selectionEndType === line.type;\n\n return (\n \n );\n })}\n
\n
\n );\n}\n\ninterface DiffLineViewProps {\n line: DiffLine;\n filePath: string;\n lineNumber: number;\n isSelected: boolean;\n hasComment: boolean;\n comments: DiffComment[];\n activeCommentId?: string | null;\n showCommentInput: boolean;\n commentText: string;\n commentKind: 'comment' | 'suggestion';\n suggestionText: string;\n commentMode: 'comment-only' | 'comment-and-suggestion';\n onCommentTextChange: (text: string) => void;\n onCommentKindChange: (kind: 'comment' | 'suggestion') => void;\n onSuggestionTextChange: (text: string) => void;\n onAddComment: () => void;\n onCancelComment: () => void;\n onRemoveComment?: (id: string) => void;\n onMouseDown?: (filePath: string, lineNumber: number, lineType: string, e: React.MouseEvent) => void;\n onMouseEnter?: (filePath: string, lineNumber: number, lineType: string) => void;\n}\n\nfunction DiffLineView({\n line,\n filePath,\n lineNumber,\n isSelected,\n hasComment,\n comments,\n activeCommentId,\n showCommentInput,\n commentText,\n commentKind,\n suggestionText,\n commentMode,\n onCommentTextChange,\n onCommentKindChange,\n onSuggestionTextChange,\n onAddComment,\n onCancelComment,\n onRemoveComment,\n onMouseDown,\n onMouseEnter,\n}: DiffLineViewProps) {\n const getLineClass = () => {\n switch (line.type) {\n case 'addition':\n return 'line-addition';\n case 'deletion':\n return 'line-deletion';\n case 'context':\n return 'line-context';\n default:\n return '';\n }\n };\n\n const getLinePrefix = () => {\n switch (line.type) {\n case 'addition':\n return '+';\n case 'deletion':\n return '-';\n case 'context':\n return ' ';\n default:\n return '';\n }\n };\n\n const canSelect = line.type === 'addition' || line.type === 'deletion';\n\n return (\n <>\n onMouseDown(filePath, lineNumber, line.type, e) : undefined}\n onMouseEnter={onMouseEnter ? () => onMouseEnter(filePath, lineNumber, line.type) : undefined}\n >\n \n {line.oldLineNumber ?? ''}\n \n \n {line.newLineNumber ?? ''}\n \n {getLinePrefix()}\n \n {line.content || '\\n'}\n \n {/* Comment indicator column - shows + on hover for commentable lines */}\n {canSelect && onMouseDown && (\n \n +\n \n )}\n \n\n {/* Comment input - appears after selection end */}\n {showCommentInput && (\n
\n {commentMode === 'comment-and-suggestion' && (\n
\n \n onCommentKindChange(e.target.value as 'comment' | 'suggestion')}\n >\n \n \n \n
\n )}\n onCommentTextChange(e.target.value)}\n placeholder={commentKind === 'suggestion'\n ? 'Optional context for this suggestion...'\n : commentMode === 'comment-and-suggestion'\n ? 'Add a comment for the PR author on the selected lines...'\n : 'Add your feedback on the selected lines...'}\n rows={2}\n autoFocus\n onMouseDown={(e) => e.stopPropagation()}\n />\n {commentMode === 'comment-and-suggestion' && commentKind === 'suggestion' && (\n onSuggestionTextChange(e.target.value)}\n placeholder=\"Suggested replacement code/text...\"\n rows={3}\n onMouseDown={(e) => e.stopPropagation()}\n />\n )}\n
\n \n \n {commentKind === 'suggestion' ? 'Add Suggestion' : 'Add Comment'}\n \n
\n
\n )}\n\n {/* Existing comments that end on this line */}\n {comments.map((comment) => (\n \n
\n \n {comment.kind === 'suggestion' ? 'suggestion' : 'comment'}\n \n {comment.endLine && comment.endLine !== comment.lineNumber && (\n \n L{comment.lineNumber}–{comment.endLine}\n \n )}\n
\n \n {comment.kind === 'suggestion' && comment.suggestion && (\n
\n {comment.suggestion}\n
\n )}\n {onRemoveComment && (\n onRemoveComment(comment.id)}\n title=\"Remove comment\"\n >\n ×\n \n )}\n \n ))}\n \n );\n}\n\n/**\n * File tree component for navigating changed files\n */\ninterface FileTreeProps {\n files: DiffFile[];\n selectedFile?: string;\n onSelect: (path: string) => void;\n noteCounts?: Record;\n}\n\nexport function FileTree({ files, selectedFile, onSelect, noteCounts }: FileTreeProps) {\n return (\n
\n
\n Changed Files\n {files.length}\n
\n
\n {files.map((file) => (\n onSelect(file.path)}\n >\n \n {file.action === 'added' && '+'}\n {file.action === 'deleted' && '-'}\n {file.action === 'modified' && '~'}\n {file.action === 'renamed' && '>'}\n \n \n {file.path.split('/').pop()}\n \n \n {typeof noteCounts?.[file.path] === 'number' && noteCounts[file.path] > 0 && (\n {noteCounts[file.path]}\n )}\n {file.additions > 0 && (\n +{file.additions}\n )}\n {file.deletions > 0 && (\n -{file.deletions}\n )}\n \n \n ))}\n
\n
\n );\n}\n" }, { "path": "src/components/DiffViewer/index.ts", "content": "export { DiffViewer, FileTree } from './DiffViewer';\n" }, { "path": "src/components/GitHubCallback.tsx", "content": "import { useEffect, useState } from 'react';\nimport { useSearchParams, useNavigate } from 'react-router-dom';\n\n/**\n * Handles GitHub OAuth callback by forwarding to the backend API.\n * This is needed because browser navigation to /api/* routes\n * may not be intercepted by the Cloudflare Vite plugin.\n */\nexport function GitHubCallback() {\n const [searchParams] = useSearchParams();\n const navigate = useNavigate();\n const [error, setError] = useState(null);\n\n useEffect(() => {\n const code = searchParams.get('code');\n const state = searchParams.get('state');\n\n if (!code || !state) {\n setError('Missing code or state parameter');\n return;\n }\n\n // Forward to backend API\n const processCallback = async () => {\n try {\n const response = await fetch(\n `/api/github/oauth/exchange?code=${encodeURIComponent(code)}&state=${encodeURIComponent(state)}`\n );\n\n const result = await response.json() as {\n success: boolean;\n data?: { boardId: string };\n error?: { message: string };\n };\n\n if (result.success && result.data) {\n navigate(`/board/${result.data.boardId}?github=connected`, { replace: true });\n } else {\n setError(result.error?.message || 'OAuth failed');\n }\n } catch (err) {\n setError(err instanceof Error ? err.message : 'OAuth failed');\n }\n };\n\n processCallback();\n }, [searchParams, navigate]);\n\n if (error) {\n return (\n
\n

GitHub Connection Failed

\n

{error}

\n \n
\n );\n }\n\n return (\n
\n

Connecting to GitHub...

\n
\n );\n}\n" }, { "path": "src/components/GoogleCallback.tsx", "content": "import { useEffect, useState } from 'react';\nimport { useSearchParams, useNavigate } from 'react-router-dom';\n\n/**\n * Handles Google OAuth callback by forwarding to the backend API.\n * This is needed because browser navigation to /api/* routes\n * may not be intercepted by the Cloudflare Vite plugin.\n */\nexport function GoogleCallback() {\n const [searchParams] = useSearchParams();\n const navigate = useNavigate();\n const [error, setError] = useState(null);\n\n useEffect(() => {\n const code = searchParams.get('code');\n const state = searchParams.get('state');\n\n if (!code || !state) {\n setError('Missing code or state parameter');\n return;\n }\n\n // Forward to backend API\n const processCallback = async () => {\n try {\n const response = await fetch(\n `/api/google/oauth/exchange?code=${encodeURIComponent(code)}&state=${encodeURIComponent(state)}`\n );\n\n const result = await response.json() as {\n success: boolean;\n data?: { boardId: string };\n error?: { message: string };\n };\n\n if (result.success && result.data) {\n navigate(`/board/${result.data.boardId}?google=connected`, { replace: true });\n } else {\n setError(result.error?.message || 'OAuth failed');\n }\n } catch (err) {\n setError(err instanceof Error ? err.message : 'OAuth failed');\n }\n };\n\n processCallback();\n }, [searchParams, navigate]);\n\n if (error) {\n return (\n
\n

Google Connection Failed

\n

{error}

\n \n
\n );\n }\n\n return (\n
\n

Connecting to Google...

\n
\n );\n}\n" }, { "path": "src/components/Header/Header.css", "content": ".header {\n position: relative;\n display: flex;\n align-items: center;\n justify-content: space-between;\n height: var(--header-height);\n padding: 0 var(--space-4);\n background: var(--color-bg-primary);\n border-bottom: 1px solid var(--color-border-default);\n}\n\n.header-left {\n /* No flex grow - only take space needed for logo */\n}\n\n/* Weft Logo */\n.weft-logo {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n cursor: pointer;\n}\n\n.weft-logo-icon {\n color: var(--color-accent-primary);\n}\n\n.weft-logo-text {\n font-size: 14px;\n font-weight: 600;\n color: var(--color-accent-primary);\n letter-spacing: 2px;\n}\n\n/* Weft logo unweave animation - segments spread apart like loosening weave */\n.weft-logo-icon {\n overflow: visible;\n}\n\n.weft-logo-icon .weft {\n transition: transform 0.35s cubic-bezier(0.25, 0.46, 0.45, 0.94);\n}\n\n/* On hover, thread segments spread apart from center - weave loosens */\n/* Top row */\n.weft-logo:hover .weft-top-1 { transform: translateX(-2px); }\n.weft-logo:hover .weft-top-2 { transform: translateY(-1px); }\n.weft-logo:hover .weft-top-3 { transform: translateX(2px); }\n\n/* Middle row - opposite motion */\n.weft-logo:hover .weft-mid-1 { transform: translateX(-1.5px); transition-delay: 40ms; }\n.weft-logo:hover .weft-mid-2 { transform: translateY(0.5px); transition-delay: 40ms; }\n.weft-logo:hover .weft-mid-3 { transform: translateX(1.5px); transition-delay: 40ms; }\n\n/* Bottom row */\n.weft-logo:hover .weft-bot-1 { transform: translateX(-2px); transition-delay: 80ms; }\n.weft-logo:hover .weft-bot-2 { transform: translateY(1px); transition-delay: 80ms; }\n.weft-logo:hover .weft-bot-3 { transform: translateX(2px); transition-delay: 80ms; }\n\n.header-center {\n position: absolute;\n left: 50%;\n transform: translateX(-50%);\n display: flex;\n justify-content: center;\n}\n\n.header-right {\n margin-left: auto;\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.header-settings-btn {\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n font-family: var(--font-mono);\n font-size: 12px;\n color: var(--color-text-muted);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.header-settings-btn:hover {\n border-color: var(--color-border-focus);\n color: var(--color-text-primary);\n}\n\n/* Board Selector */\n.board-selector-wrapper {\n position: relative;\n}\n\n.board-selector-trigger {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-primary);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.board-selector-trigger:hover {\n border-color: var(--color-border-focus);\n}\n\n.board-selector-name {\n max-width: 200px;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.board-selector-arrow {\n font-size: 10px;\n color: var(--color-text-muted);\n}\n\n.board-selector-dropdown {\n position: absolute;\n top: calc(100% + var(--space-1));\n left: 50%;\n transform: translateX(-50%);\n min-width: 200px;\n max-width: 300px;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n box-shadow: var(--shadow-lg);\n z-index: 100;\n overflow: hidden;\n}\n\n.board-selector-empty {\n padding: var(--space-3);\n color: var(--color-text-muted);\n font-size: 13px;\n text-align: center;\n}\n\n.board-selector-item {\n display: block;\n width: 100%;\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: none;\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-primary);\n text-align: left;\n cursor: pointer;\n transition: background var(--transition-fast);\n}\n\n.board-selector-item:hover {\n background: var(--color-bg-tertiary);\n}\n\n.board-selector-item.active {\n background: var(--color-accent-muted);\n color: var(--color-accent-primary);\n}\n\n.board-selector-divider {\n height: 1px;\n background: var(--color-border-default);\n margin: var(--space-1) 0;\n}\n\n.board-selector-new {\n color: var(--color-accent-primary);\n}\n\n/* Executions Dropdown */\n.executions-wrapper {\n position: relative;\n margin-right: var(--space-2);\n}\n\n.executions-trigger {\n display: flex;\n align-items: center;\n gap: var(--space-1);\n padding: var(--space-2) var(--space-3);\n background: var(--color-accent-muted);\n border: 1px solid var(--color-accent-primary);\n border-radius: var(--border-radius);\n font-family: var(--font-mono);\n font-size: 12px;\n color: var(--color-accent-primary);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.executions-trigger:hover {\n background: var(--color-accent-primary);\n color: white;\n}\n\n.executions-trigger-empty {\n background: var(--color-bg-tertiary);\n border-color: var(--color-border-default);\n color: var(--color-text-muted);\n}\n\n.executions-trigger-empty:hover {\n background: var(--color-bg-secondary);\n color: var(--color-text-primary);\n}\n\n.executions-icon {\n font-size: 12px;\n}\n\n.executions-count {\n font-weight: 600;\n min-width: 16px;\n text-align: center;\n}\n\n.executions-dropdown {\n position: absolute;\n top: calc(100% + var(--space-1));\n right: 0;\n width: 320px;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n box-shadow: var(--shadow-lg);\n z-index: 100;\n overflow: hidden;\n}\n\n.executions-header {\n padding: var(--space-2) var(--space-3);\n font-size: 11px;\n font-weight: 600;\n text-transform: uppercase;\n letter-spacing: 0.5px;\n color: var(--color-text-muted);\n background: var(--color-bg-secondary);\n border-bottom: 1px solid var(--color-border-default);\n}\n\n.executions-empty {\n padding: var(--space-3);\n color: var(--color-text-muted);\n font-size: 12px;\n text-align: center;\n}\n\n.executions-item {\n display: flex;\n align-items: center;\n width: 100%;\n background: transparent;\n border: none;\n border-bottom: 1px solid var(--color-border-default);\n font-family: var(--font-mono);\n font-size: 12px;\n text-align: left;\n transition: background var(--transition-fast);\n}\n\n.executions-item:hover {\n background: var(--color-bg-tertiary);\n}\n\n.executions-item:last-child {\n border-bottom: none;\n}\n\n.executions-item-main {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n flex: 1;\n min-width: 0;\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: none;\n font-family: inherit;\n font-size: inherit;\n text-align: left;\n cursor: pointer;\n overflow: hidden;\n}\n\n.executions-item-stop {\n padding: var(--space-1) var(--space-2);\n margin-right: var(--space-2);\n background: transparent;\n border: 1px solid var(--color-border-default);\n color: var(--color-text-muted);\n cursor: pointer;\n opacity: 0;\n transition: all var(--transition-fast);\n font-size: 11px;\n border-radius: var(--border-radius-sm);\n font-family: inherit;\n flex-shrink: 0;\n}\n\n.executions-item:hover .executions-item-stop {\n opacity: 1;\n}\n\n.executions-item-stop:hover {\n color: var(--color-text-primary);\n border-color: var(--color-border-focus);\n}\n\n.executions-item-stop.confirming {\n opacity: 1;\n color: #ef4444;\n background: rgba(239, 68, 68, 0.1);\n border-color: rgba(239, 68, 68, 0.3);\n font-weight: 500;\n}\n\n/* For execution items that are still buttons */\nbutton.executions-item {\n padding: var(--space-2) var(--space-3);\n gap: var(--space-2);\n cursor: pointer;\n}\n\n.executions-item-status {\n font-size: 16px;\n color: var(--color-accent-primary);\n animation: pulse 1.5s ease-in-out infinite;\n flex-shrink: 0;\n margin-right: var(--space-1);\n}\n\n@keyframes pulse {\n 0%, 100% { opacity: 1; }\n 50% { opacity: 0.4; }\n}\n\n/* Two-line execution item layout */\n.executions-item-info {\n display: flex;\n flex-direction: column;\n gap: 2px;\n flex: 1;\n min-width: 0;\n overflow: hidden;\n}\n\n.executions-item-title {\n color: var(--color-text-primary);\n font-size: 12px;\n font-weight: 500;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n max-width: 100%;\n}\n\n.executions-item-step {\n color: var(--color-text-muted);\n font-size: 11px;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n max-width: 100%;\n}\n\n.executions-item-status.status-checkpoint {\n color: #f59e0b;\n animation: none;\n font-size: 14px;\n}\n\n/* Modal Form */\n.modal-form {\n display: flex;\n flex-direction: column;\n gap: var(--space-4);\n}\n\n.modal-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-2);\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .header {\n padding: 0 var(--space-mobile-gutter);\n }\n\n /* Hide logo text, keep icon */\n .weft-logo-text {\n display: none;\n }\n\n /* Board selector - use static positioning */\n .header-center {\n position: static;\n transform: none;\n flex: 1;\n }\n\n .board-selector-trigger {\n padding: var(--space-2);\n min-height: var(--touch-target-min);\n }\n\n .board-selector-name {\n max-width: 140px;\n font-size: 12px;\n }\n\n /* Dropdown becomes full-width overlay */\n .board-selector-dropdown {\n position: fixed;\n top: var(--header-height);\n left: var(--space-mobile-gutter);\n right: var(--space-mobile-gutter);\n max-width: none;\n transform: none;\n max-height: calc(100vh - var(--header-height) - var(--space-8));\n max-height: calc(100dvh - var(--header-height) - var(--space-8));\n overflow-y: auto;\n }\n\n .board-selector-item {\n padding: var(--space-3);\n min-height: var(--touch-target-min);\n }\n\n /* Settings button */\n .header-settings-btn {\n min-width: var(--touch-target-min);\n min-height: var(--touch-target-min);\n padding: var(--space-2);\n }\n\n /* Executions dropdown */\n .executions-wrapper {\n margin-right: 0;\n }\n\n .executions-trigger {\n min-height: var(--touch-target-min);\n padding: var(--space-2);\n }\n\n .executions-dropdown {\n position: fixed;\n top: var(--header-height);\n left: var(--space-mobile-gutter);\n right: var(--space-mobile-gutter);\n width: auto;\n max-height: calc(100vh - var(--header-height) - var(--space-8));\n max-height: calc(100dvh - var(--header-height) - var(--space-8));\n overflow-y: auto;\n }\n\n .executions-item {\n min-height: var(--touch-target-min);\n }\n\n .executions-item-main {\n padding: var(--space-3);\n }\n\n /* Always show stop button on mobile (no hover needed) */\n .executions-item-stop {\n opacity: 1;\n min-width: var(--touch-target-min);\n min-height: 36px;\n }\n\n /* Modal form on mobile */\n .modal-form {\n gap: var(--space-3);\n }\n\n .modal-actions {\n flex-direction: column;\n gap: var(--space-2);\n }\n\n .modal-actions > * {\n width: 100%;\n }\n}\n\n/* ============================================\n User Menu\n ============================================ */\n.user-menu-wrapper {\n position: relative;\n}\n\n.user-menu-trigger {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: 4px;\n padding-right: var(--space-3);\n background: transparent;\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.user-menu-trigger:hover {\n border-color: var(--color-border-focus);\n}\n\n.user-avatar-circle {\n width: 24px;\n height: 24px;\n display: flex;\n align-items: center;\n justify-content: center;\n background: var(--color-accent-muted);\n border-radius: 50%;\n font-family: var(--font-mono);\n font-size: 11px;\n font-weight: 600;\n color: var(--color-accent-primary);\n}\n\n.user-menu-chevron {\n font-size: 10px;\n color: var(--color-text-primary);\n}\n\n.user-menu-dropdown {\n position: absolute;\n top: calc(100% + var(--space-1));\n right: 0;\n min-width: 180px;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n box-shadow: var(--shadow-lg);\n z-index: 100;\n overflow: hidden;\n}\n\n.user-menu-email {\n padding: var(--space-3);\n font-size: 12px;\n color: var(--color-text-muted);\n background: var(--color-bg-secondary);\n border-bottom: 1px solid var(--color-border-default);\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.user-menu-divider {\n height: 1px;\n background: var(--color-border-default);\n}\n\n.user-menu-item {\n display: block;\n width: 100%;\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: none;\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-primary);\n text-align: left;\n cursor: pointer;\n transition: background var(--transition-fast);\n}\n\n.user-menu-item:hover {\n background: var(--color-bg-tertiary);\n}\n\n.user-menu-signout {\n color: #ef4444;\n}\n\n.user-menu-signout:hover {\n background: rgba(239, 68, 68, 0.1);\n}\n\n/* Mobile user menu */\n@media (max-width: 767px) {\n .user-menu-trigger {\n min-height: var(--touch-target-min);\n padding: var(--space-2);\n padding-right: var(--space-2);\n }\n\n .user-avatar-circle {\n width: 28px;\n height: 28px;\n }\n\n .user-menu-dropdown {\n position: fixed;\n top: var(--header-height);\n left: var(--space-mobile-gutter);\n right: var(--space-mobile-gutter);\n min-width: auto;\n }\n\n .user-menu-item {\n padding: var(--space-3);\n min-height: var(--touch-target-min);\n display: flex;\n align-items: center;\n }\n}\n" }, { "path": "src/components/Header/Header.tsx", "content": "import { useState, useEffect, useRef } from 'react';\nimport { useNavigate, useLocation, useSearchParams } from 'react-router-dom';\nimport { useBoard } from '../../context/BoardContext';\nimport { useAuth } from '../../context/AuthContext';\nimport { Modal, Input, Button } from '../common';\nimport { BoardSettings } from '../Settings';\nimport { WeftLogo } from './WeftLogo';\nimport * as api from '../../api/client';\nimport './Header.css';\n\nexport function Header() {\n const navigate = useNavigate();\n const location = useLocation();\n const [searchParams] = useSearchParams();\n const { boards, activeBoard, clearActiveBoard, createBoard, activeWorkflows, updateWorkflowPlan, removeWorkflowPlan } = useBoard();\n const { user, signOut } = useAuth();\n const [showBoardModal, setShowBoardModal] = useState(false);\n const [showSelector, setShowSelector] = useState(false);\n const [showSettings, setShowSettings] = useState(false);\n const [showExecutions, setShowExecutions] = useState(false);\n const [showUserMenu, setShowUserMenu] = useState(false);\n const [newBoardName, setNewBoardName] = useState('');\n const [confirmingCancel, setConfirmingCancel] = useState(null);\n const dropdownRef = useRef(null);\n const executionsRef = useRef(null);\n const userMenuRef = useRef(null);\n\n const isHome = location.pathname === '/';\n\n useEffect(() => {\n const githubConnected = searchParams.get('github');\n const githubError = searchParams.get('github_error');\n if ((githubConnected === 'connected' || githubError) && activeBoard) {\n setShowSettings(true);\n }\n }, [searchParams, activeBoard]);\n\n useEffect(() => {\n const handleClickOutside = (event: MouseEvent) => {\n if (dropdownRef.current && !dropdownRef.current.contains(event.target as Node)) {\n setShowSelector(false);\n }\n if (executionsRef.current && !executionsRef.current.contains(event.target as Node)) {\n setShowExecutions(false);\n setConfirmingCancel(null);\n }\n if (userMenuRef.current && !userMenuRef.current.contains(event.target as Node)) {\n setShowUserMenu(false);\n }\n };\n\n if (showSelector || showExecutions || showUserMenu) {\n document.addEventListener('mousedown', handleClickOutside);\n }\n\n return () => {\n document.removeEventListener('mousedown', handleClickOutside);\n };\n }, [showSelector, showExecutions, showUserMenu]);\n\n const handleGoHome = () => {\n clearActiveBoard();\n navigate('/');\n };\n\n const handleCreateBoard = async () => {\n if (newBoardName.trim()) {\n const boardId = await createBoard(newBoardName.trim());\n setNewBoardName('');\n setShowBoardModal(false);\n if (boardId) {\n navigate(`/board/${boardId}`);\n }\n }\n };\n\n const handleSelectBoard = (boardId: string) => {\n navigate(`/board/${boardId}`);\n setShowSelector(false);\n };\n\n const handleStopWorkflow = async (e: React.MouseEvent, workflowId: string) => {\n e.stopPropagation();\n if (confirmingCancel === workflowId && activeBoard) {\n const result = await api.cancelWorkflow(activeBoard.id, workflowId);\n if (result.success && result.data) {\n updateWorkflowPlan(result.data);\n } else {\n removeWorkflowPlan(workflowId);\n }\n setConfirmingCancel(null);\n } else {\n setConfirmingCancel(workflowId);\n }\n };\n\n return (\n
\n
\n \n
\n\n
\n {!isHome && (\n
\n setShowSelector(!showSelector)}\n >\n \n {activeBoard?.name || 'Select Board'}\n \n ▼\n \n\n {showSelector && (\n
\n {boards.length === 0 ? (\n
No boards yet
\n ) : (\n boards.map((board) => (\n handleSelectBoard(board.id)}\n >\n {board.name}\n \n ))\n )}\n
\n {\n setShowSelector(false);\n setShowBoardModal(true);\n }}\n >\n + New Board\n \n
\n )}\n
\n )}\n
\n\n
\n {!isHome && activeBoard && (\n
\n setShowExecutions(!showExecutions)}\n title=\"Running agents\"\n aria-label={`Running agents: ${activeWorkflows.length}`}\n >\n ⚡\n {activeWorkflows.length}\n \n\n {showExecutions && (\n
\n
Running Agents
\n {activeWorkflows.length === 0 ? (\n
No agents running
\n ) : (\n activeWorkflows.map((workflow) => {\n const task = activeBoard?.tasks?.find((t) => t.id === workflow.taskId);\n const taskTitle = task?.title || `Task ${workflow.taskId.slice(0, 8)}`;\n const currentStep = workflow.steps?.[workflow.currentStepIndex || 0];\n const isCheckpoint = workflow.status === 'checkpoint';\n const isConfirming = confirmingCancel === workflow.id;\n\n let secondaryText = '';\n if (isCheckpoint) {\n secondaryText = 'Awaiting approval';\n } else if (workflow.status === 'executing' && currentStep?.name) {\n secondaryText = currentStep.name;\n } else if (workflow.status === 'planning') {\n secondaryText = 'Starting...';\n }\n\n return (\n
\n {\n setShowExecutions(false);\n window.dispatchEvent(new CustomEvent('open-task', { detail: { taskId: workflow.taskId } }));\n }}\n >\n \n {isCheckpoint ? '⏸' : '●'}\n \n
\n {taskTitle}\n {secondaryText && (\n {secondaryText}\n )}\n
\n \n handleStopWorkflow(e, workflow.id)}\n title={isConfirming ? 'Click to confirm' : 'Stop this agent'}\n >\n {isConfirming ? 'Confirm' : 'Stop'}\n \n
\n );\n })\n )}\n
\n )}\n
\n )}\n\n {!isHome && activeBoard && (\n setShowSettings(true)}\n title=\"Board Settings\"\n >\n Settings\n \n )}\n\n {user && (\n
\n setShowUserMenu(!showUserMenu)}\n title={user.email}\n >\n \n {user.email.charAt(0).toUpperCase()}\n \n ▼\n \n\n {showUserMenu && (\n
\n
{user.email}
\n
\n {\n setShowUserMenu(false);\n signOut();\n }}\n >\n Sign Out\n \n
\n )}\n
\n )}\n
\n\n setShowBoardModal(false)}\n title=\"Create New Board\"\n width=\"sm\"\n >\n {\n e.preventDefault();\n handleCreateBoard();\n }}\n >\n
\n setNewBoardName(e.target.value)}\n autoFocus\n />\n
\n setShowBoardModal(false)}\n >\n Cancel\n \n \n
\n
\n \n \n\n setShowSettings(false)}\n />\n
\n );\n}\n" }, { "path": "src/components/Header/WeftLogo.tsx", "content": "/**\n * Weft Logo Component\n *\n * Abstract weaving-inspired logo representing interwoven threads.\n * Clean, minimal design showing the weave pattern.\n * On hover, threads subtly \"unweave\" with a smooth animation.\n */\n\ninterface WeftLogoProps {\n onClick?: () => void;\n}\n\nexport function WeftLogo({ onClick }: WeftLogoProps) {\n return (\n
\n \n {/* Woven grid pattern - 3 horizontal weft threads weaving through 3 vertical warp threads */}\n\n {/* Vertical threads (warp) - lighter/background */}\n \n \n \n\n {/* Horizontal threads (weft) - main accent, with weave breaks */}\n {/* Top row: over-under-over pattern */}\n \n \n \n\n {/* Middle row: under-over-under pattern */}\n \n \n \n\n {/* Bottom row: over-under-over pattern */}\n \n \n \n \n WEFT\n
\n );\n}\n" }, { "path": "src/components/Home/Home.css", "content": ".home {\n flex: 1;\n display: flex;\n justify-content: center;\n padding: var(--space-6);\n background: var(--color-bg-secondary);\n overflow-y: auto;\n}\n\n.home-container {\n width: 100%;\n max-width: 640px;\n}\n\n.home-header {\n display: flex;\n align-items: center;\n justify-content: space-between;\n margin-bottom: var(--space-5);\n}\n\n.home-title {\n font-size: 18px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n.home-search {\n margin-bottom: var(--space-4);\n}\n\n.home-loading {\n padding: var(--space-6);\n text-align: center;\n color: var(--color-text-muted);\n}\n\n.home-empty {\n padding: var(--space-8);\n text-align: center;\n color: var(--color-text-muted);\n background: var(--color-bg-tertiary);\n border: 1px dashed var(--color-border-default);\n border-radius: var(--border-radius);\n}\n\n.home-empty p {\n margin-bottom: var(--space-4);\n}\n\n/* Board Cards */\n.home-boards {\n display: flex;\n flex-direction: column;\n gap: 0;\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n}\n\n.home-boards .board-card:first-child {\n border-top-right-radius: var(--border-radius);\n}\n\n.home-boards .board-card:last-child {\n border-bottom-right-radius: var(--border-radius);\n}\n\n.board-card {\n position: relative;\n display: flex;\n align-items: center;\n justify-content: space-between;\n width: 100%;\n padding: var(--space-3) var(--space-4);\n background: var(--color-bg-elevated);\n border: none;\n border-left: 3px solid var(--color-accent-primary);\n border-bottom: 1px solid var(--color-border-default);\n font-family: var(--font-mono);\n text-align: left;\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.board-card:last-child {\n border-bottom: none;\n}\n\n.board-card:hover {\n border-left-color: var(--color-border-focus);\n box-shadow: var(--shadow-sm);\n background: var(--color-bg-primary);\n}\n\n.board-card-name {\n font-size: 14px;\n font-weight: 500;\n color: var(--color-text-primary);\n}\n\n.board-card-meta {\n font-size: 12px;\n color: var(--color-text-muted);\n}\n\n/* Right side of card: date + menu */\n.board-card-right {\n display: flex;\n align-items: center;\n gap: var(--space-3);\n}\n\n.board-card-menu-trigger {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 28px;\n height: 28px;\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n color: var(--color-text-muted);\n font-size: 16px;\n cursor: pointer;\n opacity: 0;\n transition: all var(--transition-fast);\n}\n\n.board-card:hover .board-card-menu-trigger {\n opacity: 1;\n}\n\n.board-card-menu-trigger:hover {\n background: var(--color-bg-secondary);\n color: var(--color-text-primary);\n}\n\n.board-card-dropdown {\n position: absolute;\n top: calc(100% + 4px);\n right: var(--space-2);\n min-width: 120px;\n background: var(--color-bg-elevated);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n box-shadow: var(--shadow-md);\n z-index: 100;\n overflow: hidden;\n}\n\n.board-card-dropdown button {\n display: block;\n width: 100%;\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: none;\n text-align: left;\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-primary);\n cursor: pointer;\n transition: background var(--transition-fast);\n}\n\n.board-card-dropdown button:hover {\n background: var(--color-bg-tertiary);\n}\n\n.board-card-dropdown button.danger {\n color: var(--color-status-error);\n}\n\n.board-card-dropdown button.danger:hover {\n background: rgba(239, 68, 68, 0.1);\n}\n\n/* Delete warning text */\n.delete-warning {\n color: var(--color-text-secondary);\n font-size: 14px;\n line-height: 1.5;\n}\n\n/* Modal form styles (shared) */\n.modal-form {\n display: flex;\n flex-direction: column;\n gap: var(--space-4);\n}\n\n.modal-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-2);\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .home {\n padding: var(--space-4) var(--space-mobile-gutter);\n }\n\n .home-container {\n max-width: 100%;\n }\n\n .home-header {\n flex-direction: column;\n align-items: flex-start;\n gap: var(--space-3);\n }\n\n .home-title {\n font-size: 20px;\n }\n\n /* Board cards - touch-friendly */\n .board-card {\n padding: var(--space-4);\n min-height: 64px;\n }\n\n .board-card:hover {\n /* Remove hover on touch */\n border-color: var(--color-border-default);\n box-shadow: none;\n }\n\n .board-card:active {\n background: var(--color-bg-tertiary);\n }\n\n .board-card-name {\n font-size: 15px;\n }\n\n /* Modal form on mobile */\n .modal-form {\n gap: var(--space-3);\n }\n\n .modal-actions {\n flex-direction: column;\n gap: var(--space-2);\n }\n\n .modal-actions > * {\n width: 100%;\n }\n}\n" }, { "path": "src/components/Home/Home.tsx", "content": "import { useState, useRef, useEffect } from 'react';\nimport { useNavigate } from 'react-router-dom';\nimport { useBoard } from '../../context/BoardContext';\nimport { Button, Modal, Input } from '../common';\nimport './Home.css';\n\nexport function Home() {\n const navigate = useNavigate();\n const { boards, createBoard, renameBoard, deleteBoard, loading } = useBoard();\n const [searchQuery, setSearchQuery] = useState('');\n const [showCreateModal, setShowCreateModal] = useState(false);\n const [newBoardName, setNewBoardName] = useState('');\n const [menuOpenId, setMenuOpenId] = useState(null);\n const [renameModalBoard, setRenameModalBoard] = useState<{ id: string; name: string } | null>(null);\n const [deleteModalBoard, setDeleteModalBoard] = useState<{ id: string; name: string } | null>(null);\n const [renameName, setRenameName] = useState('');\n const menuRef = useRef(null);\n\n // Close menu when clicking outside\n useEffect(() => {\n const handleClickOutside = (e: MouseEvent) => {\n if (menuRef.current && !menuRef.current.contains(e.target as Node)) {\n setMenuOpenId(null);\n }\n };\n document.addEventListener('mousedown', handleClickOutside);\n return () => document.removeEventListener('mousedown', handleClickOutside);\n }, []);\n\n const filteredBoards = boards.filter((board) =>\n board.name.toLowerCase().includes(searchQuery.toLowerCase())\n );\n\n const handleCreateBoard = async () => {\n if (newBoardName.trim()) {\n const boardId = await createBoard(newBoardName.trim());\n setNewBoardName('');\n setShowCreateModal(false);\n if (boardId) {\n navigate(`/board/${boardId}`);\n }\n }\n };\n\n const handleSelectBoard = (boardId: string) => {\n navigate(`/board/${boardId}`);\n };\n\n const handleRename = async () => {\n if (renameModalBoard && renameName.trim()) {\n await renameBoard(renameModalBoard.id, renameName.trim());\n setRenameModalBoard(null);\n setRenameName('');\n }\n };\n\n const handleDelete = async () => {\n if (deleteModalBoard) {\n await deleteBoard(deleteModalBoard.id);\n setDeleteModalBoard(null);\n }\n };\n\n const openRenameModal = (board: { id: string; name: string }) => {\n setRenameName(board.name);\n setRenameModalBoard(board);\n setMenuOpenId(null);\n };\n\n const openDeleteModal = (board: { id: string; name: string }) => {\n setDeleteModalBoard(board);\n setMenuOpenId(null);\n };\n\n return (\n
\n
\n
\n

> Boards

\n \n
\n\n
\n setSearchQuery(e.target.value)}\n />\n
\n\n {loading ? (\n
Loading boards...
\n ) : filteredBoards.length === 0 ? (\n
\n {searchQuery ? (\n

No boards matching \"{searchQuery}\"

\n ) : (\n <>\n

No boards yet

\n \n \n )}\n
\n ) : (\n
\n {filteredBoards.map((board) => (\n handleSelectBoard(board.id)}\n ref={menuOpenId === board.id ? menuRef : null}\n >\n {board.name}\n
\n \n {new Date(board.createdAt).toLocaleDateString()}\n \n {\n e.stopPropagation();\n setMenuOpenId(menuOpenId === board.id ? null : board.id);\n }}\n >\n ⋯\n \n
\n {menuOpenId === board.id && (\n
\n \n \n
\n )}\n
\n ))}\n
\n )}\n
\n\n setShowCreateModal(false)}\n title=\"Create New Board\"\n width=\"sm\"\n >\n {\n e.preventDefault();\n handleCreateBoard();\n }}\n >\n
\n setNewBoardName(e.target.value)}\n autoFocus\n />\n
\n setShowCreateModal(false)}\n >\n Cancel\n \n \n
\n
\n \n \n\n {/* Rename Modal */}\n setRenameModalBoard(null)}\n title=\"Rename Board\"\n width=\"sm\"\n >\n {\n e.preventDefault();\n handleRename();\n }}\n >\n
\n setRenameName(e.target.value)}\n autoFocus\n />\n
\n setRenameModalBoard(null)}\n >\n Cancel\n \n \n
\n
\n \n \n\n {/* Delete Confirmation Modal */}\n setDeleteModalBoard(null)}\n title=\"Delete Board\"\n width=\"sm\"\n >\n
\n

\n Are you sure you want to delete \"{deleteModalBoard?.name}\"? This action cannot be undone.\n

\n
\n setDeleteModalBoard(null)}\n >\n Cancel\n \n \n
\n
\n \n \n );\n}\n" }, { "path": "src/components/MCP/MCP.css", "content": "/* MCP Server List */\n.mcp-server-list {\n display: flex;\n flex-direction: column;\n gap: 12px;\n}\n\n.mcp-loading,\n.mcp-empty {\n padding: 24px;\n text-align: center;\n color: var(--color-text-secondary);\n}\n\n.mcp-empty p {\n margin: 0 0 8px;\n}\n\n.mcp-empty-hint {\n font-size: 13px;\n color: var(--color-text-tertiary);\n margin-bottom: 16px !important;\n}\n\n.mcp-error,\n.mcp-connect-error {\n padding: 8px 12px;\n background: var(--color-danger-bg);\n color: var(--color-danger);\n border-radius: 4px;\n font-size: 13px;\n}\n\n/* Server Items */\n.mcp-servers {\n display: flex;\n flex-direction: column;\n gap: 8px;\n}\n\n.mcp-server-item {\n background: var(--color-surface);\n border: 1px solid var(--color-border);\n border-radius: 6px;\n overflow: hidden;\n}\n\n.mcp-server-item.mcp-server-disabled {\n opacity: 0.6;\n}\n\n.mcp-server-header {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding: 10px 12px;\n cursor: pointer;\n transition: background 0.15s;\n}\n\n.mcp-server-header:hover {\n background: var(--color-hover);\n}\n\n.mcp-server-info {\n display: flex;\n align-items: center;\n gap: 8px;\n}\n\n.mcp-status-icon {\n width: 8px;\n height: 8px;\n border-radius: 50%;\n}\n\n.mcp-status-connected {\n background: var(--color-success);\n}\n\n.mcp-status-disconnected {\n background: var(--color-text-tertiary);\n}\n\n.mcp-status-error {\n background: var(--color-danger);\n}\n\n.mcp-server-name {\n font-weight: 500;\n color: var(--color-text);\n}\n\n.mcp-server-type {\n font-size: 12px;\n color: var(--color-text-tertiary);\n padding: 2px 6px;\n background: var(--color-hover);\n border-radius: 3px;\n}\n\n.mcp-server-actions {\n display: flex;\n align-items: center;\n gap: 8px;\n}\n\n.mcp-connect-btn,\n.mcp-toggle-btn {\n font-size: 12px;\n padding: 4px 8px;\n background: none;\n border: 1px solid var(--color-border);\n border-radius: 4px;\n color: var(--color-text-secondary);\n cursor: pointer;\n transition: all 0.15s;\n}\n\n.mcp-connect-btn:hover,\n.mcp-toggle-btn:hover {\n background: var(--color-hover);\n}\n\n.mcp-connect-btn {\n color: var(--color-primary);\n border-color: var(--color-primary);\n}\n\n.mcp-connect-btn:hover {\n background: var(--color-primary-bg);\n}\n\n.mcp-connect-btn:disabled {\n opacity: 0.6;\n cursor: not-allowed;\n}\n\n.mcp-delete-btn {\n width: 24px;\n height: 24px;\n background: none;\n border: none;\n color: var(--color-text-tertiary);\n font-size: 18px;\n cursor: pointer;\n display: flex;\n align-items: center;\n justify-content: center;\n border-radius: 4px;\n}\n\n.mcp-delete-btn:hover {\n color: var(--color-danger);\n background: var(--color-danger-bg);\n}\n\n.mcp-expand-icon {\n color: var(--color-text-tertiary);\n transition: transform 0.2s;\n}\n\n.mcp-expand-icon.expanded {\n transform: rotate(180deg);\n}\n\n/* Server Details (expanded) */\n.mcp-server-details {\n padding: 12px;\n border-top: 1px solid var(--color-border);\n background: var(--color-bg);\n}\n\n.mcp-detail-row {\n display: flex;\n gap: 8px;\n font-size: 13px;\n margin-bottom: 6px;\n}\n\n.mcp-detail-label {\n color: var(--color-text-tertiary);\n min-width: 70px;\n}\n\n.mcp-detail-value {\n color: var(--color-text-secondary);\n font-family: var(--font-mono);\n font-size: 12px;\n}\n\n/* Tools Section */\n.mcp-tools-section {\n margin-top: 12px;\n padding-top: 12px;\n border-top: 1px solid var(--color-border);\n}\n\n.mcp-tools-title {\n font-size: 12px;\n font-weight: 600;\n color: var(--color-text-secondary);\n margin: 0 0 8px;\n text-transform: uppercase;\n letter-spacing: 0.5px;\n}\n\n.mcp-tools-loading,\n.mcp-tools-empty {\n font-size: 12px;\n color: var(--color-text-tertiary);\n}\n\n.mcp-tools-list {\n list-style: none;\n padding: 0;\n margin: 0;\n display: flex;\n flex-direction: column;\n gap: 6px;\n}\n\n.mcp-tool-item {\n display: flex;\n flex-direction: column;\n gap: 2px;\n}\n\n.mcp-tool-name {\n font-size: 13px;\n font-family: var(--font-mono);\n color: var(--color-text);\n}\n\n.mcp-tool-desc {\n font-size: 12px;\n color: var(--color-text-tertiary);\n}\n\n/* Add Button */\n.mcp-add-btn {\n margin-top: 8px;\n}\n\n/* Connect Form */\n.mcp-connect-form {\n display: flex;\n flex-direction: column;\n gap: 16px;\n}\n\n.mcp-form-group {\n display: flex;\n flex-direction: column;\n gap: 6px;\n}\n\n.mcp-form-label {\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text);\n}\n\n.mcp-type-buttons {\n display: flex;\n gap: 8px;\n}\n\n.mcp-type-btn {\n flex: 1;\n display: flex;\n flex-direction: column;\n align-items: center;\n gap: 4px;\n padding: 12px;\n background: var(--color-surface);\n border: 1px solid var(--color-border);\n border-radius: 6px;\n cursor: pointer;\n transition: all 0.15s;\n font-size: 14px;\n font-weight: 500;\n color: var(--color-text);\n}\n\n.mcp-type-btn:hover {\n background: var(--color-hover);\n}\n\n.mcp-type-btn.active {\n border-color: var(--color-primary);\n background: var(--color-primary-bg);\n}\n\n.mcp-type-desc {\n font-size: 11px;\n font-weight: 400;\n color: var(--color-text-tertiary);\n}\n\n.mcp-select {\n padding: 8px 12px;\n font-size: 14px;\n background: var(--color-surface);\n border: 1px solid var(--color-border);\n border-radius: 4px;\n color: var(--color-text);\n cursor: pointer;\n}\n\n.mcp-select:focus {\n outline: none;\n border-color: var(--color-primary);\n}\n\n.mcp-connect-actions {\n display: flex;\n justify-content: flex-end;\n gap: 8px;\n margin-top: 8px;\n}\n" }, { "path": "src/components/MCP/MCPOAuthCallback.css", "content": "/* MCP OAuth Callback Page */\n.mcp-oauth-callback {\n display: flex;\n align-items: center;\n justify-content: center;\n min-height: 100vh;\n background: var(--color-bg-primary);\n padding: var(--space-4);\n}\n\n.mcp-oauth-callback-card {\n display: flex;\n flex-direction: column;\n align-items: center;\n text-align: center;\n max-width: 400px;\n padding: var(--space-6);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-lg);\n box-shadow: var(--shadow-lg);\n}\n\n.mcp-oauth-callback-card h2 {\n margin: var(--space-4) 0 var(--space-2);\n font-size: 18px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n.mcp-oauth-callback-card p {\n margin: 0;\n font-size: 14px;\n color: var(--color-text-secondary);\n}\n\n/* Spinner */\n.mcp-oauth-spinner {\n width: 40px;\n height: 40px;\n border: 3px solid var(--color-border-default);\n border-top-color: var(--color-accent-primary);\n border-radius: 50%;\n animation: mcp-oauth-spin 0.8s linear infinite;\n}\n\n@keyframes mcp-oauth-spin {\n to {\n transform: rotate(360deg);\n }\n}\n\n/* Icons */\n.mcp-oauth-icon {\n width: 48px;\n height: 48px;\n display: flex;\n align-items: center;\n justify-content: center;\n border-radius: 50%;\n}\n\n.mcp-oauth-success {\n background: rgba(34, 197, 94, 0.1);\n color: #22c55e;\n}\n\n.mcp-oauth-error {\n background: rgba(239, 68, 68, 0.1);\n color: #ef4444;\n}\n\n/* Error Message */\n.mcp-oauth-error-message {\n color: #ef4444 !important;\n margin-bottom: var(--space-4) !important;\n}\n\n/* Retry Button */\n.mcp-oauth-retry-button {\n padding: var(--space-2) var(--space-4);\n background: var(--color-bg-tertiary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n color: var(--color-text-primary);\n font-size: 14px;\n font-weight: 500;\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.mcp-oauth-retry-button:hover {\n background: var(--color-bg-secondary);\n border-color: var(--color-border-emphasis);\n}\n" }, { "path": "src/components/MCP/MCPOAuthCallback.tsx", "content": "/**\n * MCPOAuthCallback - Handles OAuth callback for MCP server authentication\n *\n * After the user authorizes with the OAuth provider, they are redirected back\n * to this component with an authorization code. We exchange the code for tokens\n * and redirect back to the board.\n */\n\nimport { useEffect, useState, useRef } from 'react';\nimport { useNavigate, useSearchParams } from 'react-router-dom';\nimport * as api from '../../api/client';\nimport './MCPOAuthCallback.css';\n\nexport function MCPOAuthCallback() {\n const [searchParams] = useSearchParams();\n const navigate = useNavigate();\n const [status, setStatus] = useState<'exchanging' | 'success' | 'error'>('exchanging');\n const [error, setError] = useState(null);\n const hasRun = useRef(false);\n\n useEffect(() => {\n // Prevent double-run in React Strict Mode\n if (hasRun.current) return;\n hasRun.current = true;\n\n async function exchangeCode() {\n // Get OAuth parameters from URL\n const code = searchParams.get('code');\n const state = searchParams.get('state');\n const errorParam = searchParams.get('error');\n const errorDescription = searchParams.get('error_description');\n\n // Check for OAuth error response\n if (errorParam) {\n setStatus('error');\n setError(errorDescription || errorParam);\n return;\n }\n\n if (!code || !state) {\n setStatus('error');\n setError('Missing authorization code or state');\n return;\n }\n\n // Get stored OAuth context\n const serverId = sessionStorage.getItem('mcp_oauth_server_id');\n const boardId = sessionStorage.getItem('mcp_oauth_board_id');\n const storedState = sessionStorage.getItem('mcp_oauth_state');\n\n if (!serverId || !boardId) {\n setStatus('error');\n setError('OAuth session data not found. Please try again.');\n return;\n }\n\n // Validate state matches\n if (state !== storedState) {\n setStatus('error');\n setError('Invalid state parameter. This may be a security issue.');\n return;\n }\n\n // Exchange code for tokens\n const redirectUri = `${window.location.origin}/mcp/oauth/callback`;\n const result = await api.exchangeMCPOAuthCode(boardId, serverId, code, state, redirectUri);\n\n // Clear stored OAuth context only after exchange attempt\n sessionStorage.removeItem('mcp_oauth_server_id');\n sessionStorage.removeItem('mcp_oauth_board_id');\n sessionStorage.removeItem('mcp_oauth_state');\n\n if (!result.success) {\n setStatus('error');\n setError(result.error?.message || 'Failed to exchange authorization code');\n return;\n }\n\n setStatus('success');\n\n // Redirect back to board after a short delay\n setTimeout(() => {\n navigate(`/board/${boardId}?mcp_connected=true`);\n }, 1500);\n }\n\n exchangeCode();\n }, [searchParams, navigate]);\n\n return (\n
\n
\n {status === 'exchanging' && (\n <>\n
\n

Completing Authentication

\n

Please wait while we complete the OAuth authorization...

\n \n )}\n\n {status === 'success' && (\n <>\n
\n \n \n \n
\n

Connected Successfully

\n

Your MCP server has been authenticated. Redirecting...

\n \n )}\n\n {status === 'error' && (\n <>\n
\n \n \n \n \n \n
\n

Authentication Failed

\n

{error}

\n navigate(-1)}\n >\n Go Back\n \n \n )}\n
\n
\n );\n}\n" }, { "path": "src/components/MCP/MCPServerConnect.css", "content": "/* MCP Server Connect Form */\n.mcp-form {\n display: flex;\n flex-direction: column;\n gap: var(--space-3);\n}\n\n.mcp-form-error {\n padding: var(--space-2) var(--space-3);\n background: rgba(239, 68, 68, 0.1);\n border: 1px solid rgba(239, 68, 68, 0.3);\n border-radius: var(--border-radius);\n color: #ef4444;\n font-size: 13px;\n}\n\n.mcp-form-status {\n padding: var(--space-2) var(--space-3);\n background: rgba(59, 130, 246, 0.1);\n border: 1px solid rgba(59, 130, 246, 0.3);\n border-radius: var(--border-radius);\n color: #3b82f6;\n font-size: 13px;\n}\n\n.mcp-form-field {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n}\n\n.mcp-form-label {\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-primary);\n}\n\n.mcp-form-hint {\n font-size: 11px;\n color: var(--color-text-muted);\n}\n\n/* Type Toggle */\n.mcp-type-toggle {\n display: flex;\n background: var(--color-bg-tertiary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n padding: 2px;\n}\n\n.mcp-type-option {\n flex: 1;\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: none;\n border-radius: calc(var(--border-radius) - 2px);\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-muted);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.mcp-type-option:hover:not(.active) {\n color: var(--color-text-primary);\n}\n\n.mcp-type-option.active {\n background: var(--color-bg-secondary);\n color: var(--color-text-primary);\n box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05);\n}\n\n/* Select */\n.mcp-form-select {\n padding: var(--space-2) var(--space-3);\n font-size: 13px;\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n color: var(--color-text-primary);\n cursor: pointer;\n transition: border-color var(--transition-fast);\n}\n\n.mcp-form-select:hover {\n border-color: var(--color-border-emphasis);\n}\n\n.mcp-form-select:focus {\n outline: none;\n border-color: var(--color-accent-primary);\n}\n\n/* Actions */\n.mcp-form-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-2);\n}\n" }, { "path": "src/components/MCP/MCPServerConnect.tsx", "content": "import { useState } from 'react';\nimport { Modal, Input, Button } from '../common';\nimport type { MCPServer } from '../../types';\nimport * as api from '../../api/client';\nimport './MCPServerConnect.css';\n\ninterface MCPServerConnectProps {\n boardId: string;\n onClose: () => void;\n onServerAdded: (server: MCPServer) => void;\n inline?: boolean;\n}\n\ntype TransportType = 'streamable-http' | 'sse';\n\nexport function MCPServerConnect({ boardId, onClose, onServerAdded, inline }: MCPServerConnectProps) {\n const [name, setName] = useState('');\n const [endpoint, setEndpoint] = useState('');\n const [transportType, setTransportType] = useState('streamable-http');\n const [saving, setSaving] = useState(false);\n const [error, setError] = useState(null);\n const [statusMessage, setStatusMessage] = useState(null);\n\n const startOAuthFlow = async (server: MCPServer) => {\n setStatusMessage('Discovering OAuth endpoints...');\n\n const discoverResult = await api.discoverMCPOAuth(boardId, server.id);\n if (!discoverResult.success) {\n return { success: false, error: discoverResult.error?.message || 'OAuth discovery failed' };\n }\n\n setStatusMessage('Redirecting to authorization...');\n\n const redirectUri = `${window.location.origin}/mcp/oauth/callback`;\n const urlResult = await api.getMCPOAuthUrl(boardId, server.id, redirectUri);\n\n if (!urlResult.success || !urlResult.data?.url) {\n return { success: false, error: urlResult.error?.message || 'Failed to get authorization URL' };\n }\n\n // Store server ID for callback\n sessionStorage.setItem('mcp_oauth_server_id', server.id);\n sessionStorage.setItem('mcp_oauth_board_id', boardId);\n sessionStorage.setItem('mcp_oauth_state', urlResult.data.state);\n\n // Redirect to OAuth authorization\n window.location.href = urlResult.data.url;\n return { success: true };\n };\n\n const handleSubmit = async (e: React.FormEvent) => {\n e.preventDefault();\n if (!name.trim() || !endpoint.trim()) return;\n\n setSaving(true);\n setError(null);\n setStatusMessage(null);\n\n // Create the MCP server (start with no auth)\n setStatusMessage('Creating server...');\n const result = await api.createMCPServer(boardId, {\n name: name.trim(),\n type: 'remote',\n endpoint: endpoint.trim(),\n authType: 'none',\n transportType,\n });\n\n if (!result.success || !result.data) {\n setError(result.error?.message || 'Failed to add MCP server');\n setSaving(false);\n return;\n }\n\n const server = result.data;\n\n // Try connecting without auth first\n setStatusMessage('Connecting...');\n const connectResult = await api.connectMCPServer(boardId, server.id);\n\n if (connectResult.success) {\n // Connected without auth\n server.status = 'connected';\n onServerAdded(server);\n return;\n }\n\n // Connection failed - try OAuth\n setStatusMessage('Authentication required, trying OAuth...');\n\n // Update server to OAuth auth type\n await api.updateMCPServer(boardId, server.id, { authType: 'oauth' });\n server.authType = 'oauth';\n\n const oauthResult = await startOAuthFlow(server);\n if (!oauthResult.success) {\n // OAuth also failed - show error but keep server (user can retry)\n setError(`Connection failed: ${connectResult.error?.message || 'Unknown error'}. OAuth also failed: ${oauthResult.error}`);\n setSaving(false);\n onServerAdded(server); // Add anyway so user can see it and retry\n }\n };\n\n const formContent = (\n
\n {error &&
{error}
}\n {statusMessage &&
{statusMessage}
}\n\n setName(e.target.value)}\n autoFocus\n />\n\n setEndpoint(e.target.value)}\n />\n\n
\n \n setTransportType(e.target.value as TransportType)}\n >\n \n \n \n \n {transportType === 'streamable-http'\n ? 'Current MCP standard - POST to /mcp endpoint'\n : 'Deprecated - GET /sse then POST to returned endpoint'}\n \n
\n\n
\n \n \n {saving ? 'Connecting...' : 'Add Server'}\n \n
\n \n );\n\n if (inline) {\n return formContent;\n }\n\n return (\n \n {formContent}\n \n );\n}\n" }, { "path": "src/components/MCP/index.ts", "content": "export { MCPServerConnect } from './MCPServerConnect';\nexport { MCPOAuthCallback } from './MCPOAuthCallback';\n" }, { "path": "src/components/Settings/AccountsSection.css", "content": ".accounts-section {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.account-card {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n transition: border-color var(--transition-fast);\n}\n\n.account-card.connected {\n border-color: var(--color-success);\n border-color: rgba(34, 197, 94, 0.3);\n}\n\n.account-card-left {\n display: flex;\n align-items: center;\n gap: var(--space-3);\n min-width: 0;\n}\n\n.account-card-icon {\n width: 20px;\n height: 20px;\n display: flex;\n align-items: center;\n justify-content: center;\n flex-shrink: 0;\n}\n\n.account-card-icon svg {\n width: 18px;\n height: 18px;\n}\n\n.account-card-info {\n display: flex;\n flex-direction: column;\n gap: 2px;\n min-width: 0;\n}\n\n.account-card-name {\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-primary);\n}\n\n.account-card-meta {\n font-size: 11px;\n color: var(--color-text-muted);\n}\n\n.account-card.connected .account-card-meta {\n color: var(--color-success);\n}\n\n.account-card-actions {\n flex-shrink: 0;\n}\n\n.account-disconnect-btn {\n padding: 4px 8px;\n font-size: 11px;\n font-weight: 500;\n color: var(--color-text-muted);\n background: transparent;\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.account-disconnect-btn:hover {\n color: #ef4444;\n border-color: rgba(239, 68, 68, 0.5);\n background: rgba(239, 68, 68, 0.1);\n}\n\n.accounts-hint {\n margin: 0;\n padding: var(--space-2);\n font-size: 12px;\n color: var(--color-text-muted);\n font-style: italic;\n}\n" }, { "path": "src/components/Settings/AccountsSection.tsx", "content": "import { Button } from '../common';\nimport type { BoardCredential } from '../../types';\nimport './AccountsSection.css';\n\nconst ACCOUNTS = [\n {\n id: 'google',\n name: 'Google',\n credentialType: 'google_oauth',\n description: 'Gmail, Google Docs, and more',\n icon: (\n \n \n \n \n \n \n ),\n },\n {\n id: 'github',\n name: 'GitHub',\n credentialType: 'github_oauth',\n description: 'Repositories, issues, pull requests',\n icon: (\n \n \n \n ),\n },\n];\n\ninterface AccountsSectionProps {\n credentials: BoardCredential[];\n onConnect: (accountId: string) => void;\n onDisconnect: (credentialId: string) => void;\n connecting: string | null;\n}\n\nexport function AccountsSection({\n credentials,\n onConnect,\n onDisconnect,\n connecting,\n}: AccountsSectionProps) {\n const getCredential = (credentialType: string) =>\n credentials.find((c) => c.type === credentialType);\n\n const getConnectionInfo = (cred: BoardCredential) => {\n if (cred.metadata?.email) return cred.metadata.email as string;\n if (cred.metadata?.login) return cred.metadata.login as string;\n return 'Connected';\n };\n\n const hasAnyAccount = ACCOUNTS.some((account) =>\n getCredential(account.credentialType)\n );\n\n return (\n
\n {ACCOUNTS.map((account) => {\n const credential = getCredential(account.credentialType);\n const isConnecting = connecting === account.id;\n\n return (\n \n
\n
{account.icon}
\n
\n {account.name}\n \n {credential\n ? getConnectionInfo(credential)\n : account.description}\n \n
\n
\n
\n {credential ? (\n onDisconnect(credential.id)}\n title=\"Disconnect\"\n >\n Disconnect\n \n ) : (\n onConnect(account.id)}\n disabled={isConnecting}\n >\n {isConnecting ? 'Connecting...' : 'Connect'}\n \n )}\n
\n
\n );\n })}\n\n {!hasAnyAccount && (\n

\n Connect an account to enable its associated integrations\n

\n )}\n
\n );\n}\n" }, { "path": "src/components/Settings/BoardSettings.css", "content": "/* ============================================\n Board Settings - Sidebar Layout\n ============================================ */\n\n.settings-layout {\n display: flex;\n height: 100%;\n min-height: 500px;\n}\n\n/* Sidebar Navigation */\n.settings-sidebar {\n width: 200px;\n flex-shrink: 0;\n display: flex;\n flex-direction: column;\n justify-content: space-between;\n padding: var(--space-3);\n background: var(--color-bg-secondary);\n border-right: 1px solid var(--color-border-default);\n}\n\n.settings-nav {\n list-style: none;\n margin: 0;\n padding: 0;\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n}\n\n.settings-nav-danger {\n border-top: 1px solid var(--color-border-default);\n padding-top: var(--space-3);\n margin-top: auto;\n}\n\n.settings-nav-item {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n width: 100%;\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n color: var(--color-text-muted);\n font-size: 13px;\n font-weight: 500;\n text-align: left;\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.settings-nav-item:hover {\n background: var(--color-bg-tertiary);\n color: var(--color-text-primary);\n}\n\n.settings-nav-item.active {\n background: var(--color-bg-primary);\n color: var(--color-text-primary);\n}\n\n.settings-nav-item.danger {\n color: var(--color-text-muted);\n}\n\n.settings-nav-item.danger:hover {\n color: #ef4444;\n background: rgba(239, 68, 68, 0.1);\n}\n\n.settings-nav-item.danger.active {\n color: #ef4444;\n background: rgba(239, 68, 68, 0.15);\n}\n\n.settings-nav-icon {\n width: 18px;\n height: 18px;\n display: flex;\n align-items: center;\n justify-content: center;\n flex-shrink: 0;\n}\n\n.settings-nav-icon svg {\n width: 16px;\n height: 16px;\n}\n\n.settings-nav-label {\n flex: 1;\n}\n\n/* Content Area */\n.settings-content {\n flex: 1;\n padding: var(--space-5);\n overflow-y: auto;\n min-width: 0;\n}\n\n.settings-error {\n padding: var(--space-3);\n margin-bottom: var(--space-4);\n background: rgba(239, 68, 68, 0.1);\n border: 1px solid rgba(239, 68, 68, 0.3);\n border-radius: var(--border-radius);\n color: #ef4444;\n font-size: 13px;\n}\n\n/* Section Styles */\n.settings-section {\n margin-bottom: var(--space-6);\n}\n\n.settings-section:last-child {\n margin-bottom: 0;\n}\n\n.settings-section-header {\n margin-bottom: var(--space-4);\n}\n\n.settings-section-title {\n font-size: 16px;\n font-weight: 600;\n color: var(--color-text-primary);\n margin: 0 0 var(--space-1) 0;\n}\n\n.settings-section-description {\n font-size: 13px;\n color: var(--color-text-muted);\n margin: 0;\n}\n\n.settings-section-divider {\n height: 1px;\n background: var(--color-border-default);\n margin: var(--space-5) 0;\n}\n\n/* Loading State */\n.settings-loading {\n padding: var(--space-4);\n text-align: center;\n color: var(--color-text-muted);\n font-size: 13px;\n}\n\n/* Empty State */\n.settings-empty {\n display: flex;\n flex-direction: column;\n align-items: flex-start;\n gap: var(--space-3);\n padding: var(--space-4);\n background: var(--color-bg-secondary);\n border-radius: var(--border-radius);\n border: 1px dashed var(--color-border-default);\n}\n\n.settings-empty p {\n margin: 0;\n font-size: 13px;\n color: var(--color-text-muted);\n}\n\n/* Credential/Item Cards */\n.settings-card {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding: var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n margin-bottom: var(--space-2);\n}\n\n.settings-card:last-child {\n margin-bottom: 0;\n}\n\n.settings-card-left {\n display: flex;\n align-items: center;\n gap: var(--space-3);\n min-width: 0;\n}\n\n.settings-card-icon {\n width: 32px;\n height: 32px;\n display: flex;\n align-items: center;\n justify-content: center;\n flex-shrink: 0;\n background: var(--color-bg-tertiary);\n border-radius: var(--border-radius);\n}\n\n.settings-card-icon svg {\n width: 18px;\n height: 18px;\n}\n\n.settings-card-icon.github {\n color: var(--color-text-primary);\n}\n\n.settings-card-info {\n display: flex;\n flex-direction: column;\n gap: 2px;\n min-width: 0;\n}\n\n.settings-card-name {\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-primary);\n}\n\n.settings-card-meta {\n font-size: 12px;\n color: var(--color-text-muted);\n}\n\n.settings-card-actions {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n/* Form Styles */\n.settings-form {\n display: flex;\n flex-direction: column;\n gap: var(--space-3);\n padding: var(--space-4);\n background: var(--color-bg-secondary);\n border-radius: var(--border-radius);\n}\n\n.settings-form-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-2);\n}\n\n/* Text Button */\n.settings-text-btn {\n padding: var(--space-1) var(--space-2);\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n color: var(--color-text-muted);\n font-size: 12px;\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.settings-text-btn:hover {\n background: var(--color-bg-tertiary);\n color: var(--color-text-primary);\n}\n\n.settings-text-btn.danger:hover {\n background: rgba(239, 68, 68, 0.1);\n color: #ef4444;\n}\n\n/* Delete Button */\n.settings-delete-btn {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 28px;\n height: 28px;\n padding: 0;\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n color: var(--color-text-muted);\n font-size: 18px;\n cursor: pointer;\n transition: all var(--transition-fast);\n flex-shrink: 0;\n}\n\n.settings-delete-btn:hover {\n background: rgba(239, 68, 68, 0.1);\n color: #ef4444;\n}\n\n/* Danger Zone Card */\n.danger-card {\n padding: var(--space-4);\n background: rgba(239, 68, 68, 0.05);\n border: 1px solid rgba(239, 68, 68, 0.2);\n border-radius: var(--border-radius);\n}\n\n.danger-card-header {\n font-size: 14px;\n font-weight: 600;\n color: #ef4444;\n margin: 0 0 var(--space-2) 0;\n}\n\n.danger-card-description {\n font-size: 13px;\n color: var(--color-text-muted);\n margin: 0 0 var(--space-4) 0;\n}\n\n.danger-card-actions {\n display: flex;\n justify-content: flex-end;\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .settings-layout {\n flex-direction: column;\n min-height: auto;\n }\n\n .settings-sidebar {\n width: 100%;\n flex-direction: row;\n padding: var(--space-2);\n border-right: none;\n border-bottom: 1px solid var(--color-border-default);\n overflow-x: auto;\n -webkit-overflow-scrolling: touch;\n }\n\n .settings-nav {\n flex-direction: row;\n gap: var(--space-1);\n }\n\n .settings-nav-danger {\n border-top: none;\n border-left: 1px solid var(--color-border-default);\n padding-top: 0;\n padding-left: var(--space-2);\n margin-top: 0;\n margin-left: var(--space-2);\n }\n\n .settings-nav-item {\n white-space: nowrap;\n padding: var(--space-2);\n }\n\n .settings-nav-label {\n display: none;\n }\n\n .settings-nav-icon {\n width: 24px;\n height: 24px;\n }\n\n .settings-nav-icon svg {\n width: 20px;\n height: 20px;\n }\n\n .settings-content {\n padding: var(--space-4);\n }\n\n .settings-card {\n gap: var(--space-2);\n }\n\n .settings-card-actions {\n flex-shrink: 0;\n }\n}\n\n/* ============================================\n General Section - Info Grid\n ============================================ */\n\n.settings-info-grid {\n display: grid;\n grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));\n gap: var(--space-3);\n}\n\n.settings-info-item {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n padding: var(--space-3);\n background: var(--color-bg-secondary);\n border-radius: var(--border-radius);\n}\n\n.settings-info-label {\n font-size: 11px;\n font-weight: 500;\n color: var(--color-text-muted);\n text-transform: uppercase;\n letter-spacing: 0.5px;\n}\n\n.settings-info-value {\n font-size: 13px;\n color: var(--color-text-primary);\n}\n\n.settings-info-mono {\n font-family: var(--font-mono);\n font-size: 11px;\n word-break: break-all;\n}\n\n.settings-info-secondary {\n color: var(--color-text-muted);\n font-size: 12px;\n}\n\n/* ============================================\n Danger Section - Confirm Dialog\n ============================================ */\n\n.danger-confirm {\n display: flex;\n flex-direction: column;\n gap: var(--space-3);\n}\n\n.danger-confirm-text {\n font-size: 13px;\n color: var(--color-text-primary);\n margin: 0;\n}\n\n.danger-confirm-text strong {\n color: #ef4444;\n}\n\n.danger-confirm-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n}\n\n/* ============================================\n Integrations Section\n ============================================ */\n\n.integrations-list {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.integration-card .settings-card-left {\n flex: 1;\n min-width: 0;\n}\n\n.settings-card-account {\n font-size: 12px;\n font-weight: 400;\n color: var(--color-text-muted);\n}\n\n/* Add Options */\n.add-options-list {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.add-option-spinner {\n width: 14px;\n height: 14px;\n border: 2px solid var(--color-border-default);\n border-top-color: var(--color-accent-primary);\n border-radius: 50%;\n animation: spin 0.8s linear infinite;\n flex-shrink: 0;\n}\n\n@keyframes spin {\n to { transform: rotate(360deg); }\n}\n\n/* Tools tooltip */\n.tools-more {\n cursor: default;\n}\n\n.tools-more .tools-tooltip {\n margin-top: -6px;\n padding: 6px 10px;\n background: var(--color-bg-tertiary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n font-size: 11px;\n color: var(--color-text-primary);\n max-width: 250px;\n box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);\n z-index: 9999;\n pointer-events: none;\n}\n\n/* Clickable integration card (button element) */\nbutton.integration-card.clickable {\n cursor: pointer;\n width: 100%;\n text-align: left;\n transition: border-color var(--transition-fast);\n font-family: inherit;\n font-size: inherit;\n line-height: inherit;\n}\n\nbutton.integration-card.clickable:hover {\n background-color: var(--color-bg-secondary);\n}\n\n.settings-card-chevron {\n width: 16px;\n height: 16px;\n color: var(--color-text-muted);\n flex-shrink: 0;\n}\n\n/* ============================================\n Detail View (Drill-down Navigation)\n ============================================ */\n\n.detail-back-btn {\n display: inline-flex;\n align-items: center;\n gap: var(--space-1);\n padding: var(--space-1) 0;\n margin-bottom: var(--space-3);\n background: none;\n border: none;\n color: var(--color-text-muted);\n font-size: 13px;\n cursor: pointer;\n transition: color var(--transition-fast);\n}\n\n.detail-back-btn:hover {\n color: var(--color-text-primary);\n}\n\n.detail-back-btn svg {\n width: 16px;\n height: 16px;\n}\n\n.detail-header {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n margin-bottom: var(--space-4);\n}\n\n.detail-title {\n margin: 0;\n font-size: 18px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n/* Add Integration card at bottom of list */\n.integration-add-card {\n border-style: dashed;\n}\n\n.integration-add-icon {\n font-size: 16px;\n font-weight: 500;\n color: var(--color-text-muted);\n}\n" }, { "path": "src/components/Settings/BoardSettings.tsx", "content": "import { useState, useEffect, useCallback } from 'react';\nimport { useSearchParams, useNavigate } from 'react-router-dom';\nimport { Modal } from '../common';\nimport { GeneralSection } from './sections/GeneralSection';\nimport { CredentialsSection } from './sections/CredentialsSection';\nimport { IntegrationsSection } from './sections/IntegrationsSection';\nimport { DangerSection } from './sections/DangerSection';\nimport { useBoard } from '../../context/BoardContext';\nimport type { BoardCredential, MCPServer } from '../../types';\nimport * as api from '../../api/client';\nimport './BoardSettings.css';\n\ntype SettingsTab = 'general' | 'credentials' | 'integrations' | 'danger';\n\nconst GEAR_ICON = (\n \n \n \n \n);\n\nconst LOCK_ICON = (\n \n \n \n \n);\n\nconst INTEGRATIONS_ICON = (\n \n \n \n \n \n \n);\n\nconst WARNING_ICON = (\n \n \n \n \n \n);\n\nconst TABS: { id: SettingsTab; label: string; icon: React.ReactNode }[] = [\n { id: 'general', label: 'General', icon: GEAR_ICON },\n { id: 'credentials', label: 'Credentials', icon: LOCK_ICON },\n { id: 'integrations', label: 'Integrations', icon: INTEGRATIONS_ICON },\n { id: 'danger', label: 'Danger Zone', icon: WARNING_ICON },\n];\n\nconst TAB_IDS = new Set(TABS.map((t) => t.id));\n\nfunction isSettingsTab(value: string): value is SettingsTab {\n return TAB_IDS.has(value);\n}\n\nconst mainTabs = TABS.filter((t) => t.id !== 'danger');\nconst dangerTab = TABS.find((t) => t.id === 'danger')!;\n\ninterface BoardSettingsProps {\n isOpen: boolean;\n onClose: () => void;\n initialTab?: string;\n}\n\nexport function BoardSettings({ isOpen, onClose, initialTab }: BoardSettingsProps) {\n const { activeBoard, renameBoard, deleteBoard } = useBoard();\n const navigate = useNavigate();\n const [searchParams, setSearchParams] = useSearchParams();\n const [activeTab, setActiveTab] = useState('general');\n const [credentials, setCredentials] = useState([]);\n const [mcpServers, setMcpServers] = useState([]);\n const [loading, setLoading] = useState(false);\n const [error, setError] = useState(null);\n const [connecting, setConnecting] = useState<'github' | 'google' | null>(null);\n\n const loadCredentials = useCallback(async () => {\n if (!activeBoard) return;\n setLoading(true);\n setError(null);\n const result = await api.getCredentials(activeBoard.id);\n if (result.success && result.data) {\n setCredentials(result.data);\n } else {\n setError(result.error?.message || 'Failed to load credentials');\n }\n setLoading(false);\n }, [activeBoard]);\n\n const loadMcpServers = useCallback(async () => {\n if (!activeBoard) return;\n const result = await api.getMCPServers(activeBoard.id);\n if (result.success && result.data) {\n setMcpServers(result.data);\n }\n }, [activeBoard]);\n\n useEffect(() => {\n const providers = [\n { key: 'github', label: 'GitHub' },\n { key: 'google', label: 'Google' },\n ];\n\n let changed = false;\n for (const { key, label } of providers) {\n if (searchParams.get(key) === 'connected') {\n if (activeBoard) loadCredentials();\n searchParams.delete(key);\n changed = true;\n }\n const errorParam = searchParams.get(`${key}_error`);\n if (errorParam) {\n setError(`${label} connection failed: ${errorParam}`);\n searchParams.delete(`${key}_error`);\n changed = true;\n }\n }\n if (changed) {\n setSearchParams(searchParams, { replace: true });\n }\n }, [searchParams, setSearchParams, activeBoard, loadCredentials]);\n\n useEffect(() => {\n if (isOpen && activeBoard) {\n setActiveTab(initialTab && isSettingsTab(initialTab) ? initialTab : 'general');\n loadCredentials();\n loadMcpServers();\n }\n }, [isOpen, activeBoard, initialTab, loadCredentials, loadMcpServers]);\n\n const handleDeleteCredential = async (credentialId: string) => {\n if (!activeBoard) return;\n\n const result = await api.deleteCredential(activeBoard.id, credentialId);\n if (result.success) {\n setCredentials((prev) => prev.filter((c) => c.id !== credentialId));\n } else {\n setError(result.error?.message || 'Failed to delete credential');\n }\n };\n\n const handleConnect = async (provider: 'github' | 'google') => {\n if (!activeBoard) return;\n\n setConnecting(provider);\n setError(null);\n\n const getUrl = provider === 'github' ? api.getGitHubOAuthUrl : api.getGoogleOAuthUrl;\n const result = await getUrl(activeBoard.id);\n\n if (result.success && result.data) {\n window.location.href = result.data.url;\n } else {\n setError(result.error?.message || `Failed to connect ${provider}`);\n setConnecting(null);\n }\n };\n\n const handleCredentialAdded = (credential: BoardCredential) => {\n setCredentials((prev) => {\n const existing = prev.findIndex((c) => c.type === credential.type);\n if (existing >= 0) {\n const updated = [...prev];\n updated[existing] = credential;\n return updated;\n }\n return [...prev, credential];\n });\n };\n\n const handleMcpServerAdded = (server: MCPServer) => {\n setMcpServers((prev) => [...prev, server]);\n };\n\n const handleMcpServerDeleted = (serverId: string) => {\n setMcpServers((prev) => prev.filter((s) => s.id !== serverId));\n };\n\n if (!activeBoard) return null;\n\n return (\n \n
\n \n\n
\n {error &&
{error}
}\n\n {activeTab === 'general' && (\n renameBoard(activeBoard.id, name)}\n />\n )}\n\n {activeTab === 'credentials' && (\n \n )}\n\n {activeTab === 'integrations' && (\n \n )}\n\n {activeTab === 'danger' && (\n {\n deleteBoard(activeBoard.id);\n onClose();\n navigate('/');\n }}\n />\n )}\n
\n
\n \n );\n}\n" }, { "path": "src/components/Settings/MCPSection.css", "content": "/* MCP List */\n.mcp-list {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n/* MCP Item */\n.mcp-item {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n}\n\n.mcp-item-left {\n display: flex;\n align-items: center;\n gap: var(--space-3);\n min-width: 0;\n}\n\n.mcp-item-icon {\n width: 20px;\n height: 20px;\n display: flex;\n align-items: center;\n justify-content: center;\n flex-shrink: 0;\n color: var(--color-text-muted);\n}\n\n.mcp-item-icon svg {\n width: 18px;\n height: 18px;\n}\n\n.mcp-item-icon.github {\n color: var(--color-text-primary);\n}\n\n.mcp-item-icon.google {\n /* Google icon uses inline SVG fills, no color override needed */\n}\n\n/* MCP Info */\n.mcp-item-info {\n display: flex;\n flex-direction: column;\n gap: 2px;\n min-width: 0;\n}\n\n.mcp-item-name {\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-primary);\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.mcp-item-account {\n font-size: 11px;\n font-weight: 400;\n color: var(--color-text-muted);\n}\n\n.mcp-item-meta {\n font-size: 11px;\n color: var(--color-text-muted);\n}\n\n/* Tools \"more\" tooltip */\n.mcp-tools-more {\n cursor: default;\n}\n\n.mcp-tools-more .mcp-tools-tooltip {\n margin-top: -6px;\n padding: 6px 10px;\n background: var(--color-bg-tertiary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n font-size: 11px;\n color: var(--color-text-primary);\n max-width: 250px;\n box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);\n z-index: 9999;\n pointer-events: none;\n}\n\n/* Delete Button */\n.mcp-item-delete {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 24px;\n height: 24px;\n padding: 0;\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n color: var(--color-text-muted);\n font-size: 18px;\n cursor: pointer;\n transition: all var(--transition-fast);\n flex-shrink: 0;\n}\n\n.mcp-item-delete:hover {\n background: rgba(239, 68, 68, 0.1);\n color: #ef4444;\n}\n\n/* Empty State */\n.mcp-empty {\n display: flex;\n flex-direction: column;\n align-items: flex-start;\n gap: var(--space-3);\n padding: var(--space-3);\n background: var(--color-bg-secondary);\n border-radius: var(--border-radius);\n}\n\n.mcp-empty p {\n margin: 0;\n font-size: 13px;\n color: var(--color-text-muted);\n}\n\n/* Add MCP Form */\n.mcp-add-form {\n display: flex;\n flex-direction: column;\n gap: var(--space-3);\n padding: var(--space-3);\n background: var(--color-bg-secondary);\n border-radius: var(--border-radius);\n}\n\n.mcp-add-form-header {\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-primary);\n}\n\n.mcp-add-form-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-2);\n}\n\n/* MCP Options */\n.mcp-options {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.mcp-option {\n display: flex;\n align-items: center;\n gap: var(--space-3);\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-tertiary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n cursor: pointer;\n transition: all var(--transition-fast);\n text-align: left;\n width: 100%;\n}\n\n.mcp-option:hover:not(:disabled) {\n border-color: var(--color-border-emphasis);\n background: var(--color-bg-primary);\n}\n\n.mcp-option:disabled {\n opacity: 0.6;\n cursor: not-allowed;\n}\n\n.mcp-option-icon {\n width: 20px;\n height: 20px;\n display: flex;\n align-items: center;\n justify-content: center;\n flex-shrink: 0;\n}\n\n.mcp-option-icon svg {\n width: 18px;\n height: 18px;\n}\n\n.mcp-option-icon.mcp {\n color: var(--color-text-muted);\n}\n\n.mcp-option-icon.github {\n color: var(--color-text-primary);\n}\n\n.mcp-option-info {\n flex: 1;\n min-width: 0;\n}\n\n.mcp-option-name {\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-primary);\n}\n\n.mcp-option-desc {\n font-size: 11px;\n color: var(--color-text-muted);\n margin-top: 1px;\n}\n\n.mcp-option-arrow {\n width: 14px;\n height: 14px;\n color: var(--color-text-muted);\n flex-shrink: 0;\n}\n\n.mcp-option-spinner {\n width: 14px;\n height: 14px;\n border: 2px solid var(--color-border-default);\n border-top-color: var(--color-accent-primary);\n border-radius: 50%;\n animation: mcp-spin 0.8s linear infinite;\n flex-shrink: 0;\n}\n\n@keyframes mcp-spin {\n to { transform: rotate(360deg); }\n}\n\n/* Add button */\n.mcp-add-btn {\n align-self: flex-start;\n}\n" }, { "path": "src/components/Settings/MCPSection.tsx", "content": "import { useState, useEffect, useCallback, useRef } from 'react';\nimport { Button } from '../common';\nimport { MCPServerConnect } from '../MCP/MCPServerConnect';\nimport { CREDENTIAL_TYPES, type BoardCredential, type MCPServer, type MCPTool } from '../../types';\nimport * as api from '../../api/client';\nimport './MCPSection.css';\n\n// Small component for the \"+N more\" with fixed tooltip\nfunction ToolsMore({ count, tools }: { count: number; tools: string[] }) {\n const ref = useRef(null);\n const [tooltipPos, setTooltipPos] = useState<{ x: number; y: number } | null>(null);\n\n return (\n {\n if (ref.current) {\n const rect = ref.current.getBoundingClientRect();\n setTooltipPos({ x: rect.left + rect.width / 2, y: rect.top });\n }\n }}\n onMouseLeave={() => setTooltipPos(null)}\n >\n +{count} more\n {tooltipPos && (\n \n {tools.join(', ')}\n \n )}\n \n );\n}\n\n/**\n * Account-based MCPs that can be added when an account is connected\n * These match the MCPs in worker/mcp/AccountMCPRegistry.ts\n */\nconst ACCOUNT_MCPS = [\n {\n accountId: 'google',\n credentialType: CREDENTIAL_TYPES.GOOGLE_OAUTH,\n mcps: [\n { id: 'gmail', name: 'Gmail', description: 'Read, send, and search emails' },\n { id: 'google-docs', name: 'Google Docs', description: 'Create and edit documents' },\n { id: 'google-sheets', name: 'Google Sheets', description: 'Create and edit spreadsheets' },\n ],\n },\n];\n\ninterface MCPSectionProps {\n boardId: string;\n credentials: BoardCredential[];\n onConnectGitHub: () => void;\n connectingGitHub: boolean;\n}\n\n// Icons\nconst GITHUB_ICON = (\n \n \n \n);\n\nconst MCP_ICON = (\n \n \n \n \n \n \n);\n\nconst GOOGLE_ICON = (\n \n \n \n \n \n \n);\n\nexport function MCPSection({\n boardId,\n credentials,\n onConnectGitHub,\n connectingGitHub,\n}: MCPSectionProps) {\n const [mcpServers, setMcpServers] = useState([]);\n const [loading, setLoading] = useState(true);\n const [showAddOptions, setShowAddOptions] = useState(false);\n const [showMCPForm, setShowMCPForm] = useState(false);\n const [serverTools, setServerTools] = useState>({});\n const [addingAccountMCP, setAddingAccountMCP] = useState(null);\n\n const loadMCPServers = useCallback(async () => {\n const result = await api.getMCPServers(boardId);\n if (result.success && result.data) {\n setMcpServers(result.data);\n result.data.forEach((server) => loadServerTools(server.id));\n }\n setLoading(false);\n }, [boardId]);\n\n // Load MCP servers on mount and when credentials change (e.g., account disconnected)\n useEffect(() => {\n loadMCPServers();\n }, [loadMCPServers, credentials]);\n\n const loadServerTools = async (serverId: string) => {\n const result = await api.getMCPServerTools(boardId, serverId);\n if (result.success && result.data) {\n setServerTools((prev) => ({ ...prev, [serverId]: result.data! }));\n }\n };\n\n const handleDeleteMCP = async (serverId: string) => {\n const result = await api.deleteMCPServer(boardId, serverId);\n if (result.success) {\n setMcpServers((prev) => prev.filter((s) => s.id !== serverId));\n }\n };\n\n const handleAddAccountMCP = async (accountId: string, mcpId: string) => {\n setAddingAccountMCP(mcpId);\n try {\n const result = await api.createAccountMCP(boardId, accountId, mcpId);\n if (result.success && result.data) {\n setMcpServers((prev) => [...prev, result.data!]);\n loadServerTools(result.data.id);\n setShowAddOptions(false);\n }\n } finally {\n setAddingAccountMCP(null);\n }\n };\n\n const getAccountInfo = (server: MCPServer): string | null => {\n if (!server.credentialId) return null;\n const cred = credentials.find((c) => c.id === server.credentialId);\n if (cred?.type === CREDENTIAL_TYPES.GOOGLE_OAUTH) {\n return cred.metadata?.email as string || null;\n }\n if (cred?.type === CREDENTIAL_TYPES.GITHUB_OAUTH) {\n const login = cred.metadata?.login as string | undefined;\n return login ? `@${login}` : null;\n }\n return null;\n };\n\n const MAX_VISIBLE_TOOLS = 2;\n\n const renderTools = (tools: string[]) => {\n if (tools.length === 0) return null;\n if (tools.length <= MAX_VISIBLE_TOOLS) return tools.join(', ');\n\n const visible = tools.slice(0, MAX_VISIBLE_TOOLS);\n const hidden = tools.slice(MAX_VISIBLE_TOOLS);\n\n return (\n <>\n {visible.join(', ')}{' '}\n \n \n );\n };\n\n const handleMCPServerAdded = (server: MCPServer) => {\n setMcpServers((prev) => [...prev, server]);\n setShowMCPForm(false);\n setShowAddOptions(false);\n loadServerTools(server.id);\n };\n\n // Get available account MCPs to add (connected account, MCP not already added)\n const getAvailableAccountMCPs = () => {\n const available: Array<{\n accountId: string;\n mcpId: string;\n name: string;\n description: string;\n }> = [];\n\n for (const account of ACCOUNT_MCPS) {\n const credential = credentials.find((c) => c.type === account.credentialType);\n if (!credential) continue;\n\n for (const mcp of account.mcps) {\n // Check if this MCP is already added\n const alreadyAdded = mcpServers.some(\n (s) => s.name === mcp.name || s.name.toLowerCase() === mcp.id\n );\n if (!alreadyAdded) {\n available.push({\n accountId: account.accountId,\n mcpId: mcp.id,\n name: mcp.name,\n description: mcp.description,\n });\n }\n }\n }\n\n return available;\n };\n\n const hasMCPs = mcpServers.length > 0;\n const availableAccountMCPs = getAvailableAccountMCPs();\n const hasGitHubMCP = mcpServers.some((s) => s.name === 'GitHub');\n const showGitHubOption = !hasGitHubMCP;\n\n // Empty state\n if (!hasMCPs && !showAddOptions && !showMCPForm) {\n return (\n
\n

No MCP servers configured

\n setShowAddOptions(true)}\n >\n + Add MCP Server\n \n
\n );\n }\n\n return (\n <>\n {/* MCP Servers list */}\n {hasMCPs && (\n
\n {!loading && mcpServers.map((server) => {\n const tools = serverTools[server.id] || [];\n const toolNames = tools.map((t) => t.name);\n const accountInfo = getAccountInfo(server);\n const isGitHub = server.name === 'GitHub';\n const isGoogle = server.name === 'Gmail' || server.name === 'Google Docs' || server.name === 'Google Sheets';\n\n return (\n
\n
\n
\n {isGitHub ? GITHUB_ICON : isGoogle ? GOOGLE_ICON : MCP_ICON}\n
\n
\n \n {server.name}\n {accountInfo && (\n ({accountInfo})\n )}\n \n \n {toolNames.length > 0\n ? renderTools(toolNames)\n : server.status}\n \n
\n
\n handleDeleteMCP(server.id)}\n title=\"Remove\"\n >\n ×\n \n
\n );\n })}\n
\n )}\n\n {/* Add MCP button */}\n {hasMCPs && !showAddOptions && !showMCPForm && (\n setShowAddOptions(true)}\n className=\"mcp-add-btn\"\n >\n + Add MCP Server\n \n )}\n\n {/* Add options */}\n {showAddOptions && !showMCPForm && (\n
\n
Add MCP Server
\n
\n {/* GitHub option */}\n {showGitHubOption && (\n \n
{GITHUB_ICON}
\n
\n
GitHub
\n
\n Repositories, issues, pull requests\n
\n
\n {connectingGitHub ? (\n \n ) : (\n \n \n \n )}\n \n )}\n\n {/* Account-based MCPs (e.g., Gmail, Google Docs) */}\n {availableAccountMCPs.map((mcp) => (\n handleAddAccountMCP(mcp.accountId, mcp.mcpId)}\n disabled={addingAccountMCP === mcp.mcpId}\n >\n
{GOOGLE_ICON}
\n
\n
{mcp.name}
\n
{mcp.description}
\n
\n {addingAccountMCP === mcp.mcpId ? (\n \n ) : (\n \n \n \n )}\n \n ))}\n\n {/* Custom MCP option */}\n setShowMCPForm(true)}\n >\n
{MCP_ICON}
\n
\n
Custom MCP Server
\n
\n Connect any MCP-compatible server\n
\n
\n \n \n \n \n
\n
\n setShowAddOptions(false)}\n >\n Cancel\n \n
\n
\n )}\n\n {/* Custom MCP Form */}\n {showMCPForm && (\n
\n {\n setShowMCPForm(false);\n setShowAddOptions(true);\n }}\n onServerAdded={handleMCPServerAdded}\n inline\n />\n
\n )}\n \n );\n}\n" }, { "path": "src/components/Settings/index.ts", "content": "export { BoardSettings } from './BoardSettings';\n" }, { "path": "src/components/Settings/sections/CredentialsSection.tsx", "content": "import { useState } from 'react';\nimport { Button, Input } from '../../common';\nimport { AccountsSection } from '../AccountsSection';\nimport { CREDENTIAL_TYPES, type BoardCredential } from '../../../types';\nimport * as api from '../../../api/client';\n\ninterface CredentialsSectionProps {\n boardId: string;\n credentials: BoardCredential[];\n loading: boolean;\n connecting: 'github' | 'google' | null;\n onConnect: (provider: 'github' | 'google') => void;\n onDeleteCredential: (credentialId: string) => void;\n onCredentialAdded: (credential: BoardCredential) => void;\n}\n\nexport function CredentialsSection({\n boardId,\n credentials,\n loading,\n connecting,\n onConnect,\n onDeleteCredential,\n onCredentialAdded,\n}: CredentialsSectionProps) {\n const [apiKeyInput, setApiKeyInput] = useState('');\n const [apiKeyName, setApiKeyName] = useState('');\n const [showApiKeyForm, setShowApiKeyForm] = useState(false);\n const [saving, setSaving] = useState(false);\n\n const anthropicKeys = credentials.filter(\n (c) => c.type === CREDENTIAL_TYPES.ANTHROPIC_API_KEY\n );\n const hasExistingKey = anthropicKeys.length > 0;\n\n function getSubmitLabel(): string {\n if (saving) return 'Saving...';\n if (hasExistingKey) return 'Replace';\n return 'Save';\n }\n\n const handleAddApiKey = async (e: React.FormEvent) => {\n e.preventDefault();\n if (!apiKeyInput.trim()) return;\n\n setSaving(true);\n\n // Delete any existing Anthropic API key first (replace behavior)\n const existingKey = credentials.find(\n (c) => c.type === CREDENTIAL_TYPES.ANTHROPIC_API_KEY\n );\n if (existingKey) {\n await api.deleteCredential(boardId, existingKey.id);\n }\n\n const result = await api.createCredential(boardId, {\n type: CREDENTIAL_TYPES.ANTHROPIC_API_KEY,\n name: apiKeyName.trim() || 'Anthropic API Key',\n value: apiKeyInput.trim(),\n });\n\n if (result.success && result.data) {\n onCredentialAdded(result.data);\n setApiKeyInput('');\n setApiKeyName('');\n setShowApiKeyForm(false);\n }\n\n setSaving(false);\n };\n\n return (\n
\n {/* Anthropic API Key Section */}\n
\n
\n

Anthropic API Key

\n

\n Required to power the AI agent for task execution\n

\n
\n\n {loading && (\n
Loading...
\n )}\n\n {!loading && !showApiKeyForm && hasExistingKey && (\n
\n
\n
\n \n \n \n \n
\n
\n {anthropicKeys[0].name}\n sk-ant-...****\n
\n
\n
\n setShowApiKeyForm(true)}\n >\n Replace\n \n onDeleteCredential(anthropicKeys[0].id)}\n title=\"Remove API key\"\n >\n ×\n \n
\n
\n )}\n\n {!loading && !showApiKeyForm && !hasExistingKey && (\n
\n

No API key configured

\n setShowApiKeyForm(true)}\n >\n + Add API Key\n \n
\n )}\n\n {!loading && showApiKeyForm && (\n
\n setApiKeyName(e.target.value)}\n />\n setApiKeyInput(e.target.value)}\n autoFocus\n />\n
\n {\n setShowApiKeyForm(false);\n setApiKeyInput('');\n setApiKeyName('');\n }}\n >\n Cancel\n \n \n {getSubmitLabel()}\n \n
\n \n )}\n
\n\n
\n\n {/* Connected Accounts Section */}\n
\n
\n

Connected Accounts

\n

\n Sign in to services that power multiple integrations\n

\n
\n\n onConnect(accountId as 'github' | 'google')}\n onDisconnect={onDeleteCredential}\n connecting={connecting}\n />\n
\n\n
\n );\n}\n" }, { "path": "src/components/Settings/sections/DangerSection.tsx", "content": "import { useState } from 'react';\nimport { Button, Input } from '../../common';\nimport type { Board } from '../../../types';\n\ninterface DangerSectionProps {\n board: Board;\n onDelete: () => void;\n}\n\nexport function DangerSection({ board, onDelete }: DangerSectionProps) {\n const [confirmText, setConfirmText] = useState('');\n const [showConfirm, setShowConfirm] = useState(false);\n\n const canDelete = confirmText === board.name;\n\n const handleDelete = () => {\n if (canDelete) {\n onDelete();\n }\n };\n\n return (\n
\n
\n
\n

\n Danger Zone\n

\n

\n Irreversible actions that affect this board\n

\n
\n\n
\n

Delete this board

\n

\n Once you delete a board, there is no going back. This will permanently delete\n the board, all its columns, tasks, and associated data.\n

\n\n {!showConfirm ? (\n
\n setShowConfirm(true)}\n >\n Delete Board\n \n
\n ) : (\n
\n

\n To confirm, type {board.name} below:\n

\n setConfirmText(e.target.value)}\n placeholder={board.name}\n autoFocus\n />\n
\n {\n setShowConfirm(false);\n setConfirmText('');\n }}\n >\n Cancel\n \n \n I understand, delete this board\n \n
\n
\n )}\n
\n
\n
\n );\n}\n" }, { "path": "src/components/Settings/sections/GeneralSection.tsx", "content": "import { useState } from 'react';\nimport { Button, Input } from '../../common';\nimport type { BoardWithDetails } from '../../../api/client';\n\ninterface GeneralSectionProps {\n board: BoardWithDetails;\n onRename: (name: string) => Promise;\n}\n\nexport function GeneralSection({ board, onRename }: GeneralSectionProps) {\n const [name, setName] = useState(board.name);\n const [saving, setSaving] = useState(false);\n const [hasChanges, setHasChanges] = useState(false);\n\n const taskCountsByColumn = board.columns\n .sort((a, b) => a.position - b.position)\n .map((column) => ({\n name: column.name,\n count: board.tasks.filter((t) => t.columnId === column.id).length,\n }));\n const totalTasks = board.tasks.length;\n\n const handleNameChange = (e: React.ChangeEvent) => {\n setName(e.target.value);\n setHasChanges(e.target.value !== board.name);\n };\n\n const handleSave = async () => {\n if (!name.trim() || name === board.name) return;\n setSaving(true);\n await onRename(name.trim());\n setSaving(false);\n setHasChanges(false);\n };\n\n return (\n
\n
\n
\n

General

\n

\n Basic settings for this board\n

\n
\n\n
\n \n\n {hasChanges && (\n
\n {\n setName(board.name);\n setHasChanges(false);\n }}\n >\n Cancel\n \n \n {saving ? 'Saving...' : 'Save Changes'}\n \n
\n )}\n
\n
\n\n
\n\n
\n
\n

Board Information

\n
\n\n
\n
\n Created\n \n {new Date(board.createdAt).toLocaleDateString()}\n \n
\n
\n Board ID\n \n {board.id}\n \n
\n
\n Tasks\n \n {totalTasks} total\n {taskCountsByColumn.length > 0 && (\n \n {' — '}\n {taskCountsByColumn.map((col, i) => (\n \n {i > 0 && ' · '}\n {col.count} {col.name}\n \n ))}\n \n )}\n \n
\n
\n
\n
\n );\n}\n" }, { "path": "src/components/Settings/sections/IntegrationsSection.tsx", "content": "import { useState, useEffect, useRef } from 'react';\nimport { MCPServerConnect } from '../../MCP/MCPServerConnect';\nimport { CREDENTIAL_TYPES, type BoardCredential, type MCPServer, type MCPTool } from '../../../types';\nimport * as api from '../../../api/client';\n\nfunction ToolsMore({ count, tools }: { count: number; tools: string[] }) {\n const ref = useRef(null);\n const [tooltipPos, setTooltipPos] = useState<{ x: number; y: number } | null>(null);\n\n return (\n {\n if (ref.current) {\n const rect = ref.current.getBoundingClientRect();\n setTooltipPos({ x: rect.left + rect.width / 2, y: rect.top });\n }\n }}\n onMouseLeave={() => setTooltipPos(null)}\n >\n +{count} more\n {tooltipPos && (\n \n {tools.join(', ')}\n \n )}\n \n );\n}\n\nconst ACCOUNT_MCPS = [\n {\n accountId: 'google',\n credentialType: CREDENTIAL_TYPES.GOOGLE_OAUTH,\n mcps: [\n { id: 'gmail', name: 'Gmail', description: 'Read, send, and search emails' },\n { id: 'google-docs', name: 'Google Docs', description: 'Create and edit documents' },\n { id: 'google-sheets', name: 'Google Sheets', description: 'Create and edit spreadsheets' },\n ],\n },\n {\n accountId: 'github',\n credentialType: CREDENTIAL_TYPES.GITHUB_OAUTH,\n mcps: [\n { id: 'github', name: 'GitHub', description: 'Repositories, issues, pull requests' },\n ],\n },\n];\n\nconst GITHUB_ICON = (\n \n \n \n);\n\nconst MCP_ICON = (\n \n \n \n \n \n \n);\n\nconst GOOGLE_ICON = (\n \n \n \n \n \n \n);\n\nconst MAX_VISIBLE_TOOLS = 3;\n\nconst GOOGLE_SERVICES = new Set(['Gmail', 'Google Docs', 'Google Sheets']);\n\nconst ACCOUNT_DESCRIPTIONS: Record = {\n github: { name: 'GitHub', description: 'Connect to add repositories, issues, pull requests' },\n google: { name: 'Google', description: 'Connect to add Gmail, Docs, Sheets' },\n};\n\nfunction AddIntegrationView({\n boardId,\n unconnectedAccounts,\n availableAccountMCPs,\n onBack,\n onConnectAccount,\n connectingAccount,\n onAddAccountMCP,\n addingAccountMCP,\n onServerAdded,\n}: {\n boardId: string;\n unconnectedAccounts: { accountId: 'github' | 'google'; name: string; description: string }[];\n availableAccountMCPs: { accountId: string; mcpId: string; name: string; description: string }[];\n onBack: () => void;\n onConnectAccount: (provider: 'github' | 'google') => void;\n connectingAccount: 'github' | 'google' | null;\n onAddAccountMCP: (accountId: string, mcpId: string) => void;\n addingAccountMCP: string | null;\n onServerAdded: (server: MCPServer) => void;\n}) {\n const [showMCPForm, setShowMCPForm] = useState(false);\n\n if (showMCPForm) {\n return (\n
\n {/* Back navigation */}\n \n\n {/* Header */}\n
\n

Custom MCP Server

\n
\n\n
\n setShowMCPForm(false)}\n onServerAdded={(server) => {\n onServerAdded(server);\n onBack();\n }}\n inline\n />\n
\n
\n );\n }\n\n return (\n
\n {/* Back navigation */}\n \n\n {/* Header */}\n
\n

Add Integration

\n
\n\n {/* Integration Options */}\n
\n
\n

\n Choose a service to connect to your board\n

\n
\n\n
\n {/* Unconnected accounts - need OAuth first */}\n {unconnectedAccounts.map((account) => (\n onConnectAccount(account.accountId)}\n disabled={connectingAccount === account.accountId}\n >\n
\n
\n {account.accountId === 'github' ? GITHUB_ICON : GOOGLE_ICON}\n
\n
\n {account.name}\n {account.description}\n
\n
\n {connectingAccount === account.accountId && (\n \n )}\n \n ))}\n\n {/* Account-based MCPs (already connected) */}\n {availableAccountMCPs.map((mcp) => (\n onAddAccountMCP(mcp.accountId, mcp.mcpId)}\n disabled={addingAccountMCP === mcp.mcpId}\n >\n
\n
\n {mcp.accountId === 'github' ? GITHUB_ICON : GOOGLE_ICON}\n
\n
\n {mcp.name}\n {mcp.description}\n
\n
\n {addingAccountMCP === mcp.mcpId && (\n \n )}\n \n ))}\n\n {/* Custom MCP option */}\n setShowMCPForm(true)}\n >\n
\n
{MCP_ICON}
\n
\n Custom MCP Server\n Connect any MCP-compatible server\n
\n
\n \n \n \n \n
\n
\n
\n );\n}\n\ninterface IntegrationsSectionProps {\n boardId: string;\n credentials: BoardCredential[];\n mcpServers: MCPServer[];\n onMcpServerAdded: (server: MCPServer) => void;\n onMcpServerDeleted: (serverId: string) => void;\n onConnectAccount: (provider: 'github' | 'google') => void;\n connectingAccount: 'github' | 'google' | null;\n}\n\nexport function IntegrationsSection({\n boardId,\n credentials,\n mcpServers,\n onMcpServerAdded,\n onMcpServerDeleted,\n onConnectAccount,\n connectingAccount,\n}: IntegrationsSectionProps) {\n const [showAddView, setShowAddView] = useState(false);\n const [serverTools, setServerTools] = useState>({});\n const [addingAccountMCP, setAddingAccountMCP] = useState(null);\n\n const loadServerTools = async (serverId: string) => {\n const result = await api.getMCPServerTools(boardId, serverId);\n if (result.success && result.data) {\n setServerTools((prev) => ({ ...prev, [serverId]: result.data! }));\n }\n };\n\n // eslint-disable-next-line react-hooks/exhaustive-deps -- only fetch tools when the server list changes\n useEffect(() => {\n mcpServers.forEach((server) => {\n if (!serverTools[server.id]) {\n loadServerTools(server.id);\n }\n });\n }, [mcpServers]);\n\n const handleDeleteMCP = async (serverId: string) => {\n const result = await api.deleteMCPServer(boardId, serverId);\n if (result.success) {\n onMcpServerDeleted(serverId);\n }\n };\n\n const handleAddAccountMCP = async (accountId: string, mcpId: string) => {\n setAddingAccountMCP(mcpId);\n try {\n const result = await api.createAccountMCP(boardId, accountId, mcpId);\n if (result.success && result.data) {\n onMcpServerAdded(result.data);\n loadServerTools(result.data.id);\n setShowAddView(false);\n }\n } finally {\n setAddingAccountMCP(null);\n }\n };\n\n const getAccountInfo = (server: MCPServer): string | null => {\n if (!server.credentialId) return null;\n const cred = credentials.find((c) => c.id === server.credentialId);\n if (cred?.type === CREDENTIAL_TYPES.GOOGLE_OAUTH) {\n return cred.metadata?.email as string || null;\n }\n if (cred?.type === CREDENTIAL_TYPES.GITHUB_OAUTH) {\n const login = cred.metadata?.login as string | undefined;\n return login ? `@${login}` : null;\n }\n return null;\n };\n\n const getServerBranding = (server: MCPServer): { iconClass: string; icon: React.ReactNode } => {\n if (server.name === 'GitHub') {\n return { iconClass: 'github', icon: GITHUB_ICON };\n }\n if (GOOGLE_SERVICES.has(server.name)) {\n return { iconClass: 'google', icon: GOOGLE_ICON };\n }\n return { iconClass: '', icon: MCP_ICON };\n };\n\n const renderTools = (tools: string[]) => {\n if (tools.length === 0) return null;\n if (tools.length <= MAX_VISIBLE_TOOLS) return tools.join(', ');\n\n const visible = tools.slice(0, MAX_VISIBLE_TOOLS);\n const hidden = tools.slice(MAX_VISIBLE_TOOLS);\n\n return (\n <>\n {visible.join(', ')}{' '}\n \n \n );\n };\n\n const handleMCPServerAdded = (server: MCPServer) => {\n onMcpServerAdded(server);\n setShowAddView(false);\n loadServerTools(server.id);\n };\n\n const getAvailableAccountMCPs = () => {\n const available: Array<{\n accountId: string;\n mcpId: string;\n name: string;\n description: string;\n }> = [];\n\n for (const account of ACCOUNT_MCPS) {\n const credential = credentials.find((c) => c.type === account.credentialType);\n if (!credential) continue;\n\n for (const mcp of account.mcps) {\n const alreadyAdded = mcpServers.some(\n (s) => s.name === mcp.name || s.name.toLowerCase() === mcp.id\n );\n if (!alreadyAdded) {\n available.push({\n accountId: account.accountId,\n mcpId: mcp.id,\n name: mcp.name,\n description: mcp.description,\n });\n }\n }\n }\n\n return available;\n };\n\n const getUnconnectedAccounts = () => {\n return ACCOUNT_MCPS\n .filter((account) => !credentials.find((c) => c.type === account.credentialType))\n .map((account) => ({\n accountId: account.accountId as 'github' | 'google',\n ...ACCOUNT_DESCRIPTIONS[account.accountId],\n }));\n };\n\n const availableAccountMCPs = getAvailableAccountMCPs();\n const unconnectedAccounts = getUnconnectedAccounts();\n\n if (showAddView) {\n return (\n setShowAddView(false)}\n onConnectAccount={onConnectAccount}\n connectingAccount={connectingAccount}\n onAddAccountMCP={handleAddAccountMCP}\n addingAccountMCP={addingAccountMCP}\n onServerAdded={handleMCPServerAdded}\n />\n );\n }\n\n return (\n
\n {/* Built-in Integrations Section */}\n
\n
\n

Built-in Integrations

\n

\n Pre-configured tool providers for common services\n

\n
\n\n
\n setShowAddView(true)}\n >\n
\n
+
\n
\n Add Integration\n
\n
\n \n\n {mcpServers.map((server) => {\n const tools = serverTools[server.id] || [];\n const toolNames = tools.map((t) => t.name);\n const accountInfo = getAccountInfo(server);\n const branding = getServerBranding(server);\n\n return (\n
\n
\n
\n {branding.icon}\n
\n
\n \n {server.name}\n {accountInfo && (\n ({accountInfo})\n )}\n \n \n {toolNames.length > 0\n ? renderTools(toolNames)\n : server.status}\n \n
\n
\n handleDeleteMCP(server.id)}\n title=\"Remove\"\n >\n ×\n \n
\n );\n })}\n\n
\n
\n
\n );\n}\n" }, { "path": "src/components/Settings/sections/index.ts", "content": "export { GeneralSection } from './GeneralSection';\nexport { CredentialsSection } from './CredentialsSection';\nexport { IntegrationsSection } from './IntegrationsSection';\nexport { DangerSection } from './DangerSection';\n" }, { "path": "src/components/Task/AgentSection.css", "content": "/* Agent Section */\n.agent-section {\n padding: var(--space-3);\n background: var(--color-bg-subtle);\n border-radius: var(--radius-md);\n border: 1px solid var(--color-border-default);\n}\n\n.agent-section-content {\n display: flex;\n align-items: center;\n gap: var(--space-4);\n}\n\n/* Button Group */\n.agent-buttons {\n display: flex;\n gap: var(--space-2);\n flex-shrink: 0;\n}\n\n/* Agent Button */\n.agent-run-button {\n flex-shrink: 0;\n display: inline-flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.agent-spinner {\n width: 14px;\n height: 14px;\n border: 2px solid rgba(255, 255, 255, 0.3);\n border-top-color: #ffffff;\n border-radius: 50%;\n animation: agent-spin 0.8s linear infinite;\n}\n\n@keyframes agent-spin {\n to { transform: rotate(360deg); }\n}\n\n/* Schedule Button */\n.agent-schedule-button {\n display: inline-flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n font-family: var(--font-mono);\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-secondary);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.agent-schedule-button:hover {\n border-color: var(--color-accent-primary);\n color: var(--color-accent-primary);\n}\n\n.agent-schedule-button.active {\n background: var(--color-accent-muted);\n border-color: var(--color-accent-primary);\n color: var(--color-accent-primary);\n}\n\n.agent-schedule-button.open {\n background: var(--color-bg-tertiary);\n}\n\n.agent-schedule-button svg {\n flex-shrink: 0;\n}\n\n.agent-schedule-summary {\n max-width: 120px;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.agent-schedule-check {\n color: var(--color-accent-primary);\n}\n\n/* Tools Area - right of buttons */\n.agent-tools-area {\n display: flex;\n flex-direction: column;\n gap: 4px;\n min-width: 0; /* Allow flex child to shrink below content size */\n}\n\n.agent-sentence {\n font-size: 13px;\n font-weight: 600;\n color: var(--color-text-primary);\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.agent-tools-list {\n display: flex;\n flex-wrap: wrap;\n gap: 12px;\n}\n\n.agent-tool {\n display: inline-flex;\n align-items: center;\n gap: 5px;\n font-size: 12px;\n color: var(--color-text-secondary);\n}\n\n.agent-tool svg {\n flex-shrink: 0;\n opacity: 0.6;\n}\n\n.agent-tool-name {\n font-weight: 400;\n}\n\n.agent-tools-loading {\n font-size: 11px;\n color: var(--color-text-muted);\n}\n\n.agent-tools-empty {\n font-size: 11px;\n color: var(--color-text-muted);\n font-style: italic;\n}\n\n.agent-tool-more {\n color: var(--color-text-muted);\n cursor: default;\n}\n\n.agent-tool-tooltip {\n margin-top: -6px;\n padding: 6px 10px;\n background: var(--color-bg-tertiary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n font-size: 11px;\n color: var(--color-text-primary);\n max-width: 250px;\n box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);\n z-index: 9999;\n pointer-events: none;\n}\n\n/* Schedule Configuration Panel */\n.agent-schedule-panel {\n margin-top: var(--space-3);\n padding-top: var(--space-3);\n border-top: 1px solid var(--color-border-default);\n display: flex;\n flex-direction: column;\n gap: var(--space-3);\n}\n\n.agent-schedule-row {\n display: flex;\n gap: var(--space-3);\n}\n\n.agent-schedule-label {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n flex: 1;\n}\n\n.agent-schedule-label > span {\n font-size: 12px;\n color: var(--color-text-muted);\n}\n\n.agent-schedule-select,\n.agent-schedule-input {\n padding: var(--space-2);\n padding-right: var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-primary);\n}\n\n.agent-schedule-select {\n padding-right: var(--space-6);\n appearance: none;\n background-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 16 16' fill='%236b7280'%3E%3Cpath d='M4.22 6.22a.75.75 0 0 1 1.06 0L8 8.94l2.72-2.72a.75.75 0 1 1 1.06 1.06l-3.25 3.25a.75.75 0 0 1-1.06 0L4.22 7.28a.75.75 0 0 1 0-1.06z'/%3E%3C/svg%3E\");\n background-repeat: no-repeat;\n background-position: right var(--space-2) center;\n}\n\n.agent-schedule-select:focus,\n.agent-schedule-input:focus {\n outline: none;\n border-color: var(--color-border-focus);\n}\n\n/* Custom time picker */\n.agent-schedule-time-picker {\n display: flex;\n align-items: center;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n overflow: hidden;\n}\n\n.agent-schedule-time-picker:focus-within {\n border-color: var(--color-border-focus);\n}\n\n.agent-schedule-time-hour,\n.agent-schedule-time-minute {\n width: 28px;\n text-align: center;\n padding: var(--space-2) 2px;\n background: transparent;\n border: none;\n border-radius: 0;\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-primary);\n}\n\n.agent-schedule-time-hour:focus,\n.agent-schedule-time-minute:focus {\n outline: none;\n background: var(--color-bg-tertiary);\n}\n\n.agent-schedule-time-period {\n padding: var(--space-2) var(--space-5) var(--space-2) var(--space-2);\n background: transparent;\n border: none;\n border-radius: 0;\n}\n\n.agent-schedule-time-period:focus {\n outline: none;\n background: var(--color-bg-tertiary);\n}\n\n.agent-schedule-time-sep {\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--color-text-muted);\n}\n\n/* Cron input */\n.agent-schedule-cron {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n}\n\n.agent-schedule-cron .agent-schedule-label {\n flex: none;\n}\n\n.agent-schedule-cron .agent-schedule-input {\n width: 100%;\n}\n\n.agent-schedule-hint {\n font-size: 11px;\n color: var(--color-text-muted);\n font-style: italic;\n}\n\n/* Days of week */\n.agent-schedule-days {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.agent-schedule-days-label {\n font-size: 12px;\n color: var(--color-text-muted);\n}\n\n.agent-schedule-days-list {\n display: flex;\n gap: var(--space-1);\n}\n\n.agent-schedule-day {\n width: 36px;\n height: 28px;\n display: flex;\n align-items: center;\n justify-content: center;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n font-family: var(--font-mono);\n font-size: 11px;\n color: var(--color-text-muted);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.agent-schedule-day:hover {\n border-color: var(--color-border-focus);\n color: var(--color-text-primary);\n}\n\n.agent-schedule-day.selected {\n background: var(--color-accent-primary);\n border-color: var(--color-accent-primary);\n color: white;\n}\n\n/* Actions row */\n.agent-schedule-actions {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding-top: var(--space-2);\n border-top: 1px solid var(--color-border-default);\n}\n\n.agent-schedule-actions-left,\n.agent-schedule-actions-right {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.agent-schedule-link {\n background: none;\n border: none;\n padding: var(--space-1) var(--space-2);\n font-family: var(--font-mono);\n font-size: 12px;\n color: var(--color-text-muted);\n cursor: pointer;\n transition: color var(--transition-fast);\n}\n\n.agent-schedule-link:hover {\n color: var(--color-accent-primary);\n}\n\n.agent-schedule-link:disabled {\n opacity: 0.5;\n cursor: not-allowed;\n}\n\n.agent-schedule-link.danger:hover {\n color: #ef4444;\n}\n\n/* Mobile styles */\n@media (max-width: 767px) {\n .agent-section-content {\n flex-direction: column;\n align-items: stretch;\n gap: var(--space-3);\n }\n\n .agent-buttons {\n flex-direction: column;\n }\n\n .agent-schedule-button {\n width: 100%;\n min-height: 44px;\n justify-content: center;\n }\n\n .agent-schedule-row {\n flex-direction: column;\n gap: var(--space-2);\n }\n\n .agent-schedule-days-list {\n flex-wrap: wrap;\n }\n\n .agent-schedule-day {\n flex: 1;\n min-width: 40px;\n min-height: 40px;\n }\n\n .agent-schedule-actions {\n flex-direction: column;\n gap: var(--space-2);\n }\n\n .agent-schedule-actions-left,\n .agent-schedule-actions-right {\n width: 100%;\n justify-content: center;\n }\n\n .agent-schedule-link {\n min-height: 44px;\n padding: var(--space-2) var(--space-3);\n font-size: 14px;\n display: inline-flex;\n align-items: center;\n }\n\n .agent-schedule-time-hour,\n .agent-schedule-time-minute {\n width: 48px;\n height: 40px;\n font-size: 16px;\n }\n\n .agent-schedule-time-period {\n height: 40px;\n font-size: 16px;\n padding: 0 var(--space-3);\n }\n\n .agent-schedule-select {\n min-height: 44px;\n font-size: 16px;\n }\n}\n" }, { "path": "src/components/Task/AgentSection.tsx", "content": "import { useState, useEffect, useMemo, useRef } from 'react';\nimport { Button, AgentIcon, McpIcon } from '../common';\nimport type { MCPServer, ScheduleConfig, Column } from '../../types';\nimport * as api from '../../api/client';\nimport './AgentSection.css';\n\ninterface AgentSectionProps {\n boardId: string;\n taskId: string;\n onRun: () => void;\n isRunning?: boolean;\n columns: Column[];\n scheduleConfig?: ScheduleConfig;\n onScheduleChange: (config: ScheduleConfig | null) => void;\n onViewHistory: () => void;\n}\n\nconst PLAYFUL_SENTENCES = [\n \"Tools at my disposal:\",\n \"I have access to:\",\n \"My toolkit includes:\",\n \"At my fingertips:\",\n \"I can tap into:\",\n \"Available to me:\",\n];\n\nfunction getIconType(name: string): 'gmail' | 'google-docs' | 'google-sheets' | 'github' | 'sandbox' | 'claude-code' | 'generic' {\n const lower = name.toLowerCase();\n if (lower === 'gmail') return 'gmail';\n if (lower === 'google docs' || lower === 'google-docs') return 'google-docs';\n if (lower === 'google sheets' || lower === 'google-sheets') return 'google-sheets';\n if (lower === 'github') return 'github';\n if (lower === 'claude code' || lower === 'claude-code') return 'claude-code';\n if (lower === 'sandbox') return 'sandbox';\n return 'generic';\n}\n\nconst BUILTIN_TOOLS = [\n { id: 'claude-code', name: 'Claude Code' },\n { id: 'sandbox', name: 'Sandbox' },\n];\n\nconst COMMON_TIMEZONES = [\n { value: 'America/Los_Angeles', label: 'Pacific Time (PT)' },\n { value: 'America/Denver', label: 'Mountain Time (MT)' },\n { value: 'America/Chicago', label: 'Central Time (CT)' },\n { value: 'America/New_York', label: 'Eastern Time (ET)' },\n { value: 'UTC', label: 'UTC' },\n { value: 'Europe/London', label: 'London (GMT/BST)' },\n { value: 'Europe/Paris', label: 'Central European (CET)' },\n { value: 'Asia/Tokyo', label: 'Japan (JST)' },\n { value: 'Asia/Shanghai', label: 'China (CST)' },\n { value: 'Australia/Sydney', label: 'Sydney (AEST)' },\n];\n\nconst DAYS_OF_WEEK = [\n { value: 0, label: 'Sun' },\n { value: 1, label: 'Mon' },\n { value: 2, label: 'Tue' },\n { value: 3, label: 'Wed' },\n { value: 4, label: 'Thu' },\n { value: 5, label: 'Fri' },\n { value: 6, label: 'Sat' },\n];\n\nfunction formatScheduleSummary(config: ScheduleConfig): string {\n if (config.frequency === 'custom' && config.cron) {\n return config.cron;\n }\n const freq = config.frequency === 'daily' ? 'Daily' : 'Weekly';\n return `${freq} at ${config.time}`;\n}\n\nfunction parse24HourTime(time: string): { hour: number; minute: number; period: 'AM' | 'PM' } {\n const [h, m] = time.split(':').map(Number);\n const period: 'AM' | 'PM' = h >= 12 ? 'PM' : 'AM';\n const hour = h === 0 ? 12 : h > 12 ? h - 12 : h;\n return { hour, minute: m, period };\n}\n\nfunction to24HourTime(hour: number, minute: number, period: 'AM' | 'PM'): string {\n let h = hour;\n if (period === 'AM' && hour === 12) h = 0;\n else if (period === 'PM' && hour !== 12) h = hour + 12;\n return `${h.toString().padStart(2, '0')}:${minute.toString().padStart(2, '0')}`;\n}\n\nexport function AgentSection({\n boardId,\n taskId,\n onRun,\n isRunning,\n columns,\n scheduleConfig,\n onScheduleChange,\n onViewHistory,\n}: AgentSectionProps) {\n const [mcpServers, setMcpServers] = useState([]);\n const [loading, setLoading] = useState(true);\n const [tooltipPos, setTooltipPos] = useState<{ x: number; y: number } | null>(null);\n const moreRef = useRef(null);\n\n const [isScheduleOpen, setIsScheduleOpen] = useState(false);\n const [frequency, setFrequency] = useState<'daily' | 'weekly' | 'custom'>(scheduleConfig?.frequency ?? 'daily');\n const [time, setTime] = useState(scheduleConfig?.time ?? '09:00');\n const [timezone, setTimezone] = useState(scheduleConfig?.timezone ?? Intl.DateTimeFormat().resolvedOptions().timeZone);\n const [daysOfWeek, setDaysOfWeek] = useState(scheduleConfig?.daysOfWeek ?? [1, 2, 3, 4, 5]);\n const [cron, setCron] = useState(scheduleConfig?.cron ?? '0 9 * * *');\n const [targetColumnId, setTargetColumnId] = useState(scheduleConfig?.targetColumnId ?? columns[0]?.id ?? '');\n const [isRunningNow, setIsRunningNow] = useState(false);\n const [hourInput, setHourInput] = useState(null);\n const [minuteInput, setMinuteInput] = useState(null);\n\n const isScheduled = scheduleConfig?.enabled;\n\n useEffect(() => {\n if (scheduleConfig) {\n setFrequency(scheduleConfig.frequency);\n setTime(scheduleConfig.time);\n setTimezone(scheduleConfig.timezone);\n if (scheduleConfig.daysOfWeek) setDaysOfWeek(scheduleConfig.daysOfWeek);\n if (scheduleConfig.cron) setCron(scheduleConfig.cron);\n setTargetColumnId(scheduleConfig.targetColumnId);\n }\n }, [scheduleConfig]);\n\n useEffect(() => {\n if (!isScheduleOpen) return;\n\n onScheduleChange({\n enabled: true,\n frequency,\n time,\n timezone,\n daysOfWeek: frequency === 'weekly' ? daysOfWeek : undefined,\n cron: frequency === 'custom' ? cron : undefined,\n targetColumnId,\n });\n }, [isScheduleOpen, frequency, time, timezone, daysOfWeek, cron, targetColumnId, onScheduleChange]);\n\n const sentence = useMemo(() => {\n return PLAYFUL_SENTENCES[Math.floor(Math.random() * PLAYFUL_SENTENCES.length)];\n }, []);\n\n useEffect(() => {\n async function loadServers() {\n const result = await api.getMCPServers(boardId);\n if (result.success && result.data) {\n setMcpServers(result.data);\n }\n setLoading(false);\n }\n loadServers();\n }, [boardId]);\n\n const allTools = [\n ...BUILTIN_TOOLS,\n ...mcpServers\n .filter(s => s.enabled)\n .map(s => ({ id: s.id, name: s.name })),\n ];\n\n const MAX_VISIBLE = isScheduled ? 2 : 3;\n const visibleTools = allTools.slice(0, MAX_VISIBLE);\n const hiddenTools = allTools.slice(MAX_VISIBLE);\n const hasMore = hiddenTools.length > 0;\n\n const handleScheduleClick = () => {\n setIsScheduleOpen(!isScheduleOpen);\n };\n\n const handleRemoveSchedule = () => {\n onScheduleChange(null);\n setIsScheduleOpen(false);\n };\n\n const handleToggleDay = (day: number) => {\n if (daysOfWeek.includes(day)) {\n setDaysOfWeek(daysOfWeek.filter(d => d !== day));\n } else {\n setDaysOfWeek([...daysOfWeek, day].sort());\n }\n };\n\n const handleRunNow = async () => {\n setIsRunningNow(true);\n try {\n await api.triggerScheduledRun(boardId, taskId);\n } finally {\n setIsRunningNow(false);\n }\n };\n\n function renderToolsList() {\n if (loading) return ...;\n if (allTools.length === 0) return No tools connected;\n\n return (\n <>\n {visibleTools.map(tool => (\n \n \n {tool.name}\n
\n ))}\n {hasMore && (\n {\n if (moreRef.current) {\n const rect = moreRef.current.getBoundingClientRect();\n setTooltipPos({ x: rect.left + rect.width / 2, y: rect.top });\n }\n }}\n onMouseLeave={() => setTooltipPos(null)}\n >\n +{hiddenTools.length} more\n {tooltipPos && (\n \n {hiddenTools.map(t => t.name).join(', ')}\n
\n )}\n \n )}\n \n );\n }\n\n return (\n
\n
\n
\n \n \n Run Now\n \n\n \n \n \n \n \n {isScheduled ? (\n {formatScheduleSummary(scheduleConfig!)}\n ) : (\n Schedule\n )}\n {isScheduled && (\n \n \n \n )}\n \n
\n\n
\n {sentence}\n
\n {renderToolsList()}\n
\n
\n
\n\n {isScheduleOpen && (\n
\n
\n \n\n {frequency !== 'custom' && (\n
\n Time\n
\n {\n setHourInput(parse24HourTime(time).hour.toString().padStart(2, '0'));\n setTimeout(() => e.target.select(), 0);\n }}\n onChange={(e) => {\n const val = e.target.value.replace(/\\D/g, '').slice(0, 2);\n setHourInput(val);\n }}\n onBlur={() => {\n const num = parseInt(hourInput || '', 10);\n const { minute, period } = parse24HourTime(time);\n if (!isNaN(num) && num >= 1 && num <= 12) {\n setTime(to24HourTime(num, minute, period));\n }\n setHourInput(null);\n }}\n className=\"agent-schedule-input agent-schedule-time-hour\"\n />\n :\n {\n setMinuteInput(parse24HourTime(time).minute.toString().padStart(2, '0'));\n setTimeout(() => e.target.select(), 0);\n }}\n onChange={(e) => {\n const val = e.target.value.replace(/\\D/g, '').slice(0, 2);\n setMinuteInput(val);\n }}\n onBlur={() => {\n const num = parseInt(minuteInput || '', 10);\n const { hour, period } = parse24HourTime(time);\n if (!isNaN(num) && num >= 0 && num <= 59) {\n setTime(to24HourTime(hour, num, period));\n }\n setMinuteInput(null);\n }}\n className=\"agent-schedule-input agent-schedule-time-minute\"\n />\n {\n const { hour, minute } = parse24HourTime(time);\n setTime(to24HourTime(hour, minute, e.target.value as 'AM' | 'PM'));\n }}\n className=\"agent-schedule-select agent-schedule-time-period\"\n >\n \n \n \n
\n
\n )}\n
\n\n {frequency === 'custom' && (\n
\n \n \n minute hour day month weekday\n \n
\n )}\n\n {frequency === 'weekly' && (\n
\n Days\n
\n {DAYS_OF_WEEK.map(({ value, label }) => (\n handleToggleDay(value)}\n >\n {label}\n \n ))}\n
\n
\n )}\n\n
\n \n\n \n
\n\n
\n
\n {isScheduled && (\n <>\n \n View History\n \n \n {isRunningNow ? 'Running...' : 'Run Now'}\n \n \n )}\n
\n
\n \n {isScheduled ? 'Remove Schedule' : 'Cancel'}\n \n
\n
\n
\n )}\n
\n );\n}\n" }, { "path": "src/components/Task/RunHistory.css", "content": ".run-history-overlay {\n position: fixed;\n top: 0;\n left: 0;\n right: 0;\n bottom: 0;\n background: rgba(0, 0, 0, 0.5);\n z-index: 1001;\n display: flex;\n justify-content: flex-end;\n cursor: default;\n}\n\n.run-history-panel {\n width: 400px;\n max-width: 100%;\n background: var(--color-bg-primary);\n border-left: 1px solid var(--color-border-default);\n display: flex;\n flex-direction: column;\n animation: slideInRight 0.2s ease-out;\n cursor: default;\n}\n\n@keyframes slideInRight {\n from {\n transform: translateX(100%);\n }\n to {\n transform: translateX(0);\n }\n}\n\n.run-history-header {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding: var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n}\n\n.run-history-header h3 {\n margin: 0;\n font-size: 14px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n.run-history-close {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 28px;\n height: 28px;\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n color: var(--color-text-muted);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.run-history-close:hover {\n background: var(--color-bg-tertiary);\n color: var(--color-text-primary);\n}\n\n.run-history-content {\n flex: 1;\n overflow-y: auto;\n padding: var(--space-2);\n}\n\n.run-history-loading,\n.run-history-error,\n.run-history-empty {\n padding: var(--space-6);\n text-align: center;\n color: var(--color-text-muted);\n font-size: 13px;\n}\n\n.run-history-error {\n color: var(--color-priority-critical);\n}\n\n.run-history-list {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n}\n\n.run-history-item {\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n overflow: hidden;\n}\n\n.run-history-item.running {\n border-color: var(--color-accent-primary);\n}\n\n.run-history-item.failed {\n border-color: var(--color-priority-critical);\n}\n\n.run-history-item-header {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-secondary);\n cursor: pointer;\n user-select: none;\n}\n\n.run-history-item-header:hover {\n background: var(--color-bg-tertiary);\n}\n\n.run-history-item-left {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.run-history-status {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 20px;\n height: 20px;\n border-radius: 50%;\n}\n\n.run-history-status.completed {\n background: rgba(34, 197, 94, 0.1);\n color: #22c55e;\n}\n\n.run-history-status.failed {\n background: rgba(239, 68, 68, 0.1);\n color: #ef4444;\n}\n\n.run-history-status.running {\n background: rgba(59, 130, 246, 0.1);\n color: #3b82f6;\n}\n\n.run-history-status.pending {\n background: var(--color-bg-tertiary);\n color: var(--color-text-muted);\n}\n\n.run-history-date {\n font-size: 12px;\n color: var(--color-text-muted);\n}\n\n.run-history-item-right {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.run-history-task-count {\n font-size: 11px;\n color: var(--color-text-muted);\n padding: var(--space-1) var(--space-2);\n background: var(--color-bg-tertiary);\n border-radius: 10px;\n}\n\n.run-history-chevron {\n color: var(--color-text-muted);\n transition: transform var(--transition-fast);\n}\n\n.run-history-chevron.expanded {\n transform: rotate(90deg);\n}\n\n.run-history-item-body {\n padding: var(--space-3);\n border-top: 1px solid var(--color-border-default);\n background: var(--color-bg-primary);\n}\n\n.run-history-summary {\n font-size: 12px;\n color: var(--color-text-muted);\n margin-bottom: var(--space-2);\n}\n\n.run-history-error-inline {\n font-size: 12px;\n color: var(--color-priority-critical);\n margin-bottom: var(--space-2);\n}\n\n.run-history-task-list {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n}\n\n.run-history-task-item {\n padding: var(--space-2);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n font-size: 12px;\n color: var(--color-text-primary);\n}\n\n.run-history-no-tasks {\n font-size: 12px;\n color: var(--color-text-muted);\n font-style: italic;\n}\n\n.run-history-delete {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 20px;\n height: 20px;\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n color: var(--color-text-muted);\n cursor: pointer;\n opacity: 0;\n transition: all var(--transition-fast);\n}\n\n.run-history-item-header:hover .run-history-delete {\n opacity: 1;\n}\n\n.run-history-delete:hover {\n background: rgba(239, 68, 68, 0.1);\n color: var(--color-priority-critical);\n}\n\n/* Spinning animation */\n@keyframes spin {\n from {\n transform: rotate(0deg);\n }\n to {\n transform: rotate(360deg);\n }\n}\n\n.spinning {\n animation: spin 1s linear infinite;\n}\n\n/* Mobile styles */\n@media (max-width: 767px) {\n .run-history-panel {\n width: 100%;\n border-left: none;\n }\n\n .run-history-header {\n min-height: 48px;\n padding: var(--space-3) var(--space-4);\n }\n\n .run-history-close {\n width: 44px;\n height: 44px;\n /* Make visible without hover on touch */\n opacity: 0.7;\n }\n\n .run-history-item-header {\n padding: var(--space-3) var(--space-4);\n min-height: 48px;\n }\n\n .run-history-delete {\n opacity: 0.6;\n width: 36px;\n height: 36px;\n }\n\n .run-history-content {\n padding-bottom: env(safe-area-inset-bottom, var(--space-4));\n }\n}\n" }, { "path": "src/components/Task/RunHistory.tsx", "content": "import { useState, useEffect, useCallback } from 'react';\nimport { createPortal } from 'react-dom';\nimport type { ScheduledRun } from '../../types';\nimport * as api from '../../api/client';\nimport './RunHistory.css';\n\ninterface RunHistoryProps {\n boardId: string;\n taskId: string;\n isOpen: boolean;\n onClose: () => void;\n}\n\nfunction formatDate(dateStr: string): string {\n const date = new Date(dateStr);\n const now = new Date();\n const diffMs = now.getTime() - date.getTime();\n const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));\n\n if (diffDays === 0) {\n return `Today at ${date.toLocaleTimeString(undefined, { hour: 'numeric', minute: '2-digit' })}`;\n } else if (diffDays === 1) {\n return `Yesterday at ${date.toLocaleTimeString(undefined, { hour: 'numeric', minute: '2-digit' })}`;\n } else if (diffDays < 7) {\n return `${diffDays} days ago`;\n } else {\n return date.toLocaleDateString(undefined, { month: 'short', day: 'numeric', year: 'numeric' });\n }\n}\n\nexport function RunHistory({ boardId, taskId, isOpen, onClose }: RunHistoryProps) {\n const [runs, setRuns] = useState([]);\n const [isLoading, setIsLoading] = useState(true);\n const [error, setError] = useState(null);\n const [expandedRunId, setExpandedRunId] = useState(null);\n\n const fetchRuns = useCallback(async () => {\n setIsLoading(true);\n setError(null);\n try {\n const result = await api.getScheduledRuns(boardId, taskId);\n if (result.success && result.data) {\n setRuns(result.data);\n } else {\n setError(result.error?.message || 'Failed to load runs');\n }\n } catch (e) {\n setError(e instanceof Error ? e.message : 'Failed to load runs');\n } finally {\n setIsLoading(false);\n }\n }, [boardId, taskId]);\n\n useEffect(() => {\n if (isOpen) {\n fetchRuns();\n }\n }, [isOpen, fetchRuns]);\n\n const handleToggleRun = (runId: string) => {\n setExpandedRunId(expandedRunId === runId ? null : runId);\n };\n\n const handleDeleteRun = async (runId: string, e: React.MouseEvent) => {\n e.stopPropagation();\n try {\n const result = await api.deleteScheduledRun(boardId, runId);\n if (result.success) {\n setRuns(prev => prev.filter(r => r.id !== runId));\n }\n } catch (err) {\n console.error('Failed to delete run:', err);\n }\n };\n\n if (!isOpen) return null;\n\n const preventDrag = (e: React.DragEvent | React.MouseEvent) => {\n e.preventDefault();\n e.stopPropagation();\n };\n\n function renderContent() {\n if (isLoading) return
Loading runs...
;\n if (error) return
{error}
;\n if (runs.length === 0) return
No runs yet
;\n\n return (\n
\n {runs.map((run) => (\n
\n handleToggleRun(run.id)}\n role=\"button\"\n tabIndex={0}\n onKeyDown={(e) => e.key === 'Enter' && handleToggleRun(run.id)}\n >\n
\n \n {run.status === 'completed' && (\n \n \n \n )}\n {run.status === 'failed' && (\n \n \n \n )}\n {(run.status === 'running' || run.status === 'pending') && (\n \n \n \n \n )}\n \n \n {formatDate(run.createdAt)}\n \n
\n
\n handleDeleteRun(run.id, e)}\n title=\"Delete run\"\n >\n \n \n \n \n {run.tasksCreated > 0 && (\n \n {run.tasksCreated} task{run.tasksCreated !== 1 ? 's' : ''}\n \n )}\n \n \n \n
\n
\n\n {expandedRunId === run.id && (\n
\n {run.error && (\n
{run.error}
\n )}\n {run.childTasksInfo && run.childTasksInfo.length > 0 ? (\n
\n {run.childTasksInfo.map((task) => (\n
\n {task.title}\n
\n ))}\n
\n ) : (\n
No tasks created
\n )}\n
\n )}\n
\n ))}\n \n );\n }\n\n return createPortal(\n e.stopPropagation()}\n onDragStart={preventDrag}\n onDragOver={preventDrag}\n onDrop={preventDrag}\n >\n
e.stopPropagation()}>\n
\n

Run History

\n \n
\n\n
\n {renderContent()}\n
\n
\n ,\n document.body\n );\n}\n" }, { "path": "src/components/Task/TaskCard.css", "content": ".task-card {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n background: var(--color-bg-elevated);\n border: 1px solid var(--color-border-default);\n border-left: 3px solid var(--color-accent-primary);\n border-radius: var(--border-radius);\n padding: var(--space-3);\n cursor: grab;\n transition: all var(--transition-fast);\n}\n\n.task-card:hover {\n border-color: var(--color-border-focus);\n box-shadow: var(--shadow-sm);\n}\n\n.task-card.dragging {\n opacity: 0.6;\n cursor: grabbing;\n box-shadow: var(--shadow-md);\n transform: rotate(2deg);\n}\n\n.task-card-header {\n display: flex;\n align-items: flex-start;\n justify-content: space-between;\n gap: var(--space-2);\n}\n\n.task-card-badges {\n display: flex;\n align-items: center;\n gap: var(--space-1);\n flex-shrink: 0;\n}\n\n.task-title {\n flex: 1;\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-primary);\n line-height: 1.4;\n}\n\n.task-description {\n font-size: 12px;\n color: var(--color-text-muted);\n line-height: 1.4;\n display: -webkit-box;\n -webkit-line-clamp: 2;\n -webkit-box-orient: vertical;\n overflow: hidden;\n}\n\n/* Schedule badge */\n.schedule-badge {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 20px;\n height: 20px;\n background: var(--color-bg-tertiary);\n border-radius: 50%;\n color: var(--color-accent-primary);\n}\n\n.task-schedule-info {\n font-size: 11px;\n color: var(--color-accent-primary);\n display: flex;\n align-items: center;\n gap: var(--space-1);\n}\n\n/* Parent task link - subtle text */\n.task-parent-link {\n font-size: 11px;\n color: var(--color-text-muted);\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n/* Scheduled task styling */\n.task-card.scheduled {\n border-left-color: var(--color-accent-primary);\n}\n\n/* Child task styling */\n.task-card.child-task {\n border-left-color: var(--color-text-muted);\n}\n\n/* Context Menu */\n.task-context-menu {\n position: fixed;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n box-shadow: var(--shadow-lg);\n z-index: 1000;\n min-width: 140px;\n padding: var(--space-1) 0;\n}\n\n.context-menu-item {\n display: block;\n width: 100%;\n padding: var(--space-2) var(--space-3);\n background: transparent;\n border: none;\n font-family: var(--font-mono);\n font-size: 12px;\n color: var(--color-text-primary);\n text-align: left;\n cursor: pointer;\n transition: background var(--transition-fast);\n}\n\n.context-menu-item:hover {\n background: var(--color-bg-tertiary);\n}\n\n.context-menu-item.danger {\n color: var(--color-priority-critical);\n}\n\n.context-menu-item.danger:hover {\n background: rgba(239, 68, 68, 0.1);\n}\n\n.context-menu-divider {\n height: 1px;\n background: var(--color-border-default);\n margin: var(--space-1) 0;\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .task-card {\n padding: var(--space-3) var(--space-4);\n min-height: 48px;\n cursor: pointer;\n flex-shrink: 0;\n }\n\n /* Remove hover state on touch devices */\n .task-card:hover {\n border-color: var(--color-border-default);\n box-shadow: none;\n }\n\n .task-card:active {\n background: var(--color-bg-tertiary);\n transform: scale(0.98);\n }\n\n .task-card.dragging {\n opacity: 0.8;\n transform: none;\n }\n\n .task-title {\n font-size: 14px;\n }\n\n .task-description {\n font-size: 13px;\n -webkit-line-clamp: 3;\n }\n\n /* Context menu becomes bottom sheet */\n .task-context-menu {\n position: fixed;\n bottom: 0;\n left: 0;\n right: 0;\n top: auto;\n border-radius: var(--border-radius) var(--border-radius) 0 0;\n padding: var(--space-2) 0 env(safe-area-inset-bottom);\n max-height: 60vh;\n animation: slideUp 0.2s ease-out;\n }\n\n @keyframes slideUp {\n from {\n opacity: 0;\n transform: translateY(100%);\n }\n to {\n opacity: 1;\n transform: translateY(0);\n }\n }\n\n .context-menu-item {\n min-height: 48px;\n padding: var(--space-3) var(--space-4);\n font-size: 15px;\n display: flex;\n align-items: center;\n }\n\n .context-menu-divider {\n margin: var(--space-2) 0;\n }\n}\n" }, { "path": "src/components/Task/TaskCard.tsx", "content": "import { useState, useEffect, useRef, type DragEvent, type MouseEvent } from 'react';\nimport type { Task, ScheduleConfig } from '../../types';\nimport { useBoard } from '../../context/BoardContext';\nimport { TaskModal } from './TaskModal';\nimport { WorkflowBadge } from '../Workflow';\nimport './TaskCard.css';\n\n/** Strip markdown syntax (pills and links) to plain text for card preview */\nfunction stripMarkdownToText(text: string): string {\n return text\n // [pill:type:title](url) -> title\n .replace(/\\[pill:[^:]+:([^\\]]+)\\]\\([^)]+\\)/g, '$1')\n // [text](url) -> text\n .replace(/\\[([^\\]]+)\\]\\([^)]+\\)/g, '$1');\n}\n\n/** Format schedule frequency for display */\nfunction formatScheduleFrequency(config: ScheduleConfig): string {\n const time = config.time;\n const timeParts = time.split(':');\n const hours = parseInt(timeParts[0], 10);\n const minutes = parseInt(timeParts[1], 10);\n const ampm = hours >= 12 ? 'pm' : 'am';\n const displayHours = hours % 12 || 12;\n const displayTime = minutes === 0\n ? `${displayHours}${ampm}`\n : `${displayHours}:${minutes.toString().padStart(2, '0')}${ampm}`;\n\n // Get short timezone\n const tz = config.timezone.split('/').pop()?.replace('_', ' ') || config.timezone;\n\n if (config.frequency === 'daily') {\n return `Daily ${displayTime} ${tz}`;\n }\n if (config.frequency === 'weekly' && config.daysOfWeek) {\n const days = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];\n const dayStr = config.daysOfWeek.map(d => days[d]).join(', ');\n return `${dayStr} ${displayTime}`;\n }\n return `${displayTime} ${tz}`;\n}\n\ninterface TaskCardProps {\n task: Task;\n index: number;\n}\n\ninterface ContextMenuState {\n isOpen: boolean;\n x: number;\n y: number;\n}\n\nexport function TaskCard({ task }: TaskCardProps) {\n const { setDragState, moveTask, getTasksByColumn, deleteTask, activeBoard, getTaskWorkflowPlan, getTaskById } = useBoard();\n\n // Get parent task name if this is a child task\n const parentTask = task.parentTaskId ? getTaskById(task.parentTaskId) : null;\n const [isDragging, setIsDragging] = useState(false);\n const [showModal, setShowModal] = useState(false);\n const [contextMenu, setContextMenu] = useState({ isOpen: false, x: 0, y: 0 });\n const contextMenuRef = useRef(null);\n\n // Get workflow from context (single source of truth)\n const workflowPlan = getTaskWorkflowPlan(task.id);\n\n // Listen for open-task events from header executions dropdown\n useEffect(() => {\n const handleOpenTask = (e: CustomEvent<{ taskId: string }>) => {\n if (e.detail.taskId === task.id) {\n setShowModal(true);\n }\n };\n\n window.addEventListener('open-task', handleOpenTask as EventListener);\n return () => {\n window.removeEventListener('open-task', handleOpenTask as EventListener);\n };\n }, [task.id]);\n\n const handleModalClose = () => {\n setShowModal(false);\n };\n\n const handleDragStart = (e: DragEvent) => {\n e.stopPropagation(); // Prevent column drag from triggering\n e.dataTransfer.setData('text/plain', task.id);\n e.dataTransfer.effectAllowed = 'move';\n setIsDragging(true);\n setDragState({\n isDragging: true,\n taskId: task.id,\n sourceColumnId: task.columnId,\n });\n };\n\n const handleDragEnd = () => {\n setIsDragging(false);\n setDragState({\n isDragging: false,\n taskId: null,\n sourceColumnId: null,\n });\n };\n\n const handleDragOver = (e: DragEvent) => {\n e.preventDefault();\n e.stopPropagation();\n };\n\n const handleDrop = async (e: DragEvent) => {\n e.preventDefault();\n e.stopPropagation();\n\n const draggedTaskId = e.dataTransfer.getData('text/plain');\n if (draggedTaskId && draggedTaskId !== task.id) {\n const tasks = getTasksByColumn(task.columnId);\n const targetIndex = tasks.findIndex((t) => t.id === task.id);\n await moveTask(draggedTaskId, task.columnId, targetIndex);\n }\n };\n\n const handleContextMenu = (e: MouseEvent) => {\n e.preventDefault();\n e.stopPropagation();\n setContextMenu({ isOpen: true, x: e.clientX, y: e.clientY });\n };\n\n const closeContextMenu = () => {\n setContextMenu({ isOpen: false, x: 0, y: 0 });\n };\n\n const handleDelete = async () => {\n closeContextMenu();\n await deleteTask(task.id);\n };\n\n const handleMoveToColumn = async (columnId: string) => {\n closeContextMenu();\n const tasksInColumn = getTasksByColumn(columnId);\n await moveTask(task.id, columnId, tasksInColumn.length);\n };\n\n // Close context menu when clicking outside\n useEffect(() => {\n const handleClickOutside = (event: globalThis.MouseEvent) => {\n if (contextMenuRef.current && !contextMenuRef.current.contains(event.target as Node)) {\n closeContextMenu();\n }\n };\n\n if (contextMenu.isOpen) {\n document.addEventListener('mousedown', handleClickOutside);\n }\n\n return () => {\n document.removeEventListener('mousedown', handleClickOutside);\n };\n }, [contextMenu.isOpen]);\n\n // Get other columns for move menu\n const otherColumns = activeBoard?.columns.filter((c) => c.id !== task.columnId) || [];\n\n return (\n <>\n setShowModal(true)}\n onContextMenu={handleContextMenu}\n >\n
\n {task.title}\n
\n {task.scheduleConfig?.enabled && (\n \n \n \n \n \n )}\n {workflowPlan && (!task.scheduleConfig?.enabled || workflowPlan.status === 'executing') && (\n \n )}\n
\n
\n {task.description && (\n {stripMarkdownToText(task.description)}\n )}\n {parentTask && (\n \n ↳ {parentTask.title}\n \n )}\n {task.scheduleConfig?.enabled && (\n \n {formatScheduleFrequency(task.scheduleConfig)}\n \n )}\n \n\n {contextMenu.isOpen && (\n \n \n {otherColumns.length > 0 && (\n <>\n
\n {otherColumns.map((column) => (\n handleMoveToColumn(column.id)}\n >\n Move to {column.name}\n \n ))}\n \n )}\n
\n \n
\n )}\n\n \n \n );\n}\n" }, { "path": "src/components/Task/TaskModal.css", "content": ".task-modal {\n display: flex;\n flex-direction: column;\n gap: var(--space-4);\n}\n\n.task-modal-form {\n display: flex;\n flex-direction: column;\n gap: var(--space-4);\n}\n\n/* Footer */\n.task-modal-footer {\n display: flex;\n justify-content: space-between;\n align-items: center;\n padding-top: var(--space-4);\n border-top: 1px solid var(--color-border-default);\n}\n\n.task-modal-footer-right {\n display: flex;\n gap: var(--space-2);\n}\n\n/* Unsaved changes hint */\n.task-modal-unsaved-hint {\n font-size: 12px;\n color: var(--color-warning-fg, #b45309);\n animation: fadeSlideIn 0.15s ease-out;\n}\n\n.task-modal-footer.has-warning {\n border-top-color: var(--color-warning-emphasis, #f59e0b);\n}\n\n/* Delete action */\n.delete-action {\n display: flex;\n gap: var(--space-2);\n overflow: hidden;\n}\n\n.delete-action > * {\n animation: fadeSlideIn 0.15s ease-out;\n}\n\n@keyframes fadeSlideIn {\n from {\n opacity: 0;\n transform: translateX(-8px);\n }\n to {\n opacity: 1;\n transform: translateX(0);\n }\n}\n\n/* Workflow output section - shows below AgentSection */\n.task-modal-workflow-output {\n margin-top: var(--space-3);\n}\n\n/* Agent Section - wrapper for AgentSection component or WorkflowProgress */\n.task-modal-agent {\n /* No padding here - AgentSection handles its own styling */\n}\n\n.task-modal-error {\n padding: var(--space-3);\n margin-bottom: var(--space-3);\n background: var(--color-danger-subtle);\n color: var(--color-danger-text);\n border-radius: var(--radius-sm);\n font-size: var(--text-sm);\n}\n\n.task-modal-execution {\n display: flex;\n flex-direction: column;\n gap: var(--space-3);\n}\n\n.task-modal-execution-actions {\n display: flex;\n gap: var(--space-2);\n justify-content: flex-end;\n}\n\n/* Workflow Section */\n.task-modal-generating {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-3);\n color: var(--color-text-muted);\n font-size: var(--text-sm);\n}\n\n.generating-spinner {\n width: 16px;\n height: 16px;\n border: 2px solid var(--color-border-default);\n border-top-color: var(--color-primary);\n border-radius: 50%;\n animation: spin 0.8s linear infinite;\n}\n\n@keyframes spin {\n to { transform: rotate(360deg); }\n}\n\n.workflow-status {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.workflow-status-label {\n font-size: var(--text-sm);\n color: var(--color-text-muted);\n}\n\n.workflow-status-value {\n padding: var(--space-1) var(--space-2);\n border-radius: var(--radius-full);\n font-size: var(--text-xs);\n font-weight: 500;\n text-transform: capitalize;\n}\n\n.workflow-status-value.planning {\n background: var(--color-info-subtle);\n color: var(--color-info-text);\n}\n\n.workflow-status-value.draft {\n background: var(--color-warning-subtle);\n color: var(--color-warning-text);\n}\n\n.workflow-status-value.approved,\n.workflow-status-value.executing {\n background: var(--color-primary-subtle);\n color: var(--color-primary);\n}\n\n.workflow-status-value.checkpoint {\n background: var(--color-warning-subtle);\n color: var(--color-warning-text);\n}\n\n.workflow-status-value.completed {\n background: var(--color-success-subtle);\n color: var(--color-success-text);\n}\n\n.workflow-status-value.failed {\n background: var(--color-danger-subtle);\n color: var(--color-danger-text);\n}\n\n.workflow-view-btn {\n margin-left: auto;\n padding: var(--space-1) var(--space-2);\n background: none;\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n font-size: var(--text-sm);\n color: var(--color-text-secondary);\n cursor: pointer;\n transition: all 0.15s ease;\n}\n\n.workflow-view-btn:hover {\n background: var(--color-bg-subtle);\n border-color: var(--color-border-emphasis);\n color: var(--color-text-primary);\n}\n\n/* Workflow Artifacts */\n.workflow-artifacts {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n margin-top: var(--space-2);\n}\n\n.workflow-artifact {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n text-decoration: none;\n color: var(--color-text-primary);\n transition: all 0.15s ease;\n}\n\n.workflow-artifact:hover {\n background: var(--color-bg-secondary);\n border-color: var(--color-primary);\n}\n\n.workflow-artifact-icon {\n font-size: var(--text-base);\n}\n\n.workflow-artifact-title {\n font-size: var(--text-sm);\n font-weight: 500;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.workflow-header {\n display: flex;\n justify-content: flex-end;\n}\n\n.workflow-dismiss {\n display: flex;\n justify-content: flex-end;\n margin-top: var(--space-2);\n}\n\n/* Inline workflow generating state */\n.workflow-generating {\n display: flex;\n align-items: center;\n justify-content: center;\n gap: var(--space-3);\n padding: var(--space-4);\n}\n\n.workflow-generating-spinner {\n width: 20px;\n height: 20px;\n border: 2px solid var(--color-border-default);\n border-top-color: var(--color-accent-primary);\n border-radius: 50%;\n animation: spin 0.8s linear infinite;\n}\n\n.workflow-generating-text {\n font-size: 13px;\n color: var(--color-text-muted);\n}\n\n/* View-specific styles */\n.task-modal.view-execution-review,\n.task-modal.view-checkpoint-review {\n height: 100%;\n}\n\n/* Checkpoint Review View */\n.checkpoint-review-view {\n display: flex;\n flex-direction: column;\n gap: var(--space-3);\n}\n\n.checkpoint-header {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.checkpoint-icon {\n font-size: 14px;\n color: #f59e0b;\n}\n\n.checkpoint-step-name {\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-primary);\n}\n\n.checkpoint-section {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n}\n\n.checkpoint-section-label {\n font-size: 10px;\n font-weight: 600;\n text-transform: uppercase;\n letter-spacing: 0.5px;\n color: var(--color-text-muted);\n}\n\n.checkpoint-artifacts {\n display: flex;\n flex-wrap: wrap;\n gap: var(--space-1);\n}\n\n.checkpoint-artifact {\n display: inline-flex;\n align-items: center;\n gap: var(--space-1);\n padding: var(--space-1) var(--space-2);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n text-decoration: none;\n color: var(--color-text-secondary);\n font-size: 11px;\n transition: all 0.15s ease;\n}\n\n.checkpoint-artifact:hover {\n background: var(--color-bg-tertiary);\n border-color: var(--color-primary);\n color: var(--color-text-primary);\n}\n\n.checkpoint-artifact svg {\n flex-shrink: 0;\n width: 12px;\n height: 12px;\n}\n\n.checkpoint-artifact-title {\n font-weight: 500;\n}\n\n.checkpoint-artifact-arrow {\n color: var(--color-text-muted);\n font-size: 10px;\n}\n\n.checkpoint-next-step {\n display: inline-flex;\n align-items: center;\n gap: var(--space-1);\n padding: var(--space-1) var(--space-2);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n font-size: 11px;\n}\n\n.checkpoint-next-name {\n color: var(--color-text-primary);\n}\n\n.checkpoint-next-server {\n font-size: 10px;\n padding: 1px 4px;\n background: var(--color-bg-tertiary);\n border-radius: var(--radius-full);\n color: var(--color-text-muted);\n}\n\n.checkpoint-action-section {\n background: var(--color-bg-secondary);\n border-radius: var(--radius-sm);\n padding: var(--space-2);\n border: 1px solid var(--color-primary);\n}\n\n.checkpoint-next-action {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-primary);\n}\n\n.checkpoint-action-icon {\n color: var(--color-primary);\n font-weight: bold;\n}\n\n.checkpoint-action-name {\n color: var(--color-text-primary);\n}\n\n.checkpoint-prepared-content {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n padding: var(--space-2);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-sm);\n max-height: 200px;\n overflow-y: auto;\n}\n\n.checkpoint-content-item {\n display: flex;\n flex-direction: column;\n gap: 2px;\n}\n\n.checkpoint-content-item + .checkpoint-content-item {\n padding-top: var(--space-2);\n border-top: 1px solid var(--color-border-subtle);\n}\n\n.checkpoint-content-label {\n font-size: 10px;\n font-weight: 600;\n text-transform: uppercase;\n letter-spacing: 0.3px;\n color: var(--color-text-muted);\n}\n\n.checkpoint-content-value {\n font-size: 12px;\n font-family: var(--font-mono);\n color: var(--color-text-secondary);\n white-space: pre-wrap;\n line-height: 1.4;\n word-break: break-word;\n}\n\n.checkpoint-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-2);\n border-top: 1px solid var(--color-border-default);\n}\n\n/* Approval UI */\n.approval-card {\n display: flex;\n flex-direction: column;\n gap: var(--space-4);\n}\n\n.approval-header {\n display: flex;\n align-items: center;\n gap: var(--space-3);\n padding-bottom: var(--space-3);\n border-bottom: 1px solid var(--color-border-default);\n}\n\n.approval-icon {\n flex-shrink: 0;\n color: var(--color-text-secondary);\n}\n\n.approval-title {\n font-size: 15px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n.approval-fields {\n display: flex;\n flex-direction: column;\n gap: var(--space-4);\n}\n\n.approval-field {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.approval-field-label {\n font-size: 12px;\n font-weight: 500;\n color: var(--color-text-secondary);\n}\n\n.approval-field-value {\n padding: var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n font-size: 13px;\n line-height: 1.5;\n color: var(--color-text-primary);\n white-space: pre-wrap;\n word-break: break-word;\n max-height: 200px;\n overflow-y: auto;\n}\n\n.approval-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-4);\n border-top: 1px solid var(--color-border-default);\n}\n\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .task-modal {\n gap: var(--space-3);\n }\n\n .task-modal-form {\n gap: var(--space-3);\n }\n\n /* Footer - reorganize for mobile */\n .task-modal-footer {\n flex-direction: column-reverse;\n gap: var(--space-3);\n padding-top: var(--space-3);\n padding-bottom: env(safe-area-inset-bottom, var(--space-4));\n }\n\n /* Cancel/Save row - side by side */\n .task-modal-footer-right {\n display: flex;\n width: 100%;\n gap: var(--space-2);\n }\n\n .task-modal-footer-right > * {\n flex: 1;\n }\n\n /* Delete at bottom, full width, less prominent */\n .delete-action {\n width: 100%;\n order: -1;\n padding-top: var(--space-2);\n border-top: 1px solid var(--color-border-subtle);\n }\n\n .delete-action > * {\n width: 100%;\n }\n\n /* Workflow section */\n .workflow-generating {\n padding: var(--space-4);\n }\n\n .workflow-status {\n flex-wrap: wrap;\n gap: var(--space-2);\n }\n\n .workflow-view-btn {\n width: 100%;\n margin-left: 0;\n margin-top: var(--space-2);\n text-align: center;\n }\n\n /* Checkpoint actions */\n .checkpoint-actions {\n flex-direction: column;\n gap: var(--space-2);\n }\n\n .checkpoint-actions > * {\n width: 100%;\n }\n\n /* Approval */\n .approval-header {\n flex-wrap: wrap;\n }\n\n .approval-title {\n font-size: 14px;\n }\n\n .approval-field-value {\n max-height: 150px;\n font-size: 14px;\n }\n\n .approval-actions {\n flex-direction: column;\n gap: var(--space-2);\n }\n\n .approval-actions > * {\n width: 100%;\n }\n\n /* Checkpoint review */\n .checkpoint-prepared-content {\n max-height: 150px;\n }\n\n .checkpoint-artifact {\n font-size: 12px;\n padding: var(--space-2);\n }\n}\n" }, { "path": "src/components/Task/TaskModal.tsx", "content": "import { useState, useEffect, useCallback, useRef, type ClipboardEvent } from 'react';\nimport type { Task, WorkflowPlan, WorkflowArtifact, ScheduleConfig as ScheduleConfigType } from '../../types';\nimport { useBoard } from '../../context/BoardContext';\nimport { Modal, Button, Input, RichTextEditor } from '../common';\nimport { PlanReviewView, WorkflowProgress, EmailViewer } from '../Workflow';\nimport { getApprovalView } from '../Approval';\nimport { AgentSection } from './AgentSection';\nimport { RunHistory } from './RunHistory';\nimport { useUrlDetection, extractUrl } from '../../hooks';\nimport * as api from '../../api/client';\nimport './TaskModal.css';\n\ntype TaskModalView = 'main' | 'plan-review' | 'checkpoint-review' | 'email-view';\n\ninterface TaskModalProps {\n task: Task;\n isOpen: boolean;\n onClose: () => void;\n}\n\nexport function TaskModal({ task, isOpen, onClose }: TaskModalProps) {\n const {\n activeBoard,\n updateTask,\n deleteTask,\n getTaskById,\n getWorkflowPlan: getWorkflowPlanFromContext,\n updateWorkflowPlan: updateWorkflowPlanInContext,\n removeWorkflowPlan: removeWorkflowPlanFromContext,\n } = useBoard();\n\n // Get parent task if this is a child task\n const parentTask = task.parentTaskId ? getTaskById(task.parentTaskId) : null;\n\n const [currentView, setCurrentView] = useState('main');\n const [title, setTitle] = useState(task.title);\n const [description, setDescription] = useState(task.description || '');\n const [scheduleConfig, setScheduleConfig] = useState(task.scheduleConfig);\n const [isSaving, setIsSaving] = useState(false);\n const [confirmingDelete, setConfirmingDelete] = useState(false);\n const [showUnsavedWarning, setShowUnsavedWarning] = useState(false);\n\n const hasUnsavedChanges = title !== task.title || description !== (task.description || '');\n\n const [isGeneratingPlan, setIsGeneratingPlan] = useState(false);\n const [workflowPlan, setWorkflowPlan] = useState(null);\n const [workflowError, setWorkflowError] = useState(null);\n const [isApprovingPlan, setIsApprovingPlan] = useState(false);\n const [isRespondingToCheckpoint, setIsRespondingToCheckpoint] = useState(false);\n const [selectedEmailArtifact, setSelectedEmailArtifact] = useState(null);\n const [isRunHistoryOpen, setIsRunHistoryOpen] = useState(false);\n const [childTasks, setChildTasks] = useState([]);\n\n const { pendingUrl, isLoading: isCheckingUrl, checkUrl, clear: clearPendingUrl, toPillSyntax } = useUrlDetection(task.boardId);\n const [pastedUrl, setPastedUrl] = useState(null);\n const [pastedUrlEndIndex, setPastedUrlEndIndex] = useState(null);\n\n const wasOpenRef = useRef(false);\n\n useEffect(() => {\n if (isOpen) {\n const isInitialOpen = !wasOpenRef.current;\n wasOpenRef.current = true;\n\n setCurrentView('main');\n setTitle(task.title);\n setDescription(task.description || '');\n setScheduleConfig(task.scheduleConfig);\n setConfirmingDelete(false);\n setShowUnsavedWarning(false);\n setWorkflowError(null);\n setSelectedEmailArtifact(null);\n setIsRunHistoryOpen(false);\n setChildTasks([]);\n clearPendingUrl();\n setPastedUrl(null);\n setPastedUrlEndIndex(null);\n\n if (isInitialOpen) {\n setIsGeneratingPlan(false);\n }\n\n if (activeBoard) {\n api.getTaskWorkflowPlan(activeBoard.id, task.id).then((result) => {\n if (result.success && result.data) {\n setWorkflowPlan(result.data);\n updateWorkflowPlanInContext(result.data);\n }\n });\n\n // Fetch child tasks for scheduled tasks\n if (task.scheduleConfig?.enabled) {\n api.getChildTasks(activeBoard.id, task.id).then((result) => {\n if (result.success && result.data) {\n // Sort by createdAt desc and take recent ones\n const sorted = result.data.sort((a, b) =>\n new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()\n );\n setChildTasks(sorted.slice(0, 10));\n }\n });\n }\n }\n } else {\n wasOpenRef.current = false;\n setCurrentView('main');\n }\n }, [isOpen, task.id, task.title, task.description, task.scheduleConfig, activeBoard, updateWorkflowPlanInContext]);\n\n // Sync local state from context (WebSocket updates)\n useEffect(() => {\n if (!workflowPlan?.id) return;\n const contextPlan = getWorkflowPlanFromContext(workflowPlan.id);\n if (contextPlan && contextPlan.updatedAt !== workflowPlan.updatedAt) {\n setWorkflowPlan(contextPlan);\n if (contextPlan.status === 'executing' || contextPlan.status === 'completed' || contextPlan.status === 'failed') {\n setIsGeneratingPlan(false);\n }\n }\n }, [workflowPlan?.id, workflowPlan?.updatedAt, getWorkflowPlanFromContext]);\n\n const getModalTitle = () => {\n switch (currentView) {\n case 'plan-review':\n return 'Review Workflow';\n case 'checkpoint-review':\n return 'Approval Required';\n case 'email-view':\n return selectedEmailArtifact?.title || 'Sent Email';\n default:\n return 'Edit Task';\n }\n };\n\n const showBackButton = currentView === 'plan-review' || currentView === 'checkpoint-review' || currentView === 'email-view';\n\n const handleBack = () => {\n setCurrentView('main');\n };\n\n const handleSave = async () => {\n setIsSaving(true);\n await updateTask(task.id, {\n title,\n description,\n scheduleConfig: scheduleConfig || null,\n });\n setIsSaving(false);\n onClose();\n };\n\n const handleDiscard = () => {\n setShowUnsavedWarning(false);\n onClose();\n };\n\n const preventClose = useCallback(() => {\n // Only prevent close on desktop (mobile takes full screen, actions are explicit)\n if (window.innerWidth <= 767) return false;\n return hasUnsavedChanges;\n }, [hasUnsavedChanges]);\n\n const handleCloseBlocked = () => {\n setShowUnsavedWarning(true);\n };\n\n const handleDelete = async () => {\n await deleteTask(task.id);\n onClose();\n };\n\n const handlePaste = useCallback(\n async (e: ClipboardEvent) => {\n const pastedText = e.clipboardData?.getData('text') || '';\n const url = extractUrl(pastedText);\n\n if (!url) return;\n\n setPastedUrl(url);\n checkUrl(url);\n },\n [checkUrl]\n );\n\n const findPlainUrl = useCallback((text: string, url: string): number => {\n let searchStart = 0;\n let foundIndex = -1;\n while (true) {\n const idx = text.indexOf(url, searchStart);\n if (idx === -1) break;\n const prefix = text.slice(Math.max(0, idx - 2), idx);\n if (!prefix.endsWith('](')) {\n foundIndex = idx;\n }\n searchStart = idx + 1;\n }\n return foundIndex;\n }, []);\n\n const handleConvertToPill = useCallback(() => {\n if (!pendingUrl || !pastedUrl) return;\n\n const pillSyntax = toPillSyntax(pendingUrl);\n\n let startIndex: number;\n if (pastedUrlEndIndex !== null) {\n startIndex = pastedUrlEndIndex - pastedUrl.length;\n if (description.slice(startIndex, pastedUrlEndIndex) !== pastedUrl) {\n startIndex = findPlainUrl(description, pastedUrl);\n }\n } else {\n startIndex = findPlainUrl(description, pastedUrl);\n }\n\n if (startIndex === -1) return;\n\n const newDescription =\n description.slice(0, startIndex) +\n pillSyntax +\n description.slice(startIndex + pastedUrl.length);\n\n setDescription(newDescription);\n clearPendingUrl();\n setPastedUrl(null);\n setPastedUrlEndIndex(null);\n }, [pendingUrl, pastedUrl, pastedUrlEndIndex, description, toPillSyntax, clearPendingUrl, findPlainUrl]);\n\n const handleDismissPillPrompt = useCallback(() => {\n clearPendingUrl();\n setPastedUrl(null);\n setPastedUrlEndIndex(null);\n }, [clearPendingUrl]);\n\n const handleScheduleConfigChange = useCallback((config: ScheduleConfigType | null) => {\n setScheduleConfig(config || undefined);\n }, []);\n\n const handleStartAgent = async () => {\n setIsGeneratingPlan(true);\n setWorkflowError(null);\n\n if (description !== task.description) {\n await updateTask(task.id, { title, description });\n }\n\n if (!activeBoard) return;\n\n // Clear any existing workflow output before starting fresh\n if (workflowPlan) {\n await api.deleteWorkflowPlan(activeBoard.id, workflowPlan.id);\n removeWorkflowPlanFromContext(workflowPlan.id);\n setWorkflowPlan(null);\n }\n\n const result = await api.generateWorkflowPlan(activeBoard.id, task.id);\n\n if (result.success && result.data) {\n setWorkflowPlan(result.data);\n updateWorkflowPlanInContext(result.data);\n } else {\n setWorkflowError(result.error?.message || 'Failed to start agent');\n setIsGeneratingPlan(false);\n }\n };\n\n const handleApprovePlan = async () => {\n if (!workflowPlan || !activeBoard) return;\n\n setIsApprovingPlan(true);\n const result = await api.approveWorkflowPlan(activeBoard.id, workflowPlan.id);\n if (result.success && result.data) {\n setWorkflowPlan(result.data);\n updateWorkflowPlanInContext(result.data);\n setCurrentView('main');\n } else {\n setWorkflowError(result.error?.message || 'Failed to approve plan');\n }\n setIsApprovingPlan(false);\n };\n\n const handleDismissWorkflow = async () => {\n if (!workflowPlan || !activeBoard) return;\n await api.deleteWorkflowPlan(activeBoard.id, workflowPlan.id);\n removeWorkflowPlanFromContext(workflowPlan.id);\n setWorkflowPlan(null);\n };\n\n const handleCancelWorkflow = async () => {\n if (!workflowPlan || !activeBoard) return;\n const result = await api.cancelWorkflow(activeBoard.id, workflowPlan.id);\n if (result.success && result.data) {\n setWorkflowPlan(result.data);\n updateWorkflowPlanInContext(result.data);\n }\n };\n\n const handleApproveCheckpoint = async (responseData?: Record) => {\n if (!workflowPlan || !activeBoard) return;\n setIsRespondingToCheckpoint(true);\n const result = await api.resolveWorkflowCheckpoint(activeBoard.id, workflowPlan.id, {\n action: 'approve',\n data: responseData,\n });\n if (result.success && result.data) {\n setWorkflowPlan(result.data);\n updateWorkflowPlanInContext(result.data);\n setCurrentView('main');\n } else {\n setWorkflowError(result.error?.message || 'Failed to approve checkpoint');\n }\n setIsRespondingToCheckpoint(false);\n };\n\n const handleRequestChanges = async (feedback: string) => {\n if (!workflowPlan || !activeBoard) return;\n setIsRespondingToCheckpoint(true);\n const result = await api.resolveWorkflowCheckpoint(activeBoard.id, workflowPlan.id, {\n action: 'request_changes',\n feedback,\n });\n if (result.success && result.data) {\n setWorkflowPlan(result.data);\n updateWorkflowPlanInContext(result.data);\n setCurrentView('main');\n } else {\n setWorkflowError(result.error?.message || 'Failed to request changes');\n }\n setIsRespondingToCheckpoint(false);\n };\n\n const handleCancelCheckpoint = async () => {\n if (!workflowPlan || !activeBoard) return;\n setIsRespondingToCheckpoint(true);\n const result = await api.resolveWorkflowCheckpoint(activeBoard.id, workflowPlan.id, { action: 'cancel' });\n if (result.success && result.data) {\n setWorkflowPlan(result.data);\n updateWorkflowPlanInContext(result.data);\n setCurrentView('main');\n } else {\n setWorkflowError(result.error?.message || 'Failed to cancel workflow');\n }\n setIsRespondingToCheckpoint(false);\n };\n\n // Render content based on current view\n const renderContent = () => {\n // Plan Review (wizard pattern)\n if (currentView === 'plan-review' && workflowPlan) {\n return (\n setCurrentView('main')}\n onApprove={handleApprovePlan}\n loading={isApprovingPlan}\n />\n );\n }\n\n // Checkpoint Review (wizard pattern)\n if (currentView === 'checkpoint-review' && workflowPlan) {\n // Use context plan for real-time updates, fallback to local state\n const contextPlan = getWorkflowPlanFromContext(workflowPlan.id);\n const plan = contextPlan || workflowPlan;\n\n const checkpointData = plan.checkpointData as {\n tool?: string;\n action?: string;\n data?: Record;\n toolResults?: Record;\n } | undefined;\n\n const toolName = checkpointData?.tool || '';\n const ApprovalView = getApprovalView(toolName);\n\n // Parse data - handle JSON string case\n let dataObj: Record = {};\n if (checkpointData?.data) {\n if (typeof checkpointData.data === 'string') {\n try {\n dataObj = JSON.parse(checkpointData.data);\n } catch {\n dataObj = {};\n }\n } else {\n dataObj = checkpointData.data;\n }\n }\n\n return (\n \n );\n }\n\n // Email View (from artifact dropdown)\n if (currentView === 'email-view' && selectedEmailArtifact?.content) {\n return ;\n }\n\n // Main view (default)\n return (\n <>\n
\n setTitle(e.target.value)}\n placeholder=\"Task title...\"\n />\n\n \n
\n\n {/* Agent Section - always visible */}\n
\n {workflowError && (\n
{workflowError}
\n )}\n\n {activeBoard && (\n setIsRunHistoryOpen(true)}\n />\n )}\n\n {/* Workflow output - shown below AgentSection when present */}\n {workflowPlan && (() => {\n const contextPlan = getWorkflowPlanFromContext(workflowPlan.id);\n const plan = contextPlan || workflowPlan;\n const isScheduled = !!scheduleConfig?.enabled;\n\n return (\n
\n setCurrentView('checkpoint-review')}\n onViewEmail={!isScheduled ? (artifact) => {\n setSelectedEmailArtifact(artifact);\n setCurrentView('email-view');\n } : undefined}\n childTasks={isScheduled ? childTasks : undefined}\n onViewTask={isScheduled ? (childTask) => {\n // Close this modal first, then open the child task\n onClose();\n requestAnimationFrame(() => {\n window.dispatchEvent(new CustomEvent('open-task', { detail: { taskId: childTask.id } }));\n });\n } : undefined}\n isScheduledTask={isScheduled}\n />\n
\n );\n })()}\n
\n\n
\n
\n {confirmingDelete ? (\n <>\n \n \n \n ) : (\n \n )}\n
\n {showUnsavedWarning && (\n Unsaved changes\n )}\n
\n \n \n {isSaving ? 'Saving...' : 'Save'}\n \n
\n
\n \n );\n };\n\n // Use full width for all approval/checkpoint views\n const needsFullWidth = currentView === 'checkpoint-review' || currentView === 'plan-review';\n const modalWidth = needsFullWidth ? 'full' : 'lg';\n\n return (\n <>\n {\n onClose();\n requestAnimationFrame(() => {\n window.dispatchEvent(new CustomEvent('open-task', { detail: { taskId: parentTask.id } }));\n });\n }}\n >\n created by\n {parentTask.title}\n \n ) : undefined}\n width={modalWidth}\n showBackButton={showBackButton}\n onBack={handleBack}\n preventClose={preventClose}\n onCloseBlocked={handleCloseBlocked}\n >\n
\n {renderContent()}\n
\n \n\n {activeBoard && (\n setIsRunHistoryOpen(false)}\n />\n )}\n \n );\n}\n" }, { "path": "src/components/Toast/Toast.css", "content": "/* Toast Container - top right, below header dropdowns */\n.toast-container {\n position: fixed;\n top: calc(var(--header-height) + var(--space-3));\n right: var(--space-4);\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n z-index: 50;\n pointer-events: none;\n}\n\n/* Individual Toast */\n.toast {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-3) var(--space-4);\n background: var(--color-bg-elevated);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n min-width: 280px;\n max-width: 400px;\n pointer-events: auto;\n animation: toast-slide-in 0.2s ease-out;\n}\n\n@keyframes toast-slide-in {\n from {\n opacity: 0;\n transform: translateY(-10px);\n }\n to {\n opacity: 1;\n transform: translateY(0);\n }\n}\n\n/* Toast Icon */\n.toast-icon {\n flex-shrink: 0;\n width: 20px;\n height: 20px;\n display: flex;\n align-items: center;\n justify-content: center;\n border-radius: 50%;\n font-size: 12px;\n font-weight: 600;\n}\n\n/* Toast Message */\n.toast-message {\n flex: 1;\n font-size: 13px;\n color: var(--color-text-primary);\n line-height: 1.4;\n}\n\n/* Toast Close Button */\n.toast-close {\n flex-shrink: 0;\n width: 20px;\n height: 20px;\n display: flex;\n align-items: center;\n justify-content: center;\n background: none;\n border: none;\n color: var(--color-text-muted);\n font-size: 16px;\n cursor: pointer;\n border-radius: var(--border-radius-sm);\n transition: all 0.15s;\n}\n\n.toast-close:hover {\n background: var(--color-bg-tertiary);\n color: var(--color-text-primary);\n}\n\n/* Toast Variants */\n.toast-success {\n border-left: 3px solid #22c55e;\n}\n\n.toast-success .toast-icon {\n background: rgba(34, 197, 94, 0.15);\n color: #22c55e;\n}\n\n.toast-error {\n border-left: 3px solid #ef4444;\n}\n\n.toast-error .toast-icon {\n background: rgba(239, 68, 68, 0.15);\n color: #ef4444;\n}\n\n.toast-warning {\n border-left: 3px solid #f59e0b;\n}\n\n.toast-warning .toast-icon {\n background: rgba(245, 158, 11, 0.15);\n color: #f59e0b;\n}\n\n.toast-info {\n border-left: 3px solid #3b82f6;\n}\n\n.toast-info .toast-icon {\n background: rgba(59, 130, 246, 0.15);\n color: #3b82f6;\n}\n\n/* Clickable Toast */\n.toast-clickable {\n cursor: pointer;\n}\n\n.toast-clickable:hover {\n background: var(--color-bg-tertiary);\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .toast-container {\n left: var(--space-mobile-gutter);\n right: var(--space-mobile-gutter);\n top: auto;\n bottom: env(safe-area-inset-bottom, var(--space-4));\n }\n\n .toast {\n min-width: auto;\n max-width: none;\n width: 100%;\n }\n\n .toast-close {\n width: var(--touch-target-min);\n height: var(--touch-target-min);\n }\n\n @keyframes toast-slide-in {\n from {\n opacity: 0;\n transform: translateY(10px);\n }\n to {\n opacity: 1;\n transform: translateY(0);\n }\n }\n}\n" }, { "path": "src/components/Toast/Toast.tsx", "content": "import { useEffect, useRef, useState } from 'react';\nimport type { Toast as ToastType, ToastType as ToastVariant } from '../../context/ToastContext';\nimport './Toast.css';\n\ninterface ToastProps {\n toast: ToastType;\n onClose: () => void;\n}\n\nconst ICONS: Record = {\n success: '\\u2713', // Check mark\n error: '\\u2717', // X mark\n warning: '\\u23F8', // Pause (for approval)\n info: '\\u2139', // Info\n};\n\nexport function Toast({ toast, onClose }: ToastProps) {\n const [isPaused, setIsPaused] = useState(false);\n const timeoutRef = useRef | null>(null);\n const remainingRef = useRef(toast.duration || 4000);\n const startTimeRef = useRef(Date.now());\n\n useEffect(() => {\n if (isPaused) {\n // Clear timeout and save remaining time\n if (timeoutRef.current) {\n clearTimeout(timeoutRef.current);\n timeoutRef.current = null;\n }\n remainingRef.current -= Date.now() - startTimeRef.current;\n } else {\n // Start/resume timeout\n startTimeRef.current = Date.now();\n timeoutRef.current = setTimeout(() => {\n onClose();\n }, remainingRef.current);\n }\n\n return () => {\n if (timeoutRef.current) {\n clearTimeout(timeoutRef.current);\n }\n };\n }, [isPaused, onClose]);\n\n const handleClick = () => {\n if (toast.taskId) {\n window.dispatchEvent(new CustomEvent('open-task', { detail: { taskId: toast.taskId } }));\n onClose();\n }\n };\n\n return (\n setIsPaused(true)}\n onMouseLeave={() => setIsPaused(false)}\n >\n {ICONS[toast.type]}\n {toast.message}\n {\n e.stopPropagation();\n onClose();\n }}\n aria-label=\"Close\"\n >\n ×\n \n
\n );\n}\n" }, { "path": "src/components/Toast/ToastContainer.tsx", "content": "import { useToast } from '../../context/ToastContext';\nimport { Toast } from './Toast';\nimport './Toast.css';\n\nexport function ToastContainer() {\n const { toasts, removeToast } = useToast();\n\n if (toasts.length === 0) return null;\n\n return (\n
\n {toasts.map((toast) => (\n removeToast(toast.id)}\n />\n ))}\n
\n );\n}\n" }, { "path": "src/components/Toast/WorkflowToastListener.tsx", "content": "import { useEffect, useRef } from 'react';\nimport { useBoard } from '../../context/BoardContext';\nimport { useToast } from '../../context/ToastContext';\nimport type { WorkflowPlan, Task } from '../../types';\n\n/**\n * Listens for workflow status changes and shows toast notifications.\n * Renders nothing - it's just a listener.\n */\nexport function WorkflowToastListener() {\n const { workflowPlans, activeBoard } = useBoard();\n const { addToast } = useToast();\n const prevStatusesRef = useRef>({});\n\n useEffect(() => {\n const prevStatuses = prevStatusesRef.current;\n const currentPlans: WorkflowPlan[] = Object.values(workflowPlans);\n\n for (const plan of currentPlans) {\n const prevStatus = prevStatuses[plan.id];\n const currentStatus = plan.status;\n\n // Skip if no change or if this is the first time we're seeing this plan\n if (!prevStatus || prevStatus === currentStatus) {\n continue;\n }\n\n // Get task title for the message\n const taskTitle = getTaskTitle(plan, activeBoard?.tasks || null);\n\n // Show toast based on status transition\n if (currentStatus === 'completed') {\n addToast({\n type: 'success',\n message: `\"${taskTitle}\" completed`,\n taskId: plan.taskId,\n });\n } else if (currentStatus === 'failed') {\n // Don't show toast if user explicitly cancelled/rejected (from checkpoint or header)\n // Only show for unexpected failures (e.g., from executing state)\n if (prevStatus === 'executing') {\n addToast({\n type: 'error',\n message: `\"${taskTitle}\" failed`,\n taskId: plan.taskId,\n });\n }\n } else if (currentStatus === 'checkpoint') {\n addToast({\n type: 'warning',\n message: `\"${taskTitle}\" needs approval`,\n taskId: plan.taskId,\n });\n }\n }\n\n // Update previous statuses\n const newStatuses: Record = {};\n for (const plan of currentPlans) {\n newStatuses[plan.id] = plan.status;\n }\n prevStatusesRef.current = newStatuses;\n }, [workflowPlans, activeBoard, addToast]);\n\n return null;\n}\n\nfunction getTaskTitle(plan: WorkflowPlan, tasks: Task[] | null): string {\n if (!tasks) {\n return `Task ${plan.taskId.slice(0, 8)}`;\n }\n\n const task = tasks.find((t) => t.id === plan.taskId);\n return task?.title || `Task ${plan.taskId.slice(0, 8)}`;\n}\n" }, { "path": "src/components/Toast/index.ts", "content": "export { Toast } from './Toast';\nexport { ToastContainer } from './ToastContainer';\nexport { WorkflowToastListener } from './WorkflowToastListener';\n" }, { "path": "src/components/Workflow/EmailViewerModal.css", "content": "/**\n * Email Viewer Modal Styles\n */\n\n.email-viewer {\n display: flex;\n flex-direction: column;\n gap: var(--space-4);\n}\n\n/* Header with meta info */\n.email-viewer-header {\n display: flex;\n gap: var(--space-3);\n padding-bottom: var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n}\n\n.email-viewer-meta {\n flex: 1;\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.email-viewer-field {\n display: flex;\n gap: var(--space-2);\n font-size: 13px;\n}\n\n.email-viewer-label {\n width: 60px;\n flex-shrink: 0;\n color: var(--color-text-muted);\n}\n\n.email-viewer-value {\n flex: 1;\n color: var(--color-text-primary);\n font-family: var(--font-mono);\n}\n\n.email-viewer-subject {\n font-weight: 600;\n font-family: var(--font-sans);\n}\n\n.email-viewer-date {\n color: var(--color-text-secondary);\n font-family: var(--font-sans);\n}\n\n/* Email body */\n.email-viewer-body {\n padding: var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n min-height: 150px;\n max-height: 400px;\n overflow-y: auto;\n}\n\n.email-viewer-body-text {\n margin: 0;\n font-family: var(--font-sans);\n font-size: 14px;\n line-height: 1.6;\n color: var(--color-text-primary);\n white-space: pre-wrap;\n word-break: break-word;\n}\n" }, { "path": "src/components/Workflow/EmailViewerModal.tsx", "content": "/**\n * Email Viewer\n *\n * Displays sent email content.\n * Used for viewing email artifacts.\n */\n\nimport { McpIcon } from '../common';\nimport type { WorkflowArtifact } from '../../types';\nimport './EmailViewerModal.css';\n\ninterface EmailViewerProps {\n content: WorkflowArtifact['content'];\n}\n\nfunction formatDate(isoString?: string) {\n if (!isoString) return null;\n const date = new Date(isoString);\n return date.toLocaleDateString(undefined, {\n year: 'numeric',\n month: 'short',\n day: 'numeric',\n hour: 'numeric',\n minute: '2-digit',\n });\n}\n\n/**\n * Email content viewer (no modal wrapper)\n * Used inside TaskModal for email artifact viewing\n */\nexport function EmailViewer({ content }: EmailViewerProps) {\n if (!content) return null;\n\n return (\n
\n {/* Email header */}\n
\n \n
\n
\n To:\n {content.to}\n
\n {content.cc && (\n
\n CC:\n {content.cc}\n
\n )}\n {content.bcc && (\n
\n BCC:\n {content.bcc}\n
\n )}\n
\n Subject:\n {content.subject}\n
\n {content.sentAt && (\n
\n Sent:\n {formatDate(content.sentAt)}\n
\n )}\n
\n
\n\n {/* Email body */}\n
\n 
{content.body}
\n
\n
\n );\n}\n" }, { "path": "src/components/Workflow/PlanReviewView.css", "content": "/* Plan Review Modal */\n.plan-review {\n display: flex;\n flex-direction: column;\n gap: var(--space-4);\n}\n\n.plan-section {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.plan-section-title {\n margin: 0;\n font-size: 11px;\n font-weight: 600;\n color: var(--color-text-muted);\n text-transform: uppercase;\n letter-spacing: 0.5px;\n}\n\n.plan-summary-text {\n margin: 0;\n font-size: 14px;\n color: var(--color-text-primary);\n line-height: 1.5;\n}\n\n/* Steps List */\n.plan-steps-list {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n overflow: hidden;\n}\n\n.plan-step {\n display: flex;\n align-items: flex-start;\n gap: var(--space-3);\n padding: var(--space-3);\n background: var(--color-bg-secondary);\n border-bottom: 1px solid var(--color-border-default);\n}\n\n.plan-step:last-child {\n border-bottom: none;\n}\n\n.plan-step.checkpoint {\n background: rgba(251, 191, 36, 0.05);\n}\n\n.plan-step-number {\n width: 20px;\n height: 20px;\n display: flex;\n align-items: center;\n justify-content: center;\n background: var(--color-bg-tertiary);\n border-radius: 50%;\n font-size: 11px;\n font-weight: 600;\n color: var(--color-text-muted);\n flex-shrink: 0;\n}\n\n.plan-step.checkpoint .plan-step-number {\n background: rgba(251, 191, 36, 0.2);\n color: #b45309;\n}\n\n.plan-step-content {\n flex: 1;\n min-width: 0;\n display: flex;\n flex-direction: column;\n gap: 2px;\n}\n\n.plan-step-name {\n font-size: 13px;\n font-weight: 500;\n color: var(--color-text-primary);\n}\n\n.plan-step-meta {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n font-size: 11px;\n color: var(--color-text-muted);\n}\n\n.plan-step-server {\n font-family: var(--font-mono);\n}\n\n.plan-step-tool {\n font-family: var(--font-mono);\n}\n\n.plan-step-tool::before {\n content: '→';\n margin-right: var(--space-1);\n opacity: 0.5;\n}\n\n.plan-step-checkpoint-badge {\n display: inline-flex;\n align-items: center;\n margin-top: var(--space-1);\n padding: 2px 6px;\n background: rgba(251, 191, 36, 0.15);\n border-radius: 3px;\n font-size: 10px;\n font-weight: 500;\n color: #b45309;\n width: fit-content;\n}\n\n/* Code Toggle */\n.plan-code-toggle {\n display: inline-flex;\n align-items: center;\n gap: var(--space-1);\n padding: 0;\n background: none;\n border: none;\n font-size: 12px;\n color: var(--color-text-muted);\n cursor: pointer;\n transition: color var(--transition-fast);\n}\n\n.plan-code-toggle:hover {\n color: var(--color-text-primary);\n}\n\n.plan-code-toggle svg {\n opacity: 0.7;\n}\n\n.plan-code {\n margin: 0;\n padding: var(--space-3);\n background: var(--color-bg-tertiary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n font-size: 11px;\n font-family: var(--font-mono);\n overflow-x: auto;\n max-height: 200px;\n color: var(--color-text-secondary);\n line-height: 1.5;\n}\n\n.plan-code code {\n font-family: inherit;\n}\n\n/* Actions */\n.plan-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--space-2);\n padding-top: var(--space-3);\n border-top: 1px solid var(--color-border-default);\n}\n\n/* Generating State */\n.plan-generating {\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n gap: var(--space-4);\n padding: var(--space-6) var(--space-4);\n text-align: center;\n}\n\n.plan-generating-spinner {\n width: 32px;\n height: 32px;\n border: 3px solid var(--color-border-default);\n border-top-color: var(--color-accent-primary);\n border-radius: 50%;\n animation: plan-spin 0.8s linear infinite;\n}\n\n@keyframes plan-spin {\n to {\n transform: rotate(360deg);\n }\n}\n\n.plan-generating-text {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.plan-generating-text h3 {\n margin: 0;\n font-size: 14px;\n font-weight: 600;\n color: var(--color-text-primary);\n}\n\n.plan-generating-text p {\n margin: 0;\n font-size: 13px;\n color: var(--color-text-muted);\n max-width: 300px;\n}\n" }, { "path": "src/components/Workflow/PlanReviewView.tsx", "content": "import { useState } from 'react';\nimport { Button } from '../common';\nimport type { WorkflowPlan } from '../../types';\nimport './PlanReviewView.css';\n\ninterface PlanReviewViewProps {\n plan: WorkflowPlan;\n onBack: () => void;\n onApprove: () => void;\n loading?: boolean;\n}\n\n/**\n * Wizard-style view for reviewing a workflow plan before approval.\n * Renders inline within TaskModal (no separate modal).\n * Only shown when plan is ready (loading state stays in main view).\n */\nexport function PlanReviewView({\n plan,\n onBack,\n onApprove,\n loading = false,\n}: PlanReviewViewProps) {\n const [showCode, setShowCode] = useState(false);\n\n const steps = plan.steps || [];\n\n return (\n
\n
\n {/* Summary */}\n {plan.summary && (\n
\n

{plan.summary}

\n
\n )}\n\n {/* Steps */}\n
\n

Steps ({steps.length})

\n
\n {steps.map((step, index) => (\n
\n
{index + 1}
\n
\n
{step.name}
\n {step.mcpServer && (\n
\n {step.mcpServer}\n {step.toolName && {step.toolName}}\n
\n )}\n {step.type === 'checkpoint' && (\n
Requires approval
\n )}\n
\n
\n ))}\n
\n
\n\n {/* Generated Code (collapsible) */}\n {plan.generatedCode && (\n
\n setShowCode(!showCode)}\n >\n \n {showCode ? (\n \n ) : (\n \n )}\n \n {showCode ? 'Hide generated code' : 'Show generated code'}\n \n {showCode && (\n 
\n                {plan.generatedCode}\n
\n )}\n
\n )}\n\n {/* Actions */}\n
\n \n \n
\n
\n
\n );\n}\n" }, { "path": "src/components/Workflow/Workflow.css", "content": "/* Checkpoint Dialog */\n.checkpoint-dialog {\n display: flex;\n flex-direction: column;\n gap: var(--spacing-4);\n}\n\n.checkpoint-header {\n display: flex;\n align-items: center;\n gap: var(--spacing-2);\n padding-bottom: var(--spacing-3);\n border-bottom: 1px solid var(--color-border);\n}\n\n.checkpoint-icon {\n font-size: 1.5rem;\n color: var(--color-warning);\n}\n\n.checkpoint-step-name {\n font-weight: 600;\n color: var(--color-text);\n}\n\n.checkpoint-message {\n color: var(--color-text-muted);\n line-height: 1.5;\n}\n\n.checkpoint-data {\n display: flex;\n flex-direction: column;\n gap: var(--spacing-2);\n}\n\n.checkpoint-toggle {\n background: none;\n border: none;\n color: var(--color-primary);\n cursor: pointer;\n padding: 0;\n font-size: 0.875rem;\n text-align: left;\n}\n\n.checkpoint-toggle:hover {\n text-decoration: underline;\n}\n\n.checkpoint-json {\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border);\n border-radius: var(--radius-md);\n padding: var(--spacing-3);\n font-size: 0.75rem;\n overflow-x: auto;\n max-height: 200px;\n margin: 0;\n}\n\n.checkpoint-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--spacing-3);\n padding-top: var(--spacing-3);\n border-top: 1px solid var(--color-border);\n}\n\n/* Step Progress */\n.step-progress {\n display: flex;\n flex-direction: column;\n gap: 0;\n}\n\n.step-item {\n display: grid;\n grid-template-columns: 24px auto 1fr auto;\n gap: var(--spacing-3);\n align-items: center;\n padding: var(--spacing-3) 0;\n position: relative;\n}\n\n.step-item.current {\n background: var(--color-bg-secondary);\n margin: 0 calc(-1 * var(--spacing-4));\n padding-left: var(--spacing-4);\n padding-right: var(--spacing-4);\n border-radius: var(--radius-md);\n}\n\n.step-connector {\n position: relative;\n height: 100%;\n display: flex;\n align-items: center;\n justify-content: center;\n}\n\n.step-line {\n position: absolute;\n width: 2px;\n height: calc(100% + var(--spacing-3));\n top: calc(-50% - var(--spacing-1-5));\n left: 50%;\n transform: translateX(-50%);\n}\n\n.step-item:first-child .step-line {\n display: none;\n}\n\n.step-icon {\n font-size: 1rem;\n width: 20px;\n text-align: center;\n z-index: 1;\n background: var(--color-bg);\n}\n\n.step-item.current .step-icon {\n background: var(--color-bg-secondary);\n}\n\n.step-content {\n display: flex;\n flex-direction: column;\n gap: var(--spacing-1);\n}\n\n.step-name {\n font-weight: 500;\n color: var(--color-text);\n}\n\n.step-server {\n font-size: 0.75rem;\n color: var(--color-text-muted);\n}\n\n.step-awaiting {\n font-size: 0.75rem;\n color: var(--color-warning);\n font-style: italic;\n}\n\n.step-type {\n font-size: 0.75rem;\n color: var(--color-text-muted);\n text-transform: uppercase;\n letter-spacing: 0.5px;\n}\n\n.step-item.completed .step-name {\n color: var(--color-text-muted);\n}\n\n.step-item.failed .step-name {\n color: var(--color-danger);\n}\n\n/* Plan Review Modal */\n.plan-review {\n display: flex;\n flex-direction: column;\n gap: var(--spacing-4);\n}\n\n.plan-summary {\n padding-bottom: var(--spacing-3);\n border-bottom: 1px solid var(--color-border);\n}\n\n.plan-summary h4 {\n margin: 0 0 var(--spacing-2) 0;\n font-size: 0.875rem;\n color: var(--color-text-muted);\n text-transform: uppercase;\n letter-spacing: 0.5px;\n}\n\n.plan-summary p {\n margin: 0;\n color: var(--color-text);\n line-height: 1.5;\n}\n\n.plan-steps {\n display: flex;\n flex-direction: column;\n gap: var(--spacing-2);\n}\n\n.plan-steps h4 {\n margin: 0;\n font-size: 0.875rem;\n color: var(--color-text-muted);\n text-transform: uppercase;\n letter-spacing: 0.5px;\n}\n\n.plan-servers {\n display: flex;\n align-items: center;\n gap: var(--spacing-2);\n flex-wrap: wrap;\n}\n\n.plan-servers-label {\n font-size: 0.875rem;\n color: var(--color-text-muted);\n}\n\n.plan-server-tag {\n display: inline-flex;\n align-items: center;\n padding: var(--spacing-1) var(--spacing-2);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border);\n border-radius: var(--radius-full);\n font-size: 0.75rem;\n color: var(--color-text);\n}\n\n.plan-code-section {\n display: flex;\n flex-direction: column;\n gap: var(--spacing-2);\n}\n\n.plan-code-toggle {\n background: none;\n border: none;\n color: var(--color-primary);\n cursor: pointer;\n padding: 0;\n font-size: 0.875rem;\n text-align: left;\n}\n\n.plan-code-toggle:hover {\n text-decoration: underline;\n}\n\n.plan-code {\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border);\n border-radius: var(--radius-md);\n padding: var(--spacing-3);\n font-size: 0.75rem;\n overflow-x: auto;\n max-height: 300px;\n margin: 0;\n}\n\n.plan-code code {\n font-family: 'SF Mono', 'Consolas', monospace;\n}\n\n.plan-actions {\n display: flex;\n justify-content: flex-end;\n gap: var(--spacing-3);\n padding-top: var(--spacing-3);\n border-top: 1px solid var(--color-border);\n}\n\n/* Workflow Monitor */\n.workflow-monitor {\n display: flex;\n flex-direction: column;\n gap: var(--spacing-4);\n padding: var(--spacing-4);\n background: var(--color-bg);\n border: 1px solid var(--color-border);\n border-radius: var(--radius-lg);\n}\n\n.workflow-monitor-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n padding-bottom: var(--spacing-3);\n border-bottom: 1px solid var(--color-border);\n}\n\n.workflow-monitor-title {\n font-weight: 600;\n color: var(--color-text);\n}\n\n.workflow-monitor-status {\n font-size: 0.875rem;\n padding: var(--spacing-1) var(--spacing-2);\n border-radius: var(--radius-full);\n}\n\n.workflow-monitor-status.planning {\n background: var(--color-info-bg);\n color: var(--color-info);\n}\n\n.workflow-monitor-status.executing {\n background: var(--color-primary-bg);\n color: var(--color-primary);\n}\n\n.workflow-monitor-status.checkpoint {\n background: var(--color-warning-bg);\n color: var(--color-warning);\n}\n\n.workflow-monitor-status.completed {\n background: var(--color-success-bg);\n color: var(--color-success);\n}\n\n.workflow-monitor-status.failed {\n background: var(--color-danger-bg);\n color: var(--color-danger);\n}\n\n/* ============================================\n WorkflowProgress Component\n ============================================ */\n\n.workflow-progress {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n/* Compact status bar */\n.workflow-progress-compact {\n display: flex;\n align-items: center;\n gap: var(--space-3);\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n}\n\n.workflow-progress-indicator {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n flex-shrink: 0;\n}\n\n.workflow-progress-icon {\n font-size: 12px;\n line-height: 1;\n}\n\n.workflow-progress-label {\n font-size: 11px;\n font-weight: 600;\n text-transform: uppercase;\n letter-spacing: 0.5px;\n}\n\n/* Spinning animation for planning state */\n.workflow-progress-icon.spinning {\n display: inline-block;\n animation: spin 1s linear infinite;\n}\n\n@keyframes spin {\n from { transform: rotate(0deg); }\n to { transform: rotate(360deg); }\n}\n\n/* Status colors for workflow */\n.workflow-progress-indicator.status-planning .workflow-progress-icon,\n.workflow-progress-indicator.status-planning .workflow-progress-label {\n color: #3b82f6;\n}\n\n.workflow-progress-indicator.status-draft .workflow-progress-icon,\n.workflow-progress-indicator.status-draft .workflow-progress-label {\n color: var(--color-text-muted);\n}\n\n.workflow-progress-indicator.status-executing .workflow-progress-icon {\n color: transparent;\n position: relative;\n width: 12px;\n height: 12px;\n}\n\n.workflow-progress-indicator.status-executing .workflow-progress-icon::after {\n content: '';\n position: absolute;\n top: 0;\n left: 0;\n width: 10px;\n height: 10px;\n border: 2px solid rgba(59, 130, 246, 0.2);\n border-top-color: #3b82f6;\n border-radius: 50%;\n animation: spin 0.8s linear infinite;\n}\n\n.workflow-progress-indicator.status-executing .workflow-progress-label {\n color: #3b82f6;\n}\n\n.workflow-progress-indicator.status-checkpoint .workflow-progress-icon,\n.workflow-progress-indicator.status-checkpoint .workflow-progress-label {\n color: #f59e0b;\n}\n\n.workflow-progress-indicator.status-completed .workflow-progress-icon,\n.workflow-progress-indicator.status-completed .workflow-progress-label {\n color: #22c55e;\n}\n\n.workflow-progress-indicator.status-failed .workflow-progress-icon,\n.workflow-progress-indicator.status-failed .workflow-progress-label {\n color: #ef4444;\n}\n\n/* Preview area */\n.workflow-progress-preview {\n flex: 1;\n display: flex;\n align-items: center;\n gap: var(--space-2);\n min-width: 0;\n cursor: pointer;\n padding: var(--space-1) var(--space-2);\n margin: calc(-1 * var(--space-1)) 0;\n border-radius: var(--border-radius-sm);\n transition: background 0.15s;\n}\n\n.workflow-progress-preview:hover {\n background: var(--color-bg-tertiary);\n}\n\n.workflow-progress-preview .preview-text {\n flex: 1;\n font-size: 12px;\n font-family: var(--font-mono);\n color: var(--color-text-secondary);\n white-space: nowrap;\n overflow: hidden;\n text-overflow: ellipsis;\n}\n\n.workflow-progress-preview .preview-text.muted {\n color: var(--color-text-muted);\n font-style: italic;\n}\n\n.workflow-progress-preview .preview-expand {\n font-size: 8px;\n color: var(--color-text-muted);\n flex-shrink: 0;\n}\n\n/* Actions */\n.workflow-progress-actions {\n display: flex;\n gap: var(--space-2);\n flex-shrink: 0;\n}\n\n/* Expanded panel */\n.workflow-progress-panel {\n display: flex;\n flex-direction: column;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n overflow: hidden;\n}\n\n/* Child tasks section in expanded panel (for scheduled tasks) */\n.workflow-progress-child-tasks {\n padding: var(--space-2) var(--space-3);\n}\n\n.workflow-progress-child-tasks .child-tasks-toggle {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n width: 100%;\n padding: var(--space-1) 0;\n background: none;\n border: none;\n cursor: pointer;\n font-family: inherit;\n text-align: left;\n}\n\n.workflow-progress-child-tasks .child-tasks-toggle:hover {\n opacity: 0.8;\n}\n\n.workflow-progress-child-tasks .child-tasks-toggle-icon {\n font-size: 8px;\n color: var(--color-text-muted);\n width: 10px;\n}\n\n.workflow-progress-child-tasks .child-tasks-toggle-label {\n font-size: 10px;\n font-weight: 600;\n text-transform: uppercase;\n letter-spacing: 0.5px;\n color: var(--color-text-muted);\n}\n\n.workflow-progress-child-tasks .child-tasks-list {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n margin-left: calc(10px + var(--space-2));\n margin-top: var(--space-2);\n}\n\n.child-task-row {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding: var(--space-2);\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n cursor: pointer;\n transition: all var(--transition-fast);\n width: 100%;\n text-align: left;\n}\n\n.child-task-row:hover {\n border-color: var(--color-border-focus);\n background: var(--color-bg-tertiary);\n}\n\n.child-task-row .child-task-title {\n font-size: 12px;\n color: var(--color-text-primary);\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.child-task-row svg {\n flex-shrink: 0;\n color: var(--color-text-muted);\n}\n\n/* Steps section in expanded panel - collapsible */\n.workflow-progress-steps {\n padding: 0 var(--space-3) var(--space-2);\n margin-top: var(--space-2);\n}\n\n/* Steps toggle button */\n.workflow-progress-steps .steps-toggle {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n width: 100%;\n padding: var(--space-1) 0;\n background: none;\n border: none;\n cursor: pointer;\n font-family: inherit;\n text-align: left;\n}\n\n.workflow-progress-steps .steps-toggle:hover {\n opacity: 0.8;\n}\n\n.workflow-progress-steps .steps-toggle-icon {\n font-size: 8px;\n color: var(--color-text-muted);\n width: 10px;\n}\n\n.workflow-progress-steps .steps-toggle-label {\n font-size: 10px;\n font-weight: 600;\n text-transform: uppercase;\n letter-spacing: 0.5px;\n color: var(--color-text-muted);\n}\n\n.workflow-progress-steps .steps-toggle-count {\n font-size: 10px;\n color: var(--color-text-muted);\n font-weight: 400;\n}\n\n.workflow-progress-steps .steps-header {\n font-size: 10px;\n font-weight: 600;\n text-transform: uppercase;\n letter-spacing: 0.5px;\n color: var(--color-text-muted);\n margin-bottom: var(--space-2);\n}\n\n.workflow-progress-steps .steps-list {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n max-height: 160px;\n overflow-y: auto;\n}\n\n.step-row {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-1) var(--space-2);\n font-size: 12px;\n border-radius: var(--border-radius-sm);\n}\n\n.step-row.current {\n background: var(--color-bg-secondary);\n}\n\n.step-row-icon {\n font-size: 10px;\n width: 14px;\n text-align: center;\n}\n\n.step-row.status-pending .step-row-icon {\n color: var(--color-text-muted);\n}\n\n.step-row.status-running .step-row-icon {\n color: #3b82f6;\n}\n\n.step-row.status-completed .step-row-icon {\n color: #22c55e;\n}\n\n.step-row.status-failed .step-row-icon {\n color: #ef4444;\n}\n\n.step-row.status-awaiting_approval .step-row-icon {\n color: #f59e0b;\n}\n\n.step-row-name {\n flex: 1;\n color: var(--color-text-primary);\n}\n\n.step-row.status-completed .step-row-name {\n color: var(--color-text-muted);\n}\n\n.step-row-server {\n font-size: 10px;\n color: var(--color-text-muted);\n padding: var(--space-0-5) var(--space-1);\n background: var(--color-bg-tertiary);\n border-radius: var(--border-radius-sm);\n}\n\n.step-row-duration {\n font-size: 10px;\n color: var(--color-text-muted);\n font-family: var(--font-mono);\n min-width: 40px;\n text-align: right;\n}\n\n/* Commentary steps - subdued styling */\n.step-row.commentary-step {\n opacity: 0.7;\n}\n\n.step-row.commentary-step .step-row-icon {\n font-size: 8px;\n}\n\n.step-row.commentary-step .step-row-name {\n font-style: italic;\n color: var(--color-text-muted);\n}\n\n/* Tool steps - emphasized styling */\n.step-row.tool-step .step-row-name {\n font-weight: 500;\n}\n\n/* Logs section in expanded panel - collapsible */\n.workflow-progress-logs {\n padding: 0 var(--space-3) var(--space-2);\n margin-top: var(--space-2);\n}\n\n/* Logs toggle button */\n.workflow-progress-logs .logs-toggle {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n width: 100%;\n padding: var(--space-1) 0;\n background: none;\n border: none;\n cursor: pointer;\n font-family: inherit;\n text-align: left;\n}\n\n.workflow-progress-logs .logs-toggle:hover {\n opacity: 0.8;\n}\n\n.workflow-progress-logs .logs-toggle-icon {\n font-size: 8px;\n color: var(--color-text-muted);\n width: 10px;\n}\n\n.workflow-progress-logs .logs-toggle-label {\n font-size: 10px;\n font-weight: 600;\n text-transform: uppercase;\n letter-spacing: 0.5px;\n color: var(--color-text-muted);\n}\n\n.workflow-progress-logs .logs-toggle-count {\n font-size: 10px;\n color: var(--color-text-muted);\n font-weight: 400;\n}\n\n.workflow-progress-logs .logs-header {\n font-size: 10px;\n font-weight: 600;\n text-transform: uppercase;\n letter-spacing: 0.5px;\n color: var(--color-text-muted);\n margin-bottom: var(--space-2);\n}\n\n.workflow-progress-logs .logs-empty {\n padding: var(--space-3);\n margin-top: var(--space-2);\n text-align: center;\n font-size: 12px;\n color: var(--color-text-muted);\n}\n\n.workflow-progress-logs .logs-list {\n max-height: 180px;\n overflow-y: auto;\n font-family: var(--font-mono);\n font-size: 11px;\n margin-top: var(--space-2);\n}\n\n.workflow-progress-logs .log-entry {\n display: flex;\n flex-wrap: wrap;\n gap: var(--space-2);\n padding: var(--space-1) var(--space-2);\n border-bottom: 1px solid var(--color-border-subtle);\n}\n\n.workflow-progress-logs .log-entry:last-of-type {\n border-bottom: none;\n}\n\n.workflow-progress-logs .log-time {\n color: var(--color-text-muted);\n flex-shrink: 0;\n font-size: 10px;\n}\n\n.workflow-progress-logs .log-msg {\n flex: 1;\n color: var(--color-text-primary);\n word-break: break-word;\n}\n\n.workflow-progress-logs .log-info .log-msg {\n color: var(--color-text-secondary);\n}\n\n.workflow-progress-logs .log-warn .log-msg {\n color: #f59e0b;\n}\n\n.workflow-progress-logs .log-error .log-msg {\n color: #ef4444;\n}\n\n.workflow-progress-logs .log-show-more {\n background: none;\n border: none;\n padding: 0;\n margin-left: 4px;\n font-size: inherit;\n color: var(--color-text-muted);\n cursor: pointer;\n text-decoration: underline;\n text-decoration-style: dotted;\n}\n\n.workflow-progress-logs .log-show-more:hover {\n color: var(--color-text-primary);\n}\n\n.workflow-progress-logs .log-details {\n width: 100%;\n padding: var(--space-1) var(--space-2);\n margin-left: var(--space-4);\n background: var(--color-bg-secondary);\n border-radius: var(--border-radius-sm);\n font-size: 10px;\n color: var(--color-text-muted);\n overflow-x: auto;\n}\n\n.workflow-progress-logs .log-details code {\n white-space: pre-wrap;\n}\n\n.workflow-progress-logs .log-duration {\n font-size: 10px;\n color: var(--color-text-muted);\n flex-shrink: 0;\n}\n\n/* Error bar */\n.workflow-progress-error {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n background: rgba(239, 68, 68, 0.1);\n border: 1px solid rgba(239, 68, 68, 0.2);\n border-radius: var(--border-radius);\n font-size: 12px;\n}\n\n.workflow-progress-error .error-icon {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 16px;\n height: 16px;\n background: #ef4444;\n color: white;\n border-radius: 50%;\n font-size: 10px;\n font-weight: 700;\n flex-shrink: 0;\n}\n\n.workflow-progress-error .error-msg {\n color: #ef4444;\n}\n\n/* Checkpoint bar */\n.workflow-progress-checkpoint {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n background: rgba(245, 158, 11, 0.1);\n border: 1px solid rgba(245, 158, 11, 0.2);\n border-radius: var(--border-radius);\n font-size: 12px;\n}\n\n.workflow-progress-checkpoint .checkpoint-icon {\n color: #f59e0b;\n font-size: 14px;\n}\n\n.workflow-progress-checkpoint .checkpoint-msg {\n color: #f59e0b;\n}\n\n/* Workflow Badge */\n.workflow-badge {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n width: 16px;\n height: 16px;\n font-size: 10px;\n font-weight: 600;\n}\n\n.workflow-badge.badge-planning,\n.workflow-badge.badge-draft {\n color: var(--color-text-muted);\n}\n\n.workflow-badge.badge-executing {\n color: transparent;\n position: relative;\n}\n\n.workflow-badge.badge-executing::after {\n content: '';\n position: absolute;\n top: 50%;\n left: 50%;\n width: 10px;\n height: 10px;\n margin: -5px 0 0 -5px;\n border: 2px solid rgba(59, 130, 246, 0.2);\n border-top-color: #3b82f6;\n border-radius: 50%;\n animation: spin 0.8s linear infinite;\n}\n\n.workflow-badge.badge-checkpoint {\n color: #f59e0b;\n}\n\n.workflow-badge.badge-completed {\n color: #22c55e;\n}\n\n.workflow-badge.badge-failed {\n color: #ef4444;\n}\n\n.workflow-badge.badge-artifact {\n color: var(--color-text-secondary);\n}\n\n.workflow-badge.badge-artifact:hover {\n color: var(--color-text-primary);\n}\n\n/* Artifact link in actions (matches execution PR link) */\n.workflow-artifact-link {\n display: inline-flex;\n align-items: center;\n gap: var(--space-1);\n padding: var(--space-1) var(--space-2);\n background: var(--color-bg-tertiary);\n border: 1px solid var(--color-border-default);\n color: var(--color-text-secondary);\n border-radius: var(--border-radius);\n font-size: 12px;\n font-weight: 500;\n font-family: inherit;\n text-decoration: none;\n cursor: pointer;\n transition: all 0.15s;\n}\n\n.workflow-artifact-link:hover {\n background: var(--color-bg-elevated);\n border-color: var(--color-border-focus);\n color: var(--color-text-primary);\n}\n\n.workflow-artifact-link svg {\n flex-shrink: 0;\n}\n\n.workflow-artifact-link .artifact-title {\n max-width: 180px;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.workflow-artifact-link .artifact-pr-number {\n font-weight: 600;\n color: var(--color-text-secondary);\n flex-shrink: 0;\n}\n\n/* Artifacts dropdown */\n.workflow-artifacts-dropdown {\n position: relative;\n}\n\n.artifact-dropdown-caret {\n font-size: 8px;\n margin-left: var(--space-1);\n}\n\n.workflow-artifacts-menu {\n position: absolute;\n top: 100%;\n right: 0;\n margin-top: var(--space-1);\n min-width: 200px;\n max-width: 300px;\n background: var(--color-bg-elevated);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n box-shadow: var(--shadow-md);\n z-index: 100;\n overflow: hidden;\n}\n\n/* Fixed position menu - escapes modal overflow */\n.workflow-artifacts-menu.workflow-artifacts-menu-fixed {\n position: fixed;\n top: auto;\n right: auto;\n margin-top: 0;\n width: 280px;\n z-index: 10000;\n}\n\n.workflow-artifacts-menu-item {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n padding: var(--space-2) var(--space-3);\n width: 100%;\n background: none;\n border: none;\n color: var(--color-text-primary);\n text-decoration: none;\n font-size: 13px;\n font-family: inherit;\n text-align: left;\n cursor: pointer;\n transition: background 0.15s;\n}\n\n.workflow-artifacts-menu-item:hover {\n background: var(--color-bg-tertiary);\n}\n\n.workflow-artifacts-menu-item svg {\n flex-shrink: 0;\n color: var(--color-text-secondary);\n}\n\n.workflow-artifacts-menu-item span {\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.workflow-artifacts-menu-item .artifact-pr-number {\n font-weight: 600;\n color: var(--color-text-secondary);\n flex-shrink: 0;\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n /* Compact status bar - stack on mobile */\n .workflow-progress-compact {\n flex-wrap: wrap;\n gap: var(--space-2);\n padding: var(--space-3);\n }\n\n .workflow-progress-indicator {\n flex-shrink: 0;\n }\n\n .workflow-progress-preview {\n flex: 1 1 100%;\n order: 3;\n min-width: 0;\n margin: 0;\n padding: var(--space-2);\n background: var(--color-bg-tertiary);\n border-radius: var(--border-radius);\n }\n\n .workflow-progress-preview .preview-text {\n font-size: 11px;\n }\n\n .workflow-progress-actions {\n margin-left: auto;\n }\n\n /* Artifact link - more compact */\n .workflow-artifact-link {\n padding: var(--space-1);\n font-size: 11px;\n }\n\n .workflow-artifact-link .artifact-title {\n max-width: 100px;\n }\n\n /* Artifacts dropdown - bottom sheet */\n .workflow-artifacts-menu {\n position: fixed;\n bottom: 0;\n left: 0;\n right: 0;\n top: auto;\n max-width: none;\n min-width: auto;\n border-radius: var(--border-radius) var(--border-radius) 0 0;\n padding-bottom: env(safe-area-inset-bottom);\n max-height: 60vh;\n overflow-y: auto;\n animation: slideUp 0.2s ease-out;\n }\n\n @keyframes slideUp {\n from {\n opacity: 0;\n transform: translateY(100%);\n }\n to {\n opacity: 1;\n transform: translateY(0);\n }\n }\n\n .workflow-artifacts-menu-item {\n min-height: var(--touch-target-min);\n padding: var(--space-3) var(--space-4);\n }\n\n /* Step rows in expanded panel */\n .workflow-progress-steps .steps-list {\n max-height: 200px;\n }\n\n .step-row {\n padding: var(--space-2);\n flex-wrap: wrap;\n }\n\n .step-row-server {\n display: none;\n }\n\n .step-row-duration {\n font-size: 9px;\n }\n\n /* Logs */\n .workflow-progress-logs .logs-list {\n max-height: 150px;\n }\n\n .workflow-progress-logs .log-entry {\n padding: var(--space-2);\n }\n\n /* Checkpoint actions */\n .checkpoint-actions {\n flex-direction: column;\n gap: var(--space-2);\n }\n\n .checkpoint-actions > * {\n width: 100%;\n }\n\n /* Plan actions */\n .plan-actions {\n flex-direction: column;\n gap: var(--space-2);\n }\n\n .plan-actions > * {\n width: 100%;\n }\n\n /* Step grid - simpler on mobile */\n .step-item {\n grid-template-columns: 20px 1fr auto;\n gap: var(--space-2);\n }\n}\n" }, { "path": "src/components/Workflow/WorkflowProgress.tsx", "content": "import { useState, useEffect, useRef } from 'react';\nimport { Button } from '../common';\nimport type { WorkflowPlan, WorkflowStep as WorkflowStepType, WorkflowArtifact, Task } from '../../types';\nimport { useBoard } from '../../context/BoardContext';\nimport './Workflow.css';\n\ninterface WorkflowProgressProps {\n plan: WorkflowPlan;\n onCancel?: () => void;\n onDismiss?: () => void;\n onReviewCheckpoint?: () => void;\n onViewEmail?: (artifact: WorkflowArtifact) => void;\n // For scheduled tasks - show child tasks created\n childTasks?: Task[];\n onViewTask?: (task: Task) => void;\n // If true, this is a scheduled task's last run (hide artifacts, change Clear to Dismiss)\n isScheduledTask?: boolean;\n}\n\nexport function WorkflowProgress({\n plan,\n onCancel,\n onDismiss,\n onReviewCheckpoint,\n onViewEmail,\n childTasks,\n onViewTask,\n isScheduledTask,\n}: WorkflowProgressProps) {\n const { getWorkflowLogs, fetchWorkflowLogs } = useBoard();\n const [expanded, setExpanded] = useState(false);\n const [logsExpanded, setLogsExpanded] = useState(false);\n const [stepsExpanded, setStepsExpanded] = useState(!isScheduledTask);\n const [childTasksExpanded, setChildTasksExpanded] = useState(true);\n const [logsLoading, setLogsLoading] = useState(true);\n const [artifactsDropdownOpen, setArtifactsDropdownOpen] = useState(false);\n const [confirmingClear, setConfirmingClear] = useState(false);\n const [expandedLogs, setExpandedLogs] = useState>(new Set());\n const clearButtonRef = useRef(null);\n const logsEndRef = useRef(null);\n const stepsEndRef = useRef(null);\n\n const logs = getWorkflowLogs(plan.id);\n\n useEffect(() => {\n const loadLogs = async () => {\n await fetchWorkflowLogs(plan.boardId, plan.id);\n setLogsLoading(false);\n };\n loadLogs();\n }, [plan.boardId, plan.id, fetchWorkflowLogs]);\n\n useEffect(() => {\n if (expanded && logsExpanded) {\n logsEndRef.current?.scrollIntoView({ behavior: 'smooth' });\n }\n }, [logs, expanded, logsExpanded]);\n\n useEffect(() => {\n if (expanded && plan.steps?.length) {\n stepsEndRef.current?.scrollIntoView({ behavior: 'smooth' });\n }\n }, [plan.steps, expanded]);\n\n useEffect(() => {\n if (!confirmingClear) return;\n const handleClickOutside = (e: MouseEvent) => {\n if (clearButtonRef.current && !clearButtonRef.current.contains(e.target as Node)) {\n setConfirmingClear(false);\n }\n };\n document.addEventListener('mousedown', handleClickOutside);\n return () => document.removeEventListener('mousedown', handleClickOutside);\n }, [confirmingClear]);\n\n const getStatusIcon = () => {\n switch (plan.status) {\n case 'planning':\n case 'draft':\n return '\\u25CB'; // Empty circle\n case 'executing':\n return '\\u25D4'; // Circle with right half\n case 'checkpoint':\n return '\\u23F8'; // Pause\n case 'completed':\n return '\\u25CF'; // Filled circle (matches execution)\n case 'failed':\n return '\\u2717'; // X\n default:\n return '\\u25CB';\n }\n };\n\n const getStatusLabel = () => {\n switch (plan.status) {\n case 'planning':\n return 'Starting';\n case 'draft':\n return 'Ready';\n case 'approved':\n return 'Ready';\n case 'executing':\n return 'Working';\n case 'checkpoint':\n return 'Paused';\n case 'completed':\n return 'Done';\n case 'failed':\n return 'Failed';\n default:\n return plan.status;\n }\n };\n\n const isRunning = plan.status === 'executing' || plan.status === 'planning';\n const isComplete = plan.status === 'completed';\n const hasFailed = plan.status === 'failed';\n const isPaused = plan.status === 'checkpoint';\n\n const latestLog = logs[logs.length - 1];\n const currentStep = plan.steps?.[plan.currentStepIndex || 0];\n\n const filteredSteps = (plan.steps || []).filter((step) => {\n if (step.type === 'tool' || step.type === 'checkpoint' || step.type === 'tool_call') {\n return true;\n }\n const name = step.name.toLowerCase();\n if (name.includes('thinking') || name.startsWith('now i')) {\n return false;\n }\n if (name.includes('done') || name.includes('complete') || name.includes('finished')) {\n return true;\n }\n if (step.type === 'agent') {\n return false;\n }\n return true;\n });\n\n const getStepDuration = (step: WorkflowStepType): string | null => {\n if (step.durationMs) {\n return `${(step.durationMs / 1000).toFixed(1)}s`;\n }\n if (step.status === 'running' && step.startedAt) {\n const elapsed = Date.now() - new Date(step.startedAt).getTime();\n return `${(elapsed / 1000).toFixed(1)}s`;\n }\n return null;\n };\n\n return (\n
\n {/* Compact status bar */}\n
\n
\n {getStatusIcon()}\n {getStatusLabel()}\n
\n\n
setExpanded(!expanded)}>\n {logsLoading ? (\n Loading...\n ) : latestLog ? (\n {latestLog.message}\n ) : currentStep ? (\n {currentStep.name}\n ) : (\n \n {isRunning ? 'Starting...' : 'No activity'}\n \n )}\n {expanded ? '\\u25BC' : '\\u25C0'}\n
\n\n
\n {isRunning && onCancel && (\n \n )}\n {isPaused && onReviewCheckpoint && (\n \n )}\n {/* Artifact button/dropdown - hidden for scheduled tasks (artifacts are on child tasks) */}\n {!isScheduledTask && isComplete && plan.result?.artifacts && plan.result.artifacts.length > 0 && (\n setArtifactsDropdownOpen(!artifactsDropdownOpen)}\n onClose={() => setArtifactsDropdownOpen(false)}\n onSelectEmail={onViewEmail}\n />\n )}\n {(isComplete || hasFailed) && onDismiss && (\n {\n if (confirmingClear) {\n onDismiss();\n setConfirmingClear(false);\n } else {\n setConfirmingClear(true);\n }\n }}\n >\n {confirmingClear ? 'Confirm?' : isScheduledTask ? 'Dismiss' : 'Clear'}\n \n )}\n
\n
\n\n {/* Expanded panel with steps and logs */}\n {expanded && (\n
\n {/* Child tasks section - for scheduled tasks that created child tasks */}\n {childTasks && childTasks.length > 0 && (\n
\n setChildTasksExpanded(!childTasksExpanded)}\n >\n {childTasksExpanded ? '▼' : '▶'}\n \n Created {childTasks.length} task{childTasks.length !== 1 ? 's' : ''}\n \n \n {childTasksExpanded && (\n
\n {childTasks.map((task) => (\n onViewTask?.(task)}\n >\n {task.title}\n \n \n \n \n ))}\n
\n )}\n
\n )}\n\n {/* Steps section - collapsible, collapsed by default for scheduled tasks */}\n {(filteredSteps.length > 0 || isRunning) && (\n
\n setStepsExpanded(!stepsExpanded)}\n >\n {stepsExpanded ? '▼' : '▶'}\n \n {stepsExpanded ? 'Hide Steps' : 'Show Steps'}\n \n {filteredSteps.length > 0 && (\n ({filteredSteps.length})\n )}\n \n {stepsExpanded && (\n
\n {filteredSteps.length === 0 && isRunning ? (\n
\n {'\\u25D4'}\n Starting...\n
\n ) : (\n filteredSteps.map((step) => {\n const isToolStep = step.type === 'tool' || step.type === 'checkpoint' || step.type === 'tool_call';\n const stepIcon = getStepIcon(step.status);\n return (\n \n {stepIcon}\n {step.name}\n {step.mcpServer && (\n {step.mcpServer}\n )}\n \n {getStepDuration(step) || ''}\n \n
\n );\n })\n )}\n
\n
\n )}\n
\n )}\n\n {/* Logs section - collapsible, starts collapsed */}\n
\n setLogsExpanded(!logsExpanded)}\n >\n {logsExpanded ? '▼' : '▶'}\n \n {logsExpanded ? 'Hide Logs' : 'Show Logs'}\n \n {logs.length > 0 && (\n ({logs.length})\n )}\n \n {logsExpanded && (\n logs.length === 0 ? (\n
\n {isRunning ? 'Waiting for logs...' : 'No logs available'}\n
\n ) : (\n
\n {logs.map((log) => {\n const isLongMessage = log.message.length > 250;\n const isExpanded = expandedLogs.has(log.id);\n const displayMessage = isLongMessage && !isExpanded\n ? log.message.substring(0, 250)\n : log.message;\n\n return (\n
\n \n {new Date(log.timestamp).toLocaleTimeString([], {\n hour: '2-digit',\n minute: '2-digit',\n second: '2-digit',\n })}\n \n \n {displayMessage}\n {isLongMessage && !isExpanded && (\n {\n e.stopPropagation();\n setExpandedLogs(prev => new Set(prev).add(log.id));\n }}\n >\n show more\n \n )}\n \n {log.metadata?.type === 'tool_call' && log.metadata.args && (\n
\n {JSON.stringify(log.metadata.args, null, 2)}\n
\n )}\n {log.metadata?.type === 'tool_result' && log.metadata.durationMs && (\n \n {(log.metadata.durationMs / 1000).toFixed(2)}s\n \n )}\n
\n );\n })}\n
\n
\n )\n )}\n
\n\n
\n )}\n\n
\n );\n}\n\nfunction getPRNumber(url: string): string | null {\n const match = url.match(/\\/pull\\/(\\d+)/);\n return match ? match[1] : null;\n}\n\nfunction truncateTitle(title: string, maxLen = 30): string {\n return title.length <= maxLen ? title : title.slice(0, maxLen) + '...';\n}\n\nfunction getStepIcon(status: WorkflowStepType['status']): string {\n switch (status) {\n case 'pending':\n return '\\u25CB'; // Empty circle\n case 'running':\n return '\\u25D4'; // Circle with right half\n case 'completed':\n return '\\u2713'; // Check\n case 'failed':\n return '\\u2717'; // X\n case 'awaiting_approval':\n return '\\u23F8'; // Pause\n default:\n return '\\u25CB';\n }\n}\n\nconst ArtifactIcons = {\n google_doc: (\n \n \n \n ),\n google_sheet: (\n \n \n \n \n \n \n \n ),\n gmail_message: (\n \n \n \n ),\n github_pr: (\n \n \n \n ),\n file: (\n \n \n \n ),\n other: (\n \n \n \n ),\n};\n\nfunction ArtifactButton({\n artifacts,\n isOpen,\n onToggle,\n onClose,\n onSelectEmail,\n}: {\n artifacts: WorkflowArtifact[];\n isOpen: boolean;\n onToggle: () => void;\n onClose: () => void;\n onSelectEmail?: (artifact: WorkflowArtifact) => void;\n}) {\n const dropdownRef = useRef(null);\n const buttonRef = useRef(null);\n const [menuPosition, setMenuPosition] = useState<{ top: number; left: number } | null>(null);\n\n // Calculate menu position when opening\n useEffect(() => {\n if (isOpen && buttonRef.current) {\n const rect = buttonRef.current.getBoundingClientRect();\n // Position below the button, aligned to right edge\n setMenuPosition({\n top: rect.bottom + 4,\n left: Math.max(8, rect.right - 280), // 280px menu width, 8px min margin\n });\n }\n }, [isOpen]);\n\n useEffect(() => {\n if (!isOpen) return;\n const handleClickOutside = (e: MouseEvent) => {\n if (dropdownRef.current && !dropdownRef.current.contains(e.target as Node) &&\n buttonRef.current && !buttonRef.current.contains(e.target as Node)) {\n onClose();\n }\n };\n document.addEventListener('mousedown', handleClickOutside);\n return () => document.removeEventListener('mousedown', handleClickOutside);\n }, [isOpen, onClose]);\n\n if (artifacts.length === 1) {\n const artifact = artifacts[0];\n const icon = ArtifactIcons[artifact.type as keyof typeof ArtifactIcons] || ArtifactIcons.other;\n const prNumber = artifact.type === 'github_pr' && artifact.url ? getPRNumber(artifact.url) : null;\n\n if (artifact.type === 'gmail_message' && artifact.content && onSelectEmail) {\n return (\n onSelectEmail(artifact)}\n >\n {icon}\n {truncateTitle(artifact.title || 'View Email', 30)}\n \n );\n }\n\n return (\n \n {icon}\n {prNumber && #{prNumber}}\n {truncateTitle(artifact.title || 'View', 30)}\n \n );\n }\n\n const firstIcon = ArtifactIcons[artifacts[0].type as keyof typeof ArtifactIcons] || ArtifactIcons.other;\n\n return (\n
\n \n\n {isOpen && menuPosition && (\n \n {artifacts.map((artifact, i) => {\n const icon = ArtifactIcons[artifact.type as keyof typeof ArtifactIcons] || ArtifactIcons.other;\n const prNumber = artifact.type === 'github_pr' && artifact.url ? getPRNumber(artifact.url) : null;\n\n if (artifact.type === 'gmail_message' && artifact.content && onSelectEmail) {\n return (\n {\n onSelectEmail(artifact);\n onClose();\n }}\n >\n {icon}\n {artifact.title || 'View Email'}\n \n );\n }\n\n return (\n \n {icon}\n {prNumber && #{prNumber}}\n {artifact.title || 'View'}\n \n );\n })}\n
\n )}\n
\n );\n}\n\n/**\n * Small badge to show workflow status on task cards\n */\nexport function WorkflowBadge({\n status,\n artifactType\n}: {\n status: string;\n artifactType?: string;\n}) {\n if (status === 'completed' && artifactType) {\n if (artifactType === 'google_doc') {\n return (\n \n \n \n \n \n );\n }\n if (artifactType === 'gmail_message') {\n return (\n \n \n \n \n \n );\n }\n if (artifactType === 'github_pr') {\n return (\n \n \n \n \n \n );\n }\n if (artifactType === 'google_sheet') {\n return (\n \n \n \n \n \n \n \n \n \n );\n }\n }\n\n const getIcon = () => {\n switch (status) {\n case 'planning':\n case 'draft':\n return '\\u25CB';\n case 'executing':\n return '\\u25D4';\n case 'checkpoint':\n return '\\u23F8';\n case 'completed':\n return '\\u25CF';\n case 'failed':\n return '\\u2717';\n default:\n return '\\u25CB';\n }\n };\n\n return (\n \n {getIcon()}\n \n );\n}\n" }, { "path": "src/components/Workflow/index.ts", "content": "export { PlanReviewView } from './PlanReviewView';\nexport { WorkflowProgress, WorkflowBadge } from './WorkflowProgress';\nexport { EmailViewer } from './EmailViewerModal';\n" }, { "path": "src/components/common/Button.css", "content": ".btn {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n gap: var(--space-2);\n font-family: var(--font-mono);\n font-weight: 500;\n border-radius: var(--border-radius);\n cursor: pointer;\n transition: all var(--transition-fast);\n white-space: nowrap;\n}\n\n.btn:disabled {\n opacity: 0.5;\n cursor: not-allowed;\n}\n\n/* Sizes */\n.btn-sm {\n font-size: 12px;\n padding: var(--space-1) var(--space-2);\n}\n\n.btn-md {\n font-size: 13px;\n padding: var(--space-2) var(--space-3);\n}\n\n/* Variants */\n.btn-default {\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n color: var(--color-text-secondary);\n}\n\n.btn-default:hover:not(:disabled) {\n border-color: var(--color-accent-primary);\n color: var(--color-accent-primary);\n}\n\n.btn-primary {\n background: var(--color-accent-primary);\n border: 1px solid var(--color-accent-primary);\n color: #ffffff;\n}\n\n.btn-primary:hover:not(:disabled) {\n background: var(--color-accent-secondary);\n border-color: var(--color-accent-secondary);\n}\n\n.btn-ghost {\n background: transparent;\n border: 1px solid transparent;\n color: var(--color-text-muted);\n}\n\n.btn-ghost:hover:not(:disabled) {\n background: var(--color-accent-muted);\n color: var(--color-accent-primary);\n}\n\n.btn-danger {\n background: #ef4444;\n border: 1px solid #ef4444;\n color: #ffffff;\n}\n\n.btn-danger:hover:not(:disabled) {\n background: #dc2626;\n border-color: #dc2626;\n}\n\n/* Agent variant - polished AI button */\n.btn-agent {\n background: linear-gradient(135deg, #ff6b00 0%, #ff8533 100%);\n border: 1px solid transparent;\n color: #ffffff;\n position: relative;\n overflow: hidden;\n}\n\n.btn-agent::before {\n content: '';\n position: absolute;\n top: 0;\n left: -100%;\n width: 100%;\n height: 100%;\n background: linear-gradient(\n 90deg,\n transparent,\n rgba(255, 255, 255, 0.15),\n transparent\n );\n transition: left 0.6s ease;\n}\n\n.btn-agent:hover:not(:disabled) {\n box-shadow: 0 2px 8px rgba(255, 107, 0, 0.25);\n}\n\n.btn-agent:hover:not(:disabled)::before {\n left: 100%;\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .btn {\n min-height: var(--touch-target-min);\n }\n\n .btn-sm {\n min-height: 36px;\n font-size: 13px;\n padding: var(--space-2) var(--space-3);\n }\n\n .btn-md {\n min-height: var(--touch-target-min);\n font-size: 14px;\n padding: var(--space-3) var(--space-4);\n }\n}\n" }, { "path": "src/components/common/Button.tsx", "content": "import { forwardRef, type ButtonHTMLAttributes } from 'react';\nimport './Button.css';\n\nexport interface ButtonProps extends ButtonHTMLAttributes {\n variant?: 'default' | 'primary' | 'ghost' | 'danger' | 'agent';\n size?: 'sm' | 'md';\n}\n\nexport const Button = forwardRef(\n ({ variant = 'default', size = 'md', className = '', children, ...props }, ref) => {\n const classes = ['btn', `btn-${variant}`, `btn-${size}`, className]\n .filter(Boolean)\n .join(' ');\n\n return (\n \n );\n }\n);\n\nButton.displayName = 'Button';\n" }, { "path": "src/components/common/ErrorBoundary.css", "content": ".error-boundary {\n display: flex;\n align-items: center;\n justify-content: center;\n min-height: 200px;\n padding: 2rem;\n}\n\n.error-boundary-content {\n text-align: center;\n max-width: 400px;\n}\n\n.error-boundary-content h2 {\n color: var(--color-text);\n margin-bottom: 0.5rem;\n}\n\n.error-boundary-content p {\n color: var(--color-text-secondary);\n margin-bottom: 1rem;\n}\n\n.error-boundary-retry {\n padding: 0.5rem 1rem;\n background: var(--color-primary);\n color: white;\n border: none;\n border-radius: 4px;\n cursor: pointer;\n font-size: 0.875rem;\n}\n\n.error-boundary-retry:hover {\n opacity: 0.9;\n}\n" }, { "path": "src/components/common/ErrorBoundary.tsx", "content": "import { Component, type ReactNode, type ErrorInfo } from 'react';\nimport './ErrorBoundary.css';\n\ninterface ErrorBoundaryProps {\n children: ReactNode;\n fallback?: ReactNode;\n}\n\ninterface ErrorBoundaryState {\n hasError: boolean;\n error: Error | null;\n}\n\n/**\n * Error Boundary component that catches JavaScript errors in child components\n * and displays a fallback UI instead of crashing the entire app.\n */\nexport class ErrorBoundary extends Component {\n constructor(props: ErrorBoundaryProps) {\n super(props);\n this.state = { hasError: false, error: null };\n }\n\n static getDerivedStateFromError(error: Error): ErrorBoundaryState {\n return { hasError: true, error };\n }\n\n componentDidCatch(error: Error, errorInfo: ErrorInfo): void {\n // Log error for debugging - this is intentional server-side logging\n console.error('[ErrorBoundary] Caught error:', error, errorInfo.componentStack);\n }\n\n handleRetry = (): void => {\n this.setState({ hasError: false, error: null });\n };\n\n render(): ReactNode {\n if (this.state.hasError) {\n if (this.props.fallback) {\n return this.props.fallback;\n }\n\n return (\n
\n
\n

Something went wrong

\n

{this.state.error?.message || 'An unexpected error occurred'}

\n \n
\n
\n );\n }\n\n return this.props.children;\n }\n}\n" }, { "path": "src/components/common/Input.css", "content": ".input-wrapper {\n display: flex;\n flex-direction: column;\n gap: var(--space-1);\n}\n\n.input-label {\n font-size: 12px;\n font-weight: 500;\n color: var(--color-text-secondary);\n}\n\n.input {\n font-family: var(--font-mono);\n font-size: 14px;\n padding: var(--space-2) var(--space-3);\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n color: var(--color-text-primary);\n transition: border-color var(--transition-fast);\n}\n\n.input::placeholder {\n color: var(--color-text-muted);\n}\n\n.input:focus {\n outline: none;\n border-color: var(--color-accent-primary);\n}\n\n.input:disabled {\n background: var(--color-bg-secondary);\n cursor: not-allowed;\n}\n\n.input-error {\n border-color: var(--color-error);\n}\n\n.input-error:focus {\n border-color: var(--color-error);\n}\n\n.input-error-text {\n font-size: 12px;\n color: var(--color-error);\n}\n\n.textarea {\n min-height: 100px;\n resize: vertical;\n}\n\n/* ============================================\n Mobile Styles\n ============================================ */\n@media (max-width: 767px) {\n .input {\n font-size: 16px; /* Prevent iOS zoom */\n min-height: var(--touch-target-min);\n padding: var(--space-3);\n }\n\n .input-label {\n font-size: 13px;\n }\n\n .textarea {\n min-height: 120px;\n font-size: 16px;\n }\n}\n" }, { "path": "src/components/common/Input.tsx", "content": "import { forwardRef, type InputHTMLAttributes, type TextareaHTMLAttributes } from 'react';\nimport './Input.css';\n\nexport interface InputProps extends InputHTMLAttributes {\n label?: string;\n error?: string;\n}\n\nexport const Input = forwardRef(\n ({ label, error, className = '', id, ...props }, ref) => {\n const inputId = id || props.name;\n\n return (\n
\n {label && (\n \n )}\n \n {error && {error}}\n
\n );\n }\n);\n\nInput.displayName = 'Input';\n\nexport interface TextareaProps extends TextareaHTMLAttributes {\n label?: string;\n error?: string;\n}\n\nexport const Textarea = forwardRef(\n ({ label, error, className = '', id, ...props }, ref) => {\n const inputId = id || props.name;\n\n return (\n
\n {label && (\n \n )}\n \n {error && {error}}\n
\n );\n }\n);\n\nTextarea.displayName = 'Textarea';\n" }, { "path": "src/components/common/McpIcon.tsx", "content": "/**\n * Reusable MCP service icon component\n */\n\ninterface McpIconProps {\n type: 'google-docs' | 'google-sheets' | 'gmail' | 'github' | 'sandbox' | 'claude-code' | 'generic';\n size?: number;\n className?: string;\n}\n\nexport function McpIcon({ type, size = 20, className = '' }: McpIconProps) {\n const style = { width: size, height: size };\n\n switch (type) {\n case 'google-docs':\n return (\n \n {/* Document with folded corner and lines */}\n \n \n \n \n \n );\n\n case 'google-sheets':\n return (\n \n {/* Spreadsheet grid */}\n \n \n \n \n \n \n );\n\n case 'gmail':\n return (\n \n {/* Envelope with clear shape */}\n \n \n \n );\n\n case 'github':\n return (\n \n {/* Git fork / merge icon */}\n \n \n \n \n \n );\n\n case 'claude-code':\n return (\n \n {/* Terminal/code brackets with sparkle */}\n \n \n \n \n );\n\n case 'sandbox':\n return (\n \n {/* Container/box icon */}\n \n \n \n \n );\n\n case 'generic':\n default:\n return (\n \n \n \n \n \n );\n }\n}\n\n/**\n * Agent icon - fun robot/AI assistant icon\n */\ninterface AgentIconProps {\n size?: number;\n className?: string;\n}\n\nexport function AgentIcon({ size = 20, className = '' }: AgentIconProps) {\n const style = { width: size, height: size };\n\n return (\n \n {/* Robot head */}\n \n {/* Antenna */}\n \n \n {/* Eyes */}\n \n \n {/* Mouth */}\n \n {/* Ears */}\n \n \n \n );\n}\n\n/**\n * Get icon type from MCP tool name\n */\nexport function getIconTypeFromTool(toolName: string): McpIconProps['type'] {\n if (toolName.startsWith('Google_Docs__') || toolName.startsWith('GoogleDocs__')) {\n return 'google-docs';\n }\n if (toolName.startsWith('Google_Sheets__') || toolName.startsWith('GoogleSheets__')) {\n return 'google-sheets';\n }\n if (toolName.startsWith('Gmail__')) {\n return 'gmail';\n }\n if (toolName.startsWith('GitHub__') || toolName.startsWith('Sandbox__')) {\n return 'sandbox';\n }\n return 'generic';\n}\n" }, { "path": "src/components/common/Modal.css", "content": ".modal-overlay {\n position: fixed;\n inset: 0;\n background: rgba(0, 0, 0, 0.4);\n display: flex;\n align-items: center;\n justify-content: center;\n z-index: 1000;\n padding: var(--space-4);\n animation: modalOverlayIn 0.15s ease-out;\n}\n\n@keyframes modalOverlayIn {\n from {\n opacity: 0;\n }\n to {\n opacity: 1;\n }\n}\n\n.modal {\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--border-radius);\n box-shadow: var(--shadow-lg);\n max-height: calc(100vh - var(--space-8));\n overflow: hidden;\n display: flex;\n flex-direction: column;\n animation: modalIn 0.15s ease-out;\n}\n\n@keyframes modalIn {\n from {\n opacity: 0;\n transform: scale(0.97);\n }\n to {\n opacity: 1;\n transform: scale(1);\n }\n}\n\n@keyframes modalWiggle {\n 0%, 100% { transform: translateX(0); }\n 20% { transform: translateX(-6px); }\n 40% { transform: translateX(6px); }\n 60% { transform: translateX(-4px); }\n 80% { transform: translateX(4px); }\n}\n\n.modal-wiggle {\n animation: modalWiggle 0.4s ease-out;\n}\n\n.modal-sm {\n width: 100%;\n max-width: 400px;\n}\n\n.modal-md {\n width: 100%;\n max-width: 560px;\n}\n\n.modal-lg {\n width: 100%;\n max-width: 720px;\n}\n\n.modal-full {\n width: 100%;\n max-width: 1200px;\n height: calc(100vh - var(--space-8));\n}\n\n.modal-settings {\n width: 100%;\n max-width: 860px;\n height: min(640px, calc(100vh - var(--space-8)));\n}\n\n.modal-header {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding: var(--space-3) var(--space-4);\n border-bottom: 1px solid var(--color-border-default);\n}\n\n.modal-header-left {\n display: flex;\n align-items: center;\n gap: var(--space-2);\n}\n\n.modal-back {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 28px;\n height: 28px;\n padding: 0;\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n color: var(--color-text-muted);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.modal-back:hover {\n background: var(--color-bg-tertiary);\n color: var(--color-text-primary);\n}\n\n.modal-title {\n margin: 0;\n font-size: 14px;\n font-weight: 600;\n color: var(--color-text-primary);\n flex-shrink: 0;\n}\n\n/* Parent badge in header - styled like link pills */\n.modal-parent-badge {\n display: inline-flex;\n align-items: center;\n gap: 4px;\n padding: 2px 8px 2px 6px;\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: 999px;\n font-size: 12px;\n font-weight: 500;\n color: var(--color-text-primary);\n cursor: pointer;\n transition: all var(--transition-fast);\n max-width: 200px;\n}\n\n.modal-parent-badge:hover {\n background: var(--color-bg-tertiary);\n border-color: var(--color-border-emphasis);\n}\n\n.modal-parent-badge-label {\n color: var(--color-text-muted);\n flex-shrink: 0;\n font-weight: 400;\n}\n\n.modal-parent-badge-title {\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.modal-close {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 28px;\n height: 28px;\n padding: 0;\n background: transparent;\n border: none;\n border-radius: var(--border-radius);\n color: var(--color-text-muted);\n font-size: 20px;\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.modal-close:hover {\n background: var(--color-bg-tertiary);\n color: var(--color-text-primary);\n}\n\n.modal-content {\n padding: var(--space-4);\n overflow-x: hidden;\n overflow-y: auto;\n flex: 1;\n min-height: 0; /* Allow flex child to shrink */\n}\n\n/* Full/settings modal content should not have its own scroll - let children handle it */\n.modal-full .modal-content,\n.modal-settings .modal-content {\n padding: 0;\n overflow: hidden;\n}\n\n/* ============================================\n Mobile Styles - Full Screen Modals\n ============================================ */\n@media (max-width: 767px) {\n .modal-overlay {\n padding: 0;\n align-items: stretch;\n }\n\n .modal,\n .modal-sm,\n .modal-md,\n .modal-lg,\n .modal-full {\n width: 100%;\n max-width: 100%;\n height: 100%;\n max-height: 100%;\n border-radius: 0;\n border: none;\n }\n\n .modal-header {\n position: sticky;\n top: 0;\n z-index: 10;\n background: var(--color-bg-primary);\n padding: var(--space-3) var(--space-4);\n min-height: var(--header-height);\n }\n\n .modal-back,\n .modal-close {\n width: var(--touch-target-min);\n height: var(--touch-target-min);\n font-size: 24px;\n }\n\n .modal-title {\n font-size: 16px;\n }\n\n .modal-content {\n flex: 1;\n padding: var(--space-4);\n overflow-y: auto;\n -webkit-overflow-scrolling: touch;\n padding-bottom: env(safe-area-inset-bottom, var(--space-4));\n }\n\n .modal-full .modal-content {\n padding: 0;\n }\n}\n" }, { "path": "src/components/common/Modal.tsx", "content": "import { useEffect, useRef, useState, useCallback, type ReactNode } from 'react';\nimport { createPortal } from 'react-dom';\nimport './Modal.css';\n\nexport interface ModalProps {\n isOpen: boolean;\n onClose: () => void;\n title?: string;\n titleBadge?: ReactNode;\n children: ReactNode;\n width?: 'sm' | 'md' | 'lg' | 'full' | 'settings';\n showBackButton?: boolean;\n onBack?: () => void;\n /** Return true to prevent close and trigger wiggle animation */\n preventClose?: () => boolean;\n /** Called when close was prevented */\n onCloseBlocked?: () => void;\n}\n\nexport function Modal({ isOpen, onClose, title, titleBadge, children, width = 'md', showBackButton, onBack, preventClose, onCloseBlocked }: ModalProps) {\n const overlayRef = useRef(null);\n const [isWiggling, setIsWiggling] = useState(false);\n\n // Reset wiggle state when modal closes\n useEffect(() => {\n if (!isOpen) {\n setIsWiggling(false);\n }\n }, [isOpen]);\n\n const attemptClose = useCallback(() => {\n if (preventClose?.()) {\n // Restart animation by removing and re-adding class\n setIsWiggling(false);\n requestAnimationFrame(() => {\n setIsWiggling(true);\n });\n onCloseBlocked?.();\n return;\n }\n onClose();\n }, [preventClose, onCloseBlocked, onClose]);\n\n useEffect(() => {\n const handleEscape = (e: KeyboardEvent) => {\n if (e.key === 'Escape') {\n attemptClose();\n }\n };\n\n if (isOpen) {\n document.addEventListener('keydown', handleEscape);\n document.body.style.overflow = 'hidden';\n }\n\n return () => {\n document.removeEventListener('keydown', handleEscape);\n document.body.style.overflow = '';\n };\n }, [isOpen, attemptClose]);\n\n const handleOverlayClick = (e: React.MouseEvent) => {\n if (e.target === overlayRef.current) {\n attemptClose();\n }\n };\n\n if (!isOpen) return null;\n\n return createPortal(\n
\n
\n {title && (\n
\n
\n {showBackButton && onBack && (\n \n )}\n

{title}

\n {titleBadge}\n
\n \n
\n )}\n
{children}
\n
\n
,\n document.body\n );\n}\n" }, { "path": "src/components/common/RichTextEditor.css", "content": "/* RichTextEditor - contenteditable with inline pills */\n\n.rte-container {\n display: flex;\n flex-direction: column;\n gap: var(--space-2);\n}\n\n.rte-label {\n font-size: var(--text-sm);\n font-weight: 500;\n color: var(--color-text-secondary);\n}\n\n.rte-wrapper {\n position: relative;\n}\n\n.rte-editor {\n width: 100%;\n min-height: 100px;\n max-height: 280px;\n padding: var(--space-3);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n font-size: var(--text-sm);\n line-height: 1.5;\n background: var(--color-bg-primary);\n color: var(--color-text-primary);\n transition: border-color var(--transition-fast), box-shadow var(--transition-fast);\n outline: none;\n overflow-y: auto;\n white-space: pre-wrap;\n word-wrap: break-word;\n}\n\n.rte-editor:focus {\n border-color: var(--color-primary);\n box-shadow: 0 0 0 3px var(--color-primary-subtle);\n}\n\n/* Placeholder */\n.rte-editor.rte-empty::before {\n content: attr(data-placeholder);\n color: var(--color-text-muted);\n pointer-events: none;\n position: absolute;\n}\n\n/* Inline pill styling */\n.rte-pill {\n display: inline-flex;\n align-items: center;\n gap: 4px;\n padding: 0 6px 0 4px;\n margin: 0 1px;\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: 999px;\n font-size: 12px;\n font-weight: 500;\n line-height: 1.4;\n color: var(--color-text-primary);\n text-decoration: none;\n vertical-align: text-bottom;\n cursor: pointer;\n user-select: none;\n}\n\n.rte-pill:hover {\n background: var(--color-bg-tertiary);\n border-color: var(--color-border-emphasis);\n color: var(--color-text-primary);\n text-decoration: none;\n}\n\n.rte-pill:visited {\n color: var(--color-text-primary);\n}\n\n.rte-pill-icon {\n display: inline-flex;\n width: 12px;\n height: 12px;\n flex-shrink: 0;\n}\n\n/* Icon colors by type */\n.rte-pill-icon[data-type=\"google_doc\"]::before {\n content: '';\n width: 12px;\n height: 12px;\n background: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='%234285F4' d='M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8l-6-6z'/%3E%3Cpath fill='%23fff' d='M14 2v6h6'/%3E%3Cpath fill='none' stroke='%23fff' stroke-width='1.5' d='M8 13h8M8 17h5'/%3E%3C/svg%3E\") no-repeat center;\n background-size: contain;\n}\n\n.rte-pill-icon[data-type=\"google_sheet\"]::before {\n content: '';\n width: 12px;\n height: 12px;\n background: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='%2334A853' d='M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8l-6-6z'/%3E%3Cpath fill='%23fff' d='M14 2v6h6'/%3E%3Crect x='7' y='12' width='10' height='7' fill='none' stroke='%23fff' stroke-width='1'/%3E%3Cline x1='7' y1='15' x2='17' y2='15' stroke='%23fff' stroke-width='1'/%3E%3Cline x1='12' y1='12' x2='12' y2='19' stroke='%23fff' stroke-width='1'/%3E%3C/svg%3E\") no-repeat center;\n background-size: contain;\n}\n\n.rte-pill-icon[data-type=\"github_pr\"]::before,\n.rte-pill-icon[data-type=\"github_issue\"]::before,\n.rte-pill-icon[data-type=\"github_repo\"]::before {\n content: '';\n width: 12px;\n height: 12px;\n background: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%23333'%3E%3Cpath d='M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z'/%3E%3C/svg%3E\") no-repeat center;\n background-size: contain;\n}\n\n.rte-pill-title {\n max-width: 180px;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n/* Inline link styling */\n.rte-link {\n color: var(--color-primary);\n text-decoration: underline;\n text-decoration-color: var(--color-primary-subtle);\n text-underline-offset: 2px;\n cursor: text;\n transition: text-decoration-color var(--transition-fast);\n}\n\n.rte-link:hover {\n text-decoration-color: var(--color-primary);\n}\n\n.rte-link:visited {\n color: var(--color-primary);\n}\n\n/* Link hover tooltip */\n.rte-link-tooltip {\n display: inline-flex;\n align-items: center;\n gap: 4px;\n padding: 6px 8px;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n font-size: 12px;\n z-index: 10000;\n animation: tooltipFadeIn 0.15s ease-out;\n}\n\n.rte-link-tooltip-url {\n max-width: 200px;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n color: var(--color-text-secondary);\n font-size: 11px;\n text-decoration: none;\n cursor: pointer;\n transition: color var(--transition-fast);\n}\n\n.rte-link-tooltip-url:hover {\n color: var(--color-primary);\n}\n\n.rte-link-tooltip-divider {\n width: 1px;\n height: 16px;\n background: var(--color-border-default);\n margin: 0 2px;\n}\n\n.rte-link-tooltip-btn {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n padding: 4px;\n background: transparent;\n border: none;\n border-radius: var(--radius-sm);\n color: var(--color-text-muted);\n cursor: pointer;\n transition: background var(--transition-fast), color var(--transition-fast);\n}\n\n.rte-link-tooltip-btn:hover {\n background: var(--color-bg-tertiary);\n color: var(--color-text-primary);\n}\n\n.rte-link-tooltip-btn-danger:hover {\n background: var(--color-bg-tertiary);\n color: var(--color-danger);\n}\n\n/* Floating tooltip */\n.rte-tooltip {\n display: inline-flex;\n align-items: center;\n gap: 6px;\n padding: 6px 10px;\n background: var(--color-bg-primary);\n border: 1px solid var(--color-border-default);\n border-radius: var(--radius-md);\n box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n font-size: 12px;\n color: var(--color-text-secondary);\n z-index: 10000;\n animation: tooltipFadeIn 0.15s ease-out;\n}\n\n@keyframes tooltipFadeIn {\n from {\n opacity: 0;\n transform: translateY(-4px);\n }\n to {\n opacity: 1;\n transform: translateY(0);\n }\n}\n\n.rte-tooltip-loading {\n color: var(--color-text-muted);\n font-style: italic;\n}\n\n.rte-tooltip-key {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n padding: 2px 6px;\n background: var(--color-bg-tertiary);\n border: 1px solid var(--color-border-default);\n border-radius: 4px;\n font-size: 10px;\n font-family: var(--font-mono);\n font-weight: 500;\n color: var(--color-text-muted);\n text-transform: lowercase;\n}\n\n.rte-tooltip-text {\n color: var(--color-text-muted);\n}\n\n.rte-tooltip-pill {\n display: inline-flex;\n align-items: center;\n gap: 4px;\n padding: 2px 8px 2px 6px;\n background: var(--color-bg-secondary);\n border: 1px solid var(--color-border-default);\n border-radius: 999px;\n font-size: 12px;\n font-weight: 500;\n color: var(--color-text-primary);\n cursor: pointer;\n transition: background 0.15s ease, border-color 0.15s ease;\n}\n\n.rte-tooltip-pill:hover {\n background: var(--color-bg-tertiary);\n border-color: var(--color-border-emphasis);\n}\n\n.rte-tooltip-title {\n max-width: 150px;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n/* Mobile adjustments */\n@media (max-width: 767px) {\n .rte-tooltip {\n max-width: calc(100vw - 32px);\n }\n\n .rte-tooltip-title {\n max-width: 100px;\n }\n\n .rte-pill-title {\n max-width: 120px;\n }\n\n .rte-link-tooltip {\n max-width: calc(100vw - 32px);\n }\n\n .rte-link-tooltip-url {\n max-width: 120px;\n }\n}\n" }, { "path": "src/components/common/RichTextEditor.tsx", "content": "/**\n * RichTextEditor - contenteditable editor with inline pill rendering\n *\n * Renders pill markdown as visual LinkPill components.\n * Handles paste events for URL detection.\n * Converts back to markdown format on change.\n */\n\nimport {\n useRef,\n useEffect,\n useCallback,\n useState,\n type ClipboardEvent,\n type KeyboardEvent,\n} from 'react';\nimport type { LinkPillType } from '../../types';\nimport { createPortal } from 'react-dom';\nimport { McpIcon } from './McpIcon';\nimport './RichTextEditor.css';\n\n// Regex to match [pill:type:title](url) syntax\nconst PILL_REGEX = /\\[pill:([^:]+):([^\\]]+)\\]\\(([^)]+)\\)/g;\n\n// Regex to match markdown links [text](url) - but NOT pills\nconst MARKDOWN_LINK_REGEX = /\\[([^\\]]+)\\]\\((https?:\\/\\/[^)]+)\\)/g;\n\n// Regex to match bare URLs (http/https) - used for auto-linking on input\n// Negative lookbehind to exclude trailing punctuation\nconst URL_REGEX = /https?:\\/\\/[^\\s<>\")\\]]+(? void;\n onPaste?: (e: ClipboardEvent) => void;\n /** Called after paste with the URL end position in the markdown */\n onPasteUrlPosition?: (endIndex: number) => void;\n placeholder?: string;\n rows?: number;\n label?: string;\n /** Pending URL for pill conversion tooltip */\n pendingUrl?: PendingUrl | null;\n isCheckingUrl?: boolean;\n onAcceptPill?: () => void;\n onDismissPill?: () => void;\n}\n\ninterface PillData {\n type: LinkPillType;\n title: string;\n url: string;\n}\n\ninterface LinkData {\n url: string;\n text?: string; // Display text (defaults to URL if not provided)\n}\n\ntype Segment = {\n type: 'text' | 'pill' | 'link';\n content: string;\n pill?: PillData;\n link?: LinkData;\n};\n\n/**\n * Create a link element with proper styling and event handlers\n */\nfunction createLinkElement(url: string, displayText?: string): HTMLAnchorElement {\n const linkEl = document.createElement('a');\n linkEl.className = 'rte-link';\n linkEl.href = url;\n linkEl.target = '_blank';\n linkEl.rel = 'noopener noreferrer';\n linkEl.dataset.linkUrl = url;\n linkEl.textContent = displayText || url;\n\n // Handle click: normal click positions cursor, Cmd/Ctrl+click opens link\n linkEl.addEventListener('click', (e) => {\n if (e.metaKey || e.ctrlKey) {\n e.preventDefault();\n window.open(linkEl.href, '_blank', 'noopener,noreferrer');\n } else {\n e.preventDefault(); // Prevent navigation, allow cursor positioning\n }\n });\n\n // Handle double-click: open link in new tab\n linkEl.addEventListener('dblclick', (e) => {\n e.preventDefault();\n window.open(linkEl.href, '_blank', 'noopener,noreferrer');\n });\n\n return linkEl;\n}\n\n/**\n * Parse markdown links within a text string, returning segments of text and links\n * Only detects explicit markdown syntax [text](url), NOT bare URLs\n */\nfunction parseLinksInText(text: string): Segment[] {\n const result: Segment[] = [];\n let lastIndex = 0;\n let match: RegExpExecArray | null;\n\n MARKDOWN_LINK_REGEX.lastIndex = 0;\n\n while ((match = MARKDOWN_LINK_REGEX.exec(text)) !== null) {\n // Add text before link\n if (match.index > lastIndex) {\n result.push({ type: 'text', content: text.slice(lastIndex, match.index) });\n }\n\n const [fullMatch, linkText, url] = match;\n // Add as link segment\n result.push({\n type: 'link',\n content: fullMatch,\n link: { url, text: linkText },\n });\n\n lastIndex = match.index + fullMatch.length;\n }\n\n // Add remaining text\n if (lastIndex < text.length) {\n result.push({ type: 'text', content: text.slice(lastIndex) });\n }\n\n return result.length > 0 ? result : [{ type: 'text', content: text }];\n}\n\n/**\n * Parse markdown to extract pills, links, and text segments\n * Links must be in markdown syntax [text](url) - bare URLs are treated as plain text\n */\nfunction parseMarkdown(markdown: string): Segment[] {\n const segments: Segment[] = [];\n let lastIndex = 0;\n let match: RegExpExecArray | null;\n\n PILL_REGEX.lastIndex = 0;\n\n // First pass: extract pills\n while ((match = PILL_REGEX.exec(markdown)) !== null) {\n if (match.index > lastIndex) {\n segments.push({\n type: 'text',\n content: markdown.slice(lastIndex, match.index),\n });\n }\n\n const [fullMatch, pillType, title, url] = match;\n segments.push({\n type: 'pill',\n content: fullMatch,\n pill: { type: pillType as LinkPillType, title, url },\n });\n\n lastIndex = match.index + fullMatch.length;\n }\n\n if (lastIndex < markdown.length) {\n segments.push({\n type: 'text',\n content: markdown.slice(lastIndex),\n });\n }\n\n // Second pass: detect markdown links [text](url) within text segments\n return segments.flatMap((segment) => {\n if (segment.type !== 'text') return [segment];\n return parseLinksInText(segment.content);\n });\n}\n\n/**\n * Convert HTML content back to markdown\n */\nfunction htmlToMarkdown(element: HTMLElement): string {\n let result = '';\n const ZWS = '\\u200B';\n let lastAddedNewline = false;\n\n const walker = document.createTreeWalker(element, NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_TEXT);\n\n let node: Node | null = walker.currentNode;\n while (node) {\n if (node.nodeType === Node.TEXT_NODE) {\n // Strip zero-width spaces (used for cursor positioning)\n const text = (node.textContent || '').replace(new RegExp(ZWS, 'g'), '');\n result += text;\n if (text.length > 0) {\n lastAddedNewline = false;\n }\n } else if (node instanceof HTMLElement) {\n if (node.classList.contains('rte-pill')) {\n const type = node.dataset.pillType || 'google_doc';\n const title = node.dataset.pillTitle || '';\n const url = node.dataset.pillUrl || '';\n result += `[pill:${type}:${title}](${url})`;\n lastAddedNewline = false;\n // Skip ALL descendants of pill - find next node that's not inside this pill\n let next: Node | null = walker.nextSibling();\n while (!next) {\n const parent = walker.parentNode();\n if (!parent || parent === element) break;\n next = walker.nextSibling();\n }\n node = next;\n continue;\n } else if (node.classList.contains('rte-link')) {\n // For links, the text content IS the URL (user may have edited it)\n const linkText = node.textContent || '';\n // Check if the edited text is still a valid URL\n URL_REGEX.lastIndex = 0;\n const urlMatch = URL_REGEX.exec(linkText);\n if (urlMatch && urlMatch[0] === linkText.trim()) {\n // Text is a valid URL - use it as both text and href\n result += `[${linkText}](${linkText})`;\n } else {\n // Text is no longer a valid URL - output as plain text (unlink)\n result += linkText;\n }\n lastAddedNewline = false;\n // Skip ALL descendants of link - find next node that's not inside this link\n let next: Node | null = walker.nextSibling();\n while (!next) {\n const parent = walker.parentNode();\n if (!parent || parent === element) break;\n next = walker.nextSibling();\n }\n node = next;\n continue;\n } else if (node.tagName === 'BR') {\n result += '\\n';\n lastAddedNewline = true;\n } else if (node.tagName === 'DIV' && node !== element && node.previousSibling) {\n // Divs after the first act as line breaks in contenteditable\n // But don't add newline if we just added one (avoids double-counting with BR)\n // and don't add leading newline if there's no content yet\n if (result.length > 0 && !lastAddedNewline) {\n result += '\\n';\n lastAddedNewline = true;\n }\n }\n }\n node = walker.nextNode();\n }\n\n return result;\n}\n\n/**\n * Get icon type for pill type\n */\nfunction getIconType(type: LinkPillType): 'google-docs' | 'google-sheets' | 'github' {\n switch (type) {\n case 'google_doc':\n return 'google-docs';\n case 'google_sheet':\n return 'google-sheets';\n case 'github_pr':\n case 'github_issue':\n case 'github_repo':\n return 'github';\n }\n}\n\nexport function RichTextEditor({\n value,\n onChange,\n onPaste,\n onPasteUrlPosition,\n placeholder = '',\n rows = 4,\n label,\n pendingUrl,\n isCheckingUrl,\n onAcceptPill,\n onDismissPill,\n}: RichTextEditorProps) {\n const editorRef = useRef(null);\n const [isFocused, setIsFocused] = useState(false);\n const [tooltipPosition, setTooltipPosition] = useState<{ top: number; left: number } | null>(null);\n const isUpdatingRef = useRef(false);\n\n // Link hover tooltip state\n const [hoveredLink, setHoveredLink] = useState<{\n url: string;\n linkIndex: number; // Index of this link among all links (survives re-renders)\n position: { top: number; left: number };\n } | null>(null);\n const hoverTimeoutRef = useRef | null>(null);\n // Store pasted text to linkify in next input event\n const pendingPasteRef = useRef(null);\n\n useEffect(() => {\n return () => {\n if (hoverTimeoutRef.current) {\n clearTimeout(hoverTimeoutRef.current);\n }\n };\n }, []);\n\n // Render markdown as HTML with pill elements\n const renderContent = useCallback(() => {\n if (!editorRef.current || isUpdatingRef.current) return;\n\n const segments = parseMarkdown(value);\n const fragment = document.createDocumentFragment();\n const ZWS = '\\u200B'; // Zero-width space for cursor positioning\n\n let lastNodeType: 'text' | 'br' | 'pill' | 'link' | 'none' = 'none';\n\n segments.forEach((segment) => {\n if (segment.type === 'text') {\n // Split by newlines and add
elements\n const lines = segment.content.split('\\n');\n lines.forEach((line, i) => {\n if (i > 0) {\n fragment.appendChild(document.createElement('br'));\n lastNodeType = 'br';\n }\n if (line) {\n fragment.appendChild(document.createTextNode(line));\n lastNodeType = 'text';\n }\n });\n } else if (segment.type === 'link' && segment.link) {\n const linkEl = createLinkElement(segment.link.url, segment.link.text);\n fragment.appendChild(linkEl);\n lastNodeType = 'link';\n } else if (segment.pill) {\n // Add ZWS before pill if it follows a BR or is first element (cursor can't render there otherwise)\n if (lastNodeType === 'br' || lastNodeType === 'none') {\n fragment.appendChild(document.createTextNode(ZWS));\n }\n\n // Create pill as a link element\n const pillLink = document.createElement('a');\n pillLink.className = 'rte-pill';\n pillLink.contentEditable = 'false';\n pillLink.href = segment.pill.url;\n pillLink.target = '_blank';\n pillLink.rel = 'noopener noreferrer';\n pillLink.dataset.pillType = segment.pill.type;\n pillLink.dataset.pillTitle = segment.pill.title;\n pillLink.dataset.pillUrl = segment.pill.url;\n\n // Build pill content using DOM APIs (safe from XSS)\n const iconSpan = document.createElement('span');\n iconSpan.className = 'rte-pill-icon';\n iconSpan.dataset.type = segment.pill.type;\n\n const titleSpan = document.createElement('span');\n titleSpan.className = 'rte-pill-title';\n titleSpan.textContent = segment.pill.title; // textContent escapes HTML\n\n pillLink.appendChild(iconSpan);\n pillLink.appendChild(titleSpan);\n fragment.appendChild(pillLink);\n lastNodeType = 'pill';\n }\n });\n\n // Save selection\n const selection = window.getSelection();\n const savedRange = selection?.rangeCount ? selection.getRangeAt(0) : null;\n const wasAtEnd = savedRange && editorRef.current.contains(savedRange.endContainer) &&\n savedRange.endOffset === (savedRange.endContainer.textContent?.length || 0);\n\n editorRef.current.innerHTML = '';\n editorRef.current.appendChild(fragment);\n\n // Restore cursor to end if it was there\n if (isFocused && wasAtEnd && editorRef.current.lastChild) {\n const range = document.createRange();\n range.selectNodeContents(editorRef.current);\n range.collapse(false);\n selection?.removeAllRanges();\n selection?.addRange(range);\n }\n }, [value, isFocused]);\n\n // Initial render and value changes\n useEffect(() => {\n renderContent();\n }, [renderContent]);\n\n // Validate and update links in-place (without full re-render)\n const validateLinksInPlace = useCallback(() => {\n if (!editorRef.current) return;\n\n const selection = window.getSelection();\n const links = editorRef.current.querySelectorAll('a.rte-link');\n\n links.forEach((link) => {\n const text = link.textContent || '';\n URL_REGEX.lastIndex = 0;\n const match = URL_REGEX.exec(text);\n const isValidUrl = match && match[0] === text.trim();\n\n if (isValidUrl) {\n // Update href and data attribute to match edited text\n (link as HTMLAnchorElement).href = text;\n (link as HTMLElement).dataset.linkUrl = text;\n } else {\n // Text is no longer a valid URL - unwrap to plain text\n // Save cursor position relative to link\n let cursorOffset = 0;\n let cursorInLink = false;\n if (selection?.rangeCount) {\n const range = selection.getRangeAt(0);\n if (link.contains(range.startContainer)) {\n cursorInLink = true;\n // Calculate offset from start of link text\n if (range.startContainer.nodeType === Node.TEXT_NODE) {\n cursorOffset = range.startOffset;\n }\n }\n }\n\n const textNode = document.createTextNode(text);\n link.parentNode?.replaceChild(textNode, link);\n\n // Restore cursor position\n if (cursorInLink && selection) {\n try {\n const newRange = document.createRange();\n newRange.setStart(textNode, Math.min(cursorOffset, text.length));\n newRange.collapse(true);\n selection.removeAllRanges();\n selection.addRange(newRange);\n } catch {\n // Ignore cursor restoration errors\n }\n }\n }\n });\n }, []);\n\n // Linkify URL immediately before cursor (called after space/enter)\n const linkifyUrlBeforeCursor = useCallback(() => {\n if (!editorRef.current) return;\n\n const selection = window.getSelection();\n if (!selection?.rangeCount) return;\n\n const range = selection.getRangeAt(0);\n if (!range.collapsed) return;\n\n const container = range.startContainer;\n const cursorPos = range.startOffset;\n\n // Case 1: Cursor in a text node (space was typed)\n if (container.nodeType === Node.TEXT_NODE) {\n if ((container.parentElement as HTMLElement)?.closest('.rte-link, .rte-pill')) return;\n\n const textNode = container as Text;\n const text = textNode.textContent || '';\n\n // Get text before cursor (excluding the just-typed space)\n const textBeforeCursor = text.slice(0, cursorPos - 1);\n if (!textBeforeCursor) return;\n\n URL_REGEX.lastIndex = 0;\n let lastMatch: RegExpExecArray | null = null;\n let match: RegExpExecArray | null;\n while ((match = URL_REGEX.exec(textBeforeCursor)) !== null) {\n lastMatch = { ...match, index: match.index } as RegExpExecArray;\n }\n\n // URL must end right before the space\n if (!lastMatch || lastMatch.index + lastMatch[0].length !== textBeforeCursor.length) {\n return;\n }\n\n const url = lastMatch[0];\n const isEnrichable = ENRICHABLE_URL_PATTERNS.some((pattern) => pattern.test(url));\n if (isEnrichable) return;\n\n const urlStart = lastMatch.index;\n const beforeUrl = text.slice(0, urlStart);\n const afterUrl = text.slice(urlStart + url.length);\n\n const linkEl = createLinkElement(url);\n\n const fragment = document.createDocumentFragment();\n if (beforeUrl) {\n fragment.appendChild(document.createTextNode(beforeUrl));\n }\n fragment.appendChild(linkEl);\n const afterNode = document.createTextNode(afterUrl);\n fragment.appendChild(afterNode);\n\n textNode.parentNode?.replaceChild(fragment, textNode);\n\n try {\n const newRange = document.createRange();\n newRange.setStart(afterNode, 1);\n newRange.collapse(true);\n selection.removeAllRanges();\n selection.addRange(newRange);\n } catch {\n // Ignore cursor restoration errors\n }\n return;\n }\n\n // Case 2: Cursor at start of new line after Enter (look at previous line)\n // Find the text node just before the cursor position\n let prevTextNode: Text | null = null;\n const cursorContainer = range.startContainer;\n const cursorOffset = range.startOffset;\n let nodeBeforeCursor: Node | null = null;\n\n if (cursorContainer.nodeType === Node.ELEMENT_NODE) {\n // Cursor is in an element - get the child just before cursor offset\n const element = cursorContainer as Element;\n if (cursorOffset > 0) {\n nodeBeforeCursor = element.childNodes[cursorOffset - 1];\n } else {\n // Cursor at start of element - look at previous sibling of element\n nodeBeforeCursor = element.previousSibling;\n }\n } else {\n // Cursor in a text node at position 0 - look at previous sibling\n nodeBeforeCursor = cursorContainer.previousSibling;\n }\n\n // Walk backwards from nodeBeforeCursor to find a text node ending with URL\n const findTextNodeEndingWithUrl = (startNode: Node | null): Text | null => {\n let current: Node | null = startNode;\n\n while (current) {\n if (current.nodeType === Node.TEXT_NODE) {\n const tn = current as Text;\n // Skip if inside link or pill\n if (!tn.parentElement?.closest('.rte-link, .rte-pill')) {\n const text = tn.textContent || '';\n if (text) {\n URL_REGEX.lastIndex = 0;\n let lastMatch: RegExpExecArray | null = null;\n let match: RegExpExecArray | null;\n while ((match = URL_REGEX.exec(text)) !== null) {\n lastMatch = { ...match, index: match.index } as RegExpExecArray;\n }\n // URL must be at the end of this text node\n if (lastMatch && lastMatch.index + lastMatch[0].length === text.length) {\n return tn;\n }\n // Found a text node that doesn't end with URL - stop looking\n return null;\n }\n }\n }\n\n // If it's an element, check its last text node descendant\n if (current.nodeType === Node.ELEMENT_NODE) {\n const element = current as Element;\n // Skip links and pills entirely\n if (!element.closest('.rte-link, .rte-pill')) {\n // Get the last text node inside this element\n const walker = document.createTreeWalker(element, NodeFilter.SHOW_TEXT, null);\n let lastTextInElement: Text | null = null;\n let n: Text | null;\n while ((n = walker.nextNode() as Text | null)) {\n lastTextInElement = n;\n }\n if (lastTextInElement) {\n const text = lastTextInElement.textContent || '';\n if (text && !lastTextInElement.parentElement?.closest('.rte-link, .rte-pill')) {\n URL_REGEX.lastIndex = 0;\n let lastMatch: RegExpExecArray | null = null;\n let match: RegExpExecArray | null;\n while ((match = URL_REGEX.exec(text)) !== null) {\n lastMatch = { ...match, index: match.index } as RegExpExecArray;\n }\n if (lastMatch && lastMatch.index + lastMatch[0].length === text.length) {\n return lastTextInElement;\n }\n // Found text that doesn't end with URL - stop\n return null;\n }\n }\n }\n }\n\n // Move to previous sibling, or parent's previous sibling\n if (current.previousSibling) {\n current = current.previousSibling;\n } else {\n current = current.parentNode;\n if (current === editorRef.current || !current) break;\n current = current.previousSibling;\n }\n }\n\n return null;\n };\n\n prevTextNode = findTextNodeEndingWithUrl(nodeBeforeCursor);\n\n if (!prevTextNode) return;\n\n const text = prevTextNode.textContent || '';\n URL_REGEX.lastIndex = 0;\n let lastMatch: RegExpExecArray | null = null;\n let match: RegExpExecArray | null;\n while ((match = URL_REGEX.exec(text)) !== null) {\n lastMatch = { ...match, index: match.index } as RegExpExecArray;\n }\n\n if (!lastMatch) return;\n\n const url = lastMatch[0];\n const isEnrichable = ENRICHABLE_URL_PATTERNS.some((pattern) => pattern.test(url));\n if (isEnrichable) return;\n\n const urlStart = lastMatch.index;\n const beforeUrl = text.slice(0, urlStart);\n\n const linkEl = createLinkElement(url);\n\n const fragment = document.createDocumentFragment();\n if (beforeUrl) {\n fragment.appendChild(document.createTextNode(beforeUrl));\n }\n fragment.appendChild(linkEl);\n\n prevTextNode.parentNode?.replaceChild(fragment, prevTextNode);\n }, []);\n\n // Simple markdown update without linkification (used after pill removal, etc.)\n const updateMarkdown = useCallback(() => {\n if (!editorRef.current) return;\n isUpdatingRef.current = true;\n const markdown = htmlToMarkdown(editorRef.current);\n onChange(markdown);\n isUpdatingRef.current = false;\n }, [onChange]);\n\n // Convert bare URLs in markdown to link syntax, but only for URLs in the pasted text\n const linkifyPastedUrlsInMarkdown = useCallback(\n (markdown: string, pastedText: string): string => {\n URL_REGEX.lastIndex = 0;\n const urlsInPaste: string[] = [];\n let match: RegExpExecArray | null;\n while ((match = URL_REGEX.exec(pastedText)) !== null) {\n urlsInPaste.push(match[0]);\n }\n if (urlsInPaste.length === 0) return markdown;\n\n // Replace each pasted URL with markdown link syntax (if not already linked)\n let result = markdown;\n for (const url of urlsInPaste) {\n const isEnrichable = ENRICHABLE_URL_PATTERNS.some((pattern) => pattern.test(url));\n if (isEnrichable) continue;\n\n // Find bare URL (not already in [text](url) or [pill:...](url) format)\n const escapedUrl = url.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n // Match URL not preceded by [ or ]( and not followed by ] or )\n // This prevents matching URLs already inside markdown link syntax\n const bareUrlRegex = new RegExp(\n `(?) => {\n if (!editorRef.current) return;\n isUpdatingRef.current = true;\n\n // First, validate/update links in place (handles edited links)\n validateLinksInPlace();\n\n // Check if user just typed space/enter - trigger URL linkification\n const inputEvent = e.nativeEvent as InputEvent;\n if (\n inputEvent.data === ' ' ||\n inputEvent.data === '\\n' ||\n inputEvent.inputType === 'insertParagraph' ||\n inputEvent.inputType === 'insertLineBreak'\n ) {\n linkifyUrlBeforeCursor();\n }\n\n let markdown = htmlToMarkdown(editorRef.current);\n\n // If there's a pending paste, linkify URLs from the pasted content\n if (pendingPasteRef.current) {\n // Remove artifact leading newlines only if content starts with pasted text\n // (i.e., editor was empty before paste). Preserves intentional empty lines above.\n const stripped = markdown.replace(/^\\n+/, '');\n if (stripped.startsWith(pendingPasteRef.current)) {\n markdown = stripped;\n }\n markdown = linkifyPastedUrlsInMarkdown(markdown, pendingPasteRef.current);\n pendingPasteRef.current = null;\n }\n\n onChange(markdown);\n\n // Reset flag via microtask - runs after current code but before React's effects\n // This ensures renderContent can run on the next render cycle\n queueMicrotask(() => {\n isUpdatingRef.current = false;\n });\n },\n [onChange, validateLinksInPlace, linkifyUrlBeforeCursor, linkifyPastedUrlsInMarkdown]\n );\n\n // Handle paste\n const handlePaste = useCallback(\n (e: ClipboardEvent) => {\n const pastedText = e.clipboardData?.getData('text') || '';\n\n // Store pasted text for linkification in handleInput\n if (pastedText) {\n pendingPasteRef.current = pastedText;\n }\n\n // Let parent handle URL detection\n onPaste?.(e);\n\n // Calculate tooltip position after paste completes\n requestAnimationFrame(() => {\n const selection = window.getSelection();\n if (selection?.rangeCount) {\n const range = selection.getRangeAt(0);\n const rect = range.getBoundingClientRect();\n setTooltipPosition({\n top: rect.bottom + 4,\n left: rect.left,\n });\n\n // Calculate the URL's end position in markdown\n if (editorRef.current && onPasteUrlPosition && pastedText) {\n const markdown = htmlToMarkdown(editorRef.current);\n // Find plain text URL (not inside pill syntax)\n let searchStart = 0;\n let foundIndex = -1;\n while (true) {\n const idx = markdown.indexOf(pastedText, searchStart);\n if (idx === -1) break;\n const prefix = markdown.slice(Math.max(0, idx - 2), idx);\n if (!prefix.endsWith('](')) {\n foundIndex = idx;\n }\n searchStart = idx + 1;\n }\n if (foundIndex !== -1) {\n onPasteUrlPosition(foundIndex + pastedText.length);\n }\n }\n }\n });\n },\n [onPaste, onPasteUrlPosition]\n );\n\n // Handle keyboard\n const handleKeyDown = useCallback(\n (e: KeyboardEvent) => {\n // Tab to accept pill\n if (e.key === 'Tab' && pendingUrl && onAcceptPill) {\n e.preventDefault();\n onAcceptPill();\n return;\n }\n // Escape to dismiss\n if (e.key === 'Escape' && pendingUrl && onDismissPill) {\n e.preventDefault();\n onDismissPill();\n return;\n }\n // Arrow keys or other navigation dismisses the prompt\n if (pendingUrl && ['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown', 'Home', 'End'].includes(e.key)) {\n onDismissPill?.();\n }\n\n // Get the node immediately before/after the cursor in DOM order\n const getAdjacentNode = (direction: 'before' | 'after'): Node | null => {\n const selection = window.getSelection();\n if (!selection?.rangeCount) return null;\n const range = selection.getRangeAt(0);\n if (!range.collapsed) return null;\n\n const node = range.startContainer;\n const offset = range.startOffset;\n\n if (direction === 'before') {\n if (node.nodeType === Node.TEXT_NODE) {\n // If at start of text node, get previous sibling\n if (offset === 0) {\n return node.previousSibling;\n }\n // Otherwise we're in the middle of text, no adjacent element\n return null;\n }\n // If in element node, get child at offset-1\n if (offset > 0) {\n return node.childNodes[offset - 1];\n }\n return null;\n } else {\n if (node.nodeType === Node.TEXT_NODE) {\n // If at end of text node, get next sibling\n if (offset === node.textContent?.length) {\n return node.nextSibling;\n }\n return null;\n }\n // If in element node, get child at offset\n return node.childNodes[offset] || null;\n }\n };\n\n const isPill = (node: Node | null): node is HTMLElement => {\n return node instanceof HTMLElement && node.classList.contains('rte-pill');\n };\n\n const ZWS = '\\u200B';\n const isZwsOnly = (node: Node | null): boolean => {\n return node?.nodeType === Node.TEXT_NODE && node.textContent === ZWS;\n };\n\n // Handle ArrowLeft - skip ZWS-only nodes and position before pills\n if (e.key === 'ArrowLeft' && editorRef.current) {\n const selection = window.getSelection();\n if (!selection?.rangeCount) return;\n const range = selection.getRangeAt(0);\n if (!range.collapsed) return;\n\n const node = range.startContainer;\n const offset = range.startOffset;\n\n // If we're in a ZWS-only text node, go to end of previous line\n if (isZwsOnly(node) && (offset === 0 || offset === 1)) {\n e.preventDefault();\n const prev = node.previousSibling;\n const newRange = document.createRange();\n\n if (prev && prev.nodeName === 'BR') {\n const beforeBr = prev.previousSibling;\n if (beforeBr) {\n if (beforeBr.nodeType === Node.TEXT_NODE) {\n newRange.setStart(beforeBr, beforeBr.textContent?.length || 0);\n } else if (beforeBr.nodeName === 'BR') {\n newRange.setStartAfter(beforeBr);\n } else {\n newRange.setStartAfter(beforeBr);\n }\n } else {\n newRange.setStart(node.parentNode!, 0);\n }\n } else if (prev) {\n if (prev.nodeType === Node.TEXT_NODE) {\n newRange.setStart(prev, prev.textContent?.length || 0);\n } else {\n newRange.setStartAfter(prev);\n }\n } else {\n newRange.setStart(node.parentNode!, 0);\n }\n newRange.collapse(true);\n selection.removeAllRanges();\n selection.addRange(newRange);\n return;\n }\n\n const prevNode = getAdjacentNode('before');\n\n // If prev is pill, check if there's a ZWS before it we should land in\n if (isPill(prevNode)) {\n e.preventDefault();\n const newRange = document.createRange();\n const beforePill = prevNode.previousSibling;\n if (beforePill && isZwsOnly(beforePill)) {\n newRange.setStart(beforePill, 1);\n } else {\n newRange.setStartBefore(prevNode);\n }\n newRange.collapse(true);\n selection.removeAllRanges();\n selection.addRange(newRange);\n return;\n }\n\n // If prev is ZWS, skip over it entirely\n if (prevNode && isZwsOnly(prevNode)) {\n e.preventDefault();\n const beforeZws = prevNode.previousSibling;\n const newRange = document.createRange();\n if (beforeZws) {\n if (beforeZws.nodeType === Node.TEXT_NODE) {\n newRange.setStart(beforeZws, beforeZws.textContent?.length || 0);\n } else {\n newRange.setStartAfter(beforeZws);\n }\n } else {\n newRange.setStart(node, 0);\n }\n newRange.collapse(true);\n selection.removeAllRanges();\n selection.addRange(newRange);\n return;\n }\n }\n\n // Handle ArrowRight - skip ZWS-only nodes and position after pills\n if (e.key === 'ArrowRight' && editorRef.current) {\n const selection = window.getSelection();\n if (!selection?.rangeCount) return;\n const range = selection.getRangeAt(0);\n if (!range.collapsed) return;\n\n const node = range.startContainer;\n const offset = range.startOffset;\n\n // If we're in a ZWS-only text node at the end, skip to after it\n if (isZwsOnly(node) && offset === 1) {\n e.preventDefault();\n const next = node.nextSibling;\n if (next) {\n const newRange = document.createRange();\n if (next.nodeType === Node.TEXT_NODE) {\n newRange.setStart(next, 0);\n } else if (isPill(next)) {\n newRange.setStartAfter(next);\n } else {\n newRange.setStartBefore(next);\n }\n newRange.collapse(true);\n selection.removeAllRanges();\n selection.addRange(newRange);\n }\n return;\n }\n\n // If we're at the start of ZWS (offset 0), skip entire ZWS and pill\n if (isZwsOnly(node) && offset === 0) {\n e.preventDefault();\n const next = node.nextSibling;\n const newRange = document.createRange();\n if (isPill(next)) {\n newRange.setStartAfter(next);\n } else if (next) {\n newRange.setStartBefore(next);\n } else {\n newRange.setStartAfter(node);\n }\n newRange.collapse(true);\n selection.removeAllRanges();\n selection.addRange(newRange);\n return;\n }\n\n const nextNode = getAdjacentNode('after');\n\n // If next is ZWS, skip it and go to after the pill (or wherever)\n if (nextNode && isZwsOnly(nextNode)) {\n e.preventDefault();\n const afterZws = nextNode.nextSibling;\n const newRange = document.createRange();\n if (isPill(afterZws)) {\n newRange.setStartAfter(afterZws);\n } else if (afterZws) {\n newRange.setStartBefore(afterZws);\n } else {\n newRange.setStartAfter(nextNode);\n }\n newRange.collapse(true);\n selection.removeAllRanges();\n selection.addRange(newRange);\n return;\n }\n\n if (isPill(nextNode)) {\n e.preventDefault();\n const newRange = document.createRange();\n newRange.setStartAfter(nextNode);\n newRange.collapse(true);\n selection.removeAllRanges();\n selection.addRange(newRange);\n return;\n }\n }\n\n // Handle Backspace to delete pills (especially at line start)\n if (e.key === 'Backspace' && editorRef.current) {\n const selection = window.getSelection();\n if (!selection?.rangeCount) return;\n\n const range = selection.getRangeAt(0);\n if (!range.collapsed) return; // Let browser handle selection deletion\n\n const node = range.startContainer;\n const offset = range.startOffset;\n\n // Check if cursor is at start of a text node that follows a pill\n if (node.nodeType === Node.TEXT_NODE && offset === 0) {\n const prev = node.previousSibling;\n if (prev instanceof HTMLElement && prev.classList.contains('rte-pill')) {\n e.preventDefault();\n prev.remove();\n updateMarkdown();\n return;\n }\n }\n\n // Check if cursor is in editor directly and previous sibling is a pill\n if (node === editorRef.current && offset > 0) {\n const children = Array.from(editorRef.current.childNodes);\n const prevChild = children[offset - 1];\n if (prevChild instanceof HTMLElement && prevChild.classList.contains('rte-pill')) {\n e.preventDefault();\n prevChild.remove();\n updateMarkdown();\n return;\n }\n }\n\n // Check if at start of editor with pill as first child\n if (node === editorRef.current && offset === 0) {\n // Nothing before cursor\n return;\n }\n\n // Handle case where cursor is right after a pill (pill is previous sibling of parent)\n if (node.nodeType === Node.TEXT_NODE && offset === 0 && node.parentNode) {\n const parent = node.parentNode;\n if (parent !== editorRef.current) {\n const prev = parent.previousSibling;\n if (prev instanceof HTMLElement && prev.classList.contains('rte-pill')) {\n e.preventDefault();\n prev.remove();\n updateMarkdown();\n return;\n }\n }\n }\n }\n\n // Handle Delete key for pills\n if (e.key === 'Delete' && editorRef.current) {\n const selection = window.getSelection();\n if (!selection?.rangeCount) return;\n\n const range = selection.getRangeAt(0);\n if (!range.collapsed) return;\n\n const node = range.startContainer;\n const offset = range.startOffset;\n\n // Check if cursor is at end of text node before a pill\n if (node.nodeType === Node.TEXT_NODE && offset === node.textContent?.length) {\n const next = node.nextSibling;\n if (next instanceof HTMLElement && next.classList.contains('rte-pill')) {\n e.preventDefault();\n next.remove();\n updateMarkdown();\n return;\n }\n }\n\n // Check if cursor is in editor directly and next sibling is a pill\n if (node === editorRef.current) {\n const children = Array.from(editorRef.current.childNodes);\n const nextChild = children[offset];\n if (nextChild instanceof HTMLElement && nextChild.classList.contains('rte-pill')) {\n e.preventDefault();\n nextChild.remove();\n updateMarkdown();\n return;\n }\n }\n }\n },\n [pendingUrl, onAcceptPill, onDismissPill, updateMarkdown]\n );\n\n // Handle focus\n const handleFocus = useCallback(() => {\n setIsFocused(true);\n }, []);\n\n const handleBlur = useCallback(() => {\n setIsFocused(false);\n // No linkification on blur - links are only created during active input\n }, []);\n\n // Link hover handlers\n const handleLinkMouseEnter = useCallback((e: MouseEvent) => {\n const target = e.target as HTMLElement;\n const linkEl = target.closest('.rte-link') as HTMLElement | null;\n if (!linkEl || !editorRef.current) return;\n\n if (hoverTimeoutRef.current) {\n clearTimeout(hoverTimeoutRef.current);\n }\n\n // Calculate this link's index among all links (for finding it after re-renders)\n const allLinks = editorRef.current.querySelectorAll('a.rte-link');\n let linkIndex = -1;\n for (let i = 0; i < allLinks.length; i++) {\n if (allLinks[i] === linkEl) {\n linkIndex = i;\n break;\n }\n }\n\n // Delay to prevent tooltip flash on quick mouse movements\n hoverTimeoutRef.current = setTimeout(() => {\n const rect = linkEl.getBoundingClientRect();\n setHoveredLink({\n url: linkEl.dataset.linkUrl || linkEl.textContent || '',\n linkIndex,\n position: {\n top: rect.bottom + 4,\n left: rect.left,\n },\n });\n }, 200);\n }, []);\n\n const handleLinkMouseLeave = useCallback((e: MouseEvent) => {\n const relatedTarget = e.relatedTarget as HTMLElement | null;\n\n // Don't hide if moving to the tooltip\n if (relatedTarget?.closest('.rte-link-tooltip')) return;\n\n if (hoverTimeoutRef.current) {\n clearTimeout(hoverTimeoutRef.current);\n hoverTimeoutRef.current = null;\n }\n\n // Small delay before hiding to allow moving to tooltip\n setTimeout(() => {\n setHoveredLink((current) => {\n // Only clear if we haven't re-entered\n if (current && !document.querySelector('.rte-link-tooltip:hover')) {\n return null;\n }\n return current;\n });\n }, 100);\n }, []);\n\n const handleCopyLink = useCallback(async () => {\n if (!hoveredLink) return;\n await navigator.clipboard.writeText(hoveredLink.url);\n setHoveredLink(null);\n }, [hoveredLink]);\n\n const handleRemoveLink = useCallback(() => {\n if (!hoveredLink || !editorRef.current || hoveredLink.linkIndex < 0) return;\n\n // Find the link by index (survives re-renders, handles duplicate URLs)\n const allLinks = editorRef.current.querySelectorAll('a.rte-link');\n const linkEl = allLinks[hoveredLink.linkIndex];\n\n if (linkEl && linkEl.parentNode) {\n const textNode = document.createTextNode(linkEl.textContent || '');\n linkEl.parentNode.replaceChild(textNode, linkEl);\n\n // Directly extract markdown WITHOUT auto-linking (to prevent re-linkifying)\n isUpdatingRef.current = true;\n const markdown = htmlToMarkdown(editorRef.current);\n onChange(markdown);\n requestAnimationFrame(() => {\n isUpdatingRef.current = false;\n });\n }\n\n setHoveredLink(null);\n }, [hoveredLink, onChange]);\n\n // Add hover listeners to editor for links\n useEffect(() => {\n const editor = editorRef.current;\n if (!editor) return;\n\n editor.addEventListener('mouseover', handleLinkMouseEnter);\n editor.addEventListener('mouseout', handleLinkMouseLeave);\n\n return () => {\n editor.removeEventListener('mouseover', handleLinkMouseEnter);\n editor.removeEventListener('mouseout', handleLinkMouseLeave);\n };\n }, [handleLinkMouseEnter, handleLinkMouseLeave]);\n\n // Clear hovered link when value changes (DOM elements get recreated)\n useEffect(() => {\n setHoveredLink(null);\n }, [value]);\n\n // Update tooltip position when pending URL changes\n useEffect(() => {\n if (!pendingUrl && !isCheckingUrl) {\n setTooltipPosition(null);\n }\n }, [pendingUrl, isCheckingUrl]);\n\n // Click outside to dismiss tooltip\n useEffect(() => {\n if (!pendingUrl && !isCheckingUrl) return;\n\n const handleClickOutside = (e: MouseEvent) => {\n const target = e.target as HTMLElement;\n // Don't dismiss if clicking on the tooltip itself\n if (target.closest('.rte-tooltip')) return;\n // Dismiss on any other click\n onDismissPill?.();\n };\n\n // Use capture phase to catch clicks before they're handled\n document.addEventListener('mousedown', handleClickOutside, true);\n return () => {\n document.removeEventListener('mousedown', handleClickOutside, true);\n };\n }, [pendingUrl, isCheckingUrl, onDismissPill]);\n\n const showTooltip = (pendingUrl || isCheckingUrl) && tooltipPosition;\n const isEmpty = !value;\n\n return (\n
\n {label && }\n
\n \n\n {/* Floating tooltip for pill conversion */}\n {showTooltip &&\n createPortal(\n \n {isCheckingUrl ? (\n Checking link...\n ) : pendingUrl ? (\n <>\n tab\n to replace with\n {\n e.stopPropagation();\n onAcceptPill?.();\n }}\n >\n \n {pendingUrl.metadata.title}\n \n \n ) : null}\n
,\n document.body\n )}\n\n {/* Link hover tooltip */}\n {hoveredLink &&\n createPortal(\n {\n // Keep tooltip open when hovering over it\n if (hoverTimeoutRef.current) {\n clearTimeout(hoverTimeoutRef.current);\n }\n }}\n onMouseLeave={() => {\n setHoveredLink(null);\n }}\n >\n setHoveredLink(null)}\n >\n {hoveredLink.url}\n \n \n {\n e.preventDefault();\n e.stopPropagation();\n handleCopyLink();\n }}\n title=\"Copy link\"\n >\n \n \n \n \n \n {\n e.preventDefault();\n e.stopPropagation();\n handleRemoveLink();\n }}\n title=\"Remove link\"\n >\n \n {/* Broken chain link icon */}\n \n \n \n \n \n
,\n document.body\n )}\n \n \n );\n}\n" }, { "path": "src/components/common/index.ts", "content": "export { Button } from './Button';\nexport type { ButtonProps } from './Button';\n\nexport { Input, Textarea } from './Input';\nexport type { InputProps, TextareaProps } from './Input';\n\nexport { Modal } from './Modal';\nexport type { ModalProps } from './Modal';\n\nexport { McpIcon, getIconTypeFromTool, AgentIcon } from './McpIcon';\n\nexport { ErrorBoundary } from './ErrorBoundary';\n\nexport { RichTextEditor } from './RichTextEditor';\nexport type { RichTextEditorProps, PendingUrl } from './RichTextEditor';\n" }, { "path": "src/constants.ts", "content": "/**\n * Shared constants for the frontend\n */\n\n// Credential types - must match worker/constants.ts\nexport const CREDENTIAL_TYPES = {\n GITHUB_OAUTH: 'github_oauth',\n GOOGLE_OAUTH: 'google_oauth',\n ANTHROPIC_API_KEY: 'anthropic_api_key',\n} as const;\n\nexport type CredentialType = typeof CREDENTIAL_TYPES[keyof typeof CREDENTIAL_TYPES];\n" }, { "path": "src/context/AuthContext.tsx", "content": "/**\n * AuthContext - Authentication state management\n *\n * Provides current user info and auth state to the app.\n * Fetches user from /api/me on mount.\n */\n\nimport React, { createContext, useContext, useEffect, useState, useCallback } from 'react';\nimport type { User } from '../types';\n\ninterface AuthState {\n user: User | null;\n isLoading: boolean;\n error: string | null;\n}\n\ninterface AuthContextValue extends AuthState {\n signOut: () => void;\n refetchUser: () => Promise;\n}\n\nconst AuthContext = createContext(undefined);\n\nexport function AuthProvider({ children }: { children: React.ReactNode }) {\n const [state, setState] = useState({\n user: null,\n isLoading: true,\n error: null,\n });\n\n const fetchUser = useCallback(async () => {\n try {\n const response = await fetch('/api/me');\n const data = await response.json() as { success: boolean; data?: User; error?: { message: string } };\n\n if (data.success && data.data) {\n setState({ user: data.data, isLoading: false, error: null });\n } else {\n setState({\n user: null,\n isLoading: false,\n error: data.error?.message || 'Authentication required',\n });\n }\n } catch (err) {\n setState({\n user: null,\n isLoading: false,\n error: err instanceof Error ? err.message : 'Failed to fetch user',\n });\n }\n }, []);\n\n useEffect(() => {\n fetchUser();\n }, [fetchUser]);\n\n const signOut = useCallback(() => {\n if (state.user?.logoutUrl) {\n // Redirect to Cloudflare Access logout\n window.location.href = state.user.logoutUrl;\n } else {\n // In dev mode, just clear the user state\n setState({ user: null, isLoading: false, error: null });\n }\n }, [state.user?.logoutUrl]);\n\n const value: AuthContextValue = {\n ...state,\n signOut,\n refetchUser: fetchUser,\n };\n\n return {children};\n}\n\nexport function useAuth(): AuthContextValue {\n const context = useContext(AuthContext);\n if (!context) {\n throw new Error('useAuth must be used within an AuthProvider');\n }\n return context;\n}\n" }, { "path": "src/context/BoardContext.tsx", "content": "import {\n createContext,\n useContext,\n useReducer,\n useCallback,\n useEffect,\n useState,\n useRef,\n type ReactNode,\n} from 'react';\nimport type { Column, Task, DragState, ColumnDragState, TaskPriority, WorkflowPlan, WorkflowLog, ScheduleConfig } from '../types';\nimport * as api from '../api/client';\nimport { boardReducer, initialBoardState, type BoardState } from './boardReducer';\n\n// ============================================\n// CONTEXT\n// ============================================\n\ninterface BoardContextValue extends Omit {\n loadBoards: () => Promise;\n loadBoard: (id: string) => Promise;\n clearActiveBoard: () => void;\n createBoard: (name: string) => Promise;\n renameBoard: (id: string, name: string) => Promise;\n deleteBoard: (id: string) => Promise;\n createColumn: (name: string) => Promise;\n updateColumn: (id: string, data: { name?: string; position?: number }) => Promise;\n deleteColumn: (id: string) => Promise;\n createTask: (columnId: string, title: string, description?: string, priority?: TaskPriority) => Promise;\n updateTask: (id: string, data: { title?: string; description?: string; priority?: TaskPriority; scheduleConfig?: ScheduleConfig | null }) => Promise;\n deleteTask: (id: string) => Promise;\n moveTask: (taskId: string, columnId: string, position: number) => Promise;\n moveColumn: (columnId: string, newPosition: number) => Promise;\n setDragState: (state: Partial) => void;\n setColumnDragState: (state: Partial) => void;\n getTasksByColumn: (columnId: string) => Task[];\n getTaskById: (taskId: string) => Task | undefined;\n addingToColumn: string | null;\n setAddingToColumn: (columnId: string | null) => void;\n // Workflow state and methods\n activeWorkflows: WorkflowPlan[];\n wsConnected: boolean;\n getWorkflowPlan: (planId: string) => WorkflowPlan | null;\n getTaskWorkflowPlan: (taskId: string) => WorkflowPlan | null;\n updateWorkflowPlan: (plan: WorkflowPlan) => void;\n removeWorkflowPlan: (planId: string) => void;\n getWorkflowLogs: (planId: string) => WorkflowLog[];\n fetchWorkflowLogs: (boardId: string, planId: string) => Promise;\n}\n\nconst BoardContext = createContext(null);\n\n// ============================================\n// PROVIDER\n// ============================================\n\nexport function BoardProvider({ children }: { children: ReactNode }) {\n const [state, dispatch] = useReducer(boardReducer, initialBoardState);\n const [addingToColumn, setAddingToColumn] = useState(null);\n const [wsConnected, setWsConnected] = useState(false);\n const wsRef = useRef(null);\n const reconnectTimeoutRef = useRef | null>(null);\n const pingIntervalRef = useRef | null>(null);\n\n // Fetch all workflow plans for the board\n const fetchBoardWorkflowPlans = useCallback(async (boardId: string) => {\n const result = await api.getBoardWorkflowPlans(boardId);\n if (result.success && result.data) {\n dispatch({ type: 'SET_WORKFLOW_PLANS', payload: result.data });\n }\n }, []);\n\n // WebSocket connection for real-time updates\n const connectWebSocket = useCallback((boardId: string) => {\n if (wsRef.current?.readyState === WebSocket.OPEN) return;\n\n if (wsRef.current) {\n wsRef.current.close();\n }\n\n const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';\n const wsUrl = `${protocol}//${window.location.host}/api/ws?boardId=${encodeURIComponent(boardId)}`;\n\n try {\n const ws = new WebSocket(wsUrl);\n\n ws.onopen = () => {\n setWsConnected(true);\n\n pingIntervalRef.current = setInterval(() => {\n if (ws.readyState === WebSocket.OPEN) {\n ws.send(JSON.stringify({ type: 'ping' }));\n }\n }, 30000);\n };\n\n ws.onclose = (event) => {\n setWsConnected(false);\n\n if (pingIntervalRef.current) {\n clearInterval(pingIntervalRef.current);\n pingIntervalRef.current = null;\n }\n\n if (event.code !== 1000) {\n reconnectTimeoutRef.current = setTimeout(() => {\n if (state.activeBoard?.id) {\n connectWebSocket(state.activeBoard.id);\n }\n }, 3000);\n }\n };\n\n ws.onerror = () => {\n // Error handling done via onclose\n };\n\n ws.onmessage = (event) => {\n try {\n const message = JSON.parse(event.data);\n\n if (message.type === 'pong') return;\n\n if (message.type === 'workflow_plan_update') {\n const plan = message.data as WorkflowPlan;\n dispatch({ type: 'UPDATE_WORKFLOW_PLAN', payload: plan });\n }\n\n if (message.type === 'workflow_log') {\n const log = message.data as WorkflowLog;\n dispatch({ type: 'ADD_WORKFLOW_LOG', payload: log });\n }\n\n if (message.type === 'task_created') {\n const task = message.data.task as Task;\n dispatch({ type: 'ADD_TASK', payload: task });\n }\n } catch {\n // Silently ignore malformed messages\n }\n };\n\n wsRef.current = ws;\n } catch {\n // Connection failure will be handled by onclose/onerror\n }\n }, [state.activeBoard?.id]);\n\n // Connect WebSocket and fetch data when board changes\n useEffect(() => {\n if (state.activeBoard?.id) {\n dispatch({ type: 'CLEAR_WORKFLOW_STATE' });\n fetchBoardWorkflowPlans(state.activeBoard.id);\n connectWebSocket(state.activeBoard.id);\n }\n\n return () => {\n if (reconnectTimeoutRef.current) {\n clearTimeout(reconnectTimeoutRef.current);\n }\n if (pingIntervalRef.current) {\n clearInterval(pingIntervalRef.current);\n }\n if (wsRef.current) {\n wsRef.current.close(1000, 'Board changed');\n wsRef.current = null;\n }\n };\n }, [state.activeBoard?.id, fetchBoardWorkflowPlans, connectWebSocket]);\n\n // Derived: active workflows (executing, checkpoint, or planning)\n const activeWorkflows = Object.values(state.workflowPlans).filter(\n (p) => p.status === 'executing' || p.status === 'checkpoint' || p.status === 'planning'\n );\n\n // Get a workflow plan from state by plan ID\n const getWorkflowPlan = useCallback((planId: string): WorkflowPlan | null => {\n return state.workflowPlans[planId] || null;\n }, [state.workflowPlans]);\n\n // Get workflow plan for a task - prioritizes active plans, falls back to most recent\n const getTaskWorkflowPlan = useCallback((taskId: string): WorkflowPlan | null => {\n const plans = Object.values(state.workflowPlans).filter(p => p.taskId === taskId);\n if (plans.length === 0) return null;\n\n const activePlan = plans.find(p => p.status === 'executing' || p.status === 'checkpoint');\n if (activePlan) return activePlan;\n\n return plans.sort((a, b) =>\n new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()\n )[0];\n }, [state.workflowPlans]);\n\n // Update workflow plan in state\n const updateWorkflowPlanAction = useCallback((plan: WorkflowPlan) => {\n dispatch({ type: 'UPDATE_WORKFLOW_PLAN', payload: plan });\n }, []);\n\n // Remove workflow plan from state\n const removeWorkflowPlanAction = useCallback((planId: string) => {\n dispatch({ type: 'REMOVE_WORKFLOW_PLAN', payload: planId });\n }, []);\n\n // Get workflow logs from state\n const getWorkflowLogsFromState = useCallback((planId: string): WorkflowLog[] => {\n return state.workflowLogs[planId] || [];\n }, [state.workflowLogs]);\n\n // Fetch workflow logs from API\n const fetchWorkflowLogs = useCallback(async (boardId: string, planId: string): Promise => {\n const result = await api.getWorkflowLogs(boardId, planId);\n if (result.success && result.data) {\n dispatch({ type: 'SET_WORKFLOW_LOGS', payload: { planId, logs: result.data } });\n }\n }, []);\n\n const loadBoards = useCallback(async () => {\n dispatch({ type: 'SET_LOADING', payload: true });\n const result = await api.getBoards();\n if (result.success && result.data) {\n dispatch({ type: 'SET_BOARDS', payload: result.data });\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to load boards' });\n }\n dispatch({ type: 'SET_LOADING', payload: false });\n }, []);\n\n const loadBoard = useCallback(async (id: string) => {\n dispatch({ type: 'SET_LOADING', payload: true });\n const result = await api.getBoard(id);\n if (result.success && result.data) {\n dispatch({ type: 'SET_ACTIVE_BOARD', payload: result.data });\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to load board' });\n }\n dispatch({ type: 'SET_LOADING', payload: false });\n }, []);\n\n const clearActiveBoard = useCallback(() => {\n dispatch({ type: 'SET_ACTIVE_BOARD', payload: null });\n }, []);\n\n const createBoardAction = useCallback(async (name: string): Promise => {\n const result = await api.createBoard(name);\n if (result.success && result.data) {\n dispatch({ type: 'ADD_BOARD', payload: result.data });\n return result.data.id;\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to create board' });\n return null;\n }\n }, []);\n\n const renameBoardAction = useCallback(async (id: string, name: string) => {\n const result = await api.updateBoard(id, { name });\n if (result.success && result.data) {\n dispatch({ type: 'UPDATE_BOARD', payload: { id, name } });\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to rename board' });\n }\n }, []);\n\n const deleteBoardAction = useCallback(async (id: string) => {\n const result = await api.deleteBoard(id);\n if (result.success) {\n dispatch({ type: 'REMOVE_BOARD', payload: id });\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to delete board' });\n }\n }, []);\n\n const createColumnAction = useCallback(async (name: string): Promise => {\n if (!state.activeBoard) return null;\n const result = await api.createColumn(state.activeBoard.id, name);\n if (result.success && result.data) {\n dispatch({ type: 'ADD_COLUMN', payload: result.data });\n return result.data;\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to create column' });\n return null;\n }\n }, [state.activeBoard]);\n\n const updateColumnAction = useCallback(async (\n id: string,\n data: { name?: string; position?: number }\n ) => {\n if (!state.activeBoard) return;\n const result = await api.updateColumn(state.activeBoard.id, id, data);\n if (result.success && result.data) {\n dispatch({ type: 'UPDATE_COLUMN', payload: result.data });\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to update column' });\n }\n }, [state.activeBoard]);\n\n const deleteColumnAction = useCallback(async (id: string) => {\n if (!state.activeBoard) return;\n const result = await api.deleteColumn(state.activeBoard.id, id);\n if (result.success) {\n dispatch({ type: 'REMOVE_COLUMN', payload: id });\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to delete column' });\n }\n }, [state.activeBoard]);\n\n const createTaskAction = useCallback(async (\n columnId: string,\n title: string,\n description?: string,\n priority?: TaskPriority\n ) => {\n if (!state.activeBoard) return;\n const result = await api.createTask(state.activeBoard.id, {\n columnId,\n title,\n description,\n priority,\n });\n if (result.success && result.data) {\n dispatch({ type: 'ADD_TASK', payload: result.data });\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to create task' });\n }\n }, [state.activeBoard]);\n\n const updateTaskAction = useCallback(async (\n id: string,\n data: { title?: string; description?: string; priority?: TaskPriority; scheduleConfig?: ScheduleConfig | null }\n ) => {\n if (!state.activeBoard) return;\n const result = await api.updateTask(state.activeBoard.id, id, data);\n if (result.success && result.data) {\n dispatch({ type: 'UPDATE_TASK', payload: result.data });\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to update task' });\n }\n }, [state.activeBoard]);\n\n const deleteTaskAction = useCallback(async (id: string) => {\n if (!state.activeBoard) return;\n const result = await api.deleteTask(state.activeBoard.id, id);\n if (result.success) {\n dispatch({ type: 'REMOVE_TASK', payload: id });\n } else {\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to delete task' });\n }\n }, [state.activeBoard]);\n\n const moveTaskAction = useCallback(async (\n taskId: string,\n columnId: string,\n position: number\n ) => {\n if (!state.activeBoard) return;\n // Optimistic update\n dispatch({ type: 'MOVE_TASK', payload: { taskId, columnId, position } });\n\n const result = await api.moveTask(state.activeBoard.id, taskId, columnId, position);\n if (!result.success) {\n // Revert on error by reloading the board\n loadBoard(state.activeBoard.id);\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to move task' });\n }\n }, [state.activeBoard, loadBoard]);\n\n const setDragState = useCallback((dragState: Partial) => {\n dispatch({ type: 'SET_DRAG_STATE', payload: dragState });\n }, []);\n\n const setColumnDragState = useCallback((columnDragState: Partial) => {\n dispatch({ type: 'SET_COLUMN_DRAG_STATE', payload: columnDragState });\n }, []);\n\n const moveColumnAction = useCallback(async (columnId: string, newPosition: number) => {\n if (!state.activeBoard) return;\n\n // Find the column being moved\n const columns = [...state.activeBoard.columns].sort((a, b) => a.position - b.position);\n const columnIndex = columns.findIndex((c) => c.id === columnId);\n if (columnIndex === -1) return;\n\n // Optimistically update column positions\n const updatedColumns = columns.map((col, idx) => {\n if (col.id === columnId) {\n return { ...col, position: newPosition };\n }\n // Adjust other columns\n if (columnIndex < newPosition) {\n // Moving right: shift columns between old and new position left\n if (idx > columnIndex && idx <= newPosition) {\n return { ...col, position: col.position - 1 };\n }\n } else {\n // Moving left: shift columns between new and old position right\n if (idx >= newPosition && idx < columnIndex) {\n return { ...col, position: col.position + 1 };\n }\n }\n return col;\n });\n\n // Update local state optimistically\n updatedColumns.forEach((col) => {\n dispatch({ type: 'UPDATE_COLUMN', payload: col });\n });\n\n // Call API to persist the move\n if (!state.activeBoard) return;\n const result = await api.updateColumn(state.activeBoard.id, columnId, { position: newPosition });\n if (!result.success) {\n // Revert on error by reloading the board\n loadBoard(state.activeBoard.id);\n dispatch({ type: 'SET_ERROR', payload: result.error?.message || 'Failed to move column' });\n }\n }, [state.activeBoard, loadBoard]);\n\n const getTasksByColumn = useCallback((columnId: string): Task[] => {\n if (!state.activeBoard) return [];\n return state.activeBoard.tasks\n .filter((t) => t.columnId === columnId)\n .sort((a, b) => a.position - b.position);\n }, [state.activeBoard]);\n\n const getTaskById = useCallback((taskId: string): Task | undefined => {\n if (!state.activeBoard) return undefined;\n return state.activeBoard.tasks.find((t) => t.id === taskId);\n }, [state.activeBoard]);\n\n // Load boards on mount\n useEffect(() => {\n loadBoards();\n }, [loadBoards]);\n\n const value: BoardContextValue = {\n boards: state.boards,\n activeBoard: state.activeBoard,\n loading: state.loading,\n error: state.error,\n dragState: state.dragState,\n columnDragState: state.columnDragState,\n workflowPlans: state.workflowPlans,\n loadBoards,\n loadBoard,\n clearActiveBoard,\n createBoard: createBoardAction,\n renameBoard: renameBoardAction,\n deleteBoard: deleteBoardAction,\n createColumn: createColumnAction,\n updateColumn: updateColumnAction,\n deleteColumn: deleteColumnAction,\n createTask: createTaskAction,\n updateTask: updateTaskAction,\n deleteTask: deleteTaskAction,\n moveTask: moveTaskAction,\n moveColumn: moveColumnAction,\n setDragState,\n setColumnDragState,\n getTasksByColumn,\n getTaskById,\n addingToColumn,\n setAddingToColumn,\n activeWorkflows,\n wsConnected,\n getWorkflowPlan,\n getTaskWorkflowPlan,\n updateWorkflowPlan: updateWorkflowPlanAction,\n removeWorkflowPlan: removeWorkflowPlanAction,\n getWorkflowLogs: getWorkflowLogsFromState,\n fetchWorkflowLogs,\n };\n\n return (\n \n {children}\n \n );\n}\n\n// ============================================\n// HOOK\n// ============================================\n\nexport function useBoard(): BoardContextValue {\n const context = useContext(BoardContext);\n if (!context) {\n throw new Error('useBoard must be used within a BoardProvider');\n }\n return context;\n}\n" }, { "path": "src/context/ToastContext.tsx", "content": "import {\n createContext,\n useContext,\n useState,\n useCallback,\n type ReactNode,\n} from 'react';\n\n// ============================================\n// TYPES\n// ============================================\n\nexport type ToastType = 'success' | 'error' | 'warning' | 'info';\n\nexport interface Toast {\n id: string;\n type: ToastType;\n message: string;\n duration?: number;\n taskId?: string;\n}\n\ninterface ToastContextValue {\n toasts: Toast[];\n addToast: (toast: Omit) => void;\n removeToast: (id: string) => void;\n}\n\n// ============================================\n// CONTEXT\n// ============================================\n\nconst ToastContext = createContext(null);\n\n// ============================================\n// PROVIDER\n// ============================================\n\nconst DEFAULT_DURATION = 4000;\n\nexport function ToastProvider({ children }: { children: ReactNode }) {\n const [toasts, setToasts] = useState([]);\n\n const removeToast = useCallback((id: string) => {\n setToasts((prev) => prev.filter((t) => t.id !== id));\n }, []);\n\n const addToast = useCallback((toast: Omit) => {\n const id = `toast-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;\n const duration = toast.duration ?? DEFAULT_DURATION;\n const newToast: Toast = { ...toast, id, duration };\n\n setToasts((prev) => [...prev, newToast]);\n }, []);\n\n return (\n \n {children}\n \n );\n}\n\n// ============================================\n// HOOK\n// ============================================\n\nexport function useToast() {\n const context = useContext(ToastContext);\n if (!context) {\n throw new Error('useToast must be used within a ToastProvider');\n }\n return context;\n}\n" }, { "path": "src/context/boardReducer.ts", "content": "/**\n * Board reducer - State management logic for BoardContext\n *\n * Extracted from BoardContext.tsx for better maintainability.\n */\n\nimport type { Board, Column, Task, DragState, ColumnDragState, WorkflowPlan, WorkflowLog } from '../types';\nimport type { BoardWithDetails } from '../api/client';\n\n// ============================================\n// STATE\n// ============================================\n\nexport interface BoardState {\n boards: Board[];\n activeBoard: BoardWithDetails | null;\n loading: boolean;\n error: string | null;\n dragState: DragState;\n columnDragState: ColumnDragState;\n // Workflow state - keyed by plan ID\n workflowPlans: Record;\n workflowLogs: Record;\n}\n\nexport const initialBoardState: BoardState = {\n boards: [],\n activeBoard: null,\n loading: false,\n error: null,\n dragState: {\n isDragging: false,\n taskId: null,\n sourceColumnId: null,\n },\n columnDragState: {\n isDragging: false,\n columnId: null,\n },\n workflowPlans: {},\n workflowLogs: {},\n};\n\n// ============================================\n// ACTIONS\n// ============================================\n\nexport type BoardAction =\n | { type: 'SET_LOADING'; payload: boolean }\n | { type: 'SET_ERROR'; payload: string | null }\n | { type: 'SET_BOARDS'; payload: Board[] }\n | { type: 'SET_ACTIVE_BOARD'; payload: BoardWithDetails | null }\n | { type: 'ADD_BOARD'; payload: BoardWithDetails }\n | { type: 'UPDATE_BOARD'; payload: { id: string; name: string } }\n | { type: 'REMOVE_BOARD'; payload: string }\n | { type: 'ADD_COLUMN'; payload: Column }\n | { type: 'UPDATE_COLUMN'; payload: Column }\n | { type: 'REMOVE_COLUMN'; payload: string }\n | { type: 'ADD_TASK'; payload: Task }\n | { type: 'UPDATE_TASK'; payload: Task }\n | { type: 'REMOVE_TASK'; payload: string }\n | { type: 'MOVE_TASK'; payload: { taskId: string; columnId: string; position: number } }\n | { type: 'SET_DRAG_STATE'; payload: Partial }\n | { type: 'SET_COLUMN_DRAG_STATE'; payload: Partial }\n // Workflow actions\n | { type: 'SET_WORKFLOW_PLANS'; payload: WorkflowPlan[] }\n | { type: 'UPDATE_WORKFLOW_PLAN'; payload: WorkflowPlan }\n | { type: 'REMOVE_WORKFLOW_PLAN'; payload: string }\n | { type: 'ADD_WORKFLOW_LOG'; payload: WorkflowLog }\n | { type: 'SET_WORKFLOW_LOGS'; payload: { planId: string; logs: WorkflowLog[] } }\n | { type: 'CLEAR_WORKFLOW_STATE' };\n\n// ============================================\n// REDUCER\n// ============================================\n\nexport function boardReducer(state: BoardState, action: BoardAction): BoardState {\n switch (action.type) {\n case 'SET_LOADING':\n return { ...state, loading: action.payload };\n\n case 'SET_ERROR':\n return { ...state, error: action.payload };\n\n case 'SET_BOARDS':\n return { ...state, boards: action.payload };\n\n case 'SET_ACTIVE_BOARD':\n return { ...state, activeBoard: action.payload };\n\n case 'ADD_BOARD':\n return {\n ...state,\n boards: [action.payload, ...state.boards],\n activeBoard: action.payload,\n };\n\n case 'UPDATE_BOARD':\n return {\n ...state,\n boards: state.boards.map((b) =>\n b.id === action.payload.id ? { ...b, name: action.payload.name } : b\n ),\n activeBoard:\n state.activeBoard?.id === action.payload.id\n ? { ...state.activeBoard, name: action.payload.name }\n : state.activeBoard,\n };\n\n case 'REMOVE_BOARD':\n return {\n ...state,\n boards: state.boards.filter((b) => b.id !== action.payload),\n activeBoard:\n state.activeBoard?.id === action.payload ? null : state.activeBoard,\n };\n\n case 'ADD_COLUMN':\n if (!state.activeBoard) return state;\n return {\n ...state,\n activeBoard: {\n ...state.activeBoard,\n columns: [...state.activeBoard.columns, action.payload],\n },\n };\n\n case 'UPDATE_COLUMN':\n if (!state.activeBoard) return state;\n return {\n ...state,\n activeBoard: {\n ...state.activeBoard,\n columns: state.activeBoard.columns.map((c) =>\n c.id === action.payload.id ? action.payload : c\n ),\n },\n };\n\n case 'REMOVE_COLUMN':\n if (!state.activeBoard) return state;\n return {\n ...state,\n activeBoard: {\n ...state.activeBoard,\n columns: state.activeBoard.columns.filter((c) => c.id !== action.payload),\n tasks: state.activeBoard.tasks.filter((t) => t.columnId !== action.payload),\n },\n };\n\n case 'ADD_TASK':\n if (!state.activeBoard) return state;\n // Deduplicate: don't add if task already exists (can happen when API response and WebSocket both fire)\n if (state.activeBoard.tasks.some((t) => t.id === action.payload.id)) {\n return state;\n }\n return {\n ...state,\n activeBoard: {\n ...state.activeBoard,\n tasks: [...state.activeBoard.tasks, action.payload],\n },\n };\n\n case 'UPDATE_TASK':\n if (!state.activeBoard) return state;\n return {\n ...state,\n activeBoard: {\n ...state.activeBoard,\n tasks: state.activeBoard.tasks.map((t) =>\n t.id === action.payload.id ? action.payload : t\n ),\n },\n };\n\n case 'REMOVE_TASK':\n if (!state.activeBoard) return state;\n return {\n ...state,\n activeBoard: {\n ...state.activeBoard,\n tasks: state.activeBoard.tasks.filter((t) => t.id !== action.payload),\n },\n };\n\n case 'MOVE_TASK': {\n if (!state.activeBoard) return state;\n const { taskId, columnId: targetColumnId, position: newPosition } = action.payload;\n const movedTask = state.activeBoard.tasks.find(t => t.id === taskId);\n if (!movedTask) return state;\n\n const sourceColumnId = movedTask.columnId;\n const oldPosition = movedTask.position;\n\n return {\n ...state,\n activeBoard: {\n ...state.activeBoard,\n tasks: state.activeBoard.tasks.map((t) => {\n if (t.id === taskId) {\n return { ...t, columnId: targetColumnId, position: newPosition };\n }\n\n if (sourceColumnId === targetColumnId) {\n // Same column reorder\n if (oldPosition < newPosition) {\n // Moving down: shift tasks between old and new up (decrement)\n if (t.columnId === targetColumnId && t.position > oldPosition && t.position <= newPosition) {\n return { ...t, position: t.position - 1 };\n }\n } else if (oldPosition > newPosition) {\n // Moving up: shift tasks between new and old down (increment)\n if (t.columnId === targetColumnId && t.position >= newPosition && t.position < oldPosition) {\n return { ...t, position: t.position + 1 };\n }\n }\n } else {\n // Cross-column move\n // Close gap in source column\n if (t.columnId === sourceColumnId && t.position > oldPosition) {\n return { ...t, position: t.position - 1 };\n }\n // Make room in target column\n if (t.columnId === targetColumnId && t.position >= newPosition) {\n return { ...t, position: t.position + 1 };\n }\n }\n\n return t;\n }),\n },\n };\n }\n\n case 'SET_DRAG_STATE':\n return { ...state, dragState: { ...state.dragState, ...action.payload } };\n\n case 'SET_COLUMN_DRAG_STATE':\n return { ...state, columnDragState: { ...state.columnDragState, ...action.payload } };\n\n // Workflow reducers\n case 'SET_WORKFLOW_PLANS': {\n const plans: Record = {};\n for (const plan of action.payload) {\n plans[plan.id] = plan;\n }\n return { ...state, workflowPlans: plans };\n }\n\n case 'UPDATE_WORKFLOW_PLAN':\n return {\n ...state,\n workflowPlans: {\n ...state.workflowPlans,\n [action.payload.id]: action.payload,\n },\n };\n\n case 'REMOVE_WORKFLOW_PLAN': {\n const { [action.payload]: _, ...remainingPlans } = state.workflowPlans;\n const { [action.payload]: __, ...remainingLogs } = state.workflowLogs;\n return {\n ...state,\n workflowPlans: remainingPlans,\n workflowLogs: remainingLogs,\n };\n }\n\n case 'ADD_WORKFLOW_LOG': {\n const log = action.payload;\n return {\n ...state,\n workflowLogs: {\n ...state.workflowLogs,\n [log.planId]: [...(state.workflowLogs[log.planId] || []), log],\n },\n };\n }\n\n case 'SET_WORKFLOW_LOGS':\n return {\n ...state,\n workflowLogs: {\n ...state.workflowLogs,\n [action.payload.planId]: action.payload.logs,\n },\n };\n\n case 'CLEAR_WORKFLOW_STATE':\n return { ...state, workflowPlans: {}, workflowLogs: {} };\n\n default:\n return state;\n }\n}\n" }, { "path": "src/hooks/index.ts", "content": "export {\n useTitleEdit,\n useRowSelection,\n useCommentInput,\n useComments,\n useFieldComments,\n generateCommentId,\n type TitleEditState,\n type DragState,\n type CommentInputState,\n type UseTitleEditOptions,\n type UseTitleEditResult,\n type SelectionRange,\n type UseRowSelectionResult,\n type UseCommentInputResult,\n type CommentBase,\n type UseCommentsResult,\n type FieldComment,\n type UseFieldCommentsResult,\n} from './useApprovalComments';\n\nexport { useIsMobile } from './useIsMobile';\n\nexport {\n useUrlDetection,\n extractUrl,\n type PendingUrl,\n type UseUrlDetectionResult,\n} from './useUrlDetection';\n" }, { "path": "src/hooks/useApprovalComments.ts", "content": "/**\n * Shared hook for approval comment management\n *\n * Extracts common comment handling logic used across approval components:\n * - DefaultApproval\n * - GoogleSheetsApproval\n * - GoogleDocsApproval\n * - EmailApproval\n */\n\nimport { useState, useCallback, useRef } from 'react';\n\n// ============================================\n// TYPES\n// ============================================\n\nexport interface TitleEditState {\n editedTitle: string | null;\n titleComment: string | null;\n showTitleCommentInput: boolean;\n titleCommentText: string;\n}\n\nexport interface DragState {\n selection: T | null;\n isDragging: boolean;\n dragStartRef: React.RefObject<{ index: number; side: 'left' | 'right' } | null>;\n}\n\nexport interface CommentInputState {\n showCommentInput: boolean;\n commentText: string;\n}\n\n// ============================================\n// TITLE EDITING HOOK\n// ============================================\n\nexport interface UseTitleEditOptions {\n initialTitle?: string;\n}\n\nexport interface UseTitleEditResult {\n editedTitle: string | null;\n setEditedTitle: (title: string | null) => void;\n titleComment: string | null;\n showTitleCommentInput: boolean;\n titleCommentText: string;\n handleStartTitleComment: () => void;\n handleEditTitleComment: () => void;\n handleAddTitleComment: () => void;\n handleCancelTitleComment: () => void;\n handleRemoveTitleComment: () => void;\n setTitleCommentText: (text: string) => void;\n hasTitleComment: boolean;\n}\n\nexport function useTitleEdit(options: UseTitleEditOptions = {}): UseTitleEditResult {\n const [editedTitle, setEditedTitle] = useState(options.initialTitle ?? null);\n const [titleComment, setTitleComment] = useState(null);\n const [showTitleCommentInput, setShowTitleCommentInput] = useState(false);\n const [titleCommentText, setTitleCommentText] = useState('');\n\n const handleStartTitleComment = useCallback(() => {\n setShowTitleCommentInput(true);\n setTitleCommentText('');\n }, []);\n\n const handleEditTitleComment = useCallback(() => {\n if (titleComment) {\n setTitleCommentText(titleComment);\n setShowTitleCommentInput(true);\n }\n }, [titleComment]);\n\n const handleAddTitleComment = useCallback(() => {\n if (titleCommentText.trim()) {\n setTitleComment(titleCommentText.trim());\n setShowTitleCommentInput(false);\n setTitleCommentText('');\n }\n }, [titleCommentText]);\n\n const handleCancelTitleComment = useCallback(() => {\n setShowTitleCommentInput(false);\n setTitleCommentText('');\n }, []);\n\n const handleRemoveTitleComment = useCallback(() => {\n setTitleComment(null);\n }, []);\n\n return {\n editedTitle,\n setEditedTitle,\n titleComment,\n showTitleCommentInput,\n titleCommentText,\n handleStartTitleComment,\n handleEditTitleComment,\n handleAddTitleComment,\n handleCancelTitleComment,\n handleRemoveTitleComment,\n setTitleCommentText,\n hasTitleComment: titleComment !== null,\n };\n}\n\n// ============================================\n// ROW/LINE SELECTION HOOK (for diff views)\n// ============================================\n\nexport interface SelectionRange {\n startIndex: number;\n endIndex: number;\n side: 'left' | 'right';\n}\n\nexport interface UseRowSelectionResult {\n selection: SelectionRange | null;\n isDragging: boolean;\n dragStartRef: React.RefObject<{ index: number; side: 'left' | 'right' } | null>;\n handleMouseDown: (index: number, side: 'left' | 'right') => void;\n handleMouseMove: (index: number, side: 'left' | 'right') => void;\n handleMouseUp: () => void;\n clearSelection: () => void;\n}\n\nexport function useRowSelection(): UseRowSelectionResult {\n const [selection, setSelection] = useState(null);\n const [isDragging, setIsDragging] = useState(false);\n const dragStartRef = useRef<{ index: number; side: 'left' | 'right' } | null>(null);\n\n const handleMouseDown = useCallback((index: number, side: 'left' | 'right') => {\n dragStartRef.current = { index, side };\n setIsDragging(true);\n setSelection({ startIndex: index, endIndex: index, side });\n }, []);\n\n const handleMouseMove = useCallback((index: number, side: 'left' | 'right') => {\n if (!isDragging || !dragStartRef.current) return;\n if (side !== dragStartRef.current.side) return;\n\n const start = Math.min(dragStartRef.current.index, index);\n const end = Math.max(dragStartRef.current.index, index);\n setSelection({ startIndex: start, endIndex: end, side });\n }, [isDragging]);\n\n const handleMouseUp = useCallback(() => {\n setIsDragging(false);\n }, []);\n\n const clearSelection = useCallback(() => {\n setSelection(null);\n dragStartRef.current = null;\n }, []);\n\n return {\n selection,\n isDragging,\n dragStartRef,\n handleMouseDown,\n handleMouseMove,\n handleMouseUp,\n clearSelection,\n };\n}\n\n// ============================================\n// COMMENT INPUT HOOK\n// ============================================\n\nexport interface UseCommentInputResult {\n showCommentInput: boolean;\n commentText: string;\n setCommentText: (text: string) => void;\n openCommentInput: () => void;\n closeCommentInput: () => void;\n submitComment: (onSubmit: (text: string) => void) => void;\n}\n\nexport function useCommentInput(): UseCommentInputResult {\n const [showCommentInput, setShowCommentInput] = useState(false);\n const [commentText, setCommentText] = useState('');\n\n const openCommentInput = useCallback(() => {\n setShowCommentInput(true);\n setCommentText('');\n }, []);\n\n const closeCommentInput = useCallback(() => {\n setShowCommentInput(false);\n setCommentText('');\n }, []);\n\n const submitComment = useCallback((onSubmit: (text: string) => void) => {\n if (commentText.trim()) {\n onSubmit(commentText.trim());\n setShowCommentInput(false);\n setCommentText('');\n }\n }, [commentText]);\n\n return {\n showCommentInput,\n commentText,\n setCommentText,\n openCommentInput,\n closeCommentInput,\n submitComment,\n };\n}\n\n// ============================================\n// GENERIC COMMENTS LIST HOOK\n// ============================================\n\nexport interface CommentBase {\n id: string;\n}\n\nexport interface UseCommentsResult {\n comments: T[];\n addComment: (comment: Omit) => void;\n removeComment: (id: string) => void;\n clearComments: () => void;\n commentCount: number;\n}\n\nexport function useComments(): UseCommentsResult {\n const [comments, setComments] = useState([]);\n\n const addComment = useCallback((comment: Omit) => {\n const newComment = {\n ...comment,\n id: `comment-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n } as T;\n setComments((prev) => [...prev, newComment]);\n }, []);\n\n const removeComment = useCallback((id: string) => {\n setComments((prev) => prev.filter((c) => c.id !== id));\n }, []);\n\n const clearComments = useCallback(() => {\n setComments([]);\n }, []);\n\n return {\n comments,\n addComment,\n removeComment,\n clearComments,\n commentCount: comments.length,\n };\n}\n\n// ============================================\n// FIELD COMMENTS HOOK (for key-value approvals)\n// ============================================\n\nexport interface FieldComment {\n id: string;\n fieldKey: string;\n fieldLabel: string;\n content: string;\n}\n\nexport interface UseFieldCommentsResult {\n fieldComments: FieldComment[];\n commentingField: string | null;\n commentInput: string;\n setCommentInput: (text: string) => void;\n startFieldComment: (fieldKey: string) => void;\n editFieldComment: (fieldKey: string, currentContent: string) => void;\n submitFieldComment: (fieldKey: string, fieldLabel: string) => void;\n cancelFieldComment: () => void;\n removeFieldComment: (fieldKey: string) => void;\n getFieldComment: (fieldKey: string) => FieldComment | undefined;\n hasFieldComment: (fieldKey: string) => boolean;\n commentCount: number;\n}\n\nexport function useFieldComments(): UseFieldCommentsResult {\n const [fieldComments, setFieldComments] = useState([]);\n const [commentingField, setCommentingField] = useState(null);\n const [commentInput, setCommentInput] = useState('');\n\n const startFieldComment = useCallback((fieldKey: string) => {\n setCommentingField(fieldKey);\n setCommentInput('');\n }, []);\n\n const editFieldComment = useCallback((fieldKey: string, currentContent: string) => {\n setCommentInput(currentContent);\n setCommentingField(fieldKey);\n }, []);\n\n const submitFieldComment = useCallback((fieldKey: string, fieldLabel: string) => {\n if (!commentInput.trim()) return;\n\n setFieldComments((prev) => {\n const existingIndex = prev.findIndex((c) => c.fieldKey === fieldKey);\n if (existingIndex >= 0) {\n const updated = [...prev];\n updated[existingIndex] = {\n ...updated[existingIndex],\n content: commentInput.trim(),\n };\n return updated;\n }\n return [\n ...prev,\n {\n id: `field-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n fieldKey,\n fieldLabel,\n content: commentInput.trim(),\n },\n ];\n });\n\n setCommentingField(null);\n setCommentInput('');\n }, [commentInput]);\n\n const cancelFieldComment = useCallback(() => {\n setCommentingField(null);\n setCommentInput('');\n }, []);\n\n const removeFieldComment = useCallback((fieldKey: string) => {\n setFieldComments((prev) => prev.filter((c) => c.fieldKey !== fieldKey));\n }, []);\n\n const getFieldComment = useCallback(\n (fieldKey: string) => fieldComments.find((c) => c.fieldKey === fieldKey),\n [fieldComments]\n );\n\n const hasFieldComment = useCallback(\n (fieldKey: string) => fieldComments.some((c) => c.fieldKey === fieldKey),\n [fieldComments]\n );\n\n return {\n fieldComments,\n commentingField,\n commentInput,\n setCommentInput,\n startFieldComment,\n editFieldComment,\n submitFieldComment,\n cancelFieldComment,\n removeFieldComment,\n getFieldComment,\n hasFieldComment,\n commentCount: fieldComments.length,\n };\n}\n\n// ============================================\n// UTILITY: Generate unique ID\n// ============================================\n\nexport function generateCommentId(): string {\n return `comment-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;\n}\n" }, { "path": "src/hooks/useIsMobile.ts", "content": "import { useState, useEffect } from 'react';\n\nconst MOBILE_BREAKPOINT = 768;\n\n/**\n * Hook to detect if the current viewport is mobile-sized.\n * Uses matchMedia for efficient detection without resize listeners.\n */\nexport function useIsMobile(breakpoint = MOBILE_BREAKPOINT): boolean {\n const [isMobile, setIsMobile] = useState(() => {\n if (typeof window === 'undefined') return false;\n return window.innerWidth < breakpoint;\n });\n\n useEffect(() => {\n const mediaQuery = window.matchMedia(`(max-width: ${breakpoint - 1}px)`);\n\n setIsMobile(mediaQuery.matches);\n\n const handleChange = (e: MediaQueryListEvent) => {\n setIsMobile(e.matches);\n };\n\n mediaQuery.addEventListener('change', handleChange);\n return () => mediaQuery.removeEventListener('change', handleChange);\n }, [breakpoint]);\n\n return isMobile;\n}\n" }, { "path": "src/hooks/useUrlDetection.ts", "content": "/**\n * Hook for detecting and enriching URLs with metadata from connected MCPs\n *\n * Used by TaskModal to detect pasted URLs and offer to convert them to pills.\n */\n\nimport { useState, useCallback } from 'react';\nimport { getLinkMetadata, type LinkMetadata } from '../api/client';\n\nexport interface PendingUrl {\n url: string;\n metadata: LinkMetadata;\n}\n\nexport interface UseUrlDetectionResult {\n /** Currently pending URL awaiting user decision */\n pendingUrl: PendingUrl | null;\n /** Whether we're currently fetching metadata */\n isLoading: boolean;\n /** Check if a URL can be enriched and set it as pending if so */\n checkUrl: (url: string) => Promise;\n /** Clear the pending URL (user declined or accepted) */\n clear: () => void;\n /** Convert URL to pill markdown syntax */\n toPillSyntax: (pending: PendingUrl) => string;\n}\n\nconst URL_REGEX = /https?:\\/\\/[^\\s<>\"\\]]+/g;\n\n/**\n * Extract the first URL from text\n */\nexport function extractUrl(text: string): string | null {\n const matches = text.match(URL_REGEX);\n return matches?.[0] ?? null;\n}\n\n/**\n * Convert a pending URL to pill markdown syntax\n */\nfunction toPillSyntax(pending: PendingUrl): string {\n return `[pill:${pending.metadata.type}:${pending.metadata.title}](${pending.url})`;\n}\n\n/**\n * Hook for URL detection and metadata fetching\n */\nexport function useUrlDetection(boardId: string): UseUrlDetectionResult {\n const [pendingUrl, setPendingUrl] = useState(null);\n const [isLoading, setIsLoading] = useState(false);\n\n const checkUrl = useCallback(\n async (url: string): Promise => {\n if (!boardId || !url) return false;\n\n setIsLoading(true);\n try {\n const result = await getLinkMetadata(boardId, url);\n if (result.success && result.data) {\n setPendingUrl({ url, metadata: result.data });\n return true;\n }\n return false;\n } catch {\n return false;\n } finally {\n setIsLoading(false);\n }\n },\n [boardId]\n );\n\n const clear = useCallback(() => {\n setPendingUrl(null);\n }, []);\n\n return {\n pendingUrl,\n isLoading,\n checkUrl,\n clear,\n toPillSyntax,\n };\n}\n" }, { "path": "src/index.css", "content": "/* ============================================\n WEFT - CLI-Inspired Kanban Board\n Design System\n ============================================ */\n\n:root {\n /* Typography */\n --font-mono: 'IBM Plex Mono', 'SF Mono', Consolas, monospace;\n --font-sans: system-ui, -apple-system, sans-serif;\n\n /* Color Palette - Light Theme */\n --color-bg-primary: #ffffff;\n --color-bg-secondary: #fafafa;\n --color-bg-tertiary: #f5f5f5;\n --color-bg-elevated: #ffffff;\n\n --color-text-primary: #1a1a1a;\n --color-text-secondary: #555555;\n --color-text-muted: #888888;\n\n --color-border-default: #e0e0e0;\n --color-border-subtle: #eeeeee;\n --color-border-focus: #d0d0d0;\n\n /* Orange Accent */\n --color-accent-primary: #ff6b00;\n --color-accent-secondary: #ff8c33;\n --color-accent-muted: rgba(255, 107, 0, 0.1);\n --color-accent-hover: rgba(255, 107, 0, 0.15);\n\n /* Status Colors */\n --color-success: #22c55e;\n --color-warning: #eab308;\n --color-error: #ef4444;\n --color-info: #3b82f6;\n\n /* Priority Colors */\n --color-priority-low: #888888;\n --color-priority-medium: #555555;\n --color-priority-high: #ff6b00;\n --color-priority-critical: #ef4444;\n\n /* Spacing */\n --space-1: 4px;\n --space-2: 8px;\n --space-3: 12px;\n --space-4: 16px;\n --space-5: 24px;\n --space-6: 32px;\n --space-8: 48px;\n\n /* Sizing */\n --column-width: 320px;\n --column-gap: 16px;\n --header-height: 56px;\n --border-radius: 2px;\n\n /* Mobile */\n --touch-target-min: 44px;\n --space-mobile-gutter: 12px;\n --mobile-column-width: calc(100vw - 24px);\n\n /* Effects */\n --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.05);\n --shadow-md: 0 2px 4px rgba(0, 0, 0, 0.08);\n --shadow-lg: 0 4px 12px rgba(0, 0, 0, 0.1);\n --transition-fast: 100ms ease;\n --transition-normal: 200ms ease;\n}\n\n/* Reset */\n*, *::before, *::after {\n box-sizing: border-box;\n}\n\nbody {\n margin: 0;\n font-family: var(--font-mono);\n font-size: 14px;\n line-height: 1.5;\n color: var(--color-text-primary);\n background-color: var(--color-bg-primary);\n -webkit-font-smoothing: antialiased;\n -moz-osx-font-smoothing: grayscale;\n}\n\n#root {\n min-height: 100vh;\n display: flex;\n flex-direction: column;\n}\n\n/* Typography */\nh1, h2, h3, h4, h5, h6 {\n margin: 0;\n font-weight: 600;\n line-height: 1.3;\n}\n\np {\n margin: 0;\n}\n\n/* Links */\na {\n color: var(--color-accent-primary);\n text-decoration: none;\n}\n\na:hover {\n text-decoration: underline;\n}\n\n/* Form elements */\ninput, textarea, select {\n font-family: var(--font-mono);\n font-size: 14px;\n}\n\n/* Scrollbar styling */\n::-webkit-scrollbar {\n width: 8px;\n height: 8px;\n}\n\n::-webkit-scrollbar-track {\n background: var(--color-bg-secondary);\n}\n\n::-webkit-scrollbar-thumb {\n background: var(--color-border-default);\n border-radius: var(--border-radius);\n}\n\n::-webkit-scrollbar-thumb:hover {\n background: var(--color-border-focus);\n}\n\n/* Utility classes */\n.text-muted {\n color: var(--color-text-muted);\n}\n\n.text-secondary {\n color: var(--color-text-secondary);\n}\n\n.text-accent {\n color: var(--color-accent-primary);\n}\n\n/* Focus styles */\n:focus-visible {\n outline: 2px solid var(--color-accent-primary);\n outline-offset: 2px;\n}\n\n/* ============================================\n Mobile Responsive Styles\n ============================================ */\n@media (max-width: 767px) {\n :root {\n --column-width: var(--mobile-column-width);\n --column-gap: 0;\n --header-height: 52px;\n }\n\n body {\n font-size: 16px; /* Prevent iOS zoom on input focus */\n -webkit-text-size-adjust: 100%;\n }\n\n #root {\n min-height: 100vh;\n min-height: 100dvh; /* Dynamic viewport for iOS */\n }\n\n /* Smaller scrollbars for touch */\n ::-webkit-scrollbar {\n width: 4px;\n height: 4px;\n }\n}\n" }, { "path": "src/main.tsx", "content": "import { StrictMode } from 'react'\nimport { createRoot } from 'react-dom/client'\nimport './index.css'\nimport App from './App.tsx'\n\ncreateRoot(document.getElementById('root')!).render(\n \n \n ,\n)\n" }, { "path": "src/types/index.ts", "content": "import type { CredentialType } from '../constants';\n\n// ============================================\n// CORE ENTITIES\n// ============================================\n\nexport interface User {\n id: string;\n email: string;\n logoutUrl?: string | null;\n}\n\nexport interface Board {\n id: string;\n name: string;\n ownerId?: string;\n columns: Column[];\n toolConfig?: BoardToolConfig;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Column {\n id: string;\n boardId: string;\n name: string;\n position: number;\n}\n\nexport interface Task {\n id: string;\n columnId: string;\n boardId: string;\n title: string;\n description?: string;\n priority: TaskPriority;\n position: number;\n context?: TaskContext;\n scheduleConfig?: ScheduleConfig;\n parentTaskId?: string;\n runId?: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport type TaskPriority = 'low' | 'medium' | 'high' | 'critical';\n\n// ============================================\n// SCHEDULED TASKS\n// ============================================\n\nexport interface ScheduleConfig {\n enabled: boolean;\n frequency: 'daily' | 'weekly' | 'custom';\n time: string; // \"05:00\" (24-hour format)\n timezone: string; // \"America/Los_Angeles\"\n daysOfWeek?: number[]; // For weekly: [0-6] where 0=Sun\n cron?: string; // For custom: \"0 5 * * *\"\n targetColumnId: string; // Where to create child tasks\n}\n\nexport type ScheduledRunStatus = 'pending' | 'running' | 'completed' | 'failed';\n\nexport interface ScheduledRun {\n id: string;\n taskId: string;\n status: ScheduledRunStatus;\n startedAt?: string;\n completedAt?: string;\n tasksCreated: number;\n summary?: string;\n error?: string;\n createdAt: string;\n /** Historical record of child tasks created (preserved even after task deletion) */\n childTasksInfo?: Array<{ id: string; title: string }>;\n}\n\n// ============================================\n// AGENT EXECUTION (Future-Ready)\n// ============================================\n\nexport interface BoardToolConfig {\n tools: ToolDefinition[];\n credentials: CredentialRef[];\n sandboxConfig?: SandboxSettings;\n}\n\nexport interface ToolDefinition {\n id: string;\n name: string;\n type: 'mcp' | 'api' | 'filesystem' | 'browser';\n config: {\n endpoint?: string;\n permissions?: string[];\n scope?: string;\n };\n enabled: boolean;\n}\n\nexport interface CredentialRef {\n id: string;\n name: string;\n type: string;\n // Actual credentials stored encrypted separately\n}\n\nexport interface BoardCredential {\n id: string;\n boardId: string;\n type: CredentialType;\n name: string;\n // Note: encrypted_value is never exposed to frontend\n metadata?: Record;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface SandboxSettings {\n memoryLimitMb?: number;\n timeoutMs?: number;\n allowedDomains?: string[];\n}\n\nexport interface TaskContext {\n instructions?: string;\n references?: string[];\n expectedOutputs?: string[];\n constraints?: string[];\n dependsOn?: string[];\n}\n\n// ============================================\n// API TYPES\n// ============================================\n\nexport interface ApiResponse {\n success: boolean;\n data?: T;\n error?: ApiError;\n}\n\nexport interface ApiError {\n code: string;\n message: string;\n}\n\n// ============================================\n// DIFF COMMENTS\n// ============================================\n\nexport interface DiffComment {\n id: string;\n filePath: string;\n lineNumber: number;\n endLine?: number; // For multi-line selections\n lineType: 'addition' | 'deletion' | 'context';\n content: string;\n kind?: 'comment' | 'suggestion';\n suggestion?: string;\n}\n\n// ============================================\n// TEXT COMMENTS (for non-diff content)\n// ============================================\n\nexport interface TextComment {\n id: string;\n lineStart: number;\n lineEnd: number;\n content: string;\n}\n\n// ============================================\n// UI STATE\n// ============================================\n\nexport interface DragState {\n isDragging: boolean;\n taskId: string | null;\n sourceColumnId: string | null;\n}\n\nexport interface ColumnDragState {\n isDragging: boolean;\n columnId: string | null;\n}\n\nexport interface BoardViewState {\n selectedBoardId: string | null;\n selectedTaskId: string | null;\n isCreatingTask: boolean;\n isEditingTask: boolean;\n}\n\n// ============================================\n// MCP SERVER TYPES\n// ============================================\n\nexport interface MCPServer {\n id: string;\n boardId: string;\n name: string;\n type: 'remote' | 'hosted';\n endpoint?: string;\n authType: 'none' | 'oauth' | 'api_key' | 'bearer';\n credentialId?: string;\n /** Transport type for remote servers. Defaults to 'streamable-http' */\n transportType?: 'streamable-http' | 'sse';\n enabled: boolean;\n status: 'connected' | 'disconnected' | 'error';\n /** URL patterns this MCP can enrich (for link pills) */\n urlPatterns?: MCPUrlPattern[];\n createdAt: string;\n updatedAt: string;\n}\n\n/** Link pill types for enriched URL display */\nexport type LinkPillType = 'google_doc' | 'google_sheet' | 'github_pr' | 'github_issue' | 'github_repo';\n\nexport interface MCPUrlPattern {\n /** Regex pattern to match URLs */\n pattern: string;\n /** Type of resource this pattern matches */\n type: LinkPillType;\n /** Tool name to call for fetching metadata */\n fetchTool: string;\n}\n\nexport interface MCPTool {\n id: string;\n serverId: string;\n name: string;\n description?: string;\n inputSchema: JSONSchema;\n cachedAt: string;\n}\n\nexport interface JSONSchema {\n type: 'object' | 'string' | 'number' | 'boolean' | 'array' | 'integer' | 'null';\n properties?: Record;\n required?: string[];\n items?: JSONSchema;\n description?: string;\n enum?: unknown[];\n default?: unknown;\n format?: string;\n}\n\n// ============================================\n// WORKFLOW PLAN TYPES\n// ============================================\n\nexport type WorkflowPlanStatus =\n | 'planning'\n | 'draft'\n | 'approved'\n | 'executing'\n | 'checkpoint'\n | 'completed'\n | 'failed';\n\nexport interface WorkflowArtifact {\n type: 'google_doc' | 'google_sheet' | 'gmail_message' | 'github_pr' | 'file' | 'other';\n url?: string;\n title?: string;\n description?: string;\n // Email content for inline viewing (gmail_message type)\n content?: {\n to?: string;\n cc?: string;\n bcc?: string;\n subject?: string;\n body?: string;\n sentAt?: string;\n };\n}\n\nexport interface WorkflowResult {\n success: boolean;\n artifacts?: WorkflowArtifact[];\n stepResults?: Record;\n error?: string;\n}\n\nexport interface WorkflowPlan {\n id: string;\n taskId: string;\n boardId: string;\n status: WorkflowPlanStatus;\n summary?: string;\n generatedCode?: string;\n steps?: WorkflowStep[];\n currentStepIndex?: number;\n checkpointData?: Record;\n result?: WorkflowResult;\n createdAt: string;\n updatedAt: string;\n}\n\nexport type WorkflowStepType = 'tool_call' | 'checkpoint' | 'internal' | 'agent' | 'tool';\nexport type WorkflowStepStatus =\n | 'pending'\n | 'running'\n | 'completed'\n | 'failed'\n | 'awaiting_approval';\n\nexport interface WorkflowStep {\n id: string;\n name: string;\n type: WorkflowStepType;\n mcpServer?: string;\n toolName?: string;\n status: WorkflowStepStatus;\n startedAt?: string;\n completedAt?: string;\n durationMs?: number;\n result?: unknown;\n error?: string;\n}\n\n// ============================================\n// WORKFLOW LOGS (Real-Time Observability)\n// ============================================\n\nexport type WorkflowLogLevel = 'info' | 'warn' | 'error';\n\nexport interface WorkflowLogMetadata {\n type?: 'tool_call' | 'tool_result' | 'step_start' | 'step_end' | 'checkpoint' | 'workflow_complete' | 'workflow_error' | 'step_error' | 'agent_turn' | 'agent_stream';\n server?: string;\n tool?: string;\n args?: Record;\n durationMs?: number;\n resultPreview?: string;\n stepIndex?: number;\n totalSteps?: number;\n artifactCount?: number;\n turnIndex?: number;\n text?: string;\n}\n\nexport interface WorkflowLog {\n id: string;\n planId: string;\n stepId?: string;\n timestamp: string;\n level: WorkflowLogLevel;\n message: string;\n metadata?: WorkflowLogMetadata;\n}\n\n// Re-export constants for convenience\nexport { CREDENTIAL_TYPES, type CredentialType } from '../constants';\n" }, { "path": "src/utils/diffParser.ts", "content": "/**\n * Unified diff parser\n * Parses git diff output into structured data\n */\n\nexport interface DiffFile {\n path: string;\n oldPath?: string;\n action: 'added' | 'modified' | 'deleted' | 'renamed';\n hunks: DiffHunk[];\n additions: number;\n deletions: number;\n}\n\nexport interface DiffHunk {\n oldStart: number;\n oldLines: number;\n newStart: number;\n newLines: number;\n header: string;\n lines: DiffLine[];\n}\n\nexport interface DiffLine {\n type: 'context' | 'addition' | 'deletion' | 'header';\n content: string;\n oldLineNumber?: number;\n newLineNumber?: number;\n}\n\n/**\n * Parse a unified diff string into structured data\n */\nexport function parseDiff(diffText: string): DiffFile[] {\n const files: DiffFile[] = [];\n const fileDiffs = diffText.split(/(?=^diff --git)/m).filter(Boolean);\n\n for (const fileDiff of fileDiffs) {\n const file = parseFileDiff(fileDiff);\n if (file) {\n files.push(file);\n }\n }\n\n return files;\n}\n\nfunction parseFileDiff(diffText: string): DiffFile | null {\n const lines = diffText.split('\\n');\n\n // Parse file header\n const headerMatch = lines[0].match(/^diff --git a\\/(.+) b\\/(.+)$/);\n if (!headerMatch) return null;\n\n const oldPath = headerMatch[1];\n const newPath = headerMatch[2];\n\n // Determine action\n let action: DiffFile['action'] = 'modified';\n if (diffText.includes('new file mode')) {\n action = 'added';\n } else if (diffText.includes('deleted file mode')) {\n action = 'deleted';\n } else if (oldPath !== newPath) {\n action = 'renamed';\n }\n\n // Parse hunks\n const hunks: DiffHunk[] = [];\n let currentHunk: DiffHunk | null = null;\n let oldLineNum = 0;\n let newLineNum = 0;\n\n for (const line of lines) {\n // Hunk header\n const hunkMatch = line.match(/^@@\\s*-(\\d+)(?:,(\\d+))?\\s*\\+(\\d+)(?:,(\\d+))?\\s*@@(.*)$/);\n if (hunkMatch) {\n if (currentHunk) {\n hunks.push(currentHunk);\n }\n\n oldLineNum = parseInt(hunkMatch[1], 10);\n newLineNum = parseInt(hunkMatch[3], 10);\n\n currentHunk = {\n oldStart: oldLineNum,\n oldLines: parseInt(hunkMatch[2] || '1', 10),\n newStart: newLineNum,\n newLines: parseInt(hunkMatch[4] || '1', 10),\n header: line,\n lines: [],\n };\n continue;\n }\n\n if (!currentHunk) continue;\n\n // Parse diff lines\n if (line.startsWith('+') && !line.startsWith('+++')) {\n currentHunk.lines.push({\n type: 'addition',\n content: line.slice(1),\n newLineNumber: newLineNum++,\n });\n } else if (line.startsWith('-') && !line.startsWith('---')) {\n currentHunk.lines.push({\n type: 'deletion',\n content: line.slice(1),\n oldLineNumber: oldLineNum++,\n });\n } else if (line.startsWith(' ')) {\n currentHunk.lines.push({\n type: 'context',\n content: line.slice(1),\n oldLineNumber: oldLineNum++,\n newLineNumber: newLineNum++,\n });\n }\n }\n\n if (currentHunk) {\n hunks.push(currentHunk);\n }\n\n // Count additions and deletions\n let additions = 0;\n let deletions = 0;\n for (const hunk of hunks) {\n for (const line of hunk.lines) {\n if (line.type === 'addition') additions++;\n if (line.type === 'deletion') deletions++;\n }\n }\n\n return {\n path: newPath,\n oldPath: action === 'renamed' ? oldPath : undefined,\n action,\n hunks,\n additions,\n deletions,\n };\n}\n\n/**\n * Get file extension from path\n */\nexport function getFileExtension(path: string): string {\n const match = path.match(/\\.([^.]+)$/);\n return match ? match[1].toLowerCase() : '';\n}\n\n/**\n * Get language for syntax highlighting based on file extension\n */\nexport function getLanguage(path: string): string {\n const ext = getFileExtension(path);\n const languageMap: Record = {\n ts: 'typescript',\n tsx: 'typescript',\n js: 'javascript',\n jsx: 'javascript',\n py: 'python',\n rb: 'ruby',\n go: 'go',\n rs: 'rust',\n java: 'java',\n c: 'c',\n cpp: 'cpp',\n h: 'c',\n hpp: 'cpp',\n css: 'css',\n scss: 'scss',\n html: 'html',\n json: 'json',\n yaml: 'yaml',\n yml: 'yaml',\n md: 'markdown',\n sql: 'sql',\n sh: 'bash',\n bash: 'bash',\n };\n return languageMap[ext] || 'text';\n}\n" }, { "path": "src/vite-env.d.ts", "content": "/// \n" }, { "path": "tests/mocks/cloudflare-sandbox.ts", "content": "// Mock for @cloudflare/sandbox - not supported in vitest-pool-workers\nexport class Sandbox {\n static fromClass() {\n return class MockSandbox {};\n }\n}\n" }, { "path": "tests/worker/auth.test.ts", "content": "/**\n * Auth Layer Security Tests\n *\n * Proves that:\n * - AUTH_MODE=access requires valid JWT\n * - AUTH_MODE=none returns singleton user without auth\n * - Invalid JWTs are rejected\n */\n\nimport { describe, it, expect, vi, beforeEach } from 'vitest';\nimport { getAuthenticatedUser, type AuthEnv } from '../../worker/auth';\n\n// Mock jose module\nvi.mock('jose', () => ({\n createRemoteJWKSet: vi.fn(() => vi.fn()),\n jwtVerify: vi.fn(),\n}));\n\nimport { jwtVerify } from 'jose';\n\ndescribe('getAuthenticatedUser', () => {\n beforeEach(() => {\n vi.clearAllMocks();\n });\n\n describe('AUTH_MODE=access (Cloudflare Access)', () => {\n const accessEnv: AuthEnv = {\n AUTH_MODE: 'access',\n ACCESS_AUD: 'production-aud-123',\n ACCESS_TEAM: 'myteam',\n };\n\n it('rejects requests without JWT header', async () => {\n const request = new Request('https://example.com/api/boards');\n\n const user = await getAuthenticatedUser(request, accessEnv);\n\n expect(user).toBeNull();\n });\n\n it('rejects requests with invalid JWT', async () => {\n vi.mocked(jwtVerify).mockRejectedValueOnce(new Error('Invalid signature'));\n\n const request = new Request('https://example.com/api/boards', {\n headers: { 'CF-Access-JWT-Assertion': 'invalid-jwt-token' },\n });\n\n const user = await getAuthenticatedUser(request, accessEnv);\n\n expect(user).toBeNull();\n });\n\n it('rejects JWT with wrong audience', async () => {\n vi.mocked(jwtVerify).mockRejectedValueOnce(new Error('Audience mismatch'));\n\n const request = new Request('https://example.com/api/boards', {\n headers: { 'CF-Access-JWT-Assertion': 'jwt-wrong-audience' },\n });\n\n const user = await getAuthenticatedUser(request, accessEnv);\n\n expect(user).toBeNull();\n });\n\n it('accepts valid JWT and extracts user info', async () => {\n vi.mocked(jwtVerify).mockResolvedValueOnce({\n payload: {\n sub: 'user-123',\n email: 'user@example.com',\n },\n protectedHeader: { alg: 'RS256' },\n key: {},\n } as unknown as Awaited>);\n\n const request = new Request('https://example.com/api/boards', {\n headers: { 'CF-Access-JWT-Assertion': 'valid-jwt-token' },\n });\n\n const user = await getAuthenticatedUser(request, accessEnv);\n\n expect(user).toEqual({\n id: 'user-123',\n email: 'user@example.com',\n });\n });\n\n it('rejects JWT missing sub claim', async () => {\n vi.mocked(jwtVerify).mockResolvedValueOnce({\n payload: {\n email: 'user@example.com',\n },\n protectedHeader: { alg: 'RS256' },\n key: {},\n } as unknown as Awaited>);\n\n const request = new Request('https://example.com/api/boards', {\n headers: { 'CF-Access-JWT-Assertion': 'jwt-no-sub' },\n });\n\n const user = await getAuthenticatedUser(request, accessEnv);\n\n expect(user).toBeNull();\n });\n\n it('rejects JWT missing email claim', async () => {\n vi.mocked(jwtVerify).mockResolvedValueOnce({\n payload: {\n sub: 'user-123',\n },\n protectedHeader: { alg: 'RS256' },\n key: {},\n } as unknown as Awaited>);\n\n const request = new Request('https://example.com/api/boards', {\n headers: { 'CF-Access-JWT-Assertion': 'jwt-no-email' },\n });\n\n const user = await getAuthenticatedUser(request, accessEnv);\n\n expect(user).toBeNull();\n });\n\n it('CRITICAL: ignores USER_ID/USER_EMAIL in access mode', async () => {\n // Even if USER_ID is set, access mode must require JWT\n const envWithUser: AuthEnv = {\n AUTH_MODE: 'access',\n ACCESS_AUD: 'production-aud-123',\n ACCESS_TEAM: 'myteam',\n USER_ID: 'should-be-ignored',\n USER_EMAIL: 'ignored@example.com',\n };\n\n const request = new Request('https://example.com/api/boards');\n\n const user = await getAuthenticatedUser(request, envWithUser);\n\n expect(user).toBeNull();\n });\n });\n\n describe('AUTH_MODE=none (singleton user)', () => {\n const noneEnv: AuthEnv = {\n AUTH_MODE: 'none',\n USER_ID: 'singleton-user',\n USER_EMAIL: 'user@localhost',\n };\n\n it('returns singleton user without any auth', async () => {\n const request = new Request('https://example.com/api/boards');\n\n const user = await getAuthenticatedUser(request, noneEnv);\n\n expect(user).toEqual({\n id: 'singleton-user',\n email: 'user@localhost',\n });\n });\n\n it('uses default values when USER_ID/USER_EMAIL not set', async () => {\n const minimalEnv: AuthEnv = {\n AUTH_MODE: 'none',\n };\n\n const request = new Request('https://example.com/api/boards');\n\n const user = await getAuthenticatedUser(request, minimalEnv);\n\n expect(user).toEqual({\n id: 'user',\n email: 'user@localhost',\n });\n });\n\n it('ignores JWT header in none mode', async () => {\n // JWT should be ignored - we don't even try to verify it\n const request = new Request('https://example.com/api/boards', {\n headers: { 'CF-Access-JWT-Assertion': 'some-jwt-token' },\n });\n\n const user = await getAuthenticatedUser(request, noneEnv);\n\n // Should return singleton user, not attempt JWT verification\n expect(user).toEqual({\n id: 'singleton-user',\n email: 'user@localhost',\n });\n expect(jwtVerify).not.toHaveBeenCalled();\n });\n });\n});\n" }, { "path": "tests/worker/board-access.integration.test.ts", "content": "/**\n * Board Access Control Integration Tests\n *\n * Proves that:\n * - Users cannot access boards they don't own (403)\n * - Users can access their own boards (200)\n */\n\nimport { SELF } from 'cloudflare:test';\nimport { describe, it, expect } from 'vitest';\nimport '../../worker/index';\n\ndescribe('Board Access Control', () => {\n it('returns 403 when accessing board user does not own', async () => {\n const res = await SELF.fetch('http://localhost/api/boards/nonexistent-board-id');\n expect(res.status).toBe(403);\n });\n\n it('returns 200 when accessing own board', async () => {\n // Create a board first (adds to user's list)\n const createRes = await SELF.fetch('http://localhost/api/boards', {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({ name: 'Test Board' }),\n });\n expect(createRes.status).toBe(200);\n\n const { data } = (await createRes.json()) as { data: { id: string } };\n\n // Access it\n const res = await SELF.fetch(`http://localhost/api/boards/${data.id}`);\n expect(res.status).toBe(200);\n });\n});\n" }, { "path": "tests/worker/user-isolation.test.ts", "content": "/**\n * User Isolation Security Tests\n *\n * Proves that:\n * - Users can only see their own boards\n * - Users cannot access boards not in their list\n * - Cross-user access is prevented\n */\n\nimport { describe, it, expect } from 'vitest';\n\n// These tests verify the security model at the UserDO level\n// UserDO is keyed by userId, so each user has completely separate storage\n\ndescribe('User Isolation Model', () => {\n /**\n * Security Model Documentation:\n *\n * 1. UserDO is instantiated per-user using userId as the DO name\n * - const doId = env.USER_DO.idFromName(userId);\n * - This means User A and User B have completely separate DOs\n *\n * 2. Each UserDO stores only that user's board list\n * - user_boards table contains only boards this user has access to\n *\n * 3. Access check flow:\n * - Request comes in with JWT → extract userId\n * - Get UserDO for that userId\n * - Check if boardId is in that user's board list\n * - Only then proceed to BoardDO\n */\n\n describe('Conceptual Security Guarantees', () => {\n it('documents: UserDO keyed by userId provides natural isolation', () => {\n // When we do: env.USER_DO.idFromName(userA.id)\n // and: env.USER_DO.idFromName(userB.id)\n // We get TWO DIFFERENT Durable Object instances\n //\n // User A's DO has no knowledge of User B's boards\n // User B's DO has no knowledge of User A's boards\n //\n // This is enforced by Cloudflare's Durable Object infrastructure\n\n expect(true).toBe(true); // Documentation test\n });\n\n it('documents: has-access check prevents cross-user board access', () => {\n // Flow in worker/index.ts:\n //\n // 1. const user = await getAuthenticatedUser(request, env);\n // 2. const userDO = env.USER_DO.get(env.USER_DO.idFromName(user.id));\n // 3. const accessCheck = await userDO.fetch(`/has-access/${boardId}`);\n // 4. if (!accessCheck.hasAccess) return 403;\n //\n // User A cannot access User B's board because:\n // - User A's UserDO doesn't have User B's boardId in its user_boards table\n // - has-access returns false\n // - Request is rejected with 403\n\n expect(true).toBe(true); // Documentation test\n });\n\n it('documents: board creation adds to creator UserDO only', () => {\n // When creating a board:\n //\n // 1. Generate new boardId\n // 2. BoardDO(boardId).init({ owner_id: userId, name })\n // 3. UserDO(userId).addBoard(boardId, name)\n //\n // Only the creating user's UserDO gets the board added\n // Other users have no way to add boards to their list without\n // explicit sharing (not yet implemented)\n\n expect(true).toBe(true); // Documentation test\n });\n });\n\n describe('UserDO has-access Logic', () => {\n // Simulating the SQL query in UserDO.hasAccess()\n\n it('returns false for boardId not in user_boards table', () => {\n const userBoards = [\n { board_id: 'board-1', role: 'owner' },\n { board_id: 'board-2', role: 'owner' },\n ];\n\n const requestedBoardId = 'board-999'; // Not in list\n\n const hasAccess = userBoards.some(b => b.board_id === requestedBoardId);\n\n expect(hasAccess).toBe(false);\n });\n\n it('returns true for boardId in user_boards table', () => {\n const userBoards = [\n { board_id: 'board-1', role: 'owner' },\n { board_id: 'board-2', role: 'owner' },\n ];\n\n const requestedBoardId = 'board-1';\n\n const hasAccess = userBoards.some(b => b.board_id === requestedBoardId);\n\n expect(hasAccess).toBe(true);\n });\n\n it('different users have different board lists', () => {\n const userABoards = [\n { board_id: 'board-A1', role: 'owner' },\n { board_id: 'board-A2', role: 'owner' },\n ];\n\n const userBBoards = [\n { board_id: 'board-B1', role: 'owner' },\n { board_id: 'board-B2', role: 'owner' },\n ];\n\n // User A cannot access User B's boards\n const userACanAccessBoardB1 = userABoards.some(b => b.board_id === 'board-B1');\n expect(userACanAccessBoardB1).toBe(false);\n\n // User B cannot access User A's boards\n const userBCanAccessBoardA1 = userBBoards.some(b => b.board_id === 'board-A1');\n expect(userBCanAccessBoardA1).toBe(false);\n\n // Each user can access their own boards\n const userACanAccessBoardA1 = userABoards.some(b => b.board_id === 'board-A1');\n expect(userACanAccessBoardA1).toBe(true);\n\n const userBCanAccessBoardB1 = userBBoards.some(b => b.board_id === 'board-B1');\n expect(userBCanAccessBoardB1).toBe(true);\n });\n });\n\n describe('Attack Vectors (and why they fail)', () => {\n it('ATTACK: Guessing board UUIDs - BLOCKED by has-access check', () => {\n // Attacker knows or guesses a board UUID\n // They try: GET /api/boards/victim-board-uuid/tasks\n //\n // Flow:\n // 1. Attacker authenticates with their own JWT\n // 2. Worker extracts attacker's userId\n // 3. Worker checks attacker's UserDO.hasAccess('victim-board-uuid')\n // 4. Returns false - attacker never added this board\n // 5. 403 Forbidden returned\n\n const attackerBoards = ['attacker-board-1'];\n const victimBoardId = 'victim-board-uuid';\n\n const canAccess = attackerBoards.includes(victimBoardId);\n expect(canAccess).toBe(false);\n });\n\n it('ATTACK: Tampering with userId in request - BLOCKED by JWT verification', () => {\n // Attacker tries to set a custom header or parameter with victim's userId\n //\n // Flow:\n // 1. userId is ONLY extracted from verified JWT\n // 2. JWT is signed by Cloudflare Access\n // 3. Attacker cannot forge a valid JWT with victim's userId\n // 4. Any tampering invalidates the signature\n\n // Simulating: attacker cannot modify payload without invalidating JWT\n const attackerClaims = { sub: 'attacker-id', email: 'attacker@evil.com' };\n const attemptedClaims = { sub: 'victim-id', email: 'victim@example.com' };\n\n // JWT verification would fail if claims were tampered\n expect(attackerClaims.sub).not.toBe(attemptedClaims.sub);\n });\n\n it('ATTACK: Direct BoardDO access - BLOCKED by routing through UserDO first', () => {\n // All /api/boards/:id/* routes go through access check first\n //\n // Worker does NOT directly route to BoardDO\n // It ALWAYS checks UserDO.hasAccess first\n\n const accessCheckRequired = true; // Enforced in worker/index.ts\n expect(accessCheckRequired).toBe(true);\n });\n\n it('ATTACK: Singleton user in access mode - BLOCKED by AUTH_MODE check', () => {\n // Attacker tries to exploit singleton mode in production\n //\n // In production:\n // - AUTH_MODE is set to 'access' in wrangler.jsonc env.production\n // - Singleton user code path is NEVER taken when AUTH_MODE is 'access'\n // - USER_ID/USER_EMAIL are ignored in access mode\n\n const prodEnv: { AUTH_MODE: 'access' | 'none' } = { AUTH_MODE: 'access' };\n const singletonAllowed = prodEnv.AUTH_MODE === 'none';\n\n expect(singletonAllowed).toBe(false);\n });\n });\n});\n" }, { "path": "tsconfig.app.json", "content": "{\n \"compilerOptions\": {\n \"tsBuildInfoFile\": \"./node_modules/.tmp/tsconfig.app.tsbuildinfo\",\n \"target\": \"ES2022\",\n \"useDefineForClassFields\": true,\n \"lib\": [\"ES2022\", \"DOM\", \"DOM.Iterable\"],\n \"module\": \"ESNext\",\n \"skipLibCheck\": true,\n\n /* Bundler mode */\n \"moduleResolution\": \"bundler\",\n \"allowImportingTsExtensions\": true,\n \"verbatimModuleSyntax\": true,\n \"moduleDetection\": \"force\",\n \"noEmit\": true,\n \"jsx\": \"react-jsx\",\n\n /* Linting */\n \"strict\": true,\n \"noUnusedLocals\": true,\n \"noUnusedParameters\": true,\n \"erasableSyntaxOnly\": true,\n \"noFallthroughCasesInSwitch\": true,\n \"noUncheckedSideEffectImports\": true\n },\n \"include\": [\"src\"]\n}\n" }, { "path": "tsconfig.json", "content": "{\n\t\"files\": [],\n\t\"references\": [\n\t\t{\n\t\t\t\"path\": \"./tsconfig.app.json\"\n\t\t},\n\t\t{\n\t\t\t\"path\": \"./tsconfig.node.json\"\n\t\t},\n\t\t{\n\t\t\t\"path\": \"./tsconfig.worker.json\"\n\t\t}\n\t],\n\t\"compilerOptions\": {\n\t\t\"types\": [\n\t\t\t\"./worker-configuration.d.ts\"\n\t\t]\n\t}\n}" }, { "path": "tsconfig.node.json", "content": "{\n \"compilerOptions\": {\n \"tsBuildInfoFile\": \"./node_modules/.tmp/tsconfig.node.tsbuildinfo\",\n \"target\": \"ES2023\",\n \"lib\": [\"ES2023\"],\n \"module\": \"ESNext\",\n \"skipLibCheck\": true,\n\n /* Bundler mode */\n \"moduleResolution\": \"bundler\",\n \"allowImportingTsExtensions\": true,\n \"verbatimModuleSyntax\": true,\n \"moduleDetection\": \"force\",\n \"noEmit\": true,\n\n /* Linting */\n \"strict\": true,\n \"noUnusedLocals\": true,\n \"noUnusedParameters\": true,\n \"erasableSyntaxOnly\": true,\n \"noFallthroughCasesInSwitch\": true,\n \"noUncheckedSideEffectImports\": true\n },\n \"include\": [\"vite.config.ts\"]\n}\n" }, { "path": "tsconfig.worker.json", "content": "{\n \"extends\": \"./tsconfig.node.json\",\n \"compilerOptions\": {\n \"tsBuildInfoFile\": \"./node_modules/.tmp/tsconfig.worker.tsbuildinfo\",\n \"types\": [\"./worker-configuration.d.ts\", \"vite/client\"],\n },\n \"include\": [\"./worker-configuration.d.ts\", \"./worker\"]\n}\n" }, { "path": "vite.config.ts", "content": "import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react-swc'\n\nimport { cloudflare } from \"@cloudflare/vite-plugin\";\n\n// https://vite.dev/config/\nexport default defineConfig({\n plugins: [react(), cloudflare()],\n server: {\n port: 5174,\n },\n})" }, { "path": "vitest.config.ts", "content": "import { defineConfig } from 'vitest/config'\n\nexport default defineConfig({\n test: {\n include: ['tests/**/*.{test,spec}.ts'],\n exclude: ['tests/**/*.integration.test.ts'],\n },\n})\n" }, { "path": "vitest.config.workers.ts", "content": "import { defineWorkersConfig } from '@cloudflare/vitest-pool-workers/config';\nimport path from 'path';\n\nexport default defineWorkersConfig({\n test: {\n include: ['tests/worker/**/*.integration.test.ts'],\n poolOptions: {\n workers: {\n wrangler: { configPath: './wrangler.jsonc' },\n },\n },\n },\n resolve: {\n alias: {\n // Containers/Sandbox not supported in vitest-pool-workers\n '@cloudflare/sandbox': path.resolve(__dirname, 'tests/mocks/cloudflare-sandbox.ts'),\n '@cloudflare/containers': path.resolve(__dirname, 'tests/mocks/cloudflare-sandbox.ts'),\n },\n },\n});\n" }, { "path": "worker/BoardDO.ts", "content": "import { DurableObject } from 'cloudflare:workers';\nimport { initSchema } from './db/schema';\nimport {\n BoardService,\n CredentialService,\n MCPService,\n MCPOAuthService,\n WorkflowService,\n ScheduleService,\n} from './services';\nimport type { ScheduleConfig, ScheduledRun, ScheduledRunStatus } from './services';\nimport { logger } from './utils/logger';\n\n// ============================================\n// TYPE EXPORTS FOR RPC\n// ============================================\n\nexport interface Board {\n id: string;\n name: string;\n ownerId: string;\n createdAt: string;\n updatedAt: string;\n columns: Column[];\n tasks: Task[];\n}\n\nexport interface Column {\n id: string;\n boardId: string;\n name: string;\n position: number;\n}\n\nexport interface Task {\n id: string;\n columnId: string;\n boardId: string;\n title: string;\n description: string | null;\n priority: string;\n position: number;\n context: object | null;\n scheduleConfig: ScheduleConfig | null;\n parentTaskId: string | null;\n runId: string | null;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface ScheduledRunRecord {\n id: string;\n taskId: string;\n status: ScheduledRunStatus;\n startedAt: string | null;\n completedAt: string | null;\n tasksCreated: number;\n summary: string | null;\n error: string | null;\n createdAt: string;\n}\n\nexport interface WorkflowPlan {\n id: string;\n taskId: string;\n boardId: string;\n status: string;\n summary: string | null;\n generatedCode: string | null;\n steps: object[] | null;\n currentStepIndex: number | null;\n checkpointData: object | null;\n result: object | null;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Credential {\n id: string;\n boardId: string;\n type: string;\n name: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface MCPServer {\n id: string;\n boardId: string;\n name: string;\n type: string;\n endpoint: string | null;\n authType: string;\n credentialId: string | null;\n enabled: boolean;\n status: string;\n transportType: string | null;\n urlPatterns: object[] | null;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface MCPTool {\n id: string;\n serverId: string;\n name: string;\n description: string | null;\n inputSchema: object;\n approvalRequiredFields: string[] | null;\n}\n\n// ============================================\n// BOARD DURABLE OBJECT\n// ============================================\n\n/**\n * BoardDO - Durable Object for board state management\n *\n * Uses RPC for all operations except WebSocket (which requires fetch)\n */\nexport class BoardDO extends DurableObject {\n private sql: SqlStorage;\n\n // Services\n private boardService: BoardService;\n private credentialService: CredentialService;\n private mcpService: MCPService;\n private mcpOAuthService: MCPOAuthService;\n private workflowService: WorkflowService;\n private scheduleService: ScheduleService;\n\n constructor(ctx: DurableObjectState, env: Env) {\n super(ctx, env);\n this.sql = ctx.storage.sql;\n initSchema(this.sql);\n\n const generateId = () => crypto.randomUUID();\n\n this.credentialService = new CredentialService(\n this.sql,\n env.ENCRYPTION_KEY,\n generateId,\n {\n GOOGLE_CLIENT_ID: env.GOOGLE_CLIENT_ID,\n GOOGLE_CLIENT_SECRET: env.GOOGLE_CLIENT_SECRET,\n }\n );\n\n this.boardService = new BoardService(\n this.sql,\n this.credentialService,\n generateId\n );\n\n this.mcpService = new MCPService(\n this.sql,\n this.credentialService,\n generateId\n );\n\n this.mcpOAuthService = new MCPOAuthService(\n this.sql,\n this.credentialService,\n this.mcpService,\n generateId\n );\n\n this.workflowService = new WorkflowService(\n this.sql,\n generateId,\n (boardId, type, data) => this.broadcast(boardId, type, data)\n );\n\n this.scheduleService = new ScheduleService(\n this.sql,\n generateId\n );\n }\n\n // ============================================\n // ALARM HANDLER (for scheduled tasks)\n // ============================================\n\n async alarm(): Promise {\n const now = Date.now();\n logger.schedule.info('Alarm fired', { timestamp: new Date(now).toISOString() });\n\n const boardInfo = await this.getBoardInfo();\n if (!boardInfo.id) {\n logger.schedule.info('No board ID found, skipping alarm');\n return;\n }\n\n const boardId = boardInfo.id;\n logger.schedule.info('Processing alarm', { boardId });\n\n const dueTasks = this.scheduleService.getTasksDueForRun(boardId, now);\n logger.schedule.info('Tasks due for run', { boardId, count: dueTasks.length });\n\n const currentTime = new Date(now).toISOString();\n\n for (const { id: taskId, config, lastRunAt } of dueTasks) {\n try {\n const runResponse = this.scheduleService.createScheduledRun(taskId);\n const runResult = await runResponse.json() as { success: boolean; data?: ScheduledRun };\n if (!runResult.success || !runResult.data) continue;\n\n const runId = runResult.data.id;\n const task = await this.getTask(taskId);\n\n this.scheduleService.updateScheduledRun(runId, { status: 'running' });\n\n const planResponse = this.workflowService.createWorkflowPlan(taskId, {\n boardId,\n summary: `Scheduled run: ${task.title}`,\n });\n const planResult = await planResponse.json() as { success: boolean; data?: WorkflowPlan };\n if (!planResult.success || !planResult.data) continue;\n\n const planId = planResult.data.id;\n\n const workflow = await this.env.AGENT_WORKFLOW.create({\n id: runId,\n params: {\n planId,\n taskId,\n boardId,\n taskDescription: [task.title, task.description].filter(Boolean).join('\\n\\n') || 'No task description provided',\n isScheduledRun: true,\n runId,\n targetColumnId: config.targetColumnId,\n parentTaskId: taskId,\n currentTime,\n lastRunAt,\n scheduleTimezone: config.timezone,\n },\n });\n\n logger.schedule.info('Started scheduled run', { runId, taskId, workflowId: workflow.id });\n\n this.broadcast(boardId, 'scheduled_run_started', {\n taskId,\n runId,\n planId,\n });\n } catch (error) {\n logger.schedule.error('Failed to start scheduled run', { taskId, error: String(error) });\n }\n }\n\n await this.scheduleNextAlarm(boardId);\n }\n\n private async scheduleNextAlarm(boardId: string): Promise {\n const nextRunTime = this.scheduleService.getNextScheduledRunTime(boardId);\n\n if (nextRunTime) {\n await this.ctx.storage.setAlarm(nextRunTime);\n logger.schedule.info('Next alarm scheduled', { nextRunTime: new Date(nextRunTime).toISOString() });\n } else {\n await this.ctx.storage.deleteAlarm();\n }\n }\n\n // ============================================\n // WEBSOCKET (requires fetch - can't use RPC)\n // ============================================\n\n async fetch(request: Request): Promise {\n const url = new URL(request.url);\n\n if (url.pathname === '/ws' && request.headers.get('Upgrade') === 'websocket') {\n return this.handleWebSocketUpgrade(url);\n }\n\n return new Response('Use RPC methods', { status: 400 });\n }\n\n private handleWebSocketUpgrade(url: URL): Response {\n const pair = new WebSocketPair();\n const [client, server] = Object.values(pair);\n\n const boardId = url.searchParams.get('boardId');\n this.ctx.acceptWebSocket(server);\n server.serializeAttachment({ boardId });\n\n return new Response(null, { status: 101, webSocket: client });\n }\n\n async webSocketMessage(ws: WebSocket, message: string | ArrayBuffer) {\n if (typeof message === 'string') {\n try {\n const data = JSON.parse(message);\n if (data.type === 'ping') {\n ws.send(JSON.stringify({ type: 'pong' }));\n }\n } catch {\n // Ignore malformed messages\n }\n }\n }\n\n async webSocketClose() {\n // Cleanup handled by runtime\n }\n\n private broadcast(boardId: string, type: string, data: Record): void {\n const clients = this.ctx.getWebSockets();\n const message = JSON.stringify({ type, data });\n\n for (const ws of clients) {\n try {\n const attachment = ws.deserializeAttachment() as { boardId: string } | null;\n if (attachment?.boardId === boardId) {\n ws.send(message);\n }\n } catch {\n // Client may have disconnected\n }\n }\n }\n\n // ============================================\n // BOARD RPC METHODS\n // ============================================\n\n async initBoard(data: { id: string; name: string; ownerId: string }): Promise {\n const response = this.boardService.initBoard(data);\n return this.extractData(response);\n }\n\n async getBoardInfo(): Promise<{ id: string; name: string; ownerId: string }> {\n const response = this.boardService.getBoardInfo();\n return this.extractData(response);\n }\n\n async getBoard(boardId: string): Promise {\n const response = this.boardService.getBoard(boardId);\n return this.extractData(response);\n }\n\n async updateBoard(boardId: string, data: { name?: string }): Promise {\n const response = this.boardService.updateBoard(boardId, data);\n return this.extractData(response);\n }\n\n async deleteBoard(boardId: string): Promise<{ success: boolean }> {\n const response = this.boardService.deleteBoard(boardId);\n return this.extractData(response);\n }\n\n // ============================================\n // COLUMN RPC METHODS\n // ============================================\n\n async createColumn(boardId: string, data: { name: string }): Promise {\n const response = this.boardService.createColumn(boardId, data);\n return this.extractData(response);\n }\n\n async updateColumn(columnId: string, data: { name?: string; position?: number }): Promise {\n const response = this.boardService.updateColumn(columnId, data);\n return this.extractData(response);\n }\n\n async deleteColumn(columnId: string): Promise<{ success: boolean }> {\n const response = this.boardService.deleteColumn(columnId);\n return this.extractData(response);\n }\n\n // ============================================\n // TASK RPC METHODS\n // ============================================\n\n async createTask(data: {\n columnId: string;\n boardId: string;\n title: string;\n description?: string;\n priority?: string;\n context?: object;\n scheduleConfig?: object;\n parentTaskId?: string;\n runId?: string;\n }): Promise {\n const response = this.boardService.createTask(data);\n const task = await this.extractData(response);\n\n if (data.scheduleConfig) {\n await this.scheduleNextAlarm(data.boardId);\n }\n\n this.broadcast(data.boardId, 'task_created', { task });\n\n return task;\n }\n\n async getTask(taskId: string): Promise {\n const response = this.boardService.getTask(taskId);\n return this.extractData(response);\n }\n\n async updateTask(taskId: string, data: {\n title?: string;\n description?: string;\n priority?: string;\n context?: object;\n scheduleConfig?: object | null;\n }): Promise {\n const response = this.boardService.updateTask(taskId, data);\n const task = await this.extractData(response);\n\n if (data.scheduleConfig !== undefined) {\n await this.scheduleNextAlarm(task.boardId);\n }\n\n return task;\n }\n\n async deleteTask(taskId: string): Promise<{ success: boolean }> {\n const response = this.boardService.deleteTask(taskId);\n return this.extractData(response);\n }\n\n async moveTask(taskId: string, data: { columnId: string; position: number }): Promise {\n const response = this.boardService.moveTask(taskId, data);\n return this.extractData(response);\n }\n\n // ============================================\n // SCHEDULE RPC METHODS\n // ============================================\n\n async getScheduledTasks(boardId: string): Promise {\n const response = this.scheduleService.getScheduledTasks(boardId);\n return this.extractData(response);\n }\n\n async getScheduledRuns(taskId: string, limit?: number): Promise {\n const response = this.scheduleService.getScheduledRuns(taskId, limit);\n return this.extractData(response);\n }\n\n async getRunTasks(runId: string): Promise {\n const response = this.scheduleService.getRunTasks(runId);\n return this.extractData(response);\n }\n\n async getChildTasks(parentTaskId: string): Promise {\n const response = this.scheduleService.getChildTasks(parentTaskId);\n return this.extractData(response);\n }\n\n async triggerScheduledRun(taskId: string): Promise<{ runId: string }> {\n const task = await this.getTask(taskId);\n if (!task.scheduleConfig) {\n throw new Error('Task does not have a schedule configured');\n }\n\n const config = task.scheduleConfig;\n\n const runResponse = this.scheduleService.createScheduledRun(taskId);\n const runResult = await runResponse.json() as { success: boolean; data?: ScheduledRun };\n if (!runResult.success || !runResult.data) {\n throw new Error('Failed to create scheduled run');\n }\n\n const runId = runResult.data.id;\n\n this.scheduleService.updateScheduledRun(runId, { status: 'running' });\n\n const planResponse = this.workflowService.createWorkflowPlan(taskId, {\n boardId: task.boardId,\n summary: `Manual run: ${task.title}`,\n });\n const planResult = await planResponse.json() as { success: boolean; data?: WorkflowPlan };\n if (!planResult.success || !planResult.data) {\n throw new Error('Failed to create workflow plan');\n }\n\n const planId = planResult.data.id;\n\n const runsResponse = this.scheduleService.getScheduledRuns(taskId, 10);\n const runsResult = await runsResponse.json() as { success: boolean; data?: Array<{ status: string; completedAt?: string }> };\n const lastCompletedRun = runsResult.data?.find(r => r.status === 'completed' && r.completedAt);\n const lastRunAt = lastCompletedRun?.completedAt;\n\n const currentTime = new Date().toISOString();\n\n await this.env.AGENT_WORKFLOW.create({\n id: runId,\n params: {\n planId,\n taskId,\n boardId: task.boardId,\n taskDescription: [task.title, task.description].filter(Boolean).join('\\n\\n') || 'No task description provided',\n isScheduledRun: true,\n runId,\n targetColumnId: config.targetColumnId,\n parentTaskId: taskId,\n currentTime,\n lastRunAt,\n scheduleTimezone: config.timezone,\n },\n });\n\n this.broadcast(task.boardId, 'scheduled_run_started', {\n taskId,\n runId,\n planId,\n });\n\n return { runId };\n }\n\n async updateScheduledRun(runId: string, data: {\n status?: ScheduledRunStatus;\n completedAt?: string;\n tasksCreated?: number;\n summary?: string;\n error?: string;\n childTasksInfo?: Array<{ id: string; title: string }>;\n }): Promise {\n const response = this.scheduleService.updateScheduledRun(runId, data);\n return this.extractData(response);\n }\n\n async deleteScheduledRun(runId: string): Promise {\n this.scheduleService.deleteScheduledRun(runId);\n }\n\n // ============================================\n // CREDENTIAL RPC METHODS\n // ============================================\n\n async getCredentials(boardId: string): Promise {\n const response = this.credentialService.getCredentials(boardId);\n return this.extractData(response);\n }\n\n async createCredential(boardId: string, data: {\n type: string;\n name: string;\n value: string;\n metadata?: object;\n }): Promise {\n const response = await this.credentialService.createCredential(boardId, data);\n return this.extractData(response);\n }\n\n async deleteCredential(boardId: string, credentialId: string): Promise<{ success: boolean }> {\n const response = this.credentialService.deleteCredential(boardId, credentialId);\n return this.extractData(response);\n }\n\n async getCredentialValue(boardId: string, type: string): Promise {\n return this.credentialService.getCredentialValue(boardId, type);\n }\n\n async getCredentialFull(boardId: string, type: string): Promise<{ value: string; metadata: object } | null> {\n const response = await this.credentialService.getCredentialFullResponse(boardId, type);\n const result = await response.json() as { success: boolean; data?: { value: string; metadata: object } };\n return result.success ? result.data! : null;\n }\n\n async updateCredentialValue(\n boardId: string,\n type: string,\n value: string,\n metadata?: Record\n ): Promise<{ success: boolean }> {\n const response = await this.credentialService.updateCredentialValue(boardId, type, value, metadata);\n return this.extractData(response);\n }\n\n async getCredentialById(boardId: string, credentialId: string): Promise<{ value: string; metadata: object | null } | null> {\n const response = await this.credentialService.getCredentialById(boardId, credentialId);\n const result = await response.json() as { success: boolean; data?: { value: string; metadata: object | null } };\n return result.success ? result.data! : null;\n }\n\n findCredentialId(boardId: string, type: string): string | undefined {\n return this.credentialService.findCredentialId(boardId, type);\n }\n\n // ============================================\n // WORKFLOW PLAN RPC METHODS\n // ============================================\n\n async getTaskWorkflowPlan(taskId: string): Promise {\n const response = this.workflowService.getTaskWorkflowPlan(taskId);\n const result = await response.json() as { success: boolean; data: WorkflowPlan | null };\n return result.data;\n }\n\n async getBoardWorkflowPlans(boardId: string): Promise {\n const response = this.workflowService.getBoardWorkflowPlans(boardId);\n return this.extractData(response);\n }\n\n async createWorkflowPlan(taskId: string, data: {\n id?: string;\n boardId: string;\n summary?: string;\n generatedCode?: string;\n steps?: object[];\n }): Promise {\n const response = this.workflowService.createWorkflowPlan(taskId, data);\n return this.extractData(response);\n }\n\n async getWorkflowPlan(planId: string): Promise {\n const response = this.workflowService.getWorkflowPlan(planId);\n return this.extractData(response);\n }\n\n async updateWorkflowPlan(planId: string, data: {\n status?: string;\n summary?: string;\n generatedCode?: string;\n steps?: object[];\n currentStepIndex?: number;\n checkpointData?: object;\n result?: object;\n }): Promise {\n const response = this.workflowService.updateWorkflowPlan(planId, data);\n return this.extractData(response);\n }\n\n async deleteWorkflowPlan(planId: string): Promise<{ success: boolean }> {\n const response = this.workflowService.deleteWorkflowPlan(planId);\n return this.extractData(response);\n }\n\n async approveWorkflowPlan(planId: string): Promise {\n const response = this.workflowService.approveWorkflowPlan(planId);\n return this.extractData(response);\n }\n\n async resolveWorkflowCheckpoint(planId: string, data: {\n action: string;\n data?: object;\n }): Promise {\n const response = this.workflowService.resolveWorkflowCheckpoint(planId, data);\n return this.extractData(response);\n }\n\n // ============================================\n // WORKFLOW LOG RPC METHODS\n // ============================================\n\n async getWorkflowLogs(planId: string, limit?: number, offset?: number): Promise {\n const params = new URLSearchParams();\n if (limit) params.set('limit', String(limit));\n if (offset) params.set('offset', String(offset));\n const response = this.workflowService.getWorkflowLogs(planId, params);\n return this.extractData(response);\n }\n\n addWorkflowLog(\n planId: string,\n level: string,\n message: string,\n stepId?: string,\n metadata?: object\n ): Record {\n return this.workflowService.addWorkflowLog(planId, level, message, stepId, metadata);\n }\n\n broadcastStreamChunk(boardId: string, planId: string, turnIndex: number, text: string): void {\n this.broadcast(boardId, 'workflow_stream', { planId, turnIndex, text });\n }\n\n // ============================================\n // MCP SERVER RPC METHODS\n // ============================================\n\n async getMCPServers(boardId: string): Promise {\n const response = this.mcpService.getMCPServers(boardId);\n return this.extractData(response);\n }\n\n async getMCPServer(serverId: string): Promise {\n const response = this.mcpService.getMCPServer(serverId);\n return this.extractData(response);\n }\n\n async createMCPServer(boardId: string, data: {\n name: string;\n type: 'remote' | 'hosted';\n endpoint?: string;\n authType?: string;\n credentialId?: string;\n status?: string;\n transportType?: 'streamable-http' | 'sse';\n urlPatterns?: Array<{ pattern: string; type: string; fetchTool: string }>;\n }): Promise {\n const response = this.mcpService.createMCPServer(boardId, data);\n return this.extractData(response);\n }\n\n async createAccountMCP(boardId: string, data: {\n accountId: string;\n mcpId: string;\n }): Promise {\n const response = await this.mcpService.createAccountMCP(boardId, data);\n return this.extractData(response);\n }\n\n async updateMCPServer(serverId: string, data: {\n name?: string;\n endpoint?: string;\n authType?: string;\n credentialId?: string;\n enabled?: boolean;\n status?: string;\n transportType?: 'streamable-http' | 'sse';\n }): Promise {\n const response = this.mcpService.updateMCPServer(serverId, data);\n return this.extractData(response);\n }\n\n async deleteMCPServer(serverId: string): Promise<{ success: boolean }> {\n const response = this.mcpService.deleteMCPServer(serverId);\n return this.extractData(response);\n }\n\n async getMCPServerTools(serverId: string): Promise {\n const response = await this.mcpService.getMCPServerTools(serverId);\n return this.extractData(response);\n }\n\n async cacheMCPServerTools(serverId: string, data: {\n tools: Array<{\n name: string;\n description?: string;\n inputSchema: object;\n approvalRequiredFields?: string[];\n }>;\n }): Promise {\n const response = await this.mcpService.cacheMCPServerTools(serverId, data);\n return this.extractData(response);\n }\n\n async connectMCPServer(serverId: string): Promise<{\n status: string;\n toolCount: number;\n tools: Array<{ name: string; description?: string }>;\n }> {\n const response = await this.mcpService.connectMCPServer(serverId);\n return this.extractData(response);\n }\n\n // ============================================\n // MCP OAUTH RPC METHODS\n // ============================================\n\n async discoverMCPOAuth(serverId: string): Promise {\n const response = await this.mcpOAuthService.discoverMCPOAuth(serverId);\n return this.extractData(response);\n }\n\n async getMCPOAuthUrl(serverId: string, redirectUri: string): Promise<{ url: string; state: string }> {\n const params = new URLSearchParams();\n params.set('redirectUri', redirectUri);\n const response = await this.mcpOAuthService.getMCPOAuthUrl(serverId, params);\n return this.extractData(response);\n }\n\n async exchangeMCPOAuthCode(serverId: string, data: {\n code: string;\n state: string;\n redirectUri: string;\n }): Promise<{ status: string; credentialId: string }> {\n const response = await this.mcpOAuthService.exchangeMCPOAuthCode(serverId, data);\n return this.extractData(response);\n }\n\n // ============================================\n // OTHER RPC METHODS\n // ============================================\n\n async getGitHubRepos(boardId: string): Promise> {\n const response = await this.boardService.getGitHubRepos(boardId);\n return this.extractData(response);\n }\n\n async getLinkMetadata(boardId: string, data: { url: string }): Promise<{\n type: string;\n title: string;\n id: string;\n } | null> {\n const response = await this.boardService.getLinkMetadata(boardId, data);\n const result = await response.json() as { success: boolean; data: object | null };\n return result.data as { type: string; title: string; id: string } | null;\n }\n\n // ============================================\n // HELPER METHODS\n // ============================================\n\n private async extractData(response: Response): Promise {\n const result = await response.json() as { success?: boolean; data?: T; error?: string };\n if (result.error) {\n throw new Error(result.error);\n }\n return result.data as T;\n }\n}\n" }, { "path": "worker/UserDO.ts", "content": "/**\n * UserDO - Durable Object for user data\n *\n * Keyed by user ID (from Cloudflare Access JWT `sub` claim)\n * Stores: user info, list of boards user has access to\n *\n * Uses RPC for all operations (no HTTP routing needed)\n */\n\nimport { DurableObject } from 'cloudflare:workers';\n\n// Response types for RPC methods\nexport interface UserInfo {\n id: string;\n email: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface UserBoard {\n id: string;\n boardId: string;\n name: string;\n role: string;\n createdAt: string;\n addedAt: string;\n}\n\nexport interface AccessResult {\n hasAccess: boolean;\n role?: string;\n}\n\nexport class UserDO extends DurableObject {\n private sql: SqlStorage;\n\n constructor(ctx: DurableObjectState, env: Env) {\n super(ctx, env);\n this.sql = ctx.storage.sql;\n this.initSchema();\n }\n\n private initSchema(): void {\n this.sql.exec(`\n CREATE TABLE IF NOT EXISTS user_info (\n id TEXT PRIMARY KEY,\n email TEXT NOT NULL,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL\n );\n\n CREATE TABLE IF NOT EXISTS user_boards (\n board_id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n role TEXT NOT NULL DEFAULT 'owner',\n added_at TEXT NOT NULL\n );\n `);\n }\n\n // ============================================\n // RPC METHODS (called directly from worker)\n // ============================================\n\n /**\n * Initialize or update user info\n */\n async initUser(id: string, email: string): Promise<{ success: boolean }> {\n const now = new Date().toISOString();\n\n const existing = this.sql.exec(\n 'SELECT id, email FROM user_info WHERE id = ?',\n id\n ).toArray()[0] as { id: string; email: string } | undefined;\n\n if (existing) {\n if (existing.email !== email) {\n this.sql.exec(\n 'UPDATE user_info SET email = ?, updated_at = ? WHERE id = ?',\n email,\n now,\n id\n );\n }\n } else {\n this.sql.exec(\n 'INSERT INTO user_info (id, email, created_at, updated_at) VALUES (?, ?, ?, ?)',\n id,\n email,\n now,\n now\n );\n }\n\n return { success: true };\n }\n\n /**\n * Get user info\n */\n async getUserInfo(): Promise {\n const user = this.sql.exec(\n 'SELECT id, email, created_at, updated_at FROM user_info'\n ).toArray()[0] as { id: string; email: string; created_at: string; updated_at: string } | undefined;\n\n if (!user) return null;\n\n return {\n id: user.id,\n email: user.email,\n createdAt: user.created_at,\n updatedAt: user.updated_at,\n };\n }\n\n /**\n * Get user's boards\n */\n async getBoards(): Promise {\n const boards = this.sql.exec(\n 'SELECT board_id, name, role, added_at FROM user_boards ORDER BY added_at DESC'\n ).toArray() as Array<{ board_id: string; name: string; role: string; added_at: string }>;\n\n return boards.map((b) => ({\n id: b.board_id,\n boardId: b.board_id,\n name: b.name,\n role: b.role,\n createdAt: b.added_at,\n addedAt: b.added_at,\n }));\n }\n\n /**\n * Add a board to user's list\n */\n async addBoard(boardId: string, name: string, role?: string): Promise<{ success: boolean }> {\n const now = new Date().toISOString();\n\n const existing = this.sql.exec(\n 'SELECT board_id FROM user_boards WHERE board_id = ?',\n boardId\n ).toArray()[0];\n\n if (existing) {\n return { success: true }; // Already exists\n }\n\n this.sql.exec(\n 'INSERT INTO user_boards (board_id, name, role, added_at) VALUES (?, ?, ?, ?)',\n boardId,\n name,\n role || 'owner',\n now\n );\n\n return { success: true };\n }\n\n /**\n * Check if user has access to a board\n */\n async hasAccess(boardId: string): Promise {\n const board = this.sql.exec(\n 'SELECT board_id, role FROM user_boards WHERE board_id = ?',\n boardId\n ).toArray()[0] as { board_id: string; role: string } | undefined;\n\n if (!board) {\n return { hasAccess: false };\n }\n\n return { hasAccess: true, role: board.role };\n }\n\n /**\n * Update board name in user's list\n */\n async updateBoardName(boardId: string, name: string): Promise<{ success: boolean }> {\n this.sql.exec(\n 'UPDATE user_boards SET name = ? WHERE board_id = ?',\n name,\n boardId\n );\n return { success: true };\n }\n\n /**\n * Remove a board from user's list\n */\n async removeBoard(boardId: string): Promise<{ success: boolean }> {\n this.sql.exec('DELETE FROM user_boards WHERE board_id = ?', boardId);\n return { success: true };\n }\n}\n" }, { "path": "worker/auth.ts", "content": "/**\n * Authentication utilities\n *\n * AUTH_MODE controls authentication:\n * - 'access': Cloudflare Access JWT verification (multi-user)\n * - 'none': No auth, singleton user (self-hosted single-user deployments)\n */\n\nimport { createRemoteJWKSet, jwtVerify, type JWTPayload } from 'jose';\nimport { logger } from './utils/logger';\n\nexport interface AuthUser {\n id: string;\n email: string;\n}\n\ninterface AccessJWTPayload extends JWTPayload {\n email?: string;\n sub?: string;\n}\n\n// Extended Env type for auth (adds to auto-generated Env)\nexport interface AuthEnv {\n AUTH_MODE: 'access' | 'none';\n ACCESS_AUD?: string;\n ACCESS_TEAM?: string;\n USER_ID?: string;\n USER_EMAIL?: string;\n}\n\n// Cache JWKS for performance\nlet jwksCache: ReturnType | null = null;\n\nfunction getJWKS(teamName: string) {\n if (!jwksCache) {\n jwksCache = createRemoteJWKSet(\n new URL(`https://${teamName}.cloudflareaccess.com/cdn-cgi/access/certs`)\n );\n }\n return jwksCache;\n}\n\n/**\n * Verify Cloudflare Access JWT and extract user info\n */\nasync function verifyAccessJWT(\n jwt: string,\n env: AuthEnv\n): Promise {\n if (!env.ACCESS_AUD || !env.ACCESS_TEAM) {\n logger.auth.error('ACCESS_AUD or ACCESS_TEAM not configured');\n return null;\n }\n\n try {\n const jwks = getJWKS(env.ACCESS_TEAM);\n const { payload } = await jwtVerify(jwt, jwks, {\n audience: env.ACCESS_AUD,\n });\n\n const accessPayload = payload as AccessJWTPayload;\n\n if (!accessPayload.sub || !accessPayload.email) {\n logger.auth.error('JWT missing sub or email claim');\n return null;\n }\n\n return {\n id: accessPayload.sub,\n email: accessPayload.email,\n };\n } catch (error) {\n logger.auth.error('JWT verification failed', { error: error instanceof Error ? error.message : String(error) });\n return null;\n }\n}\n\n/**\n * Get authenticated user from request\n *\n * AUTH_MODE determines behavior:\n * - 'access': Verify Cloudflare Access JWT, multi-user\n * - 'none': Return singleton user, no auth required\n */\nexport async function getAuthenticatedUser(\n request: Request,\n env: AuthEnv\n): Promise {\n if (env.AUTH_MODE === 'none') {\n // Singleton user mode - no auth required\n return {\n id: env.USER_ID || 'user',\n email: env.USER_EMAIL || 'user@localhost',\n };\n }\n\n // AUTH_MODE === 'access' - require Cloudflare Access JWT\n const jwt = request.headers.get('CF-Access-JWT-Assertion');\n if (!jwt) {\n logger.auth.warn('No JWT provided in access mode');\n return null;\n }\n\n return await verifyAccessJWT(jwt, env);\n}\n\n/**\n * Get the Cloudflare Access logout URL\n */\nexport function getLogoutUrl(teamName: string): string {\n return `https://${teamName}.cloudflareaccess.com/cdn-cgi/access/logout`;\n}\n" }, { "path": "worker/constants.ts", "content": "/**\n * Shared constants for the worker\n */\n\n// Credential types\nexport const CREDENTIAL_TYPES = {\n GITHUB_OAUTH: 'github_oauth',\n GOOGLE_OAUTH: 'google_oauth',\n ANTHROPIC_API_KEY: 'anthropic_api_key',\n} as const;\n\nexport type CredentialType = typeof CREDENTIAL_TYPES[keyof typeof CREDENTIAL_TYPES];\n\n// MCP Server names (for matching)\nexport const MCP_SERVER_NAMES = {\n GMAIL: 'gmail',\n GOOGLE_DOCS: 'google docs',\n GITHUB: 'github',\n} as const;\n\n// Account IDs (used in AccountMCPRegistry)\nexport const ACCOUNT_IDS = {\n GOOGLE: 'google',\n GITHUB: 'github',\n} as const;\n" }, { "path": "worker/db/index.ts", "content": "export { initSchema } from './schema';\n" }, { "path": "worker/db/schema.ts", "content": "/**\n * Database schema initialization and migrations for BoardDO\n */\n\nexport function initSchema(sql: SqlStorage): void {\n sql.exec(`\n CREATE TABLE IF NOT EXISTS boards (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n owner_id TEXT NOT NULL,\n tool_config TEXT,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL\n );\n\n CREATE TABLE IF NOT EXISTS columns (\n id TEXT PRIMARY KEY,\n board_id TEXT NOT NULL,\n name TEXT NOT NULL,\n position INTEGER NOT NULL,\n FOREIGN KEY (board_id) REFERENCES boards(id) ON DELETE CASCADE\n );\n\n CREATE TABLE IF NOT EXISTS tasks (\n id TEXT PRIMARY KEY,\n column_id TEXT NOT NULL,\n board_id TEXT NOT NULL,\n title TEXT NOT NULL,\n description TEXT,\n priority TEXT NOT NULL DEFAULT 'medium',\n position INTEGER NOT NULL,\n context TEXT,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n FOREIGN KEY (column_id) REFERENCES columns(id) ON DELETE CASCADE,\n FOREIGN KEY (board_id) REFERENCES boards(id) ON DELETE CASCADE\n );\n\n -- Board credentials (encrypted OAuth tokens, API keys)\n CREATE TABLE IF NOT EXISTS board_credentials (\n id TEXT PRIMARY KEY,\n board_id TEXT NOT NULL,\n type TEXT NOT NULL,\n name TEXT NOT NULL,\n encrypted_value TEXT NOT NULL,\n metadata TEXT,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n FOREIGN KEY (board_id) REFERENCES boards(id) ON DELETE CASCADE\n );\n\n CREATE INDEX IF NOT EXISTS idx_columns_board ON columns(board_id);\n CREATE INDEX IF NOT EXISTS idx_tasks_column ON tasks(column_id);\n CREATE INDEX IF NOT EXISTS idx_tasks_board ON tasks(board_id);\n CREATE INDEX IF NOT EXISTS idx_credentials_board ON board_credentials(board_id);\n\n -- MCP Server configurations\n CREATE TABLE IF NOT EXISTS mcp_servers (\n id TEXT PRIMARY KEY,\n board_id TEXT NOT NULL,\n name TEXT NOT NULL,\n type TEXT NOT NULL,\n endpoint TEXT,\n auth_type TEXT NOT NULL DEFAULT 'none',\n credential_id TEXT,\n enabled INTEGER NOT NULL DEFAULT 1,\n status TEXT NOT NULL DEFAULT 'disconnected',\n transport_type TEXT DEFAULT 'streamable-http',\n oauth_metadata TEXT,\n url_patterns TEXT,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n FOREIGN KEY (board_id) REFERENCES boards(id) ON DELETE CASCADE,\n FOREIGN KEY (credential_id) REFERENCES board_credentials(id)\n );\n\n -- Cached MCP tool schemas\n CREATE TABLE IF NOT EXISTS mcp_tool_schemas (\n id TEXT PRIMARY KEY,\n server_id TEXT NOT NULL,\n name TEXT NOT NULL,\n description TEXT,\n input_schema TEXT NOT NULL,\n output_schema TEXT,\n approval_required_fields TEXT,\n cached_at TEXT NOT NULL,\n FOREIGN KEY (server_id) REFERENCES mcp_servers(id) ON DELETE CASCADE,\n UNIQUE(server_id, name)\n );\n\n -- Workflow plans\n CREATE TABLE IF NOT EXISTS workflow_plans (\n id TEXT PRIMARY KEY,\n task_id TEXT NOT NULL,\n board_id TEXT NOT NULL,\n status TEXT NOT NULL DEFAULT 'planning',\n summary TEXT,\n generated_code TEXT,\n steps TEXT,\n current_step_index INTEGER,\n checkpoint_data TEXT,\n result TEXT,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE,\n FOREIGN KEY (board_id) REFERENCES boards(id) ON DELETE CASCADE\n );\n\n -- Workflow logs (real-time observability)\n CREATE TABLE IF NOT EXISTS workflow_logs (\n id TEXT PRIMARY KEY,\n plan_id TEXT NOT NULL,\n step_id TEXT,\n timestamp TEXT NOT NULL,\n level TEXT NOT NULL,\n message TEXT NOT NULL,\n metadata TEXT,\n FOREIGN KEY (plan_id) REFERENCES workflow_plans(id) ON DELETE CASCADE\n );\n\n CREATE INDEX IF NOT EXISTS idx_mcp_servers_board ON mcp_servers(board_id);\n CREATE INDEX IF NOT EXISTS idx_mcp_tools_server ON mcp_tool_schemas(server_id);\n CREATE INDEX IF NOT EXISTS idx_workflow_plans_task ON workflow_plans(task_id);\n CREATE INDEX IF NOT EXISTS idx_workflow_plans_board ON workflow_plans(board_id);\n CREATE INDEX IF NOT EXISTS idx_workflow_logs_plan ON workflow_logs(plan_id);\n CREATE INDEX IF NOT EXISTS idx_workflow_logs_step ON workflow_logs(step_id);\n\n -- Pending OAuth authorizations (stores PKCE code_verifier)\n CREATE TABLE IF NOT EXISTS mcp_oauth_pending (\n id TEXT PRIMARY KEY,\n board_id TEXT NOT NULL,\n server_id TEXT NOT NULL,\n code_verifier TEXT NOT NULL,\n state TEXT NOT NULL,\n resource TEXT NOT NULL,\n scopes TEXT,\n client_id TEXT,\n client_secret TEXT,\n created_at TEXT NOT NULL,\n expires_at TEXT NOT NULL,\n FOREIGN KEY (board_id) REFERENCES boards(id) ON DELETE CASCADE,\n FOREIGN KEY (server_id) REFERENCES mcp_servers(id) ON DELETE CASCADE\n );\n CREATE INDEX IF NOT EXISTS idx_mcp_oauth_pending_state ON mcp_oauth_pending(state);\n `);\n\n runMigrations(sql);\n}\n\nfunction runMigrations(sql: SqlStorage): void {\n // Add url_patterns column to mcp_servers if it doesn't exist\n try {\n sql.exec('ALTER TABLE mcp_servers ADD COLUMN url_patterns TEXT');\n } catch {\n // Column already exists\n }\n\n // Add owner_id column to boards if it doesn't exist\n try {\n sql.exec(\"ALTER TABLE boards ADD COLUMN owner_id TEXT NOT NULL DEFAULT ''\");\n } catch {\n // Column already exists\n }\n\n // Add schedule_config column to tasks for scheduled execution\n try {\n sql.exec('ALTER TABLE tasks ADD COLUMN schedule_config TEXT');\n } catch {\n // Column already exists\n }\n\n // Add parent_task_id column to tasks for parent-child relationships\n try {\n sql.exec('ALTER TABLE tasks ADD COLUMN parent_task_id TEXT REFERENCES tasks(id) ON DELETE SET NULL');\n } catch {\n // Column already exists\n }\n\n // Add run_id column to tasks to group tasks from same scheduled run\n try {\n sql.exec('ALTER TABLE tasks ADD COLUMN run_id TEXT');\n } catch {\n // Column already exists\n }\n\n // Create indexes for parent-child and run relationships\n try {\n sql.exec('CREATE INDEX idx_tasks_parent ON tasks(parent_task_id)');\n } catch {\n // Index already exists\n }\n try {\n sql.exec('CREATE INDEX idx_tasks_run ON tasks(run_id)');\n } catch {\n // Index already exists\n }\n\n // Create scheduled_runs table to track execution history\n try {\n sql.exec(`\n CREATE TABLE IF NOT EXISTS scheduled_runs (\n id TEXT PRIMARY KEY,\n task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n status TEXT NOT NULL DEFAULT 'pending',\n started_at TEXT,\n completed_at TEXT,\n tasks_created INTEGER DEFAULT 0,\n summary TEXT,\n error TEXT,\n created_at TEXT NOT NULL\n )\n `);\n sql.exec('CREATE INDEX IF NOT EXISTS idx_scheduled_runs_task ON scheduled_runs(task_id)');\n sql.exec('CREATE INDEX IF NOT EXISTS idx_scheduled_runs_status ON scheduled_runs(status)');\n } catch {\n // Table or indexes already exist\n }\n\n // Add child_tasks_info column to scheduled_runs to preserve task info even after deletion\n try {\n sql.exec('ALTER TABLE scheduled_runs ADD COLUMN child_tasks_info TEXT');\n } catch {\n // Column already exists\n }\n}\n" }, { "path": "worker/github/GitHubMCP.ts", "content": "/**\n * GitHubMCP - Hosted MCP wrapper for GitHub operations\n *\n * Enables workflows to interact with GitHub repositories, issues, and pull requests\n * as MCP tools, making them composable with other MCP servers like Gmail, GoogleDocs.\n */\n\nimport { HostedMCPServer, type MCPToolSchema, type MCPToolCallResult } from '../mcp/MCPClient';\nimport { toolsToMCPSchemas, parseToolArgs } from '../utils/zodTools';\nimport { githubTools } from './githubTools';\n\nconst GITHUB_API_BASE = 'https://api.github.com';\nconst DEFAULT_BRANCH = 'main';\n\n// Backwards compatibility: map old snake_case tool names to camelCase\nconst LEGACY_TOOL_NAMES: Record = {\n 'read_file': 'readFile',\n 'create_branch': 'createBranch',\n 'create_pr': 'createPullRequest',\n 'create_pull_request': 'createPullRequest',\n 'list_pull_request_files': 'listPullRequestFiles',\n 'submit_pr_review': 'submitPullRequestReview',\n 'submit_pull_request_review': 'submitPullRequestReview',\n 'list_issues': 'listIssues',\n 'list_pull_requests': 'listPullRequests',\n 'list_repos': 'listRepositories',\n 'get_issue': 'getIssue',\n 'get_pull_request': 'getPullRequest',\n 'get_repository': 'getRepository',\n 'list_repositories': 'listRepositories',\n};\n\n// Backwards compatibility: map old snake_case arg names to camelCase\nconst LEGACY_ARG_NAMES: Record = {\n 'pull_number': 'pullNumber',\n 'issue_number': 'issueNumber',\n 'per_page': 'perPage',\n 'commit_id': 'commitId',\n 'start_line': 'startLine',\n 'start_side': 'startSide',\n};\n\nexport class GitHubMCPServer extends HostedMCPServer {\n readonly name = 'GitHub';\n readonly description = 'Access repositories, issues, pull requests, and submit pull request reviews.';\n\n private accessToken: string;\n\n constructor(accessToken: string) {\n super();\n this.accessToken = accessToken;\n }\n\n getTools(): MCPToolSchema[] {\n return toolsToMCPSchemas(githubTools);\n }\n\n async callTool(name: string, args: Record): Promise {\n const normalizedName = LEGACY_TOOL_NAMES[name] || name;\n const normalizedArgs = { ...args };\n for (const [oldKey, newKey] of Object.entries(LEGACY_ARG_NAMES)) {\n if (oldKey in normalizedArgs) {\n normalizedArgs[newKey] = normalizedArgs[oldKey];\n delete normalizedArgs[oldKey];\n }\n }\n\n try {\n switch (normalizedName) {\n case 'readFile':\n return await this.readFile(normalizedArgs);\n case 'createBranch':\n return await this.createBranch(normalizedArgs);\n case 'createPullRequest':\n return await this.createPullRequest(normalizedArgs);\n case 'listIssues':\n return await this.listIssues(normalizedArgs);\n case 'listPullRequests':\n return await this.listPullRequests(normalizedArgs);\n case 'getIssue':\n return await this.getIssue(normalizedArgs);\n case 'getPullRequest':\n return await this.getPullRequest(normalizedArgs);\n case 'listPullRequestFiles':\n return await this.listPullRequestFiles(normalizedArgs);\n case 'submitPullRequestReview':\n return await this.submitPullRequestReview(normalizedArgs);\n case 'listIssueComments':\n return await this.listIssueComments(normalizedArgs);\n case 'listPullRequestComments':\n return await this.listPullRequestComments(normalizedArgs);\n case 'getRepository':\n return await this.getRepository(normalizedArgs);\n case 'listRepositories':\n return await this.listRepositories(normalizedArgs);\n default:\n return this.errorContent(`Unknown tool: ${name}`);\n }\n } catch (error) {\n return this.errorContent(error instanceof Error ? error.message : String(error));\n }\n }\n\n // ============================================================================\n // Tool Implementations\n // ============================================================================\n\n private async readFile(args: Record): Promise {\n const { owner, repo, path, ref = DEFAULT_BRANCH } = parseToolArgs(githubTools.readFile.input, args);\n\n const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/contents/${path}?ref=${ref}`;\n const response = await this.githubFetch(url);\n const data = await response.json() as {\n content: string;\n sha: string;\n size: number;\n path: string;\n encoding: string;\n };\n\n // GitHub returns base64-encoded content\n const content = this.decodeBase64(data.content);\n\n const result = {\n content,\n sha: data.sha,\n size: data.size,\n path: data.path,\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async createBranch(args: Record): Promise {\n const { owner, repo, branch, from = DEFAULT_BRANCH } = parseToolArgs(githubTools.createBranch.input, args);\n\n // First, get the SHA of the source branch\n const refUrl = `${GITHUB_API_BASE}/repos/${owner}/${repo}/git/ref/heads/${from}`;\n const refResponse = await this.githubFetch(refUrl);\n const refData = await refResponse.json() as {\n object: { sha: string };\n };\n\n // Create the new branch\n const createUrl = `${GITHUB_API_BASE}/repos/${owner}/${repo}/git/refs`;\n const response = await this.githubFetch(createUrl, {\n method: 'POST',\n body: JSON.stringify({\n ref: `refs/heads/${branch}`,\n sha: refData.object.sha,\n }),\n });\n\n const data = await response.json() as {\n ref: string;\n object: { sha: string };\n };\n\n const result = {\n ref: data.ref,\n sha: data.object.sha,\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async createPullRequest(args: Record): Promise {\n const { owner, repo, title, body = '', head, base = DEFAULT_BRANCH } = parseToolArgs(githubTools.createPullRequest.input, args);\n\n const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/pulls`;\n const response = await this.githubFetch(url, {\n method: 'POST',\n body: JSON.stringify({\n title,\n body,\n head,\n base,\n }),\n });\n\n const data = await response.json() as {\n number: number;\n html_url: string;\n state: string;\n title: string;\n };\n\n const result = {\n number: data.number,\n url: data.html_url,\n state: data.state,\n title: data.title,\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: { ...result, url: data.html_url, title: data.title },\n };\n }\n\n private async listIssues(args: Record): Promise {\n const { owner, repo, state = 'open', labels, since, perPage = 30 } = parseToolArgs(githubTools.listIssues.input, args);\n\n const queryParts = [`repo:${owner}/${repo}`, 'is:issue'];\n if (state !== 'all') {\n queryParts.push(`state:${state}`);\n }\n if (labels) {\n for (const label of labels.split(',')) {\n queryParts.push(`label:${label.trim()}`);\n }\n }\n if (since) {\n queryParts.push(`created:>=${since}`);\n }\n\n const params = new URLSearchParams({\n q: queryParts.join(' '),\n per_page: String(perPage),\n });\n\n const url = `${GITHUB_API_BASE}/search/issues?${params.toString()}`;\n const response = await this.githubFetch(url);\n const data = await response.json() as {\n items: Array<{\n number: number;\n title: string;\n state: string;\n html_url: string;\n labels: Array<{ name: string; color: string }>;\n }>;\n };\n\n const result = data.items.map((issue) => ({\n number: issue.number,\n title: issue.title,\n state: issue.state,\n url: issue.html_url,\n labels: issue.labels.map((l) => l.name),\n }));\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async listPullRequests(args: Record): Promise {\n const { owner, repo, state = 'open', since, perPage = 30 } = parseToolArgs(githubTools.listPullRequests.input, args);\n\n const queryParts = [`repo:${owner}/${repo}`, 'is:pr'];\n if (state !== 'all') {\n queryParts.push(`state:${state}`);\n }\n if (since) {\n queryParts.push(`created:>=${since}`);\n }\n\n const params = new URLSearchParams({\n q: queryParts.join(' '),\n per_page: String(perPage),\n });\n\n const url = `${GITHUB_API_BASE}/search/issues?${params.toString()}`;\n const response = await this.githubFetch(url);\n const data = await response.json() as {\n items: Array<{\n number: number;\n title: string;\n state: string;\n html_url: string;\n }>;\n };\n\n const result = data.items.map((pr) => ({\n number: pr.number,\n title: pr.title,\n state: pr.state,\n url: pr.html_url,\n }));\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async getIssue(args: Record): Promise {\n const { owner, repo, issueNumber } = parseToolArgs(githubTools.getIssue.input, args);\n\n const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/issues/${issueNumber}`;\n const response = await this.githubFetch(url);\n const data = await response.json() as {\n number: number;\n title: string;\n state: string;\n body: string | null;\n html_url: string;\n };\n\n const result = {\n number: data.number,\n title: data.title,\n state: data.state,\n body: data.body || '',\n url: data.html_url,\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async getPullRequest(args: Record): Promise {\n const { owner, repo, pullNumber } = parseToolArgs(githubTools.getPullRequest.input, args);\n\n const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/pulls/${pullNumber}`;\n const response = await this.githubFetch(url);\n const data = await response.json() as {\n number: number;\n title: string;\n state: string;\n body: string | null;\n html_url: string;\n additions?: number;\n deletions?: number;\n changed_files?: number;\n user?: { login?: string };\n head?: { ref?: string };\n base?: { ref?: string };\n };\n\n // Fetch full unified diff (file patches from /files can be truncated)\n const diffResponse = await this.githubFetch(url, {\n headers: { Accept: 'application/vnd.github.v3.diff' },\n });\n const diff = await diffResponse.text();\n\n const result = {\n number: data.number,\n title: data.title,\n state: data.state,\n body: data.body || '',\n url: data.html_url,\n author: data.user?.login || '',\n head: data.head?.ref || '',\n base: data.base?.ref || '',\n diff,\n stats: {\n files: data.changed_files ?? 0,\n additions: data.additions ?? 0,\n deletions: data.deletions ?? 0,\n },\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async listPullRequestFiles(args: Record): Promise {\n const { owner, repo, pullNumber, perPage = 100, page = 1 } = parseToolArgs(githubTools.listPullRequestFiles.input, args);\n\n const params = new URLSearchParams({\n per_page: String(perPage),\n page: String(page),\n });\n\n const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/pulls/${pullNumber}/files?${params.toString()}`;\n const response = await this.githubFetch(url);\n const data = await response.json() as Array<{\n filename: string;\n status: string;\n additions: number;\n deletions: number;\n changes: number;\n patch?: string;\n previous_filename?: string;\n }>;\n\n const result = data.map((file) => ({\n filename: file.filename,\n status: file.status,\n additions: file.additions,\n deletions: file.deletions,\n changes: file.changes,\n patch: file.patch,\n previous_filename: file.previous_filename,\n }));\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async submitPullRequestReview(args: Record): Promise {\n const {\n owner,\n repo,\n pullNumber,\n event = 'COMMENT',\n body = '',\n commitId,\n comments = [],\n } = parseToolArgs(githubTools.submitPullRequestReview.input, args);\n\n const normalizedComments = comments.map((comment) => {\n const commentBody = (comment.body || '').trim();\n const suggestionBody = (comment.suggestion || '').trimEnd();\n\n if (!commentBody && !suggestionBody) {\n throw new Error(`Review comment on ${comment.path}:${comment.line} is missing both body and suggestion`);\n }\n\n const fence = suggestionBody.includes('```') ? '````' : '```';\n const suggestionText = suggestionBody\n ? comment.side === 'RIGHT'\n ? `${fence}suggestion\\n${suggestionBody}\\n${fence}`\n : suggestionBody\n : '';\n\n const composedBody = [commentBody, suggestionText].filter(Boolean).join('\\n\\n');\n\n return {\n path: comment.path,\n line: comment.line,\n side: comment.side,\n ...(comment.startLine ? { start_line: comment.startLine } : {}),\n ...(comment.startSide ? { start_side: comment.startSide } : {}),\n body: composedBody,\n };\n });\n\n const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/pulls/${pullNumber}/reviews`;\n const response = await this.githubFetch(url, {\n method: 'POST',\n body: JSON.stringify({\n event,\n body,\n ...(commitId ? { commit_id: commitId } : {}),\n ...(normalizedComments.length > 0 ? { comments: normalizedComments } : {}),\n }),\n });\n\n const data = await response.json() as {\n id: number;\n state: string;\n body: string | null;\n html_url: string;\n commit_id?: string;\n };\n\n const result = {\n id: data.id,\n state: data.state,\n body: data.body || '',\n url: data.html_url,\n commit_id: data.commit_id,\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async listIssueComments(args: Record): Promise {\n const { owner, repo, issueNumber, perPage } = parseToolArgs(githubTools.listIssueComments.input, args);\n const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/issues/${issueNumber}/comments?per_page=${perPage}`;\n const data = await this.githubFetch(url).then(r => r.json()) as Array<{\n id: number;\n body: string;\n html_url: string;\n created_at: string;\n user?: { login?: string };\n }>;\n\n const result = data.map((c) => ({\n id: c.id,\n body: c.body || '',\n author: c.user?.login || '',\n created_at: c.created_at,\n url: c.html_url,\n }));\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async listPullRequestComments(args: Record): Promise {\n const { owner, repo, pullNumber, perPage } = parseToolArgs(githubTools.listPullRequestComments.input, args);\n\n // Fetch reviews and issue-level comments in parallel\n const [reviewsData, commentsData] = await Promise.all([\n this.githubFetch(`${GITHUB_API_BASE}/repos/${owner}/${repo}/pulls/${pullNumber}/reviews?per_page=${perPage}`)\n .then(r => r.json()) as Promise>,\n this.githubFetch(`${GITHUB_API_BASE}/repos/${owner}/${repo}/issues/${pullNumber}/comments?per_page=${perPage}`)\n .then(r => r.json()) as Promise>,\n ]);\n\n const reviews = reviewsData.map((r) => ({\n id: r.id,\n state: r.state,\n body: r.body || '',\n author: r.user?.login || '',\n url: r.html_url,\n submitted_at: r.submitted_at,\n commit_id: r.commit_id,\n }));\n\n const comments = commentsData.map((c) => ({\n id: c.id,\n body: c.body || '',\n author: c.user?.login || '',\n created_at: c.created_at,\n url: c.html_url,\n }));\n\n const result = { reviews, comments };\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async getRepository(args: Record): Promise {\n const { owner, repo } = parseToolArgs(githubTools.getRepository.input, args);\n\n const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}`;\n const response = await this.githubFetch(url);\n const data = await response.json() as {\n full_name: string;\n name: string;\n owner: { login: string };\n description: string | null;\n private: boolean;\n html_url: string;\n default_branch: string;\n stargazers_count: number;\n forks_count: number;\n };\n\n const result = {\n full_name: data.full_name,\n name: data.name,\n owner: data.owner.login,\n description: data.description || '',\n private: data.private,\n url: data.html_url,\n default_branch: data.default_branch,\n stars: data.stargazers_count,\n forks: data.forks_count,\n // Use full_name as title for link pills\n title: data.full_name,\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async listRepositories(args: Record): Promise {\n const { type = 'all', sort = 'full_name', perPage = 30 } = parseToolArgs(githubTools.listRepositories.input, args);\n\n const params = new URLSearchParams({\n type,\n sort,\n per_page: String(perPage),\n });\n\n const url = `${GITHUB_API_BASE}/user/repos?${params.toString()}`;\n const response = await this.githubFetch(url);\n const data = await response.json() as Array<{\n full_name: string;\n name: string;\n owner: { login: string };\n description: string | null;\n private: boolean;\n html_url: string;\n }>;\n\n const result = data.map((repo) => ({\n full_name: repo.full_name,\n name: repo.name,\n owner: repo.owner.login,\n description: repo.description || '',\n private: repo.private,\n url: repo.html_url,\n }));\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async githubFetch(url: string, options: RequestInit = {}): Promise {\n const response = await fetch(url, {\n ...options,\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n 'Accept': 'application/vnd.github+json',\n 'X-GitHub-Api-Version': '2022-11-28',\n 'Content-Type': 'application/json',\n 'User-Agent': 'Weft-App',\n ...options.headers,\n },\n });\n\n if (!response.ok) {\n let errorMessage = `GitHub API error: ${response.status}`;\n try {\n const errorData = await response.json();\n const msg = (errorData as { message?: string }).message;\n if (msg) {\n errorMessage = msg;\n }\n const errors = (errorData as { errors?: unknown[] }).errors;\n if (errors?.length) {\n errorMessage += ' — ' + JSON.stringify(errors);\n }\n } catch {\n // Ignore JSON parse errors\n }\n throw new Error(errorMessage);\n }\n\n return response;\n }\n\n private decodeBase64(data: string): string {\n // GitHub returns base64 with newlines, need to strip them\n const cleaned = data.replace(/\\n/g, '');\n const binary = atob(cleaned);\n const bytes = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n bytes[i] = binary.charCodeAt(i);\n }\n return new TextDecoder().decode(bytes);\n }\n}\n" }, { "path": "worker/github/githubTools.ts", "content": "/**\n * GitHub MCP Tool Definitions\n *\n * Single source of truth for GitHub tool schemas using Zod.\n * Used for both JSON Schema generation (getTools) and runtime validation (callTool).\n */\n\nimport { z } from 'zod';\nimport { defineTools, commonSchemas } from '../utils/zodTools';\n\n// ============================================================================\n// Output Schemas\n// ============================================================================\n\nconst fileContentOutput = z.object({\n content: z.string().describe('File contents (decoded)'),\n sha: z.string().describe('File SHA (needed for updates)'),\n size: z.number().describe('File size in bytes'),\n path: z.string().describe('File path'),\n});\n\nconst branchOutput = z.object({\n ref: z.string().describe('Full ref path (refs/heads/branch-name)'),\n sha: z.string().describe('Commit SHA the branch points to'),\n});\n\nconst pullRequestOutput = z.object({\n number: z.number().describe('Pull request number'),\n url: z.string().describe('URL to the pull request'),\n state: z.string().describe('Pull request state'),\n title: z.string().describe('Pull request title'),\n});\n\nconst issueOutput = z.object({\n number: z.number().describe('Issue number'),\n title: z.string().describe('Issue title'),\n state: z.string().describe('Issue state'),\n url: z.string().describe('URL to the issue'),\n labels: z.array(z.string()).optional().describe('Issue labels'),\n});\n\nconst issueDetailOutput = z.object({\n number: z.number().describe('Issue number'),\n title: z.string().describe('Issue title'),\n state: z.string().describe('Issue state'),\n body: z.string().describe('Issue body'),\n url: z.string().describe('URL to the issue'),\n});\n\nconst prDetailOutput = z.object({\n number: z.number().describe('PR number'),\n title: z.string().describe('PR title'),\n state: z.string().describe('PR state'),\n body: z.string().describe('PR body'),\n url: z.string().describe('URL to the PR'),\n author: z.string().optional().describe('PR author login'),\n head: z.string().optional().describe('Head branch name'),\n base: z.string().optional().describe('Base branch name'),\n});\n\nconst pullRequestFileOutput = z.object({\n filename: z.string().describe('Path of the changed file'),\n status: z.string().describe('File status (added, modified, removed, renamed)'),\n additions: z.number().describe('Number of added lines'),\n deletions: z.number().describe('Number of deleted lines'),\n changes: z.number().describe('Total number of changed lines'),\n patch: z.string().optional().describe('Unified diff patch for this file'),\n previous_filename: z.string().optional().describe('Previous path for renamed files'),\n});\n\nconst pullRequestReviewOutput = z.object({\n id: z.number().describe('Review ID'),\n state: z.string().describe('Review state'),\n body: z.string().describe('Review body'),\n author: z.string().describe('Review author login'),\n url: z.string().describe('URL to the review'),\n submitted_at: z.string().optional().describe('When the review was submitted'),\n commit_id: z.string().optional().describe('Commit SHA the review is attached to'),\n});\n\nconst commentOutput = z.object({\n id: z.number().describe('Comment ID'),\n body: z.string().describe('Comment body'),\n author: z.string().describe('Comment author login'),\n created_at: z.string().describe('When the comment was created'),\n url: z.string().describe('URL to the comment'),\n});\n\nconst repoOutput = z.object({\n full_name: z.string().describe('Full repo name (owner/repo)'),\n name: z.string().describe('Repository name'),\n owner: z.string().describe('Repository owner'),\n description: z.string().describe('Repository description'),\n private: z.boolean().describe('Whether repo is private'),\n url: z.string().describe('URL to the repository'),\n default_branch: z.string().optional().describe('Default branch name'),\n stars: z.number().optional().describe('Number of stars'),\n forks: z.number().optional().describe('Number of forks'),\n});\n\nconst repoListItemOutput = z.object({\n full_name: z.string().describe('Full repo name (owner/repo)'),\n name: z.string().describe('Repository name'),\n owner: z.string().describe('Repository owner'),\n description: z.string().describe('Repository description'),\n private: z.boolean().describe('Whether repo is private'),\n url: z.string().describe('URL to the repository'),\n});\n\n// ============================================================================\n// Tool Definitions\n// ============================================================================\n\nexport const githubTools = defineTools({\n readFile: {\n description: 'Read the contents of a file from a GitHub repository',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n path: commonSchemas.filePath.describe('Path to the file in the repository'),\n ref: commonSchemas.gitRef.default('main')\n .describe('Branch, tag, or commit SHA (default: main)'),\n }),\n output: fileContentOutput,\n },\n\n createBranch: {\n description: 'Create a new branch in a GitHub repository',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n branch: commonSchemas.branch.describe('Name of the new branch'),\n from: commonSchemas.gitRef.default('main')\n .describe('Source branch to create from (default: main)'),\n }),\n output: branchOutput,\n },\n\n createPullRequest: {\n description: 'Create a pull request in a GitHub repository',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n title: z.string().max(500).describe('Pull request title'),\n body: z.string().max(65000).default('')\n .describe('Pull request description'),\n head: commonSchemas.branch.describe('Source branch containing the changes'),\n base: commonSchemas.gitRef.default('main')\n .describe('Target branch to merge into (default: main)'),\n }),\n output: pullRequestOutput,\n approvalRequiredFields: ['owner', 'repo', 'title', 'body', 'diff'],\n },\n\n listIssues: {\n description: 'List issues (not pull requests) in a GitHub repository',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n state: z.enum(['open', 'closed', 'all']).default('open')\n .describe('Filter by issue state (default: open)'),\n labels: z.string().max(500).optional()\n .describe('Comma-separated list of label names'),\n since: z.string().optional()\n .describe('Only issues created after this date (ISO 8601 format, e.g., 2025-01-16)'),\n perPage: z.coerce.number().int().min(1).max(100).default(30)\n .describe('Number of results per page (default: 30, max: 100)'),\n }),\n output: z.array(issueOutput),\n },\n\n listPullRequests: {\n description: 'List pull requests in a GitHub repository',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n state: z.enum(['open', 'closed', 'all']).default('open')\n .describe('Filter by PR state (default: open)'),\n since: z.string().optional()\n .describe('Only PRs created after this date (ISO 8601 format, e.g., 2025-01-16)'),\n perPage: z.coerce.number().int().min(1).max(100).default(30)\n .describe('Number of results per page (default: 30, max: 100)'),\n }),\n output: z.array(pullRequestOutput),\n },\n\n getIssue: {\n description: 'Get details of a specific issue by number',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n issueNumber: z.coerce.number().int().positive()\n .describe('Issue number'),\n }),\n output: issueDetailOutput,\n },\n\n getPullRequest: {\n description: 'Get details of a specific pull request by number',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n pullNumber: z.coerce.number().int().positive()\n .describe('Pull request number'),\n }),\n output: prDetailOutput,\n },\n\n listPullRequestFiles: {\n description: 'List changed files in a pull request with patch snippets',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n pullNumber: z.coerce.number().int().positive()\n .describe('Pull request number'),\n perPage: z.coerce.number().int().min(1).max(100).default(100)\n .describe('Number of files to return per page (default: 100, max: 100)'),\n page: z.coerce.number().int().min(1).default(1)\n .describe('Page number (default: 1)'),\n }),\n output: z.array(pullRequestFileOutput),\n },\n\n submitPullRequestReview: {\n description: 'Submit a pull request review with a decision, summary, and optional inline comments/suggestions',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n pullNumber: z.coerce.number().int().positive()\n .describe('Pull request number'),\n event: z.enum(['APPROVE', 'REQUEST_CHANGES', 'COMMENT']).default('COMMENT')\n .describe('Final review decision'),\n body: z.string().max(65000).default('')\n .describe('Review summary/body'),\n commitId: z.string().max(100).optional()\n .describe('Optional commit SHA to anchor inline comments'),\n comments: z.array(\n z.object({\n path: z.string().max(500).describe('File path relative to repository root'),\n line: z.coerce.number().int().positive()\n .describe('Line number in the pull request diff'),\n side: z.enum(['LEFT', 'RIGHT']).default('RIGHT')\n .describe('Diff side: RIGHT for additions/current, LEFT for removals'),\n startLine: z.coerce.number().int().positive().optional()\n .describe('Optional start line for multi-line comments'),\n startSide: z.enum(['LEFT', 'RIGHT']).optional()\n .describe('Optional side for startLine'),\n body: z.string().max(65000).optional()\n .describe('Comment body'),\n suggestion: z.string().max(65000).optional()\n .describe('Optional suggested replacement text (RIGHT-side comments only)'),\n })\n ).default([])\n .describe('Inline review comments to post'),\n }),\n output: pullRequestReviewOutput,\n approvalRequiredFields: ['owner', 'repo', 'pullNumber', 'event', 'diff'],\n requiresApproval: true,\n disabledInScheduledRuns: true,\n },\n\n listIssueComments: {\n description: 'List comments on an issue',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n issueNumber: z.coerce.number().int().positive()\n .describe('Issue number'),\n perPage: z.coerce.number().int().min(1).max(100).default(30)\n .describe('Number of results per page (default: 30, max: 100)'),\n }),\n output: z.array(commentOutput),\n },\n\n listPullRequestComments: {\n description: 'List review summaries and discussion comments on a pull request',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n pullNumber: z.coerce.number().int().positive()\n .describe('Pull request number'),\n perPage: z.coerce.number().int().min(1).max(100).default(30)\n .describe('Number of results per page (default: 30, max: 100)'),\n }),\n output: z.object({\n reviews: z.array(pullRequestReviewOutput),\n comments: z.array(commentOutput),\n }),\n },\n\n getRepository: {\n description: 'Get details of a specific repository',\n input: z.object({\n owner: commonSchemas.owner,\n repo: commonSchemas.repo,\n }),\n output: repoOutput,\n },\n\n listRepositories: {\n description: 'List repositories accessible to the authenticated user. Call this first to discover available repositories before using other tools.',\n input: z.object({\n type: z.enum(['all', 'owner', 'public', 'private', 'member']).default('all')\n .describe('Filter by repo type (default: all)'),\n sort: z.enum(['created', 'updated', 'pushed', 'full_name']).default('full_name')\n .describe('Sort field (default: full_name)'),\n perPage: z.coerce.number().int().min(1).max(100).default(30)\n .describe('Number of results per page (default: 30, max: 100)'),\n }),\n output: z.array(repoListItemOutput),\n },\n});\n\n// Export type for tool names\nexport type GitHubToolName = keyof typeof githubTools;\n" }, { "path": "worker/github/index.ts", "content": "/**\n * GitHub services module\n *\n * Provides OAuth and MCP wrapper for GitHub:\n * - Repository operations\n * - Issues and pull requests\n */\n\nexport * from './oauth';\nexport { GitHubMCPServer } from './GitHubMCP';\n" }, { "path": "worker/github/oauth.ts", "content": "// GitHub OAuth Configuration\n// Requires secrets: GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET\n\nexport interface GitHubEnv {\n GITHUB_CLIENT_ID: string;\n GITHUB_CLIENT_SECRET: string;\n}\n\nexport interface GitHubTokenResponse {\n access_token: string;\n token_type: string;\n scope: string;\n}\n\nexport interface GitHubUser {\n id: number;\n login: string;\n name: string | null;\n avatar_url: string;\n}\n\nexport interface GitHubRepo {\n id: number;\n name: string;\n full_name: string;\n owner: {\n login: string;\n };\n private: boolean;\n default_branch: string;\n description: string | null;\n}\n\n// Scopes needed for repo access\nconst GITHUB_SCOPES = ['repo', 'read:user'];\n\n/**\n * Generate the GitHub OAuth authorization URL\n */\nexport function getOAuthUrl(\n clientId: string,\n redirectUri: string,\n state: string\n): string {\n const params = new URLSearchParams({\n client_id: clientId,\n redirect_uri: redirectUri,\n scope: GITHUB_SCOPES.join(' '),\n state,\n });\n\n return `https://github.com/login/oauth/authorize?${params.toString()}`;\n}\n\n/**\n * Exchange authorization code for access token\n */\nexport async function exchangeCodeForToken(\n code: string,\n clientId: string,\n clientSecret: string,\n redirectUri: string\n): Promise {\n const response = await fetch('https://github.com/login/oauth/access_token', {\n method: 'POST',\n headers: {\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n client_id: clientId,\n client_secret: clientSecret,\n code,\n redirect_uri: redirectUri,\n }),\n });\n\n if (!response.ok) {\n throw new Error(`GitHub token exchange failed: ${response.status}`);\n }\n\n const data = await response.json() as GitHubTokenResponse & { error?: string };\n\n if (data.error) {\n throw new Error(`GitHub OAuth error: ${data.error}`);\n }\n\n return data;\n}\n\n/**\n * Get the authenticated user's profile\n */\nexport async function getUser(accessToken: string): Promise {\n const response = await fetch('https://api.github.com/user', {\n headers: {\n 'Authorization': `Bearer ${accessToken}`,\n 'Accept': 'application/vnd.github.v3+json',\n 'User-Agent': 'Weft-App',\n },\n });\n\n if (!response.ok) {\n throw new Error(`Failed to get GitHub user: ${response.status}`);\n }\n\n return response.json() as Promise;\n}\n\n/**\n * List repositories accessible to the user\n */\nexport async function listRepos(\n accessToken: string,\n page = 1,\n perPage = 30\n): Promise {\n const params = new URLSearchParams({\n sort: 'updated',\n direction: 'desc',\n per_page: String(perPage),\n page: String(page),\n });\n\n const response = await fetch(\n `https://api.github.com/user/repos?${params.toString()}`,\n {\n headers: {\n 'Authorization': `Bearer ${accessToken}`,\n 'Accept': 'application/vnd.github.v3+json',\n 'User-Agent': 'Weft-App',\n },\n }\n );\n\n if (!response.ok) {\n throw new Error(`Failed to list GitHub repos: ${response.status}`);\n }\n\n return response.json() as Promise;\n}\n\n/**\n * Generate a random state string for OAuth\n */\nexport function generateState(): string {\n const array = new Uint8Array(16);\n crypto.getRandomValues(array);\n return Array.from(array, (b) => b.toString(16).padStart(2, '0')).join('');\n}\n" }, { "path": "worker/google/DocsMCP.ts", "content": "/**\n * DocsMCP - Hosted MCP wrapper for Google Docs API\n *\n * Provides MCP-compatible tools for Google Docs operations:\n * - getDocument: Read a document's content\n * - listDocuments: List recent documents from Drive\n * - createDocument: Create a new document\n * - appendToDocument: Append content to a document\n * - searchDocuments: Search for documents\n * - replaceDocumentContent: Replace document content\n */\n\nimport { HostedMCPServer, type MCPToolSchema, type MCPToolCallResult } from '../mcp/MCPClient';\nimport { toolsToMCPSchemas, parseToolArgs } from '../utils/zodTools';\nimport { docsTools } from './docsTools';\nimport { markdownToDocsRequests } from './markdownToDocs';\n\nconst DOCS_API_BASE = 'https://docs.googleapis.com/v1';\nconst DRIVE_API_BASE = 'https://www.googleapis.com/drive/v3';\nconst DEFAULT_MAX_RESULTS = 10;\n\nexport interface GoogleDoc {\n documentId: string;\n title: string;\n body?: {\n content: Array<{\n paragraph?: {\n elements: Array<{\n textRun?: {\n content: string;\n };\n }>;\n };\n }>;\n };\n}\n\nexport interface DriveFile {\n id: string;\n name: string;\n mimeType: string;\n modifiedTime: string;\n webViewLink?: string;\n}\n\nexport class DocsMCPServer extends HostedMCPServer {\n readonly name = 'Google Docs';\n readonly description = 'Google Docs API for reading, creating, and editing documents';\n\n private accessToken: string;\n\n constructor(accessToken: string) {\n super();\n this.accessToken = accessToken;\n }\n\n getTools(): MCPToolSchema[] {\n return toolsToMCPSchemas(docsTools);\n }\n\n async callTool(name: string, args: Record): Promise {\n try {\n switch (name) {\n case 'getDocument':\n return await this.getDocument(args);\n case 'listDocuments':\n return await this.listDocuments(args);\n case 'createDocument':\n return await this.createDocument(args);\n case 'appendToDocument':\n return await this.appendToDocument(args);\n case 'searchDocuments':\n return await this.searchDocuments(args);\n case 'replaceDocumentContent':\n return await this.replaceDocumentContent(args);\n default:\n return this.errorContent(`Unknown tool: ${name}`);\n }\n } catch (error) {\n return this.errorContent(error instanceof Error ? error.message : String(error));\n }\n }\n\n private async getDocument(args: Record): Promise {\n const { documentId } = parseToolArgs(docsTools.getDocument.input, args);\n\n const response = await fetch(\n `${DOCS_API_BASE}/documents/${documentId}`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!response.ok) {\n throw new Error(`Google Docs API error: ${response.status}`);\n }\n\n const doc = await response.json() as GoogleDoc;\n\n // Extract plain text from document structure\n const textContent = this.extractTextFromDoc(doc);\n\n const result = {\n documentId: doc.documentId,\n title: doc.title,\n content: textContent,\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async listDocuments(args: Record): Promise {\n const { maxResults = DEFAULT_MAX_RESULTS, query } = parseToolArgs(docsTools.listDocuments.input, args);\n\n // Build Drive API query for Google Docs\n // Escape special characters for Google Drive query syntax\n let driveQuery = \"mimeType='application/vnd.google-apps.document'\";\n if (query) {\n // Escape backslashes first, then single quotes\n const escapedQuery = query.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n driveQuery += ` and name contains '${escapedQuery}'`;\n }\n\n const params = new URLSearchParams({\n q: driveQuery,\n pageSize: String(Math.min(maxResults, 100)),\n fields: 'files(id,name,mimeType,modifiedTime,webViewLink)',\n orderBy: 'modifiedTime desc',\n });\n\n const response = await fetch(\n `${DRIVE_API_BASE}/files?${params.toString()}`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!response.ok) {\n throw new Error(`Google Drive API error: ${response.status}`);\n }\n\n const data = await response.json() as { files: DriveFile[] };\n\n const results = data.files.map((file) => ({\n documentId: file.id,\n title: file.name,\n modifiedTime: file.modifiedTime,\n url: file.webViewLink,\n }));\n\n return {\n content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],\n structuredContent: results,\n };\n }\n\n private async createDocument(args: Record): Promise {\n const { title, content } = parseToolArgs(docsTools.createDocument.input, args);\n\n // Create the document\n const createResponse = await fetch(\n `${DOCS_API_BASE}/documents`,\n {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({ title }),\n }\n );\n\n if (!createResponse.ok) {\n const error = await createResponse.text();\n throw new Error(`Google Docs API error: ${createResponse.status} - ${error}`);\n }\n\n const doc = await createResponse.json() as GoogleDoc;\n\n // If content provided, insert it with formatting\n if (content) {\n await this.insertFormattedText(doc.documentId, content, 1);\n }\n\n const result = {\n documentId: doc.documentId,\n title: doc.title,\n url: `https://docs.google.com/document/d/${doc.documentId}/edit`,\n };\n\n return {\n content: [{ type: 'text', text: `Document created successfully: ${result.url}` }],\n structuredContent: result,\n };\n }\n\n private async appendToDocument(args: Record): Promise {\n const { documentId, content } = parseToolArgs(docsTools.appendToDocument.input, args);\n\n // Get document to find end index\n const docResponse = await fetch(\n `${DOCS_API_BASE}/documents/${documentId}`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!docResponse.ok) {\n throw new Error(`Google Docs API error: ${docResponse.status}`);\n }\n\n const doc = await docResponse.json() as GoogleDoc & { body: { content: Array<{ endIndex: number }> } };\n const endIndex = doc.body.content[doc.body.content.length - 1]?.endIndex || 1;\n\n // Insert formatted text at end (with leading newline)\n await this.insertFormattedText(documentId, '\\n' + content, endIndex - 1);\n\n const result = {\n success: true,\n documentId,\n title: doc.title,\n url: `https://docs.google.com/document/d/${documentId}/edit`,\n };\n\n return {\n content: [{ type: 'text', text: `Content appended to \"${doc.title}\" successfully: ${result.url}` }],\n structuredContent: result,\n };\n }\n\n private async searchDocuments(args: Record): Promise {\n const { query, maxResults = DEFAULT_MAX_RESULTS } = parseToolArgs(docsTools.searchDocuments.input, args);\n return this.listDocuments({ query, maxResults });\n }\n\n private async replaceDocumentContent(args: Record): Promise {\n const { documentId, content } = parseToolArgs(docsTools.replaceDocumentContent.input, args);\n\n // Get document to find content range\n const docResponse = await fetch(\n `${DOCS_API_BASE}/documents/${documentId}`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!docResponse.ok) {\n throw new Error(`Google Docs API error: ${docResponse.status}`);\n }\n\n const doc = await docResponse.json() as GoogleDoc & { body: { content: Array<{ endIndex: number }> } };\n const endIndex = doc.body.content[doc.body.content.length - 1]?.endIndex || 1;\n\n // Delete existing content (index 1 to endIndex-1, preserving the trailing newline structure)\n if (endIndex > 2) {\n const deleteResponse = await fetch(\n `${DOCS_API_BASE}/documents/${documentId}:batchUpdate`,\n {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n requests: [{\n deleteContentRange: {\n range: {\n startIndex: 1,\n endIndex: endIndex - 1,\n },\n },\n }],\n }),\n }\n );\n\n if (!deleteResponse.ok) {\n const error = await deleteResponse.text();\n throw new Error(`Google Docs API error: ${deleteResponse.status} - ${error}`);\n }\n }\n\n // Insert new formatted content at the beginning\n if (content) {\n await this.insertFormattedText(documentId, content, 1);\n }\n\n const result = {\n success: true,\n documentId,\n title: doc.title,\n url: `https://docs.google.com/document/d/${documentId}/edit`,\n };\n\n return {\n content: [{ type: 'text', text: `Document \"${doc.title}\" updated successfully: ${result.url}` }],\n structuredContent: result,\n };\n }\n\n /**\n * Insert text with markdown formatting converted to Google Docs styles\n */\n private async insertFormattedText(documentId: string, markdown: string, startIndex: number): Promise {\n const requests = markdownToDocsRequests(markdown, startIndex);\n\n if (requests.length === 0) {\n return;\n }\n\n const response = await fetch(\n `${DOCS_API_BASE}/documents/${documentId}:batchUpdate`,\n {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({ requests }),\n }\n );\n\n if (!response.ok) {\n const error = await response.text();\n throw new Error(`Failed to insert formatted text: ${response.status} - ${error}`);\n }\n }\n\n private extractTextFromDoc(doc: GoogleDoc): string {\n if (!doc.body?.content) return '';\n\n const textParts: string[] = [];\n\n for (const element of doc.body.content) {\n if (element.paragraph?.elements) {\n for (const elem of element.paragraph.elements) {\n if (elem.textRun?.content) {\n textParts.push(elem.textRun.content);\n }\n }\n }\n }\n\n return textParts.join('');\n }\n}\n" }, { "path": "worker/google/GmailMCP.ts", "content": "/**\n * GmailMCP - Hosted MCP wrapper for Gmail API\n *\n * Provides MCP-compatible tools for Gmail operations:\n * - listMessages: List recent emails\n * - getMessage: Get full email content\n * - sendEmail: Send an email\n * - searchMessages: Search emails with query\n * - getThread: Get full email thread\n * - getAuthenticatedUser: Get authenticated user info\n */\n\nimport { HostedMCPServer, type MCPToolSchema, type MCPToolCallResult } from '../mcp/MCPClient';\nimport { toolsToMCPSchemas, parseToolArgs } from '../utils/zodTools';\nimport { gmailTools } from './gmailTools';\n\nconst GMAIL_API_BASE = 'https://gmail.googleapis.com/gmail/v1';\nconst DEFAULT_MAX_RESULTS = 10;\n\nexport interface GmailMessage {\n id: string;\n threadId: string;\n snippet: string;\n payload?: {\n headers: Array<{ name: string; value: string }>;\n body?: { data?: string };\n parts?: Array<{\n mimeType: string;\n body?: { data?: string };\n }>;\n };\n labelIds?: string[];\n internalDate?: string;\n}\n\nexport interface GmailThread {\n id: string;\n snippet: string;\n messages: GmailMessage[];\n}\n\nexport class GmailMCPServer extends HostedMCPServer {\n readonly name = 'Gmail';\n readonly description = 'Gmail API for reading, sending, and searching emails';\n\n private accessToken: string;\n\n constructor(accessToken: string) {\n super();\n this.accessToken = accessToken;\n }\n\n getTools(): MCPToolSchema[] {\n return toolsToMCPSchemas(gmailTools);\n }\n\n async callTool(name: string, args: Record): Promise {\n try {\n switch (name) {\n case 'listMessages':\n return await this.listMessages(args);\n case 'getMessage':\n return await this.getMessage(args);\n case 'sendEmail':\n return await this.sendEmail(args);\n case 'searchMessages':\n return await this.searchMessages(args);\n case 'getThread':\n return await this.getThread(args);\n case 'getAuthenticatedUser':\n return await this.getAuthenticatedUser();\n default:\n return this.errorContent(`Unknown tool: ${name}`);\n }\n } catch (error) {\n return this.errorContent(error instanceof Error ? error.message : String(error));\n }\n }\n\n private async listMessages(args: Record): Promise {\n const { maxResults = DEFAULT_MAX_RESULTS, query, labelIds } = parseToolArgs(\n gmailTools.listMessages.input,\n args\n );\n\n const params = new URLSearchParams({\n maxResults: String(Math.min(maxResults, 100)),\n });\n if (query) params.set('q', query);\n if (labelIds) params.set('labelIds', labelIds.join(','));\n\n const response = await fetch(\n `${GMAIL_API_BASE}/users/me/messages?${params.toString()}`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!response.ok) {\n throw new Error(`Gmail API error: ${response.status}`);\n }\n\n const data = await response.json() as { messages?: Array<{ id: string; threadId: string }> };\n const messages = data.messages || [];\n\n // Fetch snippets for each message\n const messageDetails = await Promise.all(\n messages.slice(0, 20).map(async (msg) => {\n const detailResponse = await fetch(\n `${GMAIL_API_BASE}/users/me/messages/${msg.id}?format=metadata&metadataHeaders=From&metadataHeaders=Subject&metadataHeaders=Date`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n if (!detailResponse.ok) return null;\n return detailResponse.json() as Promise;\n })\n );\n\n const results = messageDetails\n .filter((m): m is GmailMessage => m !== null)\n .map((msg) => {\n const headers = msg.payload?.headers || [];\n return {\n id: msg.id,\n threadId: msg.threadId,\n from: headers.find((h) => h.name === 'From')?.value || 'Unknown',\n subject: headers.find((h) => h.name === 'Subject')?.value || '(no subject)',\n date: headers.find((h) => h.name === 'Date')?.value || '',\n snippet: msg.snippet,\n };\n });\n\n return {\n content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],\n structuredContent: results,\n };\n }\n\n private async getMessage(args: Record): Promise {\n const { messageId } = parseToolArgs(gmailTools.getMessage.input, args);\n\n const response = await fetch(\n `${GMAIL_API_BASE}/users/me/messages/${messageId}?format=full`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!response.ok) {\n throw new Error(`Gmail API error: ${response.status}`);\n }\n\n const message = await response.json() as GmailMessage;\n const headers = message.payload?.headers || [];\n\n // Extract body content\n let body = '';\n if (message.payload?.body?.data) {\n body = this.decodeBase64Url(message.payload.body.data);\n } else if (message.payload?.parts) {\n const textPart = message.payload.parts.find(\n (p) => p.mimeType === 'text/plain'\n );\n if (textPart?.body?.data) {\n body = this.decodeBase64Url(textPart.body.data);\n }\n }\n\n const result = {\n id: message.id,\n threadId: message.threadId,\n from: headers.find((h) => h.name === 'From')?.value || 'Unknown',\n to: headers.find((h) => h.name === 'To')?.value || '',\n subject: headers.find((h) => h.name === 'Subject')?.value || '(no subject)',\n date: headers.find((h) => h.name === 'Date')?.value || '',\n body,\n labels: message.labelIds || [],\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async sendEmail(args: Record): Promise {\n const { to, subject, body, cc, bcc } = parseToolArgs(gmailTools.sendEmail.input, args);\n\n // Build RFC 2822 formatted email\n const lines = [\n `To: ${to}`,\n `Subject: ${subject}`,\n 'Content-Type: text/plain; charset=utf-8',\n ];\n if (cc) lines.push(`Cc: ${cc}`);\n if (bcc) lines.push(`Bcc: ${bcc}`);\n lines.push('', body);\n\n const rawMessage = lines.join('\\r\\n');\n const encodedMessage = this.encodeBase64Url(rawMessage);\n\n const response = await fetch(\n `${GMAIL_API_BASE}/users/me/messages/send`,\n {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({ raw: encodedMessage }),\n }\n );\n\n if (!response.ok) {\n const error = await response.text();\n throw new Error(`Gmail API error: ${response.status} - ${error}`);\n }\n\n const result = await response.json() as { id: string; threadId: string };\n\n return {\n content: [{ type: 'text', text: `Email sent successfully. Message ID: ${result.id}` }],\n structuredContent: {\n success: true,\n messageId: result.id,\n threadId: result.threadId,\n title: `Email to ${to}`,\n // Inline artifact content (no external URL needed)\n content: {\n to,\n cc,\n bcc,\n subject,\n body,\n sentAt: new Date().toISOString(),\n },\n },\n };\n }\n\n private async searchMessages(args: Record): Promise {\n const { query, maxResults = DEFAULT_MAX_RESULTS } = parseToolArgs(\n gmailTools.searchMessages.input,\n args\n );\n return this.listMessages({ query, maxResults });\n }\n\n private async getThread(args: Record): Promise {\n const { threadId } = parseToolArgs(gmailTools.getThread.input, args);\n\n const response = await fetch(\n `${GMAIL_API_BASE}/users/me/threads/${threadId}?format=full`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!response.ok) {\n throw new Error(`Gmail API error: ${response.status}`);\n }\n\n const thread = await response.json() as GmailThread;\n\n const messages = thread.messages.map((msg) => {\n const headers = msg.payload?.headers || [];\n let body = '';\n if (msg.payload?.body?.data) {\n body = this.decodeBase64Url(msg.payload.body.data);\n } else if (msg.payload?.parts) {\n const textPart = msg.payload.parts.find((p) => p.mimeType === 'text/plain');\n if (textPart?.body?.data) {\n body = this.decodeBase64Url(textPart.body.data);\n }\n }\n\n return {\n id: msg.id,\n from: headers.find((h) => h.name === 'From')?.value || 'Unknown',\n to: headers.find((h) => h.name === 'To')?.value || '',\n subject: headers.find((h) => h.name === 'Subject')?.value || '(no subject)',\n date: headers.find((h) => h.name === 'Date')?.value || '',\n body,\n };\n });\n\n return {\n content: [{ type: 'text', text: JSON.stringify(messages, null, 2) }],\n structuredContent: { threadId: thread.id, messages },\n };\n }\n\n private async getAuthenticatedUser(): Promise {\n const response = await fetch('https://www.googleapis.com/oauth2/v2/userinfo', {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n });\n\n if (!response.ok) {\n throw new Error(`Failed to get user info: ${response.status}`);\n }\n\n const userInfo = await response.json() as { email: string; name: string; picture?: string };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(userInfo, null, 2) }],\n structuredContent: {\n email: userInfo.email,\n name: userInfo.name,\n picture: userInfo.picture,\n },\n };\n }\n\n private decodeBase64Url(data: string): string {\n const base64 = data.replace(/-/g, '+').replace(/_/g, '/');\n const binary = atob(base64);\n const bytes = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n bytes[i] = binary.charCodeAt(i);\n }\n return new TextDecoder().decode(bytes);\n }\n\n private encodeBase64Url(str: string): string {\n const bytes = new TextEncoder().encode(str);\n const binary = String.fromCharCode(...bytes);\n const base64 = btoa(binary);\n return base64.replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=+$/, '');\n }\n}\n" }, { "path": "worker/google/SheetsMCP.ts", "content": "/**\n * SheetsMCP - Hosted MCP wrapper for Google Sheets API\n *\n * Provides MCP-compatible tools for Google Sheets operations:\n * - getSpreadsheet: Get spreadsheet metadata\n * - getSheetData: Read data from a sheet\n * - listSpreadsheets: List recent spreadsheets\n * - searchSpreadsheets: Search spreadsheets by name\n * - createSpreadsheet: Create a new spreadsheet\n * - appendRows: Append rows to a sheet\n * - updateCells: Update specific cell range\n * - replaceSheetContent: Replace all content in a sheet\n */\n\nimport { HostedMCPServer, type MCPToolSchema, type MCPToolCallResult } from '../mcp/MCPClient';\nimport { toolsToMCPSchemas, parseToolArgs } from '../utils/zodTools';\nimport { sheetsTools } from './sheetsTools';\n\nconst SHEETS_API_BASE = 'https://sheets.googleapis.com/v4/spreadsheets';\nconst DRIVE_API_BASE = 'https://www.googleapis.com/drive/v3';\nconst DEFAULT_MAX_RESULTS = 10;\n\nexport interface SpreadsheetMetadata {\n spreadsheetId: string;\n properties: {\n title: string;\n locale?: string;\n timeZone?: string;\n };\n sheets: Array<{\n properties: {\n sheetId: number;\n title: string;\n index: number;\n gridProperties?: {\n rowCount: number;\n columnCount: number;\n };\n };\n }>;\n spreadsheetUrl: string;\n}\n\nexport interface SheetValues {\n range: string;\n majorDimension: string;\n values?: string[][];\n}\n\nexport interface DriveFile {\n id: string;\n name: string;\n mimeType: string;\n modifiedTime: string;\n webViewLink?: string;\n}\n\nexport class SheetsMCPServer extends HostedMCPServer {\n readonly name = 'Google Sheets';\n readonly description = 'Google Sheets API for reading, creating, and editing spreadsheets';\n\n private accessToken: string;\n\n constructor(accessToken: string) {\n super();\n this.accessToken = accessToken;\n }\n\n getTools(): MCPToolSchema[] {\n return toolsToMCPSchemas(sheetsTools);\n }\n\n async callTool(name: string, args: Record): Promise {\n try {\n switch (name) {\n case 'getSpreadsheet':\n return await this.getSpreadsheet(args);\n case 'getSheetData':\n return await this.getSheetData(args);\n case 'listSpreadsheets':\n return await this.listSpreadsheets(args);\n case 'searchSpreadsheets':\n return await this.searchSpreadsheets(args);\n case 'createSpreadsheet':\n return await this.createSpreadsheet(args);\n case 'appendRows':\n return await this.appendRows(args);\n case 'updateCells':\n return await this.updateCells(args);\n case 'replaceSheetContent':\n return await this.replaceSheetContent(args);\n default:\n return this.errorContent(`Unknown tool: ${name}`);\n }\n } catch (error) {\n return this.errorContent(error instanceof Error ? error.message : String(error));\n }\n }\n\n private async getSpreadsheet(args: Record): Promise {\n const { spreadsheetId } = parseToolArgs(sheetsTools.getSpreadsheet.input, args);\n\n const response = await fetch(\n `${SHEETS_API_BASE}/${spreadsheetId}?fields=spreadsheetId,properties,sheets.properties,spreadsheetUrl`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!response.ok) {\n throw new Error(`Google Sheets API error: ${response.status}`);\n }\n\n const data = await response.json() as SpreadsheetMetadata;\n\n const result = {\n spreadsheetId: data.spreadsheetId,\n title: data.properties.title,\n url: data.spreadsheetUrl,\n sheets: data.sheets.map((sheet) => ({\n sheetId: sheet.properties.sheetId,\n title: sheet.properties.title,\n rowCount: sheet.properties.gridProperties?.rowCount,\n columnCount: sheet.properties.gridProperties?.columnCount,\n })),\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async getSheetData(args: Record): Promise {\n const { spreadsheetId, range } = parseToolArgs(sheetsTools.getSheetData.input, args);\n\n const response = await fetch(\n `${SHEETS_API_BASE}/${spreadsheetId}/values/${encodeURIComponent(range)}`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!response.ok) {\n throw new Error(`Google Sheets API error: ${response.status}`);\n }\n\n const data = await response.json() as SheetValues;\n\n const result = {\n range: data.range,\n rows: data.values || [],\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n structuredContent: result,\n };\n }\n\n private async listSpreadsheets(args: Record): Promise {\n const { maxResults = DEFAULT_MAX_RESULTS, query } = parseToolArgs(sheetsTools.listSpreadsheets.input, args);\n\n // Build Drive API query for Google Sheets\n // Escape special characters for Google Drive query syntax\n let driveQuery = \"mimeType='application/vnd.google-apps.spreadsheet'\";\n if (query) {\n // Escape backslashes first, then single quotes\n const escapedQuery = query.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n driveQuery += ` and name contains '${escapedQuery}'`;\n }\n\n const params = new URLSearchParams({\n q: driveQuery,\n pageSize: String(Math.min(maxResults, 100)),\n fields: 'files(id,name,mimeType,modifiedTime,webViewLink)',\n orderBy: 'modifiedTime desc',\n });\n\n const response = await fetch(\n `${DRIVE_API_BASE}/files?${params.toString()}`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!response.ok) {\n throw new Error(`Google Drive API error: ${response.status}`);\n }\n\n const data = await response.json() as { files: DriveFile[] };\n\n const results = data.files.map((file) => ({\n spreadsheetId: file.id,\n title: file.name,\n modifiedTime: file.modifiedTime,\n url: file.webViewLink,\n }));\n\n return {\n content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],\n structuredContent: results,\n };\n }\n\n private async searchSpreadsheets(args: Record): Promise {\n const { query, maxResults = DEFAULT_MAX_RESULTS } = parseToolArgs(sheetsTools.searchSpreadsheets.input, args);\n return this.listSpreadsheets({ query, maxResults });\n }\n\n private async createSpreadsheet(args: Record): Promise {\n const { title, sheetTitle = 'Sheet1', data } = parseToolArgs(sheetsTools.createSpreadsheet.input, args);\n\n // Create the spreadsheet\n const createResponse = await fetch(\n SHEETS_API_BASE,\n {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n properties: { title },\n sheets: [{ properties: { title: sheetTitle } }],\n }),\n }\n );\n\n if (!createResponse.ok) {\n const error = await createResponse.text();\n throw new Error(`Google Sheets API error: ${createResponse.status} - ${error}`);\n }\n\n const spreadsheet = await createResponse.json() as SpreadsheetMetadata;\n\n // If data provided, insert it\n if (data && data.length > 0) {\n await this.writeValues(spreadsheet.spreadsheetId, sheetTitle, data);\n }\n\n const result = {\n spreadsheetId: spreadsheet.spreadsheetId,\n title: spreadsheet.properties.title,\n url: spreadsheet.spreadsheetUrl,\n };\n\n return {\n content: [{ type: 'text', text: `Spreadsheet created successfully: ${result.url}` }],\n structuredContent: result,\n };\n }\n\n private async appendRows(args: Record): Promise {\n const { spreadsheetId, sheetName = 'Sheet1', rows, title: titleArg } = parseToolArgs(sheetsTools.appendRows.input, args);\n let title = titleArg;\n\n // Fetch title from spreadsheet metadata if not provided\n if (!title) {\n const metaResponse = await fetch(\n `${SHEETS_API_BASE}/${spreadsheetId}?fields=properties.title`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n if (metaResponse.ok) {\n const metadata = await metaResponse.json() as SpreadsheetMetadata;\n title = metadata.properties.title;\n }\n }\n\n const range = `${sheetName}!A:A`; // Append to first column, API will extend\n\n const response = await fetch(\n `${SHEETS_API_BASE}/${spreadsheetId}/values/${encodeURIComponent(range)}:append?valueInputOption=USER_ENTERED&insertDataOption=INSERT_ROWS`,\n {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({ values: rows }),\n }\n );\n\n if (!response.ok) {\n const error = await response.text();\n throw new Error(`Google Sheets API error: ${response.status} - ${error}`);\n }\n\n const data = await response.json() as {\n updates: {\n updatedRange: string;\n updatedRows: number;\n updatedCells: number;\n };\n };\n\n const url = `https://docs.google.com/spreadsheets/d/${spreadsheetId}/edit`;\n const result = {\n success: true,\n spreadsheetId,\n url,\n title: title || 'Spreadsheet',\n updatedRange: data.updates.updatedRange,\n updatedRows: data.updates.updatedRows,\n };\n\n return {\n content: [{ type: 'text', text: `Appended ${result.updatedRows} rows successfully: ${url}` }],\n structuredContent: result,\n };\n }\n\n private async updateCells(args: Record): Promise {\n const { spreadsheetId, range, values, title: titleArg } = parseToolArgs(sheetsTools.updateCells.input, args);\n let title = titleArg;\n\n // Fetch title from spreadsheet metadata if not provided\n if (!title) {\n const metaResponse = await fetch(\n `${SHEETS_API_BASE}/${spreadsheetId}?fields=properties.title`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n if (metaResponse.ok) {\n const metadata = await metaResponse.json() as SpreadsheetMetadata;\n title = metadata.properties.title;\n }\n }\n\n const response = await fetch(\n `${SHEETS_API_BASE}/${spreadsheetId}/values/${encodeURIComponent(range)}?valueInputOption=USER_ENTERED`,\n {\n method: 'PUT',\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({ values }),\n }\n );\n\n if (!response.ok) {\n const error = await response.text();\n throw new Error(`Google Sheets API error: ${response.status} - ${error}`);\n }\n\n const data = await response.json() as {\n updatedRange: string;\n updatedCells: number;\n };\n\n const url = `https://docs.google.com/spreadsheets/d/${spreadsheetId}/edit`;\n const result = {\n success: true,\n spreadsheetId,\n url,\n title: title || 'Spreadsheet',\n updatedRange: data.updatedRange,\n updatedCells: data.updatedCells,\n };\n\n return {\n content: [{ type: 'text', text: `Updated ${result.updatedCells} cells successfully: ${url}` }],\n structuredContent: result,\n };\n }\n\n private async replaceSheetContent(args: Record): Promise {\n const { spreadsheetId, sheetName, data } = parseToolArgs(sheetsTools.replaceSheetContent.input, args);\n\n // Get spreadsheet metadata to find the sheet\n const metaResponse = await fetch(\n `${SHEETS_API_BASE}/${spreadsheetId}?fields=properties.title,sheets.properties,spreadsheetUrl`,\n {\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n },\n }\n );\n\n if (!metaResponse.ok) {\n throw new Error(`Google Sheets API error: ${metaResponse.status}`);\n }\n\n const metadata = await metaResponse.json() as SpreadsheetMetadata;\n const targetSheet = sheetName\n ? metadata.sheets.find((s) => s.properties.title === sheetName)\n : metadata.sheets[0];\n\n if (!targetSheet) {\n throw new Error(`Sheet \"${sheetName || 'default'}\" not found`);\n }\n\n const targetSheetName = targetSheet.properties.title;\n const sheetId = targetSheet.properties.sheetId;\n\n // Clear the sheet first\n const clearResponse = await fetch(\n `${SHEETS_API_BASE}/${spreadsheetId}:batchUpdate`,\n {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n requests: [\n {\n updateCells: {\n range: { sheetId },\n fields: 'userEnteredValue',\n },\n },\n ],\n }),\n }\n );\n\n if (!clearResponse.ok) {\n const error = await clearResponse.text();\n throw new Error(`Failed to clear sheet: ${clearResponse.status} - ${error}`);\n }\n\n // Write new data\n if (data.length > 0) {\n await this.writeValues(spreadsheetId, targetSheetName, data);\n }\n\n const result = {\n success: true,\n spreadsheetId,\n url: metadata.spreadsheetUrl,\n title: metadata.properties?.title || 'Spreadsheet',\n };\n\n return {\n content: [{ type: 'text', text: `Sheet content replaced successfully: ${result.url}` }],\n structuredContent: result,\n };\n }\n\n private async writeValues(spreadsheetId: string, sheetName: string, values: string[][]): Promise {\n const response = await fetch(\n `${SHEETS_API_BASE}/${spreadsheetId}/values/${encodeURIComponent(sheetName)}?valueInputOption=USER_ENTERED`,\n {\n method: 'PUT',\n headers: {\n 'Authorization': `Bearer ${this.accessToken}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({ values }),\n }\n );\n\n if (!response.ok) {\n const error = await response.text();\n throw new Error(`Failed to write values: ${response.status} - ${error}`);\n }\n }\n}\n" }, { "path": "worker/google/docsTools.ts", "content": "/**\n * Google Docs MCP Tool Definitions\n *\n * Single source of truth for Google Docs tool schemas using Zod.\n * Used for both JSON Schema generation (getTools) and runtime validation (callTool).\n */\n\nimport { z } from 'zod';\nimport { defineTools, commonSchemas } from '../utils/zodTools';\n\n// ============================================================================\n// Output Schemas\n// ============================================================================\n\nconst documentDetailOutput = z.object({\n documentId: z.string().describe('Document ID'),\n title: z.string().describe('Document title'),\n content: z.string().describe('Document text content'),\n});\n\nconst documentListItemOutput = z.object({\n documentId: z.string().describe('Document ID'),\n title: z.string().describe('Document title'),\n modifiedTime: z.string().optional().describe('Last modified timestamp'),\n url: z.string().optional().describe('URL to view/edit document'),\n});\n\nconst createDocumentOutput = z.object({\n documentId: z.string().describe('Created document ID'),\n title: z.string().describe('Document title'),\n url: z.string().describe('URL to view/edit document'),\n});\n\nconst updateDocumentOutput = z.object({\n success: z.boolean().describe('Whether update succeeded'),\n documentId: z.string().describe('Document ID'),\n url: z.string().optional().describe('URL to view/edit document'),\n});\n\n// ============================================================================\n// Tool Definitions\n// ============================================================================\n\nexport const docsTools = defineTools({\n getDocument: {\n description: 'Get the full content of a Google Doc',\n input: z.object({\n documentId: commonSchemas.documentId.describe('The ID of the Google Doc (from the URL)'),\n }),\n output: documentDetailOutput,\n },\n\n listDocuments: {\n description: 'List recent Google Docs from Drive',\n input: z.object({\n maxResults: z.coerce.number().int().min(1).max(100).default(10)\n .describe('Maximum number of documents to return (default 10)'),\n query: z.string().max(500).optional()\n .describe('Search query for document names'),\n }),\n output: z.array(documentListItemOutput).describe('Array of document summaries'),\n },\n\n createDocument: {\n description: 'Create a new Google Doc',\n input: z.object({\n title: commonSchemas.title.describe('Title of the new document'),\n content: z.string().max(100000).optional()\n .describe('Initial content for the document. Supports markdown: # headings, **bold**, *italic*, `code`, [links](url), - bullets, 1. numbered lists'),\n }),\n output: createDocumentOutput,\n approvalRequiredFields: ['title', 'content'],\n },\n\n appendToDocument: {\n description: 'Append text content to the end of a Google Doc',\n input: z.object({\n documentId: commonSchemas.documentId.describe('The ID of the Google Doc'),\n content: commonSchemas.content.describe('Content to append. Supports markdown: # headings, **bold**, *italic*, `code`, [links](url), - bullets, 1. numbered lists'),\n }),\n output: updateDocumentOutput,\n approvalRequiredFields: ['documentId', 'title', 'currentContent', 'newContent'],\n },\n\n searchDocuments: {\n description: 'Search for Google Docs by content or title',\n input: z.object({\n query: commonSchemas.searchQuery.describe('Search query (searches document names)'),\n maxResults: z.coerce.number().int().min(1).max(100).default(10)\n .describe('Maximum number of results (default 10)'),\n }),\n output: z.array(documentListItemOutput).describe('Array of matching documents'),\n },\n\n replaceDocumentContent: {\n description: 'Replace the entire content of a Google Doc with new content',\n input: z.object({\n documentId: commonSchemas.documentId.describe('The ID of the Google Doc'),\n content: z.string().max(100000).default('')\n .describe('New content to replace the document with. Supports markdown: # headings, **bold**, *italic*, `code`, [links](url), - bullets, 1. numbered lists'),\n }),\n output: updateDocumentOutput,\n approvalRequiredFields: ['documentId', 'title', 'currentContent', 'newContent'],\n },\n});\n\n// Export type for tool names\nexport type DocsToolName = keyof typeof docsTools;\n" }, { "path": "worker/google/gmailTools.ts", "content": "/**\n * Gmail MCP Tool Definitions\n *\n * Single source of truth for Gmail tool schemas using Zod.\n * Used for both JSON Schema generation (getTools) and runtime validation (callTool).\n */\n\nimport { z } from 'zod';\nimport { defineTools, commonSchemas } from '../utils/zodTools';\n\n// ============================================================================\n// Gmail-specific Schema Components\n// ============================================================================\n\nconst gmailLabelIds = z.array(z.string())\n .describe('Filter by label IDs (e.g., [\"INBOX\", \"UNREAD\"])');\n\n// ============================================================================\n// Output Schemas\n// ============================================================================\n\nconst messageListItemOutput = z.object({\n id: z.string().describe('Message ID'),\n threadId: z.string().describe('Thread ID'),\n from: z.string().describe('Sender email/name'),\n subject: z.string().describe('Email subject'),\n date: z.string().describe('Email date'),\n snippet: z.string().describe('Preview text'),\n});\n\nconst messageDetailOutput = z.object({\n id: z.string().describe('Message ID'),\n threadId: z.string().describe('Thread ID'),\n from: z.string().describe('Sender email/name'),\n to: z.string().describe('Recipient email'),\n subject: z.string().describe('Email subject'),\n date: z.string().describe('Email date'),\n body: z.string().describe('Email body content'),\n labels: z.array(z.string()).describe('Gmail labels'),\n});\n\nconst sendEmailOutput = z.object({\n success: z.boolean().describe('Whether email was sent'),\n messageId: z.string().describe('Sent message ID'),\n threadId: z.string().describe('Thread ID'),\n});\n\nconst threadOutput = z.object({\n threadId: z.string().describe('Thread ID'),\n messages: z.array(z.object({\n id: z.string().describe('Message ID'),\n from: z.string().describe('Sender email/name'),\n to: z.string().describe('Recipient email'),\n subject: z.string().describe('Email subject'),\n date: z.string().describe('Email date'),\n body: z.string().describe('Email body content'),\n })).describe('Messages in the thread'),\n});\n\nconst userInfoOutput = z.object({\n email: z.string().describe('User email address'),\n name: z.string().describe('User display name'),\n picture: z.string().optional().describe('Profile picture URL'),\n});\n\n// ============================================================================\n// Tool Definitions\n// ============================================================================\n\nexport const gmailTools = defineTools({\n listMessages: {\n description: 'List recent email messages from Gmail inbox',\n input: z.object({\n maxResults: z.coerce.number().int().min(1).max(100).default(10)\n .describe('Maximum number of messages to return (default 10, max 100)'),\n query: z.string().max(500).optional()\n .describe('Gmail search query (e.g., \"from:user@example.com\", \"is:unread\")'),\n labelIds: gmailLabelIds.optional(),\n }),\n output: z.array(messageListItemOutput)\n .describe('Array of email message summaries'),\n },\n\n getMessage: {\n description: 'Get the full content of a specific email message',\n input: z.object({\n messageId: commonSchemas.messageId,\n }),\n output: messageDetailOutput,\n },\n\n sendEmail: {\n description: 'Send an email message',\n input: z.object({\n to: commonSchemas.email.describe('Recipient email address'),\n subject: z.string().max(500).describe('Email subject line'),\n body: z.string().max(50000).describe('Email body content (plain text)'),\n cc: z.string().email().optional().describe('CC recipients (comma-separated)'),\n bcc: z.string().email().optional().describe('BCC recipients (comma-separated)'),\n }),\n output: sendEmailOutput,\n approvalRequiredFields: ['to', 'subject', 'body'],\n },\n\n searchMessages: {\n description: 'Search for emails using Gmail query syntax',\n input: z.object({\n query: z.string().max(500).describe('Gmail search query (e.g., \"subject:meeting after:2024/01/01\")'),\n maxResults: z.coerce.number().int().min(1).max(100).default(10)\n .describe('Maximum number of results (default 10)'),\n }),\n output: z.array(messageListItemOutput)\n .describe('Array of matching email summaries'),\n },\n\n getThread: {\n description: 'Get a full email thread/conversation',\n input: z.object({\n threadId: commonSchemas.threadId,\n }),\n output: threadOutput,\n },\n\n getAuthenticatedUser: {\n description: 'Get the email address and profile of the authenticated Gmail user',\n input: z.object({}),\n output: userInfoOutput,\n },\n});\n\n// Export individual schemas for direct access if needed\nexport type GmailToolName = keyof typeof gmailTools;\n" }, { "path": "worker/google/index.ts", "content": "/**\n * Google services module\n *\n * Provides OAuth and MCP wrappers for Google services:\n * - Gmail\n * - Google Docs\n */\n\nexport * from './oauth';\nexport { GmailMCPServer } from './GmailMCP';\nexport { DocsMCPServer } from './DocsMCP';\n" }, { "path": "worker/google/markdownToDocs.ts", "content": "/**\n * Markdown to Google Docs API Converter\n *\n * Converts markdown text to Google Docs API batchUpdate requests\n * with proper formatting (headings, bold, italic, lists, links).\n */\n\ninterface InsertTextRequest {\n insertText: {\n location: { index: number };\n text: string;\n };\n}\n\ninterface UpdateTextStyleRequest {\n updateTextStyle: {\n range: { startIndex: number; endIndex: number };\n textStyle: {\n bold?: boolean;\n italic?: boolean;\n link?: { url: string };\n weightedFontFamily?: { fontFamily: string };\n };\n fields: string;\n };\n}\n\ninterface UpdateParagraphStyleRequest {\n updateParagraphStyle: {\n range: { startIndex: number; endIndex: number };\n paragraphStyle: {\n namedStyleType?: string;\n };\n fields: string;\n };\n}\n\ninterface CreateParagraphBulletsRequest {\n createParagraphBullets: {\n range: { startIndex: number; endIndex: number };\n bulletPreset: string;\n };\n}\n\ntype DocsRequest =\n | InsertTextRequest\n | UpdateTextStyleRequest\n | UpdateParagraphStyleRequest\n | CreateParagraphBulletsRequest;\n\ninterface TextRange {\n start: number;\n end: number;\n}\n\ninterface FormatInfo {\n bold: TextRange[];\n italic: TextRange[];\n code: TextRange[];\n links: Array;\n}\n\ninterface ParagraphInfo {\n start: number;\n end: number;\n type: 'heading1' | 'heading2' | 'heading3' | 'heading4' | 'bullet' | 'numbered' | 'normal';\n}\n\n/**\n * Parse markdown and generate Google Docs API requests\n * @param markdown The markdown text to convert\n * @param startIndex The starting index in the document (usually 1 for new docs)\n * @returns Array of Google Docs API requests\n */\nexport function markdownToDocsRequests(markdown: string, startIndex: number = 1): DocsRequest[] {\n const { plainText, formatting, paragraphs } = parseMarkdown(markdown);\n\n if (!plainText) {\n return [];\n }\n\n const requests: DocsRequest[] = [];\n\n requests.push({\n insertText: {\n location: { index: startIndex },\n text: plainText,\n },\n });\n\n for (const para of paragraphs) {\n if (para.type === 'normal') continue;\n\n const paraStart = startIndex + para.start;\n const paraEnd = startIndex + para.end;\n\n if (para.type === 'bullet') {\n requests.push({\n createParagraphBullets: {\n range: { startIndex: paraStart, endIndex: paraEnd },\n bulletPreset: 'BULLET_DISC_CIRCLE_SQUARE',\n },\n });\n } else if (para.type === 'numbered') {\n requests.push({\n createParagraphBullets: {\n range: { startIndex: paraStart, endIndex: paraEnd },\n bulletPreset: 'NUMBERED_DECIMAL_ALPHA_ROMAN',\n },\n });\n } else {\n const styleMap: Record = {\n heading1: 'HEADING_1',\n heading2: 'HEADING_2',\n heading3: 'HEADING_3',\n heading4: 'HEADING_4',\n };\n const namedStyleType = styleMap[para.type];\n if (namedStyleType) {\n requests.push({\n updateParagraphStyle: {\n range: { startIndex: paraStart, endIndex: paraEnd },\n paragraphStyle: { namedStyleType },\n fields: 'namedStyleType',\n },\n });\n }\n }\n }\n\n for (const range of formatting.bold) {\n requests.push({\n updateTextStyle: {\n range: {\n startIndex: startIndex + range.start,\n endIndex: startIndex + range.end,\n },\n textStyle: { bold: true },\n fields: 'bold',\n },\n });\n }\n\n for (const range of formatting.italic) {\n requests.push({\n updateTextStyle: {\n range: {\n startIndex: startIndex + range.start,\n endIndex: startIndex + range.end,\n },\n textStyle: { italic: true },\n fields: 'italic',\n },\n });\n }\n\n for (const range of formatting.code) {\n requests.push({\n updateTextStyle: {\n range: {\n startIndex: startIndex + range.start,\n endIndex: startIndex + range.end,\n },\n textStyle: {\n weightedFontFamily: { fontFamily: 'Roboto Mono' },\n },\n fields: 'weightedFontFamily',\n },\n });\n }\n\n for (const link of formatting.links) {\n requests.push({\n updateTextStyle: {\n range: {\n startIndex: startIndex + link.start,\n endIndex: startIndex + link.end,\n },\n textStyle: {\n link: { url: link.url },\n },\n fields: 'link',\n },\n });\n }\n\n return requests;\n}\n\n/**\n * Parse markdown into plain text with formatting info\n */\nfunction parseMarkdown(markdown: string): {\n plainText: string;\n formatting: FormatInfo;\n paragraphs: ParagraphInfo[];\n} {\n const formatting: FormatInfo = {\n bold: [],\n italic: [],\n code: [],\n links: [],\n };\n const paragraphs: ParagraphInfo[] = [];\n const lines = markdown.split('\\n');\n let plainText = '';\n let currentIndex = 0;\n\n for (let i = 0; i < lines.length; i++) {\n let line = lines[i];\n const lineStart = currentIndex;\n let paragraphType: ParagraphInfo['type'] = 'normal';\n\n const headingMatch = line.match(/^(#{1,4})\\s+(.*)$/);\n if (headingMatch) {\n const level = headingMatch[1].length;\n line = headingMatch[2];\n paragraphType = `heading${level}` as ParagraphInfo['type'];\n }\n\n const bulletMatch = line.match(/^[-*]\\s+(.*)$/);\n if (bulletMatch) {\n line = bulletMatch[1];\n paragraphType = 'bullet';\n }\n\n const numberedMatch = line.match(/^\\d+\\.\\s+(.*)$/);\n if (numberedMatch) {\n line = numberedMatch[1];\n paragraphType = 'numbered';\n }\n\n const { text: processedLine, formatRanges } = processInlineFormatting(line, currentIndex);\n\n formatting.bold.push(...formatRanges.bold);\n formatting.italic.push(...formatRanges.italic);\n formatting.code.push(...formatRanges.code);\n formatting.links.push(...formatRanges.links);\n\n plainText += processedLine;\n currentIndex += processedLine.length;\n\n if (i < lines.length - 1) {\n plainText += '\\n';\n currentIndex += 1;\n }\n\n if (processedLine.trim() || paragraphType !== 'normal') {\n paragraphs.push({\n start: lineStart,\n end: currentIndex,\n type: paragraphType,\n });\n }\n }\n\n return { plainText, formatting, paragraphs };\n}\n\n/**\n * Process inline formatting (bold, italic, code, links)\n */\nfunction processInlineFormatting(\n text: string,\n baseIndex: number\n): {\n text: string;\n formatRanges: FormatInfo;\n} {\n const formatRanges: FormatInfo = {\n bold: [],\n italic: [],\n code: [],\n links: [],\n };\n\n let result = '';\n let i = 0;\n let outputIndex = baseIndex;\n\n while (i < text.length) {\n const linkMatch = text.slice(i).match(/^\\[([^\\]]+)\\]\\(([^)]+)\\)/);\n if (linkMatch) {\n const linkText = linkMatch[1];\n const url = linkMatch[2];\n const start = outputIndex;\n result += linkText;\n outputIndex += linkText.length;\n formatRanges.links.push({ start, end: outputIndex, url });\n i += linkMatch[0].length;\n continue;\n }\n\n const codeMatch = text.slice(i).match(/^`([^`]+)`/);\n if (codeMatch) {\n const codeText = codeMatch[1];\n const start = outputIndex;\n result += codeText;\n outputIndex += codeText.length;\n formatRanges.code.push({ start, end: outputIndex });\n i += codeMatch[0].length;\n continue;\n }\n\n const boldItalicMatch = text.slice(i).match(/^(\\*\\*\\*|___)([^*_]+)\\1/);\n if (boldItalicMatch) {\n const content = boldItalicMatch[2];\n const start = outputIndex;\n result += content;\n outputIndex += content.length;\n formatRanges.bold.push({ start, end: outputIndex });\n formatRanges.italic.push({ start, end: outputIndex });\n i += boldItalicMatch[0].length;\n continue;\n }\n\n const boldMatch = text.slice(i).match(/^(\\*\\*|__)([^*_]+)\\1/);\n if (boldMatch) {\n const content = boldMatch[2];\n const start = outputIndex;\n result += content;\n outputIndex += content.length;\n formatRanges.bold.push({ start, end: outputIndex });\n i += boldMatch[0].length;\n continue;\n }\n\n const italicMatch = text.slice(i).match(/^(\\*|_)([^*_]+)\\1/);\n if (italicMatch) {\n const content = italicMatch[2];\n const start = outputIndex;\n result += content;\n outputIndex += content.length;\n formatRanges.italic.push({ start, end: outputIndex });\n i += italicMatch[0].length;\n continue;\n }\n\n result += text[i];\n outputIndex += 1;\n i += 1;\n }\n\n return { text: result, formatRanges };\n}\n\n/**\n * Extract plain text from markdown (for preview/display)\n */\nexport function markdownToPlainText(markdown: string): string {\n const { plainText } = parseMarkdown(markdown);\n return plainText;\n}\n" }, { "path": "worker/google/oauth.ts", "content": "// Google OAuth Configuration\n// Requires secrets: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET\n\nexport interface GoogleEnv {\n GOOGLE_CLIENT_ID: string;\n GOOGLE_CLIENT_SECRET: string;\n}\n\nexport interface GoogleTokenResponse {\n access_token: string;\n refresh_token?: string;\n token_type: string;\n expires_in: number;\n scope: string;\n}\n\nexport interface GoogleUserInfo {\n id: string;\n email: string;\n name: string;\n picture?: string;\n}\n\n// Scopes needed for Gmail, Google Docs, and Google Sheets access\nconst GOOGLE_SCOPES = [\n 'https://www.googleapis.com/auth/gmail.readonly',\n 'https://www.googleapis.com/auth/gmail.send',\n 'https://www.googleapis.com/auth/gmail.modify',\n 'https://www.googleapis.com/auth/documents.readonly',\n 'https://www.googleapis.com/auth/documents',\n 'https://www.googleapis.com/auth/spreadsheets.readonly',\n 'https://www.googleapis.com/auth/spreadsheets',\n 'https://www.googleapis.com/auth/drive.readonly',\n 'https://www.googleapis.com/auth/userinfo.email',\n 'https://www.googleapis.com/auth/userinfo.profile',\n];\n\n/**\n * Generate the Google OAuth authorization URL\n */\nexport function getOAuthUrl(\n clientId: string,\n redirectUri: string,\n state: string\n): string {\n const params = new URLSearchParams({\n client_id: clientId,\n redirect_uri: redirectUri,\n response_type: 'code',\n scope: GOOGLE_SCOPES.join(' '),\n state,\n access_type: 'offline',\n prompt: 'consent',\n });\n\n return `https://accounts.google.com/o/oauth2/v2/auth?${params.toString()}`;\n}\n\n/**\n * Exchange authorization code for tokens\n */\nexport async function exchangeCodeForToken(\n code: string,\n clientId: string,\n clientSecret: string,\n redirectUri: string\n): Promise {\n const response = await fetch('https://oauth2.googleapis.com/token', {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/x-www-form-urlencoded',\n },\n body: new URLSearchParams({\n code,\n client_id: clientId,\n client_secret: clientSecret,\n redirect_uri: redirectUri,\n grant_type: 'authorization_code',\n }),\n });\n\n if (!response.ok) {\n const error = await response.text();\n throw new Error(`Google token exchange failed: ${response.status} - ${error}`);\n }\n\n const data = await response.json() as GoogleTokenResponse & { error?: string };\n\n if (data.error) {\n throw new Error(`Google OAuth error: ${data.error}`);\n }\n\n return data;\n}\n\n/**\n * Refresh an access token using a refresh token\n */\nexport async function refreshAccessToken(\n refreshToken: string,\n clientId: string,\n clientSecret: string\n): Promise {\n const response = await fetch('https://oauth2.googleapis.com/token', {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/x-www-form-urlencoded',\n },\n body: new URLSearchParams({\n refresh_token: refreshToken,\n client_id: clientId,\n client_secret: clientSecret,\n grant_type: 'refresh_token',\n }),\n });\n\n if (!response.ok) {\n const error = await response.text();\n throw new Error(`Google token refresh failed: ${response.status} - ${error}`);\n }\n\n return response.json() as Promise;\n}\n\n/**\n * Get the authenticated user's profile\n */\nexport async function getUserInfo(accessToken: string): Promise {\n const response = await fetch('https://www.googleapis.com/oauth2/v2/userinfo', {\n headers: {\n 'Authorization': `Bearer ${accessToken}`,\n },\n });\n\n if (!response.ok) {\n throw new Error(`Failed to get Google user info: ${response.status}`);\n }\n\n return response.json() as Promise;\n}\n\n/**\n * Generate a random state string for OAuth\n */\nexport function generateState(): string {\n const array = new Uint8Array(16);\n crypto.getRandomValues(array);\n return Array.from(array, (b) => b.toString(16).padStart(2, '0')).join('');\n}\n" }, { "path": "worker/google/sheetsTools.ts", "content": "/**\n * Google Sheets MCP Tool Definitions\n *\n * Single source of truth for Google Sheets tool schemas using Zod.\n * Used for both JSON Schema generation (getTools) and runtime validation (callTool).\n */\n\nimport { z } from 'zod';\nimport { defineTools, commonSchemas } from '../utils/zodTools';\n\n// ============================================================================\n// Sheets-specific Schema Components\n// ============================================================================\n\nconst sheetRange = z.string().max(200)\n .describe('A1 notation range (e.g., \"Sheet1\", \"Sheet1!A1:D10\", \"A:D\")');\n\nconst sheetData = z.array(z.array(z.string()))\n .describe('Data as 2D array of strings (rows x columns)');\n\n// ============================================================================\n// Output Schemas\n// ============================================================================\n\nconst sheetInfoOutput = z.object({\n sheetId: z.number().describe('Sheet ID'),\n title: z.string().describe('Sheet name'),\n rowCount: z.number().optional().describe('Number of rows'),\n columnCount: z.number().optional().describe('Number of columns'),\n});\n\nconst spreadsheetDetailOutput = z.object({\n spreadsheetId: z.string().describe('Spreadsheet ID'),\n title: z.string().describe('Spreadsheet title'),\n url: z.string().describe('URL to view/edit spreadsheet'),\n sheets: z.array(sheetInfoOutput).describe('List of sheets in the spreadsheet'),\n});\n\nconst sheetDataOutput = z.object({\n range: z.string().describe('The range that was read'),\n rows: z.array(z.array(z.string())).describe('The cell values as a 2D array of strings'),\n});\n\nconst spreadsheetListItemOutput = z.object({\n spreadsheetId: z.string().describe('Spreadsheet ID'),\n title: z.string().describe('Spreadsheet title'),\n modifiedTime: z.string().optional().describe('Last modified timestamp'),\n url: z.string().optional().describe('URL to view/edit spreadsheet'),\n});\n\nconst createSpreadsheetOutput = z.object({\n spreadsheetId: z.string().describe('Created spreadsheet ID'),\n title: z.string().describe('Spreadsheet title'),\n url: z.string().describe('URL to view/edit spreadsheet'),\n});\n\nconst updateSpreadsheetOutput = z.object({\n success: z.boolean().describe('Whether operation succeeded'),\n spreadsheetId: z.string().describe('Spreadsheet ID'),\n updatedRange: z.string().optional().describe('The range that was updated'),\n updatedRows: z.number().optional().describe('Number of rows affected'),\n updatedCells: z.number().optional().describe('Number of cells affected'),\n});\n\n// ============================================================================\n// Tool Definitions\n// ============================================================================\n\nexport const sheetsTools = defineTools({\n getSpreadsheet: {\n description: 'Get metadata about a spreadsheet (title, sheets list, properties)',\n input: z.object({\n spreadsheetId: commonSchemas.spreadsheetId.describe('The ID of the spreadsheet (from the URL)'),\n }),\n output: spreadsheetDetailOutput,\n },\n\n getSheetData: {\n description: 'Read data from a specific sheet or range',\n input: z.object({\n spreadsheetId: commonSchemas.spreadsheetId.describe('The ID of the spreadsheet'),\n range: sheetRange,\n }),\n output: sheetDataOutput,\n },\n\n listSpreadsheets: {\n description: 'List recent Google Spreadsheets from Drive',\n input: z.object({\n maxResults: z.coerce.number().int().min(1).max(100).default(10)\n .describe('Maximum number of spreadsheets to return (default 10)'),\n query: z.string().max(500).optional()\n .describe('Search query for spreadsheet names'),\n }),\n output: z.array(spreadsheetListItemOutput).describe('Array of spreadsheet summaries'),\n },\n\n searchSpreadsheets: {\n description: 'Search for Google Spreadsheets by name',\n input: z.object({\n query: commonSchemas.searchQuery.describe('Search query (searches spreadsheet names)'),\n maxResults: z.coerce.number().int().min(1).max(100).default(10)\n .describe('Maximum number of results (default 10)'),\n }),\n output: z.array(spreadsheetListItemOutput).describe('Array of matching spreadsheets'),\n },\n\n createSpreadsheet: {\n description: 'Create a new Google Spreadsheet',\n input: z.object({\n title: commonSchemas.title.describe('Title of the new spreadsheet'),\n sheetTitle: z.string().max(100).default('Sheet1')\n .describe('Name of the first sheet (default \"Sheet1\")'),\n data: sheetData.optional()\n .describe('Initial data as 2D array of strings (rows x columns)'),\n }),\n output: createSpreadsheetOutput,\n approvalRequiredFields: ['title', 'rows'],\n },\n\n appendRows: {\n description: 'Append rows to the end of a sheet',\n input: z.object({\n spreadsheetId: commonSchemas.spreadsheetId.describe('The ID of the spreadsheet'),\n title: commonSchemas.title.optional()\n .describe('Title of the spreadsheet (for display in results)'),\n sheetName: z.string().max(100).default('Sheet1')\n .describe('Name of the sheet to append to (default first sheet)'),\n rows: z.array(z.array(z.string())).min(1)\n .describe('Rows to append as 2D array of strings'),\n }),\n output: updateSpreadsheetOutput,\n approvalRequiredFields: ['spreadsheetId', 'title', 'currentRows', 'newRows'],\n },\n\n updateCells: {\n description: 'Update specific cells in a sheet',\n input: z.object({\n spreadsheetId: commonSchemas.spreadsheetId.describe('The ID of the spreadsheet'),\n title: commonSchemas.title.optional()\n .describe('Title of the spreadsheet (for display in results)'),\n range: sheetRange.describe('A1 notation range to update (e.g., \"Sheet1!A1:B2\")'),\n values: z.array(z.array(z.string()))\n .describe('New values as 2D array of strings'),\n }),\n output: updateSpreadsheetOutput,\n approvalRequiredFields: ['spreadsheetId', 'title', 'currentRows', 'updates'],\n },\n\n replaceSheetContent: {\n description: 'Replace all content in a sheet with new data',\n input: z.object({\n spreadsheetId: commonSchemas.spreadsheetId.describe('The ID of the spreadsheet'),\n sheetName: z.string().max(100).optional()\n .describe('Name of the sheet to replace (default first sheet)'),\n data: z.array(z.array(z.string()))\n .describe('New data as 2D array of strings (rows x columns)'),\n }),\n output: z.object({\n success: z.boolean().describe('Whether replacement succeeded'),\n spreadsheetId: z.string().describe('Spreadsheet ID'),\n url: z.string().describe('URL to view/edit spreadsheet'),\n }),\n approvalRequiredFields: ['spreadsheetId', 'title', 'currentRows', 'newRows'],\n },\n});\n\n// Export type for tool names\nexport type SheetsToolName = keyof typeof sheetsTools;\n" }, { "path": "worker/handlers/boards.ts", "content": "/**\n * Board-scoped route handlers\n */\n\nimport { jsonResponse } from '../utils/response';\nimport { handleGeneratePlan, handleResolveCheckpoint, handleCancelWorkflow } from './workflows';\nimport type { BoardDO } from '../BoardDO';\nimport type { UserDO } from '../UserDO';\nimport type { AuthUser } from '../auth';\n\ntype BoardDOStub = DurableObjectStub;\ntype UserDOStub = DurableObjectStub;\n\n/**\n * Route board-scoped requests to appropriate RPC methods\n */\nexport async function routeBoardRequest(\n request: Request,\n boardStub: BoardDOStub,\n userStub: UserDOStub,\n boardId: string,\n subPath: string,\n env: Env,\n _user: AuthUser\n): Promise {\n const method = request.method;\n\n // GET /api/boards/:id - Get board\n if (!subPath && method === 'GET') {\n try {\n const board = await boardStub.getBoard(boardId);\n return jsonResponse({ success: true, data: board });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'Board not found' },\n }, 404);\n }\n }\n\n // PUT /api/boards/:id - Update board\n if (!subPath && method === 'PUT') {\n const data = await request.json() as { name?: string };\n try {\n const board = await boardStub.updateBoard(boardId, data);\n // Also update UserDO's board list if name changed\n if (data.name) {\n await userStub.updateBoardName(boardId, data.name);\n }\n return jsonResponse({ success: true, data: board });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'UPDATE_FAILED', message: error instanceof Error ? error.message : 'Failed to update board' },\n }, 500);\n }\n }\n\n // DELETE /api/boards/:id - Delete board\n if (!subPath && method === 'DELETE') {\n try {\n await boardStub.deleteBoard(boardId);\n await userStub.removeBoard(boardId);\n return jsonResponse({ success: true });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'DELETE_FAILED', message: error instanceof Error ? error.message : 'Failed to delete board' },\n }, 500);\n }\n }\n\n // ============================================\n // COLUMN ROUTES\n // ============================================\n\n // POST /api/boards/:id/columns - Create column\n const createColumnMatch = subPath === '/columns' && method === 'POST';\n if (createColumnMatch) {\n const data = await request.json() as { name: string };\n try {\n const column = await boardStub.createColumn(boardId, data);\n return jsonResponse({ success: true, data: column });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'CREATE_FAILED', message: error instanceof Error ? error.message : 'Failed to create column' },\n }, 500);\n }\n }\n\n // PUT /api/boards/:id/columns/:columnId - Update column\n const updateColumnMatch = subPath.match(/^\\/columns\\/([^/]+)$/);\n if (updateColumnMatch && method === 'PUT') {\n const columnId = updateColumnMatch[1];\n const data = await request.json() as { name?: string; position?: number };\n try {\n const column = await boardStub.updateColumn(columnId, data);\n return jsonResponse({ success: true, data: column });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'UPDATE_FAILED', message: error instanceof Error ? error.message : 'Failed to update column' },\n }, 500);\n }\n }\n\n // DELETE /api/boards/:id/columns/:columnId - Delete column\n if (updateColumnMatch && method === 'DELETE') {\n const columnId = updateColumnMatch[1];\n try {\n await boardStub.deleteColumn(columnId);\n return jsonResponse({ success: true });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'DELETE_FAILED', message: error instanceof Error ? error.message : 'Failed to delete column' },\n }, 500);\n }\n }\n\n // ============================================\n // TASK ROUTES\n // ============================================\n\n // POST /api/boards/:id/tasks - Create task\n if (subPath === '/tasks' && method === 'POST') {\n const data = await request.json() as { columnId: string; title: string; description?: string; priority?: string; context?: object };\n try {\n const task = await boardStub.createTask({ ...data, boardId });\n return jsonResponse({ success: true, data: task });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'CREATE_FAILED', message: error instanceof Error ? error.message : 'Failed to create task' },\n }, 500);\n }\n }\n\n // GET /api/boards/:id/tasks/:taskId - Get task\n const taskMatch = subPath.match(/^\\/tasks\\/([^/]+)$/);\n if (taskMatch && method === 'GET') {\n const taskId = taskMatch[1];\n try {\n const task = await boardStub.getTask(taskId);\n return jsonResponse({ success: true, data: task });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'Task not found' },\n }, 404);\n }\n }\n\n // PUT /api/boards/:id/tasks/:taskId - Update task\n if (taskMatch && method === 'PUT') {\n const taskId = taskMatch[1];\n const data = await request.json() as { title?: string; description?: string; priority?: string; context?: object; scheduleConfig?: object | null };\n try {\n const task = await boardStub.updateTask(taskId, data);\n return jsonResponse({ success: true, data: task });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'UPDATE_FAILED', message: error instanceof Error ? error.message : 'Failed to update task' },\n }, 500);\n }\n }\n\n // DELETE /api/boards/:id/tasks/:taskId - Delete task\n if (taskMatch && method === 'DELETE') {\n const taskId = taskMatch[1];\n try {\n await boardStub.deleteTask(taskId);\n return jsonResponse({ success: true });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'DELETE_FAILED', message: error instanceof Error ? error.message : 'Failed to delete task' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/tasks/:taskId/move - Move task\n const moveTaskMatch = subPath.match(/^\\/tasks\\/([^/]+)\\/move$/);\n if (moveTaskMatch && method === 'POST') {\n const taskId = moveTaskMatch[1];\n const data = await request.json() as { columnId: string; position: number };\n try {\n const task = await boardStub.moveTask(taskId, data);\n return jsonResponse({ success: true, data: task });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'MOVE_FAILED', message: error instanceof Error ? error.message : 'Failed to move task' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/tasks/:taskId/generate-plan - Generate plan (special handler)\n const generatePlanMatch = subPath.match(/^\\/tasks\\/([^/]+)\\/generate-plan$/);\n if (generatePlanMatch && method === 'POST') {\n return handleGeneratePlan(env, boardStub, boardId, generatePlanMatch[1]);\n }\n\n // GET /api/boards/:id/tasks/:taskId/plan - Get task workflow plan\n const taskPlanMatch = subPath.match(/^\\/tasks\\/([^/]+)\\/plan$/);\n if (taskPlanMatch && method === 'GET') {\n const taskId = taskPlanMatch[1];\n try {\n const plan = await boardStub.getTaskWorkflowPlan(taskId);\n return jsonResponse({ success: true, data: plan });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'Plan not found' },\n }, 404);\n }\n }\n\n // POST /api/boards/:id/tasks/:taskId/plan - Create workflow plan\n if (taskPlanMatch && method === 'POST') {\n const taskId = taskPlanMatch[1];\n const data = await request.json() as { id?: string; summary?: string; generatedCode?: string; steps?: object[] };\n try {\n const plan = await boardStub.createWorkflowPlan(taskId, { ...data, boardId });\n return jsonResponse({ success: true, data: plan });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'CREATE_FAILED', message: error instanceof Error ? error.message : 'Failed to create plan' },\n }, 500);\n }\n }\n\n // ============================================\n // SCHEDULED TASK ROUTES\n // ============================================\n\n // GET /api/boards/:id/scheduled-tasks - Get all scheduled tasks for board\n if (subPath === '/scheduled-tasks' && method === 'GET') {\n try {\n const tasks = await boardStub.getScheduledTasks(boardId);\n return jsonResponse({ success: true, data: tasks });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'FETCH_FAILED', message: error instanceof Error ? error.message : 'Failed to get scheduled tasks' },\n }, 500);\n }\n }\n\n // GET /api/boards/:id/tasks/:taskId/runs - Get scheduled runs for a task\n const taskRunsMatch = subPath.match(/^\\/tasks\\/([^/]+)\\/runs$/);\n if (taskRunsMatch && method === 'GET') {\n const taskId = taskRunsMatch[1];\n const url = new URL(request.url);\n const limit = parseInt(url.searchParams.get('limit') || '10', 10);\n try {\n const runs = await boardStub.getScheduledRuns(taskId, limit);\n return jsonResponse({ success: true, data: runs });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'FETCH_FAILED', message: error instanceof Error ? error.message : 'Failed to get scheduled runs' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/tasks/:taskId/run - Trigger a scheduled run manually\n const triggerRunMatch = subPath.match(/^\\/tasks\\/([^/]+)\\/run$/);\n if (triggerRunMatch && method === 'POST') {\n const taskId = triggerRunMatch[1];\n try {\n const result = await boardStub.triggerScheduledRun(taskId);\n return jsonResponse({ success: true, data: result });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'TRIGGER_FAILED', message: error instanceof Error ? error.message : 'Failed to trigger scheduled run' },\n }, 500);\n }\n }\n\n // GET /api/boards/:id/runs/:runId/tasks - Get child tasks for a scheduled run\n const runTasksMatch = subPath.match(/^\\/runs\\/([^/]+)\\/tasks$/);\n if (runTasksMatch && method === 'GET') {\n const runId = runTasksMatch[1];\n try {\n const tasks = await boardStub.getRunTasks(runId);\n return jsonResponse({ success: true, data: tasks });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'FETCH_FAILED', message: error instanceof Error ? error.message : 'Failed to get run tasks' },\n }, 500);\n }\n }\n\n // DELETE /api/boards/:id/runs/:runId - Delete a scheduled run from history\n const runDeleteMatch = subPath.match(/^\\/runs\\/([^/]+)$/);\n if (runDeleteMatch && method === 'DELETE') {\n const runId = runDeleteMatch[1];\n try {\n await boardStub.deleteScheduledRun(runId);\n return jsonResponse({ success: true });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'DELETE_FAILED', message: error instanceof Error ? error.message : 'Failed to delete run' },\n }, 500);\n }\n }\n\n // GET /api/boards/:id/tasks/:taskId/children - Get child tasks for a parent scheduled task\n const childTasksMatch = subPath.match(/^\\/tasks\\/([^/]+)\\/children$/);\n if (childTasksMatch && method === 'GET') {\n const parentTaskId = childTasksMatch[1];\n try {\n const tasks = await boardStub.getChildTasks(parentTaskId);\n return jsonResponse({ success: true, data: tasks });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'FETCH_FAILED', message: error instanceof Error ? error.message : 'Failed to get child tasks' },\n }, 500);\n }\n }\n\n // ============================================\n // WORKFLOW PLAN ROUTES\n // ============================================\n\n // GET /api/boards/:id/workflow-plans - Get all workflow plans for board\n if (subPath === '/workflow-plans' && method === 'GET') {\n try {\n const plans = await boardStub.getBoardWorkflowPlans(boardId);\n return jsonResponse({ success: true, data: plans });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'FETCH_FAILED', message: error instanceof Error ? error.message : 'Failed to get workflow plans' },\n }, 500);\n }\n }\n\n // GET /api/boards/:id/plans/:planId - Get workflow plan\n const planMatch = subPath.match(/^\\/plans\\/([^/]+)$/);\n if (planMatch && method === 'GET') {\n const planId = planMatch[1];\n try {\n const plan = await boardStub.getWorkflowPlan(planId);\n return jsonResponse({ success: true, data: plan });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'Plan not found' },\n }, 404);\n }\n }\n\n // PUT /api/boards/:id/plans/:planId - Update workflow plan\n if (planMatch && method === 'PUT') {\n const planId = planMatch[1];\n const data = await request.json() as { status?: string; summary?: string; generatedCode?: string; steps?: object[]; currentStepIndex?: number; checkpointData?: object; result?: object };\n try {\n const plan = await boardStub.updateWorkflowPlan(planId, data);\n return jsonResponse({ success: true, data: plan });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'UPDATE_FAILED', message: error instanceof Error ? error.message : 'Failed to update plan' },\n }, 500);\n }\n }\n\n // DELETE /api/boards/:id/plans/:planId - Delete workflow plan\n if (planMatch && method === 'DELETE') {\n const planId = planMatch[1];\n try {\n await boardStub.deleteWorkflowPlan(planId);\n return jsonResponse({ success: true });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'DELETE_FAILED', message: error instanceof Error ? error.message : 'Failed to delete plan' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/plans/:planId/approve - Approve workflow plan\n const approvePlanMatch = subPath.match(/^\\/plans\\/([^/]+)\\/approve$/);\n if (approvePlanMatch && method === 'POST') {\n const planId = approvePlanMatch[1];\n try {\n const plan = await boardStub.approveWorkflowPlan(planId);\n return jsonResponse({ success: true, data: plan });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'APPROVE_FAILED', message: error instanceof Error ? error.message : 'Failed to approve plan' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/plans/:planId/checkpoint - Resolve checkpoint\n const checkpointMatch = subPath.match(/^\\/plans\\/([^/]+)\\/checkpoint$/);\n if (checkpointMatch && method === 'POST') {\n return handleResolveCheckpoint(request, env, boardStub, boardId, checkpointMatch[1]);\n }\n\n // POST /api/boards/:id/plans/:planId/cancel - Cancel workflow\n const cancelMatch = subPath.match(/^\\/plans\\/([^/]+)\\/cancel$/);\n if (cancelMatch && method === 'POST') {\n return handleCancelWorkflow(env, boardStub, boardId, cancelMatch[1]);\n }\n\n // GET /api/boards/:id/plans/:planId/logs - Get workflow logs\n const logsMatch = subPath.match(/^\\/plans\\/([^/]+)\\/logs$/);\n if (logsMatch && method === 'GET') {\n const planId = logsMatch[1];\n const url = new URL(request.url);\n const limit = url.searchParams.get('limit') ? parseInt(url.searchParams.get('limit')!) : undefined;\n const offset = url.searchParams.get('offset') ? parseInt(url.searchParams.get('offset')!) : undefined;\n try {\n const logs = await boardStub.getWorkflowLogs(planId, limit, offset);\n return jsonResponse({ success: true, data: logs });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'Logs not found' },\n }, 404);\n }\n }\n\n // ============================================\n // CREDENTIAL ROUTES\n // ============================================\n\n // GET /api/boards/:id/credentials - Get credentials\n if (subPath === '/credentials' && method === 'GET') {\n try {\n const credentials = await boardStub.getCredentials(boardId);\n return jsonResponse({ success: true, data: credentials });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'Failed to get credentials' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/credentials - Create credential\n if (subPath === '/credentials' && method === 'POST') {\n const data = await request.json() as { type: string; name: string; value: string; metadata?: object };\n try {\n const credential = await boardStub.createCredential(boardId, data);\n return jsonResponse({ success: true, data: credential });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'CREATE_FAILED', message: error instanceof Error ? error.message : 'Failed to create credential' },\n }, 500);\n }\n }\n\n // GET /api/boards/:id/credentials/type/:type/value - Get credential value\n const credentialValueMatch = subPath.match(/^\\/credentials\\/type\\/([^/]+)\\/value$/);\n if (credentialValueMatch && method === 'GET') {\n const type = credentialValueMatch[1];\n try {\n const value = await boardStub.getCredentialValue(boardId, type);\n return jsonResponse({ success: true, data: { value } });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'Credential not found' },\n }, 404);\n }\n }\n\n // GET /api/boards/:id/credentials/type/:type/full - Get credential with metadata\n const credentialFullMatch = subPath.match(/^\\/credentials\\/type\\/([^/]+)\\/full$/);\n if (credentialFullMatch && method === 'GET') {\n const type = credentialFullMatch[1];\n try {\n const data = await boardStub.getCredentialFull(boardId, type);\n return jsonResponse({ success: true, data });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'Credential not found' },\n }, 404);\n }\n }\n\n // PUT /api/boards/:id/credentials/type/:type - Update credential value\n const credentialTypeMatch = subPath.match(/^\\/credentials\\/type\\/([^/]+)$/);\n if (credentialTypeMatch && method === 'PUT') {\n const type = credentialTypeMatch[1];\n const data = await request.json() as { value: string; metadata?: Record };\n try {\n const result = await boardStub.updateCredentialValue(boardId, type, data.value, data.metadata);\n return jsonResponse({ success: true, data: result });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'UPDATE_FAILED', message: error instanceof Error ? error.message : 'Failed to update credential' },\n }, 500);\n }\n }\n\n // DELETE /api/boards/:id/credentials/:credentialId - Delete credential\n const deleteCredentialMatch = subPath.match(/^\\/credentials\\/([^/]+)$/);\n if (deleteCredentialMatch && method === 'DELETE') {\n const credentialId = deleteCredentialMatch[1];\n try {\n await boardStub.deleteCredential(boardId, credentialId);\n return jsonResponse({ success: true });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'DELETE_FAILED', message: error instanceof Error ? error.message : 'Failed to delete credential' },\n }, 500);\n }\n }\n\n // ============================================\n // MCP SERVER ROUTES\n // ============================================\n\n // GET /api/boards/:id/mcp-servers - Get MCP servers\n if (subPath === '/mcp-servers' && method === 'GET') {\n try {\n const servers = await boardStub.getMCPServers(boardId);\n return jsonResponse({ success: true, data: servers });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'Failed to get MCP servers' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/mcp-servers - Create MCP server\n if (subPath === '/mcp-servers' && method === 'POST') {\n const data = await request.json() as {\n name: string;\n type: 'remote' | 'hosted';\n endpoint?: string;\n authType?: string;\n credentialId?: string;\n status?: string;\n transportType?: 'streamable-http' | 'sse';\n urlPatterns?: Array<{ pattern: string; type: string; fetchTool: string }>;\n };\n try {\n const server = await boardStub.createMCPServer(boardId, data);\n return jsonResponse({ success: true, data: server });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'CREATE_FAILED', message: error instanceof Error ? error.message : 'Failed to create MCP server' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/mcp-servers/account - Create account-based MCP\n if (subPath === '/mcp-servers/account' && method === 'POST') {\n const data = await request.json() as { accountId: string; mcpId: string };\n try {\n const server = await boardStub.createAccountMCP(boardId, data);\n return jsonResponse({ success: true, data: server });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'CREATE_FAILED', message: error instanceof Error ? error.message : 'Failed to create account MCP' },\n }, 500);\n }\n }\n\n // GET /api/boards/:id/mcp-servers/:serverId - Get MCP server\n const mcpServerMatch = subPath.match(/^\\/mcp-servers\\/([^/]+)$/);\n if (mcpServerMatch && method === 'GET') {\n const serverId = mcpServerMatch[1];\n try {\n const server = await boardStub.getMCPServer(serverId);\n return jsonResponse({ success: true, data: server });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'MCP server not found' },\n }, 404);\n }\n }\n\n // PUT /api/boards/:id/mcp-servers/:serverId - Update MCP server\n if (mcpServerMatch && method === 'PUT') {\n const serverId = mcpServerMatch[1];\n const data = await request.json() as {\n name?: string;\n endpoint?: string;\n authType?: string;\n credentialId?: string;\n enabled?: boolean;\n status?: string;\n transportType?: 'streamable-http' | 'sse';\n };\n try {\n const server = await boardStub.updateMCPServer(serverId, data);\n return jsonResponse({ success: true, data: server });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'UPDATE_FAILED', message: error instanceof Error ? error.message : 'Failed to update MCP server' },\n }, 500);\n }\n }\n\n // DELETE /api/boards/:id/mcp-servers/:serverId - Delete MCP server\n if (mcpServerMatch && method === 'DELETE') {\n const serverId = mcpServerMatch[1];\n try {\n await boardStub.deleteMCPServer(serverId);\n return jsonResponse({ success: true });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'DELETE_FAILED', message: error instanceof Error ? error.message : 'Failed to delete MCP server' },\n }, 500);\n }\n }\n\n // GET /api/boards/:id/mcp-servers/:serverId/tools - Get MCP server tools\n const mcpToolsMatch = subPath.match(/^\\/mcp-servers\\/([^/]+)\\/tools$/);\n if (mcpToolsMatch && method === 'GET') {\n const serverId = mcpToolsMatch[1];\n try {\n const tools = await boardStub.getMCPServerTools(serverId);\n return jsonResponse({ success: true, data: tools });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: error instanceof Error ? error.message : 'Failed to get MCP tools' },\n }, 500);\n }\n }\n\n // PUT/POST /api/boards/:id/mcp-servers/:serverId/tools - Cache MCP server tools\n if (mcpToolsMatch && (method === 'PUT' || method === 'POST')) {\n const serverId = mcpToolsMatch[1];\n const data = await request.json() as {\n tools: Array<{\n name: string;\n description?: string;\n inputSchema: object;\n approvalRequiredFields?: string[];\n }>;\n };\n try {\n const tools = await boardStub.cacheMCPServerTools(serverId, data);\n return jsonResponse({ success: true, data: tools });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'CACHE_FAILED', message: error instanceof Error ? error.message : 'Failed to cache MCP tools' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/mcp-servers/:serverId/connect - Connect MCP server\n const mcpConnectMatch = subPath.match(/^\\/mcp-servers\\/([^/]+)\\/connect$/);\n if (mcpConnectMatch && method === 'POST') {\n const serverId = mcpConnectMatch[1];\n try {\n const result = await boardStub.connectMCPServer(serverId);\n return jsonResponse({ success: true, data: result });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'CONNECT_FAILED', message: error instanceof Error ? error.message : 'Failed to connect MCP server' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/mcp-servers/:serverId/oauth/discover - Discover OAuth\n const mcpOAuthDiscoverMatch = subPath.match(/^\\/mcp-servers\\/([^/]+)\\/oauth\\/discover$/);\n if (mcpOAuthDiscoverMatch && method === 'POST') {\n const serverId = mcpOAuthDiscoverMatch[1];\n try {\n const result = await boardStub.discoverMCPOAuth(serverId);\n return jsonResponse({ success: true, data: result });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'DISCOVER_FAILED', message: error instanceof Error ? error.message : 'OAuth discovery failed' },\n }, 500);\n }\n }\n\n // GET /api/boards/:id/mcp-servers/:serverId/oauth/url - Get OAuth URL\n const mcpOAuthUrlMatch = subPath.match(/^\\/mcp-servers\\/([^/]+)\\/oauth\\/url$/);\n if (mcpOAuthUrlMatch && method === 'GET') {\n const serverId = mcpOAuthUrlMatch[1];\n const url = new URL(request.url);\n const redirectUri = url.searchParams.get('redirectUri');\n if (!redirectUri) {\n return jsonResponse({\n success: false,\n error: { code: 'BAD_REQUEST', message: 'redirectUri is required' },\n }, 400);\n }\n try {\n const result = await boardStub.getMCPOAuthUrl(serverId, redirectUri);\n return jsonResponse({ success: true, data: result });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'URL_FAILED', message: error instanceof Error ? error.message : 'Failed to get OAuth URL' },\n }, 500);\n }\n }\n\n // POST /api/boards/:id/mcp-servers/:serverId/oauth/exchange - Exchange OAuth code\n const mcpOAuthExchangeMatch = subPath.match(/^\\/mcp-servers\\/([^/]+)\\/oauth\\/exchange$/);\n if (mcpOAuthExchangeMatch && method === 'POST') {\n const serverId = mcpOAuthExchangeMatch[1];\n const data = await request.json() as { code: string; state: string; redirectUri: string };\n try {\n const result = await boardStub.exchangeMCPOAuthCode(serverId, data);\n return jsonResponse({ success: true, data: result });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'EXCHANGE_FAILED', message: error instanceof Error ? error.message : 'OAuth exchange failed' },\n }, 500);\n }\n }\n\n // ============================================\n // GITHUB ROUTES\n // ============================================\n\n // GET /api/boards/:id/github/repos - Get GitHub repos\n if (subPath === '/github/repos' && method === 'GET') {\n try {\n const repos = await boardStub.getGitHubRepos(boardId);\n return jsonResponse({ success: true, data: repos });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'FETCH_FAILED', message: error instanceof Error ? error.message : 'Failed to get GitHub repos' },\n }, 500);\n }\n }\n\n // ============================================\n // LINK METADATA ROUTES\n // ============================================\n\n // POST /api/boards/:id/links/metadata - Get link metadata\n if (subPath === '/links/metadata' && method === 'POST') {\n const data = await request.json() as { url: string };\n try {\n const metadata = await boardStub.getLinkMetadata(boardId, data);\n return jsonResponse({ success: true, data: metadata });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'FETCH_FAILED', message: error instanceof Error ? error.message : 'Failed to get link metadata' },\n }, 500);\n }\n }\n\n return jsonResponse({ error: 'Not found' }, 404);\n}\n" }, { "path": "worker/handlers/oauth.ts", "content": "/**\n * OAuth handlers for GitHub and Google\n */\n\nimport {\n getOAuthUrl as getGitHubOAuthUrl,\n exchangeCodeForToken as exchangeGitHubCode,\n getUser as getGitHubUser,\n generateState,\n} from '../github/oauth';\nimport {\n getOAuthUrl as getGoogleOAuthUrl,\n exchangeCodeForToken as exchangeGoogleCode,\n getUserInfo as getGoogleUser,\n} from '../google/oauth';\nimport { getAccountByCredentialType, getMCPTools } from '../mcp/AccountMCPRegistry';\nimport { encodeOAuthState, decodeOAuthState } from '../utils/oauth-state';\nimport { jsonResponse } from '../utils/response';\nimport { CREDENTIAL_TYPES } from '../constants';\nimport { logger } from '../utils/logger';\nimport type { BoardDO } from '../BoardDO';\n\ntype BoardDOStub = DurableObjectStub;\n\n// ============================================\n// PROVIDER CONFIGS\n// ============================================\n\ninterface OAuthProvider {\n name: 'github' | 'google';\n credentialType: string;\n getClientId: (env: Env) => string | undefined;\n getClientSecret: (env: Env) => string | undefined;\n getOAuthUrl: (clientId: string, redirectUri: string, state: string) => string;\n exchangeCode: (code: string, clientId: string, clientSecret: string, redirectUri: string) => Promise;\n getUser: (token: string) => Promise;\n buildCredential: (user: OAuthUserData, tokenData: OAuthTokenData) => {\n name: string;\n metadata: Record;\n };\n callbackPath: string;\n}\n\ninterface OAuthTokenData {\n access_token: string;\n scope?: string;\n refresh_token?: string;\n expires_in?: number;\n}\n\ninterface OAuthUserData {\n id: string | number;\n login?: string;\n email?: string;\n name?: string | null;\n picture?: string;\n}\n\nconst githubProvider: OAuthProvider = {\n name: 'github',\n credentialType: CREDENTIAL_TYPES.GITHUB_OAUTH,\n getClientId: (env) => env.GITHUB_CLIENT_ID,\n getClientSecret: (env) => env.GITHUB_CLIENT_SECRET,\n getOAuthUrl: getGitHubOAuthUrl,\n exchangeCode: exchangeGitHubCode,\n getUser: getGitHubUser,\n buildCredential: (user, tokenData) => ({\n name: `GitHub: ${user.login}`,\n metadata: {\n login: user.login,\n userId: user.id,\n scope: tokenData.scope,\n },\n }),\n callbackPath: '/github/callback',\n};\n\nconst googleProvider: OAuthProvider = {\n name: 'google',\n credentialType: CREDENTIAL_TYPES.GOOGLE_OAUTH,\n getClientId: (env) => env.GOOGLE_CLIENT_ID,\n getClientSecret: (env) => env.GOOGLE_CLIENT_SECRET,\n getOAuthUrl: getGoogleOAuthUrl,\n exchangeCode: exchangeGoogleCode,\n getUser: getGoogleUser,\n buildCredential: (user, tokenData) => ({\n name: `Google: ${user.email}`,\n metadata: {\n email: user.email,\n userId: user.id,\n name: user.name,\n picture: user.picture,\n scope: tokenData.scope,\n refresh_token: tokenData.refresh_token,\n expires_in: tokenData.expires_in,\n expires_at: new Date(Date.now() + (tokenData.expires_in || 3600) * 1000).toISOString(),\n },\n }),\n callbackPath: '/google/callback',\n};\n\n// ============================================\n// GENERIC OAUTH HANDLERS\n// ============================================\n\nasync function handleOAuthUrl(\n request: Request,\n env: Env,\n url: URL,\n provider: OAuthProvider\n): Promise {\n if (request.method !== 'GET') {\n return jsonResponse({ success: false, error: { code: '405', message: 'Method not allowed' } }, 405);\n }\n\n const clientId = provider.getClientId(env);\n if (!clientId) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_CONFIGURED', message: `${provider.name} OAuth not configured` },\n }, 500);\n }\n\n const boardId = url.searchParams.get('boardId');\n if (!boardId) {\n return jsonResponse({\n success: false,\n error: { code: 'BAD_REQUEST', message: 'boardId is required' },\n }, 400);\n }\n\n const redirectUri = `${url.origin}${provider.callbackPath}`;\n const signedState = await encodeOAuthState(\n { boardId, nonce: generateState() },\n env.ENCRYPTION_KEY\n );\n\n const authUrl = provider.getOAuthUrl(clientId, redirectUri, signedState);\n\n return jsonResponse({\n success: true,\n data: { url: authUrl },\n });\n}\n\nasync function handleOAuthExchange(\n env: Env,\n url: URL,\n provider: OAuthProvider\n): Promise {\n const code = url.searchParams.get('code');\n const stateParam = url.searchParams.get('state');\n\n if (!code || !stateParam) {\n return jsonResponse({\n success: false,\n error: { code: 'BAD_REQUEST', message: 'Missing code or state parameter' },\n }, 400);\n }\n\n const clientId = provider.getClientId(env);\n const clientSecret = provider.getClientSecret(env);\n\n if (!clientId || !clientSecret) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_CONFIGURED', message: `${provider.name} OAuth not configured` },\n }, 500);\n }\n\n try {\n const state = await decodeOAuthState(stateParam, env.ENCRYPTION_KEY);\n if (!state) {\n return jsonResponse({\n success: false,\n error: { code: 'INVALID_STATE', message: 'Invalid or expired state parameter' },\n }, 400);\n }\n\n const { boardId } = state;\n const redirectUri = `${url.origin}${provider.callbackPath}`;\n\n const tokenData = await provider.exchangeCode(code, clientId, clientSecret, redirectUri);\n const user = await provider.getUser(tokenData.access_token);\n\n // Store credential and create MCP servers\n await storeCredentialAndCreateMCPs(env, boardId, provider, user, tokenData);\n\n return jsonResponse({\n success: true,\n data: { boardId },\n });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: {\n code: 'OAUTH_FAILED',\n message: error instanceof Error ? error.message : 'OAuth failed',\n },\n }, 500);\n }\n}\n\nasync function storeCredentialAndCreateMCPs(\n env: Env,\n boardId: string,\n provider: OAuthProvider,\n user: OAuthUserData,\n tokenData: OAuthTokenData\n): Promise {\n const doId = env.BOARD_DO.idFromName(boardId);\n const stub = env.BOARD_DO.get(doId) as BoardDOStub;\n\n const credentialData = provider.buildCredential(user, tokenData);\n\n // Check if credential already exists (re-authentication case)\n const existingCredentialId = await stub.findCredentialId(boardId, provider.credentialType);\n\n if (existingCredentialId) {\n await stub.updateCredentialValue(\n boardId,\n provider.credentialType,\n tokenData.access_token,\n credentialData.metadata\n );\n } else {\n const credential = await stub.createCredential(boardId, {\n type: provider.credentialType,\n name: credentialData.name,\n value: tokenData.access_token,\n metadata: credentialData.metadata,\n });\n\n if (!credential.id) return;\n }\n\n // Always ensure MCP servers exist (handles both new and re-auth cases)\n await ensureMCPServersExist(stub, boardId, provider);\n}\n\n/**\n * Ensure MCP servers exist for the account (handles both new and re-auth cases)\n * If MCPs already exist, this is a no-op. If not, creates them.\n */\nasync function ensureMCPServersExist(\n stub: BoardDOStub,\n boardId: string,\n provider: OAuthProvider\n): Promise {\n const account = getAccountByCredentialType(provider.credentialType);\n if (!account) {\n logger.auth.warn('No account found for credential type', { credentialType: provider.credentialType });\n return;\n }\n\n const existingServers = await stub.getMCPServers(boardId);\n const existingMcpIds = new Set(\n existingServers\n .filter(s => s.name && account.mcps.some(m => m.name === s.name))\n .map(s => s.name)\n );\n\n for (const mcp of account.mcps) {\n if (existingMcpIds.has(mcp.name)) {\n logger.auth.debug('MCP already exists', { mcpName: mcp.name, boardId });\n continue;\n }\n\n try {\n const server = await stub.createAccountMCP(boardId, {\n accountId: account.id,\n mcpId: mcp.id,\n });\n\n const tools = getMCPTools(account.id, mcp.id);\n if (tools.length > 0 && server.id) {\n await stub.cacheMCPServerTools(server.id, { tools });\n }\n\n logger.auth.info('Created MCP server', { mcpName: mcp.name, mcpId: mcp.id, boardId });\n } catch (error) {\n logger.auth.warn('Failed to create MCP server', {\n mcpName: mcp.name,\n mcpId: mcp.id,\n boardId,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n }\n}\n\n// ============================================\n// EXPORTED HANDLERS\n// ============================================\n\nexport function handleGitHubOAuthUrl(request: Request, env: Env, url: URL): Promise {\n return handleOAuthUrl(request, env, url, githubProvider);\n}\n\nexport function handleGitHubOAuthExchange(_request: Request, env: Env, url: URL): Promise {\n return handleOAuthExchange(env, url, githubProvider);\n}\n\nexport async function handleGitHubOAuthCallback(\n request: Request,\n env: Env,\n url: URL\n): Promise {\n if (request.method !== 'GET') {\n return jsonResponse({ success: false, error: { code: '405', message: 'Method not allowed' } }, 405);\n }\n\n const code = url.searchParams.get('code');\n const stateParam = url.searchParams.get('state');\n\n if (!code || !stateParam) {\n return redirectWithError(url.origin, 'Missing code or state parameter');\n }\n\n const clientId = githubProvider.getClientId(env);\n const clientSecret = githubProvider.getClientSecret(env);\n\n if (!clientId || !clientSecret) {\n return redirectWithError(url.origin, 'GitHub OAuth not configured');\n }\n\n try {\n const state = await decodeOAuthState(stateParam, env.ENCRYPTION_KEY);\n if (!state) {\n return redirectWithError(url.origin, 'Invalid or expired state parameter');\n }\n\n const { boardId } = state;\n const redirectUri = `${url.origin}/api/github/oauth/callback`;\n\n const tokenData = await githubProvider.exchangeCode(code, clientId, clientSecret, redirectUri);\n const user = await githubProvider.getUser(tokenData.access_token);\n\n await storeCredentialAndCreateMCPs(env, boardId, githubProvider, user, tokenData);\n\n return new Response(null, {\n status: 302,\n headers: {\n Location: `${url.origin}/board/${boardId}?github=connected`,\n },\n });\n } catch (error) {\n return redirectWithError(\n url.origin,\n error instanceof Error ? error.message : 'OAuth failed'\n );\n }\n}\n\nexport function handleGoogleOAuthUrl(request: Request, env: Env, url: URL): Promise {\n return handleOAuthUrl(request, env, url, googleProvider);\n}\n\nexport function handleGoogleOAuthExchange(_request: Request, env: Env, url: URL): Promise {\n return handleOAuthExchange(env, url, googleProvider);\n}\n\nfunction redirectWithError(origin: string, error: string): Response {\n const errorUrl = new URL(origin);\n errorUrl.searchParams.set('github_error', error);\n return new Response(null, {\n status: 302,\n headers: { Location: errorUrl.toString() },\n });\n}\n" }, { "path": "worker/handlers/workflows.ts", "content": "/**\n * Workflow handlers for plan generation, checkpoints, and cancellation\n */\n\nimport { type AgentWorkflowParams } from '../workflows/AgentWorkflow';\nimport { jsonResponse } from '../utils/response';\nimport { logger } from '../utils/logger';\nimport type { BoardDO } from '../BoardDO';\n\ntype BoardDOStub = DurableObjectStub;\n\n/**\n * Handle generate-plan request - starts agent workflow for a task\n */\nexport async function handleGeneratePlan(\n env: Env,\n boardStub: BoardDOStub,\n boardId: string,\n taskId: string\n): Promise {\n if (!env.AGENT_WORKFLOW) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_CONFIGURED', message: 'Agent workflow not configured' },\n }, 500);\n }\n\n // Get the task details\n let task: { id: string; boardId: string; title: string; description?: string | null };\n try {\n task = await boardStub.getTask(taskId);\n } catch {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: 'Task not found' },\n }, 404);\n }\n\n // Create a plan record with status 'executing' (skip planning/draft)\n const planId = crypto.randomUUID();\n\n try {\n await boardStub.createWorkflowPlan(taskId, {\n id: planId,\n boardId,\n // status is set to 'executing' by default\n });\n } catch {\n return jsonResponse({\n success: false,\n error: { code: 'CREATE_FAILED', message: 'Failed to create plan record' },\n }, 500);\n }\n\n // Combine task title and description for agent\n const taskDescription = [task.title, task.description].filter(Boolean).join('\\n\\n') || 'No task description provided';\n\n // Start the agent workflow directly\n try {\n const workflowParams: AgentWorkflowParams = {\n planId,\n taskId,\n boardId,\n taskDescription,\n };\n\n await env.AGENT_WORKFLOW.create({\n id: planId,\n params: workflowParams,\n });\n\n // Fetch and return the full plan\n const plan = await boardStub.getWorkflowPlan(planId);\n return jsonResponse({ success: true, data: plan });\n } catch (error) {\n await boardStub.updateWorkflowPlan(planId, {\n status: 'failed',\n result: { error: error instanceof Error ? error.message : 'Failed to start agent' },\n });\n return jsonResponse({\n success: false,\n error: { code: 'WORKFLOW_FAILED', message: 'Failed to start agent workflow' },\n }, 500);\n }\n}\n\n/**\n * Handle resolve checkpoint request - resumes workflow after user approval\n */\nexport async function handleResolveCheckpoint(\n request: Request,\n env: Env,\n boardStub: BoardDOStub,\n _boardId: string,\n planId: string\n): Promise {\n if (!env.AGENT_WORKFLOW) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_CONFIGURED', message: 'Agent workflow not configured' },\n }, 500);\n }\n\n // Get the plan\n let plan: { id: string; taskId: string; boardId: string; status: string };\n try {\n plan = await boardStub.getWorkflowPlan(planId);\n } catch {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: 'Plan not found' },\n }, 404);\n }\n\n // Parse the checkpoint resolution data\n const body = await request.json() as {\n action: string;\n data?: Record;\n feedback?: string;\n };\n\n if (plan.status !== 'checkpoint') {\n return jsonResponse({\n success: false,\n error: { code: 'INVALID_STATE', message: 'Workflow is not at a checkpoint' },\n }, 400);\n }\n\n // If cancelling (or legacy reject), just update the status and don't resume workflow\n if (body.action === 'cancel' || body.action === 'reject') {\n await boardStub.updateWorkflowPlan(planId, { status: 'failed', result: { error: 'Checkpoint cancelled by user' } });\n\n const updatedPlan = await boardStub.getWorkflowPlan(planId);\n return jsonResponse({ success: true, data: updatedPlan });\n }\n\n // For approve or request_changes, send event to resume the waiting workflow\n try {\n const instance = await env.AGENT_WORKFLOW.get(planId);\n await instance.sendEvent({\n type: 'checkpoint-approval',\n payload: {\n action: body.action,\n feedback: body.feedback,\n dataJson: body.data ? JSON.stringify(body.data) : undefined,\n },\n });\n\n // Allow the workflow to process\n await new Promise(resolve => setTimeout(resolve, 100));\n\n // Return updated plan\n const updatedPlan = await boardStub.getWorkflowPlan(planId);\n return jsonResponse({ success: true, data: updatedPlan });\n\n } catch (error) {\n logger.workflow.error('Failed to resume workflow', { planId, error: error instanceof Error ? error.message : String(error) });\n await boardStub.updateWorkflowPlan(planId, {\n status: 'failed',\n result: { error: error instanceof Error ? error.message : 'Failed to resume workflow' },\n });\n return jsonResponse({\n success: false,\n error: { code: 'WORKFLOW_FAILED', message: 'Failed to resume workflow' },\n }, 500);\n }\n}\n\n/**\n * Handle cancel workflow request - terminates running workflow\n */\nexport async function handleCancelWorkflow(\n env: Env,\n boardStub: BoardDOStub,\n _boardId: string,\n planId: string\n): Promise {\n if (!env.AGENT_WORKFLOW) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_CONFIGURED', message: 'Agent workflow not configured' },\n }, 500);\n }\n\n // Get the plan\n let plan: { id: string; status: string };\n try {\n plan = await boardStub.getWorkflowPlan(planId);\n } catch {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: 'Plan not found' },\n }, 404);\n }\n\n // Only allow cancelling running or checkpoint workflows\n if (plan.status !== 'executing' && plan.status !== 'checkpoint') {\n return jsonResponse({\n success: false,\n error: { code: 'INVALID_STATUS', message: `Cannot cancel plan with status: ${plan.status}` },\n }, 400);\n }\n\n try {\n const instance = await env.AGENT_WORKFLOW.get(planId);\n await instance.terminate();\n } catch (error) {\n logger.workflow.warn('Workflow terminate error (may be expected)', { planId, error: error instanceof Error ? error.message : String(error) });\n }\n\n // Update plan status to cancelled\n await boardStub.updateWorkflowPlan(planId, {\n status: 'failed',\n result: { error: 'Cancelled by user' },\n });\n\n // Return updated plan\n const updatedPlan = await boardStub.getWorkflowPlan(planId);\n return jsonResponse({ success: true, data: updatedPlan });\n}\n" }, { "path": "worker/index.ts", "content": "/**\n * Cloudflare Worker entry point - thin dispatcher\n */\n\nimport { Sandbox } from '@cloudflare/sandbox';\nimport { AgentWorkflow } from './workflows/AgentWorkflow';\nimport { getAuthenticatedUser, getLogoutUrl, type AuthEnv } from './auth';\nimport { jsonResponse } from './utils/response';\nimport { logger } from './utils/logger';\nimport {\n handleGitHubOAuthUrl,\n handleGitHubOAuthExchange,\n handleGitHubOAuthCallback,\n handleGoogleOAuthUrl,\n handleGoogleOAuthExchange,\n} from './handlers/oauth';\nimport { routeBoardRequest } from './handlers/boards';\nimport type { BoardDO } from './BoardDO';\nimport type { UserDO } from './UserDO';\n\nexport { BoardDO } from './BoardDO';\nexport { UserDO } from './UserDO';\nexport { Sandbox };\nexport { AgentWorkflow };\n\n// Type for DO stubs with RPC methods\ntype BoardDOStub = DurableObjectStub;\ntype UserDOStub = DurableObjectStub;\n\nexport default {\n async fetch(request: Request, env: Env, _ctx: ExecutionContext): Promise {\n const url = new URL(request.url);\n\n logger.worker.debug('Incoming request', { method: request.method, path: url.pathname });\n\n // ============================================\n // PUBLIC ROUTES (no auth required)\n // ============================================\n\n // GitHub OAuth routes\n if (url.pathname === '/api/github/oauth/url') {\n return handleGitHubOAuthUrl(request, env, url);\n }\n\n if (url.pathname === '/api/github/oauth/exchange') {\n return handleGitHubOAuthExchange(request, env, url);\n }\n\n // Legacy callback route (for direct browser navigation)\n if (url.pathname === '/api/github/oauth/callback') {\n return handleGitHubOAuthCallback(request, env, url);\n }\n\n // Google OAuth routes\n if (url.pathname === '/api/google/oauth/url') {\n return handleGoogleOAuthUrl(request, env, url);\n }\n\n if (url.pathname === '/api/google/oauth/exchange') {\n return handleGoogleOAuthExchange(request, env, url);\n }\n\n // ============================================\n // PROTECTED ROUTES (auth required)\n // ============================================\n\n if (url.pathname.startsWith('/api/')) {\n // Authenticate user\n const user = await getAuthenticatedUser(request, env as unknown as AuthEnv);\n if (!user) {\n return jsonResponse({\n success: false,\n error: { code: 'UNAUTHORIZED', message: 'Authentication required' },\n }, 401);\n }\n\n // Get UserDO stub with RPC\n const userDoId = env.USER_DO.idFromName(user.id);\n const userStub = env.USER_DO.get(userDoId) as UserDOStub;\n\n // Initialize user in UserDO (creates if new, updates email if changed)\n await userStub.initUser(user.id, user.email);\n\n // GET /api/me - Return current user info\n if (url.pathname === '/api/me' && request.method === 'GET') {\n return jsonResponse({\n success: true,\n data: {\n id: user.id,\n email: user.email,\n logoutUrl: (env as AuthEnv).AUTH_MODE === 'access' && (env as AuthEnv).ACCESS_TEAM ? getLogoutUrl((env as AuthEnv).ACCESS_TEAM!) : null,\n },\n });\n }\n\n // GET /api/boards - List user's boards (from UserDO)\n if (url.pathname === '/api/boards' && request.method === 'GET') {\n const boards = await userStub.getBoards();\n return jsonResponse({ success: true, data: boards });\n }\n\n // POST /api/boards - Create a new board\n if (url.pathname === '/api/boards' && request.method === 'POST') {\n const data = await request.json() as { name: string };\n const boardId = crypto.randomUUID();\n\n // Initialize BoardDO for this board\n const boardDoId = env.BOARD_DO.idFromName(boardId);\n const boardStub = env.BOARD_DO.get(boardDoId) as BoardDOStub;\n\n try {\n const board = await boardStub.initBoard({ id: boardId, name: data.name, ownerId: user.id });\n // Add board to user's list\n await userStub.addBoard(boardId, data.name, 'owner');\n return jsonResponse({ success: true, data: board });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'INIT_FAILED', message: error instanceof Error ? error.message : 'Failed to create board' },\n }, 500);\n }\n }\n\n // Board-specific routes - extract boardId and verify access\n const boardMatch = url.pathname.match(/^\\/api\\/boards\\/([^/]+)(\\/.*)?$/);\n if (boardMatch) {\n const boardId = boardMatch[1];\n const subPath = boardMatch[2] || '';\n\n // Check user has access to this board\n const accessResult = await userStub.hasAccess(boardId);\n\n if (!accessResult.hasAccess) {\n return jsonResponse({\n success: false,\n error: { code: 'FORBIDDEN', message: 'Access denied to this board' },\n }, 403);\n }\n\n // Get BoardDO stub with RPC\n const boardDoId = env.BOARD_DO.idFromName(boardId);\n const boardStub = env.BOARD_DO.get(boardDoId) as BoardDOStub;\n\n // Route to board handler\n return routeBoardRequest(request, boardStub, userStub, boardId, subPath, env, user);\n }\n\n // WebSocket upgrade route - forward to BoardDO (still uses fetch)\n if (url.pathname === '/api/ws' && request.headers.get('Upgrade') === 'websocket') {\n const boardId = url.searchParams.get('boardId');\n if (!boardId) {\n return jsonResponse({\n success: false,\n error: { code: 'BAD_REQUEST', message: 'boardId is required for WebSocket' },\n }, 400);\n }\n\n // Check access\n const accessResult = await userStub.hasAccess(boardId);\n\n if (!accessResult.hasAccess) {\n return jsonResponse({\n success: false,\n error: { code: 'FORBIDDEN', message: 'Access denied to this board' },\n }, 403);\n }\n\n const boardDoId = env.BOARD_DO.idFromName(boardId);\n const boardStub = env.BOARD_DO.get(boardDoId);\n\n const doUrl = new URL(request.url);\n doUrl.pathname = '/ws';\n\n // WebSocket upgrade requires fetch (can't use RPC)\n return boardStub.fetch(new Request(doUrl.toString(), {\n method: request.method,\n headers: request.headers,\n }));\n }\n\n // POST /api/tasks - Create task (boardId in body)\n if (url.pathname === '/api/tasks' && request.method === 'POST') {\n const body = await request.json() as { boardId: string; columnId: string; title: string; description?: string; priority?: string; context?: object };\n if (!body.boardId) {\n return jsonResponse({\n success: false,\n error: { code: 'BAD_REQUEST', message: 'boardId is required' },\n }, 400);\n }\n\n // Verify user has access to this board\n const accessResult = await userStub.hasAccess(body.boardId);\n\n if (!accessResult.hasAccess) {\n return jsonResponse({\n success: false,\n error: { code: 'FORBIDDEN', message: 'Access denied to this board' },\n }, 403);\n }\n\n // Route to the correct BoardDO\n const boardDoId = env.BOARD_DO.idFromName(body.boardId);\n const boardStub = env.BOARD_DO.get(boardDoId) as BoardDOStub;\n\n try {\n const task = await boardStub.createTask(body);\n return jsonResponse({ success: true, data: task });\n } catch (error) {\n return jsonResponse({\n success: false,\n error: { code: 'CREATE_FAILED', message: error instanceof Error ? error.message : 'Failed to create task' },\n }, 500);\n }\n }\n\n return jsonResponse({ error: 'Not found' }, 404);\n }\n\n return new Response(null, { status: 404 });\n },\n} satisfies ExportedHandler;\n" }, { "path": "worker/mcp/AccountMCPRegistry.ts", "content": "/**\n * AccountMCPRegistry - Pluggable registry for accounts with multiple MCPs\n *\n * Defines accounts (Google, future: Microsoft, etc.) and their associated MCPs.\n * Makes adding new account integrations straightforward.\n *\n * Used by:\n * - Board settings UI (which MCPs to enable)\n * - AgentWorkflow (tool execution and credential management)\n */\n\nimport { HostedMCPServer, type MCPToolSchema } from './MCPClient';\nimport { GmailMCPServer } from '../google/GmailMCP';\nimport { DocsMCPServer } from '../google/DocsMCP';\nimport { SheetsMCPServer } from '../google/SheetsMCP';\nimport { SandboxMCPServer } from '../sandbox/SandboxMCP';\nimport { GitHubMCPServer } from '../github/GitHubMCP';\nimport { refreshAccessToken } from '../google/oauth';\nimport { CREDENTIAL_TYPES } from '../constants';\nimport type { Sandbox } from '@cloudflare/sandbox';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/** How authentication is handled for this account */\nexport type CredentialAuthType = 'oauth' | 'api_key' | 'env_binding' | 'none';\n\n/** Artifact types that can be created by MCP tools */\nexport type ArtifactType = 'google_doc' | 'google_sheet' | 'gmail_message' | 'github_pr' | 'file' | 'other';\n\n/** URL pattern types for link enrichment */\nexport type UrlPatternType = 'google_doc' | 'google_sheet' | 'github_pr' | 'github_issue' | 'github_repo';\n\n/** URL pattern definition for link pills */\nexport interface MCPUrlPattern {\n /** Regex pattern to match URLs */\n pattern: string;\n /** Type of resource this pattern matches */\n type: UrlPatternType;\n /** Tool name to call for fetching metadata */\n fetchTool: string;\n}\n\n/** Environment bindings that may be needed by MCP factories */\nexport interface MCPEnvBindings {\n Sandbox?: DurableObjectNamespace;\n GOOGLE_CLIENT_ID?: string;\n GOOGLE_CLIENT_SECRET?: string;\n [key: string]: unknown;\n}\n\n/** Credentials passed to factories and refresh functions */\nexport interface MCPCredentials {\n accessToken?: string;\n refreshToken?: string;\n expiresAt?: string;\n apiKey?: string;\n [key: string]: unknown;\n}\n\n/**\n * Definition for an individual MCP within an account\n */\nexport interface MCPDefinition {\n /** Unique identifier for the MCP (e.g., 'gmail', 'google-docs') */\n id: string;\n /** Display name (e.g., 'Gmail', 'Google Docs') */\n name: string;\n /** Server name used in tool names (e.g., 'Gmail', 'Google_Docs' for 'Gmail__sendMessage') */\n serverName: string;\n /** Short description of what this MCP does */\n description: string;\n /** Factory function to create the MCP server instance */\n factory: (credentials: MCPCredentials, env?: MCPEnvBindings) => HostedMCPServer;\n /** Type of artifact this MCP produces (for UI display) */\n artifactType?: ArtifactType;\n /**\n * How artifact content is stored:\n * - 'url': External link (default) - artifact has url field\n * - 'inline': Content stored in artifact - artifact has content field\n */\n artifactContentType?: 'url' | 'inline';\n /** URL patterns this MCP can enrich for link pills */\n urlPatterns?: MCPUrlPattern[];\n /**\n * Workflow guidance for the agent system prompt.\n * Explains how to use this MCP's tools effectively.\n * This is injected into the agent's system prompt when the MCP is enabled.\n */\n workflowGuidance?: string;\n}\n\n/**\n * Definition for an account that has multiple MCPs\n */\nexport interface AccountDefinition {\n /** Unique identifier for the account (e.g., 'google', 'microsoft') */\n id: string;\n /** Display name (e.g., 'Google', 'Microsoft') */\n name: string;\n /** The credential type used for this account (e.g., 'google_oauth') */\n credentialType: string;\n /** How authentication is handled */\n authType: CredentialAuthType;\n /** Icon identifier for the account */\n icon?: string;\n /** MCPs available for this account */\n mcps: MCPDefinition[];\n /**\n * Token refresh function for OAuth accounts.\n * Returns new access token and optional expiry.\n */\n refreshToken?: (\n refreshToken: string,\n clientId: string,\n clientSecret: string\n ) => Promise<{ access_token: string; expires_in?: number }>;\n /**\n * If true, this account's MCPs are always available (injected automatically).\n * Used for system MCPs like Sandbox that don't require user configuration.\n */\n alwaysEnabled?: boolean;\n /**\n * Environment binding keys required by this account's MCPs.\n * These are passed from the workflow env to the MCP factory.\n * Example: ['SANDBOX'] for Sandbox MCP, ['GOOGLE_CLIENT_ID', 'GOOGLE_CLIENT_SECRET'] for Google\n */\n envBindingKeys?: string[];\n /**\n * Additional credential keys to pass to MCP factories beyond the main accessToken.\n * Example: ['githubToken', 'anthropicApiKey'] for Sandbox MCP\n */\n additionalCredentialKeys?: string[];\n}\n\n// ============================================================================\n// Registry\n// ============================================================================\n\n/**\n * Registry of all accounts with multiple MCPs\n *\n * To add a new account:\n * 1. Create MCP server classes extending HostedMCPServer\n * 2. Add a new AccountDefinition to this array\n * 3. Implement OAuth flow in worker/index.ts (if needed)\n */\n// ============================================================================\n// Workflow Guidance Templates\n// These are injected into the agent's system prompt when the MCP is enabled.\n// ============================================================================\n\nconst GMAIL_GUIDANCE = `## Gmail Workflow\nAlways request approval before sending emails.\n\n**Sending an email:**\n\\`\\`\\`\nrequest_approval({\n tool: \"Gmail__sendEmail\",\n action: \"Send Email\",\n data: {\n to: \"recipient@example.com\",\n subject: \"Email Subject\",\n body: \"Email body content...\"\n }\n})\n\\`\\`\\`\nAfter approval, call: \\`Gmail__sendEmail({ to: \"...\", subject: \"...\", body: \"...\" })\\``;\n\nconst GOOGLE_DOCS_GUIDANCE = `## Google Docs Workflow\n\n**Creating a new document:**\n\\`\\`\\`\nrequest_approval({\n tool: \"Google_Docs__createDocument\",\n action: \"Create Document\",\n data: {\n title: \"Document Title\",\n content: \"The full document content to create...\"\n }\n})\n\\`\\`\\`\nAfter approval, call: \\`Google_Docs__createDocument({ title: \"...\", content: \"...\" })\\`\n\n**Modifying existing documents (append or replace):**\n1. **Get current content first**:\n \\`\\`\\`\n Google_Docs__getDocument({ documentId: \"...\" })\n \\`\\`\\`\n2. **Request approval with both old and new content**:\n \\`\\`\\`\n request_approval({\n tool: \"Google_Docs__replaceDocumentContent\", // or appendToDocument\n action: \"Replace Document Content\",\n data: {\n documentId: \"...\",\n title: \"Document Title\",\n currentContent: \"\",\n newContent: \"\",\n action: \"replace\" // or \"append\"\n }\n })\n \\`\\`\\`\n3. **After approval**, call the actual tool:\n \\`\\`\\`\n Google_Docs__replaceDocumentContent({ documentId: \"...\", content: \"...\" })\n \\`\\`\\``;\n\nconst GOOGLE_SHEETS_GUIDANCE = `## Google Sheets Workflow\nFor creating or modifying spreadsheets, ALWAYS request approval first.\n\n**Creating a new spreadsheet:**\n\\`\\`\\`\nrequest_approval({\n tool: \"Google_Sheets__createSpreadsheet\",\n action: \"Create Spreadsheet\",\n data: {\n title: \"Spreadsheet Title\",\n rows: [\n [\"Column 1\", \"Column 2\", \"Column 3\"], // Header row\n [\"Value 1\", \"Value 2\", \"Value 3\"], // Data rows\n ]\n }\n})\n\\`\\`\\`\n\n**Modifying an existing spreadsheet (append/update/replace):**\n1. First search/get the spreadsheet to get its title\n2. Get current data: \\`Google_Sheets__getSheetData({ spreadsheetId: \"...\", range: \"Sheet1\" })\\`\n3. Request approval - CRITICAL: You MUST include both currentRows AND title:\n\\`\\`\\`\nrequest_approval({\n tool: \"Google_Sheets__appendRows\", // or updateCells, replaceSheetContent\n action: \"Append Rows to Spreadsheet\",\n data: {\n spreadsheetId: \"...\",\n title: \"ACTUAL spreadsheet title from search\", // REQUIRED - use real title!\n currentRows: [[...], [...], ...], // REQUIRED - copy the rows array from getSheetData result\n newRows: [[...], [...], ...] // the new rows to add\n }\n})\n\\`\\`\\`\n\nIMPORTANT for approval to show diff correctly:\n- \\`title\\` must be the actual spreadsheet title (not \"Spreadsheet Title\")\n- \\`currentRows\\` must contain the actual current data from getSheetData (the \\`rows\\` array)\n- \\`newRows\\` contains only the NEW rows being added\n\nAfter approval, call the actual tool with the approved data.`;\n\nconst SANDBOX_GUIDANCE = `## Code Change Workflow (Sandbox)\nFor ANY task requiring code changes, you MUST use Sandbox. Here's the flow:\n\n1. **Clone the repository**:\n \\`\\`\\`\n Sandbox__createSession({ repoUrl: \"https://github.com/owner/repo.git\", branch: \"main\" })\n \\`\\`\\`\n This returns a sessionId you'll use for all subsequent calls.\n\n2. **Make changes** - Use runClaude to let Claude Code make the edits:\n \\`\\`\\`\n Sandbox__runClaude({ sessionId: \"...\", task: \"description of what to change\" })\n \\`\\`\\`\n\n3. **Get the diff** - REQUIRED before approval:\n \\`\\`\\`\n Sandbox__getDiff({ sessionId: \"...\" })\n \\`\\`\\`\n This returns \\`structuredContent.diff\\` (unified diff) and \\`structuredContent.stats\\`.\n\n4. **Request PR approval** - Include the diff from step 3:\n \\`\\`\\`\n request_approval({\n tool: \"Sandbox__createPullRequest\",\n action: \"Create Pull Request\",\n data: {\n title: \"PR title\",\n body: \"PR description\",\n branch: \"feature/descriptive-branch-name\",\n diff: structuredContent.diff // REQUIRED: extract from getDiff result\n }\n })\n \\`\\`\\`\n\n5. **After user approval** - Create the PR (handles commit + push + PR creation):\n \\`\\`\\`\n Sandbox__createPullRequest({\n sessionId,\n title: \"PR title\",\n body: \"PR description\",\n branch: \"feature/descriptive-branch-name\",\n base: \"main\",\n commitMessage: \"commit message\",\n diff: structuredContent.diff\n })\n \\`\\`\\`\n\nIMPORTANT RULES:\n- createSession requires repoUrl parameter\n- ALWAYS call getDiff before requesting approval\n- Include the diff in both the approval request AND the createPullRequest call\n- createPullRequest handles everything: creates branch, commits, pushes, creates PR`;\n\nconst GITHUB_GUIDANCE = `## GitHub Workflow\nUse GitHub tools to read repository information, issues, and pull requests.\nFor creating PRs with code changes, use Sandbox to make the changes first.\n\n**Reading repository info:**\n\\`\\`\\`\nGitHub__getRepository({ owner: \"...\", repo: \"...\" })\nGitHub__listIssues({ owner: \"...\", repo: \"...\", state: \"open\" })\nGitHub__getPullRequest({ owner: \"...\", repo: \"...\", pullNumber: 123 })\n\\`\\`\\`\n\n**Reviewing pull requests:**\n1. Fetch PR metadata (includes full unified diff and stats):\n\\`\\`\\`\nGitHub__getPullRequest({ owner: \"...\", repo: \"...\", pullNumber: 123 })\n\\`\\`\\`\ngetPullRequest returns \\`structuredContent.diff\\` (full unified diff) and \\`structuredContent.stats\\`.\nOptionally call \\`listPullRequestFiles\\` for per-file metadata.\n2. Request approval using the diff and stats from step 1:\n\\`\\`\\`\nrequest_approval({\n tool: \"GitHub__submitPullRequestReview\",\n action: \"Review Pull Request\",\n data: {\n owner: \"...\",\n repo: \"...\",\n pullNumber: 123,\n prTitle: \"...\",\n authorLogin: \"...\",\n baseBranch: \"...\",\n headBranch: \"...\",\n event: \"REQUEST_CHANGES\",\n body: \"Overall review summary\",\n comments: [{ path: \"src/app.ts\", line: 42, side: \"RIGHT\", body: \"...\" }],\n diff: structuredContent.diff,\n stats: structuredContent.stats\n }\n})\n\\`\\`\\`\n3. After user approval, call:\n\\`\\`\\`\nGitHub__submitPullRequestReview({ owner: \"...\", repo: \"...\", pullNumber: 123, event: \"COMMENT\", body: \"...\", comments: [...] })\n\\`\\`\\`\nAlways use \\`userData\\` from the approval result when present.`;\n\n// ============================================================================\n// Registry\n// ============================================================================\n\nexport const ACCOUNT_REGISTRY: AccountDefinition[] = [\n {\n id: 'google',\n name: 'Google',\n credentialType: CREDENTIAL_TYPES.GOOGLE_OAUTH,\n authType: 'oauth',\n icon: 'google',\n refreshToken: refreshAccessToken,\n envBindingKeys: ['GOOGLE_CLIENT_ID', 'GOOGLE_CLIENT_SECRET'],\n mcps: [\n {\n id: 'gmail',\n name: 'Gmail',\n serverName: 'Gmail',\n description: 'Read, send, and search emails',\n factory: (creds) => new GmailMCPServer(creds.accessToken || ''),\n artifactType: 'gmail_message',\n artifactContentType: 'inline',\n workflowGuidance: GMAIL_GUIDANCE,\n },\n {\n id: 'google-docs',\n name: 'Google Docs',\n serverName: 'Google_Docs',\n description: 'Create and edit documents',\n factory: (creds) => new DocsMCPServer(creds.accessToken || ''),\n artifactType: 'google_doc',\n urlPatterns: [{\n pattern: 'docs\\\\.google\\\\.com/document/d/([a-zA-Z0-9_-]+)',\n type: 'google_doc',\n fetchTool: 'getDocument',\n }],\n workflowGuidance: GOOGLE_DOCS_GUIDANCE,\n },\n {\n id: 'google-sheets',\n name: 'Google Sheets',\n serverName: 'Google_Sheets',\n description: 'Create and edit spreadsheets',\n factory: (creds) => new SheetsMCPServer(creds.accessToken || ''),\n artifactType: 'google_sheet',\n urlPatterns: [{\n pattern: 'docs\\\\.google\\\\.com/spreadsheets/d/([a-zA-Z0-9_-]+)',\n type: 'google_sheet',\n fetchTool: 'getSpreadsheet',\n }],\n workflowGuidance: GOOGLE_SHEETS_GUIDANCE,\n },\n ],\n },\n {\n id: 'sandbox',\n name: 'Sandbox',\n credentialType: 'none',\n authType: 'env_binding',\n alwaysEnabled: true,\n envBindingKeys: ['SANDBOX'],\n additionalCredentialKeys: ['githubToken', 'anthropicApiKey'],\n mcps: [\n {\n id: 'sandbox',\n name: 'Sandbox',\n serverName: 'Sandbox',\n description: 'Execute code in isolated environment',\n factory: (creds, env) => new SandboxMCPServer(\n env?.SANDBOX as DurableObjectNamespace,\n {\n githubToken: creds.githubToken as string | undefined,\n anthropicApiKey: creds.anthropicApiKey as string | undefined,\n }\n ),\n workflowGuidance: SANDBOX_GUIDANCE,\n artifactType: 'github_pr',\n },\n ],\n },\n {\n id: 'github',\n name: 'GitHub',\n credentialType: CREDENTIAL_TYPES.GITHUB_OAUTH,\n authType: 'oauth',\n icon: 'github',\n // GitHub tokens don't expire, so no refreshToken needed\n mcps: [\n {\n id: 'github',\n name: 'GitHub',\n serverName: 'GitHub',\n description: 'Manage repositories, issues, and pull requests',\n factory: (creds) => new GitHubMCPServer(creds.accessToken || ''),\n artifactType: 'github_pr',\n urlPatterns: [\n {\n pattern: 'github\\\\.com/([^/]+)/([^/]+)/pull/(\\\\d+)',\n type: 'github_pr',\n fetchTool: 'getPullRequest',\n },\n {\n pattern: 'github\\\\.com/([^/]+)/([^/]+)/issues/(\\\\d+)',\n type: 'github_issue',\n fetchTool: 'getIssue',\n },\n {\n // Match repo URLs but exclude PR/issue/blob/tree paths\n pattern: 'github\\\\.com/([^/]+)/([^/]+)/?$',\n type: 'github_repo',\n fetchTool: 'getRepository',\n },\n ],\n workflowGuidance: GITHUB_GUIDANCE,\n },\n ],\n },\n];\n\n/**\n * Get an account definition by its ID\n */\nexport function getAccountById(id: string): AccountDefinition | undefined {\n return ACCOUNT_REGISTRY.find((a) => a.id === id);\n}\n\n/**\n * Get an account definition by its credential type\n */\nexport function getAccountByCredentialType(credentialType: string): AccountDefinition | undefined {\n return ACCOUNT_REGISTRY.find((a) => a.credentialType === credentialType);\n}\n\n/**\n * Get all MCPs for an account by account ID\n */\nexport function getMCPsForAccount(accountId: string): MCPDefinition[] {\n return getAccountById(accountId)?.mcps ?? [];\n}\n\n/**\n * Get a specific MCP definition by account ID and MCP ID\n */\nexport function getMCPDefinition(accountId: string, mcpId: string): MCPDefinition | undefined {\n const account = getAccountById(accountId);\n return account?.mcps.find((m) => m.id === mcpId);\n}\n\n/**\n * Find which account an MCP belongs to by MCP name\n */\nexport function getAccountForMCPName(mcpName: string): AccountDefinition | undefined {\n return ACCOUNT_REGISTRY.find((account) =>\n account.mcps.some((mcp) => mcp.name === mcpName)\n );\n}\n\n/**\n * Get an MCP definition by its display name\n */\nexport function getMCPByName(mcpName: string): MCPDefinition | undefined {\n for (const account of ACCOUNT_REGISTRY) {\n const mcp = account.mcps.find((m) => m.name === mcpName);\n if (mcp) return mcp;\n }\n return undefined;\n}\n\n/**\n * Get MCP and its parent account by server name (e.g., 'Gmail', 'Google_Docs')\n * Used by AgentWorkflow to look up MCPs when executing tools\n */\nexport function getMCPByServerName(serverName: string): {\n account: AccountDefinition;\n mcp: MCPDefinition;\n} | undefined {\n for (const account of ACCOUNT_REGISTRY) {\n const mcp = account.mcps.find((m) => m.serverName === serverName);\n if (mcp) {\n return { account, mcp };\n }\n }\n return undefined;\n}\n\n/**\n * Get credential requirements for a list of server names\n * Returns unique credential types needed (excluding 'none')\n */\nexport function getCredentialRequirements(serverNames: string[]): Array<{\n credentialType: string;\n authType: CredentialAuthType;\n accountId: string;\n}> {\n const seen = new Set();\n const requirements: Array<{\n credentialType: string;\n authType: CredentialAuthType;\n accountId: string;\n }> = [];\n\n for (const serverName of serverNames) {\n const lookup = getMCPByServerName(serverName);\n if (lookup && lookup.account.credentialType !== 'none' && !seen.has(lookup.account.credentialType)) {\n seen.add(lookup.account.credentialType);\n requirements.push({\n credentialType: lookup.account.credentialType,\n authType: lookup.account.authType,\n accountId: lookup.account.id,\n });\n }\n }\n\n return requirements;\n}\n\n/**\n * Get all account IDs\n */\nexport function getAllAccountIds(): string[] {\n return ACCOUNT_REGISTRY.map((a) => a.id);\n}\n\n/**\n * Check if a credential type belongs to a registered account\n */\nexport function isAccountCredentialType(credentialType: string): boolean {\n return ACCOUNT_REGISTRY.some((a) => a.credentialType === credentialType);\n}\n\n/**\n * Get tools for an MCP by creating a temporary instance\n * Useful for caching tools without needing a real token\n */\nexport function getMCPTools(accountId: string, mcpId: string): MCPToolSchema[] {\n const mcp = getMCPDefinition(accountId, mcpId);\n if (!mcp) return [];\n // Create instance with empty credentials just to get tool schemas\n const instance = mcp.factory({});\n return instance.getTools();\n}\n\n/**\n * Get all accounts that are always enabled (system MCPs like Sandbox)\n */\nexport function getAlwaysEnabledAccounts(): AccountDefinition[] {\n return ACCOUNT_REGISTRY.filter((a) => a.alwaysEnabled);\n}\n\n/**\n * Get all accounts that require OAuth credentials\n */\nexport function getOAuthAccounts(): AccountDefinition[] {\n return ACCOUNT_REGISTRY.filter((a) => a.authType === 'oauth');\n}\n\n/**\n * Get workflow guidance for a list of enabled MCP server names\n * Returns concatenated guidance sections for the agent system prompt\n */\nexport function getWorkflowGuidance(serverNames: string[]): string {\n const guidanceSections: string[] = [];\n const seen = new Set();\n\n for (const serverName of serverNames) {\n const lookup = getMCPByServerName(serverName);\n if (lookup?.mcp.workflowGuidance && !seen.has(lookup.mcp.id)) {\n seen.add(lookup.mcp.id);\n guidanceSections.push(lookup.mcp.workflowGuidance);\n }\n }\n\n return guidanceSections.join('\\n\\n');\n}\n\n/**\n * Get all required env binding keys for enabled accounts\n * Used to build the env bindings object for MCP factories\n */\nexport function getRequiredEnvBindingKeys(serverNames: string[]): string[] {\n const keys = new Set();\n\n for (const serverName of serverNames) {\n const lookup = getMCPByServerName(serverName);\n if (lookup?.account.envBindingKeys) {\n for (const key of lookup.account.envBindingKeys) {\n keys.add(key);\n }\n }\n }\n\n return Array.from(keys);\n}\n\n/**\n * Get additional credential keys needed for enabled accounts\n * Used to pass extra credentials (like githubToken) to MCP factories\n */\nexport function getAdditionalCredentialKeys(serverNames: string[]): string[] {\n const keys = new Set();\n\n for (const serverName of serverNames) {\n const lookup = getMCPByServerName(serverName);\n if (lookup?.account.additionalCredentialKeys) {\n for (const key of lookup.account.additionalCredentialKeys) {\n keys.add(key);\n }\n }\n }\n\n return Array.from(keys);\n}\n\n/**\n * Get credential type for a URL pattern type.\n * Finds which account's MCP has this pattern and returns that account's credentialType.\n */\nexport function getCredentialTypeForUrlPattern(patternType: UrlPatternType): string | undefined {\n for (const account of ACCOUNT_REGISTRY) {\n for (const mcp of account.mcps) {\n if (mcp.urlPatterns?.some(p => p.type === patternType)) {\n return account.credentialType;\n }\n }\n }\n return undefined;\n}\n" }, { "path": "worker/mcp/MCPBridge.ts", "content": "/**\n * MCPBridge - Bridge between workflow execution and MCP servers\n *\n * Routes tool calls from generated workflow code to the appropriate\n * MCP server (hosted or remote) and handles authentication.\n */\n\nimport { MCPRegistry, type MCPToolCallResult, type MCPServerConfig } from './MCPClient';\nimport { GmailMCPServer } from '../google/GmailMCP';\nimport { DocsMCPServer } from '../google/DocsMCP';\nimport { logger } from '../utils/logger';\n\nexport interface MCPBridgeConfig {\n servers: Array<{\n id: string;\n name: string;\n type: 'remote' | 'hosted';\n endpoint?: string;\n authType: 'none' | 'oauth' | 'api_key' | 'bearer';\n }>;\n credentials: {\n google?: string; // Google OAuth token\n github?: string; // GitHub OAuth token\n // Add more as needed\n };\n}\n\nexport interface ToolCallRequest {\n serverName: string;\n toolName: string;\n args: Record;\n}\n\nexport interface ToolCallResponse {\n success: boolean;\n result?: MCPToolCallResult;\n error?: string;\n}\n\n/**\n * MCPBridge manages connections to MCP servers and routes tool calls\n */\nexport class MCPBridge {\n private registry: MCPRegistry;\n private config: MCPBridgeConfig;\n private initialized = false;\n\n constructor(config: MCPBridgeConfig) {\n this.config = config;\n this.registry = new MCPRegistry();\n }\n\n /**\n * Initialize connections to all configured MCP servers\n */\n async initialize(): Promise {\n if (this.initialized) return;\n\n for (const server of this.config.servers) {\n try {\n if (server.type === 'hosted') {\n await this.initializeHostedServer(server);\n } else {\n await this.initializeRemoteServer(server);\n }\n } catch (error) {\n logger.mcpBridge.error('Failed to initialize MCP server', { server: server.name, error: error instanceof Error ? error.message : String(error) });\n }\n }\n\n this.initialized = true;\n }\n\n /**\n * Initialize a hosted MCP server (our wrappers)\n */\n private async initializeHostedServer(server: {\n id: string;\n name: string;\n }): Promise {\n const serverNameLower = server.name.toLowerCase();\n\n if (serverNameLower.includes('gmail')) {\n if (!this.config.credentials.google) {\n logger.mcpBridge.warn('Gmail MCP requires Google OAuth token');\n return;\n }\n const gmail = new GmailMCPServer(this.config.credentials.google);\n this.registry.registerHosted(server.id, gmail);\n logger.mcpBridge.info('Registered hosted MCP', { server: server.name });\n }\n\n if (serverNameLower.includes('docs') || serverNameLower.includes('google docs')) {\n if (!this.config.credentials.google) {\n logger.mcpBridge.warn('Google Docs MCP requires Google OAuth token');\n return;\n }\n const docs = new DocsMCPServer(this.config.credentials.google);\n this.registry.registerHosted(server.id, docs);\n logger.mcpBridge.info('Registered hosted MCP', { server: server.name });\n }\n\n // Add more hosted servers here as needed\n }\n\n /**\n * Initialize a remote MCP server\n */\n private async initializeRemoteServer(server: {\n id: string;\n name: string;\n endpoint?: string;\n authType: 'none' | 'oauth' | 'api_key' | 'bearer';\n }): Promise {\n if (!server.endpoint) {\n logger.mcpBridge.warn('Remote MCP server has no endpoint', { server: server.name });\n return;\n }\n\n const config: MCPServerConfig = {\n id: server.id,\n name: server.name,\n type: 'remote',\n endpoint: server.endpoint,\n authType: server.authType,\n credentials: {},\n };\n\n // Add credentials based on auth type\n if (server.authType === 'bearer' || server.authType === 'oauth') {\n // Try to match credential based on server name\n if (server.name.toLowerCase().includes('github') && this.config.credentials.github) {\n config.credentials = { token: this.config.credentials.github };\n }\n }\n\n const client = this.registry.registerRemote(config);\n\n try {\n await client.initialize();\n logger.mcpBridge.info('Initialized remote MCP', { server: server.name });\n } catch (error) {\n logger.mcpBridge.error('Failed to initialize remote MCP', { server: server.name, error: error instanceof Error ? error.message : String(error) });\n }\n }\n\n /**\n * Call a tool on an MCP server\n */\n async callTool(request: ToolCallRequest): Promise {\n if (!this.initialized) {\n await this.initialize();\n }\n\n const { serverName, toolName, args } = request;\n\n // Find server by name (case-insensitive, normalized)\n const normalizedName = serverName.toLowerCase().replace(/[^a-z0-9]/g, '');\n const server = this.config.servers.find(s => {\n const sNormalized = s.name.toLowerCase().replace(/[^a-z0-9]/g, '');\n return sNormalized === normalizedName || s.id === serverName;\n });\n\n if (!server) {\n return {\n success: false,\n error: `MCP server not found: ${serverName}`,\n };\n }\n\n try {\n const result = await this.registry.callTool(server.id, toolName, args);\n return {\n success: !result.isError,\n result,\n error: result.isError ? result.content[0]?.text : undefined,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : String(error),\n };\n }\n }\n\n /**\n * Get all available tools across all servers\n */\n async getAllTools(): Promise> {\n if (!this.initialized) {\n await this.initialize();\n }\n\n const allTools = await this.registry.getAllTools();\n const result = new Map();\n\n for (const server of this.config.servers) {\n const tools = allTools.get(server.id);\n if (tools) {\n result.set(server.id, {\n name: server.name,\n tools: tools.map(t => t.name),\n });\n }\n }\n\n return result;\n }\n\n /**\n * Get tools for a specific server\n */\n async getServerTools(serverIdOrName: string): Promise {\n if (!this.initialized) {\n await this.initialize();\n }\n\n const normalizedName = serverIdOrName.toLowerCase().replace(/[^a-z0-9]/g, '');\n const server = this.config.servers.find(s => {\n const sNormalized = s.name.toLowerCase().replace(/[^a-z0-9]/g, '');\n return sNormalized === normalizedName || s.id === serverIdOrName;\n });\n\n if (!server) {\n return [];\n }\n\n const allTools = await this.registry.getAllTools();\n const tools = allTools.get(server.id);\n return tools ? tools.map(t => t.name) : [];\n }\n}\n\n/**\n * Create a workflow context object for executing generated code\n * This provides the `ctx` object that generated code expects\n */\nexport function createWorkflowContext(\n _bridge: MCPBridge,\n onStep: (stepId: string) => void,\n onLog: (message: string) => void,\n onCheckpoint: (options: {\n message: string;\n data?: Record;\n actions?: string[];\n }) => Promise<{ action: string; data?: Record }>\n) {\n const stepResults: Record = {};\n\n return {\n step: (id: string) => {\n onStep(id);\n },\n\n log: (message: string) => {\n onLog(message);\n },\n\n checkpoint: async (options: {\n message: string;\n data?: Record;\n actions?: string[];\n }) => {\n return onCheckpoint(options);\n },\n\n input: {} as Record,\n stepResults,\n };\n}\n\n/**\n * Create proxy objects for MCP servers that can be used in generated code\n * Returns an object like { Gmail: { sendEmail: fn, listMessages: fn, ... } }\n */\nexport async function createMCPProxies(\n bridge: MCPBridge\n): Promise) => Promise>>> {\n const allTools = await bridge.getAllTools();\n const proxies: Record) => Promise>> = {};\n\n for (const [serverId, { name, tools }] of allTools) {\n // Normalize server name to valid JS identifier\n const serverKey = name.replace(/[^a-zA-Z0-9]/g, '_');\n\n proxies[serverKey] = {};\n\n for (const toolName of tools) {\n proxies[serverKey][toolName] = async (args: Record) => {\n const result = await bridge.callTool({\n serverName: serverId,\n toolName,\n args,\n });\n\n if (!result.success) {\n throw new Error(result.error || 'Tool call failed');\n }\n\n return result.result!;\n };\n }\n }\n\n return proxies;\n}\n" }, { "path": "worker/mcp/MCPClient.ts", "content": "/**\n * MCPClient - Client for connecting to MCP (Model Context Protocol) servers\n *\n * Supports both remote MCP servers (via HTTP/SSE) and hosted MCP wrappers.\n * Implements the MCP specification for tool discovery and invocation.\n */\n\nimport { logger } from '../utils/logger';\n\n// MCP Protocol Types\nexport interface MCPToolSchema {\n name: string;\n description?: string;\n inputSchema: JSONSchema;\n outputSchema?: JSONSchema; // Schema for structuredContent return type\n annotations?: Record;\n /** Fields required in approval data when using request_approval for this tool */\n approvalRequiredFields?: string[];\n /** If true, tool cannot be called without prior approval via request_approval */\n requiresApproval?: boolean;\n /** If true, tool is not available in scheduled runs (coordination-only mode) */\n disabledInScheduledRuns?: boolean;\n}\n\nexport interface JSONSchema {\n type: 'object' | 'string' | 'number' | 'boolean' | 'array' | 'integer' | 'null';\n properties?: Record;\n required?: string[];\n items?: JSONSchema;\n description?: string;\n enum?: unknown[];\n default?: unknown;\n format?: string;\n anyOf?: JSONSchema[];\n oneOf?: JSONSchema[];\n allOf?: JSONSchema[];\n}\n\nexport type JSONSchemaProperty = JSONSchema;\n\nexport interface MCPToolCallResult {\n content: MCPContent[];\n structuredContent?: unknown;\n isError?: boolean;\n}\n\nexport interface MCPContent {\n type: 'text' | 'image' | 'resource';\n text?: string;\n data?: string;\n mimeType?: string;\n}\n\n// MCP Server Configuration\nexport interface MCPServerConfig {\n id: string;\n name: string;\n type: 'remote' | 'hosted';\n endpoint?: string;\n authType: 'none' | 'oauth' | 'api_key' | 'bearer';\n credentials?: {\n token?: string;\n apiKey?: string;\n };\n /** Transport type for remote servers. Defaults to 'streamable-http' */\n transportType?: 'streamable-http' | 'sse';\n}\n\n// JSON-RPC Types\ninterface JSONRPCRequest {\n jsonrpc: '2.0';\n id: string | number;\n method: string;\n params?: unknown;\n}\n\ninterface JSONRPCResponse {\n jsonrpc: '2.0';\n id: string | number;\n result?: unknown;\n error?: {\n code: number;\n message: string;\n data?: unknown;\n };\n}\n\n// SSE Event parsed from stream\ninterface SSEEvent {\n event?: string;\n data: string;\n id?: string;\n}\n\n/**\n * SSE Transport for MCP protocol\n *\n * Handles the SSE connection lifecycle for per-request operations:\n * 1. Connect to SSE endpoint (GET)\n * 2. Wait for 'endpoint' event with POST URL\n * 3. POST JSON-RPC request to that URL\n * 4. Wait for response via SSE 'message' event\n * 5. Close connection\n */\nclass SSETransport {\n private baseEndpoint: string;\n private headers: Record;\n private connectionTimeout: number;\n private responseTimeout: number;\n\n constructor(\n endpoint: string,\n headers: Record,\n options?: { connectionTimeout?: number; responseTimeout?: number }\n ) {\n this.baseEndpoint = endpoint;\n this.headers = headers;\n this.connectionTimeout = options?.connectionTimeout ?? 10000; // 10s\n this.responseTimeout = options?.responseTimeout ?? 30000; // 30s\n }\n\n /**\n * Send a JSON-RPC request via SSE transport\n */\n async sendRequest(request: JSONRPCRequest): Promise {\n const controller = new AbortController();\n const totalTimeout = setTimeout(\n () => controller.abort(),\n this.connectionTimeout + this.responseTimeout\n );\n\n let reader: ReadableStreamDefaultReader | null = null;\n\n try {\n const sseResponse = await this.connectWithTimeout(controller.signal);\n\n if (!sseResponse.body) {\n throw new Error('SSE response has no body');\n }\n\n reader = sseResponse.body.getReader();\n\n const { messageEndpoint, sessionId } = await this.waitForEndpointEvent(\n reader,\n controller.signal\n );\n\n const postHeaders: Record = {\n ...this.headers,\n 'Content-Type': 'application/json',\n };\n if (sessionId) {\n postHeaders['Mcp-Session-Id'] = sessionId;\n }\n\n const postResponse = await fetch(messageEndpoint, {\n method: 'POST',\n headers: postHeaders,\n body: JSON.stringify(request),\n signal: controller.signal,\n });\n\n if (!postResponse.ok) {\n throw new Error(`POST to message endpoint failed: ${postResponse.status}`);\n }\n\n const response = await this.waitForResponse(reader, request.id, controller.signal);\n\n return response;\n } finally {\n clearTimeout(totalTimeout);\n // Clean up reader\n if (reader) {\n try {\n reader.releaseLock();\n } catch {\n // Ignore release errors\n }\n }\n controller.abort(); // Ensure cleanup\n }\n }\n\n /**\n * Connect to SSE endpoint with timeout\n */\n private async connectWithTimeout(signal: AbortSignal): Promise {\n const connectionController = new AbortController();\n const connectionTimeout = setTimeout(\n () => connectionController.abort(),\n this.connectionTimeout\n );\n\n // Combine signals\n signal.addEventListener('abort', () => connectionController.abort());\n\n try {\n const response = await fetch(this.baseEndpoint, {\n method: 'GET',\n headers: {\n ...this.headers,\n Accept: 'text/event-stream',\n 'Cache-Control': 'no-cache',\n },\n signal: connectionController.signal,\n });\n\n if (!response.ok) {\n throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);\n }\n\n return response;\n } finally {\n clearTimeout(connectionTimeout);\n }\n }\n\n /**\n * Wait for the 'endpoint' event from SSE stream\n */\n private async waitForEndpointEvent(\n reader: ReadableStreamDefaultReader,\n signal: AbortSignal\n ): Promise<{ messageEndpoint: string; sessionId?: string }> {\n const decoder = new TextDecoder();\n let buffer = '';\n\n while (!signal.aborted) {\n const { done, value } = await reader.read();\n\n if (done) {\n throw new Error('SSE stream ended before endpoint event received');\n }\n\n buffer += decoder.decode(value, { stream: true });\n\n // Parse SSE events from buffer\n const { parsed, remaining } = this.parseSSEBuffer(buffer);\n buffer = remaining;\n\n for (const event of parsed) {\n if (event.event === 'endpoint') {\n try {\n const data = JSON.parse(event.data);\n // MCP SSE spec uses 'uri' field\n const messageEndpoint = data.uri || data.url || data.endpoint;\n if (!messageEndpoint) {\n throw new Error('Endpoint event missing uri field');\n }\n return {\n messageEndpoint,\n sessionId: data.sessionId,\n };\n } catch (e) {\n throw new Error(`Failed to parse endpoint event: ${e}`);\n }\n }\n }\n }\n\n throw new Error('Aborted while waiting for endpoint event');\n }\n\n /**\n * Wait for a JSON-RPC response matching the request ID via SSE 'message' event\n */\n private async waitForResponse(\n reader: ReadableStreamDefaultReader,\n requestId: string | number,\n signal: AbortSignal\n ): Promise {\n const decoder = new TextDecoder();\n let buffer = '';\n const startTime = Date.now();\n\n while (!signal.aborted) {\n // Check response timeout\n if (Date.now() - startTime > this.responseTimeout) {\n throw new Error('Timeout waiting for SSE response');\n }\n\n const { done, value } = await reader.read();\n\n if (done) {\n throw new Error('SSE stream ended before response received');\n }\n\n buffer += decoder.decode(value, { stream: true });\n\n // Parse SSE events from buffer\n const { parsed, remaining } = this.parseSSEBuffer(buffer);\n buffer = remaining;\n\n for (const event of parsed) {\n // MCP SSE spec sends responses as 'message' events\n if (event.event === 'message' || !event.event) {\n try {\n const response = JSON.parse(event.data) as JSONRPCResponse;\n // Match response to request ID\n if (response.id === requestId) {\n return response;\n }\n } catch {\n // Not valid JSON-RPC, skip\n }\n }\n }\n }\n\n throw new Error('Aborted while waiting for response');\n }\n\n /**\n * Parse SSE format from buffer\n * Returns parsed events and remaining unparsed data\n */\n private parseSSEBuffer(buffer: string): {\n parsed: SSEEvent[];\n remaining: string;\n } {\n const events: SSEEvent[] = [];\n const lines = buffer.split('\\n');\n let remaining = '';\n\n let currentEvent: { event?: string; data: string[]; id?: string } = { data: [] };\n\n for (let i = 0; i < lines.length; i++) {\n const line = lines[i];\n\n // Check if this is the last line and might be incomplete\n if (i === lines.length - 1 && !buffer.endsWith('\\n')) {\n remaining = line;\n break;\n }\n\n if (line === '') {\n // Empty line marks end of event\n if (currentEvent.data.length > 0) {\n events.push({\n event: currentEvent.event,\n data: currentEvent.data.join('\\n'),\n id: currentEvent.id,\n });\n }\n currentEvent = { data: [] };\n } else if (line.startsWith('event:')) {\n currentEvent.event = line.slice(6).trim();\n } else if (line.startsWith('data:')) {\n currentEvent.data.push(line.slice(5).trimStart());\n } else if (line.startsWith('id:')) {\n currentEvent.id = line.slice(3).trim();\n }\n // Ignore other lines (comments starting with :, etc.)\n }\n\n return { parsed: events, remaining };\n }\n}\n\n/**\n * Streamable HTTP Transport for MCP protocol (current standard)\n *\n * Simple POST-based transport:\n * 1. POST JSON-RPC request to endpoint\n * 2. Response is either JSON or SSE stream\n * 3. Parse and return result\n */\nclass StreamableHTTPTransport {\n private endpoint: string;\n private headers: Record;\n private responseTimeout: number;\n private sessionId?: string;\n private protocolVersion: string;\n\n constructor(\n endpoint: string,\n headers: Record,\n options?: { responseTimeout?: number; protocolVersion?: string }\n ) {\n this.endpoint = endpoint;\n this.headers = headers;\n this.responseTimeout = options?.responseTimeout ?? 30000; // 30s\n this.protocolVersion = options?.protocolVersion ?? '2025-03-26';\n }\n\n /**\n * Send a JSON-RPC request via Streamable HTTP transport\n */\n async sendRequest(request: JSONRPCRequest): Promise {\n const controller = new AbortController();\n const timeout = setTimeout(() => controller.abort(), this.responseTimeout);\n\n try {\n const requestHeaders: Record = {\n ...this.headers,\n 'Content-Type': 'application/json',\n 'Accept': 'application/json, text/event-stream',\n 'MCP-Protocol-Version': this.protocolVersion,\n };\n\n if (this.sessionId) {\n requestHeaders['Mcp-Session-Id'] = this.sessionId;\n }\n\n const response = await fetch(this.endpoint, {\n method: 'POST',\n headers: requestHeaders,\n body: JSON.stringify(request),\n signal: controller.signal,\n });\n\n // Capture session ID from response headers\n const newSessionId = response.headers.get('Mcp-Session-Id');\n if (newSessionId) {\n this.sessionId = newSessionId;\n }\n\n if (!response.ok) {\n // Try to parse error response\n try {\n const errorBody = await response.json() as JSONRPCResponse;\n if (errorBody.error) {\n return errorBody;\n }\n } catch {\n // Ignore parse errors\n }\n throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n }\n\n const contentType = response.headers.get('Content-Type') || '';\n\n if (contentType.includes('text/event-stream')) {\n // Parse SSE stream for response\n return this.parseSSEResponse(response.body!, request.id, controller.signal);\n } else {\n // Direct JSON response\n return response.json() as Promise;\n }\n } finally {\n clearTimeout(timeout);\n }\n }\n\n /**\n * Parse SSE stream to extract JSON-RPC response\n */\n private async parseSSEResponse(\n body: ReadableStream,\n requestId: string | number,\n signal: AbortSignal\n ): Promise {\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n while (!signal.aborted) {\n const { done, value } = await reader.read();\n\n if (done) {\n throw new Error('SSE stream ended before response received');\n }\n\n buffer += decoder.decode(value, { stream: true });\n\n // Parse SSE events from buffer\n const { parsed, remaining } = this.parseSSEBuffer(buffer);\n buffer = remaining;\n\n for (const event of parsed) {\n // Look for message events containing our response\n if (event.event === 'message' || !event.event) {\n try {\n const response = JSON.parse(event.data) as JSONRPCResponse;\n if (response.id === requestId) {\n return response;\n }\n } catch {\n // Not valid JSON-RPC, continue\n }\n }\n }\n }\n\n throw new Error('Aborted while waiting for response');\n } finally {\n reader.releaseLock();\n }\n }\n\n /**\n * Parse SSE format from buffer\n */\n private parseSSEBuffer(buffer: string): {\n parsed: SSEEvent[];\n remaining: string;\n } {\n const events: SSEEvent[] = [];\n const lines = buffer.split('\\n');\n let remaining = '';\n\n let currentEvent: { event?: string; data: string[]; id?: string } = { data: [] };\n\n for (let i = 0; i < lines.length; i++) {\n const line = lines[i];\n\n // Check if this is the last line and might be incomplete\n if (i === lines.length - 1 && !buffer.endsWith('\\n')) {\n remaining = line;\n break;\n }\n\n if (line === '') {\n // Empty line marks end of event\n if (currentEvent.data.length > 0) {\n events.push({\n event: currentEvent.event,\n data: currentEvent.data.join('\\n'),\n id: currentEvent.id,\n });\n }\n currentEvent = { data: [] };\n } else if (line.startsWith('event:')) {\n currentEvent.event = line.slice(6).trim();\n } else if (line.startsWith('data:')) {\n currentEvent.data.push(line.slice(5).trimStart());\n } else if (line.startsWith('id:')) {\n currentEvent.id = line.slice(3).trim();\n }\n }\n\n return { parsed: events, remaining };\n }\n}\n\n/**\n * MCP Client for communicating with MCP servers\n */\nexport class MCPClient {\n private config: MCPServerConfig;\n private requestId = 0;\n private sseTransport?: SSETransport;\n private streamableHTTPTransport?: StreamableHTTPTransport;\n\n constructor(config: MCPServerConfig) {\n this.config = config;\n\n if (config.endpoint) {\n const headers = this.buildAuthHeaders();\n\n if (config.transportType === 'sse') {\n // Legacy SSE transport (deprecated)\n this.sseTransport = new SSETransport(config.endpoint, headers);\n } else {\n // Streamable HTTP transport (default, current standard)\n this.streamableHTTPTransport = new StreamableHTTPTransport(config.endpoint, headers);\n }\n }\n }\n\n /**\n * Build authentication headers based on config\n */\n private buildAuthHeaders(): Record {\n const headers: Record = {};\n\n if (\n (this.config.authType === 'bearer' || this.config.authType === 'oauth') &&\n this.config.credentials?.token\n ) {\n headers['Authorization'] = `Bearer ${this.config.credentials.token}`;\n } else if (this.config.authType === 'api_key' && this.config.credentials?.apiKey) {\n headers['X-API-Key'] = this.config.credentials.apiKey;\n }\n\n return headers;\n }\n\n /**\n * Initialize connection and get server capabilities\n */\n async initialize(): Promise<{ protocolVersion: string; capabilities: unknown }> {\n const response = await this.sendRequest('initialize', {\n protocolVersion: '2024-11-05',\n capabilities: {\n tools: {},\n },\n clientInfo: {\n name: 'weft',\n version: '1.0.0',\n },\n });\n\n // Send initialized notification\n await this.sendNotification('notifications/initialized', {});\n\n return response as { protocolVersion: string; capabilities: unknown };\n }\n\n /**\n * List all available tools from the MCP server\n */\n async listTools(): Promise {\n const response = await this.sendRequest('tools/list', {});\n const result = response as { tools: MCPToolSchema[] };\n return result.tools || [];\n }\n\n /**\n * Call a tool on the MCP server\n */\n async callTool(name: string, args: Record): Promise {\n const response = await this.sendRequest('tools/call', {\n name,\n arguments: args,\n });\n return response as MCPToolCallResult;\n }\n\n /**\n * Send a JSON-RPC request to the MCP server\n */\n private async sendRequest(method: string, params: unknown): Promise {\n if (this.config.type === 'hosted') {\n // For hosted MCP wrappers, we'll use internal routing\n throw new Error('Hosted MCP servers should use direct method calls');\n }\n\n if (!this.config.endpoint) {\n throw new Error('Remote MCP server requires an endpoint');\n }\n\n const request: JSONRPCRequest = {\n jsonrpc: '2.0',\n id: ++this.requestId,\n method,\n params,\n };\n\n // Dispatch based on transport type\n if (this.config.transportType === 'sse' && this.sseTransport) {\n return this.sendViaTransport(this.sseTransport, request);\n } else if (this.streamableHTTPTransport) {\n return this.sendViaTransport(this.streamableHTTPTransport, request);\n } else {\n throw new Error('No transport configured');\n }\n }\n\n /**\n * Send request via transport (SSE or Streamable HTTP)\n */\n private async sendViaTransport(\n transport: SSETransport | StreamableHTTPTransport,\n request: JSONRPCRequest\n ): Promise {\n const response = await transport.sendRequest(request);\n\n if (response.error) {\n throw new Error(`MCP error: ${response.error.message} (code: ${response.error.code})`);\n }\n\n return response.result;\n }\n\n /**\n * Send a JSON-RPC notification (no response expected)\n */\n private async sendNotification(method: string, params: unknown): Promise {\n if (this.config.type === 'hosted' || !this.config.endpoint) {\n return; // Skip for hosted servers\n }\n\n const notification = {\n jsonrpc: '2.0',\n method,\n params,\n };\n\n const headers: Record = {\n 'Content-Type': 'application/json',\n };\n\n if (\n (this.config.authType === 'bearer' || this.config.authType === 'oauth') &&\n this.config.credentials?.token\n ) {\n headers['Authorization'] = `Bearer ${this.config.credentials.token}`;\n }\n\n await fetch(this.config.endpoint, {\n method: 'POST',\n headers,\n body: JSON.stringify(notification),\n });\n }\n}\n\n/**\n * Abstract base class for hosted MCP wrappers\n * Implement this to create MCP-compatible wrappers for APIs like Gmail, Google Docs\n */\nexport abstract class HostedMCPServer {\n abstract readonly name: string;\n abstract readonly description: string;\n\n /**\n * Get all tools provided by this MCP server\n */\n abstract getTools(): MCPToolSchema[];\n\n /**\n * Call a tool with the given arguments\n */\n abstract callTool(name: string, args: Record): Promise;\n\n /**\n * Helper to create a text content response\n */\n protected textContent(text: string): MCPToolCallResult {\n return {\n content: [{ type: 'text', text }],\n };\n }\n\n /**\n * Helper to create an error response\n */\n protected errorContent(message: string): MCPToolCallResult {\n return {\n content: [{ type: 'text', text: message }],\n isError: true,\n };\n }\n\n /**\n * Helper to create a JSON response\n */\n protected jsonContent(data: unknown): MCPToolCallResult {\n return {\n content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],\n };\n }\n}\n\n/**\n * Registry for managing multiple MCP servers\n */\nexport class MCPRegistry {\n private remoteClients = new Map();\n private hostedServers = new Map();\n private toolCache = new Map();\n\n /**\n * Register a remote MCP server\n */\n registerRemote(config: MCPServerConfig): MCPClient {\n const client = new MCPClient(config);\n this.remoteClients.set(config.id, client);\n return client;\n }\n\n /**\n * Register a hosted MCP server\n */\n registerHosted(id: string, server: HostedMCPServer): void {\n this.hostedServers.set(id, server);\n }\n\n /**\n * Get all tools from all registered servers\n */\n async getAllTools(): Promise> {\n const allTools = new Map();\n\n // Get tools from remote servers\n for (const [id, client] of this.remoteClients) {\n try {\n const tools = await client.listTools();\n allTools.set(id, tools);\n this.toolCache.set(id, tools);\n } catch (error) {\n logger.mcp.error('Failed to get tools', { serverId: id, error: error instanceof Error ? error.message : String(error) });\n // Use cached if available\n const cached = this.toolCache.get(id);\n if (cached) {\n allTools.set(id, cached);\n }\n }\n }\n\n // Get tools from hosted servers\n for (const [id, server] of this.hostedServers) {\n const tools = server.getTools();\n allTools.set(id, tools);\n }\n\n return allTools;\n }\n\n /**\n * Call a tool on a specific server\n */\n async callTool(\n serverId: string,\n toolName: string,\n args: Record\n ): Promise {\n const hostedServer = this.hostedServers.get(serverId);\n if (hostedServer) {\n return hostedServer.callTool(toolName, args);\n }\n\n const remoteClient = this.remoteClients.get(serverId);\n if (remoteClient) {\n return remoteClient.callTool(toolName, args);\n }\n\n throw new Error(`MCP server not found: ${serverId}`);\n }\n\n /**\n * Get a specific server's client\n */\n getClient(serverId: string): MCPClient | undefined {\n return this.remoteClients.get(serverId);\n }\n\n /**\n * Get a hosted server\n */\n getHosted(serverId: string): HostedMCPServer | undefined {\n return this.hostedServers.get(serverId);\n }\n\n /**\n * Remove a server from the registry\n */\n remove(serverId: string): void {\n this.remoteClients.delete(serverId);\n this.hostedServers.delete(serverId);\n this.toolCache.delete(serverId);\n }\n}\n" }, { "path": "worker/mcp/SchemaConverter.ts", "content": "/**\n * SchemaConverter - Convert MCP tool schemas to TypeScript declarations\n *\n * Takes MCP tool schemas (JSON Schema format) and generates TypeScript\n * declarations that can be used by the planning agent to generate code.\n */\n\nimport type { MCPToolSchema, JSONSchema } from './MCPClient';\n\nexport interface TypeScriptDeclaration {\n serverId: string;\n serverName: string;\n declaration: string;\n}\n\n/**\n * Convert a collection of MCP tool schemas to TypeScript declarations\n */\nexport function mcpToolsToTypeScript(\n serverTools: Map\n): string {\n const declarations: string[] = [];\n\n declarations.push('// Auto-generated TypeScript declarations from MCP tool schemas');\n declarations.push('// Do not edit manually - regenerate from MCP servers');\n declarations.push('');\n\n for (const [serverId, { name, tools }] of serverTools) {\n const serverDeclaration = generateServerDeclaration(serverId, name, tools);\n declarations.push(serverDeclaration);\n declarations.push('');\n }\n\n // Add the workflow context declaration\n declarations.push(generateWorkflowContextDeclaration());\n\n return declarations.join('\\n');\n}\n\n/**\n * Generate TypeScript declaration for a single MCP server\n */\nfunction generateServerDeclaration(\n serverId: string,\n serverName: string,\n tools: MCPToolSchema[]\n): string {\n const lines: string[] = [];\n\n // Sanitize server name for use as variable name\n const varName = sanitizeIdentifier(serverName);\n\n lines.push(`/** MCP Server: ${serverName} (${serverId}) */`);\n lines.push(`declare const ${varName}: {`);\n\n for (const tool of tools) {\n const methodDeclaration = generateToolMethodDeclaration(tool);\n lines.push(methodDeclaration);\n }\n\n lines.push('};');\n\n return lines.join('\\n');\n}\n\n/**\n * Generate TypeScript method declaration for a single tool\n */\nfunction generateToolMethodDeclaration(tool: MCPToolSchema): string {\n const lines: string[] = [];\n const methodName = sanitizeIdentifier(tool.name);\n\n // Add JSDoc comment\n if (tool.description) {\n lines.push(` /**`);\n lines.push(` * ${tool.description}`);\n\n // Add parameter descriptions from schema\n if (tool.inputSchema.properties) {\n for (const [propName, prop] of Object.entries(tool.inputSchema.properties)) {\n if (prop.description) {\n const required = tool.inputSchema.required?.includes(propName) ? '' : ' (optional)';\n lines.push(` * @param ${propName} - ${prop.description}${required}`);\n }\n }\n }\n\n // Add return type info if we have outputSchema\n if (tool.outputSchema) {\n lines.push(` * @returns ${tool.outputSchema.description || 'Tool result in structuredContent'}`);\n }\n\n lines.push(` */`);\n }\n\n // Generate the method signature with specific return type if outputSchema is present\n const inputType = jsonSchemaToTypeScript(tool.inputSchema, 2);\n let returnType = 'MCPToolResult';\n\n if (tool.outputSchema) {\n const outputType = jsonSchemaToTypeScript(tool.outputSchema, 2);\n returnType = `MCPToolResult<${outputType}>`;\n }\n\n lines.push(` ${methodName}(params: ${inputType}): Promise<${returnType}>;`);\n\n return lines.join('\\n');\n}\n\n/**\n * Convert JSON Schema to TypeScript type string\n */\nfunction jsonSchemaToTypeScript(schema: JSONSchema, indent = 0): string {\n // Handle union types\n if (schema.anyOf) {\n const types = schema.anyOf.map(s => jsonSchemaToTypeScript(s, indent));\n return types.join(' | ');\n }\n if (schema.oneOf) {\n const types = schema.oneOf.map(s => jsonSchemaToTypeScript(s, indent));\n return types.join(' | ');\n }\n\n // Handle enum types\n if (schema.enum) {\n const enumValues = schema.enum.map(v => {\n if (typeof v === 'string') return `'${v}'`;\n return String(v);\n });\n return enumValues.join(' | ');\n }\n\n switch (schema.type) {\n case 'object':\n return generateObjectType(schema, indent);\n\n case 'array':\n if (schema.items) {\n const itemType = jsonSchemaToTypeScript(schema.items, indent);\n return `${itemType}[]`;\n }\n return 'unknown[]';\n\n case 'string':\n if (schema.format === 'date-time') return 'string'; // ISO date string\n if (schema.format === 'uri') return 'string';\n return 'string';\n\n case 'number':\n case 'integer':\n return 'number';\n\n case 'boolean':\n return 'boolean';\n\n case 'null':\n return 'null';\n\n default:\n return 'unknown';\n }\n}\n\n/**\n * Generate TypeScript object type from JSON Schema\n */\nfunction generateObjectType(schema: JSONSchema, indent: number): string {\n if (!schema.properties || Object.keys(schema.properties).length === 0) {\n return 'Record';\n }\n\n const indentStr = ' '.repeat(indent);\n const propIndent = ' '.repeat(indent + 1);\n const lines: string[] = ['{'];\n\n for (const [propName, propSchema] of Object.entries(schema.properties)) {\n const isRequired = schema.required?.includes(propName);\n const optional = isRequired ? '' : '?';\n const propType = jsonSchemaToTypeScript(propSchema, indent + 1);\n\n // Add property description as inline comment if short\n let comment = '';\n if (propSchema.description && propSchema.description.length < 60) {\n comment = ` // ${propSchema.description}`;\n }\n\n lines.push(`${propIndent}${sanitizePropertyName(propName)}${optional}: ${propType};${comment}`);\n }\n\n lines.push(`${indentStr}}`);\n return lines.join('\\n');\n}\n\n/**\n * Generate the workflow context declaration\n */\nfunction generateWorkflowContextDeclaration(): string {\n return `\n/** Result from an MCP tool call */\ninterface MCPToolResult {\n content: Array<{\n type: 'text' | 'image' | 'resource';\n text?: string;\n data?: string;\n mimeType?: string;\n }>;\n /** Typed result data - use this instead of parsing content[0].text */\n structuredContent: T;\n isError?: boolean;\n}\n\n/** Sandbox session info returned from createSession */\ninterface SandboxSession {\n sessionId: string;\n workDir: string;\n branch?: string;\n}\n\n/** Claude Code execution result */\ninterface ClaudeRunResult {\n success: boolean;\n output: string;\n filesModified: string[];\n exitCode: number;\n}\n\n/** Git diff result */\ninterface DiffResult {\n diff: string;\n stats: {\n files: number;\n additions: number;\n deletions: number;\n };\n}\n\n/** Git commit result */\ninterface CommitResult {\n success: boolean;\n commitHash: string;\n}\n\n/** Git push result */\ninterface PushResult {\n success: boolean;\n ref: string;\n}\n\n/** Sandbox MCP Server - always available for code execution tasks */\ndeclare const Sandbox: {\n /** Create a sandbox session, optionally clone a repository */\n createSession(params: {\n repoUrl?: string; // GitHub URL (token auto-injected)\n branch?: string; // Branch to checkout (default: main)\n workDir?: string; // Directory name (default: repo)\n }): Promise>;\n\n /** Execute Claude Code CLI with a task */\n runClaude(params: {\n sessionId: string;\n task: string; // Task description\n context?: string; // Additional context from previous steps\n timeout?: number; // Timeout in seconds (default: 600)\n }): Promise>;\n\n /** Get git diff of uncommitted changes */\n getDiff(params: {\n sessionId: string;\n staged?: boolean; // Only staged changes (default: false)\n }): Promise>;\n\n /** Commit current changes */\n commit(params: {\n sessionId: string;\n message: string;\n }): Promise>;\n\n /** Push commits to remote */\n push(params: {\n sessionId: string;\n branch?: string;\n }): Promise>;\n\n /** Read a file from the sandbox */\n readFile(params: {\n sessionId: string;\n path: string;\n }): Promise>;\n\n /** Write a file to the sandbox */\n writeFile(params: {\n sessionId: string;\n path: string;\n content: string;\n }): Promise>;\n\n /** Execute a shell command */\n exec(params: {\n sessionId: string;\n command: string;\n cwd?: string;\n timeout?: number;\n }): Promise>;\n\n /** Cleanup and destroy a sandbox session */\n destroySession(params: {\n sessionId: string;\n }): Promise>;\n};\n\n/** Workflow execution context */\ndeclare const ctx: {\n /** Mark the start of a named step for progress tracking */\n step(id: string): void;\n\n /** Log a message during workflow execution */\n log(message: string): void;\n\n /** Pause workflow for human approval */\n checkpoint(options: {\n message: string;\n data?: Record;\n actions?: string[];\n }): Promise<{ action: string; [key: string]: unknown }>;\n\n /** Input parameters passed to the workflow */\n input: Record;\n\n /** Results from previous steps, keyed by step ID */\n stepResults: Record;\n};\n`;\n}\n\n/**\n * Sanitize a string to be a valid TypeScript identifier\n */\nfunction sanitizeIdentifier(name: string): string {\n // Replace non-alphanumeric characters with underscores\n let sanitized = name.replace(/[^a-zA-Z0-9_]/g, '_');\n\n // Ensure it doesn't start with a number\n if (/^[0-9]/.test(sanitized)) {\n sanitized = '_' + sanitized;\n }\n\n // Handle reserved words\n const reserved = ['break', 'case', 'catch', 'continue', 'debugger', 'default',\n 'delete', 'do', 'else', 'finally', 'for', 'function', 'if', 'in',\n 'instanceof', 'new', 'return', 'switch', 'this', 'throw', 'try',\n 'typeof', 'var', 'void', 'while', 'with', 'class', 'const', 'enum',\n 'export', 'extends', 'import', 'super', 'implements', 'interface',\n 'let', 'package', 'private', 'protected', 'public', 'static', 'yield'];\n\n if (reserved.includes(sanitized.toLowerCase())) {\n sanitized = sanitized + '_';\n }\n\n return sanitized;\n}\n\n/**\n * Sanitize a property name (may need quoting)\n */\nfunction sanitizePropertyName(name: string): string {\n // If it's a valid identifier, use as-is\n if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)) {\n return name;\n }\n\n // Otherwise, quote it\n return `'${name.replace(/'/g, \"\\\\'\")}'`;\n}\n\n/**\n * Generate a summary of available tools for the planning prompt\n */\nexport function generateToolsSummary(\n serverTools: Map\n): string {\n const lines: string[] = [];\n lines.push('## Available MCP Tools\\n');\n\n for (const [serverId, { name, tools }] of serverTools) {\n lines.push(`### ${name} (${serverId})`);\n lines.push('');\n\n for (const tool of tools) {\n lines.push(`- **${tool.name}**: ${tool.description || 'No description'}`);\n\n // List parameters\n if (tool.inputSchema.properties) {\n const params = Object.entries(tool.inputSchema.properties)\n .map(([pName]) => {\n const required = tool.inputSchema.required?.includes(pName) ? '' : '?';\n return `\\`${pName}${required}\\``;\n })\n .join(', ');\n\n if (params) {\n lines.push(` - Parameters: ${params}`);\n }\n }\n }\n\n lines.push('');\n }\n\n return lines.join('\\n');\n}\n" }, { "path": "worker/mcp/index.ts", "content": "/**\n * MCP (Model Context Protocol) module\n *\n * Provides infrastructure for connecting to MCP servers and converting\n * their tool schemas to TypeScript for use by the planning agent.\n */\n\nexport {\n MCPClient,\n MCPRegistry,\n HostedMCPServer,\n type MCPServerConfig,\n type MCPToolSchema,\n type MCPToolCallResult,\n type MCPContent,\n type JSONSchema,\n type JSONSchemaProperty,\n} from './MCPClient';\n\nexport {\n mcpToolsToTypeScript,\n generateToolsSummary,\n type TypeScriptDeclaration,\n} from './SchemaConverter';\n\nexport {\n MCPBridge,\n createWorkflowContext,\n createMCPProxies,\n type MCPBridgeConfig,\n type ToolCallRequest,\n type ToolCallResponse,\n} from './MCPBridge';\n" }, { "path": "worker/mcp/oauth/discovery.ts", "content": "/**\n * OAuth endpoint discovery for MCP servers\n *\n * Implements RFC 9728 (Protected Resource Metadata) and\n * RFC 8414 (Authorization Server Metadata) discovery.\n */\n\nimport type {\n OAuthProtectedResourceMetadata,\n OAuthAuthorizationServerMetadata,\n MCPOAuthMetadata,\n OAuthDiscoveryResult,\n} from './types';\nimport { logger } from '../../utils/logger';\n\nconst DISCOVERY_TIMEOUT = 10000; // 10 seconds\n\n/**\n * Discover OAuth endpoints for an MCP server\n *\n * Tries multiple discovery methods:\n * 1. Protected Resource Metadata (/.well-known/oauth-protected-resource) -> auth server metadata\n * 2. Direct Authorization Server Metadata (/.well-known/oauth-authorization-server)\n * 3. OpenID Connect Discovery (/.well-known/openid-configuration)\n */\nexport async function discoverOAuthEndpoints(mcpServerUrl: string): Promise {\n try {\n // Normalize URL\n const baseUrl = new URL(mcpServerUrl);\n baseUrl.pathname = baseUrl.pathname.replace(/\\/$/, '');\n\n // Method 1: Try Protected Resource Metadata first (RFC 9728)\n const protectedResourceMetadata = await fetchProtectedResourceMetadata(baseUrl.origin);\n\n let authServerMetadata: OAuthAuthorizationServerMetadata | null = null;\n let authServerUrl = baseUrl.origin;\n\n if (protectedResourceMetadata?.authorization_servers?.length) {\n // Follow the protected resource metadata to the auth server\n authServerUrl = protectedResourceMetadata.authorization_servers[0];\n authServerMetadata = await fetchAuthorizationServerMetadata(authServerUrl);\n }\n\n // Method 2: If protected resource didn't work, try direct auth server metadata\n if (!authServerMetadata) {\n authServerMetadata = await fetchAuthorizationServerMetadata(baseUrl.origin);\n }\n\n // If we still don't have metadata, fail\n if (!authServerMetadata) {\n return {\n success: false,\n error: 'Could not discover OAuth endpoints. Server may not support OAuth.',\n };\n }\n\n // Validate required fields\n if (!authServerMetadata.authorization_endpoint) {\n return {\n success: false,\n error: 'Authorization server metadata missing authorization_endpoint',\n };\n }\n\n if (!authServerMetadata.token_endpoint) {\n return {\n success: false,\n error: 'Authorization server metadata missing token_endpoint',\n };\n }\n\n // Check PKCE support (required for MCP)\n const supportsPKCE = authServerMetadata.code_challenge_methods_supported?.includes('S256');\n if (!supportsPKCE) {\n logger.mcpOAuth.warn('Authorization server does not advertise S256 PKCE support, proceeding anyway');\n }\n\n // Build combined metadata\n const metadata: MCPOAuthMetadata = {\n resource: protectedResourceMetadata?.resource || authServerMetadata.issuer || baseUrl.origin,\n authorizationServer: authServerMetadata.issuer || authServerUrl,\n scopesSupported: protectedResourceMetadata?.scopes_supported || authServerMetadata.scopes_supported,\n authorizationEndpoint: authServerMetadata.authorization_endpoint,\n tokenEndpoint: authServerMetadata.token_endpoint,\n registrationEndpoint: authServerMetadata.registration_endpoint,\n revocationEndpoint: authServerMetadata.revocation_endpoint,\n codeChallengeMethodsSupported: authServerMetadata.code_challenge_methods_supported,\n cachedAt: new Date().toISOString(),\n };\n\n return {\n success: true,\n metadata,\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : 'Unknown error during OAuth discovery';\n return {\n success: false,\n error: message,\n };\n }\n}\n\n/**\n * Fetch OAuth Protected Resource Metadata\n * Tries multiple endpoints per RFC 9728\n */\nasync function fetchProtectedResourceMetadata(baseUrl: string): Promise {\n const endpoints = [\n `${baseUrl}/.well-known/oauth-protected-resource`,\n ];\n\n for (const endpoint of endpoints) {\n try {\n const response = await fetchWithTimeout(endpoint, {\n headers: {\n 'Accept': 'application/json',\n },\n });\n\n if (response.ok) {\n const data = await response.json() as OAuthProtectedResourceMetadata;\n return data;\n }\n } catch (error) {\n logger.mcpOAuth.warn('Failed to fetch protected resource metadata', { endpoint, error: error instanceof Error ? error.message : String(error) });\n }\n }\n\n return null;\n}\n\n/**\n * Fetch OAuth Authorization Server Metadata\n * Tries multiple endpoints per RFC 8414\n */\nasync function fetchAuthorizationServerMetadata(authServerUrl: string): Promise {\n const url = new URL(authServerUrl);\n\n // Build endpoints to try based on RFC 8414\n const endpoints: string[] = [];\n\n if (url.pathname && url.pathname !== '/') {\n // Server with path: try path-specific first\n endpoints.push(`${url.origin}/.well-known/oauth-authorization-server${url.pathname}`);\n endpoints.push(`${url.origin}/.well-known/openid-configuration${url.pathname}`);\n endpoints.push(`${authServerUrl}/.well-known/openid-configuration`);\n } else {\n // Server at root\n endpoints.push(`${url.origin}/.well-known/oauth-authorization-server`);\n endpoints.push(`${url.origin}/.well-known/openid-configuration`);\n }\n\n for (const endpoint of endpoints) {\n try {\n const response = await fetchWithTimeout(endpoint, {\n headers: {\n 'Accept': 'application/json',\n },\n });\n\n if (response.ok) {\n const data = await response.json() as OAuthAuthorizationServerMetadata;\n\n // Validate issuer matches (security check per RFC 8414)\n if (data.issuer && data.issuer !== authServerUrl && data.issuer !== url.origin) {\n logger.mcpOAuth.warn('Issuer mismatch', { expected: authServerUrl, got: data.issuer });\n // Continue to try other endpoints\n continue;\n }\n\n return data;\n }\n } catch (error) {\n logger.mcpOAuth.warn('Failed to fetch auth server metadata', { endpoint, error: error instanceof Error ? error.message : String(error) });\n }\n }\n\n return null;\n}\n\n/**\n * Fetch with timeout\n */\nasync function fetchWithTimeout(url: string, options: RequestInit = {}): Promise {\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), DISCOVERY_TIMEOUT);\n\n try {\n const response = await fetch(url, {\n ...options,\n signal: controller.signal,\n });\n return response;\n } finally {\n clearTimeout(timeoutId);\n }\n}\n" }, { "path": "worker/mcp/oauth/flow.ts", "content": "/**\n * OAuth flow utilities for MCP servers\n *\n * Handles authorization URL building and token exchange.\n */\n\nimport type {\n MCPOAuthMetadata,\n OAuthTokenResponse,\n OAuthErrorResponse,\n OAuthTokenExchangeResult,\n OAuthClientRegistrationResponse,\n OAuthClientRegistrationResult,\n} from './types';\n\nconst TOKEN_EXCHANGE_TIMEOUT = 30000; // 30 seconds\nconst REGISTRATION_TIMEOUT = 10000; // 10 seconds\n\n/**\n * Register a client dynamically with the OAuth server (RFC 7591)\n */\nexport async function registerClient(\n metadata: MCPOAuthMetadata,\n params: {\n redirectUri: string;\n clientName?: string;\n }\n): Promise {\n if (!metadata.registrationEndpoint) {\n return {\n success: false,\n error: 'Server does not support dynamic client registration',\n };\n }\n\n try {\n const registrationRequest = {\n redirect_uris: [params.redirectUri],\n client_name: params.clientName || 'Weft MCP Client',\n token_endpoint_auth_method: 'none', // Public client (browser-based)\n grant_types: ['authorization_code', 'refresh_token'],\n response_types: ['code'],\n };\n\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), REGISTRATION_TIMEOUT);\n\n try {\n const response = await fetch(metadata.registrationEndpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'Accept': 'application/json',\n },\n body: JSON.stringify(registrationRequest),\n signal: controller.signal,\n });\n\n const data = await response.json();\n\n if (!response.ok) {\n const errorData = data as OAuthErrorResponse;\n return {\n success: false,\n error: errorData.error_description || errorData.error || 'Client registration failed',\n };\n }\n\n const regData = data as OAuthClientRegistrationResponse;\n\n return {\n success: true,\n clientId: regData.client_id,\n clientSecret: regData.client_secret,\n };\n } finally {\n clearTimeout(timeoutId);\n }\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n return {\n success: false,\n error: 'Client registration timed out',\n };\n }\n\n const message = error instanceof Error ? error.message : 'Unknown error during client registration';\n return {\n success: false,\n error: message,\n };\n }\n}\n\n/**\n * Build OAuth authorization URL with PKCE\n */\nexport function buildAuthorizationUrl(\n metadata: MCPOAuthMetadata,\n params: {\n clientId: string;\n redirectUri: string;\n state: string;\n codeChallenge: string;\n scopes?: string[];\n includeResource?: boolean; // Some servers don't support RFC 8707\n }\n): string {\n const url = new URL(metadata.authorizationEndpoint);\n\n // Required parameters\n url.searchParams.set('response_type', 'code');\n url.searchParams.set('client_id', params.clientId);\n url.searchParams.set('redirect_uri', params.redirectUri);\n url.searchParams.set('state', params.state);\n\n // PKCE parameters (mandatory for MCP)\n url.searchParams.set('code_challenge', params.codeChallenge);\n url.searchParams.set('code_challenge_method', 'S256');\n\n // Resource indicator (RFC 8707) - optional, some servers don't support it\n if (params.includeResource !== false) {\n // Only include if explicitly requested or by default for servers that might support it\n // But skip for now as many servers reject it\n }\n\n // Scopes\n if (params.scopes && params.scopes.length > 0) {\n url.searchParams.set('scope', params.scopes.join(' '));\n } else if (metadata.scopesSupported && metadata.scopesSupported.length > 0) {\n // Use all supported scopes if none specified\n url.searchParams.set('scope', metadata.scopesSupported.join(' '));\n }\n\n return url.toString();\n}\n\n/**\n * Exchange authorization code for tokens\n */\nexport async function exchangeCodeForTokens(\n metadata: MCPOAuthMetadata,\n params: {\n code: string;\n codeVerifier: string;\n clientId: string;\n redirectUri: string;\n }\n): Promise {\n try {\n const body = new URLSearchParams();\n body.set('grant_type', 'authorization_code');\n body.set('code', params.code);\n body.set('code_verifier', params.codeVerifier);\n body.set('client_id', params.clientId);\n body.set('redirect_uri', params.redirectUri);\n\n // Note: Resource indicator (RFC 8707) omitted - many servers don't support it\n\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), TOKEN_EXCHANGE_TIMEOUT);\n\n try {\n const response = await fetch(metadata.tokenEndpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/x-www-form-urlencoded',\n 'Accept': 'application/json',\n },\n body: body.toString(),\n signal: controller.signal,\n });\n\n const data = await response.json();\n\n if (!response.ok) {\n const errorData = data as OAuthErrorResponse;\n return {\n success: false,\n error: errorData.error_description || errorData.error || 'Token exchange failed',\n };\n }\n\n const tokenData = data as OAuthTokenResponse;\n\n // Calculate expiration time\n let expiresAt: string | undefined;\n if (tokenData.expires_in) {\n const expiresAtDate = new Date(Date.now() + tokenData.expires_in * 1000);\n expiresAt = expiresAtDate.toISOString();\n }\n\n return {\n success: true,\n accessToken: tokenData.access_token,\n refreshToken: tokenData.refresh_token,\n expiresAt,\n scope: tokenData.scope,\n };\n } finally {\n clearTimeout(timeoutId);\n }\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n return {\n success: false,\n error: 'Token exchange timed out',\n };\n }\n\n const message = error instanceof Error ? error.message : 'Unknown error during token exchange';\n return {\n success: false,\n error: message,\n };\n }\n}\n\n/**\n * Refresh an access token using a refresh token\n */\nexport async function refreshAccessToken(\n metadata: MCPOAuthMetadata,\n params: {\n refreshToken: string;\n clientId: string;\n }\n): Promise {\n try {\n const body = new URLSearchParams();\n body.set('grant_type', 'refresh_token');\n body.set('refresh_token', params.refreshToken);\n body.set('client_id', params.clientId);\n\n // Note: Resource indicator (RFC 8707) omitted - many servers don't support it\n\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), TOKEN_EXCHANGE_TIMEOUT);\n\n try {\n const response = await fetch(metadata.tokenEndpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/x-www-form-urlencoded',\n 'Accept': 'application/json',\n },\n body: body.toString(),\n signal: controller.signal,\n });\n\n const data = await response.json();\n\n if (!response.ok) {\n const errorData = data as OAuthErrorResponse;\n return {\n success: false,\n error: errorData.error_description || errorData.error || 'Token refresh failed',\n };\n }\n\n const tokenData = data as OAuthTokenResponse;\n\n // Calculate expiration time\n let expiresAt: string | undefined;\n if (tokenData.expires_in) {\n const expiresAtDate = new Date(Date.now() + tokenData.expires_in * 1000);\n expiresAt = expiresAtDate.toISOString();\n }\n\n return {\n success: true,\n accessToken: tokenData.access_token,\n // New refresh token may be issued (token rotation)\n refreshToken: tokenData.refresh_token,\n expiresAt,\n scope: tokenData.scope,\n };\n } finally {\n clearTimeout(timeoutId);\n }\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n return {\n success: false,\n error: 'Token refresh timed out',\n };\n }\n\n const message = error instanceof Error ? error.message : 'Unknown error during token refresh';\n return {\n success: false,\n error: message,\n };\n }\n}\n" }, { "path": "worker/mcp/oauth/index.ts", "content": "/**\n * MCP OAuth module exports\n */\n\nexport * from './types';\nexport * from './pkce';\nexport * from './discovery';\nexport {\n buildAuthorizationUrl,\n exchangeCodeForTokens,\n refreshAccessToken,\n registerClient,\n} from './flow';\n" }, { "path": "worker/mcp/oauth/pkce.ts", "content": "/**\n * PKCE (Proof Key for Code Exchange) utilities for MCP OAuth\n *\n * Implements RFC 7636 for secure OAuth authorization code flow.\n */\n\n/**\n * Generate a cryptographically random code verifier\n * Must be 43-128 characters, using unreserved URI characters\n */\nexport function generateCodeVerifier(): string {\n const array = new Uint8Array(96); // Will produce 128 base64url chars\n crypto.getRandomValues(array);\n return base64UrlEncode(array);\n}\n\n/**\n * Generate code challenge from verifier using SHA-256\n * code_challenge = BASE64URL(SHA256(code_verifier))\n */\nexport async function generateCodeChallenge(verifier: string): Promise {\n const encoder = new TextEncoder();\n const data = encoder.encode(verifier);\n const digest = await crypto.subtle.digest('SHA-256', data);\n return base64UrlEncode(new Uint8Array(digest));\n}\n\n/**\n * Generate a secure random state parameter for CSRF protection\n * Encodes boardId, serverId, and a random nonce\n */\nexport function generateState(boardId: string, serverId: string): string {\n const nonce = generateNonce();\n const stateData = {\n boardId,\n serverId,\n nonce,\n timestamp: Date.now(),\n };\n return base64UrlEncode(new TextEncoder().encode(JSON.stringify(stateData)));\n}\n\n/**\n * Parse and validate state parameter\n * Returns null if invalid or tampered\n */\nexport function parseState(state: string): { boardId: string; serverId: string; nonce: string; timestamp: number } | null {\n try {\n const decoded = base64UrlDecode(state);\n const text = new TextDecoder().decode(decoded);\n const data = JSON.parse(text);\n\n if (!data.boardId || !data.serverId || !data.nonce || !data.timestamp) {\n return null;\n }\n\n return data;\n } catch {\n return null;\n }\n}\n\n/**\n * Generate a random nonce for state parameter\n */\nfunction generateNonce(): string {\n const array = new Uint8Array(32);\n crypto.getRandomValues(array);\n return base64UrlEncode(array);\n}\n\n/**\n * Base64 URL encode (RFC 4648 Section 5)\n * - No padding\n * - URL-safe characters (+ -> -, / -> _)\n */\nfunction base64UrlEncode(data: Uint8Array): string {\n const base64 = btoa(String.fromCharCode(...data));\n return base64\n .replace(/\\+/g, '-')\n .replace(/\\//g, '_')\n .replace(/=+$/, '');\n}\n\n/**\n * Base64 URL decode\n */\nfunction base64UrlDecode(str: string): Uint8Array {\n const padded = str + '='.repeat((4 - str.length % 4) % 4);\n const base64 = padded.replace(/-/g, '+').replace(/_/g, '/');\n const binary = atob(base64);\n const bytes = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n bytes[i] = binary.charCodeAt(i);\n }\n return bytes;\n}\n" }, { "path": "worker/mcp/oauth/types.ts", "content": "/**\n * OAuth types for MCP server authentication\n *\n * Based on RFC 8414 (OAuth Authorization Server Metadata),\n * RFC 9728 (OAuth Protected Resource Metadata), and MCP spec.\n */\n\n/**\n * OAuth Protected Resource Metadata (RFC 9728)\n * Retrieved from /.well-known/oauth-protected-resource\n */\nexport interface OAuthProtectedResourceMetadata {\n resource: string;\n authorization_servers: string[];\n scopes_supported?: string[];\n bearer_methods_supported?: string[];\n resource_documentation?: string;\n resource_signing_alg_values_supported?: string[];\n resource_encryption_alg_values_supported?: string[];\n resource_encryption_enc_values_supported?: string[];\n resource_policy_uri?: string;\n resource_tos_uri?: string;\n jwks_uri?: string;\n}\n\n/**\n * OAuth Authorization Server Metadata (RFC 8414)\n * Retrieved from /.well-known/oauth-authorization-server\n */\nexport interface OAuthAuthorizationServerMetadata {\n issuer: string;\n authorization_endpoint: string;\n token_endpoint: string;\n jwks_uri?: string;\n registration_endpoint?: string;\n scopes_supported?: string[];\n response_types_supported: string[];\n response_modes_supported?: string[];\n grant_types_supported?: string[];\n token_endpoint_auth_methods_supported?: string[];\n token_endpoint_auth_signing_alg_values_supported?: string[];\n service_documentation?: string;\n ui_locales_supported?: string[];\n op_policy_uri?: string;\n op_tos_uri?: string;\n revocation_endpoint?: string;\n revocation_endpoint_auth_methods_supported?: string[];\n introspection_endpoint?: string;\n introspection_endpoint_auth_methods_supported?: string[];\n code_challenge_methods_supported?: string[];\n}\n\n/**\n * Combined OAuth metadata for an MCP server\n * Stored in mcp_servers.oauth_metadata\n */\nexport interface MCPOAuthMetadata {\n // From protected resource metadata\n resource: string;\n authorizationServer: string;\n scopesSupported?: string[];\n\n // From authorization server metadata\n authorizationEndpoint: string;\n tokenEndpoint: string;\n registrationEndpoint?: string;\n revocationEndpoint?: string;\n codeChallengeMethodsSupported?: string[];\n\n // When this was fetched\n cachedAt: string;\n}\n\n/**\n * Pending OAuth authorization state\n * Stored in mcp_oauth_pending table\n */\nexport interface MCPOAuthPending {\n id: string;\n boardId: string;\n serverId: string;\n codeVerifier: string;\n state: string;\n resource: string;\n scopes?: string;\n createdAt: string;\n expiresAt: string;\n}\n\n/**\n * OAuth token response from token endpoint\n */\nexport interface OAuthTokenResponse {\n access_token: string;\n token_type: string;\n expires_in?: number;\n refresh_token?: string;\n scope?: string;\n}\n\n/**\n * OAuth error response\n */\nexport interface OAuthErrorResponse {\n error: string;\n error_description?: string;\n error_uri?: string;\n}\n\n/**\n * Discovery result from discoverOAuthEndpoints\n */\nexport interface OAuthDiscoveryResult {\n success: boolean;\n metadata?: MCPOAuthMetadata;\n error?: string;\n}\n\n/**\n * Authorization URL result\n */\nexport interface OAuthAuthorizationUrlResult {\n success: boolean;\n url?: string;\n state?: string;\n error?: string;\n}\n\n/**\n * Token exchange result\n */\nexport interface OAuthTokenExchangeResult {\n success: boolean;\n accessToken?: string;\n refreshToken?: string;\n expiresAt?: string;\n scope?: string;\n error?: string;\n}\n\n/**\n * Dynamic Client Registration request (RFC 7591)\n */\nexport interface OAuthClientRegistrationRequest {\n redirect_uris: string[];\n client_name?: string;\n token_endpoint_auth_method?: string;\n grant_types?: string[];\n response_types?: string[];\n scope?: string;\n}\n\n/**\n * Dynamic Client Registration response (RFC 7591)\n */\nexport interface OAuthClientRegistrationResponse {\n client_id: string;\n client_secret?: string;\n client_id_issued_at?: number;\n client_secret_expires_at?: number;\n redirect_uris?: string[];\n token_endpoint_auth_method?: string;\n grant_types?: string[];\n response_types?: string[];\n client_name?: string;\n}\n\n/**\n * Client registration result\n */\nexport interface OAuthClientRegistrationResult {\n success: boolean;\n clientId?: string;\n clientSecret?: string;\n error?: string;\n}\n" }, { "path": "worker/sandbox/SandboxMCP.ts", "content": "/**\n * SandboxMCP - Hosted MCP wrapper for Cloudflare Sandbox operations\n *\n * Enables workflows to use Claude Code and git operations as MCP tools,\n * making them composable with other MCP servers like Gmail, GoogleDocs.\n *\n * Credentials (GitHub token, Anthropic API key) are automatically injected -\n * workflow code never sees secrets.\n */\n\nimport { Sandbox } from '@cloudflare/sandbox';\nimport {\n getSandbox,\n parseSSEStream,\n type ExecEvent,\n} from '@cloudflare/sandbox';\nimport { logger } from '../utils/logger';\nimport {\n HostedMCPServer,\n type MCPToolSchema,\n type MCPToolCallResult,\n} from '../mcp/MCPClient';\nimport { toolsToMCPSchemas, parseToolArgs } from '../utils/zodTools';\nimport { sandboxTools } from './sandboxTools';\n\ninterface SandboxCredentials {\n githubToken?: string;\n anthropicApiKey?: string;\n}\n\ninterface ForkInfo {\n forkOwner: string;\n forkRepo: string;\n upstreamOwner: string;\n upstreamRepo: string;\n}\n\ninterface SessionInfo {\n sandboxId: string;\n workDir: string;\n repoUrl?: string;\n branch?: string;\n forkInfo?: ForkInfo;\n}\n\n// Session cache - keyed by sessionId\nconst sessionCache = new Map();\n\n// Common build artifacts and secrets to exclude from git staging\nconst GIT_ADD_EXCLUSIONS = [\n // Python\n ':!**/__pycache__/**',\n ':!*.pyc',\n ':!*.pyo',\n ':!**/.pytest_cache/**',\n ':!**/*.egg-info/**',\n ':!**/.mypy_cache/**',\n ':!**/.ruff_cache/**',\n // Node\n ':!**/node_modules/**',\n ':!**/.next/**',\n ':!**/dist/**',\n // Secrets/env files\n ':!**/.env',\n ':!**/.env.*',\n ':!**/.dev.vars',\n].join(' ');\n\nexport class SandboxMCPServer extends HostedMCPServer {\n readonly name = 'Sandbox';\n readonly description = 'Execute Claude Code and git operations in an isolated sandbox environment';\n\n private sandboxBinding: DurableObjectNamespace;\n private credentials: SandboxCredentials;\n\n private get githubHeaders(): Record {\n return {\n 'Authorization': `Bearer ${this.credentials.githubToken}`,\n 'Accept': 'application/vnd.github+json',\n 'Content-Type': 'application/json',\n 'X-GitHub-Api-Version': '2022-11-28',\n 'User-Agent': 'Weft-Sandbox',\n };\n }\n\n constructor(\n sandboxBinding: DurableObjectNamespace,\n credentials: SandboxCredentials\n ) {\n super();\n this.sandboxBinding = sandboxBinding;\n this.credentials = credentials;\n }\n\n getTools(): MCPToolSchema[] {\n return toolsToMCPSchemas(sandboxTools);\n }\n\n async callTool(name: string, args: Record): Promise {\n try {\n switch (name) {\n case 'createSession':\n return this.createSession(parseToolArgs(sandboxTools.createSession.input, args));\n\n case 'runClaude':\n return this.runClaude(parseToolArgs(sandboxTools.runClaude.input, args));\n\n case 'getDiff':\n return this.getDiff(parseToolArgs(sandboxTools.getDiff.input, args));\n\n case 'commit':\n return this.commit(parseToolArgs(sandboxTools.commit.input, args));\n\n case 'push':\n return this.push(parseToolArgs(sandboxTools.push.input, args));\n\n case 'createPullRequest':\n return this.createPullRequest(parseToolArgs(sandboxTools.createPullRequest.input, args));\n\n case 'readFile':\n return this.readFile(parseToolArgs(sandboxTools.readFile.input, args));\n\n case 'writeFile':\n return this.writeFile(parseToolArgs(sandboxTools.writeFile.input, args));\n\n case 'exec':\n return this.exec(parseToolArgs(sandboxTools.exec.input, args));\n\n case 'destroySession':\n return this.destroySession(parseToolArgs(sandboxTools.destroySession.input, args));\n\n default:\n return this.errorContent(`Unknown tool: ${name}`);\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n return this.errorContent(message);\n }\n }\n\n // ============================================\n // Tool Implementations\n // ============================================\n\n private async createSession(args: {\n repoUrl?: string;\n branch: string;\n workDir: string;\n }): Promise {\n const sessionId = `sandbox-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n const workDir = `/workspace/${args.workDir}`;\n const branch = args.branch;\n\n const sandbox = getSandbox(this.sandboxBinding, sessionId);\n\n // Create workspace\n await sandbox.mkdir('/workspace', { recursive: true });\n\n if (args.repoUrl) {\n let cloneUrl = args.repoUrl;\n\n if (this.credentials.githubToken && cloneUrl.startsWith('https://')) {\n cloneUrl = cloneUrl.replace('https://', `https://${this.credentials.githubToken}@`);\n }\n\n // Clone repository\n const cloneStream = await sandbox.execStream(\n `git clone --depth 1 --branch ${branch} ${cloneUrl} ${workDir}`\n );\n\n for await (const event of parseSSEStream(cloneStream)) {\n if (event.type === 'complete') {\n if (event.exitCode !== 0) {\n return this.errorContent(`Git clone failed with exit code ${event.exitCode}`);\n }\n break;\n }\n if (event.type === 'error') {\n return this.errorContent(`Git clone error: ${event.error}`);\n }\n }\n\n // Configure git\n const setupStream = await sandbox.execStream(\n `cd ${workDir} && ` +\n `git config user.email \"weft-workflow@example.com\" && ` +\n `git config user.name \"Weft\"`\n );\n\n for await (const event of parseSSEStream(setupStream)) {\n if (event.type === 'complete') break;\n }\n } else {\n // Just create the directory\n await sandbox.mkdir(workDir, { recursive: true });\n }\n\n // Store session info\n sessionCache.set(sessionId, {\n sandboxId: sessionId,\n workDir,\n repoUrl: args.repoUrl,\n branch,\n });\n\n return {\n content: [{ type: 'text', text: `Session created: ${sessionId}` }],\n structuredContent: {\n sessionId,\n workDir,\n branch,\n },\n };\n }\n\n // ============================================\n // GitHub Fork Helpers\n // ============================================\n\n /**\n * Parse GitHub URL to extract owner and repo\n */\n private parseGitHubUrl(url: string): { owner: string; repo: string } | null {\n // Supports: https://github.com/owner/repo.git or https://github.com/owner/repo\n // Also handles token-injected URLs: https://token@github.com/owner/repo.git\n const match = url.match(/github\\.com\\/([^/]+)\\/([^/]+?)(?:\\.git)?$/);\n if (!match) return null;\n return { owner: match[1], repo: match[2] };\n }\n\n /**\n * Create a fork of a repository or get existing fork\n * Returns the fork owner (the authenticated user's login)\n */\n private async createOrGetFork(owner: string, repo: string): Promise<{ forkOwner: string; forkRepo: string }> {\n const userResponse = await fetch('https://api.github.com/user', {\n headers: this.githubHeaders,\n });\n\n if (!userResponse.ok) {\n throw new Error(`Failed to get user info: ${userResponse.status}`);\n }\n\n const userData = await userResponse.json() as { login: string };\n const userLogin = userData.login;\n\n const forkResponse = await fetch(`https://api.github.com/repos/${owner}/${repo}/forks`, {\n method: 'POST',\n headers: this.githubHeaders,\n body: JSON.stringify({}),\n });\n\n if (forkResponse.status === 202) {\n // Fork created successfully (202 Accepted)\n const forkData = await forkResponse.json() as { owner: { login: string }; name: string };\n return { forkOwner: forkData.owner.login, forkRepo: forkData.name };\n } else if (forkResponse.status === 422) {\n // Fork already exists - use the user's login\n logger.sandbox.info('Fork already exists, using existing fork', { owner, repo, userLogin });\n return { forkOwner: userLogin, forkRepo: repo };\n } else {\n const errorText = await forkResponse.text();\n throw new Error(`Failed to create fork: ${forkResponse.status} ${errorText}`);\n }\n }\n\n /**\n * Wait for a fork to be ready (GitHub forks are created asynchronously)\n */\n private async waitForForkReady(forkOwner: string, forkRepo: string, maxWaitMs: number = 30000): Promise {\n const startTime = Date.now();\n const pollInterval = 2000;\n\n while (Date.now() - startTime < maxWaitMs) {\n const response = await fetch(`https://api.github.com/repos/${forkOwner}/${forkRepo}`, {\n headers: this.githubHeaders,\n });\n\n if (response.ok) {\n logger.sandbox.info('Fork is ready', { forkOwner, forkRepo });\n return;\n }\n\n await new Promise(resolve => setTimeout(resolve, pollInterval));\n }\n\n throw new Error(`Fork ${forkOwner}/${forkRepo} not ready after ${maxWaitMs}ms`);\n }\n\n private async runClaude(args: {\n sessionId: string;\n task: string;\n context?: string;\n systemPrompt?: string;\n timeout: number;\n }): Promise {\n const session = sessionCache.get(args.sessionId);\n if (!session) {\n return this.errorContent(`Session not found: ${args.sessionId}`);\n }\n\n if (!this.credentials.anthropicApiKey) {\n return this.errorContent('Anthropic API key not configured');\n }\n\n const sandbox = getSandbox(this.sandboxBinding, session.sandboxId);\n\n // Build task instructions\n let taskContent = `# Task Instructions\\n\\n${args.task}`;\n if (args.context) {\n taskContent += `\\n\\n## Context\\n\\n${args.context}`;\n }\n taskContent += `\\n\\n## Working Directory\\n${session.workDir}`;\n taskContent += '\\n\\n## Guidelines\\n- Make minimal, focused changes\\n- Follow existing code style\\n- Do NOT commit changes';\n\n await sandbox.writeFile('/tmp/task.md', taskContent);\n\n const systemPrompt = args.systemPrompt ||\n 'You are an automatic feature-implementer/bug-fixer. Apply all necessary changes to achieve the user request. Do NOT commit changes - the workflow will handle that.';\n\n // Escape the system prompt for shell\n const escapedSystemPrompt = systemPrompt.replace(/'/g, \"'\\\\''\");\n\n // Run Claude directly using execStream for better reliability\n // First check if claude is available\n const checkCmd = `command -v claude && echo \"claude-available\" || echo \"claude-not-found\"`;\n const checkStream = await sandbox.execStream(checkCmd);\n let claudeAvailable = false;\n for await (const event of parseSSEStream(checkStream)) {\n if (event.type === 'stdout' && event.data?.includes('claude-available')) {\n claudeAvailable = true;\n }\n if (event.type === 'complete') break;\n }\n\n if (!claudeAvailable) {\n // List what IS available to help debug\n const lsStream = await sandbox.execStream('ls -la /usr/local/bin 2>/dev/null; echo \"---\"; ls -la /usr/bin 2>/dev/null | head -20');\n let lsOutput = '';\n for await (const event of parseSSEStream(lsStream)) {\n if (event.type === 'stdout') lsOutput += event.data;\n if (event.type === 'complete') break;\n }\n return this.errorContent(`Claude CLI is not installed in the sandbox. Available in /usr/local/bin and /usr/bin:\\n${lsOutput}`);\n }\n\n // Run Claude Code using the same approach as ExecutionWorkflow\n // Uses --permission-mode acceptEdits instead of --dangerously-skip-permissions\n // (the latter doesn't work when running as root in the sandbox)\n const claudeScript = `#!/bin/bash\ncd ${session.workDir}\nexport ANTHROPIC_API_KEY=\"${this.credentials.anthropicApiKey}\"\nclaude --append-system-prompt \"${escapedSystemPrompt}\" -p \"$(cat /tmp/task.md)\" --permission-mode acceptEdits > /tmp/claude-output.txt 2>&1\necho \"---CLAUDE_EXIT_CODE:$?---\" >> /tmp/claude-output.txt\n`;\n\n await sandbox.writeFile('/tmp/run-claude.sh', claudeScript);\n\n logger.sandbox.info('Running Claude', { workDir: session.workDir });\n\n // Start Claude Code as a background process\n const claudeProcess = await sandbox.startProcess('bash /tmp/run-claude.sh');\n\n // Poll for completion (Claude can take several minutes)\n const timeoutSeconds = args.timeout;\n let complete = false;\n let attempts = 0;\n let output = '';\n let exitCode = 0;\n\n while (!complete && attempts < timeoutSeconds) {\n await new Promise((resolve) => setTimeout(resolve, 1000));\n attempts++;\n\n try {\n const outputFile = await sandbox.readFile('/tmp/claude-output.txt');\n if (outputFile.content.includes('---CLAUDE_EXIT_CODE:')) {\n complete = true;\n output = outputFile.content;\n\n const exitCodeMatch = output.match(/---CLAUDE_EXIT_CODE:(\\d+)---/);\n exitCode = exitCodeMatch ? parseInt(exitCodeMatch[1], 10) : 1;\n output = output.replace(/---CLAUDE_EXIT_CODE:\\d+---/, '').trim();\n }\n } catch {\n // File doesn't exist yet\n }\n }\n\n // Kill process if still running\n try {\n await sandbox.killProcess(claudeProcess.id);\n } catch {\n // Process may have already exited\n }\n\n logger.sandbox.info('Claude exited', { exitCode, outputLength: output.length });\n logger.sandbox.debug('Claude output preview', { output: output.slice(0, 500) });\n\n if (!complete) {\n return this.errorContent(`Claude Code timed out after ${timeoutSeconds} seconds`);\n }\n\n // Check for errors\n if (exitCode !== 0) {\n return this.errorContent(`Claude CLI failed with exit code ${exitCode}: ${output.slice(0, 1000)}`);\n }\n\n // Get list of modified files\n const statusStream = await sandbox.execStream(`cd ${session.workDir} && git status --porcelain`);\n let statusOutput = '';\n for await (const event of parseSSEStream(statusStream)) {\n if (event.type === 'stdout') {\n statusOutput += event.data;\n }\n if (event.type === 'complete') break;\n }\n\n const filesModified = statusOutput\n .split('\\n')\n .filter((line) => line.trim())\n .map((line) => line.slice(3).trim());\n\n return {\n content: [{ type: 'text', text: output.slice(0, 500) + (output.length > 500 ? '...' : '') }],\n structuredContent: {\n success: exitCode === 0,\n output,\n filesModified,\n exitCode,\n },\n };\n }\n\n private async getDiff(args: {\n sessionId: string;\n staged: boolean;\n }): Promise {\n const session = sessionCache.get(args.sessionId);\n if (!session) {\n return this.errorContent(`Session not found: ${args.sessionId}`);\n }\n\n const sandbox = getSandbox(this.sandboxBinding, session.sandboxId);\n\n // Stage all changes first to ensure we capture everything (excluding build artifacts)\n if (!args.staged) {\n const addStream = await sandbox.execStream(`cd ${session.workDir} && git add -A -- . ${GIT_ADD_EXCLUSIONS}`);\n for await (const event of parseSSEStream(addStream)) {\n if (event.type === 'complete') break;\n }\n }\n\n // Get diff\n const diffCmd = args.staged\n ? `cd ${session.workDir} && git diff --cached`\n : `cd ${session.workDir} && git diff HEAD`;\n\n const diffStream = await sandbox.execStream(diffCmd);\n let diff = '';\n for await (const event of parseSSEStream(diffStream)) {\n if (event.type === 'stdout') {\n diff += event.data;\n }\n if (event.type === 'complete') break;\n }\n\n // Calculate stats\n const files = (diff.match(/^diff --git/gm) || []).length;\n const additions = (diff.match(/^\\+[^+]/gm) || []).length;\n const deletions = (diff.match(/^-[^-]/gm) || []).length;\n\n return {\n content: [{ type: 'text', text: `${files} files changed, +${additions}/-${deletions}. Use structuredContent.diff and structuredContent.stats for the approval request.` }],\n structuredContent: {\n diff,\n stats: { files, additions, deletions },\n },\n };\n }\n\n private async commit(args: {\n sessionId: string;\n message: string;\n }): Promise {\n const session = sessionCache.get(args.sessionId);\n if (!session) {\n return this.errorContent(`Session not found: ${args.sessionId}`);\n }\n\n const sandbox = getSandbox(this.sandboxBinding, session.sandboxId);\n\n // Stage all changes (excluding build artifacts)\n const addStream = await sandbox.execStream(`cd ${session.workDir} && git add -A -- . ${GIT_ADD_EXCLUSIONS}`);\n for await (const event of parseSSEStream(addStream)) {\n if (event.type === 'complete') break;\n }\n\n // Write commit message to file (avoids shell escaping issues)\n await sandbox.writeFile('/tmp/commit-msg.txt', args.message);\n\n // Commit\n const commitStream = await sandbox.execStream(\n `cd ${session.workDir} && git commit -F /tmp/commit-msg.txt`\n );\n\n let commitOutput = '';\n let exitCode = 0;\n for await (const event of parseSSEStream(commitStream)) {\n if (event.type === 'stdout') {\n commitOutput += event.data;\n }\n if (event.type === 'complete') {\n exitCode = event.exitCode || 0;\n break;\n }\n }\n\n if (exitCode !== 0) {\n return this.errorContent(`Commit failed: ${commitOutput}`);\n }\n\n // Get commit hash\n const hashStream = await sandbox.execStream(`cd ${session.workDir} && git rev-parse HEAD`);\n let commitHash = '';\n for await (const event of parseSSEStream(hashStream)) {\n if (event.type === 'stdout') {\n commitHash = event.data?.trim() || '';\n }\n if (event.type === 'complete') break;\n }\n\n return {\n content: [{ type: 'text', text: `Committed: ${commitHash.slice(0, 8)}` }],\n structuredContent: {\n success: true,\n commitHash,\n },\n };\n }\n\n private async push(args: {\n sessionId: string;\n remote: string;\n branch?: string;\n }): Promise {\n const session = sessionCache.get(args.sessionId);\n if (!session) {\n return this.errorContent(`Session not found: ${args.sessionId}`);\n }\n\n const sandbox = getSandbox(this.sandboxBinding, session.sandboxId);\n const remote = args.remote;\n const branch = args.branch || session.branch || 'main';\n\n const result = await this.pushWithForkFallback(session, sandbox, remote, branch);\n\n if (!result.success) {\n return this.errorContent(`Push failed: ${result.error}`);\n }\n\n const forkNote = result.usedFork ? ' (via fork)' : '';\n return {\n content: [{ type: 'text', text: `Pushed to ${remote}/${branch}${forkNote}` }],\n structuredContent: {\n success: true,\n ref: `${remote}/${branch}`,\n usedFork: result.usedFork,\n },\n };\n }\n\n /**\n * Push with automatic fork fallback if push fails due to permissions\n */\n private async pushWithForkFallback(\n session: SessionInfo,\n sandbox: ReturnType,\n remote: string,\n branch: string\n ): Promise<{ success: boolean; error?: string; usedFork?: boolean }> {\n const pushStream = await sandbox.execStream(\n `cd ${session.workDir} && git push ${remote} HEAD:${branch}`\n );\n\n let pushOutput = '';\n let pushExitCode = 0;\n for await (const event of parseSSEStream(pushStream)) {\n if (event.type === 'stdout' || event.type === 'stderr') {\n pushOutput += event.data || '';\n }\n if (event.type === 'complete') {\n pushExitCode = event.exitCode || 0;\n break;\n }\n }\n\n if (pushExitCode === 0) {\n return { success: true };\n }\n\n // Check if it's a permission error that we can recover from via forking\n const isPermissionError =\n pushOutput.includes('Permission denied') ||\n pushOutput.includes('permission denied') ||\n pushOutput.includes('403') ||\n pushOutput.includes('unable to access') ||\n pushOutput.includes('Authentication failed') ||\n pushOutput.includes('could not read Username');\n\n if (!isPermissionError || !session.repoUrl || !this.credentials.githubToken) {\n return { success: false, error: pushOutput };\n }\n\n const repoInfo = this.parseGitHubUrl(session.repoUrl);\n if (!repoInfo) {\n return { success: false, error: `${pushOutput} (could not parse repo URL for fork fallback)` };\n }\n\n logger.sandbox.info('Push failed due to permissions, attempting fork fallback', {\n sessionId: session.sandboxId,\n owner: repoInfo.owner,\n repo: repoInfo.repo,\n });\n\n try {\n const forkInfo = await this.createOrGetFork(repoInfo.owner, repoInfo.repo);\n await this.waitForForkReady(forkInfo.forkOwner, forkInfo.forkRepo);\n\n const forkUrl = `https://${this.credentials.githubToken}@github.com/${forkInfo.forkOwner}/${forkInfo.forkRepo}.git`;\n\n const addRemoteStream = await sandbox.execStream(\n `cd ${session.workDir} && git remote add fork ${forkUrl} 2>/dev/null || git remote set-url fork ${forkUrl}`\n );\n for await (const event of parseSSEStream(addRemoteStream)) {\n if (event.type === 'complete') break;\n }\n\n const forkPushStream = await sandbox.execStream(\n `cd ${session.workDir} && git push fork HEAD:${branch}`\n );\n\n let forkPushOutput = '';\n let forkPushExitCode = 0;\n for await (const event of parseSSEStream(forkPushStream)) {\n if (event.type === 'stdout' || event.type === 'stderr') {\n forkPushOutput += event.data || '';\n }\n if (event.type === 'complete') {\n forkPushExitCode = event.exitCode || 0;\n break;\n }\n }\n\n if (forkPushExitCode !== 0) {\n return { success: false, error: `Fork push failed: ${forkPushOutput}` };\n }\n\n session.forkInfo = {\n forkOwner: forkInfo.forkOwner,\n forkRepo: forkInfo.forkRepo,\n upstreamOwner: repoInfo.owner,\n upstreamRepo: repoInfo.repo,\n };\n sessionCache.set(session.sandboxId, session);\n\n logger.sandbox.info('Push succeeded via fork', {\n sessionId: session.sandboxId,\n forkOwner: forkInfo.forkOwner,\n forkRepo: forkInfo.forkRepo,\n });\n\n return { success: true, usedFork: true };\n } catch (error) {\n const errorMsg = error instanceof Error ? error.message : String(error);\n return { success: false, error: `${pushOutput} (fork fallback failed: ${errorMsg})` };\n }\n }\n\n private async createPullRequest(args: {\n sessionId: string;\n title: string;\n body: string;\n branch: string;\n base: string;\n commitMessage: string;\n diff: string; // Required for approval but not used in implementation\n }): Promise {\n const session = sessionCache.get(args.sessionId);\n if (!session) {\n return this.errorContent(`Session not found: ${args.sessionId}`);\n }\n\n if (!session.repoUrl) {\n return this.errorContent('Session was not created with a repository URL');\n }\n\n if (!this.credentials.githubToken) {\n return this.errorContent('GitHub token not configured');\n }\n\n // Extract owner/repo from repoUrl\n const repoInfo = this.parseGitHubUrl(session.repoUrl);\n if (!repoInfo) {\n return this.errorContent(`Could not parse repository URL: ${session.repoUrl}`);\n }\n const { owner, repo } = repoInfo;\n\n const sandbox = getSandbox(this.sandboxBinding, session.sandboxId);\n\n // 1. Create and checkout feature branch\n const branchStream = await sandbox.execStream(\n `cd ${session.workDir} && git checkout -b ${args.branch}`\n );\n let branchExitCode = 0;\n for await (const event of parseSSEStream(branchStream)) {\n if (event.type === 'complete') {\n branchExitCode = event.exitCode || 0;\n break;\n }\n }\n if (branchExitCode !== 0) {\n return this.errorContent(`Failed to create branch ${args.branch}`);\n }\n\n // 2. Stage and commit changes\n const addStream = await sandbox.execStream(`cd ${session.workDir} && git add -A -- . ${GIT_ADD_EXCLUSIONS}`);\n for await (const event of parseSSEStream(addStream)) {\n if (event.type === 'complete') break;\n }\n\n await sandbox.writeFile('/tmp/commit-msg.txt', args.commitMessage);\n const commitStream = await sandbox.execStream(\n `cd ${session.workDir} && git commit -F /tmp/commit-msg.txt`\n );\n let commitHash = '';\n let commitExitCode = 0;\n for await (const event of parseSSEStream(commitStream)) {\n if (event.type === 'complete') {\n commitExitCode = event.exitCode || 0;\n break;\n }\n }\n if (commitExitCode !== 0) {\n return this.errorContent('Failed to commit changes');\n }\n\n // Get commit hash\n const hashStream = await sandbox.execStream(`cd ${session.workDir} && git rev-parse HEAD`);\n for await (const event of parseSSEStream(hashStream)) {\n if (event.type === 'stdout') {\n commitHash = event.data?.trim() || '';\n }\n if (event.type === 'complete') break;\n }\n\n const pushResult = await this.pushWithForkFallback(\n session,\n sandbox,\n 'origin',\n args.branch\n );\n\n if (!pushResult.success) {\n return this.errorContent(`Failed to push: ${pushResult.error}`);\n }\n\n // 4. Create PR via GitHub API\n // If we used a fork, create a cross-fork PR (head: \"forkOwner:branch\" on upstream repo)\n const usedFork = pushResult.usedFork && session.forkInfo;\n const prOwner = usedFork ? session.forkInfo!.upstreamOwner : owner;\n const prRepo = usedFork ? session.forkInfo!.upstreamRepo : repo;\n const prHead = usedFork ? `${session.forkInfo!.forkOwner}:${args.branch}` : args.branch;\n\n const prResponse = await fetch(`https://api.github.com/repos/${prOwner}/${prRepo}/pulls`, {\n method: 'POST',\n headers: this.githubHeaders,\n body: JSON.stringify({\n title: args.title,\n body: args.body,\n head: prHead,\n base: args.base,\n }),\n });\n\n if (!prResponse.ok) {\n const errorText = await prResponse.text();\n return this.errorContent(`Failed to create PR: ${prResponse.status} ${errorText}`);\n }\n\n const prData = await prResponse.json() as { number: number; html_url: string };\n\n logger.sandbox.info('Created pull request', {\n owner: prOwner,\n repo: prRepo,\n prNumber: prData.number,\n branch: args.branch,\n usedFork: !!usedFork,\n });\n\n return {\n content: [{ type: 'text', text: `Created PR #${prData.number}: ${prData.html_url}${usedFork ? ' (from fork)' : ''}` }],\n structuredContent: {\n success: true,\n prNumber: prData.number,\n prUrl: prData.html_url,\n commitHash,\n usedFork: !!usedFork,\n // Artifact fields for workflow result\n url: prData.html_url,\n title: `PR #${prData.number}: ${args.title}`,\n },\n };\n }\n\n private async readFile(args: {\n sessionId: string;\n path: string;\n }): Promise {\n const session = sessionCache.get(args.sessionId);\n if (!session) {\n return this.errorContent(`Session not found: ${args.sessionId}`);\n }\n\n const sandbox = getSandbox(this.sandboxBinding, session.sandboxId);\n const fullPath = args.path.startsWith('/') ? args.path : `${session.workDir}/${args.path}`;\n\n try {\n const file = await sandbox.readFile(fullPath);\n return {\n content: [{ type: 'text', text: file.content.slice(0, 1000) + (file.content.length > 1000 ? '...' : '') }],\n structuredContent: {\n content: file.content,\n },\n };\n } catch (error) {\n return this.errorContent(`Failed to read file: ${error}`);\n }\n }\n\n private async writeFile(args: {\n sessionId: string;\n path: string;\n content: string;\n }): Promise {\n const session = sessionCache.get(args.sessionId);\n if (!session) {\n return this.errorContent(`Session not found: ${args.sessionId}`);\n }\n\n const sandbox = getSandbox(this.sandboxBinding, session.sandboxId);\n const fullPath = args.path.startsWith('/') ? args.path : `${session.workDir}/${args.path}`;\n\n try {\n await sandbox.writeFile(fullPath, args.content);\n return {\n content: [{ type: 'text', text: `Wrote ${args.content.length} bytes to ${args.path}` }],\n structuredContent: {\n success: true,\n bytesWritten: args.content.length,\n },\n };\n } catch (error) {\n return this.errorContent(`Failed to write file: ${error}`);\n }\n }\n\n private async exec(args: {\n sessionId: string;\n command: string;\n cwd?: string;\n timeout: number;\n }): Promise {\n const session = sessionCache.get(args.sessionId);\n if (!session) {\n return this.errorContent(`Session not found: ${args.sessionId}`);\n }\n\n const sandbox = getSandbox(this.sandboxBinding, session.sandboxId);\n const cwd = args.cwd\n ? (args.cwd.startsWith('/') ? args.cwd : `${session.workDir}/${args.cwd}`)\n : session.workDir;\n\n const execStream = await sandbox.execStream(`cd ${cwd} && ${args.command}`);\n\n let stdout = '';\n let stderr = '';\n let exitCode = 0;\n\n for await (const event of parseSSEStream(execStream)) {\n if (event.type === 'stdout') {\n stdout += event.data || '';\n }\n if (event.type === 'stderr') {\n stderr += event.data || '';\n }\n if (event.type === 'complete') {\n exitCode = event.exitCode || 0;\n break;\n }\n if (event.type === 'error') {\n return this.errorContent(`Exec error: ${event.error}`);\n }\n }\n\n return {\n content: [{ type: 'text', text: stdout.slice(0, 500) || stderr.slice(0, 500) || `Exit code: ${exitCode}` }],\n structuredContent: {\n stdout,\n stderr,\n exitCode,\n },\n };\n }\n\n private async destroySession(args: { sessionId: string }): Promise {\n const session = sessionCache.get(args.sessionId);\n if (!session) {\n return {\n content: [{ type: 'text', text: 'Session not found (may already be destroyed)' }],\n structuredContent: { success: true },\n };\n }\n\n // Remove from cache\n sessionCache.delete(args.sessionId);\n\n // Note: The sandbox will be automatically cleaned up by Cloudflare\n // after it's no longer referenced\n\n return {\n content: [{ type: 'text', text: `Session ${args.sessionId} destroyed` }],\n structuredContent: { success: true },\n };\n }\n}\n" }, { "path": "worker/sandbox/sandboxTools.ts", "content": "/**\n * Sandbox MCP Tool Definitions\n *\n * Single source of truth for Sandbox tool schemas using Zod.\n * Used for both JSON Schema generation (getTools) and runtime validation (callTool).\n */\n\nimport { z } from 'zod';\nimport { defineTools, commonSchemas } from '../utils/zodTools';\n\n// ============================================================================\n// Output Schemas\n// ============================================================================\n\nconst createSessionOutput = z.object({\n sessionId: z.string().describe('Session identifier for subsequent calls'),\n workDir: z.string().describe('Full working directory path'),\n});\n\nconst runClaudeOutput = z.object({\n success: z.boolean().describe('Whether Claude completed successfully'),\n output: z.string().describe(\"Claude's stdout output\"),\n filesModified: z.array(z.string())\n .describe('List of files that were modified'),\n exitCode: z.number().describe('Exit code from Claude CLI'),\n});\n\nconst diffStatsOutput = z.object({\n files: z.number().describe('Number of files changed'),\n additions: z.number().describe('Lines added'),\n deletions: z.number().describe('Lines deleted'),\n});\n\nconst getDiffOutput = z.object({\n diff: z.string().describe('Git diff output (unified format)'),\n stats: diffStatsOutput,\n});\n\nconst commitOutput = z.object({\n success: z.boolean().describe('Whether commit succeeded'),\n commitHash: z.string().optional().describe('Git commit hash'),\n});\n\nconst pushOutput = z.object({\n success: z.boolean().describe('Whether push succeeded'),\n ref: z.string().optional().describe('Git ref that was pushed'),\n usedFork: z.boolean().optional().describe('Whether a fork was used due to permission error'),\n});\n\nconst createPullRequestOutput = z.object({\n success: z.boolean().describe('Whether PR was created'),\n prNumber: z.number().optional().describe('Pull request number'),\n prUrl: z.string().optional().describe('URL to the pull request'),\n commitHash: z.string().optional().describe('Commit hash'),\n usedFork: z.boolean().optional().describe('Whether PR was created from a fork'),\n});\n\nconst readFileOutput = z.object({\n content: z.string().describe('File contents'),\n});\n\nconst writeFileOutput = z.object({\n success: z.boolean().describe('Whether write succeeded'),\n bytesWritten: z.number().optional().describe('Number of bytes written'),\n});\n\nconst execOutput = z.object({\n stdout: z.string().describe('Standard output'),\n stderr: z.string().describe('Standard error'),\n exitCode: z.number().describe('Command exit code'),\n});\n\nconst destroySessionOutput = z.object({\n success: z.boolean().describe('Whether destruction succeeded'),\n});\n\n// ============================================================================\n// Tool Definitions\n// ============================================================================\n\n// Sandbox tools are disabled in scheduled runs - those should only create child tasks\nexport const sandboxTools = defineTools({\n createSession: {\n description: 'Create a new sandbox session, optionally cloning a git repository. Returns a sessionId to use in subsequent calls.',\n input: z.object({\n repoUrl: z.string().max(500).optional()\n .describe('Git repository URL to clone (e.g., https://github.com/owner/repo.git). GitHub token is auto-injected.'),\n branch: z.string().max(200).default('main')\n .describe('Branch to checkout (default: main)'),\n workDir: z.string().max(200).default('repo')\n .describe('Working directory name (default: repo)'),\n }),\n output: createSessionOutput,\n disabledInScheduledRuns: true,\n },\n\n runClaude: {\n description: 'Execute Claude Code CLI with a task. Returns output and list of modified files. Claude will make changes but NOT commit them.',\n input: z.object({\n sessionId: commonSchemas.sessionId,\n task: z.string().max(50000).describe('Task description for Claude to execute'),\n context: z.string().max(50000).optional()\n .describe('Additional context from previous workflow steps'),\n systemPrompt: z.string().max(10000).optional()\n .describe('Optional system prompt override'),\n timeout: z.coerce.number().int().min(30).max(1800).default(600)\n .describe('Timeout in seconds (default: 600)'),\n }),\n output: runClaudeOutput,\n disabledInScheduledRuns: true,\n },\n\n getDiff: {\n description: 'Get the git diff of uncommitted changes in the sandbox',\n input: z.object({\n sessionId: commonSchemas.sessionId,\n staged: z.boolean().default(false)\n .describe('Get only staged changes (default: false, gets all changes)'),\n }),\n output: getDiffOutput,\n disabledInScheduledRuns: true,\n },\n\n commit: {\n description: 'Commit current changes with a message',\n input: z.object({\n sessionId: commonSchemas.sessionId,\n message: z.string().max(5000).describe('Commit message'),\n }),\n output: commitOutput,\n disabledInScheduledRuns: true,\n },\n\n push: {\n description: 'Push commits to the remote repository',\n input: z.object({\n sessionId: commonSchemas.sessionId,\n remote: z.string().max(100).default('origin')\n .describe('Remote name (default: origin)'),\n branch: z.string().max(200).optional()\n .describe('Branch name to push'),\n }),\n output: pushOutput,\n hidden: true, // Internal only - agents should use createPullRequest\n disabledInScheduledRuns: true,\n },\n\n createPullRequest: {\n description: 'Create a pull request with the current sandbox changes. Handles commit, push, and PR creation in one step. IMPORTANT: Get the diff first using getDiff and request approval before calling this tool.',\n input: z.object({\n sessionId: commonSchemas.sessionId,\n title: z.string().max(500).describe('Pull request title'),\n body: z.string().max(65000).default('')\n .describe('Pull request description (markdown supported)'),\n branch: z.string().max(200)\n .describe('Feature branch name to create (e.g., \"feature/add-login\")'),\n base: z.string().max(200).default('main')\n .describe('Target branch to merge into (default: main)'),\n commitMessage: z.string().max(5000)\n .describe('Commit message for the changes'),\n diff: z.string().max(500000)\n .describe('The diff from getDiff - required for approval review'),\n }),\n output: createPullRequestOutput,\n approvalRequiredFields: ['title', 'body', 'diff', 'branch'],\n requiresApproval: true,\n disabledInScheduledRuns: true,\n },\n\n readFile: {\n description: 'Read a file from the sandbox',\n input: z.object({\n sessionId: commonSchemas.sessionId,\n path: commonSchemas.sandboxPath.describe('File path relative to working directory'),\n }),\n output: readFileOutput,\n disabledInScheduledRuns: true,\n },\n\n writeFile: {\n description: 'Write content to a file in the sandbox',\n input: z.object({\n sessionId: commonSchemas.sessionId,\n path: commonSchemas.sandboxPath.describe('File path relative to working directory'),\n content: z.string().max(1000000).describe('Content to write'),\n }),\n output: writeFileOutput,\n disabledInScheduledRuns: true,\n },\n\n exec: {\n description: 'Execute a shell command in the sandbox',\n input: z.object({\n sessionId: commonSchemas.sessionId,\n command: z.string().max(10000).describe('Command to execute'),\n cwd: z.string().max(500).optional()\n .describe('Working directory for command (relative to session workDir)'),\n timeout: z.coerce.number().int().min(1).max(300).default(60)\n .describe('Timeout in seconds (default: 60)'),\n }),\n output: execOutput,\n disabledInScheduledRuns: true,\n },\n\n destroySession: {\n description: 'Cleanup and destroy a sandbox session',\n input: z.object({\n sessionId: commonSchemas.sessionId,\n }),\n output: destroySessionOutput,\n disabledInScheduledRuns: true,\n },\n});\n\n// Export type for tool names\nexport type SandboxToolName = keyof typeof sandboxTools;\n" }, { "path": "worker/services/BoardService.ts", "content": "import { jsonResponse } from '../utils/response';\nimport { logger } from '../utils/logger';\nimport { CREDENTIAL_TYPES } from '../constants';\nimport { transformBoard, transformColumn, transformTask, toCamelCase } from '../utils/transformations';\nimport { getCredentialTypeForUrlPattern, type UrlPatternType } from '../mcp/AccountMCPRegistry';\nimport { DocsMCPServer } from '../google/DocsMCP';\nimport { SheetsMCPServer } from '../google/SheetsMCP';\nimport { GitHubMCPServer } from '../github/GitHubMCP';\nimport type { CredentialService } from './CredentialService';\n\ninterface TaskRow {\n id: string;\n column_id: string;\n board_id: string;\n title: string;\n description: string | null;\n priority: string;\n position: number;\n context: string | null;\n schedule_config: string | null;\n parent_task_id: string | null;\n run_id: string | null;\n created_at: string;\n updated_at: string;\n}\n\nexport class BoardService {\n private sql: SqlStorage;\n private credentialService: CredentialService;\n private generateId: () => string;\n\n constructor(\n sql: SqlStorage,\n credentialService: CredentialService,\n generateId: () => string\n ) {\n this.sql = sql;\n this.credentialService = credentialService;\n this.generateId = generateId;\n }\n\n // ============================================\n // BOARD OPERATIONS\n // ============================================\n\n /**\n * Initialize a new board in this Durable Object\n */\n initBoard(data: { id: string; name: string; ownerId: string }): Response {\n const now = new Date().toISOString();\n\n const existing = this.sql.exec('SELECT id FROM boards WHERE id = ?', data.id).toArray()[0];\n if (existing) {\n return jsonResponse({ success: false, error: 'Board already initialized' }, 400);\n }\n\n this.sql.exec(\n 'INSERT INTO boards (id, name, owner_id, created_at, updated_at) VALUES (?, ?, ?, ?, ?)',\n data.id, data.name, data.ownerId, now, now\n );\n\n // Create default columns\n const defaultColumns = ['Backlog', 'Doing', 'Done'];\n defaultColumns.forEach((name, position) => {\n const columnId = this.generateId();\n this.sql.exec(\n 'INSERT INTO columns (id, board_id, name, position) VALUES (?, ?, ?, ?)',\n columnId, data.id, name, position\n );\n });\n\n return this.getBoard(data.id);\n }\n\n /**\n * Get basic board info for access verification\n */\n getBoardInfo(): Response {\n const board = this.sql.exec('SELECT id, name, owner_id FROM boards').toArray()[0];\n if (!board) {\n return jsonResponse({ success: false, error: 'Board not initialized' }, 404);\n }\n\n const boardRecord = board as { id: string; name: string; owner_id: string };\n return jsonResponse({\n success: true,\n data: {\n id: boardRecord.id,\n name: boardRecord.name,\n ownerId: boardRecord.owner_id,\n },\n });\n }\n\n /**\n * Get a board with all columns and tasks\n */\n getBoard(id: string): Response {\n const board = this.sql.exec('SELECT * FROM boards WHERE id = ?', id).toArray()[0];\n if (!board) {\n return jsonResponse({ error: 'Board not found' }, 404);\n }\n\n const columns = this.sql.exec(\n 'SELECT * FROM columns WHERE board_id = ? ORDER BY position',\n id\n ).toArray();\n\n const tasks = this.sql.exec(\n 'SELECT * FROM tasks WHERE board_id = ? ORDER BY position',\n id\n ).toArray();\n\n return jsonResponse({\n success: true,\n data: {\n ...transformBoard(board as Record),\n columns: columns.map(c => transformColumn(c as Record)),\n tasks: tasks.map(t => transformTask(t as Record))\n }\n });\n }\n\n /**\n * Update a board\n */\n updateBoard(id: string, data: { name?: string }): Response {\n const now = new Date().toISOString();\n this.sql.exec(\n 'UPDATE boards SET name = COALESCE(?, name), updated_at = ? WHERE id = ?',\n data.name ?? null, now, id\n );\n return this.getBoard(id);\n }\n\n /**\n * Delete a board and all its data\n */\n deleteBoard(id: string): Response {\n this.sql.exec('DELETE FROM tasks WHERE board_id = ?', id);\n this.sql.exec('DELETE FROM columns WHERE board_id = ?', id);\n this.sql.exec('DELETE FROM boards WHERE id = ?', id);\n return jsonResponse({ success: true });\n }\n\n // ============================================\n // COLUMN OPERATIONS\n // ============================================\n\n /**\n * Create a new column\n */\n createColumn(boardId: string, data: { name: string }): Response {\n const id = this.generateId();\n\n const result = this.sql.exec(\n 'SELECT MAX(position) as max_pos FROM columns WHERE board_id = ?',\n boardId\n ).toArray()[0] as { max_pos: number | null };\n const position = (result?.max_pos ?? -1) + 1;\n\n this.sql.exec(\n 'INSERT INTO columns (id, board_id, name, position) VALUES (?, ?, ?, ?)',\n id, boardId, data.name, position\n );\n\n const column = this.sql.exec('SELECT * FROM columns WHERE id = ?', id).toArray()[0];\n return jsonResponse({ success: true, data: transformColumn(column as Record) });\n }\n\n /**\n * Update a column\n */\n updateColumn(id: string, data: { name?: string; position?: number }): Response {\n if (data.name !== undefined) {\n this.sql.exec('UPDATE columns SET name = ? WHERE id = ?', data.name, id);\n }\n\n if (data.position !== undefined) {\n const currentColumn = this.sql.exec(\n 'SELECT position, board_id FROM columns WHERE id = ?', id\n ).toArray()[0] as { position: number; board_id: string } | undefined;\n\n if (currentColumn) {\n const oldPosition = currentColumn.position;\n const newPosition = data.position;\n const boardId = currentColumn.board_id;\n\n if (oldPosition !== newPosition) {\n if (oldPosition < newPosition) {\n this.sql.exec(\n `UPDATE columns SET position = position - 1\n WHERE board_id = ? AND position > ? AND position <= ?`,\n boardId, oldPosition, newPosition\n );\n } else {\n this.sql.exec(\n `UPDATE columns SET position = position + 1\n WHERE board_id = ? AND position >= ? AND position < ?`,\n boardId, newPosition, oldPosition\n );\n }\n this.sql.exec('UPDATE columns SET position = ? WHERE id = ?', newPosition, id);\n }\n }\n }\n\n const column = this.sql.exec('SELECT * FROM columns WHERE id = ?', id).toArray()[0];\n return jsonResponse({ success: true, data: transformColumn(column as Record) });\n }\n\n /**\n * Delete a column\n */\n deleteColumn(id: string): Response {\n const column = this.sql.exec('SELECT id FROM columns WHERE id = ?', id).toArray()[0];\n if (!column) {\n return jsonResponse({ error: 'Column not found' }, 404);\n }\n this.sql.exec('DELETE FROM tasks WHERE column_id = ?', id);\n this.sql.exec('DELETE FROM columns WHERE id = ?', id);\n return jsonResponse({ success: true });\n }\n\n // ============================================\n // TASK OPERATIONS\n // ============================================\n\n /**\n * Create a new task\n */\n createTask(data: {\n columnId: string;\n boardId: string;\n title: string;\n description?: string;\n priority?: string;\n context?: object;\n scheduleConfig?: object;\n parentTaskId?: string;\n runId?: string;\n }): Response {\n const id = this.generateId();\n const now = new Date().toISOString();\n\n const result = this.sql.exec(\n 'SELECT MAX(position) as max_pos FROM tasks WHERE column_id = ?',\n data.columnId\n ).toArray()[0] as { max_pos: number | null };\n const position = (result?.max_pos ?? -1) + 1;\n\n this.sql.exec(\n `INSERT INTO tasks (id, column_id, board_id, title, description, priority, position, context, schedule_config, parent_task_id, run_id, created_at, updated_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n id,\n data.columnId,\n data.boardId,\n data.title,\n data.description ?? null,\n data.priority ?? 'medium',\n position,\n data.context ? JSON.stringify(data.context) : null,\n data.scheduleConfig ? JSON.stringify(data.scheduleConfig) : null,\n data.parentTaskId ?? null,\n data.runId ?? null,\n now,\n now\n );\n\n const task = this.sql.exec('SELECT * FROM tasks WHERE id = ?', id).toArray()[0];\n return jsonResponse({ success: true, data: transformTask(task as Record) });\n }\n\n /**\n * Get a task by ID\n */\n getTask(id: string): Response {\n const task = this.sql.exec('SELECT * FROM tasks WHERE id = ?', id).toArray()[0];\n if (!task) {\n return jsonResponse({ error: 'Task not found' }, 404);\n }\n return jsonResponse({ success: true, data: transformTask(task as Record) });\n }\n\n /**\n * Update a task\n */\n updateTask(id: string, data: {\n title?: string;\n description?: string;\n priority?: string;\n context?: object;\n scheduleConfig?: object | null;\n }): Response {\n const now = new Date().toISOString();\n\n const task = this.sql.exec('SELECT * FROM tasks WHERE id = ?', id).toArray()[0] as unknown as TaskRow | undefined;\n if (!task) {\n return jsonResponse({ error: 'Task not found' }, 404);\n }\n\n // Handle scheduleConfig - null means remove, undefined means keep existing\n let scheduleConfigValue: string | null;\n if (data.scheduleConfig === null) {\n scheduleConfigValue = null;\n } else if (data.scheduleConfig !== undefined) {\n scheduleConfigValue = JSON.stringify(data.scheduleConfig);\n } else {\n scheduleConfigValue = task.schedule_config;\n }\n\n this.sql.exec(\n `UPDATE tasks SET\n title = ?,\n description = ?,\n priority = ?,\n context = ?,\n schedule_config = ?,\n updated_at = ?\n WHERE id = ?`,\n data.title ?? task.title,\n data.description ?? task.description,\n data.priority ?? task.priority,\n data.context ? JSON.stringify(data.context) : task.context,\n scheduleConfigValue,\n now,\n id\n );\n\n const updated = this.sql.exec('SELECT * FROM tasks WHERE id = ?', id).toArray()[0];\n return jsonResponse({ success: true, data: transformTask(updated as Record) });\n }\n\n /**\n * Delete a task\n */\n deleteTask(id: string): Response {\n const task = this.sql.exec('SELECT id FROM tasks WHERE id = ?', id).toArray()[0];\n if (!task) {\n return jsonResponse({ error: 'Task not found' }, 404);\n }\n this.sql.exec('DELETE FROM tasks WHERE id = ?', id);\n return jsonResponse({ success: true });\n }\n\n /**\n * Move a task to a different column/position\n */\n moveTask(id: string, data: { columnId: string; position: number }): Response {\n const now = new Date().toISOString();\n\n const currentTask = this.sql.exec(\n 'SELECT column_id, position FROM tasks WHERE id = ?', id\n ).toArray()[0] as { column_id: string; position: number } | undefined;\n\n if (!currentTask) {\n return jsonResponse({ error: 'Task not found' }, 404);\n }\n\n const sourceColumnId = currentTask.column_id;\n const oldPosition = currentTask.position;\n const targetColumnId = data.columnId;\n const newPosition = data.position;\n\n if (sourceColumnId === targetColumnId) {\n // Same column reorder\n if (oldPosition < newPosition) {\n this.sql.exec(\n `UPDATE tasks SET position = position - 1\n WHERE column_id = ? AND position > ? AND position <= ? AND id != ?`,\n targetColumnId, oldPosition, newPosition, id\n );\n } else if (oldPosition > newPosition) {\n this.sql.exec(\n `UPDATE tasks SET position = position + 1\n WHERE column_id = ? AND position >= ? AND position < ? AND id != ?`,\n targetColumnId, newPosition, oldPosition, id\n );\n }\n } else {\n // Cross-column move\n this.sql.exec(\n `UPDATE tasks SET position = position - 1\n WHERE column_id = ? AND position > ?`,\n sourceColumnId, oldPosition\n );\n this.sql.exec(\n `UPDATE tasks SET position = position + 1\n WHERE column_id = ? AND position >= ?`,\n targetColumnId, newPosition\n );\n }\n\n this.sql.exec(\n 'UPDATE tasks SET column_id = ?, position = ?, updated_at = ? WHERE id = ?',\n targetColumnId, newPosition, now, id\n );\n\n const task = this.sql.exec('SELECT * FROM tasks WHERE id = ?', id).toArray()[0];\n return jsonResponse({ success: true, data: transformTask(task as Record) });\n }\n\n /**\n * Validate that a task exists (for generate-plan endpoint)\n */\n validateTaskExists(taskId: string): Response {\n const task = this.sql.exec('SELECT * FROM tasks WHERE id = ?', taskId).toArray()[0];\n if (!task) {\n return jsonResponse({ error: 'Task not found' }, 404);\n }\n return jsonResponse({ success: true, data: transformTask(task as Record) });\n }\n\n // ============================================\n // LINK METADATA (for link pills)\n // ============================================\n\n /**\n * Get metadata for a URL to display as a link pill\n */\n async getLinkMetadata(boardId: string, data: { url: string }): Promise {\n const { url } = data;\n if (!url) {\n return jsonResponse({\n success: false,\n error: { code: 'MISSING_URL', message: 'URL is required' }\n }, 400);\n }\n\n // Get all MCP servers with URL patterns\n const servers = this.sql.exec(\n \"SELECT * FROM mcp_servers WHERE board_id = ? AND url_patterns IS NOT NULL AND status = 'connected'\",\n boardId\n ).toArray();\n\n for (const serverRow of servers) {\n const server = toCamelCase(serverRow as Record) as {\n id: string;\n name: string;\n credentialId?: string;\n urlPatterns: string;\n };\n\n let patterns: Array<{ pattern: string; type: string; fetchTool: string }>;\n try {\n patterns = JSON.parse(server.urlPatterns);\n } catch {\n continue;\n }\n\n for (const patternDef of patterns) {\n const regex = new RegExp(patternDef.pattern);\n const match = url.match(regex);\n\n if (match) {\n try {\n const metadata = await this.fetchLinkMetadataFromMCP(\n boardId,\n server.name,\n server.credentialId,\n patternDef.fetchTool,\n patternDef.type,\n url,\n match\n );\n\n if (metadata) {\n return jsonResponse({ success: true, data: metadata });\n }\n } catch (error) {\n logger.board.error('Failed to fetch link metadata', { url, error: error instanceof Error ? error.message : String(error) });\n }\n }\n }\n }\n\n return jsonResponse({ success: true, data: null });\n }\n\n /**\n * Fetch metadata from an MCP server for a matched URL\n */\n private async fetchLinkMetadataFromMCP(\n boardId: string,\n _serverName: string,\n _credentialId: string | undefined,\n fetchTool: string,\n type: string,\n _url: string,\n match: RegExpMatchArray\n ): Promise<{ type: string; title: string; id: string } | null> {\n const credentialType = getCredentialTypeForUrlPattern(type as UrlPatternType);\n if (!credentialType) {\n return null;\n }\n\n const accessToken = await this.credentialService.getValidAccessToken(boardId, credentialType);\n if (!accessToken) {\n return null;\n }\n\n switch (type) {\n case 'google_doc': {\n const documentId = match[1];\n const mcp = new DocsMCPServer(accessToken);\n const result = await mcp.callTool(fetchTool, { documentId });\n const data = result?.structuredContent as { title?: string } | undefined;\n if (data?.title) {\n return { type: 'google_doc', title: data.title, id: documentId };\n }\n break;\n }\n case 'google_sheet': {\n const spreadsheetId = match[1];\n const mcp = new SheetsMCPServer(accessToken);\n const result = await mcp.callTool(fetchTool, { spreadsheetId });\n const data = result?.structuredContent as { title?: string } | undefined;\n if (data?.title) {\n return { type: 'google_sheet', title: data.title, id: spreadsheetId };\n }\n break;\n }\n case 'github_pr': {\n const [, owner, repo, prNumber] = match;\n const mcp = new GitHubMCPServer(accessToken);\n const result = await mcp.callTool(fetchTool, { owner, repo, pullNumber: parseInt(prNumber, 10) });\n const data = result?.structuredContent as { title?: string } | undefined;\n if (data?.title) {\n return { type: 'github_pr', title: data.title, id: `${owner}/${repo}#${prNumber}` };\n }\n break;\n }\n case 'github_issue': {\n const [, owner, repo, issueNumber] = match;\n const mcp = new GitHubMCPServer(accessToken);\n const result = await mcp.callTool(fetchTool, { owner, repo, issueNumber: parseInt(issueNumber, 10) });\n const data = result?.structuredContent as { title?: string } | undefined;\n if (data?.title) {\n return { type: 'github_issue', title: data.title, id: `${owner}/${repo}#${issueNumber}` };\n }\n break;\n }\n case 'github_repo': {\n const [, owner, repo] = match;\n const mcp = new GitHubMCPServer(accessToken);\n const result = await mcp.callTool(fetchTool, { owner, repo });\n const data = result?.structuredContent as { title?: string; full_name?: string } | undefined;\n const title = data?.title || data?.full_name;\n if (title) {\n return { type: 'github_repo', title, id: `${owner}/${repo}` };\n }\n break;\n }\n }\n\n return null;\n }\n\n // ============================================\n // GITHUB OPERATIONS\n // ============================================\n\n /**\n * Get GitHub repos for a board\n */\n async getGitHubRepos(boardId: string): Promise {\n const accessToken = await this.credentialService.getCredentialValue(boardId, CREDENTIAL_TYPES.GITHUB_OAUTH);\n\n if (!accessToken) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_CONNECTED', message: 'GitHub not connected' }\n }, 400);\n }\n\n try {\n const response = await fetch(\n 'https://api.github.com/user/repos?sort=updated&direction=desc&per_page=50',\n {\n headers: {\n 'Authorization': `Bearer ${accessToken}`,\n 'Accept': 'application/vnd.github.v3+json',\n 'User-Agent': 'Weft-App',\n },\n }\n );\n\n if (!response.ok) {\n if (response.status === 401) {\n return jsonResponse({\n success: false,\n error: { code: 'UNAUTHORIZED', message: 'GitHub token expired or invalid' }\n }, 401);\n }\n throw new Error(`GitHub API error: ${response.status}`);\n }\n\n const repos = await response.json() as Array<{\n id: number;\n name: string;\n full_name: string;\n owner: { login: string };\n private: boolean;\n default_branch: string;\n description: string | null;\n }>;\n\n return jsonResponse({\n success: true,\n data: repos.map(repo => ({\n id: repo.id,\n name: repo.name,\n fullName: repo.full_name,\n owner: repo.owner.login,\n private: repo.private,\n defaultBranch: repo.default_branch,\n description: repo.description,\n }))\n });\n } catch (error) {\n logger.board.error('GitHub repos error', { error: error instanceof Error ? error.message : String(error) });\n return jsonResponse({\n success: false,\n error: { code: 'GITHUB_ERROR', message: error instanceof Error ? error.message : 'Failed to fetch repos' }\n }, 500);\n }\n }\n}\n" }, { "path": "worker/services/CredentialService.ts", "content": "import { encryptValue, decryptValue } from '../utils/crypto';\nimport { jsonResponse } from '../utils/response';\nimport { toCamelCase } from '../utils/transformations';\nimport { logger } from '../utils/logger';\nimport { getAccountByCredentialType } from '../mcp/AccountMCPRegistry';\n\n// Buffer time (5 minutes) before expiry to trigger refresh\nconst TOKEN_REFRESH_BUFFER_MS = 5 * 60 * 1000;\n\n// OAuth client credentials for token refresh\n// Add new providers here as they're added\ninterface OAuthEnv {\n GOOGLE_CLIENT_ID?: string;\n GOOGLE_CLIENT_SECRET?: string;\n}\n\nexport class CredentialService {\n private sql: SqlStorage;\n private encryptionKey: string;\n private generateId: () => string;\n private oauthEnv: OAuthEnv;\n\n constructor(\n sql: SqlStorage,\n encryptionKey: string,\n generateId: () => string,\n oauthEnv: OAuthEnv = {}\n ) {\n this.sql = sql;\n this.encryptionKey = encryptionKey;\n this.generateId = generateId;\n this.oauthEnv = oauthEnv;\n }\n\n /**\n * Get all credentials for a board (without encrypted values)\n */\n getCredentials(boardId: string): Response {\n const credentials = this.sql.exec(\n 'SELECT id, board_id, type, name, metadata, created_at, updated_at FROM board_credentials WHERE board_id = ?',\n boardId\n ).toArray();\n\n return jsonResponse({\n success: true,\n data: credentials.map(c => {\n const cred = toCamelCase(c as Record);\n if (typeof cred.metadata === 'string' && cred.metadata) {\n try {\n cred.metadata = JSON.parse(cred.metadata);\n } catch {\n // Leave as string if parsing fails\n }\n }\n return cred;\n })\n });\n }\n\n /**\n * Create a new credential with encrypted value\n */\n async createCredential(boardId: string, data: {\n type: string;\n name: string;\n value: string;\n metadata?: object;\n }): Promise {\n const id = this.generateId();\n const now = new Date().toISOString();\n const encryptedValue = await this.encrypt(data.value);\n\n this.sql.exec(\n `INSERT INTO board_credentials (id, board_id, type, name, encrypted_value, metadata, created_at, updated_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,\n id,\n boardId,\n data.type,\n data.name,\n encryptedValue,\n data.metadata ? JSON.stringify(data.metadata) : null,\n now,\n now\n );\n\n return jsonResponse({\n success: true,\n data: {\n id,\n boardId,\n type: data.type,\n name: data.name,\n createdAt: now,\n updatedAt: now\n }\n });\n }\n\n /**\n * Delete a credential and cascade to associated MCP servers\n */\n deleteCredential(boardId: string, credentialId: string): Response {\n // Cascade delete associated MCP servers and their tools\n this.sql.exec(\n `DELETE FROM mcp_tool_schemas WHERE server_id IN (\n SELECT id FROM mcp_servers WHERE credential_id = ?\n )`,\n credentialId\n );\n this.sql.exec(\n 'DELETE FROM mcp_servers WHERE credential_id = ?',\n credentialId\n );\n this.sql.exec(\n 'DELETE FROM board_credentials WHERE id = ? AND board_id = ?',\n credentialId,\n boardId\n );\n\n return jsonResponse({ success: true });\n }\n\n /**\n * Get decrypted credential value by type\n */\n async getCredentialValue(boardId: string, type: string): Promise {\n const credential = this.sql.exec(\n 'SELECT encrypted_value FROM board_credentials WHERE board_id = ? AND type = ?',\n boardId,\n type\n ).toArray()[0] as { encrypted_value: string } | undefined;\n\n if (!credential) return null;\n return this.decrypt(credential.encrypted_value);\n }\n\n /**\n * Get a valid access token, refreshing if expired.\n * Centralizes all OAuth token refresh logic.\n */\n async getValidAccessToken(\n boardId: string,\n credentialType: string\n ): Promise {\n const credential = this.sql.exec(\n 'SELECT encrypted_value, metadata FROM board_credentials WHERE board_id = ? AND type = ?',\n boardId,\n credentialType\n ).toArray()[0] as { encrypted_value: string; metadata: string | null } | undefined;\n\n if (!credential) return null;\n\n let accessToken = await this.decrypt(credential.encrypted_value);\n const metadata: { refresh_token?: string; expires_at?: string } = credential.metadata\n ? JSON.parse(credential.metadata)\n : {};\n\n if (metadata.refresh_token && metadata.expires_at) {\n const expiresAtMs = new Date(metadata.expires_at).getTime();\n const needsRefresh = Date.now() > expiresAtMs - TOKEN_REFRESH_BUFFER_MS;\n\n if (needsRefresh) {\n const account = getAccountByCredentialType(credentialType);\n if (account?.refreshToken) {\n const { clientId, clientSecret } = this.getOAuthClientCredentials(account.id);\n\n if (clientId && clientSecret) {\n try {\n logger.credential.info('Refreshing expired OAuth token', { credentialType });\n\n const newTokenData = await account.refreshToken(\n metadata.refresh_token,\n clientId,\n clientSecret\n );\n\n accessToken = newTokenData.access_token;\n const newExpiresAt = new Date(\n Date.now() + (newTokenData.expires_in || 3600) * 1000\n ).toISOString();\n\n await this.updateCredentialValue(\n boardId,\n credentialType,\n newTokenData.access_token,\n { expires_at: newExpiresAt }\n );\n\n logger.credential.info('OAuth token refreshed successfully', { credentialType });\n } catch (e) {\n logger.credential.error('Failed to refresh OAuth token', {\n credentialType,\n error: e instanceof Error ? e.message : String(e),\n });\n }\n }\n }\n }\n }\n\n return accessToken;\n }\n\n /**\n * HTTP handler for getting credential value\n */\n async getCredentialValueResponse(boardId: string, type: string): Promise {\n const value = await this.getCredentialValue(boardId, type);\n if (!value) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: `Credential ${type} not found` }\n }, 404);\n }\n return jsonResponse({ success: true, data: { value } });\n }\n\n /**\n * Get credential by ID with decrypted value and metadata\n */\n async getCredentialById(boardId: string, credentialId: string): Promise {\n const credential = this.sql.exec(\n 'SELECT encrypted_value, metadata FROM board_credentials WHERE board_id = ? AND id = ?',\n boardId,\n credentialId\n ).toArray()[0] as { encrypted_value: string; metadata: string | null } | undefined;\n\n if (!credential) {\n return jsonResponse({ success: false, error: 'Credential not found' }, 404);\n }\n\n return jsonResponse({\n success: true,\n data: {\n value: await this.decrypt(credential.encrypted_value),\n metadata: credential.metadata ? JSON.parse(credential.metadata) : null,\n }\n });\n }\n\n /**\n * Get full credential by type with decrypted value and metadata\n */\n async getCredentialFullResponse(boardId: string, type: string): Promise {\n const credential = this.sql.exec(\n 'SELECT encrypted_value, metadata FROM board_credentials WHERE board_id = ? AND type = ?',\n boardId,\n type\n ).toArray()[0] as { encrypted_value: string; metadata: string | null } | undefined;\n\n if (!credential) {\n return jsonResponse({\n success: false,\n error: { code: 'NOT_FOUND', message: `Credential ${type} not found` }\n }, 404);\n }\n\n return jsonResponse({\n success: true,\n data: {\n value: await this.decrypt(credential.encrypted_value),\n metadata: credential.metadata ? JSON.parse(credential.metadata) : {},\n }\n });\n }\n\n /**\n * Update credential value (for token refresh)\n */\n async updateCredentialValue(\n boardId: string,\n type: string,\n newValue: string,\n metadataUpdates?: Record\n ): Promise {\n const encryptedValue = await this.encrypt(newValue);\n const now = new Date().toISOString();\n\n if (metadataUpdates) {\n const existing = this.sql.exec(\n 'SELECT metadata FROM board_credentials WHERE board_id = ? AND type = ?',\n boardId,\n type\n ).toArray()[0] as { metadata: string | null } | undefined;\n\n const existingMetadata = existing?.metadata ? JSON.parse(existing.metadata) : {};\n const mergedMetadata = { ...existingMetadata, ...metadataUpdates };\n\n this.sql.exec(\n 'UPDATE board_credentials SET encrypted_value = ?, metadata = ?, updated_at = ? WHERE board_id = ? AND type = ?',\n encryptedValue,\n JSON.stringify(mergedMetadata),\n now,\n boardId,\n type\n );\n } else {\n this.sql.exec(\n 'UPDATE board_credentials SET encrypted_value = ?, updated_at = ? WHERE board_id = ? AND type = ?',\n encryptedValue,\n now,\n boardId,\n type\n );\n }\n\n return jsonResponse({ success: true });\n }\n\n /**\n * Get raw credential row by ID (for internal use)\n */\n getCredentialRowById(credentialId: string): { encrypted_value: string; metadata?: string } | undefined {\n return this.sql.exec(\n 'SELECT encrypted_value, metadata FROM board_credentials WHERE id = ?',\n credentialId\n ).toArray()[0] as { encrypted_value: string; metadata?: string } | undefined;\n }\n\n /**\n * Find credential ID by board and type\n */\n findCredentialId(boardId: string, type: string): string | undefined {\n const row = this.sql.exec(\n 'SELECT id FROM board_credentials WHERE board_id = ? AND type = ?',\n boardId,\n type\n ).toArray()[0] as { id: string } | undefined;\n return row?.id;\n }\n\n /**\n * Get OAuth client credentials for an account\n * Add new providers here as they're added\n */\n private getOAuthClientCredentials(accountId: string): {\n clientId: string | undefined;\n clientSecret: string | undefined;\n } {\n switch (accountId) {\n case 'google':\n return {\n clientId: this.oauthEnv.GOOGLE_CLIENT_ID,\n clientSecret: this.oauthEnv.GOOGLE_CLIENT_SECRET,\n };\n default:\n return { clientId: undefined, clientSecret: undefined };\n }\n }\n\n /**\n * Encrypt a value\n */\n async encrypt(value: string): Promise {\n return encryptValue(value, this.encryptionKey);\n }\n\n /**\n * Decrypt a value\n */\n async decrypt(encrypted: string): Promise {\n return decryptValue(encrypted, this.encryptionKey);\n }\n}\n" }, { "path": "worker/services/MCPOAuthService.ts", "content": "import {\n discoverOAuthEndpoints,\n buildAuthorizationUrl,\n exchangeCodeForTokens,\n registerClient,\n generateCodeVerifier,\n generateCodeChallenge,\n generateState,\n parseState,\n type MCPOAuthMetadata,\n} from '../mcp/oauth';\nimport { jsonResponse } from '../utils/response';\nimport { logger } from '../utils/logger';\nimport { toCamelCase } from '../utils/transformations';\nimport type { CredentialService } from './CredentialService';\nimport type { MCPService } from './MCPService';\n\nexport class MCPOAuthService {\n private sql: SqlStorage;\n private credentialService: CredentialService;\n private mcpService: MCPService;\n private generateId: () => string;\n\n constructor(\n sql: SqlStorage,\n credentialService: CredentialService,\n mcpService: MCPService,\n generateId: () => string\n ) {\n this.sql = sql;\n this.credentialService = credentialService;\n this.mcpService = mcpService;\n this.generateId = generateId;\n }\n\n /**\n * Discover OAuth endpoints for a remote MCP server\n */\n async discoverMCPOAuth(serverId: string): Promise {\n const serverRow = this.mcpService.getServerRow(serverId);\n\n if (!serverRow) {\n return jsonResponse({ success: false, error: { code: 'NOT_FOUND', message: 'MCP server not found' } }, 404);\n }\n\n const server = toCamelCase(serverRow) as {\n id: string;\n endpoint?: string;\n type: string;\n };\n\n if (server.type !== 'remote' || !server.endpoint) {\n return jsonResponse({\n success: false,\n error: { code: 'INVALID_SERVER', message: 'Only remote MCP servers support OAuth discovery' }\n }, 400);\n }\n\n const result = await discoverOAuthEndpoints(server.endpoint);\n\n if (!result.success || !result.metadata) {\n return jsonResponse({\n success: false,\n error: { code: 'DISCOVERY_FAILED', message: result.error || 'OAuth discovery failed' }\n }, 400);\n }\n\n // Cache the OAuth metadata\n this.mcpService.updateOAuthMetadata(serverId, result.metadata);\n\n return jsonResponse({\n success: true,\n data: result.metadata\n });\n }\n\n /**\n * Get OAuth authorization URL for a remote MCP server\n */\n async getMCPOAuthUrl(serverId: string, params: URLSearchParams): Promise {\n const redirectUri = params.get('redirectUri');\n if (!redirectUri) {\n return jsonResponse({\n success: false,\n error: { code: 'MISSING_PARAM', message: 'redirectUri is required' }\n }, 400);\n }\n\n const serverRow = this.mcpService.getServerRow(serverId);\n\n if (!serverRow) {\n return jsonResponse({ success: false, error: { code: 'NOT_FOUND', message: 'MCP server not found' } }, 404);\n }\n\n const server = toCamelCase(serverRow) as {\n id: string;\n name: string;\n boardId: string;\n endpoint?: string;\n oauthMetadata?: string;\n };\n\n if (!server.oauthMetadata) {\n return jsonResponse({\n success: false,\n error: { code: 'NO_OAUTH_METADATA', message: 'OAuth discovery has not been performed for this server' }\n }, 400);\n }\n\n const metadata = JSON.parse(server.oauthMetadata) as MCPOAuthMetadata;\n\n // Dynamic Client Registration (RFC 7591)\n let clientId = redirectUri;\n let clientSecret: string | null = null;\n\n if (metadata.registrationEndpoint) {\n const regResult = await registerClient(metadata, {\n redirectUri,\n clientName: `Weft - ${server.name}`,\n });\n\n if (regResult.success && regResult.clientId) {\n clientId = regResult.clientId;\n clientSecret = regResult.clientSecret || null;\n } else {\n logger.mcpOAuth.warn('Dynamic client registration failed', { error: regResult.error });\n }\n }\n\n // Generate PKCE values\n const codeVerifier = generateCodeVerifier();\n const codeChallenge = await generateCodeChallenge(codeVerifier);\n const state = generateState(server.boardId, serverId);\n\n // Store pending authorization\n const pendingId = this.generateId();\n const now = new Date().toISOString();\n const expiresAt = new Date(Date.now() + 10 * 60 * 1000).toISOString();\n\n this.sql.exec(\n `INSERT INTO mcp_oauth_pending (id, board_id, server_id, code_verifier, state, resource, scopes, client_id, client_secret, created_at, expires_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n pendingId,\n server.boardId,\n serverId,\n codeVerifier,\n state,\n metadata.resource,\n metadata.scopesSupported?.join(' ') || null,\n clientId,\n clientSecret,\n now,\n expiresAt\n );\n\n // Build authorization URL\n const authUrl = buildAuthorizationUrl(metadata, {\n clientId,\n redirectUri,\n state,\n codeChallenge,\n scopes: metadata.scopesSupported,\n });\n\n return jsonResponse({\n success: true,\n data: {\n url: authUrl,\n state,\n }\n });\n }\n\n /**\n * Exchange OAuth authorization code for tokens\n */\n async exchangeMCPOAuthCode(serverId: string, data: {\n code: string;\n state: string;\n redirectUri: string;\n }): Promise {\n // Validate state\n const parsedState = parseState(data.state);\n if (!parsedState) {\n return jsonResponse({\n success: false,\n error: { code: 'INVALID_STATE', message: 'Invalid or malformed state parameter' }\n }, 400);\n }\n\n if (parsedState.serverId !== serverId) {\n return jsonResponse({\n success: false,\n error: { code: 'STATE_MISMATCH', message: 'State does not match server' }\n }, 400);\n }\n\n // Get pending authorization\n const pendingRow = this.sql.exec(\n 'SELECT * FROM mcp_oauth_pending WHERE state = ? AND server_id = ?',\n data.state,\n serverId\n ).toArray()[0] as Record | undefined;\n\n if (!pendingRow) {\n return jsonResponse({\n success: false,\n error: { code: 'NO_PENDING', message: 'No pending OAuth authorization found' }\n }, 400);\n }\n\n const pending = toCamelCase(pendingRow) as {\n id: string;\n boardId: string;\n codeVerifier: string;\n clientId?: string;\n clientSecret?: string;\n expiresAt: string;\n };\n\n // Check expiration\n if (new Date(pending.expiresAt) < new Date()) {\n this.sql.exec('DELETE FROM mcp_oauth_pending WHERE id = ?', pending.id);\n return jsonResponse({\n success: false,\n error: { code: 'EXPIRED', message: 'OAuth authorization has expired' }\n }, 400);\n }\n\n // Get server and OAuth metadata\n const serverRow = this.mcpService.getServerRow(serverId);\n\n if (!serverRow) {\n return jsonResponse({ success: false, error: { code: 'NOT_FOUND', message: 'MCP server not found' } }, 404);\n }\n\n const server = toCamelCase(serverRow) as {\n id: string;\n name: string;\n oauthMetadata?: string;\n };\n\n if (!server.oauthMetadata) {\n return jsonResponse({\n success: false,\n error: { code: 'NO_OAUTH_METADATA', message: 'OAuth metadata not found' }\n }, 400);\n }\n\n const metadata = JSON.parse(server.oauthMetadata) as MCPOAuthMetadata;\n const clientId = pending.clientId || data.redirectUri;\n\n // Exchange code for tokens\n const tokenResult = await exchangeCodeForTokens(metadata, {\n code: data.code,\n codeVerifier: pending.codeVerifier,\n clientId,\n redirectUri: data.redirectUri,\n });\n\n // Delete pending authorization\n this.sql.exec('DELETE FROM mcp_oauth_pending WHERE id = ?', pending.id);\n\n if (!tokenResult.success || !tokenResult.accessToken) {\n return jsonResponse({\n success: false,\n error: { code: 'TOKEN_EXCHANGE_FAILED', message: tokenResult.error || 'Token exchange failed' }\n }, 400);\n }\n\n // Store tokens as credential\n const credentialId = this.generateId();\n const now = new Date().toISOString();\n const encryptedToken = await this.credentialService.encrypt(tokenResult.accessToken);\n\n this.sql.exec(\n `INSERT INTO board_credentials (id, board_id, type, name, encrypted_value, metadata, created_at, updated_at)\n VALUES (?, ?, 'mcp_oauth', ?, ?, ?, ?, ?)`,\n credentialId,\n pending.boardId,\n `MCP: ${server.name}`,\n encryptedToken,\n JSON.stringify({\n serverId: serverId,\n refreshToken: tokenResult.refreshToken,\n expiresAt: tokenResult.expiresAt,\n scope: tokenResult.scope,\n }),\n now,\n now\n );\n\n // Update MCP server\n this.mcpService.updateServerCredential(serverId, credentialId);\n\n // Try to discover tools\n try {\n await this.mcpService.connectMCPServer(serverId);\n } catch {\n // Non-fatal\n }\n\n return jsonResponse({\n success: true,\n data: {\n status: 'connected',\n credentialId,\n }\n });\n }\n}\n" }, { "path": "worker/services/MCPService.ts", "content": "import { MCPClient, type MCPServerConfig } from '../mcp/MCPClient';\nimport {\n getAccountById,\n getMCPDefinition,\n getMCPTools,\n getAccountForMCPName,\n getMCPByName,\n} from '../mcp/AccountMCPRegistry';\nimport { jsonResponse } from '../utils/response';\nimport { toCamelCase } from '../utils/transformations';\nimport type { CredentialService } from './CredentialService';\n\nexport class MCPService {\n private sql: SqlStorage;\n private credentialService: CredentialService;\n private generateId: () => string;\n\n constructor(\n sql: SqlStorage,\n credentialService: CredentialService,\n generateId: () => string\n ) {\n this.sql = sql;\n this.credentialService = credentialService;\n this.generateId = generateId;\n }\n\n // ============================================\n // MCP SERVER CRUD\n // ============================================\n\n /**\n * Get all MCP servers for a board\n */\n getMCPServers(boardId: string): Response {\n const servers = this.sql.exec(\n 'SELECT * FROM mcp_servers WHERE board_id = ? ORDER BY created_at DESC',\n boardId\n ).toArray();\n\n return jsonResponse({\n success: true,\n data: servers.map(s => this.transformServer(s as Record))\n });\n }\n\n /**\n * Get a single MCP server by ID\n */\n getMCPServer(serverId: string): Response {\n const serverRow = this.sql.exec(\n 'SELECT * FROM mcp_servers WHERE id = ?',\n serverId\n ).toArray()[0];\n\n if (!serverRow) {\n return jsonResponse({ error: 'MCP server not found' }, 404);\n }\n\n return jsonResponse({\n success: true,\n data: this.transformServer(serverRow as Record)\n });\n }\n\n /**\n * Create a new MCP server\n */\n createMCPServer(boardId: string, data: {\n name: string;\n type: 'remote' | 'hosted';\n endpoint?: string;\n authType?: string;\n credentialId?: string;\n status?: string;\n transportType?: 'streamable-http' | 'sse';\n urlPatterns?: Array<{ pattern: string; type: string; fetchTool: string }>;\n }): Response {\n const id = this.generateId();\n const now = new Date().toISOString();\n\n this.sql.exec(\n `INSERT INTO mcp_servers (id, board_id, name, type, endpoint, auth_type, credential_id, enabled, status, transport_type, url_patterns, created_at, updated_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?)`,\n id,\n boardId,\n data.name,\n data.type,\n data.endpoint || null,\n data.authType || 'none',\n data.credentialId || null,\n data.status || 'disconnected',\n data.transportType || 'streamable-http',\n data.urlPatterns ? JSON.stringify(data.urlPatterns) : null,\n now,\n now\n );\n\n return this.getMCPServer(id);\n }\n\n /**\n * Create an account-based MCP server (Gmail, Google Docs, etc.)\n */\n async createAccountMCP(boardId: string, data: {\n accountId: string;\n mcpId: string;\n }): Promise {\n const account = getAccountById(data.accountId);\n if (!account) {\n return jsonResponse({\n success: false,\n error: { code: 'INVALID_ACCOUNT', message: `Unknown account: ${data.accountId}` }\n }, 400);\n }\n\n const mcpDef = getMCPDefinition(data.accountId, data.mcpId);\n if (!mcpDef) {\n return jsonResponse({\n success: false,\n error: { code: 'INVALID_MCP', message: `Unknown MCP: ${data.mcpId} for account ${data.accountId}` }\n }, 400);\n }\n\n const credentialId = this.credentialService.findCredentialId(boardId, account.credentialType);\n if (!credentialId) {\n return jsonResponse({\n success: false,\n error: { code: 'NO_CREDENTIAL', message: `${account.name} account not connected` }\n }, 400);\n }\n\n // Check if MCP already exists\n const existing = this.sql.exec(\n 'SELECT id FROM mcp_servers WHERE board_id = ? AND name = ?',\n boardId,\n mcpDef.name\n ).toArray()[0];\n\n if (existing) {\n return jsonResponse({\n success: false,\n error: { code: 'ALREADY_EXISTS', message: `${mcpDef.name} MCP already exists` }\n }, 400);\n }\n\n // Create the MCP server\n const id = this.generateId();\n const now = new Date().toISOString();\n\n this.sql.exec(\n `INSERT INTO mcp_servers (id, board_id, name, type, endpoint, auth_type, credential_id, enabled, status, url_patterns, created_at, updated_at)\n VALUES (?, ?, ?, 'hosted', NULL, 'oauth', ?, 1, 'connected', ?, ?, ?)`,\n id,\n boardId,\n mcpDef.name,\n credentialId,\n mcpDef.urlPatterns ? JSON.stringify(mcpDef.urlPatterns) : null,\n now,\n now\n );\n\n // Cache the tools\n const tools = getMCPTools(data.accountId, data.mcpId);\n for (const tool of tools) {\n const toolId = this.generateId();\n this.sql.exec(\n `INSERT INTO mcp_tool_schemas (id, server_id, name, description, input_schema, output_schema, approval_required_fields, cached_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,\n toolId,\n id,\n tool.name,\n tool.description || null,\n JSON.stringify(tool.inputSchema),\n tool.outputSchema ? JSON.stringify(tool.outputSchema) : null,\n tool.approvalRequiredFields ? JSON.stringify(tool.approvalRequiredFields) : null,\n now\n );\n }\n\n return this.getMCPServer(id);\n }\n\n /**\n * Update an MCP server\n */\n updateMCPServer(serverId: string, data: {\n name?: string;\n endpoint?: string;\n authType?: string;\n credentialId?: string;\n enabled?: boolean;\n status?: string;\n transportType?: 'streamable-http' | 'sse';\n }): Response {\n const now = new Date().toISOString();\n const server = this.sql.exec('SELECT * FROM mcp_servers WHERE id = ?', serverId).toArray()[0];\n\n if (!server) {\n return jsonResponse({ error: 'MCP server not found' }, 404);\n }\n\n this.sql.exec(\n `UPDATE mcp_servers SET\n name = COALESCE(?, name),\n endpoint = COALESCE(?, endpoint),\n auth_type = COALESCE(?, auth_type),\n credential_id = COALESCE(?, credential_id),\n enabled = COALESCE(?, enabled),\n status = COALESCE(?, status),\n transport_type = COALESCE(?, transport_type),\n updated_at = ?\n WHERE id = ?`,\n data.name ?? null,\n data.endpoint ?? null,\n data.authType ?? null,\n data.credentialId ?? null,\n data.enabled !== undefined ? (data.enabled ? 1 : 0) : null,\n data.status ?? null,\n data.transportType ?? null,\n now,\n serverId\n );\n\n return this.getMCPServer(serverId);\n }\n\n /**\n * Delete an MCP server\n */\n deleteMCPServer(serverId: string): Response {\n const server = this.sql.exec('SELECT id FROM mcp_servers WHERE id = ?', serverId).toArray()[0];\n if (!server) {\n return jsonResponse({ error: 'MCP server not found' }, 404);\n }\n this.sql.exec('DELETE FROM mcp_tool_schemas WHERE server_id = ?', serverId);\n this.sql.exec('DELETE FROM mcp_servers WHERE id = ?', serverId);\n return jsonResponse({ success: true });\n }\n\n // ============================================\n // MCP TOOLS\n // ============================================\n\n /**\n * Get tools for an MCP server\n * For hosted MCPs, always returns fresh tools from the registry (no stale cache)\n * For external MCPs, returns cached tools\n */\n async getMCPServerTools(serverId: string): Promise {\n const server = this.sql.exec(\n 'SELECT name, type FROM mcp_servers WHERE id = ?',\n serverId\n ).toArray()[0] as { name: string; type: string } | undefined;\n\n if (!server) {\n return jsonResponse({ success: true, data: [] });\n }\n\n if (server.type === 'hosted') {\n const account = getAccountForMCPName(server.name);\n const mcp = getMCPByName(server.name);\n\n if (account && mcp) {\n const tools = getMCPTools(account.id, mcp.id);\n return jsonResponse({\n success: true,\n data: tools.map(t => ({\n name: t.name,\n description: t.description,\n inputSchema: t.inputSchema,\n approvalRequiredFields: t.approvalRequiredFields,\n }))\n });\n }\n }\n\n const tools = this.sql.exec(\n 'SELECT * FROM mcp_tool_schemas WHERE server_id = ? ORDER BY name',\n serverId\n ).toArray();\n\n return jsonResponse({\n success: true,\n data: tools.map(t => this.transformTool(t as Record))\n });\n }\n\n /**\n * Cache tools for an MCP server\n */\n async cacheMCPServerTools(serverId: string, data: {\n tools: Array<{\n name: string;\n description?: string;\n inputSchema: object;\n approvalRequiredFields?: string[];\n }>;\n }): Promise {\n const now = new Date().toISOString();\n\n this.sql.exec('DELETE FROM mcp_tool_schemas WHERE server_id = ?', serverId);\n\n for (const tool of data.tools) {\n const id = this.generateId();\n this.sql.exec(\n `INSERT INTO mcp_tool_schemas (id, server_id, name, description, input_schema, approval_required_fields, cached_at)\n VALUES (?, ?, ?, ?, ?, ?, ?)`,\n id,\n serverId,\n tool.name,\n tool.description || null,\n JSON.stringify(tool.inputSchema),\n tool.approvalRequiredFields ? JSON.stringify(tool.approvalRequiredFields) : null,\n now\n );\n }\n\n return await this.getMCPServerTools(serverId);\n }\n\n // ============================================\n // MCP CONNECTION\n // ============================================\n\n /**\n * Connect to a remote MCP server and discover tools\n */\n async connectMCPServer(serverId: string): Promise {\n const serverRow = this.sql.exec(\n 'SELECT * FROM mcp_servers WHERE id = ?',\n serverId\n ).toArray()[0] as Record | undefined;\n\n if (!serverRow) {\n return jsonResponse({ success: false, error: { code: 'NOT_FOUND', message: 'MCP server not found' } }, 404);\n }\n\n const server = toCamelCase(serverRow) as {\n id: string;\n name: string;\n type: string;\n endpoint?: string;\n authType: string;\n credentialId?: string;\n transportType?: string;\n };\n\n if (server.type !== 'remote' || !server.endpoint) {\n return jsonResponse({\n success: false,\n error: { code: 'INVALID_SERVER', message: 'Only remote MCP servers can be connected' }\n }, 400);\n }\n\n try {\n const config: MCPServerConfig = {\n id: server.id,\n name: server.name,\n type: 'remote',\n endpoint: server.endpoint,\n authType: server.authType as MCPServerConfig['authType'],\n transportType: (server.transportType as MCPServerConfig['transportType']) || 'streamable-http',\n };\n\n // Get credentials if needed\n if (server.credentialId && ['bearer', 'api_key', 'oauth'].includes(server.authType)) {\n const credRow = this.credentialService.getCredentialRowById(server.credentialId);\n if (credRow) {\n const token = await this.credentialService.decrypt(credRow.encrypted_value);\n if (server.authType === 'oauth' || server.authType === 'bearer') {\n config.credentials = { token };\n } else {\n config.credentials = { apiKey: token };\n }\n }\n }\n\n const client = new MCPClient(config);\n await client.initialize();\n const tools = await client.listTools();\n\n // Cache discovered tools\n const now = new Date().toISOString();\n this.sql.exec('DELETE FROM mcp_tool_schemas WHERE server_id = ?', serverId);\n\n for (const tool of tools) {\n const id = this.generateId();\n this.sql.exec(\n `INSERT INTO mcp_tool_schemas (id, server_id, name, description, input_schema, approval_required_fields, cached_at)\n VALUES (?, ?, ?, ?, ?, ?, ?)`,\n id,\n serverId,\n tool.name,\n tool.description || null,\n JSON.stringify(tool.inputSchema),\n tool.approvalRequiredFields ? JSON.stringify(tool.approvalRequiredFields) : null,\n now\n );\n }\n\n // Update status\n this.sql.exec(\n \"UPDATE mcp_servers SET status = 'connected', updated_at = ? WHERE id = ?\",\n now,\n serverId\n );\n\n return jsonResponse({\n success: true,\n data: {\n status: 'connected',\n toolCount: tools.length,\n tools: tools.map(t => ({ name: t.name, description: t.description })),\n }\n });\n } catch (error) {\n const message = error instanceof Error ? error.message : 'Connection failed';\n const now = new Date().toISOString();\n this.sql.exec(\n \"UPDATE mcp_servers SET status = 'error', updated_at = ? WHERE id = ?\",\n now,\n serverId\n );\n\n return jsonResponse({\n success: false,\n error: { code: 'CONNECTION_FAILED', message }\n }, 500);\n }\n }\n\n // ============================================\n // HELPERS\n // ============================================\n\n /**\n * Get server row by ID (for OAuth service)\n */\n getServerRow(serverId: string): Record | undefined {\n return this.sql.exec('SELECT * FROM mcp_servers WHERE id = ?', serverId).toArray()[0] as Record | undefined;\n }\n\n /**\n * Update OAuth metadata for a server\n */\n updateOAuthMetadata(serverId: string, metadata: object): void {\n const now = new Date().toISOString();\n this.sql.exec(\n 'UPDATE mcp_servers SET oauth_metadata = ?, updated_at = ? WHERE id = ?',\n JSON.stringify(metadata),\n now,\n serverId\n );\n }\n\n /**\n * Update server credential and status\n */\n updateServerCredential(serverId: string, credentialId: string): void {\n const now = new Date().toISOString();\n this.sql.exec(\n \"UPDATE mcp_servers SET credential_id = ?, status = 'connected', updated_at = ? WHERE id = ?\",\n credentialId,\n now,\n serverId\n );\n }\n\n private transformServer(row: Record): Record {\n const server = toCamelCase(row);\n if (typeof server.urlPatterns === 'string' && server.urlPatterns) {\n try {\n server.urlPatterns = JSON.parse(server.urlPatterns);\n } catch {\n server.urlPatterns = null;\n }\n }\n return server;\n }\n\n private transformTool(row: Record): Record {\n const tool = toCamelCase(row);\n if (typeof tool.inputSchema === 'string') {\n try {\n tool.inputSchema = JSON.parse(tool.inputSchema);\n } catch {\n // Leave as string\n }\n }\n if (typeof tool.approvalRequiredFields === 'string') {\n try {\n tool.approvalRequiredFields = JSON.parse(tool.approvalRequiredFields);\n } catch {\n // Leave as string\n }\n }\n return tool;\n }\n}\n" }, { "path": "worker/services/ScheduleService.ts", "content": "import { jsonResponse } from '../utils/response';\nimport { transformScheduledRun, transformTask } from '../utils/transformations';\n\nexport interface ScheduleConfig {\n enabled: boolean;\n frequency: 'daily' | 'weekly' | 'custom';\n time: string; // \"05:00\" (24-hour format)\n timezone: string; // \"America/Los_Angeles\"\n daysOfWeek?: number[]; // For weekly: [1,3,5] = Mon,Wed,Fri (0=Sun)\n cron?: string; // For custom: \"0 5 * * *\"\n targetColumnId: string;\n}\n\nexport type ScheduledRunStatus = 'pending' | 'running' | 'completed' | 'failed';\n\nexport interface ScheduledRun {\n id: string;\n taskId: string;\n status: ScheduledRunStatus;\n startedAt?: string;\n completedAt?: string;\n tasksCreated: number;\n summary?: string;\n error?: string;\n createdAt: string;\n}\n\ninterface TaskRow {\n id: string;\n column_id: string;\n board_id: string;\n title: string;\n description: string | null;\n priority: string;\n position: number;\n context: string | null;\n schedule_config: string | null;\n parent_task_id: string | null;\n run_id: string | null;\n created_at: string;\n updated_at: string;\n}\n\nexport class ScheduleService {\n private sql: SqlStorage;\n private generateId: () => string;\n\n constructor(sql: SqlStorage, generateId: () => string) {\n this.sql = sql;\n this.generateId = generateId;\n }\n\n getScheduledTasks(boardId: string): Response {\n const tasks = this.sql.exec(\n `SELECT * FROM tasks\n WHERE board_id = ?\n AND schedule_config IS NOT NULL`,\n boardId\n ).toArray();\n\n const scheduledTasks = tasks.filter((task) => {\n const row = task as unknown as TaskRow;\n if (!row.schedule_config) return false;\n try {\n const config = JSON.parse(row.schedule_config) as ScheduleConfig;\n return config.enabled;\n } catch {\n return false;\n }\n });\n\n return jsonResponse({\n success: true,\n data: scheduledTasks.map(t => transformTask(t as Record))\n });\n }\n\n getScheduledRuns(taskId: string, limit = 10): Response {\n const runs = this.sql.exec(\n `SELECT * FROM scheduled_runs\n WHERE task_id = ?\n ORDER BY created_at DESC\n LIMIT ?`,\n taskId,\n limit\n ).toArray();\n\n return jsonResponse({\n success: true,\n data: runs.map(r => transformScheduledRun(r as Record))\n });\n }\n\n getRunTasks(runId: string): Response {\n const tasks = this.sql.exec(\n `SELECT * FROM tasks WHERE run_id = ? ORDER BY created_at`,\n runId\n ).toArray();\n\n return jsonResponse({\n success: true,\n data: tasks.map(t => transformTask(t as Record))\n });\n }\n\n getChildTasks(parentTaskId: string): Response {\n const tasks = this.sql.exec(\n `SELECT * FROM tasks WHERE parent_task_id = ? ORDER BY created_at DESC`,\n parentTaskId\n ).toArray();\n\n return jsonResponse({\n success: true,\n data: tasks.map(t => transformTask(t as Record))\n });\n }\n\n createScheduledRun(taskId: string): Response {\n const id = this.generateId();\n const now = new Date().toISOString();\n\n this.sql.exec(\n `INSERT INTO scheduled_runs (id, task_id, status, started_at, tasks_created, created_at)\n VALUES (?, ?, 'pending', ?, 0, ?)`,\n id,\n taskId,\n now,\n now\n );\n\n const run = this.sql.exec('SELECT * FROM scheduled_runs WHERE id = ?', id).toArray()[0];\n return jsonResponse({ success: true, data: transformScheduledRun(run as Record) });\n }\n\n updateScheduledRun(runId: string, data: {\n status?: ScheduledRunStatus;\n completedAt?: string;\n tasksCreated?: number;\n summary?: string;\n error?: string;\n childTasksInfo?: Array<{ id: string; title: string }>;\n }): Response {\n const run = this.sql.exec('SELECT * FROM scheduled_runs WHERE id = ?', runId).toArray()[0];\n if (!run) {\n return jsonResponse({ error: 'Scheduled run not found' }, 404);\n }\n\n const currentRun = run as Record;\n\n this.sql.exec(\n `UPDATE scheduled_runs SET\n status = ?,\n completed_at = ?,\n tasks_created = ?,\n summary = ?,\n error = ?,\n child_tasks_info = ?\n WHERE id = ?`,\n data.status ?? currentRun.status,\n data.completedAt ?? currentRun.completed_at,\n data.tasksCreated ?? currentRun.tasks_created,\n data.summary ?? currentRun.summary,\n data.error ?? currentRun.error,\n data.childTasksInfo ? JSON.stringify(data.childTasksInfo) : currentRun.child_tasks_info,\n runId\n );\n\n const updated = this.sql.exec('SELECT * FROM scheduled_runs WHERE id = ?', runId).toArray()[0];\n return jsonResponse({ success: true, data: transformScheduledRun(updated as Record) });\n }\n\n deleteScheduledRun(runId: string): void {\n this.sql.exec('DELETE FROM scheduled_runs WHERE id = ?', runId);\n }\n\n getNextScheduledRunTime(boardId: string): number | null {\n const tasks = this.sql.exec(\n `SELECT * FROM tasks\n WHERE board_id = ?\n AND schedule_config IS NOT NULL`,\n boardId\n ).toArray();\n\n let earliestNextRun: number | null = null;\n\n for (const task of tasks) {\n const row = task as unknown as TaskRow;\n if (!row.schedule_config) continue;\n\n try {\n const config = JSON.parse(row.schedule_config) as ScheduleConfig;\n if (!config.enabled) continue;\n\n const nextRun = this.calculateNextRunTime(config);\n if (nextRun !== null) {\n if (earliestNextRun === null || nextRun < earliestNextRun) {\n earliestNextRun = nextRun;\n }\n }\n } catch {\n // Invalid JSON in schedule_config - skip this task\n }\n }\n\n return earliestNextRun;\n }\n\n getTasksDueForRun(boardId: string, alarmTimestamp: number): Array<{\n id: string;\n config: ScheduleConfig;\n lastRunAt?: string;\n }> {\n const tasks = this.sql.exec(\n `SELECT t.*,\n (SELECT MAX(sr.completed_at) FROM scheduled_runs sr\n WHERE sr.task_id = t.id AND sr.status = 'completed') as last_completed_at,\n (SELECT MAX(sr.created_at) FROM scheduled_runs sr WHERE sr.task_id = t.id) as last_run_at\n FROM tasks t\n WHERE t.board_id = ?\n AND t.schedule_config IS NOT NULL`,\n boardId\n ).toArray();\n\n const dueTasks: Array<{ id: string; config: ScheduleConfig; lastRunAt?: string }> = [];\n const alarmDate = new Date(alarmTimestamp);\n\n for (const task of tasks) {\n const row = task as unknown as TaskRow & { last_run_at?: string; last_completed_at?: string };\n if (!row.schedule_config) continue;\n\n try {\n const config = JSON.parse(row.schedule_config) as ScheduleConfig;\n\n if (!config.enabled) {\n continue;\n }\n\n if (this.isTaskDueAt(config, alarmDate, row.last_run_at)) {\n dueTasks.push({\n id: row.id,\n config,\n lastRunAt: row.last_completed_at || undefined,\n });\n }\n } catch {\n // Invalid JSON in schedule_config - skip this task\n }\n }\n\n return dueTasks;\n }\n\n private isTaskDueAt(config: ScheduleConfig, alarmDate: Date, lastRunAt?: string): boolean {\n const formatter = new Intl.DateTimeFormat('en-US', {\n timeZone: config.timezone,\n hour: 'numeric',\n minute: 'numeric',\n weekday: 'short',\n hour12: false,\n });\n\n const parts = formatter.formatToParts(alarmDate);\n const getPart = (type: string) => parts.find(p => p.type === type)?.value || '';\n\n const alarmHours = parseInt(getPart('hour'), 10);\n const alarmMinutes = parseInt(getPart('minute'), 10);\n const alarmWeekday = getPart('weekday');\n\n const [schedHours, schedMinutes] = config.time.split(':').map(Number);\n\n const schedTotalMinutes = schedHours * 60 + schedMinutes;\n const alarmTotalMinutes = alarmHours * 60 + alarmMinutes;\n const timeDiff = Math.abs(alarmTotalMinutes - schedTotalMinutes);\n\n if (timeDiff > 5 && timeDiff < (24 * 60 - 5)) {\n return false;\n }\n\n if (config.frequency === 'weekly') {\n const dayMap: Record = { 'Sun': 0, 'Mon': 1, 'Tue': 2, 'Wed': 3, 'Thu': 4, 'Fri': 5, 'Sat': 6 };\n const dayOfWeek = dayMap[alarmWeekday];\n if (!config.daysOfWeek?.includes(dayOfWeek)) {\n return false;\n }\n }\n\n // Prevent duplicate alarm fires within 5-minute window\n if (lastRunAt) {\n const lastRun = new Date(lastRunAt);\n const minutesSinceLastRun = (alarmDate.getTime() - lastRun.getTime()) / (1000 * 60);\n\n if (minutesSinceLastRun < 5) {\n return false;\n }\n }\n\n return true;\n }\n\n calculateNextRunTime(config: ScheduleConfig): number | null {\n if (!config.enabled) return null;\n\n if (config.frequency === 'custom' && config.cron) {\n return this.parseCronNextRun(config.cron, config.timezone);\n }\n\n const now = Date.now();\n const [schedHours, schedMinutes] = config.time.split(':').map(Number);\n const nowLocal = this.getLocalTimeParts(now, config.timezone);\n\n if (config.frequency === 'daily') {\n let targetUtc = this.localTimeToUTC(\n nowLocal.year, nowLocal.month, nowLocal.day,\n schedHours, schedMinutes, config.timezone\n );\n\n if (targetUtc <= now) {\n const tomorrowLocal = this.getLocalTimeParts(now + 24 * 60 * 60 * 1000, config.timezone);\n targetUtc = this.localTimeToUTC(\n tomorrowLocal.year, tomorrowLocal.month, tomorrowLocal.day,\n schedHours, schedMinutes, config.timezone\n );\n }\n\n return targetUtc;\n }\n\n if (config.frequency === 'weekly' && config.daysOfWeek?.length) {\n const sortedDays = [...config.daysOfWeek].sort((a, b) => a - b);\n\n for (let daysAhead = 0; daysAhead <= 7; daysAhead++) {\n const checkLocal = this.getLocalTimeParts(now + daysAhead * 24 * 60 * 60 * 1000, config.timezone);\n\n if (sortedDays.includes(checkLocal.weekday)) {\n const targetUtc = this.localTimeToUTC(\n checkLocal.year, checkLocal.month, checkLocal.day,\n schedHours, schedMinutes, config.timezone\n );\n if (targetUtc > now) {\n return targetUtc;\n }\n }\n }\n }\n\n return null;\n }\n\n private getLocalTimeParts(timestamp: number, timezone: string): {\n year: number;\n month: number;\n day: number;\n hour: number;\n minute: number;\n weekday: number;\n } {\n const formatter = new Intl.DateTimeFormat('en-US', {\n timeZone: timezone,\n year: 'numeric',\n month: '2-digit',\n day: '2-digit',\n hour: '2-digit',\n minute: '2-digit',\n weekday: 'short',\n hour12: false,\n });\n\n const parts = formatter.formatToParts(new Date(timestamp));\n const getPart = (type: string) => parts.find(p => p.type === type)?.value || '';\n const weekdayMap: Record = {\n 'Sun': 0, 'Mon': 1, 'Tue': 2, 'Wed': 3, 'Thu': 4, 'Fri': 5, 'Sat': 6\n };\n\n return {\n year: parseInt(getPart('year'), 10),\n month: parseInt(getPart('month'), 10),\n day: parseInt(getPart('day'), 10),\n hour: parseInt(getPart('hour'), 10),\n minute: parseInt(getPart('minute'), 10),\n weekday: weekdayMap[getPart('weekday')] ?? 0,\n };\n }\n\n private localTimeToUTC(\n year: number, month: number, day: number,\n hour: number, minute: number, timezone: string\n ): number {\n const roughUtc = Date.UTC(year, month - 1, day, hour, minute, 0, 0);\n const offsetMs = this.getTimezoneOffsetMs(roughUtc, timezone);\n return roughUtc - offsetMs;\n }\n\n private getTimezoneOffsetMs(timestamp: number, timezone: string): number {\n const date = new Date(timestamp);\n\n const utcFormatter = new Intl.DateTimeFormat('en-US', {\n timeZone: 'UTC',\n year: 'numeric', month: '2-digit', day: '2-digit',\n hour: '2-digit', minute: '2-digit',\n hour12: false,\n });\n\n const tzFormatter = new Intl.DateTimeFormat('en-US', {\n timeZone: timezone,\n year: 'numeric', month: '2-digit', day: '2-digit',\n hour: '2-digit', minute: '2-digit',\n hour12: false,\n });\n\n const utcParts = utcFormatter.formatToParts(date);\n const tzParts = tzFormatter.formatToParts(date);\n\n const getNum = (parts: Intl.DateTimeFormatPart[], type: string) =>\n parseInt(parts.find(p => p.type === type)?.value || '0', 10);\n\n const utcMs = Date.UTC(\n getNum(utcParts, 'year'), getNum(utcParts, 'month') - 1, getNum(utcParts, 'day'),\n getNum(utcParts, 'hour'), getNum(utcParts, 'minute'), 0\n );\n\n const tzMs = Date.UTC(\n getNum(tzParts, 'year'), getNum(tzParts, 'month') - 1, getNum(tzParts, 'day'),\n getNum(tzParts, 'hour'), getNum(tzParts, 'minute'), 0\n );\n\n return tzMs - utcMs;\n }\n\n private parseCronNextRun(cron: string, timezone: string): number | null {\n const cronParts = cron.trim().split(/\\s+/);\n if (cronParts.length !== 5) return null;\n\n const minutes = this.parseCronField(cronParts[0], 0, 59);\n const hours = this.parseCronField(cronParts[1], 0, 23);\n const daysOfMonth = this.parseCronField(cronParts[2], 1, 31);\n const months = this.parseCronField(cronParts[3], 1, 12);\n const daysOfWeek = this.parseCronField(cronParts[4], 0, 6);\n\n if (!minutes || !hours || !daysOfMonth || !months || !daysOfWeek) {\n return null;\n }\n\n const now = Date.now();\n const startMinute = Math.floor(now / 60000) * 60000 + 60000;\n\n for (let i = 0; i < 366 * 24 * 60; i++) {\n const candidateUtc = startMinute + i * 60000;\n const local = this.getLocalTimeParts(candidateUtc, timezone);\n\n if (\n minutes.has(local.minute) &&\n hours.has(local.hour) &&\n daysOfMonth.has(local.day) &&\n months.has(local.month) &&\n daysOfWeek.has(local.weekday)\n ) {\n return candidateUtc;\n }\n }\n\n return null;\n }\n\n private parseCronField(field: string, min: number, max: number): Set | null {\n const values = new Set();\n\n if (field === '*') {\n for (let i = min; i <= max; i++) values.add(i);\n return values;\n }\n\n for (const part of field.split(',')) {\n if (part.includes('/')) {\n const [rangePart, stepStr] = part.split('/');\n const step = parseInt(stepStr, 10);\n if (isNaN(step) || step <= 0) return null;\n\n let start = min;\n let end = max;\n\n if (rangePart !== '*') {\n if (rangePart.includes('-')) {\n const [s, e] = rangePart.split('-').map(Number);\n if (isNaN(s) || isNaN(e)) return null;\n start = s;\n end = e;\n } else {\n start = parseInt(rangePart, 10);\n if (isNaN(start)) return null;\n }\n }\n\n for (let i = start; i <= end; i += step) {\n if (i >= min && i <= max) values.add(i);\n }\n } else if (part.includes('-')) {\n const [start, end] = part.split('-').map(Number);\n if (isNaN(start) || isNaN(end)) return null;\n for (let i = start; i <= end; i++) {\n if (i >= min && i <= max) values.add(i);\n }\n } else {\n const num = parseInt(part, 10);\n if (isNaN(num) || num < min || num > max) return null;\n values.add(num);\n }\n }\n\n return values.size > 0 ? values : null;\n }\n}\n" }, { "path": "worker/services/WorkflowService.ts", "content": "import { jsonResponse } from '../utils/response';\nimport { transformWorkflowPlan, transformWorkflowLog } from '../utils/transformations';\n\ntype BroadcastFn = (boardId: string, type: string, data: Record) => void;\n\nexport class WorkflowService {\n private sql: SqlStorage;\n private generateId: () => string;\n private broadcast: BroadcastFn;\n\n constructor(\n sql: SqlStorage,\n generateId: () => string,\n broadcast: BroadcastFn\n ) {\n this.sql = sql;\n this.generateId = generateId;\n this.broadcast = broadcast;\n }\n\n // ============================================\n // WORKFLOW PLAN OPERATIONS\n // ============================================\n\n /**\n * Get the latest workflow plan for a task\n */\n getTaskWorkflowPlan(taskId: string): Response {\n const task = this.sql.exec('SELECT id FROM tasks WHERE id = ?', taskId).toArray()[0];\n if (!task) {\n return jsonResponse({ error: 'Task not found' }, 404);\n }\n\n const plan = this.sql.exec(\n 'SELECT * FROM workflow_plans WHERE task_id = ? ORDER BY created_at DESC LIMIT 1',\n taskId\n ).toArray()[0];\n\n if (!plan) {\n return jsonResponse({ success: true, data: null });\n }\n\n return jsonResponse({\n success: true,\n data: transformWorkflowPlan(plan as Record)\n });\n }\n\n /**\n * Get all workflow plans for a board (latest per task)\n */\n getBoardWorkflowPlans(boardId: string): Response {\n const plans = this.sql.exec(`\n SELECT wp.* FROM workflow_plans wp\n INNER JOIN (\n SELECT task_id, MAX(created_at) as max_created\n FROM workflow_plans\n WHERE board_id = ?\n GROUP BY task_id\n ) latest ON wp.task_id = latest.task_id AND wp.created_at = latest.max_created\n WHERE wp.board_id = ?\n `, boardId, boardId).toArray();\n\n return jsonResponse({\n success: true,\n data: plans.map(plan => transformWorkflowPlan(plan as Record))\n });\n }\n\n /**\n * Get a specific workflow plan by ID\n */\n getWorkflowPlan(planId: string): Response {\n const plan = this.sql.exec(\n 'SELECT * FROM workflow_plans WHERE id = ?',\n planId\n ).toArray()[0];\n\n if (!plan) {\n return jsonResponse({ error: 'Workflow plan not found' }, 404);\n }\n\n return jsonResponse({\n success: true,\n data: transformWorkflowPlan(plan as Record)\n });\n }\n\n /**\n * Create a new workflow plan\n */\n createWorkflowPlan(taskId: string, data: {\n id?: string;\n boardId: string;\n summary?: string;\n generatedCode?: string;\n steps?: object[];\n }): Response {\n const id = data.id || this.generateId();\n const now = new Date().toISOString();\n\n this.sql.exec(\n `INSERT INTO workflow_plans (id, task_id, board_id, status, summary, generated_code, steps, created_at, updated_at)\n VALUES (?, ?, ?, 'planning', ?, ?, ?, ?, ?)`,\n id,\n taskId,\n data.boardId,\n data.summary || null,\n data.generatedCode || null,\n data.steps ? JSON.stringify(data.steps) : null,\n now,\n now\n );\n\n return this.getWorkflowPlan(id);\n }\n\n /**\n * Update a workflow plan\n */\n updateWorkflowPlan(planId: string, data: {\n status?: string;\n summary?: string;\n generatedCode?: string;\n steps?: object[];\n currentStepIndex?: number;\n checkpointData?: object;\n result?: object;\n }): Response {\n const now = new Date().toISOString();\n const plan = this.sql.exec('SELECT * FROM workflow_plans WHERE id = ?', planId).toArray()[0];\n\n if (!plan) {\n return jsonResponse({ error: 'Workflow plan not found' }, 404);\n }\n\n this.sql.exec(\n `UPDATE workflow_plans SET\n status = COALESCE(?, status),\n summary = COALESCE(?, summary),\n generated_code = COALESCE(?, generated_code),\n steps = COALESCE(?, steps),\n current_step_index = COALESCE(?, current_step_index),\n checkpoint_data = COALESCE(?, checkpoint_data),\n result = COALESCE(?, result),\n updated_at = ?\n WHERE id = ?`,\n data.status ?? null,\n data.summary ?? null,\n data.generatedCode ?? null,\n data.steps ? JSON.stringify(data.steps) : null,\n data.currentStepIndex ?? null,\n data.checkpointData ? JSON.stringify(data.checkpointData) : null,\n data.result ? JSON.stringify(data.result) : null,\n now,\n planId\n );\n\n // Broadcast update\n const updatedPlan = this.sql.exec('SELECT * FROM workflow_plans WHERE id = ?', planId).toArray()[0];\n if (updatedPlan) {\n const boardId = (updatedPlan as Record).board_id as string;\n this.broadcast(boardId, 'workflow_plan_update', transformWorkflowPlan(updatedPlan as Record));\n }\n\n return this.getWorkflowPlan(planId);\n }\n\n /**\n * Delete a workflow plan\n */\n deleteWorkflowPlan(planId: string): Response {\n const plan = this.sql.exec('SELECT id FROM workflow_plans WHERE id = ?', planId).toArray()[0];\n if (!plan) {\n return jsonResponse({ error: 'Workflow plan not found' }, 404);\n }\n this.sql.exec('DELETE FROM workflow_plans WHERE id = ?', planId);\n return jsonResponse({ success: true });\n }\n\n /**\n * Approve a workflow plan (transition from draft to approved)\n */\n approveWorkflowPlan(planId: string): Response {\n const now = new Date().toISOString();\n this.sql.exec(\n \"UPDATE workflow_plans SET status = 'approved', updated_at = ? WHERE id = ? AND status = 'draft'\",\n now,\n planId\n );\n return this.getWorkflowPlan(planId);\n }\n\n /**\n * Resolve a workflow checkpoint\n */\n resolveWorkflowCheckpoint(planId: string, data: {\n action: string;\n data?: object;\n }): Response {\n const now = new Date().toISOString();\n\n this.sql.exec(\n `UPDATE workflow_plans SET\n status = 'executing',\n checkpoint_data = ?,\n updated_at = ?\n WHERE id = ? AND status = 'checkpoint'`,\n JSON.stringify({ action: data.action, ...data.data }),\n now,\n planId\n );\n\n // Broadcast the update\n const plan = this.sql.exec('SELECT * FROM workflow_plans WHERE id = ?', planId).toArray()[0];\n if (plan) {\n const boardId = (plan as Record).board_id as string;\n this.broadcast(boardId, 'workflow_plan_update', transformWorkflowPlan(plan as Record));\n }\n\n return this.getWorkflowPlan(planId);\n }\n\n // ============================================\n // WORKFLOW LOG OPERATIONS\n // ============================================\n\n /**\n * Get workflow logs for a plan\n */\n getWorkflowLogs(planId: string, params: URLSearchParams): Response {\n const plan = this.sql.exec('SELECT id FROM workflow_plans WHERE id = ?', planId).toArray()[0];\n if (!plan) {\n return jsonResponse({ error: 'Plan not found' }, 404);\n }\n\n const limit = parseInt(params.get('limit') || '100');\n const offset = parseInt(params.get('offset') || '0');\n\n const logs = this.sql.exec(\n 'SELECT * FROM workflow_logs WHERE plan_id = ? ORDER BY timestamp ASC LIMIT ? OFFSET ?',\n planId,\n limit,\n offset\n ).toArray();\n\n return jsonResponse({\n success: true,\n data: logs.map(l => transformWorkflowLog(l as Record))\n });\n }\n\n /**\n * Add a workflow log entry (HTTP handler)\n */\n handleAddWorkflowLog(planId: string, data: {\n level: string;\n message: string;\n stepId?: string;\n metadata?: object;\n }): Response {\n const log = this.addWorkflowLog(planId, data.level, data.message, data.stepId, data.metadata);\n return jsonResponse({ success: true, data: log });\n }\n\n /**\n * Add a workflow log entry (internal use)\n */\n addWorkflowLog(\n planId: string,\n level: string,\n message: string,\n stepId?: string,\n metadata?: object\n ): Record {\n const id = this.generateId();\n const now = new Date().toISOString();\n\n this.sql.exec(\n 'INSERT INTO workflow_logs (id, plan_id, step_id, timestamp, level, message, metadata) VALUES (?, ?, ?, ?, ?, ?, ?)',\n id,\n planId,\n stepId || null,\n now,\n level,\n message,\n metadata ? JSON.stringify(metadata) : null\n );\n\n const log = {\n id,\n planId,\n stepId: stepId || null,\n timestamp: now,\n level,\n message,\n metadata: metadata || null,\n };\n\n // Get boardId from plan and broadcast\n const plan = this.sql.exec('SELECT board_id FROM workflow_plans WHERE id = ?', planId).toArray()[0];\n if (plan) {\n this.broadcast((plan as Record).board_id as string, 'workflow_log', log);\n }\n\n return log;\n }\n}\n" }, { "path": "worker/services/index.ts", "content": "export { BoardService } from './BoardService';\nexport { CredentialService } from './CredentialService';\nexport { MCPService } from './MCPService';\nexport { MCPOAuthService } from './MCPOAuthService';\nexport { WorkflowService } from './WorkflowService';\nexport { ScheduleService } from './ScheduleService';\nexport type { ScheduleConfig, ScheduledRun, ScheduledRunStatus } from './ScheduleService';\n" }, { "path": "worker/utils/crypto.ts", "content": "/**\n * Encryption utilities using Web Crypto API\n *\n * Uses AES-256-GCM for authenticated encryption.\n * Key is derived from ENCRYPTION_KEY environment variable.\n */\n\n/**\n * Encrypt a string value using AES-GCM\n * Returns base64-encoded string containing IV + ciphertext\n */\nexport async function encryptValue(value: string, encryptionKey: string): Promise {\n const key = await deriveKey(encryptionKey);\n const iv = crypto.getRandomValues(new Uint8Array(12));\n const encoded = new TextEncoder().encode(value);\n\n const ciphertext = await crypto.subtle.encrypt(\n { name: 'AES-GCM', iv },\n key,\n encoded\n );\n\n // Combine IV + ciphertext\n const combined = new Uint8Array(iv.length + ciphertext.byteLength);\n combined.set(iv);\n combined.set(new Uint8Array(ciphertext), iv.length);\n\n return arrayBufferToBase64(combined);\n}\n\n/**\n * Decrypt a base64-encoded encrypted value\n */\nexport async function decryptValue(encrypted: string, encryptionKey: string): Promise {\n const key = await deriveKey(encryptionKey);\n const combined = base64ToArrayBuffer(encrypted);\n\n const iv = combined.slice(0, 12);\n const ciphertext = combined.slice(12);\n\n const decrypted = await crypto.subtle.decrypt(\n { name: 'AES-GCM', iv },\n key,\n ciphertext\n );\n\n return new TextDecoder().decode(decrypted);\n}\n\n/**\n * Derive an AES-256 key from the encryption key string\n * Uses PBKDF2 for key derivation\n */\nasync function deriveKey(keyString: string): Promise {\n const keyMaterial = await crypto.subtle.importKey(\n 'raw',\n new TextEncoder().encode(keyString),\n 'PBKDF2',\n false,\n ['deriveKey']\n );\n\n // Use a fixed salt - in production you might want a per-deployment salt\n const salt = new TextEncoder().encode('weft-credential-encryption-v1');\n\n return crypto.subtle.deriveKey(\n {\n name: 'PBKDF2',\n salt,\n iterations: 100000,\n hash: 'SHA-256',\n },\n keyMaterial,\n { name: 'AES-GCM', length: 256 },\n false,\n ['encrypt', 'decrypt']\n );\n}\n\n/**\n * Convert Uint8Array to base64 string\n */\nfunction arrayBufferToBase64(buffer: Uint8Array): string {\n let binary = '';\n for (let i = 0; i < buffer.length; i++) {\n binary += String.fromCharCode(buffer[i]);\n }\n return btoa(binary);\n}\n\n/**\n * Convert base64 string to Uint8Array\n */\nfunction base64ToArrayBuffer(base64: string): Uint8Array {\n const binary = atob(base64);\n const bytes = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n bytes[i] = binary.charCodeAt(i);\n }\n return bytes;\n}\n\n" }, { "path": "worker/utils/logger.ts", "content": "/**\n * Structured logger for Cloudflare Workers\n *\n * Provides consistent log formatting with context.\n * In production, these go to Cloudflare's logging infrastructure.\n */\n\ntype LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\ninterface LogContext {\n [key: string]: unknown;\n}\n\ninterface Logger {\n debug(message: string, context?: LogContext): void;\n info(message: string, context?: LogContext): void;\n warn(message: string, context?: LogContext): void;\n error(message: string, context?: LogContext): void;\n}\n\nfunction formatLog(level: LogLevel, component: string, message: string, context?: LogContext): string {\n const entry = {\n level,\n component,\n message,\n ...context,\n timestamp: new Date().toISOString(),\n };\n return JSON.stringify(entry);\n}\n\n/**\n * Create a logger for a specific component\n */\nexport function createLogger(component: string): Logger {\n return {\n debug(message: string, context?: LogContext) {\n console.log(formatLog('debug', component, message, context));\n },\n info(message: string, context?: LogContext) {\n console.log(formatLog('info', component, message, context));\n },\n warn(message: string, context?: LogContext) {\n console.warn(formatLog('warn', component, message, context));\n },\n error(message: string, context?: LogContext) {\n console.error(formatLog('error', component, message, context));\n },\n };\n}\n\n// Pre-configured loggers for common components\nexport const logger = {\n worker: createLogger('Worker'),\n auth: createLogger('Auth'),\n workflow: createLogger('AgentWorkflow'),\n mcp: createLogger('MCP'),\n mcpBridge: createLogger('MCPBridge'),\n mcpOAuth: createLogger('MCPOAuth'),\n sandbox: createLogger('Sandbox'),\n board: createLogger('BoardService'),\n credential: createLogger('CredentialService'),\n schedule: createLogger('Schedule'),\n};\n" }, { "path": "worker/utils/oauth-state.ts", "content": "/**\n * Secure OAuth state encoding/decoding with HMAC signature\n *\n * Uses HMAC-SHA256 to sign the state, preventing tampering.\n * The state includes a timestamp to prevent replay attacks.\n */\n\ninterface OAuthStatePayload {\n boardId: string;\n nonce: string;\n timestamp: number;\n}\n\nconst STATE_MAX_AGE_MS = 10 * 60 * 1000; // 10 minutes\n\n/**\n * Sign and encode OAuth state\n */\nexport async function encodeOAuthState(\n payload: { boardId: string; nonce: string },\n secretKey: string\n): Promise {\n const statePayload: OAuthStatePayload = {\n ...payload,\n timestamp: Date.now(),\n };\n\n const payloadJson = JSON.stringify(statePayload);\n const payloadBase64 = btoa(payloadJson);\n\n // Create HMAC signature\n const signature = await createHmacSignature(payloadBase64, secretKey);\n\n // Combine payload and signature\n return `${payloadBase64}.${signature}`;\n}\n\n/**\n * Decode and verify OAuth state\n * Returns null if signature is invalid or state has expired\n */\nexport async function decodeOAuthState(\n encodedState: string,\n secretKey: string\n): Promise {\n const parts = encodedState.split('.');\n if (parts.length !== 2) {\n return null;\n }\n\n const [payloadBase64, signature] = parts;\n\n // Verify signature\n const expectedSignature = await createHmacSignature(payloadBase64, secretKey);\n if (!timingSafeEqual(signature, expectedSignature)) {\n return null;\n }\n\n // Decode payload\n try {\n const payloadJson = atob(payloadBase64);\n const payload = JSON.parse(payloadJson) as OAuthStatePayload;\n\n // Check timestamp (prevent replay attacks)\n const age = Date.now() - payload.timestamp;\n if (age > STATE_MAX_AGE_MS || age < 0) {\n return null;\n }\n\n return payload;\n } catch {\n return null;\n }\n}\n\n/**\n * Create HMAC-SHA256 signature\n */\nasync function createHmacSignature(data: string, secretKey: string): Promise {\n const encoder = new TextEncoder();\n const keyData = encoder.encode(secretKey);\n const dataBuffer = encoder.encode(data);\n\n const cryptoKey = await crypto.subtle.importKey(\n 'raw',\n keyData,\n { name: 'HMAC', hash: 'SHA-256' },\n false,\n ['sign']\n );\n\n const signatureBuffer = await crypto.subtle.sign('HMAC', cryptoKey, dataBuffer);\n const signatureArray = new Uint8Array(signatureBuffer);\n\n // Convert to base64url (URL-safe base64)\n return btoa(String.fromCharCode(...signatureArray))\n .replace(/\\+/g, '-')\n .replace(/\\//g, '_')\n .replace(/=+$/, '');\n}\n\n/**\n * Timing-safe string comparison to prevent timing attacks\n */\nfunction timingSafeEqual(a: string, b: string): boolean {\n if (a.length !== b.length) {\n return false;\n }\n\n let result = 0;\n for (let i = 0; i < a.length; i++) {\n result |= a.charCodeAt(i) ^ b.charCodeAt(i);\n }\n\n return result === 0;\n}\n" }, { "path": "worker/utils/response.ts", "content": "/**\n * HTTP response utilities\n */\n\n/**\n * Create a JSON response with proper headers\n */\nexport function jsonResponse(data: object, status = 200): Response {\n return new Response(JSON.stringify(data), {\n status,\n headers: { 'Content-Type': 'application/json' }\n });\n}\n" }, { "path": "worker/utils/transformations.ts", "content": "/**\n * Data transformation utilities for API responses\n *\n * Converts snake_case database records to camelCase for client consumption\n * and parses JSON string fields.\n */\n\n/**\n * Convert snake_case keys to camelCase\n */\nexport function toCamelCase(obj: Record): Record {\n const result: Record = {};\n for (const key in obj) {\n const camelKey = key.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());\n result[camelKey] = obj[key];\n }\n return result;\n}\n\n/**\n * Transform board record for API response\n */\nexport function transformBoard(board: Record): Record {\n return toCamelCase(board);\n}\n\n/**\n * Transform column record for API response\n */\nexport function transformColumn(column: Record): Record {\n return toCamelCase(column);\n}\n\n/**\n * Transform task record for API response\n * Parses scheduleConfig and context JSON fields\n */\nexport function transformTask(task: Record): Record {\n const transformed = toCamelCase(task);\n\n if (typeof transformed.scheduleConfig === 'string' && transformed.scheduleConfig) {\n try {\n transformed.scheduleConfig = JSON.parse(transformed.scheduleConfig);\n } catch {\n // Leave as string\n }\n }\n\n if (typeof transformed.context === 'string' && transformed.context) {\n try {\n transformed.context = JSON.parse(transformed.context);\n } catch {\n // Leave as string\n }\n }\n\n return transformed;\n}\n\n/**\n * Transform workflow plan record for API response\n * Parses steps, checkpointData, and result JSON fields\n */\nexport function transformWorkflowPlan(plan: Record): Record {\n const transformed = toCamelCase(plan);\n\n if (typeof transformed.steps === 'string' && transformed.steps) {\n try {\n transformed.steps = JSON.parse(transformed.steps);\n } catch {\n // Leave as string\n }\n }\n\n if (typeof transformed.checkpointData === 'string' && transformed.checkpointData) {\n try {\n transformed.checkpointData = JSON.parse(transformed.checkpointData);\n } catch {\n // Leave as string\n }\n }\n\n if (typeof transformed.result === 'string' && transformed.result) {\n try {\n transformed.result = JSON.parse(transformed.result);\n } catch {\n // Leave as string\n }\n }\n\n return transformed;\n}\n\n/**\n * Transform workflow log record for API response\n * Parses metadata JSON if present\n */\nexport function transformWorkflowLog(log: Record): Record {\n const transformed = toCamelCase(log);\n\n if (typeof transformed.metadata === 'string' && transformed.metadata) {\n try {\n transformed.metadata = JSON.parse(transformed.metadata);\n } catch {\n // Leave as string\n }\n }\n\n return transformed;\n}\n\n/**\n * Transform scheduled run record for API response\n * Parses childTasksInfo JSON if present\n */\nexport function transformScheduledRun(run: Record): Record {\n const transformed = toCamelCase(run);\n\n if (typeof transformed.childTasksInfo === 'string' && transformed.childTasksInfo) {\n try {\n transformed.childTasksInfo = JSON.parse(transformed.childTasksInfo);\n } catch {\n transformed.childTasksInfo = [];\n }\n }\n\n return transformed;\n}\n" }, { "path": "worker/utils/zodTools.ts", "content": "/**\n * Zod-based tool definitions for MCP servers\n *\n * This utility provides a single source of truth for MCP tool definitions\n * using Zod schemas. It eliminates the duplication between JSON Schema\n * definitions in getTools() and Zod schemas in validation.ts.\n *\n * Usage:\n * ```typescript\n * // Define tools with Zod schemas\n * const myTools = defineTools({\n * myTool: {\n * description: 'Does something',\n * input: z.object({ name: z.string() }),\n * output: z.object({ result: z.string() }),\n * },\n * });\n *\n * // In getTools()\n * getTools() {\n * return toolsToMCPSchemas(myTools);\n * }\n *\n * // In callTool()\n * const parsed = myTools.myTool.input.parse(args);\n * ```\n */\n\nimport { z } from 'zod';\nimport type { MCPToolSchema, JSONSchema } from '../mcp/MCPClient';\n\n/**\n * Definition for a single tool\n */\nexport interface ToolDefinition<\n TInput extends z.ZodTypeAny = z.ZodTypeAny,\n TOutput extends z.ZodTypeAny = z.ZodTypeAny\n> {\n /** Tool description shown to the AI */\n description: string;\n /** Zod schema for input validation */\n input: TInput;\n /** Zod schema for output (optional, for documentation) */\n output?: TOutput;\n /** Fields that require user approval before execution */\n approvalRequiredFields?: string[];\n /** If true, tool is not exposed to agents (internal use only) */\n hidden?: boolean;\n /** If true, tool cannot be called without prior approval via request_approval */\n requiresApproval?: boolean;\n /** If true, tool is not available in scheduled runs (coordination-only mode) */\n disabledInScheduledRuns?: boolean;\n}\n\n/**\n * A collection of tool definitions\n */\nexport type ToolDefinitions = Record;\n\n/**\n * Define a collection of tools with Zod schemas\n * This is the main entry point for defining MCP tools\n */\nexport function defineTools(tools: T): T {\n return tools;\n}\n\n/**\n * Convert a Zod schema to JSON Schema for MCP tool definitions\n * Uses Zod v4's built-in toJSONSchema() method\n */\nfunction zodSchemaToJsonSchema(schema: z.ZodTypeAny): JSONSchema {\n // Use Zod v4's built-in JSON Schema conversion\n const converted = z.toJSONSchema(schema, { target: 'draft-7' });\n\n // Remove $schema field - MCP doesn't need it\n const { $schema: _schema, ...rest } = converted as Record;\n return rest as unknown as JSONSchema;\n}\n\n/**\n * Convert tool definitions to MCP tool schemas for getTools()\n * Hidden tools are filtered out - they can still be called internally\n */\nexport function toolsToMCPSchemas(tools: ToolDefinitions): MCPToolSchema[] {\n return Object.entries(tools)\n .filter(([, def]) => !def.hidden)\n .map(([name, def]) => {\n const schema: MCPToolSchema = {\n name,\n description: def.description,\n inputSchema: zodSchemaToJsonSchema(def.input),\n };\n\n if (def.output) {\n schema.outputSchema = zodSchemaToJsonSchema(def.output);\n }\n\n if (def.approvalRequiredFields && def.approvalRequiredFields.length > 0) {\n schema.approvalRequiredFields = def.approvalRequiredFields;\n }\n\n if (def.requiresApproval) {\n schema.requiresApproval = def.requiresApproval;\n }\n\n if (def.disabledInScheduledRuns) {\n schema.disabledInScheduledRuns = def.disabledInScheduledRuns;\n }\n\n return schema;\n });\n}\n\n/**\n * Parse and validate tool arguments using the Zod schema\n * Throws a descriptive error if validation fails\n */\nexport function parseToolArgs(\n schema: T,\n args: Record\n): z.infer {\n const result = schema.safeParse(args);\n if (!result.success) {\n const errors = result.error.issues\n .map((issue) => `${issue.path.join('.')}: ${issue.message}`)\n .join(', ');\n throw new Error(`Invalid arguments: ${errors}`);\n }\n return result.data;\n}\n\n/**\n * Helper to get a tool's input schema for external use\n */\nexport function getToolInputSchema(\n tools: T,\n toolName: keyof T\n): z.ZodTypeAny {\n return tools[toolName].input;\n}\n\n// ============================================================================\n// Common Reusable Schema Components\n// ============================================================================\n\n/**\n * Common ID fields used across tools\n */\nexport const commonSchemas = {\n // Document/resource IDs\n documentId: z.string().max(100).describe('Google Doc ID'),\n spreadsheetId: z.string().max(100).describe('Google Sheets spreadsheet ID'),\n messageId: z.string().max(100).describe('Gmail message ID'),\n threadId: z.string().max(100).describe('Thread/conversation ID'),\n\n // GitHub-specific\n owner: z.string().max(100).describe('Repository owner (username or organization)'),\n repo: z.string().max(100).describe('Repository name'),\n branch: z.string().max(200).describe('Branch name'),\n gitRef: z.string().max(200).describe('Git ref (branch, tag, or commit SHA)'),\n filePath: z.string().max(500).describe('File path'),\n\n // Common parameters\n maxResults: z.coerce.number().int().min(1).max(100).default(10)\n .describe('Maximum number of results to return'),\n searchQuery: z.string().max(500).describe('Search query'),\n title: z.string().max(256).describe('Title'),\n content: z.string().max(100000).describe('Content'),\n email: z.string().email().describe('Email address'),\n\n // Sandbox-specific\n sessionId: z.string().min(1).max(100).describe('Sandbox session ID'),\n sandboxPath: z.string().max(1000).describe('File path in sandbox'),\n} as const;\n" }, { "path": "worker/workflows/AgentWorkflow.ts", "content": "/**\n * AgentWorkflow - Dynamic agent-driven workflow execution\n *\n * Runs a Claude agent loop that dynamically creates steps as it reasons\n * through the task. Each agent turn and tool call becomes a durable step.\n *\n * Key features:\n * - No upfront code generation - agent reasons step-by-step\n * - Dynamic step creation with real-time UI updates\n * - Streaming responses via WebSocket\n * - Agent-initiated approvals via special tool\n */\n\nimport { WorkflowEntrypoint } from 'cloudflare:workers';\nimport type { WorkflowEvent, WorkflowStep } from 'cloudflare:workers';\nimport Anthropic from '@anthropic-ai/sdk';\nimport type { MessageParam, ContentBlock, ToolUseBlock, TextBlock, Tool } from '@anthropic-ai/sdk/resources/messages';\nimport {\n getMCPByServerName,\n getMCPTools,\n getAlwaysEnabledAccounts,\n getOAuthAccounts,\n getWorkflowGuidance,\n type MCPCredentials,\n type MCPEnvBindings,\n type AccountDefinition,\n} from '../mcp/AccountMCPRegistry';\nimport { MCPClient, type MCPServerConfig } from '../mcp/MCPClient';\nimport { logger } from '../utils/logger';\nimport { CREDENTIAL_TYPES } from '../constants';\nimport type { BoardDO } from '../BoardDO';\n\n// Constants\nconst TOKEN_REFRESH_BUFFER_MS = 5 * 60 * 1000; // 5 minutes before expiry\nconst DEFAULT_MODEL = 'claude-sonnet-4-5-20250929';\n\n// Workflow parameters\nexport interface AgentWorkflowParams {\n planId: string;\n taskId: string;\n boardId: string;\n taskDescription: string;\n // Scheduled run parameters (optional)\n isScheduledRun?: boolean;\n runId?: string;\n targetColumnId?: string;\n parentTaskId?: string;\n // Time context for scheduled runs\n currentTime?: string; // ISO timestamp of when this run started\n lastRunAt?: string; // ISO timestamp of when the last run completed (null if first run)\n scheduleTimezone?: string; // Timezone for the schedule (e.g., \"America/Los_Angeles\")\n}\n\n// Event sent to resume from checkpoint\nexport interface CheckpointEvent {\n action: 'approve' | 'request_changes' | 'cancel';\n feedback?: string;\n // User-edited data from approval form (e.g., PR title/body), passed as JSON string for serialization\n dataJson?: string;\n}\n\n// Extended Env with workflow bindings\n// Uses index signature for dynamic MCP env bindings (Sandbox, GOOGLE_CLIENT_ID, etc.)\ninterface WorkflowEnv {\n BOARD_DO: DurableObjectNamespace;\n AGENT_WORKFLOW: Workflow;\n [key: string]: unknown;\n}\n\n// Step type for UI display\ninterface AgentStep {\n id: string;\n name: string;\n type: 'agent' | 'tool' | 'approval';\n status: 'pending' | 'running' | 'completed' | 'failed' | 'awaiting_approval';\n startedAt?: string;\n completedAt?: string;\n durationMs?: number;\n result?: unknown;\n error?: string;\n // For agent steps\n thinking?: string;\n // For tool steps\n toolName?: string;\n toolArgs?: Record;\n // For approval steps\n approvalMessage?: string;\n approvalData?: unknown;\n}\n\n// Artifact created during execution\ninterface WorkflowArtifact {\n type: 'google_doc' | 'google_sheet' | 'gmail_message' | 'github_pr' | 'file' | 'other';\n url?: string;\n title?: string;\n description?: string;\n // Email content for inline viewing (gmail_message type)\n content?: {\n to?: string;\n cc?: string;\n bcc?: string;\n subject?: string;\n body?: string;\n sentAt?: string;\n };\n}\n\n// MCP tool info for loading\ninterface MCPServerInfo {\n id: string;\n name: string;\n type: 'remote' | 'hosted';\n endpoint?: string;\n authType: string;\n transportType?: 'streamable-http' | 'sse';\n credentialId?: string;\n accessToken?: string; // OAuth access token for remote servers\n tools: Array<{\n name: string;\n description: string;\n inputSchema: Record;\n approvalRequiredFields?: string[];\n requiresApproval?: boolean;\n disabledInScheduledRuns?: boolean;\n }>;\n}\n\n// Store for all credentials during workflow execution\ninterface CredentialStore {\n googleToken?: string;\n googleRefreshToken?: string;\n googleTokenExpiresAt?: string;\n githubToken?: string;\n anthropicApiKey?: string;\n // Index signature for dynamic credential types\n [key: string]: string | undefined;\n}\n\n/**\n * Convert internal tool name to user-friendly display name\n * e.g. \"Google_Docs__createDocument\" -> \"Create Document\"\n */\nfunction formatToolName(toolName: string): string {\n // Split server__method format\n const parts = toolName.split('__');\n const method = parts.length > 1 ? parts[1] : toolName;\n\n // Convert camelCase to Title Case with spaces\n return method\n .replace(/([A-Z])/g, ' $1') // Add space before capitals\n .replace(/^./, (str) => str.toUpperCase()) // Capitalize first letter\n .trim();\n}\n\nexport class AgentWorkflow extends WorkflowEntrypoint {\n async run(event: WorkflowEvent, step: WorkflowStep) {\n const params = event.payload;\n const { planId, boardId, taskDescription } = params;\n // Scheduled run parameters\n const isScheduledRun = params.isScheduledRun ?? false;\n const runId = params.runId;\n const targetColumnId = params.targetColumnId;\n const parentTaskId = params.parentTaskId ?? params.taskId;\n // Time context for scheduled runs\n const currentTime = params.currentTime;\n const lastRunAt = params.lastRunAt;\n const scheduleTimezone = params.scheduleTimezone;\n\n const getBoardStub = (): DurableObjectStub => {\n const doId = this.env.BOARD_DO.idFromName(boardId);\n return this.env.BOARD_DO.get(doId) as DurableObjectStub;\n };\n\n const updatePlan = async (data: Record) => {\n const stub = getBoardStub();\n await stub.updateWorkflowPlan(planId, data);\n };\n\n const addLog = async (level: string, message: string, stepId?: string, metadata?: object) => {\n const stub = getBoardStub();\n stub.addWorkflowLog(planId, level, message, stepId, metadata);\n };\n\n const broadcastStreamChunk = async (turnIndex: number, text: string) => {\n const stub = getBoardStub();\n stub.broadcastStreamChunk(boardId, planId, turnIndex, text);\n };\n\n try {\n const mcpConfigJson = await step.do('load-mcp-config', async () => {\n const stub = getBoardStub();\n\n const rawServers = await stub.getMCPServers(boardId);\n const enabledServers = rawServers.filter((s: { enabled: boolean }) => s.enabled);\n\n const servers: MCPServerInfo[] = [];\n for (const server of enabledServers) {\n const tools = await stub.getMCPServerTools(server.id);\n\n let accessToken: string | undefined;\n if (server.type === 'remote' && server.authType === 'oauth' && server.credentialId) {\n const credData = await stub.getCredentialById(boardId, server.credentialId);\n if (credData) {\n accessToken = credData.value;\n }\n }\n\n servers.push({\n id: server.id,\n name: server.name,\n type: server.type as 'remote' | 'hosted',\n endpoint: server.endpoint || undefined,\n authType: server.authType,\n transportType: server.transportType as 'streamable-http' | 'sse' | undefined,\n credentialId: server.credentialId || undefined,\n accessToken,\n tools: tools.map((t: { name: string; description?: string | null; inputSchema: object; approvalRequiredFields?: string[] | null; requiresApproval?: boolean | null }) => ({\n name: t.name,\n description: t.description || '',\n inputSchema: t.inputSchema as Record,\n approvalRequiredFields: t.approvalRequiredFields || undefined,\n requiresApproval: t.requiresApproval || undefined,\n })),\n });\n }\n\n for (const account of getAlwaysEnabledAccounts()) {\n for (const mcp of account.mcps) {\n const tools = getMCPTools(account.id, mcp.id);\n servers.push({\n id: `${account.id}-builtin`,\n name: mcp.name,\n type: 'hosted',\n authType: account.authType,\n tools: tools.map(t => ({\n name: t.name,\n description: t.description || '',\n inputSchema: t.inputSchema as unknown as Record,\n approvalRequiredFields: t.approvalRequiredFields || undefined,\n requiresApproval: t.requiresApproval || undefined,\n })),\n });\n }\n }\n\n const anthropicApiKey = await stub.getCredentialValue(boardId, CREDENTIAL_TYPES.ANTHROPIC_API_KEY);\n if (!anthropicApiKey) {\n throw new Error('Anthropic API key not configured');\n }\n\n const credentials: Record = {\n anthropicApiKey,\n };\n\n for (const account of getOAuthAccounts()) {\n const credData = await stub.getCredentialFull(boardId, account.credentialType);\n\n const tokenKey = `${account.id}Token`;\n let accessToken = credData?.value;\n\n if (credData?.metadata && account.refreshToken) {\n try {\n const metadata = credData.metadata as Record;\n if (metadata.refresh_token) {\n const needsRefresh = !metadata.expires_at ||\n Date.now() > new Date(metadata.expires_at as string).getTime() - TOKEN_REFRESH_BUFFER_MS;\n\n if (needsRefresh) {\n logger.workflow.info('Refreshing token', { account: account.id });\n\n const clientIdKey = `${account.id.toUpperCase()}_CLIENT_ID`;\n const clientSecretKey = `${account.id.toUpperCase()}_CLIENT_SECRET`;\n const clientId = (this.env as Record)[clientIdKey] as string | undefined;\n const clientSecret = (this.env as Record)[clientSecretKey] as string | undefined;\n\n if (clientId && clientSecret) {\n const newTokenData = await account.refreshToken(\n metadata.refresh_token as string,\n clientId,\n clientSecret\n );\n accessToken = newTokenData.access_token;\n\n const newExpiresAt = new Date(\n Date.now() + (newTokenData.expires_in || 3600) * 1000\n ).toISOString();\n\n await stub.updateCredentialValue(boardId, account.credentialType, newTokenData.access_token, { expires_at: newExpiresAt });\n\n credentials[`${account.id}RefreshToken`] = metadata.refresh_token as string;\n credentials[`${account.id}TokenExpiresAt`] = newExpiresAt;\n }\n } else {\n credentials[`${account.id}RefreshToken`] = metadata.refresh_token as string;\n credentials[`${account.id}TokenExpiresAt`] = metadata.expires_at as string;\n }\n }\n } catch (e) {\n logger.workflow.error('Token refresh error', { account: account.id, error: e instanceof Error ? e.message : String(e) });\n }\n }\n\n credentials[tokenKey] = accessToken;\n }\n\n return JSON.stringify({\n servers,\n credentials,\n });\n });\n\n const mcpConfig = JSON.parse(mcpConfigJson) as {\n servers: MCPServerInfo[];\n credentials: CredentialStore;\n };\n\n const claudeTools = this.buildClaudeTools(mcpConfig.servers, isScheduledRun);\n const systemPrompt = this.buildSystemPrompt(mcpConfig.servers, isScheduledRun, {\n currentTime,\n lastRunAt,\n scheduleTimezone,\n });\n const messages: MessageParam[] = [\n { role: 'user', content: taskDescription },\n ];\n\n const steps: AgentStep[] = [];\n const artifacts: WorkflowArtifact[] = [];\n let turnIndex = 0;\n let done = false;\n let childTasksCreated = 0; // Track child tasks for scheduled runs\n const childTaskTitles: string[] = []; // Track titles for summary\n const childTasksInfo: Array<{ id: string; title: string }> = [];\n const approvedTools = new Set();\n const toolResultsCache: Record = {};\n\n while (!done && turnIndex < 50) {\n const currentTurnIndex = turnIndex;\n\n const turnResultJson = await step.do(`turn-${currentTurnIndex}`, async () => {\n if (currentTurnIndex === 0) {\n await updatePlan({\n status: 'executing',\n steps: [],\n });\n await addLog('info', 'Agent started working on task');\n }\n\n const client = new Anthropic({ apiKey: mcpConfig.credentials.anthropicApiKey });\n\n const stream = client.messages.stream({\n model: DEFAULT_MODEL,\n max_tokens: 8192,\n system: systemPrompt,\n messages,\n tools: claudeTools,\n });\n\n stream.on('text', async (text) => {\n broadcastStreamChunk(currentTurnIndex, text).catch((e) =>\n logger.workflow.error('Stream broadcast failed', { error: e instanceof Error ? e.message : String(e) })\n );\n });\n\n const finalMessage = await stream.finalMessage();\n\n const textContent = finalMessage.content\n .filter((block): block is TextBlock => block.type === 'text')\n .map((block) => block.text)\n .join('\\n');\n\n const agentStep: AgentStep = {\n id: `turn-${currentTurnIndex}`,\n name: textContent.length > 50 ? textContent.substring(0, 50) + '...' : (textContent || 'Thinking...'),\n type: 'agent',\n status: 'completed',\n completedAt: new Date().toISOString(),\n thinking: textContent,\n };\n\n return JSON.stringify({\n response: {\n id: finalMessage.id,\n role: finalMessage.role,\n content: finalMessage.content,\n stop_reason: finalMessage.stop_reason,\n usage: finalMessage.usage,\n },\n agentStep,\n textContent,\n });\n });\n\n const turnResult = JSON.parse(turnResultJson) as {\n response: {\n id: string;\n role: 'assistant';\n content: ContentBlock[];\n stop_reason: 'end_turn' | 'tool_use' | 'max_tokens' | 'stop_sequence';\n usage: { input_tokens: number; output_tokens: number };\n };\n agentStep: AgentStep;\n textContent: string;\n };\n\n const { response, agentStep, textContent } = turnResult;\n steps.push(agentStep);\n\n // Fire-and-forget to avoid extra checkpoint\n updatePlan({ steps: [...steps] }).catch((e) =>\n logger.workflow.error('Plan update failed', { error: e instanceof Error ? e.message : String(e) })\n );\n if (textContent) {\n const truncated = textContent.length > 1500 ? textContent.substring(0, 1500) + '...' : textContent;\n addLog('info', truncated, agentStep.id).catch(() => {});\n }\n\n messages.push({ role: 'assistant', content: response.content });\n\n const toolUses = response.content.filter(\n (block): block is ToolUseBlock => block.type === 'tool_use'\n );\n\n if (toolUses.length > 0) {\n const toolResults: Array<{\n type: 'tool_result';\n tool_use_id: string;\n content: string;\n is_error?: boolean;\n }> = [];\n\n for (const toolUse of toolUses) {\n const toolStepId = `tool-${currentTurnIndex}-${toolUse.id}`;\n\n if (toolUse.name === 'request_approval') {\n // Handle approval request\n const approvalArgs = toolUse.input as {\n tool: string;\n action: string;\n data: Record;\n };\n\n // Validate required fields from tool metadata\n // Tool name format: \"ServerName__methodName\"\n const [serverName, methodName] = approvalArgs.tool.split('__');\n const matchingServer = mcpConfig.servers.find((s: MCPServerInfo) => s.name.replace(/\\s+/g, '_') === serverName);\n const matchingTool = matchingServer?.tools.find((t: { name: string; approvalRequiredFields?: string[] }) => t.name === methodName);\n const required = matchingTool?.approvalRequiredFields;\n\n if (required && required.length > 0) {\n const missing = required.filter((f: string) => !approvalArgs.data?.[f]);\n if (missing.length > 0) {\n // Return error to agent asking for required fields\n toolResults.push({\n type: 'tool_result',\n tool_use_id: toolUse.id,\n content: `Error: Missing required fields for ${approvalArgs.tool}: ${missing.join(', ')}. Please include these fields in the data parameter: ${required.map((f: string) => `\"${f}\"`).join(', ')}.`,\n is_error: true,\n });\n continue;\n }\n }\n\n const approvalStep: AgentStep = {\n id: toolStepId,\n name: approvalArgs.action || 'Waiting for approval',\n type: 'approval',\n status: 'awaiting_approval',\n startedAt: new Date().toISOString(),\n toolName: approvalArgs.tool,\n approvalData: approvalArgs.data,\n };\n steps.push(approvalStep);\n\n // Update plan and wait for approval\n await step.do(`checkpoint-setup-${toolStepId}`, async () => {\n await updatePlan({\n status: 'checkpoint',\n steps: [...steps],\n checkpointData: {\n stepId: toolStepId,\n tool: approvalArgs.tool,\n action: approvalArgs.action,\n data: approvalArgs.data,\n toolResults: toolResultsCache,\n },\n });\n await addLog('info', `Requesting approval: ${approvalArgs.action}`, toolStepId);\n return 'checkpoint';\n });\n\n // Wait for user approval event\n const approvalEvent = await step.waitForEvent(\n `Wait for approval: ${approvalArgs.action}`,\n { type: 'checkpoint-approval', timeout: '7 days' }\n );\n\n // Process approval result\n const approvalAction = approvalEvent.payload.action;\n const approvalFeedback = approvalEvent.payload.feedback;\n\n await step.do(`checkpoint-resolve-${toolStepId}`, async () => {\n if (approvalAction === 'cancel') {\n // User cancelled - fail the workflow\n const stepIndex = steps.findIndex((s) => s.id === toolStepId);\n if (stepIndex >= 0) {\n steps[stepIndex].status = 'failed';\n steps[stepIndex].error = 'User cancelled';\n steps[stepIndex].completedAt = new Date().toISOString();\n }\n await updatePlan({\n status: 'failed',\n steps: [...steps],\n });\n throw new Error('User cancelled the workflow');\n }\n\n if (approvalAction === 'request_changes') {\n // User requested changes - update step and continue with feedback\n const stepIndex = steps.findIndex((s) => s.id === toolStepId);\n if (stepIndex >= 0) {\n steps[stepIndex].status = 'completed';\n steps[stepIndex].completedAt = new Date().toISOString();\n }\n await updatePlan({\n status: 'executing',\n steps: [...steps],\n checkpointData: undefined,\n });\n await addLog('info', `User requested changes: ${approvalFeedback?.substring(0, 100) || ''}`, toolStepId);\n return 'request_changes';\n }\n\n // Update step as approved\n const stepIndex = steps.findIndex((s) => s.id === toolStepId);\n if (stepIndex >= 0) {\n steps[stepIndex].status = 'completed';\n steps[stepIndex].completedAt = new Date().toISOString();\n }\n await updatePlan({\n status: 'executing',\n steps: [...steps],\n checkpointData: undefined,\n });\n await addLog('info', 'User approved', toolStepId);\n return 'approved';\n });\n\n let userData: Record | undefined;\n if (approvalEvent.payload.dataJson) {\n try {\n userData = JSON.parse(approvalEvent.payload.dataJson);\n } catch {\n // Ignore invalid JSON\n }\n }\n\n if (approvalAction === 'request_changes') {\n toolResults.push({\n type: 'tool_result',\n tool_use_id: toolUse.id,\n content: JSON.stringify({\n approved: false,\n action: 'request_changes',\n feedback: approvalFeedback || 'User requested changes without specific feedback',\n message: 'The user has requested changes. Please address the feedback and request approval again.',\n }),\n });\n } else {\n approvedTools.add(approvalArgs.tool);\n\n toolResults.push({\n type: 'tool_result',\n tool_use_id: toolUse.id,\n content: JSON.stringify({\n approved: true,\n feedback: approvalFeedback,\n ...(userData && { userData }),\n }),\n });\n }\n } else if (toolUse.name === 'weft_create_task') {\n // Handle child task creation with forked agent model\n // Child tasks are independent agents that run their own workflows\n const taskArgs = toolUse.input as {\n title: string;\n description: string;\n priority?: 'low' | 'medium' | 'high';\n context?: {\n issueUrl?: string;\n priorAnalysis?: string;\n constraints?: string[];\n [key: string]: unknown;\n };\n startWorkflow?: boolean;\n };\n\n const shouldStartWorkflow = taskArgs.startWorkflow !== false; // default: true\n\n const toolResultJson = await step.do(`create-child-task-${toolStepId}`, async () => {\n if (!targetColumnId) {\n return JSON.stringify({\n success: false,\n error: 'No target column configured for child tasks',\n });\n }\n\n try {\n const stub = getBoardStub();\n\n // Create the child task\n const childTask = await stub.createTask({\n columnId: targetColumnId,\n boardId,\n title: taskArgs.title,\n description: taskArgs.description,\n priority: taskArgs.priority || 'medium',\n context: taskArgs.context as object | undefined,\n parentTaskId,\n runId,\n }) as { id: string; title: string };\n\n const childTaskId = childTask.id;\n const childTaskTitle = childTask.title;\n\n let workflowStarted = false;\n\n // If startWorkflow is true (default), trigger the child's workflow\n if (shouldStartWorkflow) {\n try {\n // Create a workflow plan for the child task\n const childPlanId = `plan-${childTaskId}-${Date.now()}`;\n await stub.createWorkflowPlan(childTaskId, {\n id: childPlanId,\n boardId,\n steps: [],\n });\n\n // Build comprehensive task description including context\n // The description is what the user sees, context has the details for the agent\n let fullTaskDescription = taskArgs.description;\n if (taskArgs.context && Object.keys(taskArgs.context).length > 0) {\n fullTaskDescription += '\\n\\n## Context from parent task\\n';\n fullTaskDescription += JSON.stringify(taskArgs.context, null, 2);\n }\n\n // Start the child workflow\n await this.env.AGENT_WORKFLOW.create({\n id: childPlanId,\n params: {\n planId: childPlanId,\n taskId: childTaskId,\n boardId,\n taskDescription: fullTaskDescription,\n // Child tasks can also create grandchildren if needed\n isScheduledRun: false, // Child workflows are not scheduled runs\n targetColumnId, // Pass through for potential grandchildren\n },\n });\n\n workflowStarted = true;\n } catch (workflowError) {\n // Log but don't fail task creation if workflow start fails\n const errorMsg = workflowError instanceof Error ? workflowError.message : String(workflowError);\n logger.workflow.error('Failed to start child workflow', { childTaskId, error: errorMsg });\n }\n }\n\n await addLog(\n 'info',\n `Created child task: ${taskArgs.title}${workflowStarted ? ' (workflow started)' : ''}`,\n toolStepId,\n {\n type: 'child_task_created',\n taskId: childTaskId,\n workflowStarted,\n }\n );\n\n return JSON.stringify({\n success: true,\n taskId: childTaskId,\n title: childTaskTitle,\n workflowStarted,\n message: workflowStarted\n ? `Created task \"${childTaskTitle}\" and started its workflow. The child agent will work independently.`\n : `Created task \"${childTaskTitle}\" in the target column.`,\n });\n } catch (e) {\n const error = e instanceof Error ? e.message : String(e);\n await addLog('error', `Failed to create child task: ${error}`, toolStepId);\n return JSON.stringify({\n success: false,\n error,\n });\n }\n });\n\n const result = JSON.parse(toolResultJson);\n if (result.success) {\n childTasksCreated++;\n childTaskTitles.push(taskArgs.title);\n childTasksInfo.push({ id: result.taskId, title: result.title || taskArgs.title });\n }\n\n const childTaskStep: AgentStep = {\n id: toolStepId,\n name: `Fork agent: ${taskArgs.title.substring(0, 25)}${taskArgs.title.length > 25 ? '...' : ''}`,\n type: 'tool',\n status: result.success ? 'completed' : 'failed',\n startedAt: new Date().toISOString(),\n completedAt: new Date().toISOString(),\n toolName: 'weft_create_task',\n toolArgs: taskArgs,\n result: result.success ? result : undefined,\n error: result.success ? undefined : result.error,\n };\n steps.push(childTaskStep);\n\n // Fire-and-forget to avoid extra checkpoint\n updatePlan({ steps: [...steps] }).catch((e) =>\n logger.workflow.error('Plan update failed', { error: e instanceof Error ? e.message : String(e) })\n );\n\n toolResults.push({\n type: 'tool_result',\n tool_use_id: toolUse.id,\n content: toolResultJson,\n is_error: !result.success,\n });\n } else {\n const toolResultJson = await step.do(`tool-${toolStepId}`, async () => {\n const startTime = Date.now();\n const toolStepData: AgentStep = {\n id: toolStepId,\n name: formatToolName(toolUse.name),\n type: 'tool',\n status: 'running',\n startedAt: new Date().toISOString(),\n toolName: toolUse.name,\n toolArgs: toolUse.input as Record,\n };\n\n await addLog(\n 'info',\n `Calling ${formatToolName(toolUse.name)}`,\n toolStepId,\n { type: 'tool_call', tool: toolUse.name, args: toolUse.input }\n );\n\n let success = false;\n let result: unknown;\n let error: string | undefined;\n\n const [serverName, methodName] = toolUse.name.split('__');\n const matchingServer = mcpConfig.servers.find((s: MCPServerInfo) => s.name.replace(/\\s+/g, '_') === serverName);\n const matchingTool = matchingServer?.tools.find((t: { name: string; requiresApproval?: boolean }) => t.name === methodName);\n\n if (matchingTool?.requiresApproval && !approvedTools.has(toolUse.name)) {\n error = `This tool requires approval before use. Please call request_approval first with tool=\"${toolUse.name}\" to get user approval, then retry this tool call after approval is granted.`;\n } else {\n try {\n result = await this.executeMcpTool(\n toolUse.name,\n toolUse.input as Record,\n mcpConfig.credentials,\n mcpConfig.servers\n );\n const mcpResult = result as { isError?: boolean; content?: Array<{ type: string; text?: string }> };\n if (mcpResult.isError) {\n error = mcpResult.content?.find(c => c.type === 'text')?.text || 'Tool returned error';\n } else {\n success = true;\n }\n } catch (e) {\n error = e instanceof Error ? e.message : String(e);\n }\n }\n\n const durationMs = Date.now() - startTime;\n\n toolStepData.status = success ? 'completed' : 'failed';\n toolStepData.completedAt = new Date().toISOString();\n toolStepData.durationMs = durationMs;\n toolStepData.result = success ? result : undefined;\n toolStepData.error = error;\n\n await addLog(\n success ? 'info' : 'error',\n success\n ? `Tool completed in ${durationMs}ms`\n : `Tool failed: ${error}`,\n toolStepId,\n { type: 'tool_result', durationMs }\n );\n\n return JSON.stringify({\n toolStep: toolStepData,\n success,\n result: success ? result : undefined,\n error,\n });\n });\n\n const toolResultData = JSON.parse(toolResultJson) as {\n toolStep: AgentStep;\n success: boolean;\n result?: unknown;\n error?: string;\n };\n\n steps.push(toolResultData.toolStep);\n\n // Fire-and-forget to avoid extra checkpoint\n updatePlan({ steps: [...steps] }).catch((e) =>\n logger.workflow.error('Plan update failed', { error: e instanceof Error ? e.message : String(e) })\n );\n\n if (toolResultData.success && toolResultData.result) {\n const structured = (toolResultData.result as { structuredContent?: unknown })?.structuredContent;\n if (structured) {\n toolResultsCache[toolUse.name] = structured;\n }\n\n const artifact = this.extractArtifact(toolUse.name, toolResultData.result);\n if (artifact) {\n // Dedupe overlapping URLs, keep the more specific one.\n if (artifact.url) {\n const existingIdx = artifacts.findIndex(\n (a) => a.url && a.type === artifact.type && (a.url.startsWith(artifact.url!) || artifact.url!.startsWith(a.url))\n );\n if (existingIdx !== -1) {\n artifacts[existingIdx] = artifact.url.length >= artifacts[existingIdx].url!.length ? artifact : artifacts[existingIdx];\n } else {\n artifacts.push(artifact);\n }\n } else {\n artifacts.push(artifact);\n }\n }\n }\n\n if (toolResultData.success) {\n toolResults.push({\n type: 'tool_result',\n tool_use_id: toolUse.id,\n content: JSON.stringify(toolResultData.result),\n });\n } else {\n toolResults.push({\n type: 'tool_result',\n tool_use_id: toolUse.id,\n content: `Error: ${toolResultData.error}`,\n is_error: true,\n });\n }\n }\n }\n\n messages.push({ role: 'user', content: toolResults });\n } else if (response.stop_reason === 'end_turn') {\n done = true;\n }\n\n turnIndex++;\n }\n\n const failedSteps = steps.filter((s) => s.status === 'failed');\n const hasFailures = failedSteps.length > 0;\n const hasArtifacts = artifacts.length > 0;\n\n // Check if agent recovered from failures (successful work after the last failure)\n const lastFailedIndex = steps.findLastIndex((s) => s.status === 'failed');\n const recoveredFromFailures =\n hasFailures && steps.slice(lastFailedIndex + 1).some((s) => s.status === 'completed');\n\n // For scheduled runs: success if created tasks, no failures, or recovered from failures\n // For regular runs: success if has artifacts or no failures\n const isSuccess = isScheduledRun\n ? childTasksCreated > 0 || !hasFailures || recoveredFromFailures\n : hasArtifacts || !hasFailures;\n\n await step.do('complete', async () => {\n const stub = getBoardStub();\n\n if (isSuccess) {\n await updatePlan({\n status: 'completed',\n steps: [...steps],\n result: {\n success: true,\n totalTurns: turnIndex,\n artifacts: hasArtifacts ? artifacts : undefined,\n childTasksCreated: isScheduledRun ? childTasksCreated : undefined,\n warnings:\n hasFailures\n ? failedSteps.map((s) => ({ name: s.name, error: s.error }))\n : undefined,\n },\n });\n\n // Update scheduled run record if this is a scheduled run\n if (isScheduledRun && runId) {\n // Include task titles in summary for historical record (even if tasks are deleted later)\n let summary: string;\n if (childTasksCreated > 0) {\n const titlesStr = childTaskTitles.join('\\n- ');\n summary = `Created ${childTasksCreated} task${childTasksCreated === 1 ? '' : 's'}:\\n- ${titlesStr}`;\n } else {\n summary = 'Completed with no new tasks';\n }\n await stub.updateScheduledRun(runId, {\n status: 'completed',\n completedAt: new Date().toISOString(),\n tasksCreated: childTasksCreated,\n summary,\n childTasksInfo,\n });\n }\n\n if (hasFailures) {\n await addLog(\n 'info',\n `Agent completed successfully (${failedSteps.length} intermediate tool error(s) were handled)`\n );\n } else {\n await addLog('info', isScheduledRun\n ? `Scheduled run completed: created ${childTasksCreated} task(s)`\n : 'Agent completed task successfully'\n );\n }\n } else {\n await updatePlan({\n status: 'failed',\n steps: [...steps],\n result: {\n success: false,\n totalTurns: turnIndex,\n error: `${failedSteps.length} tool(s) failed`,\n failedSteps: failedSteps.map((s) => ({ name: s.name, error: s.error })),\n },\n });\n\n // Update scheduled run record if this is a scheduled run\n if (isScheduledRun && runId) {\n await stub.updateScheduledRun(runId, {\n status: 'failed',\n completedAt: new Date().toISOString(),\n tasksCreated: childTasksCreated,\n error: `${failedSteps.length} tool(s) failed`,\n });\n }\n\n await addLog('error', `Agent failed: ${failedSteps.length} tool error(s)`);\n }\n return 'completed';\n });\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.workflow.error('Workflow error', { error: message });\n\n await step.do('handle-error', async () => {\n const stub = getBoardStub();\n await updatePlan({\n status: 'failed',\n result: { success: false, error: message },\n });\n\n // Update scheduled run record if this is a scheduled run\n if (isScheduledRun && runId) {\n await stub.updateScheduledRun(runId, {\n status: 'failed',\n completedAt: new Date().toISOString(),\n error: message,\n });\n }\n\n await addLog('error', `Workflow failed: ${message}`);\n return 'error';\n });\n\n throw error;\n }\n }\n\n /**\n * Build Claude tools from MCP server definitions\n * @param servers - MCP server definitions with their tools\n * @param isScheduledRun - If true, filters out tools marked with disabledInScheduledRuns\n */\n private buildClaudeTools(servers: MCPServerInfo[], isScheduledRun = false): Tool[] {\n const tools: Tool[] = [];\n\n for (const server of servers) {\n for (const tool of server.tools) {\n // Skip tools disabled in scheduled runs (coordination-only mode)\n if (isScheduledRun && tool.disabledInScheduledRuns) {\n continue;\n }\n const inputSchema = tool.inputSchema as Tool['input_schema'];\n if (!inputSchema.type) {\n inputSchema.type = 'object';\n }\n tools.push({\n name: `${server.name.replace(/\\s+/g, '_')}__${tool.name}`,\n description: `[${server.name}] ${tool.description}`,\n input_schema: inputSchema,\n });\n }\n }\n\n // For scheduled runs, only include weft_create_task (not request_approval)\n // For regular runs, only include request_approval (not weft_create_task)\n if (isScheduledRun) {\n // Scheduled run: add weft_create_task instead of request_approval\n tools.push({\n name: 'weft_create_task',\n description:\n 'Fork a new independent agent to handle a subtask. The child task will have its own workflow. IMPORTANT: Keep description SHORT (1-2 sentences) since users see it on the task card. Put detailed instructions in the context field.',\n input_schema: {\n type: 'object',\n properties: {\n title: {\n type: 'string',\n description: 'Short, actionable title (e.g., \"Daily Issue Report - Jan 19\" or \"Review PR #1\")',\n },\n description: {\n type: 'string',\n description: 'Brief 1-2 sentence summary for the user. NO tool names. Example: \"Send email summarizing open issues in repo\"',\n },\n priority: {\n type: 'string',\n enum: ['low', 'medium', 'high'],\n description: 'Task priority (default: medium)',\n },\n context: {\n type: 'object',\n description: 'CRITICAL: Data the child agent needs to do its job. Include ALL specifics so the child does NOT need to re-fetch data. The child will use these values directly in tool calls.',\n properties: {\n action: {\n type: 'string',\n description: 'What the child should do (e.g., \"sendEmail\", \"createPullRequest\", \"reviewAndMerge\")',\n },\n owner: {\n type: 'string',\n description: 'GitHub repository owner (e.g., \"acme-org\") - child will use this directly',\n },\n repo: {\n type: 'string',\n description: 'GitHub repository name (e.g., \"my-project\") - child will use this directly',\n },\n issueUrl: {\n type: 'string',\n description: 'URL of the issue or PR being worked on',\n },\n issues: {\n type: 'array',\n description: 'List of issues/PRs with full details (number, title, state, body, labels, etc.)',\n },\n summary: {\n type: 'string',\n description: 'Your analysis summary - what you found, prioritization, recommendations',\n },\n emailTo: {\n type: 'string',\n description: 'Email recipient address',\n },\n emailSubject: {\n type: 'string',\n description: 'Suggested email subject line',\n },\n emailGuidance: {\n type: 'string',\n description: 'Guidance for email content, tone, what to include',\n },\n },\n },\n startWorkflow: {\n type: 'boolean',\n description: 'Whether to start the child workflow immediately (default: true). Set to false to create the task without starting its agent.',\n },\n },\n required: ['title', 'description'],\n },\n });\n } else {\n // Regular run: add request_approval (not weft_create_task)\n tools.push({\n name: 'request_approval',\n description:\n 'Pause execution and ask user for approval before proceeding. Use this before sending emails, creating documents, or any action that cannot be undone.',\n input_schema: {\n type: 'object',\n properties: {\n tool: {\n type: 'string',\n description: 'The MCP tool that will be called if approved (e.g., \"Google_Docs__createDocument\", \"Gmail__sendMessage\")',\n },\n action: {\n type: 'string',\n description: 'Short human-readable action label (e.g., \"Create Document\", \"Send Email\")',\n },\n data: {\n type: 'object',\n description: 'The exact data that will be passed to the tool (e.g., { title: \"...\", content: \"...\" } for docs)',\n },\n },\n required: ['tool', 'action', 'data'],\n },\n });\n }\n\n return tools;\n }\n\n /**\n * Build system prompt for the agent\n * Uses registry-based workflow guidance for each enabled MCP\n */\n private buildSystemPrompt(\n servers: MCPServerInfo[],\n isScheduledRun = false,\n timeContext?: {\n currentTime?: string;\n lastRunAt?: string;\n scheduleTimezone?: string;\n }\n ): string {\n const toolsList = servers\n .map((s) => `- **${s.name}**: ${s.tools.map((t) => t.name).join(', ')}`)\n .join('\\n');\n\n const serverNames = servers.map(s => s.name.replace(/\\s+/g, '_'));\n const workflowGuidance = getWorkflowGuidance(serverNames);\n\n // Build time context section for scheduled runs\n let timeContextSection = '';\n if (isScheduledRun && timeContext) {\n const currentTimeStr = timeContext.currentTime\n ? new Date(timeContext.currentTime).toLocaleString('en-US', {\n timeZone: timeContext.scheduleTimezone || 'UTC',\n weekday: 'long',\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n hour: 'numeric',\n minute: '2-digit',\n timeZoneName: 'short',\n })\n : 'Unknown';\n\n const lastRunStr = timeContext.lastRunAt\n ? new Date(timeContext.lastRunAt).toLocaleString('en-US', {\n timeZone: timeContext.scheduleTimezone || 'UTC',\n weekday: 'long',\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n hour: 'numeric',\n minute: '2-digit',\n timeZoneName: 'short',\n })\n : null;\n\n timeContextSection = `\n## Time Context\n- **Current time:** ${currentTimeStr}\n- **Last successful run:** ${lastRunStr || 'This is the first run'}\n- **Timezone:** ${timeContext.scheduleTimezone || 'UTC'}\n${timeContext.lastRunAt ? `\n**IMPORTANT:** When looking for \"new\" items (issues, emails, etc.), filter by items created or updated AFTER: ${timeContext.lastRunAt}\n` : `\n**IMPORTANT:** This is the first run of this scheduled task. Consider whether you need to limit results (e.g., only look at recent items, not all-time).\n`}\n`;\n }\n\n const scheduledRunGuidance = isScheduledRun ? `\n## Creating Child Tasks\n\nUse \\`weft_create_task\\` to delegate work. Each child task gets its own agent with full tool access and approval workflows.\n\n**Task fields:**\n- \\`title\\`: Short, actionable (shown on task card)\n- \\`description\\`: 1-2 sentences for the user (NO tool names)\n- \\`context\\`: All data the child needs - owner, repo, issue numbers, your analysis\n\n**Example:**\n\\`\\`\\`javascript\nweft_create_task({\n title: \"Review PR #42\",\n description: \"Review dependency update PR\",\n context: { owner: \"acme\", repo: \"app\", prNumber: 42, action: \"review_and_merge\" }\n})\n\\`\\`\\`\n\n**Important:** Include everything in context so the child doesn't re-fetch what you already found.\n` : '';\n\n // For scheduled runs, use a completely different prompt structure\n if (isScheduledRun) {\n return `You are a scheduled task agent. Analyze the situation using read-only tools, then create child tasks for any work.\n\n**Rules:**\n- DO NOT execute actions directly (no PRs, emails, document edits)\n- ALWAYS use \\`weft_create_task\\` for each piece of work found, even if there's only one item\n- Child tasks have their own agent with full tool access and approval workflows\n${timeContextSection}\n## Available Tools\n${toolsList}\n- **weft_create_task**: Create a child task for work that needs to be done\n${scheduledRunGuidance}\nSummarize what you found and what child tasks you created.`;\n }\n\n // Regular (non-scheduled) runs get the full prompt with approval guidelines\n return `You are a helpful AI assistant that accomplishes tasks using available tools.\n\n## Available Tools\n${toolsList}\n- **request_approval**: Pause and ask user for approval before irreversible actions\n\n## Using Context from Parent Tasks\nIf your task includes a \"## Context from parent task\" section, use that data directly - don't re-fetch what the parent already gathered.\n\n## Guidelines\n- Request approval before sending emails, creating/modifying documents, making commits, or any irreversible action\n- When requesting approval, include a clear description and preview of the content\n- If the approval result contains \\`userData\\`, use those values (the user edited the data)\n- Be concise and handle errors gracefully\n\n${workflowGuidance}\n\nKeep outputs minimal - just the content, no preambles or explanations.`;\n }\n\n /**\n * Get a valid access token for any OAuth account, refreshing if needed\n */\n private async ensureValidToken(\n account: AccountDefinition,\n credentials: CredentialStore\n ): Promise {\n // Build credential keys based on account id (e.g., 'google' -> 'googleToken')\n const tokenKey = `${account.id}Token`;\n const refreshTokenKey = `${account.id}RefreshToken`;\n const expiresAtKey = `${account.id}TokenExpiresAt`;\n\n const accessToken = credentials[tokenKey];\n const refreshToken = credentials[refreshTokenKey];\n const expiresAt = credentials[expiresAtKey];\n\n if (!accessToken) {\n throw new Error(`${account.name} OAuth not configured`);\n }\n\n // Check if token needs refresh\n if (refreshToken && expiresAt && account.refreshToken) {\n const expiresAtMs = new Date(expiresAt).getTime();\n const now = Date.now();\n\n if (now > expiresAtMs - TOKEN_REFRESH_BUFFER_MS) {\n logger.workflow.info('Refreshing expired token', { account: account.name });\n\n // Get client credentials from env using account id pattern\n const clientIdKey = `${account.id.toUpperCase()}_CLIENT_ID` as keyof WorkflowEnv;\n const clientSecretKey = `${account.id.toUpperCase()}_CLIENT_SECRET` as keyof WorkflowEnv;\n const clientId = this.env[clientIdKey] as string | undefined;\n const clientSecret = this.env[clientSecretKey] as string | undefined;\n\n if (!clientId || !clientSecret) {\n throw new Error(`Missing OAuth config for ${account.name}`);\n }\n\n const newTokenData = await account.refreshToken(\n refreshToken,\n clientId,\n clientSecret\n );\n\n credentials[tokenKey] = newTokenData.access_token;\n credentials[expiresAtKey] = new Date(\n Date.now() + (newTokenData.expires_in || 3600) * 1000\n ).toISOString();\n\n logger.workflow.info('Token refreshed successfully', { account: account.name });\n return newTokenData.access_token;\n }\n }\n\n return accessToken;\n }\n\n /**\n * Execute an MCP tool using registry-based dispatch\n */\n private async executeMcpTool(\n toolName: string,\n args: Record,\n credentials: CredentialStore,\n servers: MCPServerInfo[]\n ): Promise {\n const parts = toolName.split('__');\n if (parts.length !== 2) {\n throw new Error(`Invalid tool name format: ${toolName}`);\n }\n\n const [serverName, method] = parts;\n\n const lookup = getMCPByServerName(serverName);\n\n if (lookup) {\n return this.executeHostedMcpTool(lookup, method, args, credentials);\n }\n\n const remoteServer = servers.find(s => {\n const normalized = s.name.replace(/[^a-zA-Z0-9]/g, '_');\n return normalized === serverName;\n });\n\n if (remoteServer && remoteServer.type === 'remote') {\n return this.executeRemoteMcpTool(remoteServer, method, args);\n }\n\n throw new Error(`Unknown MCP server: ${serverName}`);\n }\n\n /**\n * Execute a tool on a hosted MCP server (Gmail, Docs, etc.)\n * Uses registry-driven credential and env binding configuration\n */\n private async executeHostedMcpTool(\n lookup: { account: AccountDefinition; mcp: { factory: (creds: MCPCredentials, env: MCPEnvBindings) => { callTool: (name: string, args: Record) => Promise } } },\n method: string,\n args: Record,\n credentials: CredentialStore\n ): Promise {\n const { account, mcp } = lookup;\n\n const mcpCredentials: MCPCredentials = {};\n\n if (account.authType === 'oauth') {\n const accessToken = await this.ensureValidToken(account, credentials);\n mcpCredentials.accessToken = accessToken;\n }\n\n if (account.additionalCredentialKeys) {\n for (const key of account.additionalCredentialKeys) {\n if (credentials[key]) {\n mcpCredentials[key] = credentials[key];\n }\n }\n }\n\n const envBindings: MCPEnvBindings = {};\n if (account.envBindingKeys) {\n for (const key of account.envBindingKeys) {\n const value = (this.env as Record)[key];\n if (value !== undefined) {\n envBindings[key] = value;\n }\n }\n }\n\n const server = mcp.factory(mcpCredentials, envBindings);\n return await server.callTool(method, args);\n }\n\n /**\n * Execute a tool on a remote MCP server (user-added servers like Cloudflare Docs)\n */\n private async executeRemoteMcpTool(\n server: MCPServerInfo,\n method: string,\n args: Record\n ): Promise {\n if (!server.endpoint) {\n throw new Error(`Remote MCP server ${server.name} has no endpoint configured`);\n }\n\n const config: MCPServerConfig = {\n id: server.id,\n name: server.name,\n type: 'remote',\n endpoint: server.endpoint,\n authType: server.authType as MCPServerConfig['authType'],\n transportType: server.transportType || 'streamable-http',\n };\n\n if (server.authType === 'oauth' && server.accessToken) {\n config.credentials = { token: server.accessToken };\n }\n\n const client = new MCPClient(config);\n\n try {\n await client.initialize();\n const result = await client.callTool(method, args);\n return result;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n throw new Error(`Remote MCP tool call failed: ${message}`);\n }\n }\n\n /**\n * Extract artifact from tool result using registry-based type lookup\n */\n private extractArtifact(toolName: string, result: unknown): WorkflowArtifact | null {\n const structured = (result as { structuredContent?: Record })?.structuredContent;\n if (!structured) return null;\n\n const url = structured.url as string | undefined;\n const title = structured.title as string | undefined;\n const content = structured.content as WorkflowArtifact['content'] | undefined;\n\n const [serverName] = toolName.split('__');\n const lookup = getMCPByServerName(serverName);\n\n if (!lookup?.mcp.artifactType) {\n return url ? { type: 'other', url, title } : null;\n }\n\n if (lookup.mcp.artifactContentType === 'inline') {\n return content ? { type: lookup.mcp.artifactType, title, content } : null;\n }\n\n return url ? { type: lookup.mcp.artifactType, url, title } : null;\n }\n}\n" }, { "path": "worker-configuration.d.ts", "content": "/* eslint-disable */\n// Generated by Wrangler by running `wrangler types` (hash: d320f551ae3092561d41e7d1ed89d621)\n// Runtime types generated with workerd@1.20251210.0 2025-12-10 nodejs_compat_v2\ndeclare namespace Cloudflare {\n\tinterface GlobalProps {\n\t\tmainModule: typeof import(\"./worker/index\");\n\t\tdurableNamespaces: \"BoardDO\" | \"Sandbox\" | \"UserDO\";\n\t}\n\tinterface Env {\n\t\tAUTH_MODE: \"none\" | \"access\";\n\t\tUSER_ID: \"dev-user\";\n\t\tUSER_EMAIL: \"dev@localhost\";\n\t\tGITHUB_CLIENT_ID: string;\n\t\tGITHUB_CLIENT_SECRET: string;\n\t\tGOOGLE_CLIENT_ID: string;\n\t\tGOOGLE_CLIENT_SECRET: string;\n\t\tENCRYPTION_KEY: string;\n\t\tDEV_USER_ID: string;\n\t\tDEV_USER_EMAIL: string;\n\t\tBOARD_DO: DurableObjectNamespace;\n\t\tUSER_DO: DurableObjectNamespace;\n\t\tSANDBOX: DurableObjectNamespace;\n\t\tAGENT_WORKFLOW: Workflow[0]['payload']>;\n\t}\n}\ninterface Env extends Cloudflare.Env {}\n\n// Begin runtime types\n/*! *****************************************************************************\nCopyright (c) Cloudflare. All rights reserved.\nCopyright (c) Microsoft Corporation. All rights reserved.\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use\nthis file except in compliance with the License. You may obtain a copy of the\nLicense at http://www.apache.org/licenses/LICENSE-2.0\nTHIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\nKIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED\nWARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,\nMERCHANTABLITY OR NON-INFRINGEMENT.\nSee the Apache Version 2.0 License for specific language governing permissions\nand limitations under the License.\n***************************************************************************** */\n/* eslint-disable */\n// noinspection JSUnusedGlobalSymbols\ndeclare var onmessage: never;\n/**\n * The **`DOMException`** interface represents an abnormal event (called an **exception**) that occurs as a result of calling a method or accessing a property of a web API.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException)\n */\ndeclare class DOMException extends Error {\n constructor(message?: string, name?: string);\n /**\n * The **`message`** read-only property of the a message or description associated with the given error name.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/message)\n */\n readonly message: string;\n /**\n * The **`name`** read-only property of the one of the strings associated with an error name.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/name)\n */\n readonly name: string;\n /**\n * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or `0` if none match.\n * @deprecated\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/code)\n */\n readonly code: number;\n static readonly INDEX_SIZE_ERR: number;\n static readonly DOMSTRING_SIZE_ERR: number;\n static readonly HIERARCHY_REQUEST_ERR: number;\n static readonly WRONG_DOCUMENT_ERR: number;\n static readonly INVALID_CHARACTER_ERR: number;\n static readonly NO_DATA_ALLOWED_ERR: number;\n static readonly NO_MODIFICATION_ALLOWED_ERR: number;\n static readonly NOT_FOUND_ERR: number;\n static readonly NOT_SUPPORTED_ERR: number;\n static readonly INUSE_ATTRIBUTE_ERR: number;\n static readonly INVALID_STATE_ERR: number;\n static readonly SYNTAX_ERR: number;\n static readonly INVALID_MODIFICATION_ERR: number;\n static readonly NAMESPACE_ERR: number;\n static readonly INVALID_ACCESS_ERR: number;\n static readonly VALIDATION_ERR: number;\n static readonly TYPE_MISMATCH_ERR: number;\n static readonly SECURITY_ERR: number;\n static readonly NETWORK_ERR: number;\n static readonly ABORT_ERR: number;\n static readonly URL_MISMATCH_ERR: number;\n static readonly QUOTA_EXCEEDED_ERR: number;\n static readonly TIMEOUT_ERR: number;\n static readonly INVALID_NODE_TYPE_ERR: number;\n static readonly DATA_CLONE_ERR: number;\n get stack(): any;\n set stack(value: any);\n}\ntype WorkerGlobalScopeEventMap = {\n fetch: FetchEvent;\n scheduled: ScheduledEvent;\n queue: QueueEvent;\n unhandledrejection: PromiseRejectionEvent;\n rejectionhandled: PromiseRejectionEvent;\n};\ndeclare abstract class WorkerGlobalScope extends EventTarget {\n EventTarget: typeof EventTarget;\n}\n/* The **`console`** object provides access to the debugging console (e.g., the Web console in Firefox). *\n * The **`console`** object provides access to the debugging console (e.g., the Web console in Firefox).\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console)\n */\ninterface Console {\n \"assert\"(condition?: boolean, ...data: any[]): void;\n /**\n * The **`console.clear()`** static method clears the console if possible.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/clear_static)\n */\n clear(): void;\n /**\n * The **`console.count()`** static method logs the number of times that this particular call to `count()` has been called.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/count_static)\n */\n count(label?: string): void;\n /**\n * The **`console.countReset()`** static method resets counter used with console/count_static.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/countReset_static)\n */\n countReset(label?: string): void;\n /**\n * The **`console.debug()`** static method outputs a message to the console at the 'debug' log level.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/debug_static)\n */\n debug(...data: any[]): void;\n /**\n * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dir_static)\n */\n dir(item?: any, options?: any): void;\n /**\n * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dirxml_static)\n */\n dirxml(...data: any[]): void;\n /**\n * The **`console.error()`** static method outputs a message to the console at the 'error' log level.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/error_static)\n */\n error(...data: any[]): void;\n /**\n * The **`console.group()`** static method creates a new inline group in the Web console log, causing any subsequent console messages to be indented by an additional level, until console/groupEnd_static is called.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/group_static)\n */\n group(...data: any[]): void;\n /**\n * The **`console.groupCollapsed()`** static method creates a new inline group in the console.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupCollapsed_static)\n */\n groupCollapsed(...data: any[]): void;\n /**\n * The **`console.groupEnd()`** static method exits the current inline group in the console.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupEnd_static)\n */\n groupEnd(): void;\n /**\n * The **`console.info()`** static method outputs a message to the console at the 'info' log level.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/info_static)\n */\n info(...data: any[]): void;\n /**\n * The **`console.log()`** static method outputs a message to the console.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/log_static)\n */\n log(...data: any[]): void;\n /**\n * The **`console.table()`** static method displays tabular data as a table.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/table_static)\n */\n table(tabularData?: any, properties?: string[]): void;\n /**\n * The **`console.time()`** static method starts a timer you can use to track how long an operation takes.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/time_static)\n */\n time(label?: string): void;\n /**\n * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console/time_static.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeEnd_static)\n */\n timeEnd(label?: string): void;\n /**\n * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console/time_static.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeLog_static)\n */\n timeLog(label?: string, ...data: any[]): void;\n timeStamp(label?: string): void;\n /**\n * The **`console.trace()`** static method outputs a stack trace to the console.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/trace_static)\n */\n trace(...data: any[]): void;\n /**\n * The **`console.warn()`** static method outputs a warning message to the console at the 'warning' log level.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/warn_static)\n */\n warn(...data: any[]): void;\n}\ndeclare const console: Console;\ntype BufferSource = ArrayBufferView | ArrayBuffer;\ntype TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array | BigInt64Array | BigUint64Array;\ndeclare namespace WebAssembly {\n class CompileError extends Error {\n constructor(message?: string);\n }\n class RuntimeError extends Error {\n constructor(message?: string);\n }\n type ValueType = \"anyfunc\" | \"externref\" | \"f32\" | \"f64\" | \"i32\" | \"i64\" | \"v128\";\n interface GlobalDescriptor {\n value: ValueType;\n mutable?: boolean;\n }\n class Global {\n constructor(descriptor: GlobalDescriptor, value?: any);\n value: any;\n valueOf(): any;\n }\n type ImportValue = ExportValue | number;\n type ModuleImports = Record;\n type Imports = Record;\n type ExportValue = Function | Global | Memory | Table;\n type Exports = Record;\n class Instance {\n constructor(module: Module, imports?: Imports);\n readonly exports: Exports;\n }\n interface MemoryDescriptor {\n initial: number;\n maximum?: number;\n shared?: boolean;\n }\n class Memory {\n constructor(descriptor: MemoryDescriptor);\n readonly buffer: ArrayBuffer;\n grow(delta: number): number;\n }\n type ImportExportKind = \"function\" | \"global\" | \"memory\" | \"table\";\n interface ModuleExportDescriptor {\n kind: ImportExportKind;\n name: string;\n }\n interface ModuleImportDescriptor {\n kind: ImportExportKind;\n module: string;\n name: string;\n }\n abstract class Module {\n static customSections(module: Module, sectionName: string): ArrayBuffer[];\n static exports(module: Module): ModuleExportDescriptor[];\n static imports(module: Module): ModuleImportDescriptor[];\n }\n type TableKind = \"anyfunc\" | \"externref\";\n interface TableDescriptor {\n element: TableKind;\n initial: number;\n maximum?: number;\n }\n class Table {\n constructor(descriptor: TableDescriptor, value?: any);\n readonly length: number;\n get(index: number): any;\n grow(delta: number, value?: any): number;\n set(index: number, value?: any): void;\n }\n function instantiate(module: Module, imports?: Imports): Promise;\n function validate(bytes: BufferSource): boolean;\n}\n/**\n * The **`ServiceWorkerGlobalScope`** interface of the Service Worker API represents the global execution context of a service worker.\n * Available only in secure contexts.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerGlobalScope)\n */\ninterface ServiceWorkerGlobalScope extends WorkerGlobalScope {\n DOMException: typeof DOMException;\n WorkerGlobalScope: typeof WorkerGlobalScope;\n btoa(data: string): string;\n atob(data: string): string;\n setTimeout(callback: (...args: any[]) => void, msDelay?: number): number;\n setTimeout(callback: (...args: Args) => void, msDelay?: number, ...args: Args): number;\n clearTimeout(timeoutId: number | null): void;\n setInterval(callback: (...args: any[]) => void, msDelay?: number): number;\n setInterval(callback: (...args: Args) => void, msDelay?: number, ...args: Args): number;\n clearInterval(timeoutId: number | null): void;\n queueMicrotask(task: Function): void;\n structuredClone(value: T, options?: StructuredSerializeOptions): T;\n reportError(error: any): void;\n fetch(input: RequestInfo | URL, init?: RequestInit): Promise;\n self: ServiceWorkerGlobalScope;\n crypto: Crypto;\n caches: CacheStorage;\n scheduler: Scheduler;\n performance: Performance;\n Cloudflare: Cloudflare;\n readonly origin: string;\n Event: typeof Event;\n ExtendableEvent: typeof ExtendableEvent;\n CustomEvent: typeof CustomEvent;\n PromiseRejectionEvent: typeof PromiseRejectionEvent;\n FetchEvent: typeof FetchEvent;\n TailEvent: typeof TailEvent;\n TraceEvent: typeof TailEvent;\n ScheduledEvent: typeof ScheduledEvent;\n MessageEvent: typeof MessageEvent;\n CloseEvent: typeof CloseEvent;\n ReadableStreamDefaultReader: typeof ReadableStreamDefaultReader;\n ReadableStreamBYOBReader: typeof ReadableStreamBYOBReader;\n ReadableStream: typeof ReadableStream;\n WritableStream: typeof WritableStream;\n WritableStreamDefaultWriter: typeof WritableStreamDefaultWriter;\n TransformStream: typeof TransformStream;\n ByteLengthQueuingStrategy: typeof ByteLengthQueuingStrategy;\n CountQueuingStrategy: typeof CountQueuingStrategy;\n ErrorEvent: typeof ErrorEvent;\n MessageChannel: typeof MessageChannel;\n MessagePort: typeof MessagePort;\n EventSource: typeof EventSource;\n ReadableStreamBYOBRequest: typeof ReadableStreamBYOBRequest;\n ReadableStreamDefaultController: typeof ReadableStreamDefaultController;\n ReadableByteStreamController: typeof ReadableByteStreamController;\n WritableStreamDefaultController: typeof WritableStreamDefaultController;\n TransformStreamDefaultController: typeof TransformStreamDefaultController;\n CompressionStream: typeof CompressionStream;\n DecompressionStream: typeof DecompressionStream;\n TextEncoderStream: typeof TextEncoderStream;\n TextDecoderStream: typeof TextDecoderStream;\n Headers: typeof Headers;\n Body: typeof Body;\n Request: typeof Request;\n Response: typeof Response;\n WebSocket: typeof WebSocket;\n WebSocketPair: typeof WebSocketPair;\n WebSocketRequestResponsePair: typeof WebSocketRequestResponsePair;\n AbortController: typeof AbortController;\n AbortSignal: typeof AbortSignal;\n TextDecoder: typeof TextDecoder;\n TextEncoder: typeof TextEncoder;\n navigator: Navigator;\n Navigator: typeof Navigator;\n URL: typeof URL;\n URLSearchParams: typeof URLSearchParams;\n URLPattern: typeof URLPattern;\n Blob: typeof Blob;\n File: typeof File;\n FormData: typeof FormData;\n Crypto: typeof Crypto;\n SubtleCrypto: typeof SubtleCrypto;\n CryptoKey: typeof CryptoKey;\n CacheStorage: typeof CacheStorage;\n Cache: typeof Cache;\n FixedLengthStream: typeof FixedLengthStream;\n IdentityTransformStream: typeof IdentityTransformStream;\n HTMLRewriter: typeof HTMLRewriter;\n}\ndeclare function addEventListener(type: Type, handler: EventListenerOrEventListenerObject, options?: EventTargetAddEventListenerOptions | boolean): void;\ndeclare function removeEventListener(type: Type, handler: EventListenerOrEventListenerObject, options?: EventTargetEventListenerOptions | boolean): void;\n/**\n * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)\n */\ndeclare function dispatchEvent(event: WorkerGlobalScopeEventMap[keyof WorkerGlobalScopeEventMap]): boolean;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/btoa) */\ndeclare function btoa(data: string): string;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/atob) */\ndeclare function atob(data: string): string;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/setTimeout) */\ndeclare function setTimeout(callback: (...args: any[]) => void, msDelay?: number): number;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/setTimeout) */\ndeclare function setTimeout(callback: (...args: Args) => void, msDelay?: number, ...args: Args): number;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/clearTimeout) */\ndeclare function clearTimeout(timeoutId: number | null): void;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/setInterval) */\ndeclare function setInterval(callback: (...args: any[]) => void, msDelay?: number): number;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/setInterval) */\ndeclare function setInterval(callback: (...args: Args) => void, msDelay?: number, ...args: Args): number;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/clearInterval) */\ndeclare function clearInterval(timeoutId: number | null): void;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/queueMicrotask) */\ndeclare function queueMicrotask(task: Function): void;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/structuredClone) */\ndeclare function structuredClone(value: T, options?: StructuredSerializeOptions): T;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/reportError) */\ndeclare function reportError(error: any): void;\n/* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/fetch) */\ndeclare function fetch(input: RequestInfo | URL, init?: RequestInit): Promise;\ndeclare const self: ServiceWorkerGlobalScope;\n/**\n* The Web Crypto API provides a set of low-level functions for common cryptographic tasks.\n* The Workers runtime implements the full surface of this API, but with some differences in\n* the [supported algorithms](https://developers.cloudflare.com/workers/runtime-apis/web-crypto/#supported-algorithms)\n* compared to those implemented in most browsers.\n*\n* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/web-crypto/)\n*/\ndeclare const crypto: Crypto;\n/**\n* The Cache API allows fine grained control of reading and writing from the Cloudflare global network cache.\n*\n* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/cache/)\n*/\ndeclare const caches: CacheStorage;\ndeclare const scheduler: Scheduler;\n/**\n* The Workers runtime supports a subset of the Performance API, used to measure timing and performance,\n* as well as timing of subrequests and other operations.\n*\n* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/)\n*/\ndeclare const performance: Performance;\ndeclare const Cloudflare: Cloudflare;\ndeclare const origin: string;\ndeclare const navigator: Navigator;\ninterface TestController {\n}\ninterface ExecutionContext {\n waitUntil(promise: Promise): void;\n passThroughOnException(): void;\n readonly exports: Cloudflare.Exports;\n readonly props: Props;\n}\ntype ExportedHandlerFetchHandler = (request: Request>, env: Env, ctx: ExecutionContext) => Response | Promise;\ntype ExportedHandlerTailHandler = (events: TraceItem[], env: Env, ctx: ExecutionContext) => void | Promise;\ntype ExportedHandlerTraceHandler = (traces: TraceItem[], env: Env, ctx: ExecutionContext) => void | Promise;\ntype ExportedHandlerTailStreamHandler = (event: TailStream.TailEvent, env: Env, ctx: ExecutionContext) => TailStream.TailEventHandlerType | Promise;\ntype ExportedHandlerScheduledHandler = (controller: ScheduledController, env: Env, ctx: ExecutionContext) => void | Promise;\ntype ExportedHandlerQueueHandler = (batch: MessageBatch, env: Env, ctx: ExecutionContext) => void | Promise;\ntype ExportedHandlerTestHandler = (controller: TestController, env: Env, ctx: ExecutionContext) => void | Promise;\ninterface ExportedHandler {\n fetch?: ExportedHandlerFetchHandler;\n tail?: ExportedHandlerTailHandler;\n trace?: ExportedHandlerTraceHandler;\n tailStream?: ExportedHandlerTailStreamHandler;\n scheduled?: ExportedHandlerScheduledHandler;\n test?: ExportedHandlerTestHandler;\n email?: EmailExportedHandler;\n queue?: ExportedHandlerQueueHandler;\n}\ninterface StructuredSerializeOptions {\n transfer?: any[];\n}\ndeclare abstract class Navigator {\n sendBeacon(url: string, body?: BodyInit): boolean;\n readonly userAgent: string;\n readonly hardwareConcurrency: number;\n readonly language: string;\n readonly languages: string[];\n}\ninterface AlarmInvocationInfo {\n readonly isRetry: boolean;\n readonly retryCount: number;\n}\ninterface Cloudflare {\n readonly compatibilityFlags: Record;\n}\ninterface DurableObject {\n fetch(request: Request): Response | Promise;\n alarm?(alarmInfo?: AlarmInvocationInfo): void | Promise;\n webSocketMessage?(ws: WebSocket, message: string | ArrayBuffer): void | Promise;\n webSocketClose?(ws: WebSocket, code: number, reason: string, wasClean: boolean): void | Promise;\n webSocketError?(ws: WebSocket, error: unknown): void | Promise;\n}\ntype DurableObjectStub = Fetcher & {\n readonly id: DurableObjectId;\n readonly name?: string;\n};\ninterface DurableObjectId {\n toString(): string;\n equals(other: DurableObjectId): boolean;\n readonly name?: string;\n}\ndeclare abstract class DurableObjectNamespace {\n newUniqueId(options?: DurableObjectNamespaceNewUniqueIdOptions): DurableObjectId;\n idFromName(name: string): DurableObjectId;\n idFromString(id: string): DurableObjectId;\n get(id: DurableObjectId, options?: DurableObjectNamespaceGetDurableObjectOptions): DurableObjectStub;\n getByName(name: string, options?: DurableObjectNamespaceGetDurableObjectOptions): DurableObjectStub;\n jurisdiction(jurisdiction: DurableObjectJurisdiction): DurableObjectNamespace;\n}\ntype DurableObjectJurisdiction = \"eu\" | \"fedramp\" | \"fedramp-high\";\ninterface DurableObjectNamespaceNewUniqueIdOptions {\n jurisdiction?: DurableObjectJurisdiction;\n}\ntype DurableObjectLocationHint = \"wnam\" | \"enam\" | \"sam\" | \"weur\" | \"eeur\" | \"apac\" | \"oc\" | \"afr\" | \"me\";\ninterface DurableObjectNamespaceGetDurableObjectOptions {\n locationHint?: DurableObjectLocationHint;\n}\ninterface DurableObjectClass<_T extends Rpc.DurableObjectBranded | undefined = undefined> {\n}\ninterface DurableObjectState {\n waitUntil(promise: Promise): void;\n readonly exports: Cloudflare.Exports;\n readonly props: Props;\n readonly id: DurableObjectId;\n readonly storage: DurableObjectStorage;\n container?: Container;\n blockConcurrencyWhile(callback: () => Promise): Promise;\n acceptWebSocket(ws: WebSocket, tags?: string[]): void;\n getWebSockets(tag?: string): WebSocket[];\n setWebSocketAutoResponse(maybeReqResp?: WebSocketRequestResponsePair): void;\n getWebSocketAutoResponse(): WebSocketRequestResponsePair | null;\n getWebSocketAutoResponseTimestamp(ws: WebSocket): Date | null;\n setHibernatableWebSocketEventTimeout(timeoutMs?: number): void;\n getHibernatableWebSocketEventTimeout(): number | null;\n getTags(ws: WebSocket): string[];\n abort(reason?: string): void;\n}\ninterface DurableObjectTransaction {\n get(key: string, options?: DurableObjectGetOptions): Promise;\n get(keys: string[], options?: DurableObjectGetOptions): Promise>;\n list(options?: DurableObjectListOptions): Promise>;\n put(key: string, value: T, options?: DurableObjectPutOptions): Promise;\n put(entries: Record, options?: DurableObjectPutOptions): Promise;\n delete(key: string, options?: DurableObjectPutOptions): Promise;\n delete(keys: string[], options?: DurableObjectPutOptions): Promise;\n rollback(): void;\n getAlarm(options?: DurableObjectGetAlarmOptions): Promise;\n setAlarm(scheduledTime: number | Date, options?: DurableObjectSetAlarmOptions): Promise;\n deleteAlarm(options?: DurableObjectSetAlarmOptions): Promise;\n}\ninterface DurableObjectStorage {\n get(key: string, options?: DurableObjectGetOptions): Promise;\n get(keys: string[], options?: DurableObjectGetOptions): Promise>;\n list(options?: DurableObjectListOptions): Promise>;\n put(key: string, value: T, options?: DurableObjectPutOptions): Promise;\n put(entries: Record, options?: DurableObjectPutOptions): Promise;\n delete(key: string, options?: DurableObjectPutOptions): Promise;\n delete(keys: string[], options?: DurableObjectPutOptions): Promise;\n deleteAll(options?: DurableObjectPutOptions): Promise;\n transaction(closure: (txn: DurableObjectTransaction) => Promise): Promise;\n getAlarm(options?: DurableObjectGetAlarmOptions): Promise;\n setAlarm(scheduledTime: number | Date, options?: DurableObjectSetAlarmOptions): Promise;\n deleteAlarm(options?: DurableObjectSetAlarmOptions): Promise;\n sync(): Promise;\n sql: SqlStorage;\n kv: SyncKvStorage;\n transactionSync(closure: () => T): T;\n getCurrentBookmark(): Promise;\n getBookmarkForTime(timestamp: number | Date): Promise;\n onNextSessionRestoreBookmark(bookmark: string): Promise;\n}\ninterface DurableObjectListOptions {\n start?: string;\n startAfter?: string;\n end?: string;\n prefix?: string;\n reverse?: boolean;\n limit?: number;\n allowConcurrency?: boolean;\n noCache?: boolean;\n}\ninterface DurableObjectGetOptions {\n allowConcurrency?: boolean;\n noCache?: boolean;\n}\ninterface DurableObjectGetAlarmOptions {\n allowConcurrency?: boolean;\n}\ninterface DurableObjectPutOptions {\n allowConcurrency?: boolean;\n allowUnconfirmed?: boolean;\n noCache?: boolean;\n}\ninterface DurableObjectSetAlarmOptions {\n allowConcurrency?: boolean;\n allowUnconfirmed?: boolean;\n}\ndeclare class WebSocketRequestResponsePair {\n constructor(request: string, response: string);\n get request(): string;\n get response(): string;\n}\ninterface AnalyticsEngineDataset {\n writeDataPoint(event?: AnalyticsEngineDataPoint): void;\n}\ninterface AnalyticsEngineDataPoint {\n indexes?: ((ArrayBuffer | string) | null)[];\n doubles?: number[];\n blobs?: ((ArrayBuffer | string) | null)[];\n}\n/**\n * The **`Event`** interface represents an event which takes place on an `EventTarget`.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event)\n */\ndeclare class Event {\n constructor(type: string, init?: EventInit);\n /**\n * The **`type`** read-only property of the Event interface returns a string containing the event's type.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type)\n */\n get type(): string;\n /**\n * The **`eventPhase`** read-only property of the being evaluated.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/eventPhase)\n */\n get eventPhase(): number;\n /**\n * The read-only **`composed`** property of the or not the event will propagate across the shadow DOM boundary into the standard DOM.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composed)\n */\n get composed(): boolean;\n /**\n * The **`bubbles`** read-only property of the Event interface indicates whether the event bubbles up through the DOM tree or not.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/bubbles)\n */\n get bubbles(): boolean;\n /**\n * The **`cancelable`** read-only property of the Event interface indicates whether the event can be canceled, and therefore prevented as if the event never happened.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelable)\n */\n get cancelable(): boolean;\n /**\n * The **`defaultPrevented`** read-only property of the Event interface returns a boolean value indicating whether or not the call to Event.preventDefault() canceled the event.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/defaultPrevented)\n */\n get defaultPrevented(): boolean;\n /**\n * The Event property **`returnValue`** indicates whether the default action for this event has been prevented or not.\n * @deprecated\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/returnValue)\n */\n get returnValue(): boolean;\n /**\n * The **`currentTarget`** read-only property of the Event interface identifies the element to which the event handler has been attached.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/currentTarget)\n */\n get currentTarget(): EventTarget | undefined;\n /**\n * The read-only **`target`** property of the dispatched.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target)\n */\n get target(): EventTarget | undefined;\n /**\n * The deprecated **`Event.srcElement`** is an alias for the Event.target property.\n * @deprecated\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement)\n */\n get srcElement(): EventTarget | undefined;\n /**\n * The **`timeStamp`** read-only property of the Event interface returns the time (in milliseconds) at which the event was created.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/timeStamp)\n */\n get timeStamp(): number;\n /**\n * The **`isTrusted`** read-only property of the when the event was generated by the user agent (including via user actions and programmatic methods such as HTMLElement.focus()), and `false` when the event was dispatched via The only exception is the `click` event, which initializes the `isTrusted` property to `false` in user agents.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted)\n */\n get isTrusted(): boolean;\n /**\n * The **`cancelBubble`** property of the Event interface is deprecated.\n * @deprecated\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)\n */\n get cancelBubble(): boolean;\n /**\n * The **`cancelBubble`** property of the Event interface is deprecated.\n * @deprecated\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)\n */\n set cancelBubble(value: boolean);\n /**\n * The **`stopImmediatePropagation()`** method of the If several listeners are attached to the same element for the same event type, they are called in the order in which they were added.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopImmediatePropagation)\n */\n stopImmediatePropagation(): void;\n /**\n * The **`preventDefault()`** method of the Event interface tells the user agent that if the event does not get explicitly handled, its default action should not be taken as it normally would be.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/preventDefault)\n */\n preventDefault(): void;\n /**\n * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation)\n */\n stopPropagation(): void;\n /**\n * The **`composedPath()`** method of the Event interface returns the event's path which is an array of the objects on which listeners will be invoked.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath)\n */\n composedPath(): EventTarget[];\n static readonly NONE: number;\n static readonly CAPTURING_PHASE: number;\n static readonly AT_TARGET: number;\n static readonly BUBBLING_PHASE: number;\n}\ninterface EventInit {\n bubbles?: boolean;\n cancelable?: boolean;\n composed?: boolean;\n}\ntype EventListener = (event: EventType) => void;\ninterface EventListenerObject {\n handleEvent(event: EventType): void;\n}\ntype EventListenerOrEventListenerObject = EventListener | EventListenerObject;\n/**\n * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget)\n */\ndeclare class EventTarget = Record> {\n constructor();\n /**\n * The **`addEventListener()`** method of the EventTarget interface sets up a function that will be called whenever the specified event is delivered to the target.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/addEventListener)\n */\n addEventListener(type: Type, handler: EventListenerOrEventListenerObject, options?: EventTargetAddEventListenerOptions | boolean): void;\n /**\n * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener)\n */\n removeEventListener(type: Type, handler: EventListenerOrEventListenerObject, options?: EventTargetEventListenerOptions | boolean): void;\n /**\n * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)\n */\n dispatchEvent(event: EventMap[keyof EventMap]): boolean;\n}\ninterface EventTargetEventListenerOptions {\n capture?: boolean;\n}\ninterface EventTargetAddEventListenerOptions {\n capture?: boolean;\n passive?: boolean;\n once?: boolean;\n signal?: AbortSignal;\n}\ninterface EventTargetHandlerObject {\n handleEvent: (event: Event) => any | undefined;\n}\n/**\n * The **`AbortController`** interface represents a controller object that allows you to abort one or more Web requests as and when desired.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController)\n */\ndeclare class AbortController {\n constructor();\n /**\n * The **`signal`** read-only property of the AbortController interface returns an AbortSignal object instance, which can be used to communicate with/abort an asynchronous operation as desired.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/signal)\n */\n get signal(): AbortSignal;\n /**\n * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort)\n */\n abort(reason?: any): void;\n}\n/**\n * The **`AbortSignal`** interface represents a signal object that allows you to communicate with an asynchronous operation (such as a fetch request) and abort it if required via an AbortController object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal)\n */\ndeclare abstract class AbortSignal extends EventTarget {\n /**\n * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an AbortSignal/abort_event event).\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static)\n */\n static abort(reason?: any): AbortSignal;\n /**\n * The **`AbortSignal.timeout()`** static method returns an AbortSignal that will automatically abort after a specified time.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/timeout_static)\n */\n static timeout(delay: number): AbortSignal;\n /**\n * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static)\n */\n static any(signals: AbortSignal[]): AbortSignal;\n /**\n * The **`aborted`** read-only property returns a value that indicates whether the asynchronous operations the signal is communicating with are aborted (`true`) or not (`false`).\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/aborted)\n */\n get aborted(): boolean;\n /**\n * The **`reason`** read-only property returns a JavaScript value that indicates the abort reason.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/reason)\n */\n get reason(): any;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_event) */\n get onabort(): any | null;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_event) */\n set onabort(value: any | null);\n /**\n * The **`throwIfAborted()`** method throws the signal's abort AbortSignal.reason if the signal has been aborted; otherwise it does nothing.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted)\n */\n throwIfAborted(): void;\n}\ninterface Scheduler {\n wait(delay: number, maybeOptions?: SchedulerWaitOptions): Promise;\n}\ninterface SchedulerWaitOptions {\n signal?: AbortSignal;\n}\n/**\n * The **`ExtendableEvent`** interface extends the lifetime of the `install` and `activate` events dispatched on the global scope as part of the service worker lifecycle.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent)\n */\ndeclare abstract class ExtendableEvent extends Event {\n /**\n * The **`ExtendableEvent.waitUntil()`** method tells the event dispatcher that work is ongoing.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent/waitUntil)\n */\n waitUntil(promise: Promise): void;\n}\n/**\n * The **`CustomEvent`** interface represents events initialized by an application for any purpose.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent)\n */\ndeclare class CustomEvent extends Event {\n constructor(type: string, init?: CustomEventCustomEventInit);\n /**\n * The read-only **`detail`** property of the CustomEvent interface returns any data passed when initializing the event.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent/detail)\n */\n get detail(): T;\n}\ninterface CustomEventCustomEventInit {\n bubbles?: boolean;\n cancelable?: boolean;\n composed?: boolean;\n detail?: any;\n}\n/**\n * The **`Blob`** interface represents a blob, which is a file-like object of immutable, raw data; they can be read as text or binary data, or converted into a ReadableStream so its methods can be used for processing the data.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob)\n */\ndeclare class Blob {\n constructor(type?: ((ArrayBuffer | ArrayBufferView) | string | Blob)[], options?: BlobOptions);\n /**\n * The **`size`** read-only property of the Blob interface returns the size of the Blob or File in bytes.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/size)\n */\n get size(): number;\n /**\n * The **`type`** read-only property of the Blob interface returns the MIME type of the file.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/type)\n */\n get type(): string;\n /**\n * The **`slice()`** method of the Blob interface creates and returns a new `Blob` object which contains data from a subset of the blob on which it's called.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice)\n */\n slice(start?: number, end?: number, type?: string): Blob;\n /**\n * The **`arrayBuffer()`** method of the Blob interface returns a Promise that resolves with the contents of the blob as binary data contained in an ArrayBuffer.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/arrayBuffer)\n */\n arrayBuffer(): Promise;\n /**\n * The **`bytes()`** method of the Blob interface returns a Promise that resolves with a Uint8Array containing the contents of the blob as an array of bytes.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/bytes)\n */\n bytes(): Promise;\n /**\n * The **`text()`** method of the string containing the contents of the blob, interpreted as UTF-8.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text)\n */\n text(): Promise;\n /**\n * The **`stream()`** method of the Blob interface returns a ReadableStream which upon reading returns the data contained within the `Blob`.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/stream)\n */\n stream(): ReadableStream;\n}\ninterface BlobOptions {\n type?: string;\n}\n/**\n * The **`File`** interface provides information about files and allows JavaScript in a web page to access their content.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File)\n */\ndeclare class File extends Blob {\n constructor(bits: ((ArrayBuffer | ArrayBufferView) | string | Blob)[] | undefined, name: string, options?: FileOptions);\n /**\n * The **`name`** read-only property of the File interface returns the name of the file represented by a File object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name)\n */\n get name(): string;\n /**\n * The **`lastModified`** read-only property of the File interface provides the last modified date of the file as the number of milliseconds since the Unix epoch (January 1, 1970 at midnight).\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified)\n */\n get lastModified(): number;\n}\ninterface FileOptions {\n type?: string;\n lastModified?: number;\n}\n/**\n* The Cache API allows fine grained control of reading and writing from the Cloudflare global network cache.\n*\n* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/cache/)\n*/\ndeclare abstract class CacheStorage {\n /**\n * The **`open()`** method of the the Cache object matching the `cacheName`.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/open)\n */\n open(cacheName: string): Promise;\n readonly default: Cache;\n}\n/**\n* The Cache API allows fine grained control of reading and writing from the Cloudflare global network cache.\n*\n* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/cache/)\n*/\ndeclare abstract class Cache {\n /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/cache/#delete) */\n delete(request: RequestInfo | URL, options?: CacheQueryOptions): Promise;\n /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/cache/#match) */\n match(request: RequestInfo | URL, options?: CacheQueryOptions): Promise;\n /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/cache/#put) */\n put(request: RequestInfo | URL, response: Response): Promise;\n}\ninterface CacheQueryOptions {\n ignoreMethod?: boolean;\n}\n/**\n* The Web Crypto API provides a set of low-level functions for common cryptographic tasks.\n* The Workers runtime implements the full surface of this API, but with some differences in\n* the [supported algorithms](https://developers.cloudflare.com/workers/runtime-apis/web-crypto/#supported-algorithms)\n* compared to those implemented in most browsers.\n*\n* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/web-crypto/)\n*/\ndeclare abstract class Crypto {\n /**\n * The **`Crypto.subtle`** read-only property returns a cryptographic operations.\n * Available only in secure contexts.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/subtle)\n */\n get subtle(): SubtleCrypto;\n /**\n * The **`Crypto.getRandomValues()`** method lets you get cryptographically strong random values.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/getRandomValues)\n */\n getRandomValues(buffer: T): T;\n /**\n * The **`randomUUID()`** method of the Crypto interface is used to generate a v4 UUID using a cryptographically secure random number generator.\n * Available only in secure contexts.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/randomUUID)\n */\n randomUUID(): string;\n DigestStream: typeof DigestStream;\n}\n/**\n * The **`SubtleCrypto`** interface of the Web Crypto API provides a number of low-level cryptographic functions.\n * Available only in secure contexts.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto)\n */\ndeclare abstract class SubtleCrypto {\n /**\n * The **`encrypt()`** method of the SubtleCrypto interface encrypts data.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/encrypt)\n */\n encrypt(algorithm: string | SubtleCryptoEncryptAlgorithm, key: CryptoKey, plainText: ArrayBuffer | ArrayBufferView): Promise;\n /**\n * The **`decrypt()`** method of the SubtleCrypto interface decrypts some encrypted data.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/decrypt)\n */\n decrypt(algorithm: string | SubtleCryptoEncryptAlgorithm, key: CryptoKey, cipherText: ArrayBuffer | ArrayBufferView): Promise;\n /**\n * The **`sign()`** method of the SubtleCrypto interface generates a digital signature.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/sign)\n */\n sign(algorithm: string | SubtleCryptoSignAlgorithm, key: CryptoKey, data: ArrayBuffer | ArrayBufferView): Promise;\n /**\n * The **`verify()`** method of the SubtleCrypto interface verifies a digital signature.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/verify)\n */\n verify(algorithm: string | SubtleCryptoSignAlgorithm, key: CryptoKey, signature: ArrayBuffer | ArrayBufferView, data: ArrayBuffer | ArrayBufferView): Promise;\n /**\n * The **`digest()`** method of the SubtleCrypto interface generates a _digest_ of the given data, using the specified hash function.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/digest)\n */\n digest(algorithm: string | SubtleCryptoHashAlgorithm, data: ArrayBuffer | ArrayBufferView): Promise;\n /**\n * The **`generateKey()`** method of the SubtleCrypto interface is used to generate a new key (for symmetric algorithms) or key pair (for public-key algorithms).\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/generateKey)\n */\n generateKey(algorithm: string | SubtleCryptoGenerateKeyAlgorithm, extractable: boolean, keyUsages: string[]): Promise;\n /**\n * The **`deriveKey()`** method of the SubtleCrypto interface can be used to derive a secret key from a master key.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveKey)\n */\n deriveKey(algorithm: string | SubtleCryptoDeriveKeyAlgorithm, baseKey: CryptoKey, derivedKeyAlgorithm: string | SubtleCryptoImportKeyAlgorithm, extractable: boolean, keyUsages: string[]): Promise;\n /**\n * The **`deriveBits()`** method of the key.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveBits)\n */\n deriveBits(algorithm: string | SubtleCryptoDeriveKeyAlgorithm, baseKey: CryptoKey, length?: number | null): Promise;\n /**\n * The **`importKey()`** method of the SubtleCrypto interface imports a key: that is, it takes as input a key in an external, portable format and gives you a CryptoKey object that you can use in the Web Crypto API.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/importKey)\n */\n importKey(format: string, keyData: (ArrayBuffer | ArrayBufferView) | JsonWebKey, algorithm: string | SubtleCryptoImportKeyAlgorithm, extractable: boolean, keyUsages: string[]): Promise;\n /**\n * The **`exportKey()`** method of the SubtleCrypto interface exports a key: that is, it takes as input a CryptoKey object and gives you the key in an external, portable format.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/exportKey)\n */\n exportKey(format: string, key: CryptoKey): Promise;\n /**\n * The **`wrapKey()`** method of the SubtleCrypto interface 'wraps' a key.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/wrapKey)\n */\n wrapKey(format: string, key: CryptoKey, wrappingKey: CryptoKey, wrapAlgorithm: string | SubtleCryptoEncryptAlgorithm): Promise;\n /**\n * The **`unwrapKey()`** method of the SubtleCrypto interface 'unwraps' a key.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey)\n */\n unwrapKey(format: string, wrappedKey: ArrayBuffer | ArrayBufferView, unwrappingKey: CryptoKey, unwrapAlgorithm: string | SubtleCryptoEncryptAlgorithm, unwrappedKeyAlgorithm: string | SubtleCryptoImportKeyAlgorithm, extractable: boolean, keyUsages: string[]): Promise;\n timingSafeEqual(a: ArrayBuffer | ArrayBufferView, b: ArrayBuffer | ArrayBufferView): boolean;\n}\n/**\n * The **`CryptoKey`** interface of the Web Crypto API represents a cryptographic key obtained from one of the SubtleCrypto methods SubtleCrypto.generateKey, SubtleCrypto.deriveKey, SubtleCrypto.importKey, or SubtleCrypto.unwrapKey.\n * Available only in secure contexts.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey)\n */\ndeclare abstract class CryptoKey {\n /**\n * The read-only **`type`** property of the CryptoKey interface indicates which kind of key is represented by the object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/type)\n */\n readonly type: string;\n /**\n * The read-only **`extractable`** property of the CryptoKey interface indicates whether or not the key may be extracted using `SubtleCrypto.exportKey()` or `SubtleCrypto.wrapKey()`.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/extractable)\n */\n readonly extractable: boolean;\n /**\n * The read-only **`algorithm`** property of the CryptoKey interface returns an object describing the algorithm for which this key can be used, and any associated extra parameters.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/algorithm)\n */\n readonly algorithm: CryptoKeyKeyAlgorithm | CryptoKeyAesKeyAlgorithm | CryptoKeyHmacKeyAlgorithm | CryptoKeyRsaKeyAlgorithm | CryptoKeyEllipticKeyAlgorithm | CryptoKeyArbitraryKeyAlgorithm;\n /**\n * The read-only **`usages`** property of the CryptoKey interface indicates what can be done with the key.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/usages)\n */\n readonly usages: string[];\n}\ninterface CryptoKeyPair {\n publicKey: CryptoKey;\n privateKey: CryptoKey;\n}\ninterface JsonWebKey {\n kty: string;\n use?: string;\n key_ops?: string[];\n alg?: string;\n ext?: boolean;\n crv?: string;\n x?: string;\n y?: string;\n d?: string;\n n?: string;\n e?: string;\n p?: string;\n q?: string;\n dp?: string;\n dq?: string;\n qi?: string;\n oth?: RsaOtherPrimesInfo[];\n k?: string;\n}\ninterface RsaOtherPrimesInfo {\n r?: string;\n d?: string;\n t?: string;\n}\ninterface SubtleCryptoDeriveKeyAlgorithm {\n name: string;\n salt?: (ArrayBuffer | ArrayBufferView);\n iterations?: number;\n hash?: (string | SubtleCryptoHashAlgorithm);\n $public?: CryptoKey;\n info?: (ArrayBuffer | ArrayBufferView);\n}\ninterface SubtleCryptoEncryptAlgorithm {\n name: string;\n iv?: (ArrayBuffer | ArrayBufferView);\n additionalData?: (ArrayBuffer | ArrayBufferView);\n tagLength?: number;\n counter?: (ArrayBuffer | ArrayBufferView);\n length?: number;\n label?: (ArrayBuffer | ArrayBufferView);\n}\ninterface SubtleCryptoGenerateKeyAlgorithm {\n name: string;\n hash?: (string | SubtleCryptoHashAlgorithm);\n modulusLength?: number;\n publicExponent?: (ArrayBuffer | ArrayBufferView);\n length?: number;\n namedCurve?: string;\n}\ninterface SubtleCryptoHashAlgorithm {\n name: string;\n}\ninterface SubtleCryptoImportKeyAlgorithm {\n name: string;\n hash?: (string | SubtleCryptoHashAlgorithm);\n length?: number;\n namedCurve?: string;\n compressed?: boolean;\n}\ninterface SubtleCryptoSignAlgorithm {\n name: string;\n hash?: (string | SubtleCryptoHashAlgorithm);\n dataLength?: number;\n saltLength?: number;\n}\ninterface CryptoKeyKeyAlgorithm {\n name: string;\n}\ninterface CryptoKeyAesKeyAlgorithm {\n name: string;\n length: number;\n}\ninterface CryptoKeyHmacKeyAlgorithm {\n name: string;\n hash: CryptoKeyKeyAlgorithm;\n length: number;\n}\ninterface CryptoKeyRsaKeyAlgorithm {\n name: string;\n modulusLength: number;\n publicExponent: ArrayBuffer | ArrayBufferView;\n hash?: CryptoKeyKeyAlgorithm;\n}\ninterface CryptoKeyEllipticKeyAlgorithm {\n name: string;\n namedCurve: string;\n}\ninterface CryptoKeyArbitraryKeyAlgorithm {\n name: string;\n hash?: CryptoKeyKeyAlgorithm;\n namedCurve?: string;\n length?: number;\n}\ndeclare class DigestStream extends WritableStream {\n constructor(algorithm: string | SubtleCryptoHashAlgorithm);\n readonly digest: Promise;\n get bytesWritten(): number | bigint;\n}\n/**\n * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, `KOI8-R`, `GBK`, etc.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder)\n */\ndeclare class TextDecoder {\n constructor(label?: string, options?: TextDecoderConstructorOptions);\n /**\n * The **`TextDecoder.decode()`** method returns a string containing text decoded from the buffer passed as a parameter.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder/decode)\n */\n decode(input?: (ArrayBuffer | ArrayBufferView), options?: TextDecoderDecodeOptions): string;\n get encoding(): string;\n get fatal(): boolean;\n get ignoreBOM(): boolean;\n}\n/**\n * The **`TextEncoder`** interface takes a stream of code points as input and emits a stream of UTF-8 bytes.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder)\n */\ndeclare class TextEncoder {\n constructor();\n /**\n * The **`TextEncoder.encode()`** method takes a string as input, and returns a Global_Objects/Uint8Array containing the text given in parameters encoded with the specific method for that TextEncoder object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode)\n */\n encode(input?: string): Uint8Array;\n /**\n * The **`TextEncoder.encodeInto()`** method takes a string to encode and a destination Uint8Array to put resulting UTF-8 encoded text into, and returns a dictionary object indicating the progress of the encoding.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto)\n */\n encodeInto(input: string, buffer: Uint8Array): TextEncoderEncodeIntoResult;\n get encoding(): string;\n}\ninterface TextDecoderConstructorOptions {\n fatal: boolean;\n ignoreBOM: boolean;\n}\ninterface TextDecoderDecodeOptions {\n stream: boolean;\n}\ninterface TextEncoderEncodeIntoResult {\n read: number;\n written: number;\n}\n/**\n * The **`ErrorEvent`** interface represents events providing information related to errors in scripts or in files.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent)\n */\ndeclare class ErrorEvent extends Event {\n constructor(type: string, init?: ErrorEventErrorEventInit);\n /**\n * The **`filename`** read-only property of the ErrorEvent interface returns a string containing the name of the script file in which the error occurred.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/filename)\n */\n get filename(): string;\n /**\n * The **`message`** read-only property of the ErrorEvent interface returns a string containing a human-readable error message describing the problem.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/message)\n */\n get message(): string;\n /**\n * The **`lineno`** read-only property of the ErrorEvent interface returns an integer containing the line number of the script file on which the error occurred.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/lineno)\n */\n get lineno(): number;\n /**\n * The **`colno`** read-only property of the ErrorEvent interface returns an integer containing the column number of the script file on which the error occurred.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/colno)\n */\n get colno(): number;\n /**\n * The **`error`** read-only property of the ErrorEvent interface returns a JavaScript value, such as an Error or DOMException, representing the error associated with this event.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/error)\n */\n get error(): any;\n}\ninterface ErrorEventErrorEventInit {\n message?: string;\n filename?: string;\n lineno?: number;\n colno?: number;\n error?: any;\n}\n/**\n * The **`MessageEvent`** interface represents a message received by a target object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent)\n */\ndeclare class MessageEvent extends Event {\n constructor(type: string, initializer: MessageEventInit);\n /**\n * The **`data`** read-only property of the The data sent by the message emitter; this can be any data type, depending on what originated this event.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/data)\n */\n readonly data: any;\n /**\n * The **`origin`** read-only property of the origin of the message emitter.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/origin)\n */\n readonly origin: string | null;\n /**\n * The **`lastEventId`** read-only property of the unique ID for the event.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/lastEventId)\n */\n readonly lastEventId: string;\n /**\n * The **`source`** read-only property of the a WindowProxy, MessagePort, or a `MessageEventSource` (which can be a WindowProxy, message emitter.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source)\n */\n readonly source: MessagePort | null;\n /**\n * The **`ports`** read-only property of the containing all MessagePort objects sent with the message, in order.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/ports)\n */\n readonly ports: MessagePort[];\n}\ninterface MessageEventInit {\n data: ArrayBuffer | string;\n}\n/**\n * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent)\n */\ndeclare abstract class PromiseRejectionEvent extends Event {\n /**\n * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript rejected.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise)\n */\n readonly promise: Promise;\n /**\n * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject().\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason)\n */\n readonly reason: any;\n}\n/**\n * The **`FormData`** interface provides a way to construct a set of key/value pairs representing form fields and their values, which can be sent using the Window/fetch, XMLHttpRequest.send() or navigator.sendBeacon() methods.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData)\n */\ndeclare class FormData {\n constructor();\n /**\n * The **`append()`** method of the FormData interface appends a new value onto an existing key inside a `FormData` object, or adds the key if it does not already exist.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)\n */\n append(name: string, value: string): void;\n /**\n * The **`append()`** method of the FormData interface appends a new value onto an existing key inside a `FormData` object, or adds the key if it does not already exist.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)\n */\n append(name: string, value: Blob, filename?: string): void;\n /**\n * The **`delete()`** method of the FormData interface deletes a key and its value(s) from a `FormData` object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/delete)\n */\n delete(name: string): void;\n /**\n * The **`get()`** method of the FormData interface returns the first value associated with a given key from within a `FormData` object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/get)\n */\n get(name: string): (File | string) | null;\n /**\n * The **`getAll()`** method of the FormData interface returns all the values associated with a given key from within a `FormData` object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/getAll)\n */\n getAll(name: string): (File | string)[];\n /**\n * The **`has()`** method of the FormData interface returns whether a `FormData` object contains a certain key.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/has)\n */\n has(name: string): boolean;\n /**\n * The **`set()`** method of the FormData interface sets a new value for an existing key inside a `FormData` object, or adds the key/value if it does not already exist.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)\n */\n set(name: string, value: string): void;\n /**\n * The **`set()`** method of the FormData interface sets a new value for an existing key inside a `FormData` object, or adds the key/value if it does not already exist.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)\n */\n set(name: string, value: Blob, filename?: string): void;\n /* Returns an array of key, value pairs for every entry in the list. */\n entries(): IterableIterator<[\n key: string,\n value: File | string\n ]>;\n /* Returns a list of keys in the list. */\n keys(): IterableIterator;\n /* Returns a list of values in the list. */\n values(): IterableIterator<(File | string)>;\n forEach(callback: (this: This, value: File | string, key: string, parent: FormData) => void, thisArg?: This): void;\n [Symbol.iterator](): IterableIterator<[\n key: string,\n value: File | string\n ]>;\n}\ninterface ContentOptions {\n html?: boolean;\n}\ndeclare class HTMLRewriter {\n constructor();\n on(selector: string, handlers: HTMLRewriterElementContentHandlers): HTMLRewriter;\n onDocument(handlers: HTMLRewriterDocumentContentHandlers): HTMLRewriter;\n transform(response: Response): Response;\n}\ninterface HTMLRewriterElementContentHandlers {\n element?(element: Element): void | Promise;\n comments?(comment: Comment): void | Promise;\n text?(element: Text): void | Promise;\n}\ninterface HTMLRewriterDocumentContentHandlers {\n doctype?(doctype: Doctype): void | Promise;\n comments?(comment: Comment): void | Promise;\n text?(text: Text): void | Promise;\n end?(end: DocumentEnd): void | Promise;\n}\ninterface Doctype {\n readonly name: string | null;\n readonly publicId: string | null;\n readonly systemId: string | null;\n}\ninterface Element {\n tagName: string;\n readonly attributes: IterableIterator;\n readonly removed: boolean;\n readonly namespaceURI: string;\n getAttribute(name: string): string | null;\n hasAttribute(name: string): boolean;\n setAttribute(name: string, value: string): Element;\n removeAttribute(name: string): Element;\n before(content: string | ReadableStream | Response, options?: ContentOptions): Element;\n after(content: string | ReadableStream | Response, options?: ContentOptions): Element;\n prepend(content: string | ReadableStream | Response, options?: ContentOptions): Element;\n append(content: string | ReadableStream | Response, options?: ContentOptions): Element;\n replace(content: string | ReadableStream | Response, options?: ContentOptions): Element;\n remove(): Element;\n removeAndKeepContent(): Element;\n setInnerContent(content: string | ReadableStream | Response, options?: ContentOptions): Element;\n onEndTag(handler: (tag: EndTag) => void | Promise): void;\n}\ninterface EndTag {\n name: string;\n before(content: string | ReadableStream | Response, options?: ContentOptions): EndTag;\n after(content: string | ReadableStream | Response, options?: ContentOptions): EndTag;\n remove(): EndTag;\n}\ninterface Comment {\n text: string;\n readonly removed: boolean;\n before(content: string, options?: ContentOptions): Comment;\n after(content: string, options?: ContentOptions): Comment;\n replace(content: string, options?: ContentOptions): Comment;\n remove(): Comment;\n}\ninterface Text {\n readonly text: string;\n readonly lastInTextNode: boolean;\n readonly removed: boolean;\n before(content: string | ReadableStream | Response, options?: ContentOptions): Text;\n after(content: string | ReadableStream | Response, options?: ContentOptions): Text;\n replace(content: string | ReadableStream | Response, options?: ContentOptions): Text;\n remove(): Text;\n}\ninterface DocumentEnd {\n append(content: string, options?: ContentOptions): DocumentEnd;\n}\n/**\n * This is the event type for `fetch` events dispatched on the ServiceWorkerGlobalScope.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent)\n */\ndeclare abstract class FetchEvent extends ExtendableEvent {\n /**\n * The **`request`** read-only property of the the event handler.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/request)\n */\n readonly request: Request;\n /**\n * The **`respondWith()`** method of allows you to provide a promise for a Response yourself.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/respondWith)\n */\n respondWith(promise: Response | Promise): void;\n passThroughOnException(): void;\n}\ntype HeadersInit = Headers | Iterable> | Record;\n/**\n * The **`Headers`** interface of the Fetch API allows you to perform various actions on HTTP request and response headers.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers)\n */\ndeclare class Headers {\n constructor(init?: HeadersInit);\n /**\n * The **`get()`** method of the Headers interface returns a byte string of all the values of a header within a `Headers` object with a given name.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/get)\n */\n get(name: string): string | null;\n getAll(name: string): string[];\n /**\n * The **`getSetCookie()`** method of the Headers interface returns an array containing the values of all Set-Cookie headers associated with a response.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/getSetCookie)\n */\n getSetCookie(): string[];\n /**\n * The **`has()`** method of the Headers interface returns a boolean stating whether a `Headers` object contains a certain header.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/has)\n */\n has(name: string): boolean;\n /**\n * The **`set()`** method of the Headers interface sets a new value for an existing header inside a `Headers` object, or adds the header if it does not already exist.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/set)\n */\n set(name: string, value: string): void;\n /**\n * The **`append()`** method of the Headers interface appends a new value onto an existing header inside a `Headers` object, or adds the header if it does not already exist.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/append)\n */\n append(name: string, value: string): void;\n /**\n * The **`delete()`** method of the Headers interface deletes a header from the current `Headers` object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/delete)\n */\n delete(name: string): void;\n forEach(callback: (this: This, value: string, key: string, parent: Headers) => void, thisArg?: This): void;\n /* Returns an iterator allowing to go through all key/value pairs contained in this object. */\n entries(): IterableIterator<[\n key: string,\n value: string\n ]>;\n /* Returns an iterator allowing to go through all keys of the key/value pairs contained in this object. */\n keys(): IterableIterator;\n /* Returns an iterator allowing to go through all values of the key/value pairs contained in this object. */\n values(): IterableIterator;\n [Symbol.iterator](): IterableIterator<[\n key: string,\n value: string\n ]>;\n}\ntype BodyInit = ReadableStream | string | ArrayBuffer | ArrayBufferView | Blob | URLSearchParams | FormData;\ndeclare abstract class Body {\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */\n get body(): ReadableStream | null;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */\n get bodyUsed(): boolean;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */\n arrayBuffer(): Promise;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */\n bytes(): Promise;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */\n text(): Promise;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */\n json(): Promise;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */\n formData(): Promise;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */\n blob(): Promise;\n}\n/**\n * The **`Response`** interface of the Fetch API represents the response to a request.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response)\n */\ndeclare var Response: {\n prototype: Response;\n new (body?: BodyInit | null, init?: ResponseInit): Response;\n error(): Response;\n redirect(url: string, status?: number): Response;\n json(any: any, maybeInit?: (ResponseInit | Response)): Response;\n};\n/**\n * The **`Response`** interface of the Fetch API represents the response to a request.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response)\n */\ninterface Response extends Body {\n /**\n * The **`clone()`** method of the Response interface creates a clone of a response object, identical in every way, but stored in a different variable.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/clone)\n */\n clone(): Response;\n /**\n * The **`status`** read-only property of the Response interface contains the HTTP status codes of the response.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/status)\n */\n status: number;\n /**\n * The **`statusText`** read-only property of the Response interface contains the status message corresponding to the HTTP status code in Response.status.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/statusText)\n */\n statusText: string;\n /**\n * The **`headers`** read-only property of the with the response.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/headers)\n */\n headers: Headers;\n /**\n * The **`ok`** read-only property of the Response interface contains a Boolean stating whether the response was successful (status in the range 200-299) or not.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/ok)\n */\n ok: boolean;\n /**\n * The **`redirected`** read-only property of the Response interface indicates whether or not the response is the result of a request you made which was redirected.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/redirected)\n */\n redirected: boolean;\n /**\n * The **`url`** read-only property of the Response interface contains the URL of the response.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/url)\n */\n url: string;\n webSocket: WebSocket | null;\n cf: any | undefined;\n /**\n * The **`type`** read-only property of the Response interface contains the type of the response.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/type)\n */\n type: \"default\" | \"error\";\n}\ninterface ResponseInit {\n status?: number;\n statusText?: string;\n headers?: HeadersInit;\n cf?: any;\n webSocket?: (WebSocket | null);\n encodeBody?: \"automatic\" | \"manual\";\n}\ntype RequestInfo> = Request | string;\n/**\n * The **`Request`** interface of the Fetch API represents a resource request.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request)\n */\ndeclare var Request: {\n prototype: Request;\n new >(input: RequestInfo | URL, init?: RequestInit): Request;\n};\n/**\n * The **`Request`** interface of the Fetch API represents a resource request.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request)\n */\ninterface Request> extends Body {\n /**\n * The **`clone()`** method of the Request interface creates a copy of the current `Request` object.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/clone)\n */\n clone(): Request;\n /**\n * The **`method`** read-only property of the `POST`, etc.) A String indicating the method of the request.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/method)\n */\n method: string;\n /**\n * The **`url`** read-only property of the Request interface contains the URL of the request.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/url)\n */\n url: string;\n /**\n * The **`headers`** read-only property of the with the request.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/headers)\n */\n headers: Headers;\n /**\n * The **`redirect`** read-only property of the Request interface contains the mode for how redirects are handled.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/redirect)\n */\n redirect: string;\n fetcher: Fetcher | null;\n /**\n * The read-only **`signal`** property of the Request interface returns the AbortSignal associated with the request.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/signal)\n */\n signal: AbortSignal;\n cf: Cf | undefined;\n /**\n * The **`integrity`** read-only property of the Request interface contains the subresource integrity value of the request.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/integrity)\n */\n integrity: string;\n /**\n * The **`keepalive`** read-only property of the Request interface contains the request's `keepalive` setting (`true` or `false`), which indicates whether the browser will keep the associated request alive if the page that initiated it is unloaded before the request is complete.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/keepalive)\n */\n keepalive: boolean;\n /**\n * The **`cache`** read-only property of the Request interface contains the cache mode of the request.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/cache)\n */\n cache?: \"no-store\" | \"no-cache\";\n}\ninterface RequestInit {\n /* A string to set request's method. */\n method?: string;\n /* A Headers object, an object literal, or an array of two-item arrays to set request's headers. */\n headers?: HeadersInit;\n /* A BodyInit object or null to set request's body. */\n body?: BodyInit | null;\n /* A string indicating whether request follows redirects, results in an error upon encountering a redirect, or returns the redirect (in an opaque fashion). Sets request's redirect. */\n redirect?: string;\n fetcher?: (Fetcher | null);\n cf?: Cf;\n /* A string indicating how the request will interact with the browser's cache to set request's cache. */\n cache?: \"no-store\" | \"no-cache\";\n /* A cryptographic hash of the resource to be fetched by request. Sets request's integrity. */\n integrity?: string;\n /* An AbortSignal to set request's signal. */\n signal?: (AbortSignal | null);\n encodeResponseBody?: \"automatic\" | \"manual\";\n}\ntype Service Rpc.WorkerEntrypointBranded) | Rpc.WorkerEntrypointBranded | ExportedHandler | undefined = undefined> = T extends new (...args: any[]) => Rpc.WorkerEntrypointBranded ? Fetcher> : T extends Rpc.WorkerEntrypointBranded ? Fetcher : T extends Exclude ? never : Fetcher;\ntype Fetcher = (T extends Rpc.EntrypointBranded ? Rpc.Provider : unknown) & {\n fetch(input: RequestInfo | URL, init?: RequestInit): Promise;\n connect(address: SocketAddress | string, options?: SocketOptions): Socket;\n};\ninterface KVNamespaceListKey {\n name: Key;\n expiration?: number;\n metadata?: Metadata;\n}\ntype KVNamespaceListResult = {\n list_complete: false;\n keys: KVNamespaceListKey[];\n cursor: string;\n cacheStatus: string | null;\n} | {\n list_complete: true;\n keys: KVNamespaceListKey[];\n cacheStatus: string | null;\n};\ninterface KVNamespace {\n get(key: Key, options?: Partial>): Promise;\n get(key: Key, type: \"text\"): Promise;\n get(key: Key, type: \"json\"): Promise;\n get(key: Key, type: \"arrayBuffer\"): Promise;\n get(key: Key, type: \"stream\"): Promise;\n get(key: Key, options?: KVNamespaceGetOptions<\"text\">): Promise;\n get(key: Key, options?: KVNamespaceGetOptions<\"json\">): Promise;\n get(key: Key, options?: KVNamespaceGetOptions<\"arrayBuffer\">): Promise;\n get(key: Key, options?: KVNamespaceGetOptions<\"stream\">): Promise;\n get(key: Array, type: \"text\"): Promise>;\n get(key: Array, type: \"json\"): Promise>;\n get(key: Array, options?: Partial>): Promise>;\n get(key: Array, options?: KVNamespaceGetOptions<\"text\">): Promise>;\n get(key: Array, options?: KVNamespaceGetOptions<\"json\">): Promise>;\n list(options?: KVNamespaceListOptions): Promise>;\n put(key: Key, value: string | ArrayBuffer | ArrayBufferView | ReadableStream, options?: KVNamespacePutOptions): Promise;\n getWithMetadata(key: Key, options?: Partial>): Promise>;\n getWithMetadata(key: Key, type: \"text\"): Promise>;\n getWithMetadata(key: Key, type: \"json\"): Promise>;\n getWithMetadata(key: Key, type: \"arrayBuffer\"): Promise>;\n getWithMetadata(key: Key, type: \"stream\"): Promise>;\n getWithMetadata(key: Key, options: KVNamespaceGetOptions<\"text\">): Promise>;\n getWithMetadata(key: Key, options: KVNamespaceGetOptions<\"json\">): Promise>;\n getWithMetadata(key: Key, options: KVNamespaceGetOptions<\"arrayBuffer\">): Promise>;\n getWithMetadata(key: Key, options: KVNamespaceGetOptions<\"stream\">): Promise>;\n getWithMetadata(key: Array, type: \"text\"): Promise>>;\n getWithMetadata(key: Array, type: \"json\"): Promise>>;\n getWithMetadata(key: Array, options?: Partial>): Promise>>;\n getWithMetadata(key: Array, options?: KVNamespaceGetOptions<\"text\">): Promise>>;\n getWithMetadata(key: Array, options?: KVNamespaceGetOptions<\"json\">): Promise>>;\n delete(key: Key): Promise;\n}\ninterface KVNamespaceListOptions {\n limit?: number;\n prefix?: (string | null);\n cursor?: (string | null);\n}\ninterface KVNamespaceGetOptions {\n type: Type;\n cacheTtl?: number;\n}\ninterface KVNamespacePutOptions {\n expiration?: number;\n expirationTtl?: number;\n metadata?: (any | null);\n}\ninterface KVNamespaceGetWithMetadataResult {\n value: Value | null;\n metadata: Metadata | null;\n cacheStatus: string | null;\n}\ntype QueueContentType = \"text\" | \"bytes\" | \"json\" | \"v8\";\ninterface Queue {\n send(message: Body, options?: QueueSendOptions): Promise;\n sendBatch(messages: Iterable>, options?: QueueSendBatchOptions): Promise;\n}\ninterface QueueSendOptions {\n contentType?: QueueContentType;\n delaySeconds?: number;\n}\ninterface QueueSendBatchOptions {\n delaySeconds?: number;\n}\ninterface MessageSendRequest {\n body: Body;\n contentType?: QueueContentType;\n delaySeconds?: number;\n}\ninterface QueueRetryOptions {\n delaySeconds?: number;\n}\ninterface Message {\n readonly id: string;\n readonly timestamp: Date;\n readonly body: Body;\n readonly attempts: number;\n retry(options?: QueueRetryOptions): void;\n ack(): void;\n}\ninterface QueueEvent extends ExtendableEvent {\n readonly messages: readonly Message[];\n readonly queue: string;\n retryAll(options?: QueueRetryOptions): void;\n ackAll(): void;\n}\ninterface MessageBatch {\n readonly messages: readonly Message[];\n readonly queue: string;\n retryAll(options?: QueueRetryOptions): void;\n ackAll(): void;\n}\ninterface R2Error extends Error {\n readonly name: string;\n readonly code: number;\n readonly message: string;\n readonly action: string;\n readonly stack: any;\n}\ninterface R2ListOptions {\n limit?: number;\n prefix?: string;\n cursor?: string;\n delimiter?: string;\n startAfter?: string;\n include?: (\"httpMetadata\" | \"customMetadata\")[];\n}\ndeclare abstract class R2Bucket {\n head(key: string): Promise;\n get(key: string, options: R2GetOptions & {\n onlyIf: R2Conditional | Headers;\n }): Promise;\n get(key: string, options?: R2GetOptions): Promise;\n put(key: string, value: ReadableStream | ArrayBuffer | ArrayBufferView | string | null | Blob, options?: R2PutOptions & {\n onlyIf: R2Conditional | Headers;\n }): Promise;\n put(key: string, value: ReadableStream | ArrayBuffer | ArrayBufferView | string | null | Blob, options?: R2PutOptions): Promise;\n createMultipartUpload(key: string, options?: R2MultipartOptions): Promise;\n resumeMultipartUpload(key: string, uploadId: string): R2MultipartUpload;\n delete(keys: string | string[]): Promise;\n list(options?: R2ListOptions): Promise;\n}\ninterface R2MultipartUpload {\n readonly key: string;\n readonly uploadId: string;\n uploadPart(partNumber: number, value: ReadableStream | (ArrayBuffer | ArrayBufferView) | string | Blob, options?: R2UploadPartOptions): Promise;\n abort(): Promise;\n complete(uploadedParts: R2UploadedPart[]): Promise;\n}\ninterface R2UploadedPart {\n partNumber: number;\n etag: string;\n}\ndeclare abstract class R2Object {\n readonly key: string;\n readonly version: string;\n readonly size: number;\n readonly etag: string;\n readonly httpEtag: string;\n readonly checksums: R2Checksums;\n readonly uploaded: Date;\n readonly httpMetadata?: R2HTTPMetadata;\n readonly customMetadata?: Record;\n readonly range?: R2Range;\n readonly storageClass: string;\n readonly ssecKeyMd5?: string;\n writeHttpMetadata(headers: Headers): void;\n}\ninterface R2ObjectBody extends R2Object {\n get body(): ReadableStream;\n get bodyUsed(): boolean;\n arrayBuffer(): Promise;\n bytes(): Promise;\n text(): Promise;\n json(): Promise;\n blob(): Promise;\n}\ntype R2Range = {\n offset: number;\n length?: number;\n} | {\n offset?: number;\n length: number;\n} | {\n suffix: number;\n};\ninterface R2Conditional {\n etagMatches?: string;\n etagDoesNotMatch?: string;\n uploadedBefore?: Date;\n uploadedAfter?: Date;\n secondsGranularity?: boolean;\n}\ninterface R2GetOptions {\n onlyIf?: (R2Conditional | Headers);\n range?: (R2Range | Headers);\n ssecKey?: (ArrayBuffer | string);\n}\ninterface R2PutOptions {\n onlyIf?: (R2Conditional | Headers);\n httpMetadata?: (R2HTTPMetadata | Headers);\n customMetadata?: Record;\n md5?: ((ArrayBuffer | ArrayBufferView) | string);\n sha1?: ((ArrayBuffer | ArrayBufferView) | string);\n sha256?: ((ArrayBuffer | ArrayBufferView) | string);\n sha384?: ((ArrayBuffer | ArrayBufferView) | string);\n sha512?: ((ArrayBuffer | ArrayBufferView) | string);\n storageClass?: string;\n ssecKey?: (ArrayBuffer | string);\n}\ninterface R2MultipartOptions {\n httpMetadata?: (R2HTTPMetadata | Headers);\n customMetadata?: Record;\n storageClass?: string;\n ssecKey?: (ArrayBuffer | string);\n}\ninterface R2Checksums {\n readonly md5?: ArrayBuffer;\n readonly sha1?: ArrayBuffer;\n readonly sha256?: ArrayBuffer;\n readonly sha384?: ArrayBuffer;\n readonly sha512?: ArrayBuffer;\n toJSON(): R2StringChecksums;\n}\ninterface R2StringChecksums {\n md5?: string;\n sha1?: string;\n sha256?: string;\n sha384?: string;\n sha512?: string;\n}\ninterface R2HTTPMetadata {\n contentType?: string;\n contentLanguage?: string;\n contentDisposition?: string;\n contentEncoding?: string;\n cacheControl?: string;\n cacheExpiry?: Date;\n}\ntype R2Objects = {\n objects: R2Object[];\n delimitedPrefixes: string[];\n} & ({\n truncated: true;\n cursor: string;\n} | {\n truncated: false;\n});\ninterface R2UploadPartOptions {\n ssecKey?: (ArrayBuffer | string);\n}\ndeclare abstract class ScheduledEvent extends ExtendableEvent {\n readonly scheduledTime: number;\n readonly cron: string;\n noRetry(): void;\n}\ninterface ScheduledController {\n readonly scheduledTime: number;\n readonly cron: string;\n noRetry(): void;\n}\ninterface QueuingStrategy {\n highWaterMark?: (number | bigint);\n size?: (chunk: T) => number | bigint;\n}\ninterface UnderlyingSink {\n type?: string;\n start?: (controller: WritableStreamDefaultController) => void | Promise;\n write?: (chunk: W, controller: WritableStreamDefaultController) => void | Promise;\n abort?: (reason: any) => void | Promise;\n close?: () => void | Promise;\n}\ninterface UnderlyingByteSource {\n type: \"bytes\";\n autoAllocateChunkSize?: number;\n start?: (controller: ReadableByteStreamController) => void | Promise;\n pull?: (controller: ReadableByteStreamController) => void | Promise;\n cancel?: (reason: any) => void | Promise;\n}\ninterface UnderlyingSource {\n type?: \"\" | undefined;\n start?: (controller: ReadableStreamDefaultController) => void | Promise;\n pull?: (controller: ReadableStreamDefaultController) => void | Promise;\n cancel?: (reason: any) => void | Promise;\n expectedLength?: (number | bigint);\n}\ninterface Transformer {\n readableType?: string;\n writableType?: string;\n start?: (controller: TransformStreamDefaultController) => void | Promise;\n transform?: (chunk: I, controller: TransformStreamDefaultController) => void | Promise;\n flush?: (controller: TransformStreamDefaultController) => void | Promise;\n cancel?: (reason: any) => void | Promise;\n expectedLength?: number;\n}\ninterface StreamPipeOptions {\n /**\n * Pipes this readable stream to a given writable stream destination. The way in which the piping process behaves under various error conditions can be customized with a number of passed options. It returns a promise that fulfills when the piping process completes successfully, or rejects if any errors were encountered.\n *\n * Piping a stream will lock it for the duration of the pipe, preventing any other consumer from acquiring a reader.\n *\n * Errors and closures of the source and destination streams propagate as follows:\n *\n * An error in this source readable stream will abort destination, unless preventAbort is truthy. The returned promise will be rejected with the source's error, or with any error that occurs during aborting the destination.\n *\n * An error in destination will cancel this source readable stream, unless preventCancel is truthy. The returned promise will be rejected with the destination's error, or with any error that occurs during canceling the source.\n *\n * When this source readable stream closes, destination will be closed, unless preventClose is truthy. The returned promise will be fulfilled once this process completes, unless an error is encountered while closing the destination, in which case it will be rejected with that error.\n *\n * If destination starts out closed or closing, this source readable stream will be canceled, unless preventCancel is true. The returned promise will be rejected with an error indicating piping to a closed stream failed, or with any error that occurs during canceling the source.\n *\n * The signal option can be set to an AbortSignal to allow aborting an ongoing pipe operation via the corresponding AbortController. In this case, this source readable stream will be canceled, and destination aborted, unless the respective options preventCancel or preventAbort are set.\n */\n preventClose?: boolean;\n preventAbort?: boolean;\n preventCancel?: boolean;\n signal?: AbortSignal;\n}\ntype ReadableStreamReadResult = {\n done: false;\n value: R;\n} | {\n done: true;\n value?: undefined;\n};\n/**\n * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)\n */\ninterface ReadableStream {\n /**\n * The **`locked`** read-only property of the ReadableStream interface returns whether or not the readable stream is locked to a reader.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/locked)\n */\n get locked(): boolean;\n /**\n * The **`cancel()`** method of the ReadableStream interface returns a Promise that resolves when the stream is canceled.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/cancel)\n */\n cancel(reason?: any): Promise;\n /**\n * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)\n */\n getReader(): ReadableStreamDefaultReader;\n /**\n * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)\n */\n getReader(options: ReadableStreamGetReaderOptions): ReadableStreamBYOBReader;\n /**\n * The **`pipeThrough()`** method of the ReadableStream interface provides a chainable way of piping the current stream through a transform stream or any other writable/readable pair.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeThrough)\n */\n pipeThrough(transform: ReadableWritablePair, options?: StreamPipeOptions): ReadableStream;\n /**\n * The **`pipeTo()`** method of the ReadableStream interface pipes the current `ReadableStream` to a given WritableStream and returns a Promise that fulfills when the piping process completes successfully, or rejects if any errors were encountered.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo)\n */\n pipeTo(destination: WritableStream, options?: StreamPipeOptions): Promise;\n /**\n * The **`tee()`** method of the two-element array containing the two resulting branches as new ReadableStream instances.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/tee)\n */\n tee(): [\n ReadableStream,\n ReadableStream\n ];\n values(options?: ReadableStreamValuesOptions): AsyncIterableIterator;\n [Symbol.asyncIterator](options?: ReadableStreamValuesOptions): AsyncIterableIterator;\n}\n/**\n * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)\n */\ndeclare const ReadableStream: {\n prototype: ReadableStream;\n new (underlyingSource: UnderlyingByteSource, strategy?: QueuingStrategy): ReadableStream;\n new (underlyingSource?: UnderlyingSource, strategy?: QueuingStrategy): ReadableStream;\n};\n/**\n * The **`ReadableStreamDefaultReader`** interface of the Streams API represents a default reader that can be used to read stream data supplied from a network (such as a fetch request).\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader)\n */\ndeclare class ReadableStreamDefaultReader {\n constructor(stream: ReadableStream);\n get closed(): Promise;\n cancel(reason?: any): Promise;\n /**\n * The **`read()`** method of the ReadableStreamDefaultReader interface returns a Promise providing access to the next chunk in the stream's internal queue.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader/read)\n */\n read(): Promise>;\n /**\n * The **`releaseLock()`** method of the ReadableStreamDefaultReader interface releases the reader's lock on the stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader/releaseLock)\n */\n releaseLock(): void;\n}\n/**\n * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)\n */\ndeclare class ReadableStreamBYOBReader {\n constructor(stream: ReadableStream);\n get closed(): Promise;\n cancel(reason?: any): Promise;\n /**\n * The **`read()`** method of the ReadableStreamBYOBReader interface is used to read data into a view on a user-supplied buffer from an associated readable byte stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read)\n */\n read(view: T): Promise>;\n /**\n * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock)\n */\n releaseLock(): void;\n readAtLeast(minElements: number, view: T): Promise>;\n}\ninterface ReadableStreamBYOBReaderReadableStreamBYOBReaderReadOptions {\n min?: number;\n}\ninterface ReadableStreamGetReaderOptions {\n /**\n * Creates a ReadableStreamBYOBReader and locks the stream to the new reader.\n *\n * This call behaves the same way as the no-argument variant, except that it only works on readable byte streams, i.e. streams which were constructed specifically with the ability to handle \"bring your own buffer\" reading. The returned BYOB reader provides the ability to directly read individual chunks from the stream via its read() method, into developer-supplied buffers, allowing more precise control over allocation.\n */\n mode: \"byob\";\n}\n/**\n * The **`ReadableStreamBYOBRequest`** interface of the Streams API represents a 'pull request' for data from an underlying source that will made as a zero-copy transfer to a consumer (bypassing the stream's internal queues).\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest)\n */\ndeclare abstract class ReadableStreamBYOBRequest {\n /**\n * The **`view`** getter property of the ReadableStreamBYOBRequest interface returns the current view.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/view)\n */\n get view(): Uint8Array | null;\n /**\n * The **`respond()`** method of the ReadableStreamBYOBRequest interface is used to signal to the associated readable byte stream that the specified number of bytes were written into the ReadableStreamBYOBRequest.view.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/respond)\n */\n respond(bytesWritten: number): void;\n /**\n * The **`respondWithNewView()`** method of the ReadableStreamBYOBRequest interface specifies a new view that the consumer of the associated readable byte stream should write to instead of ReadableStreamBYOBRequest.view.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/respondWithNewView)\n */\n respondWithNewView(view: ArrayBuffer | ArrayBufferView): void;\n get atLeast(): number | null;\n}\n/**\n * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController)\n */\ndeclare abstract class ReadableStreamDefaultController {\n /**\n * The **`desiredSize`** read-only property of the required to fill the stream's internal queue.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/desiredSize)\n */\n get desiredSize(): number | null;\n /**\n * The **`close()`** method of the ReadableStreamDefaultController interface closes the associated stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/close)\n */\n close(): void;\n /**\n * The **`enqueue()`** method of the ```js-nolint enqueue(chunk) ``` - `chunk` - : The chunk to enqueue.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/enqueue)\n */\n enqueue(chunk?: R): void;\n /**\n * The **`error()`** method of the with the associated stream to error.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/error)\n */\n error(reason: any): void;\n}\n/**\n * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController)\n */\ndeclare abstract class ReadableByteStreamController {\n /**\n * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest)\n */\n get byobRequest(): ReadableStreamBYOBRequest | null;\n /**\n * The **`desiredSize`** read-only property of the ReadableByteStreamController interface returns the number of bytes required to fill the stream's internal queue to its 'desired size'.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize)\n */\n get desiredSize(): number | null;\n /**\n * The **`close()`** method of the ReadableByteStreamController interface closes the associated stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/close)\n */\n close(): void;\n /**\n * The **`enqueue()`** method of the ReadableByteStreamController interface enqueues a given chunk on the associated readable byte stream (the chunk is copied into the stream's internal queues).\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/enqueue)\n */\n enqueue(chunk: ArrayBuffer | ArrayBufferView): void;\n /**\n * The **`error()`** method of the ReadableByteStreamController interface causes any future interactions with the associated stream to error with the specified reason.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/error)\n */\n error(reason: any): void;\n}\n/**\n * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController)\n */\ndeclare abstract class WritableStreamDefaultController {\n /**\n * The read-only **`signal`** property of the WritableStreamDefaultController interface returns the AbortSignal associated with the controller.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/signal)\n */\n get signal(): AbortSignal;\n /**\n * The **`error()`** method of the with the associated stream to error.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/error)\n */\n error(reason?: any): void;\n}\n/**\n * The **`TransformStreamDefaultController`** interface of the Streams API provides methods to manipulate the associated ReadableStream and WritableStream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController)\n */\ndeclare abstract class TransformStreamDefaultController {\n /**\n * The **`desiredSize`** read-only property of the TransformStreamDefaultController interface returns the desired size to fill the queue of the associated ReadableStream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/desiredSize)\n */\n get desiredSize(): number | null;\n /**\n * The **`enqueue()`** method of the TransformStreamDefaultController interface enqueues the given chunk in the readable side of the stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/enqueue)\n */\n enqueue(chunk?: O): void;\n /**\n * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error)\n */\n error(reason: any): void;\n /**\n * The **`terminate()`** method of the TransformStreamDefaultController interface closes the readable side and errors the writable side of the stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/terminate)\n */\n terminate(): void;\n}\ninterface ReadableWritablePair {\n /**\n * Provides a convenient, chainable way of piping this readable stream through a transform stream (or any other { writable, readable } pair). It simply pipes the stream into the writable side of the supplied pair, and returns the readable side for further use.\n *\n * Piping a stream will lock it for the duration of the pipe, preventing any other consumer from acquiring a reader.\n */\n writable: WritableStream;\n readable: ReadableStream;\n}\n/**\n * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream)\n */\ndeclare class WritableStream {\n constructor(underlyingSink?: UnderlyingSink, queuingStrategy?: QueuingStrategy);\n /**\n * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked)\n */\n get locked(): boolean;\n /**\n * The **`abort()`** method of the WritableStream interface aborts the stream, signaling that the producer can no longer successfully write to the stream and it is to be immediately moved to an error state, with any queued writes discarded.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/abort)\n */\n abort(reason?: any): Promise;\n /**\n * The **`close()`** method of the WritableStream interface closes the associated stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)\n */\n close(): Promise;\n /**\n * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)\n */\n getWriter(): WritableStreamDefaultWriter;\n}\n/**\n * The **`WritableStreamDefaultWriter`** interface of the Streams API is the object returned by WritableStream.getWriter() and once created locks the writer to the `WritableStream` ensuring that no other streams can write to the underlying sink.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)\n */\ndeclare class WritableStreamDefaultWriter {\n constructor(stream: WritableStream);\n /**\n * The **`closed`** read-only property of the the stream errors or the writer's lock is released.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/closed)\n */\n get closed(): Promise;\n /**\n * The **`ready`** read-only property of the that resolves when the desired size of the stream's internal queue transitions from non-positive to positive, signaling that it is no longer applying backpressure.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/ready)\n */\n get ready(): Promise;\n /**\n * The **`desiredSize`** read-only property of the to fill the stream's internal queue.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/desiredSize)\n */\n get desiredSize(): number | null;\n /**\n * The **`abort()`** method of the the producer can no longer successfully write to the stream and it is to be immediately moved to an error state, with any queued writes discarded.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/abort)\n */\n abort(reason?: any): Promise;\n /**\n * The **`close()`** method of the stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/close)\n */\n close(): Promise;\n /**\n * The **`write()`** method of the operation.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/write)\n */\n write(chunk?: W): Promise;\n /**\n * The **`releaseLock()`** method of the corresponding stream.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock)\n */\n releaseLock(): void;\n}\n/**\n * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream)\n */\ndeclare class TransformStream {\n constructor(transformer?: Transformer, writableStrategy?: QueuingStrategy, readableStrategy?: QueuingStrategy);\n /**\n * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable)\n */\n get readable(): ReadableStream;\n /**\n * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable)\n */\n get writable(): WritableStream;\n}\ndeclare class FixedLengthStream extends IdentityTransformStream {\n constructor(expectedLength: number | bigint, queuingStrategy?: IdentityTransformStreamQueuingStrategy);\n}\ndeclare class IdentityTransformStream extends TransformStream {\n constructor(queuingStrategy?: IdentityTransformStreamQueuingStrategy);\n}\ninterface IdentityTransformStreamQueuingStrategy {\n highWaterMark?: (number | bigint);\n}\ninterface ReadableStreamValuesOptions {\n preventCancel?: boolean;\n}\n/**\n * The **`CompressionStream`** interface of the Compression Streams API is an API for compressing a stream of data.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CompressionStream)\n */\ndeclare class CompressionStream extends TransformStream {\n constructor(format: \"gzip\" | \"deflate\" | \"deflate-raw\");\n}\n/**\n * The **`DecompressionStream`** interface of the Compression Streams API is an API for decompressing a stream of data.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DecompressionStream)\n */\ndeclare class DecompressionStream extends TransformStream {\n constructor(format: \"gzip\" | \"deflate\" | \"deflate-raw\");\n}\n/**\n * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream)\n */\ndeclare class TextEncoderStream extends TransformStream {\n constructor();\n get encoding(): string;\n}\n/**\n * The **`TextDecoderStream`** interface of the Encoding API converts a stream of text in a binary encoding, such as UTF-8 etc., to a stream of strings.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream)\n */\ndeclare class TextDecoderStream extends TransformStream {\n constructor(label?: string, options?: TextDecoderStreamTextDecoderStreamInit);\n get encoding(): string;\n get fatal(): boolean;\n get ignoreBOM(): boolean;\n}\ninterface TextDecoderStreamTextDecoderStreamInit {\n fatal?: boolean;\n ignoreBOM?: boolean;\n}\n/**\n * The **`ByteLengthQueuingStrategy`** interface of the Streams API provides a built-in byte length queuing strategy that can be used when constructing streams.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy)\n */\ndeclare class ByteLengthQueuingStrategy implements QueuingStrategy {\n constructor(init: QueuingStrategyInit);\n /**\n * The read-only **`ByteLengthQueuingStrategy.highWaterMark`** property returns the total number of bytes that can be contained in the internal queue before backpressure is applied.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy/highWaterMark)\n */\n get highWaterMark(): number;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy/size) */\n get size(): (chunk?: any) => number;\n}\n/**\n * The **`CountQueuingStrategy`** interface of the Streams API provides a built-in chunk counting queuing strategy that can be used when constructing streams.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy)\n */\ndeclare class CountQueuingStrategy implements QueuingStrategy {\n constructor(init: QueuingStrategyInit);\n /**\n * The read-only **`CountQueuingStrategy.highWaterMark`** property returns the total number of chunks that can be contained in the internal queue before backpressure is applied.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy/highWaterMark)\n */\n get highWaterMark(): number;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy/size) */\n get size(): (chunk?: any) => number;\n}\ninterface QueuingStrategyInit {\n /**\n * Creates a new ByteLengthQueuingStrategy with the provided high water mark.\n *\n * Note that the provided high water mark will not be validated ahead of time. Instead, if it is negative, NaN, or not a number, the resulting ByteLengthQueuingStrategy will cause the corresponding stream constructor to throw.\n */\n highWaterMark: number;\n}\ninterface ScriptVersion {\n id?: string;\n tag?: string;\n message?: string;\n}\ndeclare abstract class TailEvent extends ExtendableEvent {\n readonly events: TraceItem[];\n readonly traces: TraceItem[];\n}\ninterface TraceItem {\n readonly event: (TraceItemFetchEventInfo | TraceItemJsRpcEventInfo | TraceItemScheduledEventInfo | TraceItemAlarmEventInfo | TraceItemQueueEventInfo | TraceItemEmailEventInfo | TraceItemTailEventInfo | TraceItemCustomEventInfo | TraceItemHibernatableWebSocketEventInfo) | null;\n readonly eventTimestamp: number | null;\n readonly logs: TraceLog[];\n readonly exceptions: TraceException[];\n readonly diagnosticsChannelEvents: TraceDiagnosticChannelEvent[];\n readonly scriptName: string | null;\n readonly entrypoint?: string;\n readonly scriptVersion?: ScriptVersion;\n readonly dispatchNamespace?: string;\n readonly scriptTags?: string[];\n readonly durableObjectId?: string;\n readonly outcome: string;\n readonly executionModel: string;\n readonly truncated: boolean;\n readonly cpuTime: number;\n readonly wallTime: number;\n}\ninterface TraceItemAlarmEventInfo {\n readonly scheduledTime: Date;\n}\ninterface TraceItemCustomEventInfo {\n}\ninterface TraceItemScheduledEventInfo {\n readonly scheduledTime: number;\n readonly cron: string;\n}\ninterface TraceItemQueueEventInfo {\n readonly queue: string;\n readonly batchSize: number;\n}\ninterface TraceItemEmailEventInfo {\n readonly mailFrom: string;\n readonly rcptTo: string;\n readonly rawSize: number;\n}\ninterface TraceItemTailEventInfo {\n readonly consumedEvents: TraceItemTailEventInfoTailItem[];\n}\ninterface TraceItemTailEventInfoTailItem {\n readonly scriptName: string | null;\n}\ninterface TraceItemFetchEventInfo {\n readonly response?: TraceItemFetchEventInfoResponse;\n readonly request: TraceItemFetchEventInfoRequest;\n}\ninterface TraceItemFetchEventInfoRequest {\n readonly cf?: any;\n readonly headers: Record;\n readonly method: string;\n readonly url: string;\n getUnredacted(): TraceItemFetchEventInfoRequest;\n}\ninterface TraceItemFetchEventInfoResponse {\n readonly status: number;\n}\ninterface TraceItemJsRpcEventInfo {\n readonly rpcMethod: string;\n}\ninterface TraceItemHibernatableWebSocketEventInfo {\n readonly getWebSocketEvent: TraceItemHibernatableWebSocketEventInfoMessage | TraceItemHibernatableWebSocketEventInfoClose | TraceItemHibernatableWebSocketEventInfoError;\n}\ninterface TraceItemHibernatableWebSocketEventInfoMessage {\n readonly webSocketEventType: string;\n}\ninterface TraceItemHibernatableWebSocketEventInfoClose {\n readonly webSocketEventType: string;\n readonly code: number;\n readonly wasClean: boolean;\n}\ninterface TraceItemHibernatableWebSocketEventInfoError {\n readonly webSocketEventType: string;\n}\ninterface TraceLog {\n readonly timestamp: number;\n readonly level: string;\n readonly message: any;\n}\ninterface TraceException {\n readonly timestamp: number;\n readonly message: string;\n readonly name: string;\n readonly stack?: string;\n}\ninterface TraceDiagnosticChannelEvent {\n readonly timestamp: number;\n readonly channel: string;\n readonly message: any;\n}\ninterface TraceMetrics {\n readonly cpuTime: number;\n readonly wallTime: number;\n}\ninterface UnsafeTraceMetrics {\n fromTrace(item: TraceItem): TraceMetrics;\n}\n/**\n * The **`URL`** interface is used to parse, construct, normalize, and encode URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL)\n */\ndeclare class URL {\n constructor(url: string | URL, base?: string | URL);\n /**\n * The **`origin`** read-only property of the URL interface returns a string containing the Unicode serialization of the origin of the represented URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/origin)\n */\n get origin(): string;\n /**\n * The **`href`** property of the URL interface is a string containing the whole URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/href)\n */\n get href(): string;\n /**\n * The **`href`** property of the URL interface is a string containing the whole URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/href)\n */\n set href(value: string);\n /**\n * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)\n */\n get protocol(): string;\n /**\n * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)\n */\n set protocol(value: string);\n /**\n * The **`username`** property of the URL interface is a string containing the username component of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)\n */\n get username(): string;\n /**\n * The **`username`** property of the URL interface is a string containing the username component of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)\n */\n set username(value: string);\n /**\n * The **`password`** property of the URL interface is a string containing the password component of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)\n */\n get password(): string;\n /**\n * The **`password`** property of the URL interface is a string containing the password component of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)\n */\n set password(value: string);\n /**\n * The **`host`** property of the URL interface is a string containing the host, which is the URL.hostname, and then, if the port of the URL is nonempty, a `':'`, followed by the URL.port of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)\n */\n get host(): string;\n /**\n * The **`host`** property of the URL interface is a string containing the host, which is the URL.hostname, and then, if the port of the URL is nonempty, a `':'`, followed by the URL.port of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)\n */\n set host(value: string);\n /**\n * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)\n */\n get hostname(): string;\n /**\n * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)\n */\n set hostname(value: string);\n /**\n * The **`port`** property of the URL interface is a string containing the port number of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)\n */\n get port(): string;\n /**\n * The **`port`** property of the URL interface is a string containing the port number of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)\n */\n set port(value: string);\n /**\n * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)\n */\n get pathname(): string;\n /**\n * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)\n */\n set pathname(value: string);\n /**\n * The **`search`** property of the URL interface is a search string, also called a _query string_, that is a string containing a `'?'` followed by the parameters of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)\n */\n get search(): string;\n /**\n * The **`search`** property of the URL interface is a search string, also called a _query string_, that is a string containing a `'?'` followed by the parameters of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)\n */\n set search(value: string);\n /**\n * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)\n */\n get hash(): string;\n /**\n * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)\n */\n set hash(value: string);\n /**\n * The **`searchParams`** read-only property of the access to the [MISSING: httpmethod('GET')] decoded query arguments contained in the URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/searchParams)\n */\n get searchParams(): URLSearchParams;\n /**\n * The **`toJSON()`** method of the URL interface returns a string containing a serialized version of the URL, although in practice it seems to have the same effect as ```js-nolint toJSON() ``` None.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/toJSON)\n */\n toJSON(): string;\n /*function toString() { [native code] }*/\n toString(): string;\n /**\n * The **`URL.canParse()`** static method of the URL interface returns a boolean indicating whether or not an absolute URL, or a relative URL combined with a base URL, are parsable and valid.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/canParse_static)\n */\n static canParse(url: string, base?: string): boolean;\n /**\n * The **`URL.parse()`** static method of the URL interface returns a newly created URL object representing the URL defined by the parameters.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/parse_static)\n */\n static parse(url: string, base?: string): URL | null;\n /**\n * The **`createObjectURL()`** static method of the URL interface creates a string containing a URL representing the object given in the parameter.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/createObjectURL_static)\n */\n static createObjectURL(object: File | Blob): string;\n /**\n * The **`revokeObjectURL()`** static method of the URL interface releases an existing object URL which was previously created by calling Call this method when you've finished using an object URL to let the browser know not to keep the reference to the file any longer.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/revokeObjectURL_static)\n */\n static revokeObjectURL(object_url: string): void;\n}\n/**\n * The **`URLSearchParams`** interface defines utility methods to work with the query string of a URL.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams)\n */\ndeclare class URLSearchParams {\n constructor(init?: (Iterable> | Record | string));\n /**\n * The **`size`** read-only property of the URLSearchParams interface indicates the total number of search parameter entries.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/size)\n */\n get size(): number;\n /**\n * The **`append()`** method of the URLSearchParams interface appends a specified key/value pair as a new search parameter.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/append)\n */\n append(name: string, value: string): void;\n /**\n * The **`delete()`** method of the URLSearchParams interface deletes specified parameters and their associated value(s) from the list of all search parameters.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/delete)\n */\n delete(name: string, value?: string): void;\n /**\n * The **`get()`** method of the URLSearchParams interface returns the first value associated to the given search parameter.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/get)\n */\n get(name: string): string | null;\n /**\n * The **`getAll()`** method of the URLSearchParams interface returns all the values associated with a given search parameter as an array.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/getAll)\n */\n getAll(name: string): string[];\n /**\n * The **`has()`** method of the URLSearchParams interface returns a boolean value that indicates whether the specified parameter is in the search parameters.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/has)\n */\n has(name: string, value?: string): boolean;\n /**\n * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set)\n */\n set(name: string, value: string): void;\n /**\n * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort)\n */\n sort(): void;\n /* Returns an array of key, value pairs for every entry in the search params. */\n entries(): IterableIterator<[\n key: string,\n value: string\n ]>;\n /* Returns a list of keys in the search params. */\n keys(): IterableIterator;\n /* Returns a list of values in the search params. */\n values(): IterableIterator;\n forEach(callback: (this: This, value: string, key: string, parent: URLSearchParams) => void, thisArg?: This): void;\n /*function toString() { [native code] }*/\n toString(): string;\n [Symbol.iterator](): IterableIterator<[\n key: string,\n value: string\n ]>;\n}\ndeclare class URLPattern {\n constructor(input?: (string | URLPatternInit), baseURL?: (string | URLPatternOptions), patternOptions?: URLPatternOptions);\n get protocol(): string;\n get username(): string;\n get password(): string;\n get hostname(): string;\n get port(): string;\n get pathname(): string;\n get search(): string;\n get hash(): string;\n get hasRegExpGroups(): boolean;\n test(input?: (string | URLPatternInit), baseURL?: string): boolean;\n exec(input?: (string | URLPatternInit), baseURL?: string): URLPatternResult | null;\n}\ninterface URLPatternInit {\n protocol?: string;\n username?: string;\n password?: string;\n hostname?: string;\n port?: string;\n pathname?: string;\n search?: string;\n hash?: string;\n baseURL?: string;\n}\ninterface URLPatternComponentResult {\n input: string;\n groups: Record;\n}\ninterface URLPatternResult {\n inputs: (string | URLPatternInit)[];\n protocol: URLPatternComponentResult;\n username: URLPatternComponentResult;\n password: URLPatternComponentResult;\n hostname: URLPatternComponentResult;\n port: URLPatternComponentResult;\n pathname: URLPatternComponentResult;\n search: URLPatternComponentResult;\n hash: URLPatternComponentResult;\n}\ninterface URLPatternOptions {\n ignoreCase?: boolean;\n}\n/**\n * A `CloseEvent` is sent to clients using WebSockets when the connection is closed.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent)\n */\ndeclare class CloseEvent extends Event {\n constructor(type: string, initializer?: CloseEventInit);\n /**\n * The **`code`** read-only property of the CloseEvent interface returns a WebSocket connection close code indicating the reason the connection was closed.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/code)\n */\n readonly code: number;\n /**\n * The **`reason`** read-only property of the CloseEvent interface returns the WebSocket connection close reason the server gave for closing the connection; that is, a concise human-readable prose explanation for the closure.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/reason)\n */\n readonly reason: string;\n /**\n * The **`wasClean`** read-only property of the CloseEvent interface returns `true` if the connection closed cleanly.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/wasClean)\n */\n readonly wasClean: boolean;\n}\ninterface CloseEventInit {\n code?: number;\n reason?: string;\n wasClean?: boolean;\n}\ntype WebSocketEventMap = {\n close: CloseEvent;\n message: MessageEvent;\n open: Event;\n error: ErrorEvent;\n};\n/**\n * The `WebSocket` object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)\n */\ndeclare var WebSocket: {\n prototype: WebSocket;\n new (url: string, protocols?: (string[] | string)): WebSocket;\n readonly READY_STATE_CONNECTING: number;\n readonly CONNECTING: number;\n readonly READY_STATE_OPEN: number;\n readonly OPEN: number;\n readonly READY_STATE_CLOSING: number;\n readonly CLOSING: number;\n readonly READY_STATE_CLOSED: number;\n readonly CLOSED: number;\n};\n/**\n * The `WebSocket` object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)\n */\ninterface WebSocket extends EventTarget {\n accept(): void;\n /**\n * The **`WebSocket.send()`** method enqueues the specified data to be transmitted to the server over the WebSocket connection, increasing the value of `bufferedAmount` by the number of bytes needed to contain the data.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/send)\n */\n send(message: (ArrayBuffer | ArrayBufferView) | string): void;\n /**\n * The **`WebSocket.close()`** method closes the already `CLOSED`, this method does nothing.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/close)\n */\n close(code?: number, reason?: string): void;\n serializeAttachment(attachment: any): void;\n deserializeAttachment(): any | null;\n /**\n * The **`WebSocket.readyState`** read-only property returns the current state of the WebSocket connection.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/readyState)\n */\n readyState: number;\n /**\n * The **`WebSocket.url`** read-only property returns the absolute URL of the WebSocket as resolved by the constructor.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/url)\n */\n url: string | null;\n /**\n * The **`WebSocket.protocol`** read-only property returns the name of the sub-protocol the server selected; this will be one of the strings specified in the `protocols` parameter when creating the WebSocket object, or the empty string if no connection is established.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/protocol)\n */\n protocol: string | null;\n /**\n * The **`WebSocket.extensions`** read-only property returns the extensions selected by the server.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/extensions)\n */\n extensions: string | null;\n}\ndeclare const WebSocketPair: {\n new (): {\n 0: WebSocket;\n 1: WebSocket;\n };\n};\ninterface SqlStorage {\n exec>(query: string, ...bindings: any[]): SqlStorageCursor;\n get databaseSize(): number;\n Cursor: typeof SqlStorageCursor;\n Statement: typeof SqlStorageStatement;\n}\ndeclare abstract class SqlStorageStatement {\n}\ntype SqlStorageValue = ArrayBuffer | string | number | null;\ndeclare abstract class SqlStorageCursor> {\n next(): {\n done?: false;\n value: T;\n } | {\n done: true;\n value?: never;\n };\n toArray(): T[];\n one(): T;\n raw(): IterableIterator;\n columnNames: string[];\n get rowsRead(): number;\n get rowsWritten(): number;\n [Symbol.iterator](): IterableIterator;\n}\ninterface Socket {\n get readable(): ReadableStream;\n get writable(): WritableStream;\n get closed(): Promise;\n get opened(): Promise;\n get upgraded(): boolean;\n get secureTransport(): \"on\" | \"off\" | \"starttls\";\n close(): Promise;\n startTls(options?: TlsOptions): Socket;\n}\ninterface SocketOptions {\n secureTransport?: string;\n allowHalfOpen: boolean;\n highWaterMark?: (number | bigint);\n}\ninterface SocketAddress {\n hostname: string;\n port: number;\n}\ninterface TlsOptions {\n expectedServerHostname?: string;\n}\ninterface SocketInfo {\n remoteAddress?: string;\n localAddress?: string;\n}\n/**\n * The **`EventSource`** interface is web content's interface to server-sent events.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource)\n */\ndeclare class EventSource extends EventTarget {\n constructor(url: string, init?: EventSourceEventSourceInit);\n /**\n * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the ```js-nolint close() ``` None.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/close)\n */\n close(): void;\n /**\n * The **`url`** read-only property of the URL of the source.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/url)\n */\n get url(): string;\n /**\n * The **`withCredentials`** read-only property of the the `EventSource` object was instantiated with CORS credentials set.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/withCredentials)\n */\n get withCredentials(): boolean;\n /**\n * The **`readyState`** read-only property of the connection.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/readyState)\n */\n get readyState(): number;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/open_event) */\n get onopen(): any | null;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/open_event) */\n set onopen(value: any | null);\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/message_event) */\n get onmessage(): any | null;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/message_event) */\n set onmessage(value: any | null);\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/error_event) */\n get onerror(): any | null;\n /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/error_event) */\n set onerror(value: any | null);\n static readonly CONNECTING: number;\n static readonly OPEN: number;\n static readonly CLOSED: number;\n static from(stream: ReadableStream): EventSource;\n}\ninterface EventSourceEventSourceInit {\n withCredentials?: boolean;\n fetcher?: Fetcher;\n}\ninterface Container {\n get running(): boolean;\n start(options?: ContainerStartupOptions): void;\n monitor(): Promise;\n destroy(error?: any): Promise;\n signal(signo: number): void;\n getTcpPort(port: number): Fetcher;\n setInactivityTimeout(durationMs: number | bigint): Promise;\n}\ninterface ContainerStartupOptions {\n entrypoint?: string[];\n enableInternet: boolean;\n env?: Record;\n hardTimeout?: (number | bigint);\n}\n/**\n * The **`MessagePort`** interface of the Channel Messaging API represents one of the two ports of a MessageChannel, allowing messages to be sent from one port and listening out for them arriving at the other.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort)\n */\ndeclare abstract class MessagePort extends EventTarget {\n /**\n * The **`postMessage()`** method of the transfers ownership of objects to other browsing contexts.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/postMessage)\n */\n postMessage(data?: any, options?: (any[] | MessagePortPostMessageOptions)): void;\n /**\n * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close)\n */\n close(): void;\n /**\n * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start)\n */\n start(): void;\n get onmessage(): any | null;\n set onmessage(value: any | null);\n}\n/**\n * The **`MessageChannel`** interface of the Channel Messaging API allows us to create a new message channel and send data through it via its two MessagePort properties.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel)\n */\ndeclare class MessageChannel {\n constructor();\n /**\n * The **`port1`** read-only property of the the port attached to the context that originated the channel.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port1)\n */\n readonly port1: MessagePort;\n /**\n * The **`port2`** read-only property of the the port attached to the context at the other end of the channel, which the message is initially sent to.\n *\n * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port2)\n */\n readonly port2: MessagePort;\n}\ninterface MessagePortPostMessageOptions {\n transfer?: any[];\n}\ntype LoopbackForExport Rpc.EntrypointBranded) | ExportedHandler | undefined = undefined> = T extends new (...args: any[]) => Rpc.WorkerEntrypointBranded ? LoopbackServiceStub> : T extends new (...args: any[]) => Rpc.DurableObjectBranded ? LoopbackDurableObjectClass> : T extends ExportedHandler ? LoopbackServiceStub : undefined;\ntype LoopbackServiceStub = Fetcher & (T extends CloudflareWorkersModule.WorkerEntrypoint ? (opts: {\n props?: Props;\n}) => Fetcher : (opts: {\n props?: any;\n}) => Fetcher);\ntype LoopbackDurableObjectClass = DurableObjectClass & (T extends CloudflareWorkersModule.DurableObject ? (opts: {\n props?: Props;\n}) => DurableObjectClass : (opts: {\n props?: any;\n}) => DurableObjectClass);\ninterface SyncKvStorage {\n get(key: string): T | undefined;\n list(options?: SyncKvListOptions): Iterable<[\n string,\n T\n ]>;\n put(key: string, value: T): void;\n delete(key: string): boolean;\n}\ninterface SyncKvListOptions {\n start?: string;\n startAfter?: string;\n end?: string;\n prefix?: string;\n reverse?: boolean;\n limit?: number;\n}\ninterface WorkerStub {\n getEntrypoint(name?: string, options?: WorkerStubEntrypointOptions): Fetcher;\n}\ninterface WorkerStubEntrypointOptions {\n props?: any;\n}\ninterface WorkerLoader {\n get(name: string | null, getCode: () => WorkerLoaderWorkerCode | Promise): WorkerStub;\n}\ninterface WorkerLoaderModule {\n js?: string;\n cjs?: string;\n text?: string;\n data?: ArrayBuffer;\n json?: any;\n py?: string;\n wasm?: ArrayBuffer;\n}\ninterface WorkerLoaderWorkerCode {\n compatibilityDate: string;\n compatibilityFlags?: string[];\n allowExperimental?: boolean;\n mainModule: string;\n modules: Record;\n env?: any;\n globalOutbound?: (Fetcher | null);\n tails?: Fetcher[];\n streamingTails?: Fetcher[];\n}\n/**\n* The Workers runtime supports a subset of the Performance API, used to measure timing and performance,\n* as well as timing of subrequests and other operations.\n*\n* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/)\n*/\ndeclare abstract class Performance {\n /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/#performancetimeorigin) */\n get timeOrigin(): number;\n /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/#performancenow) */\n now(): number;\n}\ntype AiImageClassificationInput = {\n image: number[];\n};\ntype AiImageClassificationOutput = {\n score?: number;\n label?: string;\n}[];\ndeclare abstract class BaseAiImageClassification {\n inputs: AiImageClassificationInput;\n postProcessedOutputs: AiImageClassificationOutput;\n}\ntype AiImageToTextInput = {\n image: number[];\n prompt?: string;\n max_tokens?: number;\n temperature?: number;\n top_p?: number;\n top_k?: number;\n seed?: number;\n repetition_penalty?: number;\n frequency_penalty?: number;\n presence_penalty?: number;\n raw?: boolean;\n messages?: RoleScopedChatInput[];\n};\ntype AiImageToTextOutput = {\n description: string;\n};\ndeclare abstract class BaseAiImageToText {\n inputs: AiImageToTextInput;\n postProcessedOutputs: AiImageToTextOutput;\n}\ntype AiImageTextToTextInput = {\n image: string;\n prompt?: string;\n max_tokens?: number;\n temperature?: number;\n ignore_eos?: boolean;\n top_p?: number;\n top_k?: number;\n seed?: number;\n repetition_penalty?: number;\n frequency_penalty?: number;\n presence_penalty?: number;\n raw?: boolean;\n messages?: RoleScopedChatInput[];\n};\ntype AiImageTextToTextOutput = {\n description: string;\n};\ndeclare abstract class BaseAiImageTextToText {\n inputs: AiImageTextToTextInput;\n postProcessedOutputs: AiImageTextToTextOutput;\n}\ntype AiMultimodalEmbeddingsInput = {\n image: string;\n text: string[];\n};\ntype AiIMultimodalEmbeddingsOutput = {\n data: number[][];\n shape: number[];\n};\ndeclare abstract class BaseAiMultimodalEmbeddings {\n inputs: AiImageTextToTextInput;\n postProcessedOutputs: AiImageTextToTextOutput;\n}\ntype AiObjectDetectionInput = {\n image: number[];\n};\ntype AiObjectDetectionOutput = {\n score?: number;\n label?: string;\n}[];\ndeclare abstract class BaseAiObjectDetection {\n inputs: AiObjectDetectionInput;\n postProcessedOutputs: AiObjectDetectionOutput;\n}\ntype AiSentenceSimilarityInput = {\n source: string;\n sentences: string[];\n};\ntype AiSentenceSimilarityOutput = number[];\ndeclare abstract class BaseAiSentenceSimilarity {\n inputs: AiSentenceSimilarityInput;\n postProcessedOutputs: AiSentenceSimilarityOutput;\n}\ntype AiAutomaticSpeechRecognitionInput = {\n audio: number[];\n};\ntype AiAutomaticSpeechRecognitionOutput = {\n text?: string;\n words?: {\n word: string;\n start: number;\n end: number;\n }[];\n vtt?: string;\n};\ndeclare abstract class BaseAiAutomaticSpeechRecognition {\n inputs: AiAutomaticSpeechRecognitionInput;\n postProcessedOutputs: AiAutomaticSpeechRecognitionOutput;\n}\ntype AiSummarizationInput = {\n input_text: string;\n max_length?: number;\n};\ntype AiSummarizationOutput = {\n summary: string;\n};\ndeclare abstract class BaseAiSummarization {\n inputs: AiSummarizationInput;\n postProcessedOutputs: AiSummarizationOutput;\n}\ntype AiTextClassificationInput = {\n text: string;\n};\ntype AiTextClassificationOutput = {\n score?: number;\n label?: string;\n}[];\ndeclare abstract class BaseAiTextClassification {\n inputs: AiTextClassificationInput;\n postProcessedOutputs: AiTextClassificationOutput;\n}\ntype AiTextEmbeddingsInput = {\n text: string | string[];\n};\ntype AiTextEmbeddingsOutput = {\n shape: number[];\n data: number[][];\n};\ndeclare abstract class BaseAiTextEmbeddings {\n inputs: AiTextEmbeddingsInput;\n postProcessedOutputs: AiTextEmbeddingsOutput;\n}\ntype RoleScopedChatInput = {\n role: \"user\" | \"assistant\" | \"system\" | \"tool\" | (string & NonNullable);\n content: string;\n name?: string;\n};\ntype AiTextGenerationToolLegacyInput = {\n name: string;\n description: string;\n parameters?: {\n type: \"object\" | (string & NonNullable);\n properties: {\n [key: string]: {\n type: string;\n description?: string;\n };\n };\n required: string[];\n };\n};\ntype AiTextGenerationToolInput = {\n type: \"function\" | (string & NonNullable);\n function: {\n name: string;\n description: string;\n parameters?: {\n type: \"object\" | (string & NonNullable);\n properties: {\n [key: string]: {\n type: string;\n description?: string;\n };\n };\n required: string[];\n };\n };\n};\ntype AiTextGenerationFunctionsInput = {\n name: string;\n code: string;\n};\ntype AiTextGenerationResponseFormat = {\n type: string;\n json_schema?: any;\n};\ntype AiTextGenerationInput = {\n prompt?: string;\n raw?: boolean;\n stream?: boolean;\n max_tokens?: number;\n temperature?: number;\n top_p?: number;\n top_k?: number;\n seed?: number;\n repetition_penalty?: number;\n frequency_penalty?: number;\n presence_penalty?: number;\n messages?: RoleScopedChatInput[];\n response_format?: AiTextGenerationResponseFormat;\n tools?: AiTextGenerationToolInput[] | AiTextGenerationToolLegacyInput[] | (object & NonNullable);\n functions?: AiTextGenerationFunctionsInput[];\n};\ntype AiTextGenerationToolLegacyOutput = {\n name: string;\n arguments: unknown;\n};\ntype AiTextGenerationToolOutput = {\n id: string;\n type: \"function\";\n function: {\n name: string;\n arguments: string;\n };\n};\ntype UsageTags = {\n prompt_tokens: number;\n completion_tokens: number;\n total_tokens: number;\n};\ntype AiTextGenerationOutput = {\n response?: string;\n tool_calls?: AiTextGenerationToolLegacyOutput[] & AiTextGenerationToolOutput[];\n usage?: UsageTags;\n};\ndeclare abstract class BaseAiTextGeneration {\n inputs: AiTextGenerationInput;\n postProcessedOutputs: AiTextGenerationOutput;\n}\ntype AiTextToSpeechInput = {\n prompt: string;\n lang?: string;\n};\ntype AiTextToSpeechOutput = Uint8Array | {\n audio: string;\n};\ndeclare abstract class BaseAiTextToSpeech {\n inputs: AiTextToSpeechInput;\n postProcessedOutputs: AiTextToSpeechOutput;\n}\ntype AiTextToImageInput = {\n prompt: string;\n negative_prompt?: string;\n height?: number;\n width?: number;\n image?: number[];\n image_b64?: string;\n mask?: number[];\n num_steps?: number;\n strength?: number;\n guidance?: number;\n seed?: number;\n};\ntype AiTextToImageOutput = ReadableStream;\ndeclare abstract class BaseAiTextToImage {\n inputs: AiTextToImageInput;\n postProcessedOutputs: AiTextToImageOutput;\n}\ntype AiTranslationInput = {\n text: string;\n target_lang: string;\n source_lang?: string;\n};\ntype AiTranslationOutput = {\n translated_text?: string;\n};\ndeclare abstract class BaseAiTranslation {\n inputs: AiTranslationInput;\n postProcessedOutputs: AiTranslationOutput;\n}\n/**\n * Workers AI support for OpenAI's Responses API\n * Reference: https://github.com/openai/openai-node/blob/master/src/resources/responses/responses.ts\n *\n * It's a stripped down version from its source.\n * It currently supports basic function calling, json mode and accepts images as input.\n *\n * It does not include types for WebSearch, CodeInterpreter, FileInputs, MCP, CustomTools.\n * We plan to add those incrementally as model + platform capabilities evolve.\n */\ntype ResponsesInput = {\n background?: boolean | null;\n conversation?: string | ResponseConversationParam | null;\n include?: Array | null;\n input?: string | ResponseInput;\n instructions?: string | null;\n max_output_tokens?: number | null;\n parallel_tool_calls?: boolean | null;\n previous_response_id?: string | null;\n prompt_cache_key?: string;\n reasoning?: Reasoning | null;\n safety_identifier?: string;\n service_tier?: \"auto\" | \"default\" | \"flex\" | \"scale\" | \"priority\" | null;\n stream?: boolean | null;\n stream_options?: StreamOptions | null;\n temperature?: number | null;\n text?: ResponseTextConfig;\n tool_choice?: ToolChoiceOptions | ToolChoiceFunction;\n tools?: Array;\n top_p?: number | null;\n truncation?: \"auto\" | \"disabled\" | null;\n};\ntype ResponsesOutput = {\n id?: string;\n created_at?: number;\n output_text?: string;\n error?: ResponseError | null;\n incomplete_details?: ResponseIncompleteDetails | null;\n instructions?: string | Array | null;\n object?: \"response\";\n output?: Array;\n parallel_tool_calls?: boolean;\n temperature?: number | null;\n tool_choice?: ToolChoiceOptions | ToolChoiceFunction;\n tools?: Array;\n top_p?: number | null;\n max_output_tokens?: number | null;\n previous_response_id?: string | null;\n prompt?: ResponsePrompt | null;\n reasoning?: Reasoning | null;\n safety_identifier?: string;\n service_tier?: \"auto\" | \"default\" | \"flex\" | \"scale\" | \"priority\" | null;\n status?: ResponseStatus;\n text?: ResponseTextConfig;\n truncation?: \"auto\" | \"disabled\" | null;\n usage?: ResponseUsage;\n};\ntype EasyInputMessage = {\n content: string | ResponseInputMessageContentList;\n role: \"user\" | \"assistant\" | \"system\" | \"developer\";\n type?: \"message\";\n};\ntype ResponsesFunctionTool = {\n name: string;\n parameters: {\n [key: string]: unknown;\n } | null;\n strict: boolean | null;\n type: \"function\";\n description?: string | null;\n};\ntype ResponseIncompleteDetails = {\n reason?: \"max_output_tokens\" | \"content_filter\";\n};\ntype ResponsePrompt = {\n id: string;\n variables?: {\n [key: string]: string | ResponseInputText | ResponseInputImage;\n } | null;\n version?: string | null;\n};\ntype Reasoning = {\n effort?: ReasoningEffort | null;\n generate_summary?: \"auto\" | \"concise\" | \"detailed\" | null;\n summary?: \"auto\" | \"concise\" | \"detailed\" | null;\n};\ntype ResponseContent = ResponseInputText | ResponseInputImage | ResponseOutputText | ResponseOutputRefusal | ResponseContentReasoningText;\ntype ResponseContentReasoningText = {\n text: string;\n type: \"reasoning_text\";\n};\ntype ResponseConversationParam = {\n id: string;\n};\ntype ResponseCreatedEvent = {\n response: Response;\n sequence_number: number;\n type: \"response.created\";\n};\ntype ResponseCustomToolCallOutput = {\n call_id: string;\n output: string | Array;\n type: \"custom_tool_call_output\";\n id?: string;\n};\ntype ResponseError = {\n code: \"server_error\" | \"rate_limit_exceeded\" | \"invalid_prompt\" | \"vector_store_timeout\" | \"invalid_image\" | \"invalid_image_format\" | \"invalid_base64_image\" | \"invalid_image_url\" | \"image_too_large\" | \"image_too_small\" | \"image_parse_error\" | \"image_content_policy_violation\" | \"invalid_image_mode\" | \"image_file_too_large\" | \"unsupported_image_media_type\" | \"empty_image_file\" | \"failed_to_download_image\" | \"image_file_not_found\";\n message: string;\n};\ntype ResponseErrorEvent = {\n code: string | null;\n message: string;\n param: string | null;\n sequence_number: number;\n type: \"error\";\n};\ntype ResponseFailedEvent = {\n response: Response;\n sequence_number: number;\n type: \"response.failed\";\n};\ntype ResponseFormatText = {\n type: \"text\";\n};\ntype ResponseFormatJSONObject = {\n type: \"json_object\";\n};\ntype ResponseFormatTextConfig = ResponseFormatText | ResponseFormatTextJSONSchemaConfig | ResponseFormatJSONObject;\ntype ResponseFormatTextJSONSchemaConfig = {\n name: string;\n schema: {\n [key: string]: unknown;\n };\n type: \"json_schema\";\n description?: string;\n strict?: boolean | null;\n};\ntype ResponseFunctionCallArgumentsDeltaEvent = {\n delta: string;\n item_id: string;\n output_index: number;\n sequence_number: number;\n type: \"response.function_call_arguments.delta\";\n};\ntype ResponseFunctionCallArgumentsDoneEvent = {\n arguments: string;\n item_id: string;\n name: string;\n output_index: number;\n sequence_number: number;\n type: \"response.function_call_arguments.done\";\n};\ntype ResponseFunctionCallOutputItem = ResponseInputTextContent | ResponseInputImageContent;\ntype ResponseFunctionCallOutputItemList = Array;\ntype ResponseFunctionToolCall = {\n arguments: string;\n call_id: string;\n name: string;\n type: \"function_call\";\n id?: string;\n status?: \"in_progress\" | \"completed\" | \"incomplete\";\n};\ninterface ResponseFunctionToolCallItem extends ResponseFunctionToolCall {\n id: string;\n}\ntype ResponseFunctionToolCallOutputItem = {\n id: string;\n call_id: string;\n output: string | Array;\n type: \"function_call_output\";\n status?: \"in_progress\" | \"completed\" | \"incomplete\";\n};\ntype ResponseIncludable = \"message.input_image.image_url\" | \"message.output_text.logprobs\";\ntype ResponseIncompleteEvent = {\n response: Response;\n sequence_number: number;\n type: \"response.incomplete\";\n};\ntype ResponseInput = Array;\ntype ResponseInputContent = ResponseInputText | ResponseInputImage;\ntype ResponseInputImage = {\n detail: \"low\" | \"high\" | \"auto\";\n type: \"input_image\";\n /**\n * Base64 encoded image\n */\n image_url?: string | null;\n};\ntype ResponseInputImageContent = {\n type: \"input_image\";\n detail?: \"low\" | \"high\" | \"auto\" | null;\n /**\n * Base64 encoded image\n */\n image_url?: string | null;\n};\ntype ResponseInputItem = EasyInputMessage | ResponseInputItemMessage | ResponseOutputMessage | ResponseFunctionToolCall | ResponseInputItemFunctionCallOutput | ResponseReasoningItem;\ntype ResponseInputItemFunctionCallOutput = {\n call_id: string;\n output: string | ResponseFunctionCallOutputItemList;\n type: \"function_call_output\";\n id?: string | null;\n status?: \"in_progress\" | \"completed\" | \"incomplete\" | null;\n};\ntype ResponseInputItemMessage = {\n content: ResponseInputMessageContentList;\n role: \"user\" | \"system\" | \"developer\";\n status?: \"in_progress\" | \"completed\" | \"incomplete\";\n type?: \"message\";\n};\ntype ResponseInputMessageContentList = Array;\ntype ResponseInputMessageItem = {\n id: string;\n content: ResponseInputMessageContentList;\n role: \"user\" | \"system\" | \"developer\";\n status?: \"in_progress\" | \"completed\" | \"incomplete\";\n type?: \"message\";\n};\ntype ResponseInputText = {\n text: string;\n type: \"input_text\";\n};\ntype ResponseInputTextContent = {\n text: string;\n type: \"input_text\";\n};\ntype ResponseItem = ResponseInputMessageItem | ResponseOutputMessage | ResponseFunctionToolCallItem | ResponseFunctionToolCallOutputItem;\ntype ResponseOutputItem = ResponseOutputMessage | ResponseFunctionToolCall | ResponseReasoningItem;\ntype ResponseOutputItemAddedEvent = {\n item: ResponseOutputItem;\n output_index: number;\n sequence_number: number;\n type: \"response.output_item.added\";\n};\ntype ResponseOutputItemDoneEvent = {\n item: ResponseOutputItem;\n output_index: number;\n sequence_number: number;\n type: \"response.output_item.done\";\n};\ntype ResponseOutputMessage = {\n id: string;\n content: Array;\n role: \"assistant\";\n status: \"in_progress\" | \"completed\" | \"incomplete\";\n type: \"message\";\n};\ntype ResponseOutputRefusal = {\n refusal: string;\n type: \"refusal\";\n};\ntype ResponseOutputText = {\n text: string;\n type: \"output_text\";\n logprobs?: Array;\n};\ntype ResponseReasoningItem = {\n id: string;\n summary: Array;\n type: \"reasoning\";\n content?: Array;\n encrypted_content?: string | null;\n status?: \"in_progress\" | \"completed\" | \"incomplete\";\n};\ntype ResponseReasoningSummaryItem = {\n text: string;\n type: \"summary_text\";\n};\ntype ResponseReasoningContentItem = {\n text: string;\n type: \"reasoning_text\";\n};\ntype ResponseReasoningTextDeltaEvent = {\n content_index: number;\n delta: string;\n item_id: string;\n output_index: number;\n sequence_number: number;\n type: \"response.reasoning_text.delta\";\n};\ntype ResponseReasoningTextDoneEvent = {\n content_index: number;\n item_id: string;\n output_index: number;\n sequence_number: number;\n text: string;\n type: \"response.reasoning_text.done\";\n};\ntype ResponseRefusalDeltaEvent = {\n content_index: number;\n delta: string;\n item_id: string;\n output_index: number;\n sequence_number: number;\n type: \"response.refusal.delta\";\n};\ntype ResponseRefusalDoneEvent = {\n content_index: number;\n item_id: string;\n output_index: number;\n refusal: string;\n sequence_number: number;\n type: \"response.refusal.done\";\n};\ntype ResponseStatus = \"completed\" | \"failed\" | \"in_progress\" | \"cancelled\" | \"queued\" | \"incomplete\";\ntype ResponseStreamEvent = ResponseCompletedEvent | ResponseCreatedEvent | ResponseErrorEvent | ResponseFunctionCallArgumentsDeltaEvent | ResponseFunctionCallArgumentsDoneEvent | ResponseFailedEvent | ResponseIncompleteEvent | ResponseOutputItemAddedEvent | ResponseOutputItemDoneEvent | ResponseReasoningTextDeltaEvent | ResponseReasoningTextDoneEvent | ResponseRefusalDeltaEvent | ResponseRefusalDoneEvent | ResponseTextDeltaEvent | ResponseTextDoneEvent;\ntype ResponseCompletedEvent = {\n response: Response;\n sequence_number: number;\n type: \"response.completed\";\n};\ntype ResponseTextConfig = {\n format?: ResponseFormatTextConfig;\n verbosity?: \"low\" | \"medium\" | \"high\" | null;\n};\ntype ResponseTextDeltaEvent = {\n content_index: number;\n delta: string;\n item_id: string;\n logprobs: Array;\n output_index: number;\n sequence_number: number;\n type: \"response.output_text.delta\";\n};\ntype ResponseTextDoneEvent = {\n content_index: number;\n item_id: string;\n logprobs: Array;\n output_index: number;\n sequence_number: number;\n text: string;\n type: \"response.output_text.done\";\n};\ntype Logprob = {\n token: string;\n logprob: number;\n top_logprobs?: Array;\n};\ntype TopLogprob = {\n token?: string;\n logprob?: number;\n};\ntype ResponseUsage = {\n input_tokens: number;\n output_tokens: number;\n total_tokens: number;\n};\ntype Tool = ResponsesFunctionTool;\ntype ToolChoiceFunction = {\n name: string;\n type: \"function\";\n};\ntype ToolChoiceOptions = \"none\";\ntype ReasoningEffort = \"minimal\" | \"low\" | \"medium\" | \"high\" | null;\ntype StreamOptions = {\n include_obfuscation?: boolean;\n};\ntype Ai_Cf_Baai_Bge_Base_En_V1_5_Input = {\n text: string | string[];\n /**\n * The pooling method used in the embedding process. `cls` pooling will generate more accurate embeddings on larger inputs - however, embeddings created with cls pooling are not compatible with embeddings generated with mean pooling. The default pooling method is `mean` in order for this to not be a breaking change, but we highly suggest using the new `cls` pooling for better accuracy.\n */\n pooling?: \"mean\" | \"cls\";\n} | {\n /**\n * Batch of the embeddings requests to run using async-queue\n */\n requests: {\n text: string | string[];\n /**\n * The pooling method used in the embedding process. `cls` pooling will generate more accurate embeddings on larger inputs - however, embeddings created with cls pooling are not compatible with embeddings generated with mean pooling. The default pooling method is `mean` in order for this to not be a breaking change, but we highly suggest using the new `cls` pooling for better accuracy.\n */\n pooling?: \"mean\" | \"cls\";\n }[];\n};\ntype Ai_Cf_Baai_Bge_Base_En_V1_5_Output = {\n shape?: number[];\n /**\n * Embeddings of the requested text values\n */\n data?: number[][];\n /**\n * The pooling method used in the embedding process.\n */\n pooling?: \"mean\" | \"cls\";\n} | Ai_Cf_Baai_Bge_Base_En_V1_5_AsyncResponse;\ninterface Ai_Cf_Baai_Bge_Base_En_V1_5_AsyncResponse {\n /**\n * The async request id that can be used to obtain the results.\n */\n request_id?: string;\n}\ndeclare abstract class Base_Ai_Cf_Baai_Bge_Base_En_V1_5 {\n inputs: Ai_Cf_Baai_Bge_Base_En_V1_5_Input;\n postProcessedOutputs: Ai_Cf_Baai_Bge_Base_En_V1_5_Output;\n}\ntype Ai_Cf_Openai_Whisper_Input = string | {\n /**\n * An array of integers that represent the audio data constrained to 8-bit unsigned integer values\n */\n audio: number[];\n};\ninterface Ai_Cf_Openai_Whisper_Output {\n /**\n * The transcription\n */\n text: string;\n word_count?: number;\n words?: {\n word?: string;\n /**\n * The second this word begins in the recording\n */\n start?: number;\n /**\n * The ending second when the word completes\n */\n end?: number;\n }[];\n vtt?: string;\n}\ndeclare abstract class Base_Ai_Cf_Openai_Whisper {\n inputs: Ai_Cf_Openai_Whisper_Input;\n postProcessedOutputs: Ai_Cf_Openai_Whisper_Output;\n}\ntype Ai_Cf_Meta_M2M100_1_2B_Input = {\n /**\n * The text to be translated\n */\n text: string;\n /**\n * The language code of the source text (e.g., 'en' for English). Defaults to 'en' if not specified\n */\n source_lang?: string;\n /**\n * The language code to translate the text into (e.g., 'es' for Spanish)\n */\n target_lang: string;\n} | {\n /**\n * Batch of the embeddings requests to run using async-queue\n */\n requests: {\n /**\n * The text to be translated\n */\n text: string;\n /**\n * The language code of the source text (e.g., 'en' for English). Defaults to 'en' if not specified\n */\n source_lang?: string;\n /**\n * The language code to translate the text into (e.g., 'es' for Spanish)\n */\n target_lang: string;\n }[];\n};\ntype Ai_Cf_Meta_M2M100_1_2B_Output = {\n /**\n * The translated text in the target language\n */\n translated_text?: string;\n} | Ai_Cf_Meta_M2M100_1_2B_AsyncResponse;\ninterface Ai_Cf_Meta_M2M100_1_2B_AsyncResponse {\n /**\n * The async request id that can be used to obtain the results.\n */\n request_id?: string;\n}\ndeclare abstract class Base_Ai_Cf_Meta_M2M100_1_2B {\n inputs: Ai_Cf_Meta_M2M100_1_2B_Input;\n postProcessedOutputs: Ai_Cf_Meta_M2M100_1_2B_Output;\n}\ntype Ai_Cf_Baai_Bge_Small_En_V1_5_Input = {\n text: string | string[];\n /**\n * The pooling method used in the embedding process. `cls` pooling will generate more accurate embeddings on larger inputs - however, embeddings created with cls pooling are not compatible with embeddings generated with mean pooling. The default pooling method is `mean` in order for this to not be a breaking change, but we highly suggest using the new `cls` pooling for better accuracy.\n */\n pooling?: \"mean\" | \"cls\";\n} | {\n /**\n * Batch of the embeddings requests to run using async-queue\n */\n requests: {\n text: string | string[];\n /**\n * The pooling method used in the embedding process. `cls` pooling will generate more accurate embeddings on larger inputs - however, embeddings created with cls pooling are not compatible with embeddings generated with mean pooling. The default pooling method is `mean` in order for this to not be a breaking change, but we highly suggest using the new `cls` pooling for better accuracy.\n */\n pooling?: \"mean\" | \"cls\";\n }[];\n};\ntype Ai_Cf_Baai_Bge_Small_En_V1_5_Output = {\n shape?: number[];\n /**\n * Embeddings of the requested text values\n */\n data?: number[][];\n /**\n * The pooling method used in the embedding process.\n */\n pooling?: \"mean\" | \"cls\";\n} | Ai_Cf_Baai_Bge_Small_En_V1_5_AsyncResponse;\ninterface Ai_Cf_Baai_Bge_Small_En_V1_5_AsyncResponse {\n /**\n * The async request id that can be used to obtain the results.\n */\n request_id?: string;\n}\ndeclare abstract class Base_Ai_Cf_Baai_Bge_Small_En_V1_5 {\n inputs: Ai_Cf_Baai_Bge_Small_En_V1_5_Input;\n postProcessedOutputs: Ai_Cf_Baai_Bge_Small_En_V1_5_Output;\n}\ntype Ai_Cf_Baai_Bge_Large_En_V1_5_Input = {\n text: string | string[];\n /**\n * The pooling method used in the embedding process. `cls` pooling will generate more accurate embeddings on larger inputs - however, embeddings created with cls pooling are not compatible with embeddings generated with mean pooling. The default pooling method is `mean` in order for this to not be a breaking change, but we highly suggest using the new `cls` pooling for better accuracy.\n */\n pooling?: \"mean\" | \"cls\";\n} | {\n /**\n * Batch of the embeddings requests to run using async-queue\n */\n requests: {\n text: string | string[];\n /**\n * The pooling method used in the embedding process. `cls` pooling will generate more accurate embeddings on larger inputs - however, embeddings created with cls pooling are not compatible with embeddings generated with mean pooling. The default pooling method is `mean` in order for this to not be a breaking change, but we highly suggest using the new `cls` pooling for better accuracy.\n */\n pooling?: \"mean\" | \"cls\";\n }[];\n};\ntype Ai_Cf_Baai_Bge_Large_En_V1_5_Output = {\n shape?: number[];\n /**\n * Embeddings of the requested text values\n */\n data?: number[][];\n /**\n * The pooling method used in the embedding process.\n */\n pooling?: \"mean\" | \"cls\";\n} | Ai_Cf_Baai_Bge_Large_En_V1_5_AsyncResponse;\ninterface Ai_Cf_Baai_Bge_Large_En_V1_5_AsyncResponse {\n /**\n * The async request id that can be used to obtain the results.\n */\n request_id?: string;\n}\ndeclare abstract class Base_Ai_Cf_Baai_Bge_Large_En_V1_5 {\n inputs: Ai_Cf_Baai_Bge_Large_En_V1_5_Input;\n postProcessedOutputs: Ai_Cf_Baai_Bge_Large_En_V1_5_Output;\n}\ntype Ai_Cf_Unum_Uform_Gen2_Qwen_500M_Input = string | {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt?: string;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * Controls the creativity of the AI's responses by adjusting how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n image: number[] | (string & NonNullable);\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n};\ninterface Ai_Cf_Unum_Uform_Gen2_Qwen_500M_Output {\n description?: string;\n}\ndeclare abstract class Base_Ai_Cf_Unum_Uform_Gen2_Qwen_500M {\n inputs: Ai_Cf_Unum_Uform_Gen2_Qwen_500M_Input;\n postProcessedOutputs: Ai_Cf_Unum_Uform_Gen2_Qwen_500M_Output;\n}\ntype Ai_Cf_Openai_Whisper_Tiny_En_Input = string | {\n /**\n * An array of integers that represent the audio data constrained to 8-bit unsigned integer values\n */\n audio: number[];\n};\ninterface Ai_Cf_Openai_Whisper_Tiny_En_Output {\n /**\n * The transcription\n */\n text: string;\n word_count?: number;\n words?: {\n word?: string;\n /**\n * The second this word begins in the recording\n */\n start?: number;\n /**\n * The ending second when the word completes\n */\n end?: number;\n }[];\n vtt?: string;\n}\ndeclare abstract class Base_Ai_Cf_Openai_Whisper_Tiny_En {\n inputs: Ai_Cf_Openai_Whisper_Tiny_En_Input;\n postProcessedOutputs: Ai_Cf_Openai_Whisper_Tiny_En_Output;\n}\ninterface Ai_Cf_Openai_Whisper_Large_V3_Turbo_Input {\n /**\n * Base64 encoded value of the audio data.\n */\n audio: string;\n /**\n * Supported tasks are 'translate' or 'transcribe'.\n */\n task?: string;\n /**\n * The language of the audio being transcribed or translated.\n */\n language?: string;\n /**\n * Preprocess the audio with a voice activity detection model.\n */\n vad_filter?: boolean;\n /**\n * A text prompt to help provide context to the model on the contents of the audio.\n */\n initial_prompt?: string;\n /**\n * The prefix it appended the the beginning of the output of the transcription and can guide the transcription result.\n */\n prefix?: string;\n}\ninterface Ai_Cf_Openai_Whisper_Large_V3_Turbo_Output {\n transcription_info?: {\n /**\n * The language of the audio being transcribed or translated.\n */\n language?: string;\n /**\n * The confidence level or probability of the detected language being accurate, represented as a decimal between 0 and 1.\n */\n language_probability?: number;\n /**\n * The total duration of the original audio file, in seconds.\n */\n duration?: number;\n /**\n * The duration of the audio after applying Voice Activity Detection (VAD) to remove silent or irrelevant sections, in seconds.\n */\n duration_after_vad?: number;\n };\n /**\n * The complete transcription of the audio.\n */\n text: string;\n /**\n * The total number of words in the transcription.\n */\n word_count?: number;\n segments?: {\n /**\n * The starting time of the segment within the audio, in seconds.\n */\n start?: number;\n /**\n * The ending time of the segment within the audio, in seconds.\n */\n end?: number;\n /**\n * The transcription of the segment.\n */\n text?: string;\n /**\n * The temperature used in the decoding process, controlling randomness in predictions. Lower values result in more deterministic outputs.\n */\n temperature?: number;\n /**\n * The average log probability of the predictions for the words in this segment, indicating overall confidence.\n */\n avg_logprob?: number;\n /**\n * The compression ratio of the input to the output, measuring how much the text was compressed during the transcription process.\n */\n compression_ratio?: number;\n /**\n * The probability that the segment contains no speech, represented as a decimal between 0 and 1.\n */\n no_speech_prob?: number;\n words?: {\n /**\n * The individual word transcribed from the audio.\n */\n word?: string;\n /**\n * The starting time of the word within the audio, in seconds.\n */\n start?: number;\n /**\n * The ending time of the word within the audio, in seconds.\n */\n end?: number;\n }[];\n }[];\n /**\n * The transcription in WebVTT format, which includes timing and text information for use in subtitles.\n */\n vtt?: string;\n}\ndeclare abstract class Base_Ai_Cf_Openai_Whisper_Large_V3_Turbo {\n inputs: Ai_Cf_Openai_Whisper_Large_V3_Turbo_Input;\n postProcessedOutputs: Ai_Cf_Openai_Whisper_Large_V3_Turbo_Output;\n}\ntype Ai_Cf_Baai_Bge_M3_Input = Ai_Cf_Baai_Bge_M3_Input_QueryAnd_Contexts | Ai_Cf_Baai_Bge_M3_Input_Embedding | {\n /**\n * Batch of the embeddings requests to run using async-queue\n */\n requests: (Ai_Cf_Baai_Bge_M3_Input_QueryAnd_Contexts_1 | Ai_Cf_Baai_Bge_M3_Input_Embedding_1)[];\n};\ninterface Ai_Cf_Baai_Bge_M3_Input_QueryAnd_Contexts {\n /**\n * A query you wish to perform against the provided contexts. If no query is provided the model with respond with embeddings for contexts\n */\n query?: string;\n /**\n * List of provided contexts. Note that the index in this array is important, as the response will refer to it.\n */\n contexts: {\n /**\n * One of the provided context content\n */\n text?: string;\n }[];\n /**\n * When provided with too long context should the model error out or truncate the context to fit?\n */\n truncate_inputs?: boolean;\n}\ninterface Ai_Cf_Baai_Bge_M3_Input_Embedding {\n text: string | string[];\n /**\n * When provided with too long context should the model error out or truncate the context to fit?\n */\n truncate_inputs?: boolean;\n}\ninterface Ai_Cf_Baai_Bge_M3_Input_QueryAnd_Contexts_1 {\n /**\n * A query you wish to perform against the provided contexts. If no query is provided the model with respond with embeddings for contexts\n */\n query?: string;\n /**\n * List of provided contexts. Note that the index in this array is important, as the response will refer to it.\n */\n contexts: {\n /**\n * One of the provided context content\n */\n text?: string;\n }[];\n /**\n * When provided with too long context should the model error out or truncate the context to fit?\n */\n truncate_inputs?: boolean;\n}\ninterface Ai_Cf_Baai_Bge_M3_Input_Embedding_1 {\n text: string | string[];\n /**\n * When provided with too long context should the model error out or truncate the context to fit?\n */\n truncate_inputs?: boolean;\n}\ntype Ai_Cf_Baai_Bge_M3_Output = Ai_Cf_Baai_Bge_M3_Ouput_Query | Ai_Cf_Baai_Bge_M3_Output_EmbeddingFor_Contexts | Ai_Cf_Baai_Bge_M3_Ouput_Embedding | Ai_Cf_Baai_Bge_M3_AsyncResponse;\ninterface Ai_Cf_Baai_Bge_M3_Ouput_Query {\n response?: {\n /**\n * Index of the context in the request\n */\n id?: number;\n /**\n * Score of the context under the index.\n */\n score?: number;\n }[];\n}\ninterface Ai_Cf_Baai_Bge_M3_Output_EmbeddingFor_Contexts {\n response?: number[][];\n shape?: number[];\n /**\n * The pooling method used in the embedding process.\n */\n pooling?: \"mean\" | \"cls\";\n}\ninterface Ai_Cf_Baai_Bge_M3_Ouput_Embedding {\n shape?: number[];\n /**\n * Embeddings of the requested text values\n */\n data?: number[][];\n /**\n * The pooling method used in the embedding process.\n */\n pooling?: \"mean\" | \"cls\";\n}\ninterface Ai_Cf_Baai_Bge_M3_AsyncResponse {\n /**\n * The async request id that can be used to obtain the results.\n */\n request_id?: string;\n}\ndeclare abstract class Base_Ai_Cf_Baai_Bge_M3 {\n inputs: Ai_Cf_Baai_Bge_M3_Input;\n postProcessedOutputs: Ai_Cf_Baai_Bge_M3_Output;\n}\ninterface Ai_Cf_Black_Forest_Labs_Flux_1_Schnell_Input {\n /**\n * A text description of the image you want to generate.\n */\n prompt: string;\n /**\n * The number of diffusion steps; higher values can improve quality but take longer.\n */\n steps?: number;\n}\ninterface Ai_Cf_Black_Forest_Labs_Flux_1_Schnell_Output {\n /**\n * The generated image in Base64 format.\n */\n image?: string;\n}\ndeclare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_1_Schnell {\n inputs: Ai_Cf_Black_Forest_Labs_Flux_1_Schnell_Input;\n postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_1_Schnell_Output;\n}\ntype Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct_Input = Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct_Prompt | Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct_Messages;\ninterface Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct_Prompt {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n image?: number[] | (string & NonNullable);\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n /**\n * Name of the LoRA (Low-Rank Adaptation) model to fine-tune the base model.\n */\n lora?: string;\n}\ninterface Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct_Messages {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role?: string;\n /**\n * The tool call id. Must be supplied for tool calls for Mistral-3. If you don't know what to put here you can fall back to 000000001\n */\n tool_call_id?: string;\n content?: string | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n }[] | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n };\n }[];\n image?: number[] | (string & NonNullable);\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n /**\n * If true, the response will be streamed back incrementally.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Controls the creativity of the AI's responses by adjusting how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ntype Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct_Output = {\n /**\n * The generated text response from the model\n */\n response?: string;\n /**\n * An array of tool calls requests made during the response generation\n */\n tool_calls?: {\n /**\n * The arguments passed to be passed to the tool call request\n */\n arguments?: object;\n /**\n * The name of the tool to be called\n */\n name?: string;\n }[];\n};\ndeclare abstract class Base_Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct {\n inputs: Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct_Input;\n postProcessedOutputs: Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct_Output;\n}\ntype Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Input = Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Prompt | Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Messages | Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Async_Batch;\ninterface Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Prompt {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * Name of the LoRA (Low-Rank Adaptation) model to fine-tune the base model.\n */\n lora?: string;\n response_format?: Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_JSON_Mode;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_JSON_Mode {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ninterface Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Messages {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role: string;\n /**\n * The content of the message as a string.\n */\n content: string;\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n response_format?: Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_JSON_Mode_1;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_JSON_Mode_1 {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ninterface Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Async_Batch {\n requests?: {\n /**\n * User-supplied reference. This field will be present in the response as well it can be used to reference the request and response. It's NOT validated to be unique.\n */\n external_reference?: string;\n /**\n * Prompt for the text generation model\n */\n prompt?: string;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n response_format?: Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_JSON_Mode_2;\n }[];\n}\ninterface Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_JSON_Mode_2 {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ntype Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Output = {\n /**\n * The generated text response from the model\n */\n response: string;\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n /**\n * An array of tool calls requests made during the response generation\n */\n tool_calls?: {\n /**\n * The arguments passed to be passed to the tool call request\n */\n arguments?: object;\n /**\n * The name of the tool to be called\n */\n name?: string;\n }[];\n} | string | Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_AsyncResponse;\ninterface Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_AsyncResponse {\n /**\n * The async request id that can be used to obtain the results.\n */\n request_id?: string;\n}\ndeclare abstract class Base_Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast {\n inputs: Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Input;\n postProcessedOutputs: Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Output;\n}\ninterface Ai_Cf_Meta_Llama_Guard_3_8B_Input {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender must alternate between 'user' and 'assistant'.\n */\n role: \"user\" | \"assistant\";\n /**\n * The content of the message as a string.\n */\n content: string;\n }[];\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Dictate the output format of the generated response.\n */\n response_format?: {\n /**\n * Set to json_object to process and output generated text as JSON.\n */\n type?: string;\n };\n}\ninterface Ai_Cf_Meta_Llama_Guard_3_8B_Output {\n response?: string | {\n /**\n * Whether the conversation is safe or not.\n */\n safe?: boolean;\n /**\n * A list of what hazard categories predicted for the conversation, if the conversation is deemed unsafe.\n */\n categories?: string[];\n };\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n}\ndeclare abstract class Base_Ai_Cf_Meta_Llama_Guard_3_8B {\n inputs: Ai_Cf_Meta_Llama_Guard_3_8B_Input;\n postProcessedOutputs: Ai_Cf_Meta_Llama_Guard_3_8B_Output;\n}\ninterface Ai_Cf_Baai_Bge_Reranker_Base_Input {\n /**\n * A query you wish to perform against the provided contexts.\n */\n /**\n * Number of returned results starting with the best score.\n */\n top_k?: number;\n /**\n * List of provided contexts. Note that the index in this array is important, as the response will refer to it.\n */\n contexts: {\n /**\n * One of the provided context content\n */\n text?: string;\n }[];\n}\ninterface Ai_Cf_Baai_Bge_Reranker_Base_Output {\n response?: {\n /**\n * Index of the context in the request\n */\n id?: number;\n /**\n * Score of the context under the index.\n */\n score?: number;\n }[];\n}\ndeclare abstract class Base_Ai_Cf_Baai_Bge_Reranker_Base {\n inputs: Ai_Cf_Baai_Bge_Reranker_Base_Input;\n postProcessedOutputs: Ai_Cf_Baai_Bge_Reranker_Base_Output;\n}\ntype Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_Input = Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_Prompt | Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_Messages;\ninterface Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_Prompt {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * Name of the LoRA (Low-Rank Adaptation) model to fine-tune the base model.\n */\n lora?: string;\n response_format?: Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_JSON_Mode;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_JSON_Mode {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ninterface Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_Messages {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role: string;\n /**\n * The content of the message as a string.\n */\n content: string;\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n response_format?: Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_JSON_Mode_1;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_JSON_Mode_1 {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ntype Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_Output = {\n /**\n * The generated text response from the model\n */\n response: string;\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n /**\n * An array of tool calls requests made during the response generation\n */\n tool_calls?: {\n /**\n * The arguments passed to be passed to the tool call request\n */\n arguments?: object;\n /**\n * The name of the tool to be called\n */\n name?: string;\n }[];\n};\ndeclare abstract class Base_Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct {\n inputs: Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_Input;\n postProcessedOutputs: Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_Output;\n}\ntype Ai_Cf_Qwen_Qwq_32B_Input = Ai_Cf_Qwen_Qwq_32B_Prompt | Ai_Cf_Qwen_Qwq_32B_Messages;\ninterface Ai_Cf_Qwen_Qwq_32B_Prompt {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * JSON schema that should be fulfilled for the response.\n */\n guided_json?: object;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Qwen_Qwq_32B_Messages {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role?: string;\n /**\n * The tool call id. Must be supplied for tool calls for Mistral-3. If you don't know what to put here you can fall back to 000000001\n */\n tool_call_id?: string;\n content?: string | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n }[] | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n };\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n /**\n * JSON schema that should be fufilled for the response.\n */\n guided_json?: object;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ntype Ai_Cf_Qwen_Qwq_32B_Output = {\n /**\n * The generated text response from the model\n */\n response: string;\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n /**\n * An array of tool calls requests made during the response generation\n */\n tool_calls?: {\n /**\n * The arguments passed to be passed to the tool call request\n */\n arguments?: object;\n /**\n * The name of the tool to be called\n */\n name?: string;\n }[];\n};\ndeclare abstract class Base_Ai_Cf_Qwen_Qwq_32B {\n inputs: Ai_Cf_Qwen_Qwq_32B_Input;\n postProcessedOutputs: Ai_Cf_Qwen_Qwq_32B_Output;\n}\ntype Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Input = Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Prompt | Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Messages;\ninterface Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Prompt {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * JSON schema that should be fulfilled for the response.\n */\n guided_json?: object;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Messages {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role?: string;\n /**\n * The tool call id. Must be supplied for tool calls for Mistral-3. If you don't know what to put here you can fall back to 000000001\n */\n tool_call_id?: string;\n content?: string | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n }[] | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n };\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n /**\n * JSON schema that should be fufilled for the response.\n */\n guided_json?: object;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ntype Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Output = {\n /**\n * The generated text response from the model\n */\n response: string;\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n /**\n * An array of tool calls requests made during the response generation\n */\n tool_calls?: {\n /**\n * The arguments passed to be passed to the tool call request\n */\n arguments?: object;\n /**\n * The name of the tool to be called\n */\n name?: string;\n }[];\n};\ndeclare abstract class Base_Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct {\n inputs: Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Input;\n postProcessedOutputs: Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Output;\n}\ntype Ai_Cf_Google_Gemma_3_12B_It_Input = Ai_Cf_Google_Gemma_3_12B_It_Prompt | Ai_Cf_Google_Gemma_3_12B_It_Messages;\ninterface Ai_Cf_Google_Gemma_3_12B_It_Prompt {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * JSON schema that should be fufilled for the response.\n */\n guided_json?: object;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Google_Gemma_3_12B_It_Messages {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role?: string;\n content?: string | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n }[];\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n /**\n * JSON schema that should be fufilled for the response.\n */\n guided_json?: object;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ntype Ai_Cf_Google_Gemma_3_12B_It_Output = {\n /**\n * The generated text response from the model\n */\n response: string;\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n /**\n * An array of tool calls requests made during the response generation\n */\n tool_calls?: {\n /**\n * The arguments passed to be passed to the tool call request\n */\n arguments?: object;\n /**\n * The name of the tool to be called\n */\n name?: string;\n }[];\n};\ndeclare abstract class Base_Ai_Cf_Google_Gemma_3_12B_It {\n inputs: Ai_Cf_Google_Gemma_3_12B_It_Input;\n postProcessedOutputs: Ai_Cf_Google_Gemma_3_12B_It_Output;\n}\ntype Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Input = Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Prompt | Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Messages | Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Async_Batch;\ninterface Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Prompt {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * JSON schema that should be fulfilled for the response.\n */\n guided_json?: object;\n response_format?: Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_JSON_Mode;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_JSON_Mode {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ninterface Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Messages {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role?: string;\n /**\n * The tool call id. If you don't know what to put here you can fall back to 000000001\n */\n tool_call_id?: string;\n content?: string | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n }[] | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n };\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n response_format?: Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_JSON_Mode;\n /**\n * JSON schema that should be fufilled for the response.\n */\n guided_json?: object;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Async_Batch {\n requests: (Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Prompt_Inner | Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Messages_Inner)[];\n}\ninterface Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Prompt_Inner {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * JSON schema that should be fulfilled for the response.\n */\n guided_json?: object;\n response_format?: Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_JSON_Mode;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Messages_Inner {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role?: string;\n /**\n * The tool call id. If you don't know what to put here you can fall back to 000000001\n */\n tool_call_id?: string;\n content?: string | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n }[] | {\n /**\n * Type of the content provided\n */\n type?: string;\n text?: string;\n image_url?: {\n /**\n * image uri with data (e.g. data:image/jpeg;base64,/9j/...). HTTP URL will not be accepted\n */\n url?: string;\n };\n };\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n response_format?: Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_JSON_Mode;\n /**\n * JSON schema that should be fufilled for the response.\n */\n guided_json?: object;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ntype Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Output = {\n /**\n * The generated text response from the model\n */\n response: string;\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n /**\n * An array of tool calls requests made during the response generation\n */\n tool_calls?: {\n /**\n * The tool call id.\n */\n id?: string;\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type?: string;\n /**\n * Details of the function tool.\n */\n function?: {\n /**\n * The name of the tool to be called\n */\n name?: string;\n /**\n * The arguments passed to be passed to the tool call request\n */\n arguments?: object;\n };\n }[];\n};\ndeclare abstract class Base_Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct {\n inputs: Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Input;\n postProcessedOutputs: Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Output;\n}\ntype Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Input = Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Prompt | Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Messages | Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Async_Batch;\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Prompt {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * Name of the LoRA (Low-Rank Adaptation) model to fine-tune the base model.\n */\n lora?: string;\n response_format?: Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_JSON_Mode;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_JSON_Mode {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Messages {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role: string;\n /**\n * The content of the message as a string.\n */\n content: string;\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n response_format?: Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_JSON_Mode_1;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_JSON_Mode_1 {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Async_Batch {\n requests: (Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Prompt_1 | Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Messages_1)[];\n}\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Prompt_1 {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * Name of the LoRA (Low-Rank Adaptation) model to fine-tune the base model.\n */\n lora?: string;\n response_format?: Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_JSON_Mode_2;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_JSON_Mode_2 {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Messages_1 {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role: string;\n /**\n * The content of the message as a string.\n */\n content: string;\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n response_format?: Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_JSON_Mode_3;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_JSON_Mode_3 {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ntype Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Output = Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Chat_Completion_Response | Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Text_Completion_Response | string | Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_AsyncResponse;\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Chat_Completion_Response {\n /**\n * Unique identifier for the completion\n */\n id?: string;\n /**\n * Object type identifier\n */\n object?: \"chat.completion\";\n /**\n * Unix timestamp of when the completion was created\n */\n created?: number;\n /**\n * Model used for the completion\n */\n model?: string;\n /**\n * List of completion choices\n */\n choices?: {\n /**\n * Index of the choice in the list\n */\n index?: number;\n /**\n * The message generated by the model\n */\n message?: {\n /**\n * Role of the message author\n */\n role: string;\n /**\n * The content of the message\n */\n content: string;\n /**\n * Internal reasoning content (if available)\n */\n reasoning_content?: string;\n /**\n * Tool calls made by the assistant\n */\n tool_calls?: {\n /**\n * Unique identifier for the tool call\n */\n id: string;\n /**\n * Type of tool call\n */\n type: \"function\";\n function: {\n /**\n * Name of the function to call\n */\n name: string;\n /**\n * JSON string of arguments for the function\n */\n arguments: string;\n };\n }[];\n };\n /**\n * Reason why the model stopped generating\n */\n finish_reason?: string;\n /**\n * Stop reason (may be null)\n */\n stop_reason?: string | null;\n /**\n * Log probabilities (if requested)\n */\n logprobs?: {} | null;\n }[];\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n /**\n * Log probabilities for the prompt (if requested)\n */\n prompt_logprobs?: {} | null;\n}\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Text_Completion_Response {\n /**\n * Unique identifier for the completion\n */\n id?: string;\n /**\n * Object type identifier\n */\n object?: \"text_completion\";\n /**\n * Unix timestamp of when the completion was created\n */\n created?: number;\n /**\n * Model used for the completion\n */\n model?: string;\n /**\n * List of completion choices\n */\n choices?: {\n /**\n * Index of the choice in the list\n */\n index: number;\n /**\n * The generated text completion\n */\n text: string;\n /**\n * Reason why the model stopped generating\n */\n finish_reason: string;\n /**\n * Stop reason (may be null)\n */\n stop_reason?: string | null;\n /**\n * Log probabilities (if requested)\n */\n logprobs?: {} | null;\n /**\n * Log probabilities for the prompt (if requested)\n */\n prompt_logprobs?: {} | null;\n }[];\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n}\ninterface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_AsyncResponse {\n /**\n * The async request id that can be used to obtain the results.\n */\n request_id?: string;\n}\ndeclare abstract class Base_Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8 {\n inputs: Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Input;\n postProcessedOutputs: Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Output;\n}\ninterface Ai_Cf_Deepgram_Nova_3_Input {\n audio: {\n body: object;\n contentType: string;\n };\n /**\n * Sets how the model will interpret strings submitted to the custom_topic param. When strict, the model will only return topics submitted using the custom_topic param. When extended, the model will return its own detected topics in addition to those submitted using the custom_topic param.\n */\n custom_topic_mode?: \"extended\" | \"strict\";\n /**\n * Custom topics you want the model to detect within your input audio or text if present Submit up to 100\n */\n custom_topic?: string;\n /**\n * Sets how the model will interpret intents submitted to the custom_intent param. When strict, the model will only return intents submitted using the custom_intent param. When extended, the model will return its own detected intents in addition those submitted using the custom_intents param\n */\n custom_intent_mode?: \"extended\" | \"strict\";\n /**\n * Custom intents you want the model to detect within your input audio if present\n */\n custom_intent?: string;\n /**\n * Identifies and extracts key entities from content in submitted audio\n */\n detect_entities?: boolean;\n /**\n * Identifies the dominant language spoken in submitted audio\n */\n detect_language?: boolean;\n /**\n * Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0\n */\n diarize?: boolean;\n /**\n * Identify and extract key entities from content in submitted audio\n */\n dictation?: boolean;\n /**\n * Specify the expected encoding of your submitted audio\n */\n encoding?: \"linear16\" | \"flac\" | \"mulaw\" | \"amr-nb\" | \"amr-wb\" | \"opus\" | \"speex\" | \"g729\";\n /**\n * Arbitrary key-value pairs that are attached to the API response for usage in downstream processing\n */\n extra?: string;\n /**\n * Filler Words can help transcribe interruptions in your audio, like 'uh' and 'um'\n */\n filler_words?: boolean;\n /**\n * Key term prompting can boost or suppress specialized terminology and brands.\n */\n keyterm?: string;\n /**\n * Keywords can boost or suppress specialized terminology and brands.\n */\n keywords?: string;\n /**\n * The BCP-47 language tag that hints at the primary spoken language. Depending on the Model and API endpoint you choose only certain languages are available.\n */\n language?: string;\n /**\n * Spoken measurements will be converted to their corresponding abbreviations.\n */\n measurements?: boolean;\n /**\n * Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip.\n */\n mip_opt_out?: boolean;\n /**\n * Mode of operation for the model representing broad area of topic that will be talked about in the supplied audio\n */\n mode?: \"general\" | \"medical\" | \"finance\";\n /**\n * Transcribe each audio channel independently.\n */\n multichannel?: boolean;\n /**\n * Numerals converts numbers from written format to numerical format.\n */\n numerals?: boolean;\n /**\n * Splits audio into paragraphs to improve transcript readability.\n */\n paragraphs?: boolean;\n /**\n * Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completely.\n */\n profanity_filter?: boolean;\n /**\n * Add punctuation and capitalization to the transcript.\n */\n punctuate?: boolean;\n /**\n * Redaction removes sensitive information from your transcripts.\n */\n redact?: string;\n /**\n * Search for terms or phrases in submitted audio and replaces them.\n */\n replace?: string;\n /**\n * Search for terms or phrases in submitted audio.\n */\n search?: string;\n /**\n * Recognizes the sentiment throughout a transcript or text.\n */\n sentiment?: boolean;\n /**\n * Apply formatting to transcript output. When set to true, additional formatting will be applied to transcripts to improve readability.\n */\n smart_format?: boolean;\n /**\n * Detect topics throughout a transcript or text.\n */\n topics?: boolean;\n /**\n * Segments speech into meaningful semantic units.\n */\n utterances?: boolean;\n /**\n * Seconds to wait before detecting a pause between words in submitted audio.\n */\n utt_split?: number;\n /**\n * The number of channels in the submitted audio\n */\n channels?: number;\n /**\n * Specifies whether the streaming endpoint should provide ongoing transcription updates as more audio is received. When set to true, the endpoint sends continuous updates, meaning transcription results may evolve over time. Note: Supported only for webosockets.\n */\n interim_results?: boolean;\n /**\n * Indicates how long model will wait to detect whether a speaker has finished speaking or pauses for a significant period of time. When set to a value, the streaming endpoint immediately finalizes the transcription for the processed time range and returns the transcript with a speech_final parameter set to true. Can also be set to false to disable endpointing\n */\n endpointing?: string;\n /**\n * Indicates that speech has started. You'll begin receiving Speech Started messages upon speech starting. Note: Supported only for webosockets.\n */\n vad_events?: boolean;\n /**\n * Indicates how long model will wait to send an UtteranceEnd message after a word has been transcribed. Use with interim_results. Note: Supported only for webosockets.\n */\n utterance_end_ms?: boolean;\n}\ninterface Ai_Cf_Deepgram_Nova_3_Output {\n results?: {\n channels?: {\n alternatives?: {\n confidence?: number;\n transcript?: string;\n words?: {\n confidence?: number;\n end?: number;\n start?: number;\n word?: string;\n }[];\n }[];\n }[];\n summary?: {\n result?: string;\n short?: string;\n };\n sentiments?: {\n segments?: {\n text?: string;\n start_word?: number;\n end_word?: number;\n sentiment?: string;\n sentiment_score?: number;\n }[];\n average?: {\n sentiment?: string;\n sentiment_score?: number;\n };\n };\n };\n}\ndeclare abstract class Base_Ai_Cf_Deepgram_Nova_3 {\n inputs: Ai_Cf_Deepgram_Nova_3_Input;\n postProcessedOutputs: Ai_Cf_Deepgram_Nova_3_Output;\n}\ninterface Ai_Cf_Qwen_Qwen3_Embedding_0_6B_Input {\n queries?: string | string[];\n /**\n * Optional instruction for the task\n */\n instruction?: string;\n documents?: string | string[];\n text?: string | string[];\n}\ninterface Ai_Cf_Qwen_Qwen3_Embedding_0_6B_Output {\n data?: number[][];\n shape?: number[];\n}\ndeclare abstract class Base_Ai_Cf_Qwen_Qwen3_Embedding_0_6B {\n inputs: Ai_Cf_Qwen_Qwen3_Embedding_0_6B_Input;\n postProcessedOutputs: Ai_Cf_Qwen_Qwen3_Embedding_0_6B_Output;\n}\ntype Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Input = {\n /**\n * readable stream with audio data and content-type specified for that data\n */\n audio: {\n body: object;\n contentType: string;\n };\n /**\n * type of data PCM data that's sent to the inference server as raw array\n */\n dtype?: \"uint8\" | \"float32\" | \"float64\";\n} | {\n /**\n * base64 encoded audio data\n */\n audio: string;\n /**\n * type of data PCM data that's sent to the inference server as raw array\n */\n dtype?: \"uint8\" | \"float32\" | \"float64\";\n};\ninterface Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Output {\n /**\n * if true, end-of-turn was detected\n */\n is_complete?: boolean;\n /**\n * probability of the end-of-turn detection\n */\n probability?: number;\n}\ndeclare abstract class Base_Ai_Cf_Pipecat_Ai_Smart_Turn_V2 {\n inputs: Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Input;\n postProcessedOutputs: Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Output;\n}\ndeclare abstract class Base_Ai_Cf_Openai_Gpt_Oss_120B {\n inputs: ResponsesInput;\n postProcessedOutputs: ResponsesOutput;\n}\ndeclare abstract class Base_Ai_Cf_Openai_Gpt_Oss_20B {\n inputs: ResponsesInput;\n postProcessedOutputs: ResponsesOutput;\n}\ninterface Ai_Cf_Leonardo_Phoenix_1_0_Input {\n /**\n * A text description of the image you want to generate.\n */\n prompt: string;\n /**\n * Controls how closely the generated image should adhere to the prompt; higher values make the image more aligned with the prompt\n */\n guidance?: number;\n /**\n * Random seed for reproducibility of the image generation\n */\n seed?: number;\n /**\n * The height of the generated image in pixels\n */\n height?: number;\n /**\n * The width of the generated image in pixels\n */\n width?: number;\n /**\n * The number of diffusion steps; higher values can improve quality but take longer\n */\n num_steps?: number;\n /**\n * Specify what to exclude from the generated images\n */\n negative_prompt?: string;\n}\n/**\n * The generated image in JPEG format\n */\ntype Ai_Cf_Leonardo_Phoenix_1_0_Output = string;\ndeclare abstract class Base_Ai_Cf_Leonardo_Phoenix_1_0 {\n inputs: Ai_Cf_Leonardo_Phoenix_1_0_Input;\n postProcessedOutputs: Ai_Cf_Leonardo_Phoenix_1_0_Output;\n}\ninterface Ai_Cf_Leonardo_Lucid_Origin_Input {\n /**\n * A text description of the image you want to generate.\n */\n prompt: string;\n /**\n * Controls how closely the generated image should adhere to the prompt; higher values make the image more aligned with the prompt\n */\n guidance?: number;\n /**\n * Random seed for reproducibility of the image generation\n */\n seed?: number;\n /**\n * The height of the generated image in pixels\n */\n height?: number;\n /**\n * The width of the generated image in pixels\n */\n width?: number;\n /**\n * The number of diffusion steps; higher values can improve quality but take longer\n */\n num_steps?: number;\n /**\n * The number of diffusion steps; higher values can improve quality but take longer\n */\n steps?: number;\n}\ninterface Ai_Cf_Leonardo_Lucid_Origin_Output {\n /**\n * The generated image in Base64 format.\n */\n image?: string;\n}\ndeclare abstract class Base_Ai_Cf_Leonardo_Lucid_Origin {\n inputs: Ai_Cf_Leonardo_Lucid_Origin_Input;\n postProcessedOutputs: Ai_Cf_Leonardo_Lucid_Origin_Output;\n}\ninterface Ai_Cf_Deepgram_Aura_1_Input {\n /**\n * Speaker used to produce the audio.\n */\n speaker?: \"angus\" | \"asteria\" | \"arcas\" | \"orion\" | \"orpheus\" | \"athena\" | \"luna\" | \"zeus\" | \"perseus\" | \"helios\" | \"hera\" | \"stella\";\n /**\n * Encoding of the output audio.\n */\n encoding?: \"linear16\" | \"flac\" | \"mulaw\" | \"alaw\" | \"mp3\" | \"opus\" | \"aac\";\n /**\n * Container specifies the file format wrapper for the output audio. The available options depend on the encoding type..\n */\n container?: \"none\" | \"wav\" | \"ogg\";\n /**\n * The text content to be converted to speech\n */\n text: string;\n /**\n * Sample Rate specifies the sample rate for the output audio. Based on the encoding, different sample rates are supported. For some encodings, the sample rate is not configurable\n */\n sample_rate?: number;\n /**\n * The bitrate of the audio in bits per second. Choose from predefined ranges or specific values based on the encoding type.\n */\n bit_rate?: number;\n}\n/**\n * The generated audio in MP3 format\n */\ntype Ai_Cf_Deepgram_Aura_1_Output = string;\ndeclare abstract class Base_Ai_Cf_Deepgram_Aura_1 {\n inputs: Ai_Cf_Deepgram_Aura_1_Input;\n postProcessedOutputs: Ai_Cf_Deepgram_Aura_1_Output;\n}\ninterface Ai_Cf_Ai4Bharat_Indictrans2_En_Indic_1B_Input {\n /**\n * Input text to translate. Can be a single string or a list of strings.\n */\n text: string | string[];\n /**\n * Target langauge to translate to\n */\n target_language: \"asm_Beng\" | \"awa_Deva\" | \"ben_Beng\" | \"bho_Deva\" | \"brx_Deva\" | \"doi_Deva\" | \"eng_Latn\" | \"gom_Deva\" | \"gon_Deva\" | \"guj_Gujr\" | \"hin_Deva\" | \"hne_Deva\" | \"kan_Knda\" | \"kas_Arab\" | \"kas_Deva\" | \"kha_Latn\" | \"lus_Latn\" | \"mag_Deva\" | \"mai_Deva\" | \"mal_Mlym\" | \"mar_Deva\" | \"mni_Beng\" | \"mni_Mtei\" | \"npi_Deva\" | \"ory_Orya\" | \"pan_Guru\" | \"san_Deva\" | \"sat_Olck\" | \"snd_Arab\" | \"snd_Deva\" | \"tam_Taml\" | \"tel_Telu\" | \"urd_Arab\" | \"unr_Deva\";\n}\ninterface Ai_Cf_Ai4Bharat_Indictrans2_En_Indic_1B_Output {\n /**\n * Translated texts\n */\n translations: string[];\n}\ndeclare abstract class Base_Ai_Cf_Ai4Bharat_Indictrans2_En_Indic_1B {\n inputs: Ai_Cf_Ai4Bharat_Indictrans2_En_Indic_1B_Input;\n postProcessedOutputs: Ai_Cf_Ai4Bharat_Indictrans2_En_Indic_1B_Output;\n}\ntype Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Input = Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Prompt | Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Messages | Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Async_Batch;\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Prompt {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * Name of the LoRA (Low-Rank Adaptation) model to fine-tune the base model.\n */\n lora?: string;\n response_format?: Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_JSON_Mode;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_JSON_Mode {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Messages {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role: string;\n /**\n * The content of the message as a string.\n */\n content: string;\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n response_format?: Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_JSON_Mode_1;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_JSON_Mode_1 {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Async_Batch {\n requests: (Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Prompt_1 | Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Messages_1)[];\n}\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Prompt_1 {\n /**\n * The input text prompt for the model to generate a response.\n */\n prompt: string;\n /**\n * Name of the LoRA (Low-Rank Adaptation) model to fine-tune the base model.\n */\n lora?: string;\n response_format?: Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_JSON_Mode_2;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_JSON_Mode_2 {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Messages_1 {\n /**\n * An array of message objects representing the conversation history.\n */\n messages: {\n /**\n * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').\n */\n role: string;\n /**\n * The content of the message as a string.\n */\n content: string;\n }[];\n functions?: {\n name: string;\n code: string;\n }[];\n /**\n * A list of tools available for the assistant to use.\n */\n tools?: ({\n /**\n * The name of the tool. More descriptive the better.\n */\n name: string;\n /**\n * A brief description of what the tool does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the tool.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n } | {\n /**\n * Specifies the type of tool (e.g., 'function').\n */\n type: string;\n /**\n * Details of the function tool.\n */\n function: {\n /**\n * The name of the function.\n */\n name: string;\n /**\n * A brief description of what the function does.\n */\n description: string;\n /**\n * Schema defining the parameters accepted by the function.\n */\n parameters: {\n /**\n * The type of the parameters object (usually 'object').\n */\n type: string;\n /**\n * List of required parameter names.\n */\n required?: string[];\n /**\n * Definitions of each parameter.\n */\n properties: {\n [k: string]: {\n /**\n * The data type of the parameter.\n */\n type: string;\n /**\n * A description of the expected parameter.\n */\n description: string;\n };\n };\n };\n };\n })[];\n response_format?: Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_JSON_Mode_3;\n /**\n * If true, a chat template is not applied and you must adhere to the specific model's expected formatting.\n */\n raw?: boolean;\n /**\n * If true, the response will be streamed back incrementally using SSE, Server Sent Events.\n */\n stream?: boolean;\n /**\n * The maximum number of tokens to generate in the response.\n */\n max_tokens?: number;\n /**\n * Controls the randomness of the output; higher values produce more random results.\n */\n temperature?: number;\n /**\n * Adjusts the creativity of the AI's responses by controlling how many possible words it considers. Lower values make outputs more predictable; higher values allow for more varied and creative responses.\n */\n top_p?: number;\n /**\n * Limits the AI to choose from the top 'k' most probable words. Lower values make responses more focused; higher values introduce more variety and potential surprises.\n */\n top_k?: number;\n /**\n * Random seed for reproducibility of the generation.\n */\n seed?: number;\n /**\n * Penalty for repeated tokens; higher values discourage repetition.\n */\n repetition_penalty?: number;\n /**\n * Decreases the likelihood of the model repeating the same lines verbatim.\n */\n frequency_penalty?: number;\n /**\n * Increases the likelihood of the model introducing new topics.\n */\n presence_penalty?: number;\n}\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_JSON_Mode_3 {\n type?: \"json_object\" | \"json_schema\";\n json_schema?: unknown;\n}\ntype Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Output = Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Chat_Completion_Response | Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Text_Completion_Response | string | Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_AsyncResponse;\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Chat_Completion_Response {\n /**\n * Unique identifier for the completion\n */\n id?: string;\n /**\n * Object type identifier\n */\n object?: \"chat.completion\";\n /**\n * Unix timestamp of when the completion was created\n */\n created?: number;\n /**\n * Model used for the completion\n */\n model?: string;\n /**\n * List of completion choices\n */\n choices?: {\n /**\n * Index of the choice in the list\n */\n index?: number;\n /**\n * The message generated by the model\n */\n message?: {\n /**\n * Role of the message author\n */\n role: string;\n /**\n * The content of the message\n */\n content: string;\n /**\n * Internal reasoning content (if available)\n */\n reasoning_content?: string;\n /**\n * Tool calls made by the assistant\n */\n tool_calls?: {\n /**\n * Unique identifier for the tool call\n */\n id: string;\n /**\n * Type of tool call\n */\n type: \"function\";\n function: {\n /**\n * Name of the function to call\n */\n name: string;\n /**\n * JSON string of arguments for the function\n */\n arguments: string;\n };\n }[];\n };\n /**\n * Reason why the model stopped generating\n */\n finish_reason?: string;\n /**\n * Stop reason (may be null)\n */\n stop_reason?: string | null;\n /**\n * Log probabilities (if requested)\n */\n logprobs?: {} | null;\n }[];\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n /**\n * Log probabilities for the prompt (if requested)\n */\n prompt_logprobs?: {} | null;\n}\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Text_Completion_Response {\n /**\n * Unique identifier for the completion\n */\n id?: string;\n /**\n * Object type identifier\n */\n object?: \"text_completion\";\n /**\n * Unix timestamp of when the completion was created\n */\n created?: number;\n /**\n * Model used for the completion\n */\n model?: string;\n /**\n * List of completion choices\n */\n choices?: {\n /**\n * Index of the choice in the list\n */\n index: number;\n /**\n * The generated text completion\n */\n text: string;\n /**\n * Reason why the model stopped generating\n */\n finish_reason: string;\n /**\n * Stop reason (may be null)\n */\n stop_reason?: string | null;\n /**\n * Log probabilities (if requested)\n */\n logprobs?: {} | null;\n /**\n * Log probabilities for the prompt (if requested)\n */\n prompt_logprobs?: {} | null;\n }[];\n /**\n * Usage statistics for the inference request\n */\n usage?: {\n /**\n * Total number of tokens in input\n */\n prompt_tokens?: number;\n /**\n * Total number of tokens in output\n */\n completion_tokens?: number;\n /**\n * Total number of input and output tokens\n */\n total_tokens?: number;\n };\n}\ninterface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_AsyncResponse {\n /**\n * The async request id that can be used to obtain the results.\n */\n request_id?: string;\n}\ndeclare abstract class Base_Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It {\n inputs: Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Input;\n postProcessedOutputs: Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Output;\n}\ninterface Ai_Cf_Pfnet_Plamo_Embedding_1B_Input {\n /**\n * Input text to embed. Can be a single string or a list of strings.\n */\n text: string | string[];\n}\ninterface Ai_Cf_Pfnet_Plamo_Embedding_1B_Output {\n /**\n * Embedding vectors, where each vector is a list of floats.\n */\n data: number[][];\n /**\n * Shape of the embedding data as [number_of_embeddings, embedding_dimension].\n *\n * @minItems 2\n * @maxItems 2\n */\n shape: [\n number,\n number\n ];\n}\ndeclare abstract class Base_Ai_Cf_Pfnet_Plamo_Embedding_1B {\n inputs: Ai_Cf_Pfnet_Plamo_Embedding_1B_Input;\n postProcessedOutputs: Ai_Cf_Pfnet_Plamo_Embedding_1B_Output;\n}\ninterface Ai_Cf_Deepgram_Flux_Input {\n /**\n * Encoding of the audio stream. Currently only supports raw signed little-endian 16-bit PCM.\n */\n encoding: \"linear16\";\n /**\n * Sample rate of the audio stream in Hz.\n */\n sample_rate: string;\n /**\n * End-of-turn confidence required to fire an eager end-of-turn event. When set, enables EagerEndOfTurn and TurnResumed events. Valid Values 0.3 - 0.9.\n */\n eager_eot_threshold?: string;\n /**\n * End-of-turn confidence required to finish a turn. Valid Values 0.5 - 0.9.\n */\n eot_threshold?: string;\n /**\n * A turn will be finished when this much time has passed after speech, regardless of EOT confidence.\n */\n eot_timeout_ms?: string;\n /**\n * Keyterm prompting can improve recognition of specialized terminology. Pass multiple keyterm query parameters to boost multiple keyterms.\n */\n keyterm?: string;\n /**\n * Opts out requests from the Deepgram Model Improvement Program. Refer to Deepgram Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip\n */\n mip_opt_out?: \"true\" | \"false\";\n /**\n * Label your requests for the purpose of identification during usage reporting\n */\n tag?: string;\n}\n/**\n * Output will be returned as websocket messages.\n */\ninterface Ai_Cf_Deepgram_Flux_Output {\n /**\n * The unique identifier of the request (uuid)\n */\n request_id?: string;\n /**\n * Starts at 0 and increments for each message the server sends to the client.\n */\n sequence_id?: number;\n /**\n * The type of event being reported.\n */\n event?: \"Update\" | \"StartOfTurn\" | \"EagerEndOfTurn\" | \"TurnResumed\" | \"EndOfTurn\";\n /**\n * The index of the current turn\n */\n turn_index?: number;\n /**\n * Start time in seconds of the audio range that was transcribed\n */\n audio_window_start?: number;\n /**\n * End time in seconds of the audio range that was transcribed\n */\n audio_window_end?: number;\n /**\n * Text that was said over the course of the current turn\n */\n transcript?: string;\n /**\n * The words in the transcript\n */\n words?: {\n /**\n * The individual punctuated, properly-cased word from the transcript\n */\n word: string;\n /**\n * Confidence that this word was transcribed correctly\n */\n confidence: number;\n }[];\n /**\n * Confidence that no more speech is coming in this turn\n */\n end_of_turn_confidence?: number;\n}\ndeclare abstract class Base_Ai_Cf_Deepgram_Flux {\n inputs: Ai_Cf_Deepgram_Flux_Input;\n postProcessedOutputs: Ai_Cf_Deepgram_Flux_Output;\n}\ninterface Ai_Cf_Deepgram_Aura_2_En_Input {\n /**\n * Speaker used to produce the audio.\n */\n speaker?: \"amalthea\" | \"andromeda\" | \"apollo\" | \"arcas\" | \"aries\" | \"asteria\" | \"athena\" | \"atlas\" | \"aurora\" | \"callista\" | \"cora\" | \"cordelia\" | \"delia\" | \"draco\" | \"electra\" | \"harmonia\" | \"helena\" | \"hera\" | \"hermes\" | \"hyperion\" | \"iris\" | \"janus\" | \"juno\" | \"jupiter\" | \"luna\" | \"mars\" | \"minerva\" | \"neptune\" | \"odysseus\" | \"ophelia\" | \"orion\" | \"orpheus\" | \"pandora\" | \"phoebe\" | \"pluto\" | \"saturn\" | \"thalia\" | \"theia\" | \"vesta\" | \"zeus\";\n /**\n * Encoding of the output audio.\n */\n encoding?: \"linear16\" | \"flac\" | \"mulaw\" | \"alaw\" | \"mp3\" | \"opus\" | \"aac\";\n /**\n * Container specifies the file format wrapper for the output audio. The available options depend on the encoding type..\n */\n container?: \"none\" | \"wav\" | \"ogg\";\n /**\n * The text content to be converted to speech\n */\n text: string;\n /**\n * Sample Rate specifies the sample rate for the output audio. Based on the encoding, different sample rates are supported. For some encodings, the sample rate is not configurable\n */\n sample_rate?: number;\n /**\n * The bitrate of the audio in bits per second. Choose from predefined ranges or specific values based on the encoding type.\n */\n bit_rate?: number;\n}\n/**\n * The generated audio in MP3 format\n */\ntype Ai_Cf_Deepgram_Aura_2_En_Output = string;\ndeclare abstract class Base_Ai_Cf_Deepgram_Aura_2_En {\n inputs: Ai_Cf_Deepgram_Aura_2_En_Input;\n postProcessedOutputs: Ai_Cf_Deepgram_Aura_2_En_Output;\n}\ninterface Ai_Cf_Deepgram_Aura_2_Es_Input {\n /**\n * Speaker used to produce the audio.\n */\n speaker?: \"sirio\" | \"nestor\" | \"carina\" | \"celeste\" | \"alvaro\" | \"diana\" | \"aquila\" | \"selena\" | \"estrella\" | \"javier\";\n /**\n * Encoding of the output audio.\n */\n encoding?: \"linear16\" | \"flac\" | \"mulaw\" | \"alaw\" | \"mp3\" | \"opus\" | \"aac\";\n /**\n * Container specifies the file format wrapper for the output audio. The available options depend on the encoding type..\n */\n container?: \"none\" | \"wav\" | \"ogg\";\n /**\n * The text content to be converted to speech\n */\n text: string;\n /**\n * Sample Rate specifies the sample rate for the output audio. Based on the encoding, different sample rates are supported. For some encodings, the sample rate is not configurable\n */\n sample_rate?: number;\n /**\n * The bitrate of the audio in bits per second. Choose from predefined ranges or specific values based on the encoding type.\n */\n bit_rate?: number;\n}\n/**\n * The generated audio in MP3 format\n */\ntype Ai_Cf_Deepgram_Aura_2_Es_Output = string;\ndeclare abstract class Base_Ai_Cf_Deepgram_Aura_2_Es {\n inputs: Ai_Cf_Deepgram_Aura_2_Es_Input;\n postProcessedOutputs: Ai_Cf_Deepgram_Aura_2_Es_Output;\n}\ninterface AiModels {\n \"@cf/huggingface/distilbert-sst-2-int8\": BaseAiTextClassification;\n \"@cf/stabilityai/stable-diffusion-xl-base-1.0\": BaseAiTextToImage;\n \"@cf/runwayml/stable-diffusion-v1-5-inpainting\": BaseAiTextToImage;\n \"@cf/runwayml/stable-diffusion-v1-5-img2img\": BaseAiTextToImage;\n \"@cf/lykon/dreamshaper-8-lcm\": BaseAiTextToImage;\n \"@cf/bytedance/stable-diffusion-xl-lightning\": BaseAiTextToImage;\n \"@cf/myshell-ai/melotts\": BaseAiTextToSpeech;\n \"@cf/google/embeddinggemma-300m\": BaseAiTextEmbeddings;\n \"@cf/microsoft/resnet-50\": BaseAiImageClassification;\n \"@cf/meta/llama-2-7b-chat-int8\": BaseAiTextGeneration;\n \"@cf/mistral/mistral-7b-instruct-v0.1\": BaseAiTextGeneration;\n \"@cf/meta/llama-2-7b-chat-fp16\": BaseAiTextGeneration;\n \"@hf/thebloke/llama-2-13b-chat-awq\": BaseAiTextGeneration;\n \"@hf/thebloke/mistral-7b-instruct-v0.1-awq\": BaseAiTextGeneration;\n \"@hf/thebloke/zephyr-7b-beta-awq\": BaseAiTextGeneration;\n \"@hf/thebloke/openhermes-2.5-mistral-7b-awq\": BaseAiTextGeneration;\n \"@hf/thebloke/neural-chat-7b-v3-1-awq\": BaseAiTextGeneration;\n \"@hf/thebloke/llamaguard-7b-awq\": BaseAiTextGeneration;\n \"@hf/thebloke/deepseek-coder-6.7b-base-awq\": BaseAiTextGeneration;\n \"@hf/thebloke/deepseek-coder-6.7b-instruct-awq\": BaseAiTextGeneration;\n \"@cf/deepseek-ai/deepseek-math-7b-instruct\": BaseAiTextGeneration;\n \"@cf/defog/sqlcoder-7b-2\": BaseAiTextGeneration;\n \"@cf/openchat/openchat-3.5-0106\": BaseAiTextGeneration;\n \"@cf/tiiuae/falcon-7b-instruct\": BaseAiTextGeneration;\n \"@cf/thebloke/discolm-german-7b-v1-awq\": BaseAiTextGeneration;\n \"@cf/qwen/qwen1.5-0.5b-chat\": BaseAiTextGeneration;\n \"@cf/qwen/qwen1.5-7b-chat-awq\": BaseAiTextGeneration;\n \"@cf/qwen/qwen1.5-14b-chat-awq\": BaseAiTextGeneration;\n \"@cf/tinyllama/tinyllama-1.1b-chat-v1.0\": BaseAiTextGeneration;\n \"@cf/microsoft/phi-2\": BaseAiTextGeneration;\n \"@cf/qwen/qwen1.5-1.8b-chat\": BaseAiTextGeneration;\n \"@cf/mistral/mistral-7b-instruct-v0.2-lora\": BaseAiTextGeneration;\n \"@hf/nousresearch/hermes-2-pro-mistral-7b\": BaseAiTextGeneration;\n \"@hf/nexusflow/starling-lm-7b-beta\": BaseAiTextGeneration;\n \"@hf/google/gemma-7b-it\": BaseAiTextGeneration;\n \"@cf/meta-llama/llama-2-7b-chat-hf-lora\": BaseAiTextGeneration;\n \"@cf/google/gemma-2b-it-lora\": BaseAiTextGeneration;\n \"@cf/google/gemma-7b-it-lora\": BaseAiTextGeneration;\n \"@hf/mistral/mistral-7b-instruct-v0.2\": BaseAiTextGeneration;\n \"@cf/meta/llama-3-8b-instruct\": BaseAiTextGeneration;\n \"@cf/fblgit/una-cybertron-7b-v2-bf16\": BaseAiTextGeneration;\n \"@cf/meta/llama-3-8b-instruct-awq\": BaseAiTextGeneration;\n \"@cf/meta/llama-3.1-8b-instruct-fp8\": BaseAiTextGeneration;\n \"@cf/meta/llama-3.1-8b-instruct-awq\": BaseAiTextGeneration;\n \"@cf/meta/llama-3.2-3b-instruct\": BaseAiTextGeneration;\n \"@cf/meta/llama-3.2-1b-instruct\": BaseAiTextGeneration;\n \"@cf/deepseek-ai/deepseek-r1-distill-qwen-32b\": BaseAiTextGeneration;\n \"@cf/ibm-granite/granite-4.0-h-micro\": BaseAiTextGeneration;\n \"@cf/facebook/bart-large-cnn\": BaseAiSummarization;\n \"@cf/llava-hf/llava-1.5-7b-hf\": BaseAiImageToText;\n \"@cf/baai/bge-base-en-v1.5\": Base_Ai_Cf_Baai_Bge_Base_En_V1_5;\n \"@cf/openai/whisper\": Base_Ai_Cf_Openai_Whisper;\n \"@cf/meta/m2m100-1.2b\": Base_Ai_Cf_Meta_M2M100_1_2B;\n \"@cf/baai/bge-small-en-v1.5\": Base_Ai_Cf_Baai_Bge_Small_En_V1_5;\n \"@cf/baai/bge-large-en-v1.5\": Base_Ai_Cf_Baai_Bge_Large_En_V1_5;\n \"@cf/unum/uform-gen2-qwen-500m\": Base_Ai_Cf_Unum_Uform_Gen2_Qwen_500M;\n \"@cf/openai/whisper-tiny-en\": Base_Ai_Cf_Openai_Whisper_Tiny_En;\n \"@cf/openai/whisper-large-v3-turbo\": Base_Ai_Cf_Openai_Whisper_Large_V3_Turbo;\n \"@cf/baai/bge-m3\": Base_Ai_Cf_Baai_Bge_M3;\n \"@cf/black-forest-labs/flux-1-schnell\": Base_Ai_Cf_Black_Forest_Labs_Flux_1_Schnell;\n \"@cf/meta/llama-3.2-11b-vision-instruct\": Base_Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct;\n \"@cf/meta/llama-3.3-70b-instruct-fp8-fast\": Base_Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast;\n \"@cf/meta/llama-guard-3-8b\": Base_Ai_Cf_Meta_Llama_Guard_3_8B;\n \"@cf/baai/bge-reranker-base\": Base_Ai_Cf_Baai_Bge_Reranker_Base;\n \"@cf/qwen/qwen2.5-coder-32b-instruct\": Base_Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct;\n \"@cf/qwen/qwq-32b\": Base_Ai_Cf_Qwen_Qwq_32B;\n \"@cf/mistralai/mistral-small-3.1-24b-instruct\": Base_Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct;\n \"@cf/google/gemma-3-12b-it\": Base_Ai_Cf_Google_Gemma_3_12B_It;\n \"@cf/meta/llama-4-scout-17b-16e-instruct\": Base_Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct;\n \"@cf/qwen/qwen3-30b-a3b-fp8\": Base_Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8;\n \"@cf/deepgram/nova-3\": Base_Ai_Cf_Deepgram_Nova_3;\n \"@cf/qwen/qwen3-embedding-0.6b\": Base_Ai_Cf_Qwen_Qwen3_Embedding_0_6B;\n \"@cf/pipecat-ai/smart-turn-v2\": Base_Ai_Cf_Pipecat_Ai_Smart_Turn_V2;\n \"@cf/openai/gpt-oss-120b\": Base_Ai_Cf_Openai_Gpt_Oss_120B;\n \"@cf/openai/gpt-oss-20b\": Base_Ai_Cf_Openai_Gpt_Oss_20B;\n \"@cf/leonardo/phoenix-1.0\": Base_Ai_Cf_Leonardo_Phoenix_1_0;\n \"@cf/leonardo/lucid-origin\": Base_Ai_Cf_Leonardo_Lucid_Origin;\n \"@cf/deepgram/aura-1\": Base_Ai_Cf_Deepgram_Aura_1;\n \"@cf/ai4bharat/indictrans2-en-indic-1B\": Base_Ai_Cf_Ai4Bharat_Indictrans2_En_Indic_1B;\n \"@cf/aisingapore/gemma-sea-lion-v4-27b-it\": Base_Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It;\n \"@cf/pfnet/plamo-embedding-1b\": Base_Ai_Cf_Pfnet_Plamo_Embedding_1B;\n \"@cf/deepgram/flux\": Base_Ai_Cf_Deepgram_Flux;\n \"@cf/deepgram/aura-2-en\": Base_Ai_Cf_Deepgram_Aura_2_En;\n \"@cf/deepgram/aura-2-es\": Base_Ai_Cf_Deepgram_Aura_2_Es;\n}\ntype AiOptions = {\n /**\n * Send requests as an asynchronous batch job, only works for supported models\n * https://developers.cloudflare.com/workers-ai/features/batch-api\n */\n queueRequest?: boolean;\n /**\n * Establish websocket connections, only works for supported models\n */\n websocket?: boolean;\n /**\n * Tag your requests to group and view them in Cloudflare dashboard.\n *\n * Rules:\n * Tags must only contain letters, numbers, and the symbols: : - . / @\n * Each tag can have maximum 50 characters.\n * Maximum 5 tags are allowed each request.\n * Duplicate tags will removed.\n */\n tags?: string[];\n gateway?: GatewayOptions;\n returnRawResponse?: boolean;\n prefix?: string;\n extraHeaders?: object;\n};\ntype AiModelsSearchParams = {\n author?: string;\n hide_experimental?: boolean;\n page?: number;\n per_page?: number;\n search?: string;\n source?: number;\n task?: string;\n};\ntype AiModelsSearchObject = {\n id: string;\n source: number;\n name: string;\n description: string;\n task: {\n id: string;\n name: string;\n description: string;\n };\n tags: string[];\n properties: {\n property_id: string;\n value: string;\n }[];\n};\ninterface InferenceUpstreamError extends Error {\n}\ninterface AiInternalError extends Error {\n}\ntype AiModelListType = Record;\ndeclare abstract class Ai {\n aiGatewayLogId: string | null;\n gateway(gatewayId: string): AiGateway;\n autorag(autoragId: string): AutoRAG;\n run(model: Name, inputs: InputOptions, options?: Options): Promise;\n models(params?: AiModelsSearchParams): Promise;\n toMarkdown(): ToMarkdownService;\n toMarkdown(files: MarkdownDocument[], options?: ConversionRequestOptions): Promise;\n toMarkdown(files: MarkdownDocument, options?: ConversionRequestOptions): Promise;\n}\ntype GatewayRetries = {\n maxAttempts?: 1 | 2 | 3 | 4 | 5;\n retryDelayMs?: number;\n backoff?: 'constant' | 'linear' | 'exponential';\n};\ntype GatewayOptions = {\n id: string;\n cacheKey?: string;\n cacheTtl?: number;\n skipCache?: boolean;\n metadata?: Record;\n collectLog?: boolean;\n eventId?: string;\n requestTimeoutMs?: number;\n retries?: GatewayRetries;\n};\ntype UniversalGatewayOptions = Exclude & {\n /**\n ** @deprecated\n */\n id?: string;\n};\ntype AiGatewayPatchLog = {\n score?: number | null;\n feedback?: -1 | 1 | null;\n metadata?: Record | null;\n};\ntype AiGatewayLog = {\n id: string;\n provider: string;\n model: string;\n model_type?: string;\n path: string;\n duration: number;\n request_type?: string;\n request_content_type?: string;\n status_code: number;\n response_content_type?: string;\n success: boolean;\n cached: boolean;\n tokens_in?: number;\n tokens_out?: number;\n metadata?: Record;\n step?: number;\n cost?: number;\n custom_cost?: boolean;\n request_size: number;\n request_head?: string;\n request_head_complete: boolean;\n response_size: number;\n response_head?: string;\n response_head_complete: boolean;\n created_at: Date;\n};\ntype AIGatewayProviders = 'workers-ai' | 'anthropic' | 'aws-bedrock' | 'azure-openai' | 'google-vertex-ai' | 'huggingface' | 'openai' | 'perplexity-ai' | 'replicate' | 'groq' | 'cohere' | 'google-ai-studio' | 'mistral' | 'grok' | 'openrouter' | 'deepseek' | 'cerebras' | 'cartesia' | 'elevenlabs' | 'adobe-firefly';\ntype AIGatewayHeaders = {\n 'cf-aig-metadata': Record | string;\n 'cf-aig-custom-cost': {\n per_token_in?: number;\n per_token_out?: number;\n } | {\n total_cost?: number;\n } | string;\n 'cf-aig-cache-ttl': number | string;\n 'cf-aig-skip-cache': boolean | string;\n 'cf-aig-cache-key': string;\n 'cf-aig-event-id': string;\n 'cf-aig-request-timeout': number | string;\n 'cf-aig-max-attempts': number | string;\n 'cf-aig-retry-delay': number | string;\n 'cf-aig-backoff': string;\n 'cf-aig-collect-log': boolean | string;\n Authorization: string;\n 'Content-Type': string;\n [key: string]: string | number | boolean | object;\n};\ntype AIGatewayUniversalRequest = {\n provider: AIGatewayProviders | string; // eslint-disable-line\n endpoint: string;\n headers: Partial;\n query: unknown;\n};\ninterface AiGatewayInternalError extends Error {\n}\ninterface AiGatewayLogNotFound extends Error {\n}\ndeclare abstract class AiGateway {\n patchLog(logId: string, data: AiGatewayPatchLog): Promise;\n getLog(logId: string): Promise;\n run(data: AIGatewayUniversalRequest | AIGatewayUniversalRequest[], options?: {\n gateway?: UniversalGatewayOptions;\n extraHeaders?: object;\n }): Promise;\n getUrl(provider?: AIGatewayProviders | string): Promise; // eslint-disable-line\n}\ninterface AutoRAGInternalError extends Error {\n}\ninterface AutoRAGNotFoundError extends Error {\n}\ninterface AutoRAGUnauthorizedError extends Error {\n}\ninterface AutoRAGNameNotSetError extends Error {\n}\ntype ComparisonFilter = {\n key: string;\n type: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte';\n value: string | number | boolean;\n};\ntype CompoundFilter = {\n type: 'and' | 'or';\n filters: ComparisonFilter[];\n};\ntype AutoRagSearchRequest = {\n query: string;\n filters?: CompoundFilter | ComparisonFilter;\n max_num_results?: number;\n ranking_options?: {\n ranker?: string;\n score_threshold?: number;\n };\n reranking?: {\n enabled?: boolean;\n model?: string;\n };\n rewrite_query?: boolean;\n};\ntype AutoRagAiSearchRequest = AutoRagSearchRequest & {\n stream?: boolean;\n system_prompt?: string;\n};\ntype AutoRagAiSearchRequestStreaming = Omit & {\n stream: true;\n};\ntype AutoRagSearchResponse = {\n object: 'vector_store.search_results.page';\n search_query: string;\n data: {\n file_id: string;\n filename: string;\n score: number;\n attributes: Record;\n content: {\n type: 'text';\n text: string;\n }[];\n }[];\n has_more: boolean;\n next_page: string | null;\n};\ntype AutoRagListResponse = {\n id: string;\n enable: boolean;\n type: string;\n source: string;\n vectorize_name: string;\n paused: boolean;\n status: string;\n}[];\ntype AutoRagAiSearchResponse = AutoRagSearchResponse & {\n response: string;\n};\ndeclare abstract class AutoRAG {\n list(): Promise;\n search(params: AutoRagSearchRequest): Promise;\n aiSearch(params: AutoRagAiSearchRequestStreaming): Promise;\n aiSearch(params: AutoRagAiSearchRequest): Promise;\n aiSearch(params: AutoRagAiSearchRequest): Promise;\n}\ninterface BasicImageTransformations {\n /**\n * Maximum width in image pixels. The value must be an integer.\n */\n width?: number;\n /**\n * Maximum height in image pixels. The value must be an integer.\n */\n height?: number;\n /**\n * Resizing mode as a string. It affects interpretation of width and height\n * options:\n * - scale-down: Similar to contain, but the image is never enlarged. If\n * the image is larger than given width or height, it will be resized.\n * Otherwise its original size will be kept.\n * - contain: Resizes to maximum size that fits within the given width and\n * height. If only a single dimension is given (e.g. only width), the\n * image will be shrunk or enlarged to exactly match that dimension.\n * Aspect ratio is always preserved.\n * - cover: Resizes (shrinks or enlarges) to fill the entire area of width\n * and height. If the image has an aspect ratio different from the ratio\n * of width and height, it will be cropped to fit.\n * - crop: The image will be shrunk and cropped to fit within the area\n * specified by width and height. The image will not be enlarged. For images\n * smaller than the given dimensions it's the same as scale-down. For\n * images larger than the given dimensions, it's the same as cover.\n * See also trim.\n * - pad: Resizes to the maximum size that fits within the given width and\n * height, and then fills the remaining area with a background color\n * (white by default). Use of this mode is not recommended, as the same\n * effect can be more efficiently achieved with the contain mode and the\n * CSS object-fit: contain property.\n * - squeeze: Stretches and deforms to the width and height given, even if it\n * breaks aspect ratio\n */\n fit?: \"scale-down\" | \"contain\" | \"cover\" | \"crop\" | \"pad\" | \"squeeze\";\n /**\n * Image segmentation using artificial intelligence models. Sets pixels not\n * within selected segment area to transparent e.g \"foreground\" sets every\n * background pixel as transparent.\n */\n segment?: \"foreground\";\n /**\n * When cropping with fit: \"cover\", this defines the side or point that should\n * be left uncropped. The value is either a string\n * \"left\", \"right\", \"top\", \"bottom\", \"auto\", or \"center\" (the default),\n * or an object {x, y} containing focal point coordinates in the original\n * image expressed as fractions ranging from 0.0 (top or left) to 1.0\n * (bottom or right), 0.5 being the center. {fit: \"cover\", gravity: \"top\"} will\n * crop bottom or left and right sides as necessary, but won’t crop anything\n * from the top. {fit: \"cover\", gravity: {x:0.5, y:0.2}} will crop each side to\n * preserve as much as possible around a point at 20% of the height of the\n * source image.\n */\n gravity?: 'face' | 'left' | 'right' | 'top' | 'bottom' | 'center' | 'auto' | 'entropy' | BasicImageTransformationsGravityCoordinates;\n /**\n * Background color to add underneath the image. Applies only to images with\n * transparency (such as PNG). Accepts any CSS color (#RRGGBB, rgba(…),\n * hsl(…), etc.)\n */\n background?: string;\n /**\n * Number of degrees (90, 180, 270) to rotate the image by. width and height\n * options refer to axes after rotation.\n */\n rotate?: 0 | 90 | 180 | 270 | 360;\n}\ninterface BasicImageTransformationsGravityCoordinates {\n x?: number;\n y?: number;\n mode?: 'remainder' | 'box-center';\n}\n/**\n * In addition to the properties you can set in the RequestInit dict\n * that you pass as an argument to the Request constructor, you can\n * set certain properties of a `cf` object to control how Cloudflare\n * features are applied to that new Request.\n *\n * Note: Currently, these properties cannot be tested in the\n * playground.\n */\ninterface RequestInitCfProperties extends Record {\n cacheEverything?: boolean;\n /**\n * A request's cache key is what determines if two requests are\n * \"the same\" for caching purposes. If a request has the same cache key\n * as some previous request, then we can serve the same cached response for\n * both. (e.g. 'some-key')\n *\n * Only available for Enterprise customers.\n */\n cacheKey?: string;\n /**\n * This allows you to append additional Cache-Tag response headers\n * to the origin response without modifications to the origin server.\n * This will allow for greater control over the Purge by Cache Tag feature\n * utilizing changes only in the Workers process.\n *\n * Only available for Enterprise customers.\n */\n cacheTags?: string[];\n /**\n * Force response to be cached for a given number of seconds. (e.g. 300)\n */\n cacheTtl?: number;\n /**\n * Force response to be cached for a given number of seconds based on the Origin status code.\n * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })\n */\n cacheTtlByStatus?: Record;\n scrapeShield?: boolean;\n apps?: boolean;\n image?: RequestInitCfPropertiesImage;\n minify?: RequestInitCfPropertiesImageMinify;\n mirage?: boolean;\n polish?: \"lossy\" | \"lossless\" | \"off\";\n r2?: RequestInitCfPropertiesR2;\n /**\n * Redirects the request to an alternate origin server. You can use this,\n * for example, to implement load balancing across several origins.\n * (e.g.us-east.example.com)\n *\n * Note - For security reasons, the hostname set in resolveOverride must\n * be proxied on the same Cloudflare zone of the incoming request.\n * Otherwise, the setting is ignored. CNAME hosts are allowed, so to\n * resolve to a host under a different domain or a DNS only domain first\n * declare a CNAME record within your own zone’s DNS mapping to the\n * external hostname, set proxy on Cloudflare, then set resolveOverride\n * to point to that CNAME record.\n */\n resolveOverride?: string;\n}\ninterface RequestInitCfPropertiesImageDraw extends BasicImageTransformations {\n /**\n * Absolute URL of the image file to use for the drawing. It can be any of\n * the supported file formats. For drawing of watermarks or non-rectangular\n * overlays we recommend using PNG or WebP images.\n */\n url: string;\n /**\n * Floating-point number between 0 (transparent) and 1 (opaque).\n * For example, opacity: 0.5 makes overlay semitransparent.\n */\n opacity?: number;\n /**\n * - If set to true, the overlay image will be tiled to cover the entire\n * area. This is useful for stock-photo-like watermarks.\n * - If set to \"x\", the overlay image will be tiled horizontally only\n * (form a line).\n * - If set to \"y\", the overlay image will be tiled vertically only\n * (form a line).\n */\n repeat?: true | \"x\" | \"y\";\n /**\n * Position of the overlay image relative to a given edge. Each property is\n * an offset in pixels. 0 aligns exactly to the edge. For example, left: 10\n * positions left side of the overlay 10 pixels from the left edge of the\n * image it's drawn over. bottom: 0 aligns bottom of the overlay with bottom\n * of the background image.\n *\n * Setting both left & right, or both top & bottom is an error.\n *\n * If no position is specified, the image will be centered.\n */\n top?: number;\n left?: number;\n bottom?: number;\n right?: number;\n}\ninterface RequestInitCfPropertiesImage extends BasicImageTransformations {\n /**\n * Device Pixel Ratio. Default 1. Multiplier for width/height that makes it\n * easier to specify higher-DPI sizes in .\n */\n dpr?: number;\n /**\n * Allows you to trim your image. Takes dpr into account and is performed before\n * resizing or rotation.\n *\n * It can be used as:\n * - left, top, right, bottom - it will specify the number of pixels to cut\n * off each side\n * - width, height - the width/height you'd like to end up with - can be used\n * in combination with the properties above\n * - border - this will automatically trim the surroundings of an image based on\n * it's color. It consists of three properties:\n * - color: rgb or hex representation of the color you wish to trim (todo: verify the rgba bit)\n * - tolerance: difference from color to treat as color\n * - keep: the number of pixels of border to keep\n */\n trim?: \"border\" | {\n top?: number;\n bottom?: number;\n left?: number;\n right?: number;\n width?: number;\n height?: number;\n border?: boolean | {\n color?: string;\n tolerance?: number;\n keep?: number;\n };\n };\n /**\n * Quality setting from 1-100 (useful values are in 60-90 range). Lower values\n * make images look worse, but load faster. The default is 85. It applies only\n * to JPEG and WebP images. It doesn’t have any effect on PNG.\n */\n quality?: number | \"low\" | \"medium-low\" | \"medium-high\" | \"high\";\n /**\n * Output format to generate. It can be:\n * - avif: generate images in AVIF format.\n * - webp: generate images in Google WebP format. Set quality to 100 to get\n * the WebP-lossless format.\n * - json: instead of generating an image, outputs information about the\n * image, in JSON format. The JSON object will contain image size\n * (before and after resizing), source image’s MIME type, file size, etc.\n * - jpeg: generate images in JPEG format.\n * - png: generate images in PNG format.\n */\n format?: \"avif\" | \"webp\" | \"json\" | \"jpeg\" | \"png\" | \"baseline-jpeg\" | \"png-force\" | \"svg\";\n /**\n * Whether to preserve animation frames from input files. Default is true.\n * Setting it to false reduces animations to still images. This setting is\n * recommended when enlarging images or processing arbitrary user content,\n * because large GIF animations can weigh tens or even hundreds of megabytes.\n * It is also useful to set anim:false when using format:\"json\" to get the\n * response quicker without the number of frames.\n */\n anim?: boolean;\n /**\n * What EXIF data should be preserved in the output image. Note that EXIF\n * rotation and embedded color profiles are always applied (\"baked in\" into\n * the image), and aren't affected by this option. Note that if the Polish\n * feature is enabled, all metadata may have been removed already and this\n * option may have no effect.\n * - keep: Preserve most of EXIF metadata, including GPS location if there's\n * any.\n * - copyright: Only keep the copyright tag, and discard everything else.\n * This is the default behavior for JPEG files.\n * - none: Discard all invisible EXIF metadata. Currently WebP and PNG\n * output formats always discard metadata.\n */\n metadata?: \"keep\" | \"copyright\" | \"none\";\n /**\n * Strength of sharpening filter to apply to the image. Floating-point\n * number between 0 (no sharpening, default) and 10 (maximum). 1.0 is a\n * recommended value for downscaled images.\n */\n sharpen?: number;\n /**\n * Radius of a blur filter (approximate gaussian). Maximum supported radius\n * is 250.\n */\n blur?: number;\n /**\n * Overlays are drawn in the order they appear in the array (last array\n * entry is the topmost layer).\n */\n draw?: RequestInitCfPropertiesImageDraw[];\n /**\n * Fetching image from authenticated origin. Setting this property will\n * pass authentication headers (Authorization, Cookie, etc.) through to\n * the origin.\n */\n \"origin-auth\"?: \"share-publicly\";\n /**\n * Adds a border around the image. The border is added after resizing. Border\n * width takes dpr into account, and can be specified either using a single\n * width property, or individually for each side.\n */\n border?: {\n color: string;\n width: number;\n } | {\n color: string;\n top: number;\n right: number;\n bottom: number;\n left: number;\n };\n /**\n * Increase brightness by a factor. A value of 1.0 equals no change, a value\n * of 0.5 equals half brightness, and a value of 2.0 equals twice as bright.\n * 0 is ignored.\n */\n brightness?: number;\n /**\n * Increase contrast by a factor. A value of 1.0 equals no change, a value of\n * 0.5 equals low contrast, and a value of 2.0 equals high contrast. 0 is\n * ignored.\n */\n contrast?: number;\n /**\n * Increase exposure by a factor. A value of 1.0 equals no change, a value of\n * 0.5 darkens the image, and a value of 2.0 lightens the image. 0 is ignored.\n */\n gamma?: number;\n /**\n * Increase contrast by a factor. A value of 1.0 equals no change, a value of\n * 0.5 equals low contrast, and a value of 2.0 equals high contrast. 0 is\n * ignored.\n */\n saturation?: number;\n /**\n * Flips the images horizontally, vertically, or both. Flipping is applied before\n * rotation, so if you apply flip=h,rotate=90 then the image will be flipped\n * horizontally, then rotated by 90 degrees.\n */\n flip?: 'h' | 'v' | 'hv';\n /**\n * Slightly reduces latency on a cache miss by selecting a\n * quickest-to-compress file format, at a cost of increased file size and\n * lower image quality. It will usually override the format option and choose\n * JPEG over WebP or AVIF. We do not recommend using this option, except in\n * unusual circumstances like resizing uncacheable dynamically-generated\n * images.\n */\n compression?: \"fast\";\n}\ninterface RequestInitCfPropertiesImageMinify {\n javascript?: boolean;\n css?: boolean;\n html?: boolean;\n}\ninterface RequestInitCfPropertiesR2 {\n /**\n * Colo id of bucket that an object is stored in\n */\n bucketColoId?: number;\n}\n/**\n * Request metadata provided by Cloudflare's edge.\n */\ntype IncomingRequestCfProperties = IncomingRequestCfPropertiesBase & IncomingRequestCfPropertiesBotManagementEnterprise & IncomingRequestCfPropertiesCloudflareForSaaSEnterprise & IncomingRequestCfPropertiesGeographicInformation & IncomingRequestCfPropertiesCloudflareAccessOrApiShield;\ninterface IncomingRequestCfPropertiesBase extends Record {\n /**\n * [ASN](https://www.iana.org/assignments/as-numbers/as-numbers.xhtml) of the incoming request.\n *\n * @example 395747\n */\n asn?: number;\n /**\n * The organization which owns the ASN of the incoming request.\n *\n * @example \"Google Cloud\"\n */\n asOrganization?: string;\n /**\n * The original value of the `Accept-Encoding` header if Cloudflare modified it.\n *\n * @example \"gzip, deflate, br\"\n */\n clientAcceptEncoding?: string;\n /**\n * The number of milliseconds it took for the request to reach your worker.\n *\n * @example 22\n */\n clientTcpRtt?: number;\n /**\n * The three-letter [IATA](https://en.wikipedia.org/wiki/IATA_airport_code)\n * airport code of the data center that the request hit.\n *\n * @example \"DFW\"\n */\n colo: string;\n /**\n * Represents the upstream's response to a\n * [TCP `keepalive` message](https://tldp.org/HOWTO/TCP-Keepalive-HOWTO/overview.html)\n * from cloudflare.\n *\n * For workers with no upstream, this will always be `1`.\n *\n * @example 3\n */\n edgeRequestKeepAliveStatus: IncomingRequestCfPropertiesEdgeRequestKeepAliveStatus;\n /**\n * The HTTP Protocol the request used.\n *\n * @example \"HTTP/2\"\n */\n httpProtocol: string;\n /**\n * The browser-requested prioritization information in the request object.\n *\n * If no information was set, defaults to the empty string `\"\"`\n *\n * @example \"weight=192;exclusive=0;group=3;group-weight=127\"\n * @default \"\"\n */\n requestPriority: string;\n /**\n * The TLS version of the connection to Cloudflare.\n * In requests served over plaintext (without TLS), this property is the empty string `\"\"`.\n *\n * @example \"TLSv1.3\"\n */\n tlsVersion: string;\n /**\n * The cipher for the connection to Cloudflare.\n * In requests served over plaintext (without TLS), this property is the empty string `\"\"`.\n *\n * @example \"AEAD-AES128-GCM-SHA256\"\n */\n tlsCipher: string;\n /**\n * Metadata containing the [`HELLO`](https://www.rfc-editor.org/rfc/rfc5246#section-7.4.1.2) and [`FINISHED`](https://www.rfc-editor.org/rfc/rfc5246#section-7.4.9) messages from this request's TLS handshake.\n *\n * If the incoming request was served over plaintext (without TLS) this field is undefined.\n */\n tlsExportedAuthenticator?: IncomingRequestCfPropertiesExportedAuthenticatorMetadata;\n}\ninterface IncomingRequestCfPropertiesBotManagementBase {\n /**\n * Cloudflare’s [level of certainty](https://developers.cloudflare.com/bots/concepts/bot-score/) that a request comes from a bot,\n * represented as an integer percentage between `1` (almost certainly a bot) and `99` (almost certainly human).\n *\n * @example 54\n */\n score: number;\n /**\n * A boolean value that is true if the request comes from a good bot, like Google or Bing.\n * Most customers choose to allow this traffic. For more details, see [Traffic from known bots](https://developers.cloudflare.com/firewall/known-issues-and-faq/#how-does-firewall-rules-handle-traffic-from-known-bots).\n */\n verifiedBot: boolean;\n /**\n * A boolean value that is true if the request originates from a\n * Cloudflare-verified proxy service.\n */\n corporateProxy: boolean;\n /**\n * A boolean value that's true if the request matches [file extensions](https://developers.cloudflare.com/bots/reference/static-resources/) for many types of static resources.\n */\n staticResource: boolean;\n /**\n * List of IDs that correlate to the Bot Management heuristic detections made on a request (you can have multiple heuristic detections on the same request).\n */\n detectionIds: number[];\n}\ninterface IncomingRequestCfPropertiesBotManagement {\n /**\n * Results of Cloudflare's Bot Management analysis\n */\n botManagement: IncomingRequestCfPropertiesBotManagementBase;\n /**\n * Duplicate of `botManagement.score`.\n *\n * @deprecated\n */\n clientTrustScore: number;\n}\ninterface IncomingRequestCfPropertiesBotManagementEnterprise extends IncomingRequestCfPropertiesBotManagement {\n /**\n * Results of Cloudflare's Bot Management analysis\n */\n botManagement: IncomingRequestCfPropertiesBotManagementBase & {\n /**\n * A [JA3 Fingerprint](https://developers.cloudflare.com/bots/concepts/ja3-fingerprint/) to help profile specific SSL/TLS clients\n * across different destination IPs, Ports, and X509 certificates.\n */\n ja3Hash: string;\n };\n}\ninterface IncomingRequestCfPropertiesCloudflareForSaaSEnterprise {\n /**\n * Custom metadata set per-host in [Cloudflare for SaaS](https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/).\n *\n * This field is only present if you have Cloudflare for SaaS enabled on your account\n * and you have followed the [required steps to enable it]((https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/custom-metadata/)).\n */\n hostMetadata?: HostMetadata;\n}\ninterface IncomingRequestCfPropertiesCloudflareAccessOrApiShield {\n /**\n * Information about the client certificate presented to Cloudflare.\n *\n * This is populated when the incoming request is served over TLS using\n * either Cloudflare Access or API Shield (mTLS)\n * and the presented SSL certificate has a valid\n * [Certificate Serial Number](https://ldapwiki.com/wiki/Certificate%20Serial%20Number)\n * (i.e., not `null` or `\"\"`).\n *\n * Otherwise, a set of placeholder values are used.\n *\n * The property `certPresented` will be set to `\"1\"` when\n * the object is populated (i.e. the above conditions were met).\n */\n tlsClientAuth: IncomingRequestCfPropertiesTLSClientAuth | IncomingRequestCfPropertiesTLSClientAuthPlaceholder;\n}\n/**\n * Metadata about the request's TLS handshake\n */\ninterface IncomingRequestCfPropertiesExportedAuthenticatorMetadata {\n /**\n * The client's [`HELLO` message](https://www.rfc-editor.org/rfc/rfc5246#section-7.4.1.2), encoded in hexadecimal\n *\n * @example \"44372ba35fa1270921d318f34c12f155dc87b682cf36a790cfaa3ba8737a1b5d\"\n */\n clientHandshake: string;\n /**\n * The server's [`HELLO` message](https://www.rfc-editor.org/rfc/rfc5246#section-7.4.1.2), encoded in hexadecimal\n *\n * @example \"44372ba35fa1270921d318f34c12f155dc87b682cf36a790cfaa3ba8737a1b5d\"\n */\n serverHandshake: string;\n /**\n * The client's [`FINISHED` message](https://www.rfc-editor.org/rfc/rfc5246#section-7.4.9), encoded in hexadecimal\n *\n * @example \"084ee802fe1348f688220e2a6040a05b2199a761f33cf753abb1b006792d3f8b\"\n */\n clientFinished: string;\n /**\n * The server's [`FINISHED` message](https://www.rfc-editor.org/rfc/rfc5246#section-7.4.9), encoded in hexadecimal\n *\n * @example \"084ee802fe1348f688220e2a6040a05b2199a761f33cf753abb1b006792d3f8b\"\n */\n serverFinished: string;\n}\n/**\n * Geographic data about the request's origin.\n */\ninterface IncomingRequestCfPropertiesGeographicInformation {\n /**\n * The [ISO 3166-1 Alpha 2](https://www.iso.org/iso-3166-country-codes.html) country code the request originated from.\n *\n * If your worker is [configured to accept TOR connections](https://support.cloudflare.com/hc/en-us/articles/203306930-Understanding-Cloudflare-Tor-support-and-Onion-Routing), this may also be `\"T1\"`, indicating a request that originated over TOR.\n *\n * If Cloudflare is unable to determine where the request originated this property is omitted.\n *\n * The country code `\"T1\"` is used for requests originating on TOR.\n *\n * @example \"GB\"\n */\n country?: Iso3166Alpha2Code | \"T1\";\n /**\n * If present, this property indicates that the request originated in the EU\n *\n * @example \"1\"\n */\n isEUCountry?: \"1\";\n /**\n * A two-letter code indicating the continent the request originated from.\n *\n * @example \"AN\"\n */\n continent?: ContinentCode;\n /**\n * The city the request originated from\n *\n * @example \"Austin\"\n */\n city?: string;\n /**\n * Postal code of the incoming request\n *\n * @example \"78701\"\n */\n postalCode?: string;\n /**\n * Latitude of the incoming request\n *\n * @example \"30.27130\"\n */\n latitude?: string;\n /**\n * Longitude of the incoming request\n *\n * @example \"-97.74260\"\n */\n longitude?: string;\n /**\n * Timezone of the incoming request\n *\n * @example \"America/Chicago\"\n */\n timezone?: string;\n /**\n * If known, the ISO 3166-2 name for the first level region associated with\n * the IP address of the incoming request\n *\n * @example \"Texas\"\n */\n region?: string;\n /**\n * If known, the ISO 3166-2 code for the first-level region associated with\n * the IP address of the incoming request\n *\n * @example \"TX\"\n */\n regionCode?: string;\n /**\n * Metro code (DMA) of the incoming request\n *\n * @example \"635\"\n */\n metroCode?: string;\n}\n/** Data about the incoming request's TLS certificate */\ninterface IncomingRequestCfPropertiesTLSClientAuth {\n /** Always `\"1\"`, indicating that the certificate was presented */\n certPresented: \"1\";\n /**\n * Result of certificate verification.\n *\n * @example \"FAILED:self signed certificate\"\n */\n certVerified: Exclude;\n /** The presented certificate's revokation status.\n *\n * - A value of `\"1\"` indicates the certificate has been revoked\n * - A value of `\"0\"` indicates the certificate has not been revoked\n */\n certRevoked: \"1\" | \"0\";\n /**\n * The certificate issuer's [distinguished name](https://knowledge.digicert.com/generalinformation/INFO1745.html)\n *\n * @example \"CN=cloudflareaccess.com, C=US, ST=Texas, L=Austin, O=Cloudflare\"\n */\n certIssuerDN: string;\n /**\n * The certificate subject's [distinguished name](https://knowledge.digicert.com/generalinformation/INFO1745.html)\n *\n * @example \"CN=*.cloudflareaccess.com, C=US, ST=Texas, L=Austin, O=Cloudflare\"\n */\n certSubjectDN: string;\n /**\n * The certificate issuer's [distinguished name](https://knowledge.digicert.com/generalinformation/INFO1745.html) ([RFC 2253](https://www.rfc-editor.org/rfc/rfc2253.html) formatted)\n *\n * @example \"CN=cloudflareaccess.com, C=US, ST=Texas, L=Austin, O=Cloudflare\"\n */\n certIssuerDNRFC2253: string;\n /**\n * The certificate subject's [distinguished name](https://knowledge.digicert.com/generalinformation/INFO1745.html) ([RFC 2253](https://www.rfc-editor.org/rfc/rfc2253.html) formatted)\n *\n * @example \"CN=*.cloudflareaccess.com, C=US, ST=Texas, L=Austin, O=Cloudflare\"\n */\n certSubjectDNRFC2253: string;\n /** The certificate issuer's distinguished name (legacy policies) */\n certIssuerDNLegacy: string;\n /** The certificate subject's distinguished name (legacy policies) */\n certSubjectDNLegacy: string;\n /**\n * The certificate's serial number\n *\n * @example \"00936EACBE07F201DF\"\n */\n certSerial: string;\n /**\n * The certificate issuer's serial number\n *\n * @example \"2489002934BDFEA34\"\n */\n certIssuerSerial: string;\n /**\n * The certificate's Subject Key Identifier\n *\n * @example \"BB:AF:7E:02:3D:FA:A6:F1:3C:84:8E:AD:EE:38:98:EC:D9:32:32:D4\"\n */\n certSKI: string;\n /**\n * The certificate issuer's Subject Key Identifier\n *\n * @example \"BB:AF:7E:02:3D:FA:A6:F1:3C:84:8E:AD:EE:38:98:EC:D9:32:32:D4\"\n */\n certIssuerSKI: string;\n /**\n * The certificate's SHA-1 fingerprint\n *\n * @example \"6b9109f323999e52259cda7373ff0b4d26bd232e\"\n */\n certFingerprintSHA1: string;\n /**\n * The certificate's SHA-256 fingerprint\n *\n * @example \"acf77cf37b4156a2708e34c4eb755f9b5dbbe5ebb55adfec8f11493438d19e6ad3f157f81fa3b98278453d5652b0c1fd1d71e5695ae4d709803a4d3f39de9dea\"\n */\n certFingerprintSHA256: string;\n /**\n * The effective starting date of the certificate\n *\n * @example \"Dec 22 19:39:00 2018 GMT\"\n */\n certNotBefore: string;\n /**\n * The effective expiration date of the certificate\n *\n * @example \"Dec 22 19:39:00 2018 GMT\"\n */\n certNotAfter: string;\n}\n/** Placeholder values for TLS Client Authorization */\ninterface IncomingRequestCfPropertiesTLSClientAuthPlaceholder {\n certPresented: \"0\";\n certVerified: \"NONE\";\n certRevoked: \"0\";\n certIssuerDN: \"\";\n certSubjectDN: \"\";\n certIssuerDNRFC2253: \"\";\n certSubjectDNRFC2253: \"\";\n certIssuerDNLegacy: \"\";\n certSubjectDNLegacy: \"\";\n certSerial: \"\";\n certIssuerSerial: \"\";\n certSKI: \"\";\n certIssuerSKI: \"\";\n certFingerprintSHA1: \"\";\n certFingerprintSHA256: \"\";\n certNotBefore: \"\";\n certNotAfter: \"\";\n}\n/** Possible outcomes of TLS verification */\ndeclare type CertVerificationStatus = \n/** Authentication succeeded */\n\"SUCCESS\"\n/** No certificate was presented */\n | \"NONE\"\n/** Failed because the certificate was self-signed */\n | \"FAILED:self signed certificate\"\n/** Failed because the certificate failed a trust chain check */\n | \"FAILED:unable to verify the first certificate\"\n/** Failed because the certificate not yet valid */\n | \"FAILED:certificate is not yet valid\"\n/** Failed because the certificate is expired */\n | \"FAILED:certificate has expired\"\n/** Failed for another unspecified reason */\n | \"FAILED\";\n/**\n * An upstream endpoint's response to a TCP `keepalive` message from Cloudflare.\n */\ndeclare type IncomingRequestCfPropertiesEdgeRequestKeepAliveStatus = 0 /** Unknown */ | 1 /** no keepalives (not found) */ | 2 /** no connection re-use, opening keepalive connection failed */ | 3 /** no connection re-use, keepalive accepted and saved */ | 4 /** connection re-use, refused by the origin server (`TCP FIN`) */ | 5; /** connection re-use, accepted by the origin server */\n/** ISO 3166-1 Alpha-2 codes */\ndeclare type Iso3166Alpha2Code = \"AD\" | \"AE\" | \"AF\" | \"AG\" | \"AI\" | \"AL\" | \"AM\" | \"AO\" | \"AQ\" | \"AR\" | \"AS\" | \"AT\" | \"AU\" | \"AW\" | \"AX\" | \"AZ\" | \"BA\" | \"BB\" | \"BD\" | \"BE\" | \"BF\" | \"BG\" | \"BH\" | \"BI\" | \"BJ\" | \"BL\" | \"BM\" | \"BN\" | \"BO\" | \"BQ\" | \"BR\" | \"BS\" | \"BT\" | \"BV\" | \"BW\" | \"BY\" | \"BZ\" | \"CA\" | \"CC\" | \"CD\" | \"CF\" | \"CG\" | \"CH\" | \"CI\" | \"CK\" | \"CL\" | \"CM\" | \"CN\" | \"CO\" | \"CR\" | \"CU\" | \"CV\" | \"CW\" | \"CX\" | \"CY\" | \"CZ\" | \"DE\" | \"DJ\" | \"DK\" | \"DM\" | \"DO\" | \"DZ\" | \"EC\" | \"EE\" | \"EG\" | \"EH\" | \"ER\" | \"ES\" | \"ET\" | \"FI\" | \"FJ\" | \"FK\" | \"FM\" | \"FO\" | \"FR\" | \"GA\" | \"GB\" | \"GD\" | \"GE\" | \"GF\" | \"GG\" | \"GH\" | \"GI\" | \"GL\" | \"GM\" | \"GN\" | \"GP\" | \"GQ\" | \"GR\" | \"GS\" | \"GT\" | \"GU\" | \"GW\" | \"GY\" | \"HK\" | \"HM\" | \"HN\" | \"HR\" | \"HT\" | \"HU\" | \"ID\" | \"IE\" | \"IL\" | \"IM\" | \"IN\" | \"IO\" | \"IQ\" | \"IR\" | \"IS\" | \"IT\" | \"JE\" | \"JM\" | \"JO\" | \"JP\" | \"KE\" | \"KG\" | \"KH\" | \"KI\" | \"KM\" | \"KN\" | \"KP\" | \"KR\" | \"KW\" | \"KY\" | \"KZ\" | \"LA\" | \"LB\" | \"LC\" | \"LI\" | \"LK\" | \"LR\" | \"LS\" | \"LT\" | \"LU\" | \"LV\" | \"LY\" | \"MA\" | \"MC\" | \"MD\" | \"ME\" | \"MF\" | \"MG\" | \"MH\" | \"MK\" | \"ML\" | \"MM\" | \"MN\" | \"MO\" | \"MP\" | \"MQ\" | \"MR\" | \"MS\" | \"MT\" | \"MU\" | \"MV\" | \"MW\" | \"MX\" | \"MY\" | \"MZ\" | \"NA\" | \"NC\" | \"NE\" | \"NF\" | \"NG\" | \"NI\" | \"NL\" | \"NO\" | \"NP\" | \"NR\" | \"NU\" | \"NZ\" | \"OM\" | \"PA\" | \"PE\" | \"PF\" | \"PG\" | \"PH\" | \"PK\" | \"PL\" | \"PM\" | \"PN\" | \"PR\" | \"PS\" | \"PT\" | \"PW\" | \"PY\" | \"QA\" | \"RE\" | \"RO\" | \"RS\" | \"RU\" | \"RW\" | \"SA\" | \"SB\" | \"SC\" | \"SD\" | \"SE\" | \"SG\" | \"SH\" | \"SI\" | \"SJ\" | \"SK\" | \"SL\" | \"SM\" | \"SN\" | \"SO\" | \"SR\" | \"SS\" | \"ST\" | \"SV\" | \"SX\" | \"SY\" | \"SZ\" | \"TC\" | \"TD\" | \"TF\" | \"TG\" | \"TH\" | \"TJ\" | \"TK\" | \"TL\" | \"TM\" | \"TN\" | \"TO\" | \"TR\" | \"TT\" | \"TV\" | \"TW\" | \"TZ\" | \"UA\" | \"UG\" | \"UM\" | \"US\" | \"UY\" | \"UZ\" | \"VA\" | \"VC\" | \"VE\" | \"VG\" | \"VI\" | \"VN\" | \"VU\" | \"WF\" | \"WS\" | \"YE\" | \"YT\" | \"ZA\" | \"ZM\" | \"ZW\";\n/** The 2-letter continent codes Cloudflare uses */\ndeclare type ContinentCode = \"AF\" | \"AN\" | \"AS\" | \"EU\" | \"NA\" | \"OC\" | \"SA\";\ntype CfProperties = IncomingRequestCfProperties | RequestInitCfProperties;\ninterface D1Meta {\n duration: number;\n size_after: number;\n rows_read: number;\n rows_written: number;\n last_row_id: number;\n changed_db: boolean;\n changes: number;\n /**\n * The region of the database instance that executed the query.\n */\n served_by_region?: string;\n /**\n * True if-and-only-if the database instance that executed the query was the primary.\n */\n served_by_primary?: boolean;\n timings?: {\n /**\n * The duration of the SQL query execution by the database instance. It doesn't include any network time.\n */\n sql_duration_ms: number;\n };\n /**\n * Number of total attempts to execute the query, due to automatic retries.\n * Note: All other fields in the response like `timings` only apply to the last attempt.\n */\n total_attempts?: number;\n}\ninterface D1Response {\n success: true;\n meta: D1Meta & Record;\n error?: never;\n}\ntype D1Result = D1Response & {\n results: T[];\n};\ninterface D1ExecResult {\n count: number;\n duration: number;\n}\ntype D1SessionConstraint = \n// Indicates that the first query should go to the primary, and the rest queries\n// using the same D1DatabaseSession will go to any replica that is consistent with\n// the bookmark maintained by the session (returned by the first query).\n'first-primary'\n// Indicates that the first query can go anywhere (primary or replica), and the rest queries\n// using the same D1DatabaseSession will go to any replica that is consistent with\n// the bookmark maintained by the session (returned by the first query).\n | 'first-unconstrained';\ntype D1SessionBookmark = string;\ndeclare abstract class D1Database {\n prepare(query: string): D1PreparedStatement;\n batch(statements: D1PreparedStatement[]): Promise[]>;\n exec(query: string): Promise;\n /**\n * Creates a new D1 Session anchored at the given constraint or the bookmark.\n * All queries executed using the created session will have sequential consistency,\n * meaning that all writes done through the session will be visible in subsequent reads.\n *\n * @param constraintOrBookmark Either the session constraint or the explicit bookmark to anchor the created session.\n */\n withSession(constraintOrBookmark?: D1SessionBookmark | D1SessionConstraint): D1DatabaseSession;\n /**\n * @deprecated dump() will be removed soon, only applies to deprecated alpha v1 databases.\n */\n dump(): Promise;\n}\ndeclare abstract class D1DatabaseSession {\n prepare(query: string): D1PreparedStatement;\n batch(statements: D1PreparedStatement[]): Promise[]>;\n /**\n * @returns The latest session bookmark across all executed queries on the session.\n * If no query has been executed yet, `null` is returned.\n */\n getBookmark(): D1SessionBookmark | null;\n}\ndeclare abstract class D1PreparedStatement {\n bind(...values: unknown[]): D1PreparedStatement;\n first(colName: string): Promise;\n first>(): Promise;\n run>(): Promise>;\n all>(): Promise>;\n raw(options: {\n columnNames: true;\n }): Promise<[\n string[],\n ...T[]\n ]>;\n raw(options?: {\n columnNames?: false;\n }): Promise;\n}\n// `Disposable` was added to TypeScript's standard lib types in version 5.2.\n// To support older TypeScript versions, define an empty `Disposable` interface.\n// Users won't be able to use `using`/`Symbol.dispose` without upgrading to 5.2,\n// but this will ensure type checking on older versions still passes.\n// TypeScript's interface merging will ensure our empty interface is effectively\n// ignored when `Disposable` is included in the standard lib.\ninterface Disposable {\n}\n/**\n * An email message that can be sent from a Worker.\n */\ninterface EmailMessage {\n /**\n * Envelope From attribute of the email message.\n */\n readonly from: string;\n /**\n * Envelope To attribute of the email message.\n */\n readonly to: string;\n}\n/**\n * An email message that is sent to a consumer Worker and can be rejected/forwarded.\n */\ninterface ForwardableEmailMessage extends EmailMessage {\n /**\n * Stream of the email message content.\n */\n readonly raw: ReadableStream;\n /**\n * An [Headers object](https://developer.mozilla.org/en-US/docs/Web/API/Headers).\n */\n readonly headers: Headers;\n /**\n * Size of the email message content.\n */\n readonly rawSize: number;\n /**\n * Reject this email message by returning a permanent SMTP error back to the connecting client including the given reason.\n * @param reason The reject reason.\n * @returns void\n */\n setReject(reason: string): void;\n /**\n * Forward this email message to a verified destination address of the account.\n * @param rcptTo Verified destination address.\n * @param headers A [Headers object](https://developer.mozilla.org/en-US/docs/Web/API/Headers).\n * @returns A promise that resolves when the email message is forwarded.\n */\n forward(rcptTo: string, headers?: Headers): Promise;\n /**\n * Reply to the sender of this email message with a new EmailMessage object.\n * @param message The reply message.\n * @returns A promise that resolves when the email message is replied.\n */\n reply(message: EmailMessage): Promise;\n}\n/**\n * A binding that allows a Worker to send email messages.\n */\ninterface SendEmail {\n send(message: EmailMessage): Promise;\n}\ndeclare abstract class EmailEvent extends ExtendableEvent {\n readonly message: ForwardableEmailMessage;\n}\ndeclare type EmailExportedHandler = (message: ForwardableEmailMessage, env: Env, ctx: ExecutionContext) => void | Promise;\ndeclare module \"cloudflare:email\" {\n let _EmailMessage: {\n prototype: EmailMessage;\n new (from: string, to: string, raw: ReadableStream | string): EmailMessage;\n };\n export { _EmailMessage as EmailMessage };\n}\n/**\n * Hello World binding to serve as an explanatory example. DO NOT USE\n */\ninterface HelloWorldBinding {\n /**\n * Retrieve the current stored value\n */\n get(): Promise<{\n value: string;\n ms?: number;\n }>;\n /**\n * Set a new stored value\n */\n set(value: string): Promise;\n}\ninterface Hyperdrive {\n /**\n * Connect directly to Hyperdrive as if it's your database, returning a TCP socket.\n *\n * Calling this method returns an idential socket to if you call\n * `connect(\"host:port\")` using the `host` and `port` fields from this object.\n * Pick whichever approach works better with your preferred DB client library.\n *\n * Note that this socket is not yet authenticated -- it's expected that your\n * code (or preferably, the client library of your choice) will authenticate\n * using the information in this class's readonly fields.\n */\n connect(): Socket;\n /**\n * A valid DB connection string that can be passed straight into the typical\n * client library/driver/ORM. This will typically be the easiest way to use\n * Hyperdrive.\n */\n readonly connectionString: string;\n /*\n * A randomly generated hostname that is only valid within the context of the\n * currently running Worker which, when passed into `connect()` function from\n * the \"cloudflare:sockets\" module, will connect to the Hyperdrive instance\n * for your database.\n */\n readonly host: string;\n /*\n * The port that must be paired the the host field when connecting.\n */\n readonly port: number;\n /*\n * The username to use when authenticating to your database via Hyperdrive.\n * Unlike the host and password, this will be the same every time\n */\n readonly user: string;\n /*\n * The randomly generated password to use when authenticating to your\n * database via Hyperdrive. Like the host field, this password is only valid\n * within the context of the currently running Worker instance from which\n * it's read.\n */\n readonly password: string;\n /*\n * The name of the database to connect to.\n */\n readonly database: string;\n}\n// Copyright (c) 2024 Cloudflare, Inc.\n// Licensed under the Apache 2.0 license found in the LICENSE file or at:\n// https://opensource.org/licenses/Apache-2.0\ntype ImageInfoResponse = {\n format: 'image/svg+xml';\n} | {\n format: string;\n fileSize: number;\n width: number;\n height: number;\n};\ntype ImageTransform = {\n width?: number;\n height?: number;\n background?: string;\n blur?: number;\n border?: {\n color?: string;\n width?: number;\n } | {\n top?: number;\n bottom?: number;\n left?: number;\n right?: number;\n };\n brightness?: number;\n contrast?: number;\n fit?: 'scale-down' | 'contain' | 'pad' | 'squeeze' | 'cover' | 'crop';\n flip?: 'h' | 'v' | 'hv';\n gamma?: number;\n segment?: 'foreground';\n gravity?: 'face' | 'left' | 'right' | 'top' | 'bottom' | 'center' | 'auto' | 'entropy' | {\n x?: number;\n y?: number;\n mode: 'remainder' | 'box-center';\n };\n rotate?: 0 | 90 | 180 | 270;\n saturation?: number;\n sharpen?: number;\n trim?: 'border' | {\n top?: number;\n bottom?: number;\n left?: number;\n right?: number;\n width?: number;\n height?: number;\n border?: boolean | {\n color?: string;\n tolerance?: number;\n keep?: number;\n };\n };\n};\ntype ImageDrawOptions = {\n opacity?: number;\n repeat?: boolean | string;\n top?: number;\n left?: number;\n bottom?: number;\n right?: number;\n};\ntype ImageInputOptions = {\n encoding?: 'base64';\n};\ntype ImageOutputOptions = {\n format: 'image/jpeg' | 'image/png' | 'image/gif' | 'image/webp' | 'image/avif' | 'rgb' | 'rgba';\n quality?: number;\n background?: string;\n anim?: boolean;\n};\ninterface ImagesBinding {\n /**\n * Get image metadata (type, width and height)\n * @throws {@link ImagesError} with code 9412 if input is not an image\n * @param stream The image bytes\n */\n info(stream: ReadableStream, options?: ImageInputOptions): Promise;\n /**\n * Begin applying a series of transformations to an image\n * @param stream The image bytes\n * @returns A transform handle\n */\n input(stream: ReadableStream, options?: ImageInputOptions): ImageTransformer;\n}\ninterface ImageTransformer {\n /**\n * Apply transform next, returning a transform handle.\n * You can then apply more transformations, draw, or retrieve the output.\n * @param transform\n */\n transform(transform: ImageTransform): ImageTransformer;\n /**\n * Draw an image on this transformer, returning a transform handle.\n * You can then apply more transformations, draw, or retrieve the output.\n * @param image The image (or transformer that will give the image) to draw\n * @param options The options configuring how to draw the image\n */\n draw(image: ReadableStream | ImageTransformer, options?: ImageDrawOptions): ImageTransformer;\n /**\n * Retrieve the image that results from applying the transforms to the\n * provided input\n * @param options Options that apply to the output e.g. output format\n */\n output(options: ImageOutputOptions): Promise;\n}\ntype ImageTransformationOutputOptions = {\n encoding?: 'base64';\n};\ninterface ImageTransformationResult {\n /**\n * The image as a response, ready to store in cache or return to users\n */\n response(): Response;\n /**\n * The content type of the returned image\n */\n contentType(): string;\n /**\n * The bytes of the response\n */\n image(options?: ImageTransformationOutputOptions): ReadableStream;\n}\ninterface ImagesError extends Error {\n readonly code: number;\n readonly message: string;\n readonly stack?: string;\n}\n/**\n * Media binding for transforming media streams.\n * Provides the entry point for media transformation operations.\n */\ninterface MediaBinding {\n /**\n * Creates a media transformer from an input stream.\n * @param media - The input media bytes\n * @returns A MediaTransformer instance for applying transformations\n */\n input(media: ReadableStream): MediaTransformer;\n}\n/**\n * Media transformer for applying transformation operations to media content.\n * Handles sizing, fitting, and other input transformation parameters.\n */\ninterface MediaTransformer {\n /**\n * Applies transformation options to the media content.\n * @param transform - Configuration for how the media should be transformed\n * @returns A generator for producing the transformed media output\n */\n transform(transform: MediaTransformationInputOptions): MediaTransformationGenerator;\n}\n/**\n * Generator for producing media transformation results.\n * Configures the output format and parameters for the transformed media.\n */\ninterface MediaTransformationGenerator {\n /**\n * Generates the final media output with specified options.\n * @param output - Configuration for the output format and parameters\n * @returns The final transformation result containing the transformed media\n */\n output(output: MediaTransformationOutputOptions): MediaTransformationResult;\n}\n/**\n * Result of a media transformation operation.\n * Provides multiple ways to access the transformed media content.\n */\ninterface MediaTransformationResult {\n /**\n * Returns the transformed media as a readable stream of bytes.\n * @returns A stream containing the transformed media data\n */\n media(): ReadableStream;\n /**\n * Returns the transformed media as an HTTP response object.\n * @returns The transformed media as a Response, ready to store in cache or return to users\n */\n response(): Response;\n /**\n * Returns the MIME type of the transformed media.\n * @returns The content type string (e.g., 'image/jpeg', 'video/mp4')\n */\n contentType(): string;\n}\n/**\n * Configuration options for transforming media input.\n * Controls how the media should be resized and fitted.\n */\ntype MediaTransformationInputOptions = {\n /** How the media should be resized to fit the specified dimensions */\n fit?: 'contain' | 'cover' | 'scale-down';\n /** Target width in pixels */\n width?: number;\n /** Target height in pixels */\n height?: number;\n};\n/**\n * Configuration options for Media Transformations output.\n * Controls the format, timing, and type of the generated output.\n */\ntype MediaTransformationOutputOptions = {\n /**\n * Output mode determining the type of media to generate\n */\n mode?: 'video' | 'spritesheet' | 'frame' | 'audio';\n /** Whether to include audio in the output */\n audio?: boolean;\n /**\n * Starting timestamp for frame extraction or start time for clips. (e.g. '2s').\n */\n time?: string;\n /**\n * Duration for video clips, audio extraction, and spritesheet generation (e.g. '5s').\n */\n duration?: string;\n /**\n * Number of frames in the spritesheet.\n */\n imageCount?: number;\n /**\n * Output format for the generated media.\n */\n format?: 'jpg' | 'png' | 'm4a';\n};\n/**\n * Error object for media transformation operations.\n * Extends the standard Error interface with additional media-specific information.\n */\ninterface MediaError extends Error {\n readonly code: number;\n readonly message: string;\n readonly stack?: string;\n}\ndeclare module 'cloudflare:node' {\n interface NodeStyleServer {\n listen(...args: unknown[]): this;\n address(): {\n port?: number | null | undefined;\n };\n }\n export function httpServerHandler(port: number): ExportedHandler;\n export function httpServerHandler(options: {\n port: number;\n }): ExportedHandler;\n export function httpServerHandler(server: NodeStyleServer): ExportedHandler;\n}\ntype Params

= Record;\ntype EventContext = {\n request: Request>;\n functionPath: string;\n waitUntil: (promise: Promise) => void;\n passThroughOnException: () => void;\n next: (input?: Request | string, init?: RequestInit) => Promise;\n env: Env & {\n ASSETS: {\n fetch: typeof fetch;\n };\n };\n params: Params

;\n data: Data;\n};\ntype PagesFunction = Record> = (context: EventContext) => Response | Promise;\ntype EventPluginContext = {\n request: Request>;\n functionPath: string;\n waitUntil: (promise: Promise) => void;\n passThroughOnException: () => void;\n next: (input?: Request | string, init?: RequestInit) => Promise;\n env: Env & {\n ASSETS: {\n fetch: typeof fetch;\n };\n };\n params: Params

;\n data: Data;\n pluginArgs: PluginArgs;\n};\ntype PagesPluginFunction = Record, PluginArgs = unknown> = (context: EventPluginContext) => Response | Promise;\ndeclare module \"assets:*\" {\n export const onRequest: PagesFunction;\n}\n// Copyright (c) 2022-2023 Cloudflare, Inc.\n// Licensed under the Apache 2.0 license found in the LICENSE file or at:\n// https://opensource.org/licenses/Apache-2.0\ndeclare module \"cloudflare:pipelines\" {\n export abstract class PipelineTransformationEntrypoint {\n protected env: Env;\n protected ctx: ExecutionContext;\n constructor(ctx: ExecutionContext, env: Env);\n /**\n * run recieves an array of PipelineRecord which can be\n * transformed and returned to the pipeline\n * @param records Incoming records from the pipeline to be transformed\n * @param metadata Information about the specific pipeline calling the transformation entrypoint\n * @returns A promise containing the transformed PipelineRecord array\n */\n public run(records: I[], metadata: PipelineBatchMetadata): Promise;\n }\n export type PipelineRecord = Record;\n export type PipelineBatchMetadata = {\n pipelineId: string;\n pipelineName: string;\n };\n export interface Pipeline {\n /**\n * The Pipeline interface represents the type of a binding to a Pipeline\n *\n * @param records The records to send to the pipeline\n */\n send(records: T[]): Promise;\n }\n}\n// PubSubMessage represents an incoming PubSub message.\n// The message includes metadata about the broker, the client, and the payload\n// itself.\n// https://developers.cloudflare.com/pub-sub/\ninterface PubSubMessage {\n // Message ID\n readonly mid: number;\n // MQTT broker FQDN in the form mqtts://BROKER.NAMESPACE.cloudflarepubsub.com:PORT\n readonly broker: string;\n // The MQTT topic the message was sent on.\n readonly topic: string;\n // The client ID of the client that published this message.\n readonly clientId: string;\n // The unique identifier (JWT ID) used by the client to authenticate, if token\n // auth was used.\n readonly jti?: string;\n // A Unix timestamp (seconds from Jan 1, 1970), set when the Pub/Sub Broker\n // received the message from the client.\n readonly receivedAt: number;\n // An (optional) string with the MIME type of the payload, if set by the\n // client.\n readonly contentType: string;\n // Set to 1 when the payload is a UTF-8 string\n // https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Toc3901063\n readonly payloadFormatIndicator: number;\n // Pub/Sub (MQTT) payloads can be UTF-8 strings, or byte arrays.\n // You can use payloadFormatIndicator to inspect this before decoding.\n payload: string | Uint8Array;\n}\n// JsonWebKey extended by kid parameter\ninterface JsonWebKeyWithKid extends JsonWebKey {\n // Key Identifier of the JWK\n readonly kid: string;\n}\ninterface RateLimitOptions {\n key: string;\n}\ninterface RateLimitOutcome {\n success: boolean;\n}\ninterface RateLimit {\n /**\n * Rate limit a request based on the provided options.\n * @see https://developers.cloudflare.com/workers/runtime-apis/bindings/rate-limit/\n * @returns A promise that resolves with the outcome of the rate limit.\n */\n limit(options: RateLimitOptions): Promise;\n}\n// Namespace for RPC utility types. Unfortunately, we can't use a `module` here as these types need\n// to referenced by `Fetcher`. This is included in the \"importable\" version of the types which\n// strips all `module` blocks.\ndeclare namespace Rpc {\n // Branded types for identifying `WorkerEntrypoint`/`DurableObject`/`Target`s.\n // TypeScript uses *structural* typing meaning anything with the same shape as type `T` is a `T`.\n // For the classes exported by `cloudflare:workers` we want *nominal* typing (i.e. we only want to\n // accept `WorkerEntrypoint` from `cloudflare:workers`, not any other class with the same shape)\n export const __RPC_STUB_BRAND: '__RPC_STUB_BRAND';\n export const __RPC_TARGET_BRAND: '__RPC_TARGET_BRAND';\n export const __WORKER_ENTRYPOINT_BRAND: '__WORKER_ENTRYPOINT_BRAND';\n export const __DURABLE_OBJECT_BRAND: '__DURABLE_OBJECT_BRAND';\n export const __WORKFLOW_ENTRYPOINT_BRAND: '__WORKFLOW_ENTRYPOINT_BRAND';\n export interface RpcTargetBranded {\n [__RPC_TARGET_BRAND]: never;\n }\n export interface WorkerEntrypointBranded {\n [__WORKER_ENTRYPOINT_BRAND]: never;\n }\n export interface DurableObjectBranded {\n [__DURABLE_OBJECT_BRAND]: never;\n }\n export interface WorkflowEntrypointBranded {\n [__WORKFLOW_ENTRYPOINT_BRAND]: never;\n }\n export type EntrypointBranded = WorkerEntrypointBranded | DurableObjectBranded | WorkflowEntrypointBranded;\n // Types that can be used through `Stub`s\n export type Stubable = RpcTargetBranded | ((...args: any[]) => any);\n // Types that can be passed over RPC\n // The reason for using a generic type here is to build a serializable subset of structured\n // cloneable composite types. This allows types defined with the \"interface\" keyword to pass the\n // serializable check as well. Otherwise, only types defined with the \"type\" keyword would pass.\n type Serializable = \n // Structured cloneables\n BaseType\n // Structured cloneable composites\n | Map ? Serializable : never, T extends Map ? Serializable : never> | Set ? Serializable : never> | ReadonlyArray ? Serializable : never> | {\n [K in keyof T]: K extends number | string ? Serializable : never;\n }\n // Special types\n | Stub\n // Serialized as stubs, see `Stubify`\n | Stubable;\n // Base type for all RPC stubs, including common memory management methods.\n // `T` is used as a marker type for unwrapping `Stub`s later.\n interface StubBase extends Disposable {\n [__RPC_STUB_BRAND]: T;\n dup(): this;\n }\n export type Stub = Provider & StubBase;\n // This represents all the types that can be sent as-is over an RPC boundary\n type BaseType = void | undefined | null | boolean | number | bigint | string | TypedArray | ArrayBuffer | DataView | Date | Error | RegExp | ReadableStream | WritableStream | Request | Response | Headers;\n // Recursively rewrite all `Stubable` types with `Stub`s\n // prettier-ignore\n type Stubify = T extends Stubable ? Stub : T extends Map ? Map, Stubify> : T extends Set ? Set> : T extends Array ? Array> : T extends ReadonlyArray ? ReadonlyArray> : T extends BaseType ? T : T extends {\n [key: string | number]: any;\n } ? {\n [K in keyof T]: Stubify;\n } : T;\n // Recursively rewrite all `Stub`s with the corresponding `T`s.\n // Note we use `StubBase` instead of `Stub` here to avoid circular dependencies:\n // `Stub` depends on `Provider`, which depends on `Unstubify`, which would depend on `Stub`.\n // prettier-ignore\n type Unstubify = T extends StubBase ? V : T extends Map ? Map, Unstubify> : T extends Set ? Set> : T extends Array ? Array> : T extends ReadonlyArray ? ReadonlyArray> : T extends BaseType ? T : T extends {\n [key: string | number]: unknown;\n } ? {\n [K in keyof T]: Unstubify;\n } : T;\n type UnstubifyAll = {\n [I in keyof A]: Unstubify;\n };\n // Utility type for adding `Provider`/`Disposable`s to `object` types only.\n // Note `unknown & T` is equivalent to `T`.\n type MaybeProvider = T extends object ? Provider : unknown;\n type MaybeDisposable = T extends object ? Disposable : unknown;\n // Type for method return or property on an RPC interface.\n // - Stubable types are replaced by stubs.\n // - Serializable types are passed by value, with stubable types replaced by stubs\n // and a top-level `Disposer`.\n // Everything else can't be passed over PRC.\n // Technically, we use custom thenables here, but they quack like `Promise`s.\n // Intersecting with `(Maybe)Provider` allows pipelining.\n // prettier-ignore\n type Result = R extends Stubable ? Promise> & Provider : R extends Serializable ? Promise & MaybeDisposable> & MaybeProvider : never;\n // Type for method or property on an RPC interface.\n // For methods, unwrap `Stub`s in parameters, and rewrite returns to be `Result`s.\n // Unwrapping `Stub`s allows calling with `Stubable` arguments.\n // For properties, rewrite types to be `Result`s.\n // In each case, unwrap `Promise`s.\n type MethodOrProperty = V extends (...args: infer P) => infer R ? (...args: UnstubifyAll

) => Result> : Result>;\n // Type for the callable part of an `Provider` if `T` is callable.\n // This is intersected with methods/properties.\n type MaybeCallableProvider = T extends (...args: any[]) => any ? MethodOrProperty : unknown;\n // Base type for all other types providing RPC-like interfaces.\n // Rewrites all methods/properties to be `MethodOrProperty`s, while preserving callable types.\n // `Reserved` names (e.g. stub method names like `dup()`) and symbols can't be accessed over RPC.\n export type Provider = MaybeCallableProvider & Pick<{\n [K in keyof T]: MethodOrProperty;\n }, Exclude>>;\n}\ndeclare namespace Cloudflare {\n // Type of `env`.\n //\n // The specific project can extend `Env` by redeclaring it in project-specific files. Typescript\n // will merge all declarations.\n //\n // You can use `wrangler types` to generate the `Env` type automatically.\n interface Env {\n }\n // Project-specific parameters used to inform types.\n //\n // This interface is, again, intended to be declared in project-specific files, and then that\n // declaration will be merged with this one.\n //\n // A project should have a declaration like this:\n //\n // interface GlobalProps {\n // // Declares the main module's exports. Used to populate Cloudflare.Exports aka the type\n // // of `ctx.exports`.\n // mainModule: typeof import(\"my-main-module\");\n //\n // // Declares which of the main module's exports are configured with durable storage, and\n // // thus should behave as Durable Object namsepace bindings.\n // durableNamespaces: \"MyDurableObject\" | \"AnotherDurableObject\";\n // }\n //\n // You can use `wrangler types` to generate `GlobalProps` automatically.\n interface GlobalProps {\n }\n // Evaluates to the type of a property in GlobalProps, defaulting to `Default` if it is not\n // present.\n type GlobalProp = K extends keyof GlobalProps ? GlobalProps[K] : Default;\n // The type of the program's main module exports, if known. Requires `GlobalProps` to declare the\n // `mainModule` property.\n type MainModule = GlobalProp<\"mainModule\", {}>;\n // The type of ctx.exports, which contains loopback bindings for all top-level exports.\n type Exports = {\n [K in keyof MainModule]: LoopbackForExport\n // If the export is listed in `durableNamespaces`, then it is also a\n // DurableObjectNamespace.\n & (K extends GlobalProp<\"durableNamespaces\", never> ? MainModule[K] extends new (...args: any[]) => infer DoInstance ? DoInstance extends Rpc.DurableObjectBranded ? DurableObjectNamespace : DurableObjectNamespace : DurableObjectNamespace : {});\n };\n}\ndeclare namespace CloudflareWorkersModule {\n export type RpcStub = Rpc.Stub;\n export const RpcStub: {\n new (value: T): Rpc.Stub;\n };\n export abstract class RpcTarget implements Rpc.RpcTargetBranded {\n [Rpc.__RPC_TARGET_BRAND]: never;\n }\n // `protected` fields don't appear in `keyof`s, so can't be accessed over RPC\n export abstract class WorkerEntrypoint implements Rpc.WorkerEntrypointBranded {\n [Rpc.__WORKER_ENTRYPOINT_BRAND]: never;\n protected ctx: ExecutionContext;\n protected env: Env;\n constructor(ctx: ExecutionContext, env: Env);\n email?(message: ForwardableEmailMessage): void | Promise;\n fetch?(request: Request): Response | Promise;\n queue?(batch: MessageBatch): void | Promise;\n scheduled?(controller: ScheduledController): void | Promise;\n tail?(events: TraceItem[]): void | Promise;\n tailStream?(event: TailStream.TailEvent): TailStream.TailEventHandlerType | Promise;\n test?(controller: TestController): void | Promise;\n trace?(traces: TraceItem[]): void | Promise;\n }\n export abstract class DurableObject implements Rpc.DurableObjectBranded {\n [Rpc.__DURABLE_OBJECT_BRAND]: never;\n protected ctx: DurableObjectState;\n protected env: Env;\n constructor(ctx: DurableObjectState, env: Env);\n alarm?(alarmInfo?: AlarmInvocationInfo): void | Promise;\n fetch?(request: Request): Response | Promise;\n webSocketMessage?(ws: WebSocket, message: string | ArrayBuffer): void | Promise;\n webSocketClose?(ws: WebSocket, code: number, reason: string, wasClean: boolean): void | Promise;\n webSocketError?(ws: WebSocket, error: unknown): void | Promise;\n }\n export type WorkflowDurationLabel = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';\n export type WorkflowSleepDuration = `${number} ${WorkflowDurationLabel}${'s' | ''}` | number;\n export type WorkflowDelayDuration = WorkflowSleepDuration;\n export type WorkflowTimeoutDuration = WorkflowSleepDuration;\n export type WorkflowRetentionDuration = WorkflowSleepDuration;\n export type WorkflowBackoff = 'constant' | 'linear' | 'exponential';\n export type WorkflowStepConfig = {\n retries?: {\n limit: number;\n delay: WorkflowDelayDuration | number;\n backoff?: WorkflowBackoff;\n };\n timeout?: WorkflowTimeoutDuration | number;\n };\n export type WorkflowEvent = {\n payload: Readonly;\n timestamp: Date;\n instanceId: string;\n };\n export type WorkflowStepEvent = {\n payload: Readonly;\n timestamp: Date;\n type: string;\n };\n export abstract class WorkflowStep {\n do>(name: string, callback: () => Promise): Promise;\n do>(name: string, config: WorkflowStepConfig, callback: () => Promise): Promise;\n sleep: (name: string, duration: WorkflowSleepDuration) => Promise;\n sleepUntil: (name: string, timestamp: Date | number) => Promise;\n waitForEvent>(name: string, options: {\n type: string;\n timeout?: WorkflowTimeoutDuration | number;\n }): Promise>;\n }\n export abstract class WorkflowEntrypoint | unknown = unknown> implements Rpc.WorkflowEntrypointBranded {\n [Rpc.__WORKFLOW_ENTRYPOINT_BRAND]: never;\n protected ctx: ExecutionContext;\n protected env: Env;\n constructor(ctx: ExecutionContext, env: Env);\n run(event: Readonly>, step: WorkflowStep): Promise;\n }\n export function waitUntil(promise: Promise): void;\n export function withEnv(newEnv: unknown, fn: () => unknown): unknown;\n export function withExports(newExports: unknown, fn: () => unknown): unknown;\n export function withEnvAndExports(newEnv: unknown, newExports: unknown, fn: () => unknown): unknown;\n export const env: Cloudflare.Env;\n export const exports: Cloudflare.Exports;\n}\ndeclare module 'cloudflare:workers' {\n export = CloudflareWorkersModule;\n}\ninterface SecretsStoreSecret {\n /**\n * Get a secret from the Secrets Store, returning a string of the secret value\n * if it exists, or throws an error if it does not exist\n */\n get(): Promise;\n}\ndeclare module \"cloudflare:sockets\" {\n function _connect(address: string | SocketAddress, options?: SocketOptions): Socket;\n export { _connect as connect };\n}\ntype MarkdownDocument = {\n name: string;\n blob: Blob;\n};\ntype ConversionResponse = {\n name: string;\n mimeType: string;\n format: 'markdown';\n tokens: number;\n data: string;\n} | {\n name: string;\n mimeType: string;\n format: 'error';\n error: string;\n};\ntype ImageConversionOptions = {\n descriptionLanguage?: 'en' | 'es' | 'fr' | 'it' | 'pt' | 'de';\n};\ntype EmbeddedImageConversionOptions = ImageConversionOptions & {\n convert?: boolean;\n maxConvertedImages?: number;\n};\ntype ConversionOptions = {\n html?: {\n images?: EmbeddedImageConversionOptions & {\n convertOGImage?: boolean;\n };\n };\n docx?: {\n images?: EmbeddedImageConversionOptions;\n };\n image?: ImageConversionOptions;\n pdf?: {\n images?: EmbeddedImageConversionOptions;\n metadata?: boolean;\n };\n};\ntype ConversionRequestOptions = {\n gateway?: GatewayOptions;\n extraHeaders?: object;\n conversionOptions?: ConversionOptions;\n};\ntype SupportedFileFormat = {\n mimeType: string;\n extension: string;\n};\ndeclare abstract class ToMarkdownService {\n transform(files: MarkdownDocument[], options?: ConversionRequestOptions): Promise;\n transform(files: MarkdownDocument, options?: ConversionRequestOptions): Promise;\n supported(): Promise;\n}\ndeclare namespace TailStream {\n interface Header {\n readonly name: string;\n readonly value: string;\n }\n interface FetchEventInfo {\n readonly type: \"fetch\";\n readonly method: string;\n readonly url: string;\n readonly cfJson?: object;\n readonly headers: Header[];\n }\n interface JsRpcEventInfo {\n readonly type: \"jsrpc\";\n }\n interface ScheduledEventInfo {\n readonly type: \"scheduled\";\n readonly scheduledTime: Date;\n readonly cron: string;\n }\n interface AlarmEventInfo {\n readonly type: \"alarm\";\n readonly scheduledTime: Date;\n }\n interface QueueEventInfo {\n readonly type: \"queue\";\n readonly queueName: string;\n readonly batchSize: number;\n }\n interface EmailEventInfo {\n readonly type: \"email\";\n readonly mailFrom: string;\n readonly rcptTo: string;\n readonly rawSize: number;\n }\n interface TraceEventInfo {\n readonly type: \"trace\";\n readonly traces: (string | null)[];\n }\n interface HibernatableWebSocketEventInfoMessage {\n readonly type: \"message\";\n }\n interface HibernatableWebSocketEventInfoError {\n readonly type: \"error\";\n }\n interface HibernatableWebSocketEventInfoClose {\n readonly type: \"close\";\n readonly code: number;\n readonly wasClean: boolean;\n }\n interface HibernatableWebSocketEventInfo {\n readonly type: \"hibernatableWebSocket\";\n readonly info: HibernatableWebSocketEventInfoClose | HibernatableWebSocketEventInfoError | HibernatableWebSocketEventInfoMessage;\n }\n interface CustomEventInfo {\n readonly type: \"custom\";\n }\n interface FetchResponseInfo {\n readonly type: \"fetch\";\n readonly statusCode: number;\n }\n type EventOutcome = \"ok\" | \"canceled\" | \"exception\" | \"unknown\" | \"killSwitch\" | \"daemonDown\" | \"exceededCpu\" | \"exceededMemory\" | \"loadShed\" | \"responseStreamDisconnected\" | \"scriptNotFound\";\n interface ScriptVersion {\n readonly id: string;\n readonly tag?: string;\n readonly message?: string;\n }\n interface Onset {\n readonly type: \"onset\";\n readonly attributes: Attribute[];\n // id for the span being opened by this Onset event.\n readonly spanId: string;\n readonly dispatchNamespace?: string;\n readonly entrypoint?: string;\n readonly executionModel: string;\n readonly scriptName?: string;\n readonly scriptTags?: string[];\n readonly scriptVersion?: ScriptVersion;\n readonly info: FetchEventInfo | JsRpcEventInfo | ScheduledEventInfo | AlarmEventInfo | QueueEventInfo | EmailEventInfo | TraceEventInfo | HibernatableWebSocketEventInfo | CustomEventInfo;\n }\n interface Outcome {\n readonly type: \"outcome\";\n readonly outcome: EventOutcome;\n readonly cpuTime: number;\n readonly wallTime: number;\n }\n interface SpanOpen {\n readonly type: \"spanOpen\";\n readonly name: string;\n // id for the span being opened by this SpanOpen event.\n readonly spanId: string;\n readonly info?: FetchEventInfo | JsRpcEventInfo | Attributes;\n }\n interface SpanClose {\n readonly type: \"spanClose\";\n readonly outcome: EventOutcome;\n }\n interface DiagnosticChannelEvent {\n readonly type: \"diagnosticChannel\";\n readonly channel: string;\n readonly message: any;\n }\n interface Exception {\n readonly type: \"exception\";\n readonly name: string;\n readonly message: string;\n readonly stack?: string;\n }\n interface Log {\n readonly type: \"log\";\n readonly level: \"debug\" | \"error\" | \"info\" | \"log\" | \"warn\";\n readonly message: object;\n }\n // This marks the worker handler return information.\n // This is separate from Outcome because the worker invocation can live for a long time after\n // returning. For example - Websockets that return an http upgrade response but then continue\n // streaming information or SSE http connections.\n interface Return {\n readonly type: \"return\";\n readonly info?: FetchResponseInfo;\n }\n interface Attribute {\n readonly name: string;\n readonly value: string | string[] | boolean | boolean[] | number | number[] | bigint | bigint[];\n }\n interface Attributes {\n readonly type: \"attributes\";\n readonly info: Attribute[];\n }\n type EventType = Onset | Outcome | SpanOpen | SpanClose | DiagnosticChannelEvent | Exception | Log | Return | Attributes;\n // Context in which this trace event lives.\n interface SpanContext {\n // Single id for the entire top-level invocation\n // This should be a new traceId for the first worker stage invoked in the eyeball request and then\n // same-account service-bindings should reuse the same traceId but cross-account service-bindings\n // should use a new traceId.\n readonly traceId: string;\n // spanId in which this event is handled\n // for Onset and SpanOpen events this would be the parent span id\n // for Outcome and SpanClose these this would be the span id of the opening Onset and SpanOpen events\n // For Hibernate and Mark this would be the span under which they were emitted.\n // spanId is not set ONLY if:\n // 1. This is an Onset event\n // 2. We are not inherting any SpanContext. (e.g. this is a cross-account service binding or a new top-level invocation)\n readonly spanId?: string;\n }\n interface TailEvent {\n // invocation id of the currently invoked worker stage.\n // invocation id will always be unique to every Onset event and will be the same until the Outcome event.\n readonly invocationId: string;\n // Inherited spanContext for this event.\n readonly spanContext: SpanContext;\n readonly timestamp: Date;\n readonly sequence: number;\n readonly event: Event;\n }\n type TailEventHandler = (event: TailEvent) => void | Promise;\n type TailEventHandlerObject = {\n outcome?: TailEventHandler;\n spanOpen?: TailEventHandler;\n spanClose?: TailEventHandler;\n diagnosticChannel?: TailEventHandler;\n exception?: TailEventHandler;\n log?: TailEventHandler;\n return?: TailEventHandler;\n attributes?: TailEventHandler;\n };\n type TailEventHandlerType = TailEventHandler | TailEventHandlerObject;\n}\n// Copyright (c) 2022-2023 Cloudflare, Inc.\n// Licensed under the Apache 2.0 license found in the LICENSE file or at:\n// https://opensource.org/licenses/Apache-2.0\n/**\n * Data types supported for holding vector metadata.\n */\ntype VectorizeVectorMetadataValue = string | number | boolean | string[];\n/**\n * Additional information to associate with a vector.\n */\ntype VectorizeVectorMetadata = VectorizeVectorMetadataValue | Record;\ntype VectorFloatArray = Float32Array | Float64Array;\ninterface VectorizeError {\n code?: number;\n error: string;\n}\n/**\n * Comparison logic/operation to use for metadata filtering.\n *\n * This list is expected to grow as support for more operations are released.\n */\ntype VectorizeVectorMetadataFilterOp = '$eq' | '$ne' | '$lt' | '$lte' | '$gt' | '$gte';\ntype VectorizeVectorMetadataFilterCollectionOp = '$in' | '$nin';\n/**\n * Filter criteria for vector metadata used to limit the retrieved query result set.\n */\ntype VectorizeVectorMetadataFilter = {\n [field: string]: Exclude | null | {\n [Op in VectorizeVectorMetadataFilterOp]?: Exclude | null;\n } | {\n [Op in VectorizeVectorMetadataFilterCollectionOp]?: Exclude[];\n };\n};\n/**\n * Supported distance metrics for an index.\n * Distance metrics determine how other \"similar\" vectors are determined.\n */\ntype VectorizeDistanceMetric = \"euclidean\" | \"cosine\" | \"dot-product\";\n/**\n * Metadata return levels for a Vectorize query.\n *\n * Default to \"none\".\n *\n * @property all Full metadata for the vector return set, including all fields (including those un-indexed) without truncation. This is a more expensive retrieval, as it requires additional fetching & reading of un-indexed data.\n * @property indexed Return all metadata fields configured for indexing in the vector return set. This level of retrieval is \"free\" in that no additional overhead is incurred returning this data. However, note that indexed metadata is subject to truncation (especially for larger strings).\n * @property none No indexed metadata will be returned.\n */\ntype VectorizeMetadataRetrievalLevel = \"all\" | \"indexed\" | \"none\";\ninterface VectorizeQueryOptions {\n topK?: number;\n namespace?: string;\n returnValues?: boolean;\n returnMetadata?: boolean | VectorizeMetadataRetrievalLevel;\n filter?: VectorizeVectorMetadataFilter;\n}\n/**\n * Information about the configuration of an index.\n */\ntype VectorizeIndexConfig = {\n dimensions: number;\n metric: VectorizeDistanceMetric;\n} | {\n preset: string; // keep this generic, as we'll be adding more presets in the future and this is only in a read capacity\n};\n/**\n * Metadata about an existing index.\n *\n * This type is exclusively for the Vectorize **beta** and will be deprecated once Vectorize RC is released.\n * See {@link VectorizeIndexInfo} for its post-beta equivalent.\n */\ninterface VectorizeIndexDetails {\n /** The unique ID of the index */\n readonly id: string;\n /** The name of the index. */\n name: string;\n /** (optional) A human readable description for the index. */\n description?: string;\n /** The index configuration, including the dimension size and distance metric. */\n config: VectorizeIndexConfig;\n /** The number of records containing vectors within the index. */\n vectorsCount: number;\n}\n/**\n * Metadata about an existing index.\n */\ninterface VectorizeIndexInfo {\n /** The number of records containing vectors within the index. */\n vectorCount: number;\n /** Number of dimensions the index has been configured for. */\n dimensions: number;\n /** ISO 8601 datetime of the last processed mutation on in the index. All changes before this mutation will be reflected in the index state. */\n processedUpToDatetime: number;\n /** UUIDv4 of the last mutation processed by the index. All changes before this mutation will be reflected in the index state. */\n processedUpToMutation: number;\n}\n/**\n * Represents a single vector value set along with its associated metadata.\n */\ninterface VectorizeVector {\n /** The ID for the vector. This can be user-defined, and must be unique. It should uniquely identify the object, and is best set based on the ID of what the vector represents. */\n id: string;\n /** The vector values */\n values: VectorFloatArray | number[];\n /** The namespace this vector belongs to. */\n namespace?: string;\n /** Metadata associated with the vector. Includes the values of other fields and potentially additional details. */\n metadata?: Record;\n}\n/**\n * Represents a matched vector for a query along with its score and (if specified) the matching vector information.\n */\ntype VectorizeMatch = Pick, \"values\"> & Omit & {\n /** The score or rank for similarity, when returned as a result */\n score: number;\n};\n/**\n * A set of matching {@link VectorizeMatch} for a particular query.\n */\ninterface VectorizeMatches {\n matches: VectorizeMatch[];\n count: number;\n}\n/**\n * Results of an operation that performed a mutation on a set of vectors.\n * Here, `ids` is a list of vectors that were successfully processed.\n *\n * This type is exclusively for the Vectorize **beta** and will be deprecated once Vectorize RC is released.\n * See {@link VectorizeAsyncMutation} for its post-beta equivalent.\n */\ninterface VectorizeVectorMutation {\n /* List of ids of vectors that were successfully processed. */\n ids: string[];\n /* Total count of the number of processed vectors. */\n count: number;\n}\n/**\n * Result type indicating a mutation on the Vectorize Index.\n * Actual mutations are processed async where the `mutationId` is the unique identifier for the operation.\n */\ninterface VectorizeAsyncMutation {\n /** The unique identifier for the async mutation operation containing the changeset. */\n mutationId: string;\n}\n/**\n * A Vectorize Vector Search Index for querying vectors/embeddings.\n *\n * This type is exclusively for the Vectorize **beta** and will be deprecated once Vectorize RC is released.\n * See {@link Vectorize} for its new implementation.\n */\ndeclare abstract class VectorizeIndex {\n /**\n * Get information about the currently bound index.\n * @returns A promise that resolves with information about the current index.\n */\n public describe(): Promise;\n /**\n * Use the provided vector to perform a similarity search across the index.\n * @param vector Input vector that will be used to drive the similarity search.\n * @param options Configuration options to massage the returned data.\n * @returns A promise that resolves with matched and scored vectors.\n */\n public query(vector: VectorFloatArray | number[], options?: VectorizeQueryOptions): Promise;\n /**\n * Insert a list of vectors into the index dataset. If a provided id exists, an error will be thrown.\n * @param vectors List of vectors that will be inserted.\n * @returns A promise that resolves with the ids & count of records that were successfully processed.\n */\n public insert(vectors: VectorizeVector[]): Promise;\n /**\n * Upsert a list of vectors into the index dataset. If a provided id exists, it will be replaced with the new values.\n * @param vectors List of vectors that will be upserted.\n * @returns A promise that resolves with the ids & count of records that were successfully processed.\n */\n public upsert(vectors: VectorizeVector[]): Promise;\n /**\n * Delete a list of vectors with a matching id.\n * @param ids List of vector ids that should be deleted.\n * @returns A promise that resolves with the ids & count of records that were successfully processed (and thus deleted).\n */\n public deleteByIds(ids: string[]): Promise;\n /**\n * Get a list of vectors with a matching id.\n * @param ids List of vector ids that should be returned.\n * @returns A promise that resolves with the raw unscored vectors matching the id set.\n */\n public getByIds(ids: string[]): Promise;\n}\n/**\n * A Vectorize Vector Search Index for querying vectors/embeddings.\n *\n * Mutations in this version are async, returning a mutation id.\n */\ndeclare abstract class Vectorize {\n /**\n * Get information about the currently bound index.\n * @returns A promise that resolves with information about the current index.\n */\n public describe(): Promise;\n /**\n * Use the provided vector to perform a similarity search across the index.\n * @param vector Input vector that will be used to drive the similarity search.\n * @param options Configuration options to massage the returned data.\n * @returns A promise that resolves with matched and scored vectors.\n */\n public query(vector: VectorFloatArray | number[], options?: VectorizeQueryOptions): Promise;\n /**\n * Use the provided vector-id to perform a similarity search across the index.\n * @param vectorId Id for a vector in the index against which the index should be queried.\n * @param options Configuration options to massage the returned data.\n * @returns A promise that resolves with matched and scored vectors.\n */\n public queryById(vectorId: string, options?: VectorizeQueryOptions): Promise;\n /**\n * Insert a list of vectors into the index dataset. If a provided id exists, an error will be thrown.\n * @param vectors List of vectors that will be inserted.\n * @returns A promise that resolves with a unique identifier of a mutation containing the insert changeset.\n */\n public insert(vectors: VectorizeVector[]): Promise;\n /**\n * Upsert a list of vectors into the index dataset. If a provided id exists, it will be replaced with the new values.\n * @param vectors List of vectors that will be upserted.\n * @returns A promise that resolves with a unique identifier of a mutation containing the upsert changeset.\n */\n public upsert(vectors: VectorizeVector[]): Promise;\n /**\n * Delete a list of vectors with a matching id.\n * @param ids List of vector ids that should be deleted.\n * @returns A promise that resolves with a unique identifier of a mutation containing the delete changeset.\n */\n public deleteByIds(ids: string[]): Promise;\n /**\n * Get a list of vectors with a matching id.\n * @param ids List of vector ids that should be returned.\n * @returns A promise that resolves with the raw unscored vectors matching the id set.\n */\n public getByIds(ids: string[]): Promise;\n}\n/**\n * The interface for \"version_metadata\" binding\n * providing metadata about the Worker Version using this binding.\n */\ntype WorkerVersionMetadata = {\n /** The ID of the Worker Version using this binding */\n id: string;\n /** The tag of the Worker Version using this binding */\n tag: string;\n /** The timestamp of when the Worker Version was uploaded */\n timestamp: string;\n};\ninterface DynamicDispatchLimits {\n /**\n * Limit CPU time in milliseconds.\n */\n cpuMs?: number;\n /**\n * Limit number of subrequests.\n */\n subRequests?: number;\n}\ninterface DynamicDispatchOptions {\n /**\n * Limit resources of invoked Worker script.\n */\n limits?: DynamicDispatchLimits;\n /**\n * Arguments for outbound Worker script, if configured.\n */\n outbound?: {\n [key: string]: any;\n };\n}\ninterface DispatchNamespace {\n /**\n * @param name Name of the Worker script.\n * @param args Arguments to Worker script.\n * @param options Options for Dynamic Dispatch invocation.\n * @returns A Fetcher object that allows you to send requests to the Worker script.\n * @throws If the Worker script does not exist in this dispatch namespace, an error will be thrown.\n */\n get(name: string, args?: {\n [key: string]: any;\n }, options?: DynamicDispatchOptions): Fetcher;\n}\ndeclare module 'cloudflare:workflows' {\n /**\n * NonRetryableError allows for a user to throw a fatal error\n * that makes a Workflow instance fail immediately without triggering a retry\n */\n export class NonRetryableError extends Error {\n public constructor(message: string, name?: string);\n }\n}\ndeclare abstract class Workflow {\n /**\n * Get a handle to an existing instance of the Workflow.\n * @param id Id for the instance of this Workflow\n * @returns A promise that resolves with a handle for the Instance\n */\n public get(id: string): Promise;\n /**\n * Create a new instance and return a handle to it. If a provided id exists, an error will be thrown.\n * @param options Options when creating an instance including id and params\n * @returns A promise that resolves with a handle for the Instance\n */\n public create(options?: WorkflowInstanceCreateOptions): Promise;\n /**\n * Create a batch of instances and return handle for all of them. If a provided id exists, an error will be thrown.\n * `createBatch` is limited at 100 instances at a time or when the RPC limit for the batch (1MiB) is reached.\n * @param batch List of Options when creating an instance including name and params\n * @returns A promise that resolves with a list of handles for the created instances.\n */\n public createBatch(batch: WorkflowInstanceCreateOptions[]): Promise;\n}\ntype WorkflowDurationLabel = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';\ntype WorkflowSleepDuration = `${number} ${WorkflowDurationLabel}${'s' | ''}` | number;\ntype WorkflowRetentionDuration = WorkflowSleepDuration;\ninterface WorkflowInstanceCreateOptions {\n /**\n * An id for your Workflow instance. Must be unique within the Workflow.\n */\n id?: string;\n /**\n * The event payload the Workflow instance is triggered with\n */\n params?: PARAMS;\n /**\n * The retention policy for Workflow instance.\n * Defaults to the maximum retention period available for the owner's account.\n */\n retention?: {\n successRetention?: WorkflowRetentionDuration;\n errorRetention?: WorkflowRetentionDuration;\n };\n}\ntype InstanceStatus = {\n status: 'queued' // means that instance is waiting to be started (see concurrency limits)\n | 'running' | 'paused' | 'errored' | 'terminated' // user terminated the instance while it was running\n | 'complete' | 'waiting' // instance is hibernating and waiting for sleep or event to finish\n | 'waitingForPause' // instance is finishing the current work to pause\n | 'unknown';\n error?: {\n name: string;\n message: string;\n };\n output?: unknown;\n};\ninterface WorkflowError {\n code?: number;\n message: string;\n}\ndeclare abstract class WorkflowInstance {\n public id: string;\n /**\n * Pause the instance.\n */\n public pause(): Promise;\n /**\n * Resume the instance. If it is already running, an error will be thrown.\n */\n public resume(): Promise;\n /**\n * Terminate the instance. If it is errored, terminated or complete, an error will be thrown.\n */\n public terminate(): Promise;\n /**\n * Restart the instance.\n */\n public restart(): Promise;\n /**\n * Returns the current status of the instance.\n */\n public status(): Promise;\n /**\n * Send an event to this instance.\n */\n public sendEvent({ type, payload, }: {\n type: string;\n payload: unknown;\n }): Promise;\n}\n" }, { "path": "wrangler.jsonc", "content": "{\n \"$schema\": \"node_modules/wrangler/config-schema.json\",\n \"name\": \"weft-dev\",\n \"main\": \"worker/index.ts\",\n \"compatibility_date\": \"2025-12-10\",\n \"workers_dev\": true,\n \"preview_urls\": false,\n \"compatibility_flags\": [\"nodejs_compat_v2\"],\n \"vars\": {\n \"AUTH_MODE\": \"none\",\n \"USER_ID\": \"dev-user\",\n \"USER_EMAIL\": \"dev@localhost\",\n },\n \"assets\": {\n \"directory\": \"./dist\",\n \"not_found_handling\": \"single-page-application\",\n },\n \"observability\": {\n \"enabled\": true,\n },\n \"workflows\": [\n {\n \"name\": \"agent-workflow\",\n \"binding\": \"AGENT_WORKFLOW\",\n \"class_name\": \"AgentWorkflow\",\n },\n ],\n \"containers\": [\n {\n \"class_name\": \"Sandbox\",\n \"image\": \"./Dockerfile\",\n \"instance_type\": \"standard-3\",\n \"max_instances\": 10,\n },\n ],\n \"durable_objects\": {\n \"bindings\": [\n {\n \"name\": \"BOARD_DO\",\n \"class_name\": \"BoardDO\",\n },\n {\n \"name\": \"USER_DO\",\n \"class_name\": \"UserDO\",\n },\n {\n \"name\": \"SANDBOX\",\n \"class_name\": \"Sandbox\",\n },\n ],\n },\n \"migrations\": [\n {\n \"tag\": \"v1\",\n \"new_sqlite_classes\": [\"BoardDO\", \"Sandbox\"],\n },\n {\n \"tag\": \"v2\",\n \"new_sqlite_classes\": [\"UserDO\"],\n },\n ],\n \"env\": {\n \"production\": {\n \"name\": \"weft\",\n \"vars\": {\n // AUTH_MODE: \"none\" = single user, no auth required\n // AUTH_MODE: \"access\" = multi-user with Cloudflare Access (set ACCESS_AUD/ACCESS_TEAM secrets)\n \"AUTH_MODE\": \"none\",\n \"USER_ID\": \"user\",\n \"USER_EMAIL\": \"user@localhost\",\n },\n \"workflows\": [\n {\n \"name\": \"weft-agent-workflow\",\n \"binding\": \"AGENT_WORKFLOW\",\n \"class_name\": \"AgentWorkflow\",\n },\n ],\n \"containers\": [\n {\n \"name\": \"weft-production-sandbox\",\n \"class_name\": \"Sandbox\",\n \"image\": \"./Dockerfile\",\n \"instance_type\": \"standard-3\",\n \"max_instances\": 10,\n },\n ],\n \"durable_objects\": {\n \"bindings\": [\n {\n \"name\": \"BOARD_DO\",\n \"class_name\": \"BoardDO\",\n },\n {\n \"name\": \"USER_DO\",\n \"class_name\": \"UserDO\",\n },\n {\n \"name\": \"SANDBOX\",\n \"class_name\": \"Sandbox\",\n },\n ],\n },\n },\n },\n}\n" } ]