@loicngr/kobo 2.1.13 → 2.1.16

package/src/mcp-server/README.md

@@ -2,7 +2,7 @@
 
 Standalone MCP (Model Context Protocol) server configured for each Claude Code or Codex agent running inside a workspace. Exposes workspace-scoped tools that the agent can invoke to interact with Kōbō state: tasks, settings, dev server, images, git, etc.
 
-Kōbō also exposes conversation tools to external MCP clients over HTTP and through the global stdio server.
+Kōbō also exposes workspace creation, PR checkout diagnosis and conversation tools to external MCP clients over HTTP and through the global stdio server.
 
 ## Connect an external LLM
 
@@ -162,6 +162,32 @@ conversation tools are described separately. The registration schemas in
 | `cron_list` | None | List this workspace's schedules. |
 | `cron_delete` | `id` | Cancel one of this workspace's schedules. |
 
+### Final auto-loop review
+
+`submit_final_review` (shown to agents as `kobo__submit_final_review`) is available
+only in the separate final-review session launched by Kōbō. It is not an external
+HTTP/global-stdio conversation tool or a general task-completion tool. Kōbō binds
+its capability to the active reviewer; the agent cannot select another workspace
+or session. Plan/read-only reviewers can submit this verdict without permission to
+modify files or tasks.
+
+Arguments: `summary` (non-empty, at most 12,000 characters) and `findings` (at most
+100 items). Each finding requires `severity` (`critical`, `important`, or `minor`),
+`file` (at most 1,000 characters), `description` and `recommendation` (each at most
+4,000 characters), with an optional positive integer `line`. The complete
+serialized verdict is capped at 60,000 characters. Include every actionable
+finding; use `findings: []` only when the entire mission and its acceptance
+criteria are clear. A prose-only report does not satisfy this completion gate.
+
+Submit one final verdict, then end the turn. Repeating an identical verdict is
+safe; replacing an already accepted verdict with different findings is refused.
+Kōbō turns findings into tasks, returns them to the original working session for
+automatic correction and final verification, and launches a fresh review. With no
+findings, the original session receives the result before the loop completes.
+This review/return state survives a client disconnect or server restart. An
+uncertain return delivery requires explicit retry/cancel in Kōbō; the reviewer
+must not try to bypass that decision. See [final review configuration](../../CONFIGURATION.md#final-review-for-auto-loop).
+
 ### Documents, context and history
 
 | Tool | Input | Purpose |
@@ -339,7 +365,7 @@ List all images uploaded to the current workspace via Kōbō's chat paste/upload
 
 ### Global tools (workspace-less mode)
 
-These 4 management tools and the 6 [conversation tools](#conversation-tools) are always registered, regardless of whether `KOBO_WORKSPACE_ID` is set — they let a session that Kōbō did NOT spawn (e.g. a standalone terminal session) discover, manage and talk to workspaces instead of being bound to one. The HTTP endpoint exposes discovery and conversation only.
+These management tools and the 6 [conversation tools](#conversation-tools) are registered regardless of whether `KOBO_WORKSPACE_ID` is set. Workspace-bound stdio, global stdio and external HTTP share creation, PR diagnosis, archive, purge, deletion and restoration tools. The HTTP endpoint also exposes discovery, conversation and memory; `stop_workspace` remains a stdio tool. Restricted final-review and handoff sessions cannot call creation or lifecycle mutation tools.
 
 #### `list_workspaces`
 List Kōbō workspaces with id, title, status, and creation date. Reads the DB directly — works even when the Kōbō backend server isn't running.
@@ -352,28 +378,113 @@ List Kōbō workspaces with id, title, status, and creation date. Reads the DB d
 ---
 
 #### `create_workspace`
-Create a new workspace (git worktree + agent session), like the "Créer" button on the Create page. Requires the Kōbō backend server to be running and reachable at `KOBO_BACKEND_URL` — this API has no automatic branch-name derivation from the workspace name, unlike the UI.
+Create a workspace through the same backend handlers as the Create page, including worktree setup, imports, attachments, auto-loop and final review. The backend must be running. Inputs use snake_case; returned `Workspace` fields use the HTTP API's camelCase.
 
-**Input:**
-- `name`, `project_path`, `source_branch`, `working_branch` (string, required)
-- `model`, `reasoning_effort`, `engine`, `description` (string, optional)
-- `tasks`, `acceptance_criteria` (string[], optional)
-- `agent_permission_mode` (`plan | bypass | strict | interactive`, optional)
-- `auto_loop` (boolean, optional), `auto_loop_session_mode` (`per_task | continuous`, optional)
-- `skip_setup_script` (boolean, optional)
+| Inputs | Meaning |
+|---|---|
+| `name`, `project_path` | Required. Select a project configured in Kōbō. |
+| `source_branch`, `working_branch` | Required for ordinary creation; supply branch names explicitly. With `worktree_path`, only `source_branch` is required. With `pr_url`, canonical PR base/head branches are derived. |
+| `engine`, `model`, `reasoning_effort`, `agent_permission_mode` | Same engine and permissions as the form (`claude-code` / `codex`; `plan` / `bypass` / `strict` / `interactive`, subject to engine support). |
+| `description`, `tags`, `tasks`, `acceptance_criteria` | Description and arrays of strings. |
+| `auto_loop`, `auto_loop_session_mode` | Enable auto-loop; mode is `per_task` or `continuous`. |
+| `brainstorm_model`, `brainstorm_reasoning_effort` | Separate initial brainstorm configuration, on the workspace's engine. |
+| `auto_loop_final_review` | Reviewer `{engine, model, reasoning_effort, additional_instructions?}`; uses the same durable review/correction cycle as the form. |
+| `workflow_policy` | Optional `commit`, `push`, `publish`, each `manual` or `automatic`. |
+| `notion_url`, `notion_page_id`, `sentry_url` | `notion_url` or `sentry_url` imports ticket context using the enabled, configured integration. `notion_page_id` stores an optional identifier; it does not import content on its own. |
+| `pr_url`, `pr_checkout` | Resume a PR/MR through diagnosis and checkout; see below. |
+| `worktree_path`, `skip_setup_script` | Reuse an existing worktree or control the setup script. PR checkout skips setup by default; explicit `false` runs it. |
+| `comparison_id`, `creation_id` | Group separate creations for comparison; correlate creation progress. These are not idempotency keys. |
+| `attachments` | Up to 10 `{name, mime_type, data_base64}` files, 50 MiB decoded total. Same file types as the form; send inline base64, never a server file path. |
+
+For an engine comparison, create two workspaces with distinct working branches and the same `comparison_id`, configuring each engine separately. Selecting a saved form preset in an MCP client means sending its effective field values.
+
+Example with final review:
+
+```json
+{
+  "name": "Implement feature",
+  "project_path": "/home/me/project",
+  "source_branch": "develop",
+  "working_branch": "feature/example",
+  "engine": "codex",
+  "auto_loop": true,
+  "auto_loop_final_review": {
+    "engine": "claude-code",
+    "model": "opus",
+    "reasoning_effort": "high",
+    "additional_instructions": "Check regressions and tests"
+  },
+  "workflow_policy": { "commit": "manual", "push": "manual", "publish": "manual" }
+}
+```
+
+**Result:** a created `Workspace`, or `{created: false, requiresAction: true, report, pr, fingerprint, reason?}` when PR checkout needs decisions. Opening/unarchiving an existing workspace returns `{created: false, workspaceId, workspace}`. Cancellation returns `{created: false, cancelled: true, ...}`. Backend errors are MCP errors with `{error, status, stage, details}` so stale checkout reports remain available.
+
+If creation fails after PR checkout, Kōbō removes only the checkout created by that request when its directory, branch and HEAD are unchanged, it has no local or ignored files, and no workspace adopted it. The PR branch and earlier checkout decisions remain intact. Existing, modified or adopted checkouts are preserved. Errors include `details.checkoutRecovery` with the path, `removed` outcome and a reason when retained. An uncertain creation outcome preserves the checkout for inspection; do not retry automatically.
 
-**Output:** created `Workspace`
+Creation requests have no automatic retry or exactly-once guarantee. After a disconnect/timeout, inspect `list_workspaces` before trying again: checkout or creation may have completed. The stdio bridge allows up to 15 minutes for creation; external clients should configure their own request timeout for slow setup scripts. Ordinary MCP requests retain the 1 MiB envelope limit; creation allows base64 expansion of the 50 MiB upload limit plus 1 MiB metadata, including at the SDK HTTP and stdio transport boundaries.
+
+#### `diagnose_workspace_pr`
+
+**Input:** `{project_path, pr_url}`. Returns `{report, pr, fingerprint}` for the configured forge and the PR's local Git state. Creates no workspace and applies no checkout changes.
+
+1. Call `diagnose_workspace_pr` to inspect the PR. A clean PR can also be passed directly to `create_workspace` using only `name`, `project_path`, `pr_url` and the desired agent options.
+2. When checkout needs a choice, call `create_workspace` with the same PR and `pr_checkout: {fingerprint, decisions}`. Use the returned fingerprint, not a guessed value. Missing choices return `requiresAction`; stale state returns an error with the current report.
+3. Inspect the result before continuing. Existing workspaces can be opened or unarchived; use `restore_workspace` first for a purged checkout. No duplicate workspace is created automatically.
+
+`decisions` uses the existing checkout contract's camelCase keys: `existingWorkspace: "open"`, `archivedWorkspace: "unarchive"`, `orphanWorktree: "attach" | "create-elsewhere"`, `pathCollision: {worktreePath}`, `localChanges: "stash" | "commit" | "discard" | "keep"`, `ongoingOperation: "abort" | "cancel"`, `divergence: "fast-forward" | "rebase" | "reset-hard" | "keep"`. Destructive choices must be supplied explicitly. The backend rechecks Git state under its checkout lock before applying them. Forks, unavailable forge CLIs and other blockers are reported using the same rules as the form.
 
 ---
 
 #### `archive_workspace`
-Archive a workspace by id, like the "Archiver" action in the workspace context menu. Requires the backend to be running.
+Archive a workspace by id, like the "Archiver" action in the workspace context menu. Stops its processes and auto-loop, preserves checkout and history, and may run the configured archive script. Available on internal stdio, global stdio and external HTTP; requires the backend to be running.
 
 **Input:**
 - `workspace_id` (string, required) — from `list_workspaces`
 
 ---
 
+#### `purge_workspace_worktree`
+
+Free disk space by removing a Kōbō-owned checkout and archiving the workspace. Conversation history and recovery metadata remain available; uncommitted files are not recoverable. External attached worktrees are protected.
+
+**Input:** `{workspace_id, confirm_purge: true}`.
+
+**Output:** `{workspace, warnings, outcome}` from the existing purge lifecycle. Inspect warnings and outcome: a failed removal does not mean disk space was freed.
+
+#### `delete_workspace`
+
+Permanently delete one workspace and its history, with the same branch options as the deletion dialog. Stops processes and removes its owned checkout; externally managed worktrees are preserved.
+
+**Input:**
+
+```json
+{
+  "workspace_id": "workspace-id",
+  "confirm_delete": true,
+  "confirmation_branch": "feature/example",
+  "delete_local_branch": true,
+  "delete_remote_branch": true
+}
+```
+
+Both branch flags default to `false`; remote deletion requires local deletion too, as in the form. `confirmation_branch` must match the current working branch for every deletion. The backend checks it again under the lifecycle lock before any teardown; branch rename and resynchronization are rejected while this operation is in progress. Bulk deletion through the reserved `archived` endpoint is not exposed.
+
+**Output:** `{ok: true, workspaceId, warnings: []}` after a clean 204 response, or the backend's `{ok: true, warnings}` when cleanup was incomplete. Preserve these warnings: deletion of the workspace record can succeed while branch or disk cleanup fails.
+
+#### `unarchive_workspace` and `restore_workspace`
+
+Both accept `{workspace_id}` and are available on all three MCP transports.
+
+- `unarchive_workspace` restores visibility when the checkout is still present, preserving the workspace's prior status. A purged checkout is refused; use `restore_workspace`.
+- `restore_workspace` checks or recreates the Kōbō-owned worktree using the existing recovery service, then unarchives the workspace. It preserves chat history, returns the final workspace with restoration outcome/source, and starts no agent or setup script. An already active, non-purged workspace is returned unchanged.
+
+Restoration reuses the saved Git recovery information and retains the existing ownership/path/conflict checks. A checkout deleted manually without purge metadata may return `not-purged`; a workspace whose database record and history were permanently deleted cannot be restored by these tools.
+
+Lifecycle errors preserve `{error, status, stage, details}`. No automatic mutation retries occur. A connection can close while an operation finishes, especially when an agent archives or deletes its own workspace; inspect current state before repeating a request.
+
+---
+
 #### `stop_workspace`
 Stop the currently running agent session on a workspace, like the Stop action in the chat header. Also disables auto-loop and cancels a queued replacement. Requires the backend to be running. Safe to call when nothing is running; an unconfirmed shutdown is reported as an error.
 
@@ -414,3 +525,36 @@ Automatic mode means the agent deliberately calls `remember` when it has stable,
 - **Notifications**: `mark_task_done` hits `POST /tasks/:id/notify-done`, while `create_task` / `update_task` / `delete_task` hit `POST /tasks/notify-updated`. Both cause the backend to emit a `task:updated` WS event so the Vue UI refreshes.
 - **Workspace scoping**: every handler that touches tasks uses `WHERE workspace_id = ?` to prevent cross-workspace access, even if the LLM passes a task_id from another workspace.
 - **Error handling**: the MCP dispatcher wraps every tool call in a `try/catch` and returns `{ isError: true, content: [{ type: 'text', text: 'Error: ...' }] }` on failure. Handlers should throw with descriptive messages.
+
+### Group messages
+
+The UI, workspace-bound stdio, global stdio and external HTTP MCP share the same
+backend delivery service. The MCP exposes three tools:
+
+1. `preview_workspace_group_message`: select optional `tags`, `statuses`, and
+   `dev_server_running` (boolean, default false). Set it to true to keep only
+   workspaces with development server status `running`.
+   Tags match any selected tag, statuses match any selected status, and all enabled
+   filters intersect. Empty filters match all non-archived, non-purged workspaces.
+   Results include `workspaceId`, `name`, `tags`, `status`, and `delivery`, sorted
+   by workspace ID. Use `limit` (1–200, default 200) and `offset` (default 0),
+   checking `total` to paginate. Preview is live, not a reservation.
+2. `send_workspace_group_message`: supply a unique `request_id`, an explicit
+   `workspace_ids` list (1–200 distinct IDs), and `content` (up to 100,000
+   characters). Filters and wildcards cannot substitute for selected IDs.
+   Workspace-bound agents cannot include their own workspace. Manual targets
+   receive immediately; auto-loop targets queue for their next iteration.
+3. `get_workspace_group_message`: inspect the durable receipt using `request_id`.
+   Submission returns promptly; `complete` and each recipient's `state` track
+   delivery separately (`pending`, `sending`, `sent`, `queued`, `rejected`,
+   `unknown`, or `not_sent`). `queued` confirms enqueueing, not execution.
+
+Repeating the same request ID with the same content, recipients and MCP source
+returns its receipt without sending again. Reusing that ID with different input
+fails. Ineligible recipients fail individually without discarding other results.
+After a server interruption, undelivered recipients become `not_sent` and
+ambiguous dispatches become `unknown`; neither is automatically resent. Inspect
+workspace history before issuing another request for an uncertain recipient.
+MCP client name and HTTP/stdio provenance remain attached to delivered messages.
+Read-only final-review and handoff launches expose preview and receipt lookup,
+but cannot submit a group message.

package/src/mcp-server/kobo-tasks-server.ts

@@ -5,7 +5,14 @@ import { CallToolRequestSchema, ListToolsRequestSchema, type Tool } from '@model
 import type Database from 'better-sqlite3'
 import { getDb } from '../server/db/index.js'
 import { EXTERNAL_MEMORY_TOOL_DEFINITIONS, isMemoryToolName, MEMORY_TOOL_DEFINITIONS } from '../shared/memory-tools.js'
+import {
+  isWorkspaceCreationTool,
+  MAX_MCP_CREATION_REQUEST_BYTES,
+  WORKSPACE_CREATION_TOOLS,
+} from '../shared/workspace-creation-tools.js'
 import { WORKSPACE_DIALOGUE_TOOLS } from '../shared/workspace-dialogue-tools.js'
+import { isWorkspaceGroupMessageTool, WORKSPACE_GROUP_MESSAGE_TOOLS } from '../shared/workspace-group-message-tools.js'
+import { isWorkspaceLifecycleTool, WORKSPACE_LIFECYCLE_TOOLS } from '../shared/workspace-lifecycle-tools.js'
 import {
   createTaskHandler,
   cronListHandler,
@@ -30,6 +37,8 @@ import {
 import { callMemoryTool, isMemoryOutputSuppressed } from './memory-client.js'
 import { callWorkspaceDialogueTool } from './workspace-dialogue-client.js'
 
+const finalReviewToken = process.env.KOBO_FINAL_REVIEW_TOKEN
+const finalReviewSessionId = process.env.KOBO_FINAL_REVIEW_SESSION_ID
 const handoffId = process.env.KOBO_HANDOFF_ID
 const handoffToken = process.env.KOBO_HANDOFF_TOKEN
 const workspaceId = process.env.KOBO_WORKSPACE_ID
@@ -184,6 +193,34 @@ const TASK_ORDER_PROPERTIES = {
 }
 
 const WORKSPACE_SCOPED_TOOLS: Tool[] = [
+  {
+    name: 'submit_final_review',
+    description:
+      'Submit the final structured verdict for this backend-owned auto-loop review, then end your turn. Include all actionable findings; use an empty findings array only when the entire mission is clear.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        summary: { type: 'string', minLength: 1, maxLength: 12000 },
+        findings: {
+          type: 'array',
+          maxItems: 100,
+          items: {
+            type: 'object',
+            properties: {
+              severity: { type: 'string', enum: ['critical', 'important', 'minor'] },
+              file: { type: 'string', minLength: 1, maxLength: 1000 },
+              line: { type: 'integer', minimum: 1 },
+              description: { type: 'string', minLength: 1, maxLength: 4000 },
+              recommendation: { type: 'string', minLength: 1, maxLength: 4000 },
+            },
+            required: ['severity', 'file', 'description', 'recommendation'],
+          },
+        },
+      },
+      required: ['summary', 'findings'],
+    },
+    annotations: { destructiveHint: false, openWorldHint: false },
+  },
   {
     name: 'submit_session_handoff',
     description:
@@ -605,6 +642,9 @@ const WORKSPACE_SCOPED_TOOLS: Tool[] = [
 
 const GLOBAL_TOOLS: typeof WORKSPACE_SCOPED_TOOLS = [
   ...WORKSPACE_DIALOGUE_TOOLS,
+  ...WORKSPACE_CREATION_TOOLS,
+  ...WORKSPACE_LIFECYCLE_TOOLS,
+  ...WORKSPACE_GROUP_MESSAGE_TOOLS,
   ...EXTERNAL_MEMORY_TOOL_DEFINITIONS,
   {
     name: 'list_workspaces',
@@ -627,65 +667,6 @@ const GLOBAL_TOOLS: typeof WORKSPACE_SCOPED_TOOLS = [
     },
     annotations: { readOnlyHint: true, openWorldHint: false },
   },
-  {
-    name: 'create_workspace',
-    description:
-      'Create a new Kōbō workspace (git worktree + agent session), like the "Créer" button on the Create page. Requires the Kōbō backend server to be running and reachable at KOBO_BACKEND_URL. name/project_path/source_branch/working_branch are mandatory — unlike the UI, this API does not auto-derive a branch name from the workspace name.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        name: { type: 'string', description: 'Workspace display name.' },
-        project_path: { type: 'string', description: 'Absolute path to the project on disk.' },
-        source_branch: { type: 'string', description: 'Branch to base the new worktree on (e.g. "develop").' },
-        working_branch: {
-          type: 'string',
-          description: 'New branch name for the worktree (e.g. "feature/my-thing").',
-        },
-        model: { type: 'string', description: 'Model id override (optional, defaults to project/global setting).' },
-        reasoning_effort: { type: 'string', description: 'Reasoning effort override (optional).' },
-        engine: { type: 'string', description: 'Agent engine id, e.g. "claude-code" or "codex" (optional).' },
-        description: { type: 'string', description: 'Task description / initial brainstorming prompt (optional).' },
-        tags: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Workspace tags to assign at creation (optional).',
-        },
-        tasks: { type: 'array', items: { type: 'string' }, description: 'Initial manual task titles (optional).' },
-        acceptance_criteria: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Initial manual acceptance criteria (optional).',
-        },
-        agent_permission_mode: {
-          type: 'string',
-          enum: ['plan', 'bypass', 'strict', 'interactive'],
-          description: 'Permission mode for the new session (optional).',
-        },
-        auto_loop: { type: 'boolean', description: 'Start the workspace in auto-loop mode (optional).' },
-        auto_loop_session_mode: {
-          type: 'string',
-          enum: ['per_task', 'continuous'],
-          description: "Auto-loop session mode when auto_loop is true (optional, default 'per_task').",
-        },
-        skip_setup_script: { type: 'boolean', description: "Skip the project's setup script (optional)." },
-      },
-      required: ['name', 'project_path', 'source_branch', 'working_branch'],
-    },
-    annotations: { destructiveHint: false, openWorldHint: false },
-  },
-  {
-    name: 'archive_workspace',
-    description:
-      'Archive a workspace by id, like the "Archiver" action in the workspace context menu. Requires the Kōbō backend server to be running.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        workspace_id: { type: 'string', description: 'Workspace id, from list_workspaces.' },
-      },
-      required: ['workspace_id'],
-    },
-    annotations: { destructiveHint: false, openWorldHint: false },
-  },
   {
     name: 'stop_workspace',
     description:
@@ -718,7 +699,9 @@ function availableTools(): Tool[] {
   return tools.filter((tool) =>
     handoffId && handoffToken
       ? tool.name === 'submit_session_handoff' || tool.annotations?.readOnlyHint === true
-      : tool.name !== 'submit_session_handoff',
+      : finalReviewToken && finalReviewSessionId
+        ? tool.name === 'submit_final_review' || tool.annotations?.readOnlyHint === true
+        : tool.name !== 'submit_session_handoff' && tool.name !== 'submit_final_review',
   )
 }
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: availableTools() }))
@@ -757,6 +740,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   }
 
   try {
+    if (finalReviewToken && finalReviewSessionId && !availableTools().some((tool) => tool.name === name))
+      return fail('This is a read-only final review. Only read tools and submit_final_review are available.')
+    if (name === 'submit_final_review') {
+      if (!workspaceId || !finalReviewToken || !finalReviewSessionId)
+        return fail('No final review is active for this MCP invocation.')
+      return ok(
+        await backendRequest('POST', `/api/workspaces/${workspaceId}/auto-loop/final-review/report`, {
+          token: finalReviewToken,
+          sessionId: finalReviewSessionId,
+          report: a,
+        }),
+      )
+    }
     if (handoffId && handoffToken && !availableTools().some((tool) => tool.name === name))
       return fail(
         'This turn is reserved for a handoff report. Only read tools and submit_session_handoff are available.',
@@ -800,8 +796,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           : {}),
       }
     }
-    if (WORKSPACE_DIALOGUE_TOOLS.some((tool) => tool.name === name)) {
-      if (workspaceId && a.workspace_id === workspaceId && name === 'send_workspace_message')
+    if (
+      isWorkspaceCreationTool(name) ||
+      isWorkspaceLifecycleTool(name) ||
+      isWorkspaceGroupMessageTool(name) ||
+      WORKSPACE_DIALOGUE_TOOLS.some((tool) => tool.name === name)
+    ) {
+      if (
+        workspaceId &&
+        ((a.workspace_id === workspaceId && name === 'send_workspace_message') ||
+          (name === 'send_workspace_group_message' &&
+            Array.isArray(a.workspace_ids) &&
+            a.workspace_ids.includes(workspaceId)))
+      )
         return fail('Use the normal conversation to communicate in your own workspace.')
       return await callWorkspaceDialogueTool(
         backendUrl,
@@ -1098,49 +1105,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       return ok(listWorkspacesHandler(db, { includeArchived, tag }))
     }
 
-    if (name === 'create_workspace') {
-      const workspaceName = a.name as string | undefined
-      const projectPath = a.project_path as string | undefined
-      const sourceBranch = a.source_branch as string | undefined
-      const workingBranch = a.working_branch as string | undefined
-      if (!workspaceName || !projectPath || !sourceBranch || !workingBranch) {
-        return fail('name, project_path, source_branch, and working_branch parameters are required')
-      }
-      try {
-        const created = await backendRequest('POST', '/api/workspaces', {
-          name: workspaceName,
-          projectPath,
-          sourceBranch,
-          workingBranch,
-          model: a.model as string | undefined,
-          reasoningEffort: a.reasoning_effort as string | undefined,
-          engine: a.engine as string | undefined,
-          description: a.description as string | undefined,
-          tags: a.tags as string[] | undefined,
-          tasks: a.tasks as string[] | undefined,
-          acceptanceCriteria: a.acceptance_criteria as string[] | undefined,
-          agentPermissionMode: a.agent_permission_mode as string | undefined,
-          autoLoop: a.auto_loop as boolean | undefined,
-          autoLoopSessionMode: a.auto_loop_session_mode as string | undefined,
-          skipSetupScript: a.skip_setup_script as boolean | undefined,
-        })
-        return ok(created)
-      } catch (err) {
-        return fail(backendErrorMessage(err))
-      }
-    }
-
-    if (name === 'archive_workspace') {
-      const targetId = a.workspace_id as string | undefined
-      if (!targetId) return fail('workspace_id parameter is required')
-      try {
-        const result = await backendRequest('POST', `/api/workspaces/${targetId}/archive`)
-        return ok(result)
-      } catch (err) {
-        return fail(backendErrorMessage(err))
-      }
-    }
-
     if (name === 'stop_workspace') {
       const targetId = a.workspace_id as string | undefined
       if (!targetId) return fail('workspace_id parameter is required')
@@ -1158,7 +1122,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   }
 })
 
-const transport = new StdioServerTransport()
+const transport = new StdioServerTransport(process.stdin, process.stdout, {
+  // Include the JSON-lines delimiter in addition to the HTTP envelope budget.
+  maxBufferSize: MAX_MCP_CREATION_REQUEST_BYTES + 1,
+})
 server.connect(transport).catch((err) => {
   console.error('[kobo-tasks-server] Fatal:', err)
   process.exit(1)

package/src/mcp-server/workspace-dialogue-client.ts

@@ -1,7 +1,13 @@
 import { Client } from '@modelcontextprotocol/sdk/client/index.js'
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'
 import { isMemoryToolName, validateMemoryToolArguments } from '../shared/memory-tools.js'
+import { isWorkspaceCreationTool, validateWorkspaceCreationArguments } from '../shared/workspace-creation-tools.js'
 import { validateDialogueArguments } from '../shared/workspace-dialogue-tools.js'
+import {
+  isWorkspaceGroupMessageTool,
+  validateWorkspaceGroupMessageArguments,
+} from '../shared/workspace-group-message-tools.js'
+import { isWorkspaceLifecycleTool, validateWorkspaceLifecycleArguments } from '../shared/workspace-lifecycle-tools.js'
 import { normalizeClientName } from '../shared/workspace-message-types.js'
 
 /** Stateless HTTP bridge: external stdio clients never own agent runtime state. */
@@ -14,9 +20,18 @@ export async function callWorkspaceDialogueTool(
 ) {
   const arguments_ = isMemoryToolName(name)
     ? validateMemoryToolArguments(name, args, true)
-    : validateDialogueArguments(name, args)
+    : isWorkspaceCreationTool(name)
+      ? validateWorkspaceCreationArguments(name, args)
+      : isWorkspaceLifecycleTool(name)
+        ? validateWorkspaceLifecycleArguments(name, args)
+        : isWorkspaceGroupMessageTool(name)
+          ? validateWorkspaceGroupMessageArguments(name, args)
+          : validateDialogueArguments(name, args)
   const client = new Client({ name: 'kobo-stdio-bridge', version: '1.0.0' })
-  const signal = AbortSignal.timeout(30_000)
+  // Creation can include forge reads, worktree setup and user setup scripts.
+  // A timed-out creation is ambiguous and must never be retried automatically.
+  const timeout = isWorkspaceCreationTool(name) || isWorkspaceLifecycleTool(name) ? 15 * 60_000 : 30_000
+  const signal = AbortSignal.timeout(timeout)
   const transport = new StreamableHTTPClientTransport(new URL(`${backendUrl.replace(/\/$/, '')}/api/mcp`), {
     requestInit: {
       signal,
@@ -30,7 +45,7 @@ export async function callWorkspaceDialogueTool(
   })
   try {
     await client.connect(transport, { signal })
-    return await client.callTool({ name, arguments: arguments_ }, undefined, { signal })
+    return await client.callTool({ name, arguments: arguments_ }, undefined, { signal, timeout })
   } finally {
     await client.close()
   }

package/src/client/dist/pwa/assets/ActivityFeed-BTRzc60o.js

@@ -1,2 +0,0 @@
-import{M as e,S as t,dt as n,lt as r,p as i,pt as a,v as o}from"./reactivity.esm-bundler-DY1JkAEA.js";import{C as s,F as c,J as l,L as u,N as d,O as f,P as p,T as m,Y as h,_ as g,d as _,f as v,g as y,j as ee,k as b,l as x,p as S,r as C,u as w,y as T,z as te}from"./runtime-core.esm-bundler-Bqg71Vll.js";import{$ as ne,K as re,M as E,f as ie,z as ae}from"./dom-BtYTvLeN.js";import{l as oe,t as D,u as se}from"./QBtn-BUSdPaf4.js";import{Bt as ce,O as le,Qt as ue,Ut as de,Yt as fe,an as O,at as pe,cn as k,ft as me,j as he,m as ge,mt as _e,ot as ve,pt as ye,v as be}from"./index-ImUH7Bbt.js";import{t as xe}from"./QSpinnerDots-xdWyaE1i.js";import{t as Se}from"./QList-Cx1UfaUm.js";import{t as Ce}from"./QMarkupTable-UhP7fVUp.js";import{c as A,l as j,s as M}from"./QSelect-MdPXvwm4.js";import{t as N}from"./QItemSection-MdJ1_ZK7.js";import{t as we}from"./QExpansionItem-D33aoRoG.js";import{a as P,c as Te,r as F,t as I}from"./ToolCallItem-cSHh3p_F.js";import{t as Ee}from"./QScrollArea-Di-D6t2u.js";import{a as L}from"./use-tours-6yxNVmjH.js";import{f as De,g as R,m as Oe,p as ke,u as Ae}from"./use-worktree-restore-BM3Giig1.js";import{t as z}from"./QTooltip-BhwG7lp2.js";import{n as B}from"./render-chat-markdown-CafzCcmu.js";import{n as V}from"./WorkspacePage-BwUkijpS.js";function je(e,t){return s(`div`,e,[s(`table`,{class:`q-table`},t)])}var Me={list:Se,table:Ce},H=[`list`,`table`,`__qtable`],Ne=ae({name:`QVirtualScroll`,props:{...j,type:{type:String,default:`list`,validator:e=>H.includes(e)},items:{type:Array,default:()=>[]},itemsFn:Function,itemsSize:Number,scrollTarget:k},setup(e,{slots:n,attrs:r}){let i,a=t(null),o=x(()=>e.itemsSize>=0&&e.itemsFn!==void 0?Number.parseInt(e.itemsSize,10):Array.isArray(e.items)?e.items.length:0),{virtualScrollSliceRange:c,localResetVirtualScroll:u,padVirtualScroll:f,onVirtualScrollEvt:m}=A({virtualScrollLength:o,getVirtualScrollTarget:y,getVirtualScrollEl:v}),h=x(()=>{if(o.value===0)return[];let t=(e,t)=>({index:c.value.from+t,item:e});return e.itemsFn===void 0?e.items.slice(c.value.from,c.value.to).map(t):e.itemsFn(c.value.from,c.value.to-c.value.from).map(t)}),g=x(()=>`q-virtual-scroll q-virtual-scroll`+(e.virtualScrollHorizontal?`--horizontal`:`--vertical`)+(e.scrollTarget===void 0?` scroll`:``)),_=x(()=>e.scrollTarget===void 0?{tabindex:0}:{});l(o,()=>{u()}),l(()=>e.scrollTarget,()=>{C(),S()});function v(){let e=a.value;return e===null?null:e.$el||e}function y(){return i}function S(){let t=v();t!==null&&(i=O(t,e.scrollTarget),i.addEventListener(`scroll`,m,E.passive))}function C(){i!==void 0&&(i.removeEventListener(`scroll`,m,E.passive),i=void 0)}function w(){let t=f(e.type===`list`?`div`:`tbody`,h.value.map(n.default));return n.before!==void 0&&(t=n.before().concat(t)),ie(n.after,t)}return u(),p(()=>{S()}),b(()=>{S()}),d(()=>{C()}),ee(()=>{C()}),()=>{if(n.default===void 0){console.error(`QVirtualScroll: default scoped slot is required for rendering`);return}return e.type===`__qtable`?je({ref:a,class:`q-table__middle `+g.value,tabindex:0},w()):s(Me[e.type],{...r,ref:a,class:[r.class,g.value],..._.value},w)}}}),Pe=new Set([`setup`,`cleanup`,`archive`]);function Fe(e){switch(e.type){case`user`:return e.sender===`system-prompt`?`system-prompt`:Pe.has(e.sender)||le(e.sender)?`script`:`user`;case`session`:return`session`;default:return`agent`}}function Ie(e){let t=[],n=null,r=null;for(let i of e){let e=Fe(i),a=e===`session`||e===`system-prompt`,o=e===`script`&&i.type===`user`?`script:${i.sender}`:e===`user`&&i.type===`user`&&i.source?JSON.stringify([`mcp`,i.source.transport,i.source.clientName]):e;!n||r!==o||a?(n={speaker:e,ts:i.ts,items:[i]},r=o,t.push(n),a&&(n=null)):n.items.push(i)}return t}function U(e){switch(e.type){case`text`:return`text:${e.messageId}`;case`thinking`:return`thinking:${e.messageId}:${e.eventIds?.[0]??e.ts??``}`;case`tool`:return`tool:${e.toolCallId}`;case`session`:return`session:${e.kind}:${e.eventIds?.[0]??e.ts??``}`;case`user`:return`user:${e.eventIds?.[0]??`${e.sender}:${e.ts??``}`}`;case`error`:return`error:${e.eventIds?.[0]??`${e.category}:${e.ts??``}`}`}}function Le(e){let t=e.items[0];return`${e.speaker}:${t?U(t):`empty`}`}function Re(e,t){let n=Math.min(t,e.length)-1;for(let t=n;t>=0;t--)if(e[t]?.speaker===`user`)return t;return-1}function ze(e,t,n){return new Promise(r=>{let i=!1,a=null,o=null,s=e=>{i||(i=!0,a!==null&&clearTimeout(a),a=null,o?.(),r(e))};if(o=l(e,e=>{t(e)&&s(!0)},{immediate:!0}),i){o();return}a=setTimeout(()=>s(!1),n)})}var Be={class:`agent-error-item`},Ve={class:`agent-error-item__body`},He={class:`agent-error-item__title`},W={class:`agent-error-item__message`},Ue=L(T({__name:`AgentErrorItem`,props:{item:{}},setup(e){let t=e,{te:n}=fe(),r=x(()=>{let e=`agent.error.${t.item.category}`;return n(e)?e:`agent.error.other`});return(t,n)=>(u(),S(`div`,Be,[g(oe,{name:`error_outline`,size:`16px`,class:`agent-error-item__icon`}),w(`div`,Ve,[w(`div`,He,a(t.$t(r.value)),1),w(`div`,W,a(e.item.message),1)])]))}}),[[`__scopeId`,`data-v-e98c3c02`]]),We={class:`text-caption text-kobo-3`},Ge=T({__name:`SessionEventItem`,props:{item:{}},setup(e){let t=e,n=x(()=>{switch(t.item.kind){case`started`:return`session.started`;case`ended`:return R(t.item.detail);case`compacted`:return`session.compacted`;default:return`session.started`}});return(e,t)=>(u(),S(`span`,We,a(e.$t(n.value)),1))}}),G=new Map;function K(){for(let e of G.values())e.controller.abort(),e.blobUrl&&URL.revokeObjectURL(e.blobUrl);G.clear()}typeof window<`u`&&(window.addEventListener(`kobo:auth-token-changed`,K),window.addEventListener(`storage`,e=>{(e.key===`kobo:network-token`||e.key===null)&&K()}));function q(e){if(!/^\/api\/workspaces\/[^/]+\/images\/file\?path=/.test(e))throw Error(`Invalid workspace image URL`);let t=G.get(e);if(!t){let n=new AbortController,r={references:0,controller:n,ready:Promise.resolve(``)};r.ready=ce(e,{signal:n.signal}).then(async e=>{if(!e.ok)throw await de(e);let t=await e.blob();if(n.signal.aborted)throw new DOMException(`Aborted`,`AbortError`);return r.blobUrl=URL.createObjectURL(t),r.blobUrl}),t=r,G.set(e,t)}t.references++;let n=!1,r=t;return{ready:r.ready,release(){n||(n=!0,!(--r.references>0)&&(r.controller.abort(),r.blobUrl&&URL.revokeObjectURL(r.blobUrl),G.get(e)===r&&G.delete(e)))}}}function Ke(e,t){let n=o(``),r=o(0),a=()=>{r.value++},s=e=>{(e.key===`kobo:network-token`||e.key===null)&&a()};return window.addEventListener(`kobo:auth-token-changed`,a),window.addEventListener(`storage`,s),i(()=>{window.removeEventListener(`kobo:auth-token-changed`,a),window.removeEventListener(`storage`,s)}),l([e,r],([e],r,i)=>{let a=!0,o=[],s=document.createElement(`template`);s.innerHTML=e;for(let e of s.content.querySelectorAll(`img`)){let r=e.getAttribute(`src`)??``;if(e.removeAttribute(`data-kobo-image-url`),!/^\/api\/workspaces\/[^/]+\/images\/file\?path=/.test(r))continue;e.removeAttribute(`src`);let i=q(r);o.push(i),i.ready.then(t=>{a&&(e.setAttribute(`src`,t),e.setAttribute(`data-kobo-image-url`,r),n.value=s.innerHTML)}).catch(()=>{a&&(e.setAttribute(`title`,t()),n.value=s.innerHTML)})}n.value=s.innerHTML,i(()=>{a=!1;for(let e of o)e.release()})},{immediate:!0}),n}function qe(e,t){return t?e.replace(/\[image:\s+([^\]]+)\]/g,(e,n)=>{let r=String(n).trim();return/^(\.ai\/images\/|images\/)/.test(r)?`![${r}](${`/api/workspaces/${encodeURIComponent(t)}/images/file?path=${encodeURIComponent(r)}`})`:e}):e}var Je=[`innerHTML`],Ye=[`innerHTML`],Xe=[`src`],J=L(T({__name:`UserMessageItem`,props:{item:{},workspaceId:{}},setup(t){let n=t,{t:r}=fe(),a=x(()=>n.item.sender===`system-prompt`),s=Ke(x(()=>{let e=qe(n.item.content,n.workspaceId);return B(e)}),()=>r(`network.login.unreachable`)),c=o(null),d=o(!1),f;function p(){d.value=!1,c.value=null,f?.release(),f=void 0}l(d,e=>{e||p()}),l(()=>n.workspaceId,p);let m=e=>{(e.key===`kobo:network-token`||e.key===null)&&p()};window.addEventListener(`storage`,m),window.addEventListener(`kobo:auth-token-changed`,p),i(()=>{p(),window.removeEventListener(`kobo:auth-token-changed`,p),window.removeEventListener(`storage`,m)});function y(e){let t=e.target;if(t?.tagName!==`IMG`)return;let n=t;n.src&&(p(),n.dataset.koboImageUrl&&(f=q(n.dataset.koboImageUrl),f.ready.catch(p)),c.value=n.src,d.value=!0)}return(t,n)=>(u(),S(C,null,[a.value?(u(),_(we,{key:0,dense:``,"dense-toggle":``,label:t.$t(`chat.systemPrompt`),"header-class":`text-kobo-2 text-caption`},{default:h(()=>[w(`div`,{class:`q-py-xs markdown-user-prompt`,innerHTML:e(s)},null,8,Je)]),_:1},8,[`label`])):(u(),S(`div`,{key:1,class:`markdown-message`,onClick:y},[w(`div`,{innerHTML:e(s)},null,8,Ye)])),g(ue,{modelValue:d.value,"onUpdate:modelValue":n[1]||=e=>d.value=e},{default:h(()=>[c.value?(u(),S(`img`,{key:0,src:c.value,alt:``,class:`image-lightbox-img`,onClick:n[0]||=e=>d.value=!1},null,8,Xe)):v(``,!0)]),_:1},8,[`modelValue`])],64))}}),[[`__scopeId`,`data-v-db2fc622`]]),Ze=[`data-event-ids`],Y={class:`turn-header`},Qe={key:0,class:`turn-time`},$e={class:`turn-time turn-time-updated`},X={key:2,class:`turn-actions`},et={class:`turn-body`},tt={class:`ellipsis`},nt={class:`q-px-sm q-pb-sm`},rt={key:0,class:`turn-scroll-top`},it=L(T({__name:`TurnCard`,props:{turn:{},workspaceId:{},highlighted:{type:Boolean}},emits:[`scrollTo`],setup(t,{emit:i}){let s=t,c=i,{t:l}=fe(),d=pe(),f=m(P),p=o(null);function ee(){let e=p.value;if(!e)return;let t=e.closest(`.q-scrollarea`)?.querySelector(`.q-scrollarea__content`);if(!t){e.scrollIntoView({behavior:`smooth`,block:`start`});return}let n=e.getBoundingClientRect().top-t.getBoundingClientRect().top;c(`scrollTo`,Math.max(0,n-8))}let b=x(()=>{switch(s.turn.speaker){case`user`:{let e=s.turn.items[0],t=e?.type===`user`?e.source:void 0;return{label:t?l(`chat.externalLlm`,{name:t.clientName}):l(`chat.you`),accent:`var(--kobo-turn-user)`,badgeClass:`turn-badge-user`}}case`agent`:return{label:l(`chat.agent`),accent:`var(--kobo-turn-agent)`,badgeClass:`turn-badge-agent`};case`system-prompt`:return{label:l(`chat.systemPrompt`),accent:`var(--kobo-text-3)`,badgeClass:`turn-badge-system`};case`session`:return{label:l(`chat.session`),accent:`var(--kobo-text-3)`,badgeClass:`turn-badge-session`};case`script`:{let e=s.turn.items[0],t=e?.type===`user`?e.sender:``;return{label:le(t)?l(`chat.hookScript`,{event:t.slice(5)}):l(t===`archive`?`chat.archiveScript`:t===`setup`?`chat.setupScript`:`chat.cleanupScript`),accent:`var(--kobo-success)`,badgeClass:`turn-badge-script`}}}});function T(e,t=!1){if(!e)return``;let n=new Date(e);return Number.isNaN(n.getTime())?``:n.toLocaleTimeString(void 0,t?{hour:`2-digit`,minute:`2-digit`,second:`2-digit`}:{hour:`2-digit`,minute:`2-digit`})}let re=x(()=>T(s.turn.ts)),E=x(()=>s.turn.items.flatMap(e=>e.eventIds??[]).join(` `)),ie=x(()=>{let e=s.turn.items;if(e.length===0)return null;for(let t=e.length-1;t>=0;t--){let n=e[t].ts;if(n)return n}return null}),ae=x(()=>{let e=s.turn.ts,t=ie.value;if(!t||!e||t===e)return``;let n=new Date(e).getTime(),r=new Date(t).getTime();return Number.isNaN(n)||Number.isNaN(r)||r<=n?``:T(t,r-n<6e4)}),se=x(()=>ae.value!==``);function ce(e){return Te(e.origin,Object.values(d.subagents[s.workspaceId]??{}),e.type===`tool`?e.toolCallId:void 0)}function ue(e){return e||l(`chat.subagentActivity`)}function de(e){return(e.type===`text`||e.type===`thinking`||e.type===`tool`)&&e.origin?.kind===`subagent`}let O=x(()=>{let e=[],t=new Map;for(let n of s.turn.items){if(!de(n)){e.push({type:`item`,key:U(n),item:n});continue}let r=ce(n),i=r?.toolUseId??n.origin?.toolCallId??n.origin?.threadId??U(n),a=t.get(i);if(a){a.items.push(n);continue}let o={type:`subagent`,key:`subagent:${U(n)}`,items:[n],subagentKey:i,subagentName:r?.description||null};t.set(i,o),e.push(o)}return e});function k(e){e.origin&&f?.({origin:e.origin})}let me=x(()=>s.turn.items.filter(e=>e.type===`tool`).length);return(i,o)=>(u(),S(`div`,{ref_key:`cardEl`,ref:p,class:r([`turn-card`,{"turn-card--user":t.turn.speaker===`user`,"turn-card--highlighted":t.highlighted}]),"data-event-ids":E.value,style:n({"--turn-accent":b.value.accent})},[w(`div`,Y,[w(`span`,{class:r([`turn-badge`,b.value.badgeClass])},a(b.value.label),3),re.value?(u(),S(`span`,Qe,a(re.value),1)):v(``,!0),se.value?(u(),S(C,{key:1},[g(oe,{name:`arrow_forward`,size:`10px`,color:`kobo-3`,class:`turn-time-arrow`}),w(`span`,$e,[y(a(ae.value)+` `,1),g(z,null,{default:h(()=>[y(a(e(l)(`chat.lastUpdatedAt`,{time:ae.value})),1)]),_:1})])],64)):v(``,!0),me.value>0?(u(),S(`span`,X,` · `+a(e(l)(`chat.nActions`,{n:me.value})),1)):v(``,!0)]),w(`div`,et,[(u(!0),S(C,null,te(O.value,n=>(u(),S(C,{key:n.key},[n.type===`subagent`?(u(),_(we,{key:0,class:`turn-subagent-activity`,dense:``,label:ue(n.subagentName),caption:e(l)(`chat.nActions`,{n:n.items.length}),"default-opened":t.highlighted&&n.items.some(e=>e.eventIds?.some(e=>E.value.includes(e)))},{header:h(()=>[g(N,null,{default:h(()=>[g(M,{class:`row items-center no-wrap`,title:n.subagentName??void 0},{default:h(()=>[g(oe,{name:`hub`,size:`16px`,class:`q-mr-xs`},{default:h(()=>[g(z,null,{default:h(()=>[y(a(e(l)(`chat.subagentActivity`)),1)]),_:1})]),_:1}),w(`span`,tt,a(ue(n.subagentName)),1)]),_:2},1032,[`title`]),g(M,{caption:``},{default:h(()=>[y(a(e(l)(`chat.nActions`,{n:n.items.length})),1)]),_:2},1024)]),_:2},1024),g(N,{side:``},{default:h(()=>[g(D,{flat:``,round:``,dense:``,size:`sm`,icon:`open_in_new`,"aria-label":e(l)(`chat.openSubagentActivity`),onClick:ne(e=>k(n.items[0]),[`stop`])},{default:h(()=>[g(z,null,{default:h(()=>[y(a(e(l)(`chat.openSubagentActivity`)),1)]),_:1})]),_:1},8,[`aria-label`,`onClick`])]),_:2},1024)]),default:h(()=>[w(`div`,nt,[(u(!0),S(C,null,te(n.items,t=>(u(),S(C,{key:e(U)(t)},[t.type===`text`?(u(),_(F,{key:0,item:t},null,8,[`item`])):t.type===`thinking`?(u(),_(V,{key:1,item:t},null,8,[`item`])):t.type===`tool`?(u(),_(I,{key:2,item:t},null,8,[`item`])):v(``,!0)],64))),128))])]),_:2},1032,[`label`,`caption`,`default-opened`])):(u(),S(C,{key:1},[n.item.type===`text`?(u(),_(F,{key:0,item:n.item},null,8,[`item`])):n.item.type===`thinking`?(u(),_(V,{key:1,item:n.item},null,8,[`item`])):n.item.type===`tool`?(u(),_(I,{key:2,item:n.item},null,8,[`item`])):n.item.type===`user`?(u(),_(J,{key:3,item:n.item,"workspace-id":t.workspaceId},null,8,[`item`,`workspace-id`])):n.item.type===`session`?(u(),_(Ge,{key:4,item:n.item},null,8,[`item`])):n.item.type===`error`?(u(),_(Ue,{key:5,item:n.item},null,8,[`item`])):v(``,!0)],64))],64))),128))]),t.turn.items.length>4?(u(),S(`div`,rt,[g(D,{flat:``,round:``,dense:``,size:`xs`,icon:`arrow_upward`,color:`kobo-3`,class:`turn-scroll-top-btn`,onClick:ee},{default:h(()=>[g(z,null,{default:h(()=>[y(a(e(l)(`chat.scrollToTurnTop`)),1)]),_:1})]),_:1})])):v(``,!0)],14,Ze))}}),[[`__scopeId`,`data-v-13bebb3d`]]),at={key:0,class:`activity-feed-switching`},ot={key:1,class:`activity-feed-wrap`,"data-tour":`ws-chat`},st={key:0,role:`alert`,class:`q-pa-sm text-negative`},ct={key:1,"data-testid":`history-load-error`,role:`alert`,class:`q-pa-sm text-negative`},lt=[`aria-label`],ut={key:0,class:`activity-feed-compacting`},dt={class:`text-caption text-kobo-2`},ft={key:0,class:`text-center q-py-sm text-caption text-kobo-3`},pt={key:1,class:`activity-feed-empty q-pa-md`},mt={class:`activity-feed-empty__title`},ht={class:`activity-feed-empty__hint`},gt={key:2,class:`q-px-md q-pb-md`},_t=[`title`],vt={class:`ellipsis`},yt={class:`activity-feed-nav-cluster`},bt=300,xt=60,St=200,Ct=180,wt=255,Tt=3,Et=60,Dt=L(T({__name:`ActivityFeed`,props:{workspaceId:{}},setup(t){let{t:n}=fe(),r=t,i=_e(),s=he(),d=pe(),m=ge(),ee=x(()=>m.isCompacting(r.workspaceId)),b=x(()=>d.selectedSessionId),T=x(()=>d.sessions.find(e=>e.id===b.value)?.engineSessionId??null),ne=x(()=>{let e=d.sessions;return e.length!==0&&b.value===e[e.length-1].id});function E(e){return b.value?e?e===b.value||e===T.value:ne.value:!0}let ie=x(()=>(d.activityFeeds[r.workspaceId]??[]).filter(e=>e.type===`text`&&typeof e.content==`string`&&E(e.sessionId)).map(e=>({content:e.content,sender:e.meta?.sender??`user`,source:be(e.meta?.source),ts:e.timestamp,sessionId:e.sessionId,eventIds:[e.id]}))),ae=x(()=>{let e=d.workspaces.find(e=>e.id===r.workspaceId);return ve(e?.status)}),le=Ae(),ue=``,O=x(()=>{let e=i.eventsFor(r.workspaceId),t=i.timestampsFor(r.workspaceId),n=i.sessionIdsFor(r.workspaceId),a=i.eventIdsFor(r.workspaceId),o=[],c=[],l=[];for(let r=0;r<e.length;r++)E(n[r])&&(o.push(e[r]),c.push(t[r]),l.push(a[r]??null));let u=`${r.workspaceId}::${b.value??`*`}`;u!==ue&&(le=Ae(),ue=u);let d=De(le,o,c,ae.value,l);return Ie(Oe(d,ie.value).filter(e=>e.type===`thinking`?!1:e.type===`session`?e.kind===`ended`?s.showVerboseSystemMessages||!ke(e.detail):s.showVerboseSystemMessages:!0))}),k=x(()=>s.showVerboseSystemMessages?i.eventsFor(r.workspaceId).filter(e=>e.kind===`message:raw`).map(e=>e.content):[]),Se=x(()=>{for(let e=O.value.length-1;e>=0;e--){let t=O.value[e]?.items??[];for(let e=t.length-1;e>=0;e--){let r=t[e];if(r){if(r.type===`text`&&!r.streaming)return{key:`text:${r.messageId}`,text:r.text};if(r.type===`tool`)return r.result?{key:`tool:${r.toolCallId}:end`,text:r.result.isError?n(`activity.a11y.toolFailed`,{name:r.name}):n(`activity.a11y.toolFinished`,{name:r.name})}:{key:`tool:${r.toolCallId}:start`,text:n(`activity.a11y.toolStarted`,{name:r.name})}}}}return null}),Ce=o(``);l(Se,(e,t)=>{if(!e||e.key===t?.key)return;let r=e.key.startsWith(`text:`)?n(`activity.a11y.agentSaid`,{text:e.text.slice(0,bt)}):e.text;Ce.value=r});let A=o(null),j=o(!0),M=o(!1),N=o(``),P=me(),Te=me(),F=me(),I=o(null),L=!1,R=!0,z=null,B=o(new Set),V=new Map,je=x(()=>{if(O.value.length>0||k.value.length>0)return!1;let e=r.workspaceId,t=b.value;return!!d.loadingSessions[e]||m.isSyncPending(e)||t!==null&&B.value.has(U(e,t))}),Me=o(new Map),H=x(()=>O.value.length>0||k.value.length>0),Pe=x(()=>!!d.loadingSessions[r.workspaceId]||m.isSyncPending(r.workspaceId)||b.value!==null&&B.value.has(U(r.workspaceId,b.value)));function Fe(e){tt();let t=z;if(z=e.verticalSize,t!==null&&e.verticalSize>t&&j.value&&!M.value){K(0);return}let n=e.verticalSize-e.verticalPosition-e.verticalContainerSize;j.value=n<=xt,L&&e.verticalPosition<=St&&!M.value&&!N.value&&Be()&&Ue()}function U(e,t){return`${e}:${t}`}function Be(){let e=b.value;return e?Me.value.get(U(r.workspaceId,e))??!0:i.hasMoreOlderFor(r.workspaceId)}function Ve(e,t,n){Me.value.set(U(e,t),n)}function He(e){if(!b.value)return i.oldestIdFor(e);let t=i.eventIdsFor(e),n=i.sessionIdsFor(e);for(let e=0;e<t.length;e++){if(!E(n[e]))continue;let r=t[e];if(r)return r}}let W=null;function Ue(){if(W)return W;let e=G().finally(()=>{W===e&&(W=null)});return W=e,W}function We(){P.abort(),Te.abort(),F.abort(),M.value=!1,W=null;for(let e of B.value)Ft.delete(e);V.clear(),B.value.clear(),N.value=``}function Ge(){N.value=``,Nt.value===0&&b.value?It():Ue()}l(()=>[r.workspaceId,b.value],We,{flush:`sync`});async function G(){let e=r.workspaceId,t=b.value,n=He(e);if(!n)return;let a=P.begin();N.value=``,M.value=!0;try{let r=A.value;if(await f(),!P.isCurrent(a))return;let o=r?.getScroll().verticalSize??0,s=r?.getScroll().verticalPosition??0,c=new URLSearchParams({before:n,limit:`200`});t&&c.set(`session`,t);let l=await ce(`/api/workspaces/${e}/events?${c.toString()}`,{signal:a});if(!l.ok)throw await de(l);let u=await l.json();if(!P.isCurrent(a))return;let p=u.events??[],m=p.filter(t=>t.type===`agent:event`&&t.workspaceId===e),h=p.filter(t=>t.type===`user:message`&&t.workspaceId===e),g=m.map(e=>e.payload),_=m.map(e=>e.createdAt),v=m.map(e=>e.sessionId??null),y=m.map(e=>e.id),ee=p.length>0?p[0].id:n;t&&Ve(e,t,u.hasMore),i.prepend(e,g,_,{oldestId:ee,hasMoreOlder:t?i.hasMoreOlderFor(e):u.hasMore,sessionIds:v,eventIds:y});for(let t of h){let n=t.payload;typeof n.content==`string`&&d.addActivityItem(e,{id:t.id,type:`text`,content:n.content,timestamp:t.createdAt,sessionId:t.sessionId??void 0,meta:{sender:n.sender??`user`,source:be(n.source)}})}if(await f(),r&&P.isCurrent(a)){let e=r.getScroll().verticalSize-o;if(e>0){let t=Math.max(s+e,250);r.setScrollPosition(`vertical`,t,0)}}}catch(e){if(ye(e)||!P.isCurrent(a))return;N.value=e instanceof Error?e.message:String(e),console.error(`[ActivityFeed] failed to load older events:`,e)}finally{P.isCurrent(a)&&(M.value=!1)}}async function K(e=0){let t=$();if(await f(),t!==$())return;let n=A.value;if(!n)return;let r=n.getScroll();n.setScrollPosition(`vertical`,r.verticalSize,e)}let q=null,Ke=0;function qe(){if(q!=null)return;let e=performance.now()-Ke<Ct,t=$();q=requestAnimationFrame(()=>{q=null,t===$()&&(Ke=performance.now(),K(e?0:180))})}function Je(e){Q(),j.value=!1;let t=A.value;t&&t.setScrollPosition(`vertical`,Math.max(0,e),250)}function Ye(){let e=window.location.hash,t=e.indexOf(`?`);if(t===-1||!new URLSearchParams(e.slice(t+1)).has(`eventId`))return;let n=e.slice(0,t);window.history.replaceState(window.history.state,``,`${window.location.pathname}${window.location.search}${n}`)}async function Xe(e){let t=e.detail;if(t?.workspaceId!==r.workspaceId||!t.eventId)return;Q(),j.value=!1;let n=F.begin(),a=r.workspaceId;try{let e=new URLSearchParams({around:t.eventId,limit:`200`});t.sessionId&&e.set(`session`,t.sessionId);let o=await ce(`/api/workspaces/${a}/events?${e}`,{signal:n});if(!o.ok)throw await de(o);let s=await o.json();if(!F.isCurrent(n))return;let c=s.events??[],l=c.filter(e=>e.type===`agent:event`&&e.workspaceId===r.workspaceId),u=c.filter(e=>e.type===`user:message`&&e.workspaceId===r.workspaceId);i.reset(r.workspaceId,l.map(e=>e.payload),l.map(e=>e.createdAt),{oldestId:c[0]?.id,hasMoreOlder:s.hasMore??!1,sessionIds:l.map(e=>e.sessionId),eventIds:l.map(e=>e.id)});for(let e of u){let t=e.payload;typeof t.content==`string`&&d.addActivityItem(r.workspaceId,{id:e.id,type:`text`,content:t.content,timestamp:e.createdAt,sessionId:e.sessionId??void 0,meta:{sender:t.sender??`user`,source:be(t.source)}})}if(await ze(je,e=>!e,5e3),await f(),await new Promise(e=>requestAnimationFrame(()=>requestAnimationFrame(()=>e()))),!F.isCurrent(n))return;let p=O.value.findIndex(e=>e.items.some(e=>e.eventIds?.includes(t.eventId)??!1));if(p<0)return;I.value=t.eventId,J.value?.scrollTo(p,`center`),Y.value=p,window.setTimeout(()=>{I.value===t.eventId&&(I.value=null)},1800)}catch(e){if(ye(e)||!F.isCurrent(n))return;N.value=e instanceof Error?e.message:String(e),console.error(`[ActivityFeed] failed to focus history event:`,e)}}let J=o(null),Ze=o(null),Y=o(0),Qe=o(!1),$e=x(()=>{for(let e=O.value.length-1;e>=0;e--)if(O.value[e]?.speaker===`user`)return e;return-1}),X=null;function et(){let e=$e.value,t=A.value?.getScrollTarget(),n=t?.querySelector(`[data-turn-index="${e}"]`);if(!n||!t){Qe.value=!1;return}let r=t.getBoundingClientRect(),i=n.getBoundingClientRect();Qe.value=i.bottom>r.top&&i.top<r.bottom}function tt(){X===null&&(X=requestAnimationFrame(()=>{X=null,et()}))}function nt(e){return e.length<=wt?e:`${e.slice(0,252)}...`}let rt=x(()=>{let e=$e.value,t=O.value[e];if(!t||Y.value<=e||Qe.value)return null;let n=t.items.filter(e=>e.type===`user`).map(e=>e.content).join(`
-`).trim();return n?{index:e,content:nt(n)}:null});function Dt(e){Y.value=e.index,tt()}function Ot(){let e=rt.value;e&&(Q(),j.value=!1,J.value?.scrollTo(e.index,`start`),Y.value=e.index)}let kt=o(!1);async function At(){if(kt.value)return;Q(),j.value=!1,kt.value=!0;let e=r.workspaceId;try{let t=Re(O.value,Y.value);if(t<0)for(let n=0;n<15;n++){if(e!==r.workspaceId)return;if(!Be())break;let n=O.value.length;if(await Ue(),await f(),e!==r.workspaceId)return;if(Y.value+=O.value.length-n,t=Re(O.value,Y.value),t>=0)break}t>=0&&e===r.workspaceId&&(J.value?.scrollTo(t,`start`),Y.value=t)}finally{kt.value=!1}}let Z=0;function jt(){return new Promise(e=>requestAnimationFrame(()=>e()))}async function Mt(){if(!R||!H.value||je.value)return;L=!1;let e=++Z;if(await f(),e!==Z||!R||(Ze.value=A.value?.getScrollTarget()??null,await f(),e!==Z||!R))return;O.value.length>0&&J.value?.scrollTo(O.value.length-1,`end-force`),await jt();let t=-1,n=0;for(let r=0;r<Et&&n<Tt;r++){if(e!==Z||!R)return;await K(0),await jt();let r=A.value?.getScroll().verticalSize??0;z=r,n=r===t?n+1:0,t=r}e===Z&&!Pe.value&&(L=!0,R=!1)}function Q(){R=!1,!L&&(Z++,L=!0)}let Nt=x(()=>{let e=i.sessionIdsFor(r.workspaceId);if(!b.value)return e.length;let t=0;for(let n of e)E(n)&&t++;return t});l(je,async e=>{!e&&H.value&&await Mt(),e||f(()=>{Ze.value=A.value?.getScrollTarget()??null,tt()})}),l(Pe,(e,t)=>{!e&&t&&R&&H.value&&Mt()}),p(()=>{window.addEventListener(`kobo:focus-history-event`,Xe),f(()=>{Ze.value=A.value?.getScrollTarget()??null,tt()}),H.value&&Mt(),b.value&&It();let e=new URLSearchParams(window.location.hash.split(`?`)[1]??``).get(`eventId`);e&&(Xe(new CustomEvent(`kobo:focus-history-event`,{detail:{workspaceId:r.workspaceId,sessionId:b.value,eventId:e}})),Ye())}),l([Nt,()=>ie.value.length,()=>k.value.length],async([e,t,n])=>{M.value||R&&e+t+n>0&&await Mt()}),l([$e,()=>O.value.length],()=>{f(tt)});let Pt=x(()=>i.liveAppendCountFor(r.workspaceId,E)),$=()=>`${r.workspaceId}\u0000${d.selectedSessionId??``}`;l([Pt,$],([e,t],[n,r])=>{t===r&&e>n&&j.value&&!M.value&&qe()}),c(()=>{Z++,R=!1,We(),window.removeEventListener(`kobo:focus-history-event`,Xe),q!=null&&(cancelAnimationFrame(q),q=null),X!==null&&cancelAnimationFrame(X)}),l([()=>r.workspaceId,()=>d.selectedSessionId],()=>{Z++,R=!0,z=null,j.value=!0,L=!1,It(),H.value&&Mt()});let Ft=new Set;async function It(){let e=r.workspaceId,t=b.value;if(!t||Nt.value>0)return;let n=U(e,t);if(Ft.has(n))return;Ft.add(n),B.value.add(n);let a=Te.begin();V.set(n,a),N.value=``;try{let n=await ce(`/api/workspaces/${e}/events?session=${encodeURIComponent(t)}&limit=500`,{signal:a});if(!n.ok)throw await de(n);let r=await n.json();if(!Te.isCurrent(a))return;let o=r.events??[];if(o.length===0)return;let s=o.filter(t=>t.type===`agent:event`&&t.workspaceId===e),c=o.filter(t=>t.type===`user:message`&&t.workspaceId===e),l=s.map(e=>e.payload),u=s.map(e=>e.createdAt),f=s.map(e=>e.sessionId??null),p=s.map(e=>e.id);Ve(e,t,r.hasMore),l.length>0&&i.prepend(e,l,u,{oldestId:o[0].id,hasMoreOlder:i.hasMoreOlderFor(e),sessionIds:f,eventIds:p});for(let t of c){let n=t.payload;typeof n.content==`string`&&d.addActivityItem(e,{id:t.id,type:`text`,content:n.content,timestamp:t.createdAt,sessionId:t.sessionId??void 0,meta:{sender:n.sender??`user`,source:be(n.source)}})}}catch(e){if(ye(e)||!Te.isCurrent(a)){(!V.has(n)||V.get(n)===a)&&Ft.delete(n);return}N.value=e instanceof Error?e.message:String(e),console.error(`[ActivityFeed] fetchSessionIfMissing failed:`,e),Ft.delete(n)}finally{V.get(n)===a&&(V.delete(n),B.value.delete(n))}}let Lt=x(()=>ie.value.filter(e=>e.sender===`user`).length),Rt=x(()=>(d.activityFeeds[r.workspaceId]??[]).filter(e=>e.meta?.sender===`user`&&e.meta.pending&&E(e.sessionId)).length);l([Lt,Rt,$],async([e,t,n],[r,i,a])=>{let o=t>i;n===a&&(o||e>r&&j.value&&!M.value&&!Pe.value)&&(j.value=!0,await K(o?180:0))});async function zt(){j.value=!0,await K(250)}return(t,n)=>je.value?(u(),S(`div`,at,[g(xe,{size:`40px`,color:`primary`})])):(u(),S(`div`,ot,[e(d).sessionsErrors[r.workspaceId]?(u(),S(`div`,st,[y(a(t.$t(`activity.sessionsError`,{message:e(d).sessionsErrors[r.workspaceId]}))+` `,1),g(D,{flat:``,dense:``,label:t.$t(`common.retry`),onClick:n[0]||=t=>e(d).fetchSessions(r.workspaceId)},null,8,[`label`])])):v(``,!0),N.value?(u(),S(`div`,ct,[y(a(t.$t(`activity.historyError`,{message:N.value}))+` `,1),g(D,{flat:``,dense:``,label:t.$t(`common.retry`),onClick:Ge},null,8,[`label`])])):v(``,!0),w(`div`,{"data-testid":`activity-live-region`,class:`sr-only`,role:`log`,"aria-live":`polite`,"aria-atomic":`true`,"aria-label":t.$t(`activity.a11y.region`)},a(Ce.value),9,lt),g(re,{name:`fade`},{default:h(()=>[ee.value?(u(),S(`div`,ut,[g(xe,{size:`18px`,color:`primary`}),w(`span`,dt,a(t.$t(`activity.compacting`)),1)])):v(``,!0)]),_:1}),g(Ee,{ref_key:`scrollRef`,ref:A,class:`activity-feed-scroll`,onScroll:Fe,onWheelPassive:Q,onTouchstartPassive:Q,onKeydown:Q},{default:h(()=>[M.value?(u(),S(`div`,ft,[g(se,{size:`sm`}),y(` `+a(t.$t(`activity.loading_older`)),1)])):v(``,!0),g(Ne,{ref_key:`virtualScrollRef`,ref:J,class:`q-pa-md`,items:O.value,"scroll-target":Ze.value??void 0,"virtual-scroll-item-size":160,"virtual-scroll-slice-size":20,onVirtualScroll:Dt},{default:h(({item:t,index:n})=>[(u(),_(it,{key:e(Le)(t),turn:t,"workspace-id":r.workspaceId,"data-turn-index":n,highlighted:t.items.some(e=>e.eventIds?.includes(I.value??``)??!1),onScrollTo:Je},null,8,[`turn`,`workspace-id`,`data-turn-index`,`highlighted`]))]),_:1},8,[`items`,`scroll-target`]),O.value.length===0&&k.value.length===0&&!M.value?(u(),S(`div`,pt,[g(oe,{name:`forum`,size:`28px`}),w(`div`,mt,a(t.$t(`activity.empty`)),1),w(`div`,ht,a(t.$t(`activity.emptyHint`)),1)])):v(``,!0),k.value.length?(u(),S(`div`,gt,[g(we,{label:t.$t(`activity.raw_lines`,{n:k.value.length}),dense:``},{default:h(()=>[(u(!0),S(C,null,te(k.value,(e,t)=>(u(),S(`div`,{key:t,class:`text-caption text-kobo-3 q-pa-xs`},a(e),1))),128))]),_:1},8,[`label`])])):v(``,!0)]),_:1},512),rt.value?(u(),S(`button`,{key:2,type:`button`,class:`activity-feed-last-user`,"data-testid":`latest-user-message`,title:rt.value.content,onClick:Ot},[g(oe,{name:`person`,size:`16px`}),w(`span`,vt,a(rt.value.content),1)],8,_t)):v(``,!0),w(`div`,yt,[j.value?v(``,!0):(u(),_(D,{key:0,round:``,dense:``,unelevated:``,color:`kobo-surface-2`,"text-color":`kobo-1`,icon:`arrow_downward`,size:`sm`,class:`activity-feed-nav-btn`,title:t.$t(`activity.scroll_to_bottom`),"aria-label":t.$t(`activity.scroll_to_bottom`),onClick:zt},null,8,[`title`,`aria-label`])),g(D,{round:``,dense:``,unelevated:``,color:`kobo-surface-2`,"text-color":`kobo-1`,icon:`arrow_upward`,size:`sm`,class:`activity-feed-nav-btn`,title:t.$t(`activity.prev_user_message`),"aria-label":t.$t(`activity.prev_user_message`),loading:kt.value,disable:kt.value,onClick:At},null,8,[`title`,`aria-label`,`loading`,`disable`])])]))}}),[[`__scopeId`,`data-v-58324159`]]);export{Dt as default};