@rallycry/conveyor-mcp 4.3.8 → 4.3.9

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ConveyorConnection
-} from "./chunk-NQWURJDR.js";
+} from "./chunk-KOYKRWVY.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -66,8 +66,50 @@ function registerProjectTools(server2, conn2) {
   );
 }
 
-// src/tools/project-config.ts
+// src/tools/connection.ts
 import { z as z2 } from "zod";
+var CAPABILITY_ENUM = ["read", "create", "update", "chat", "files", "build"];
+function registerConnectionTools(server2, conn2) {
+  server2.tool(
+    "get_connection_context",
+    "Resolve WHO this connection is and WHAT project/board it points at \u2014 call this FIRST, before inferring anything from names. Returns the effective account, project, and board (sub-project) each with BOTH its immutable ID and its human-readable name/slug, the granted capabilities (read/create/update/chat/files/build), management URLs, and a one-line summary. Removes the ambiguity between a project's canonical name and a board label. Pass projectId to target a specific project; otherwise the configured default project is used.",
+    {
+      projectId: z2.string().optional().describe("Target Conveyor project ID")
+    },
+    async (params) => {
+      const ctx = await conn2.getConnectionContext(params.projectId);
+      return { content: [{ type: "text", text: JSON.stringify(ctx, null, 2) }] };
+    }
+  );
+  server2.tool(
+    "verify_connection",
+    "Prove the connection is correct AND that you can actually write to the intended board \u2014 not just that auth works. Runs layered checks (auth \u2192 account \u2192 project \u2192 target board \u2192 capabilities \u2192 read) and returns a plain pass/fail with, on failure, the exact failing layer and ONE next action. Use this instead of get_project_summary to confirm setup: a summary that returns data proves auth, not scope. Pass intendedActions to verify specific capabilities (defaults to read+create+update). Pass projectId to target a specific project; otherwise the configured default project is used. The board scope comes from CONVEYOR_SUBPROJECT_ID.",
+    {
+      projectId: z2.string().optional().describe("Target Conveyor project ID"),
+      intendedActions: z2.array(z2.enum(CAPABILITY_ENUM)).optional().describe(
+        "Capabilities to verify the connection can perform (default: read, create, update)."
+      )
+    },
+    async (params) => {
+      const result = await conn2.verifyConnection(params);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server2.tool(
+    "list_accessible_subprojects",
+    "List the boards (sub-projects) under the connected project \u2014 each with its ID, name, slug, board URL, owned root path, and the role/capabilities this token has on it. Use this to discover which board to create or list cards on (pass a returned id as subProjectId, or set CONVEYOR_SUBPROJECT_ID) instead of asking the human for one. Pass projectId to target a specific project; otherwise the configured default project is used.",
+    {
+      projectId: z2.string().optional().describe("Target Conveyor project ID")
+    },
+    async (params) => {
+      const subprojects = await conn2.listAccessibleSubprojects(params.projectId);
+      return { content: [{ type: "text", text: JSON.stringify(subprojects, null, 2) }] };
+    }
+  );
+}
+
+// src/tools/project-config.ts
+import { z as z3 } from "zod";
 function jsonResult(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 }
@@ -85,7 +127,7 @@ function registerGetConnectUrls(server2, conn2) {
     "get_connect_urls",
     "Get browser-only setup URLs to hand to the user: the Google Cloud OAuth connect link (gcpConnect) plus Settings deep links (gcpSettings, memberSettings, projectSettings, setupWizard). Use these for setup steps an agent cannot perform (OAuth grants, secret entry). Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z2.string().optional().describe("Target Conveyor project ID")
+      projectId: z3.string().optional().describe("Target Conveyor project ID")
     },
     async (params) => jsonResult(await conn2.getConnectUrls(params.projectId))
   );
@@ -95,16 +137,16 @@ function registerUpdateProjectSettings(server2, conn2) {
     "update_project_settings",
     "Update project configuration: name, description, default agent assignments, or a deep-merged patch of the project settings JSON (JSON Merge Patch: nested objects merge recursively, null deletes a key, arrays replace \u2014 a partial patch never wipes sibling keys). Requires a Moderate project role. Does NOT touch repositories or branches \u2014 those are configured in the Conveyor UI.",
     {
-      projectId: z2.string().optional().describe("Target Conveyor project ID"),
-      name: z2.string().optional().describe("New project name"),
-      description: z2.string().optional().describe("New project description"),
-      settings: z2.record(z2.unknown()).optional().describe(
+      projectId: z3.string().optional().describe("Target Conveyor project ID"),
+      name: z3.string().optional().describe("New project name"),
+      description: z3.string().optional().describe("New project description"),
+      settings: z3.record(z3.unknown()).optional().describe(
         "Deep-merged patch of the project settings JSON (JSON Merge Patch semantics: null deletes a key; advanced)"
       ),
-      defaultPmAgentId: z2.string().nullable().optional().describe("Default PM agent ID"),
-      defaultTaskAgentId: z2.string().nullable().optional().describe("Default task agent ID"),
-      defaultReviewerAgentId: z2.string().nullable().optional().describe("Default reviewer agent ID"),
-      helperAgentId: z2.string().nullable().optional().describe("Helper agent ID")
+      defaultPmAgentId: z3.string().nullable().optional().describe("Default PM agent ID"),
+      defaultTaskAgentId: z3.string().nullable().optional().describe("Default task agent ID"),
+      defaultReviewerAgentId: z3.string().nullable().optional().describe("Default reviewer agent ID"),
+      helperAgentId: z3.string().nullable().optional().describe("Helper agent ID")
     },
     async (params) => {
       const { projectId: projectId2, name, description, settings, ...agents } = params;
@@ -133,12 +175,12 @@ function registerManageTags(server2, conn2) {
     "manage_tags",
     "List, create, update, or delete project tags. create requires name (optional color/description); update/delete require the tag id. Mutations require a Moderate project role.",
     {
-      action: z2.enum(["list", "create", "update", "delete"]).describe("Operation to perform"),
-      projectId: z2.string().optional().describe("Target Conveyor project ID (list/create)"),
-      id: z2.string().optional().describe("Tag ID (update/delete)"),
-      name: z2.string().optional().describe("Tag name"),
-      color: z2.string().optional().describe("Hex color, e.g. #ff0000"),
-      description: z2.string().optional().describe("Tag description")
+      action: z3.enum(["list", "create", "update", "delete"]).describe("Operation to perform"),
+      projectId: z3.string().optional().describe("Target Conveyor project ID (list/create)"),
+      id: z3.string().optional().describe("Tag ID (update/delete)"),
+      name: z3.string().optional().describe("Tag name"),
+      color: z3.string().optional().describe("Hex color, e.g. #ff0000"),
+      description: z3.string().optional().describe("Tag description")
     },
     async (params) => {
       const { action, projectId: projectId2, id, name, color, description } = params;
@@ -172,13 +214,13 @@ function registerManagePriorities(server2, conn2) {
     "manage_priorities",
     "List, create, update, or delete project priorities. create requires value (1-100), name, and color; update/delete require the priority id. create/update require a Moderate role; delete requires Admin.",
     {
-      action: z2.enum(["list", "create", "update", "delete"]).describe("Operation to perform"),
-      projectId: z2.string().optional().describe("Target Conveyor project ID (list/create)"),
-      id: z2.string().optional().describe("Priority ID (update/delete)"),
-      value: z2.number().int().min(1).max(100).optional().describe("Priority value (1 = highest urgency scale point)"),
-      name: z2.string().optional().describe("Priority name"),
-      color: z2.string().optional().describe("Hex color, e.g. #ff0000"),
-      description: z2.string().optional().describe("Priority description")
+      action: z3.enum(["list", "create", "update", "delete"]).describe("Operation to perform"),
+      projectId: z3.string().optional().describe("Target Conveyor project ID (list/create)"),
+      id: z3.string().optional().describe("Priority ID (update/delete)"),
+      value: z3.number().int().min(1).max(100).optional().describe("Priority value (1 = highest urgency scale point)"),
+      name: z3.string().optional().describe("Priority name"),
+      color: z3.string().optional().describe("Hex color, e.g. #ff0000"),
+      description: z3.string().optional().describe("Priority description")
     },
     async (params) => {
       const { action, projectId: projectId2, id, value, name, color, description } = params;
@@ -219,7 +261,7 @@ function registerProjectConfigTools(server2, conn2) {
 }
 
 // src/tools/tasks.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 var CLI_EVENT_FORMATTERS = {
   thinking: (data) => String(data.message ?? ""),
   tool_use: (data) => `${data.tool}: ${String(data.input ?? "").slice(0, 1e3)}`,
@@ -289,22 +331,26 @@ var STATUS_ENUM = [
 ];
 var CARD_TYPE_ENUM = ["task", "incident", "suggestion"];
 var RISK_ENUM = ["critical", "high", "medium", "low"];
+var BOARD_FILTER = z4.string().nullable().optional().describe(
+  "Filter to a sub-project board. Omit to use the connection's default board (CONVEYOR_SUBPROJECT_ID) when set, else the whole project; pass null to force the whole project. Use list_accessible_subprojects to find board IDs."
+);
+var BOARD_ASSIGN = z4.string().nullable().optional().describe(
+  "Assign the card to a sub-project board. Omit to use the connection's default board (CONVEYOR_SUBPROJECT_ID) when set, else the parent project; pass null to force the parent project. Use list_accessible_subprojects to find board IDs."
+);
 function registerListTasks(server2, conn2) {
   server2.tool(
     "list_tasks",
     "List project cards, optionally filtered by card type, status, or assignment (a specific assignee, or unassigned tasks). Defaults to type=task \u2014 pass typeFilters to list incidents/suggestions. Results are relevance-ordered: highest priority first then newest; suggestions-only queries rank by upvote score. Pass projectId to target a specific project; otherwise the configured default project is used. Returns summaries \u2014 plan omitted, description truncated; use get_task for full details.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      status: z3.enum(STATUS_ENUM).optional().describe("Filter by task status"),
-      typeFilters: z3.array(z3.enum(CARD_TYPE_ENUM)).optional().describe(
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      status: z4.enum(STATUS_ENUM).optional().describe("Filter by task status"),
+      typeFilters: z4.array(z4.enum(CARD_TYPE_ENUM)).optional().describe(
         'Card types to include, e.g. ["incident"] or ["task", "incident"]. Omit for tasks only.'
       ),
-      assigneeId: z3.string().optional().describe("Filter by assigned user ID"),
-      unassigned: z3.boolean().optional().describe("Only return tasks with no assignee (mutually exclusive with assigneeId)"),
-      subProjectId: z3.string().optional().describe(
-        "Scope to a sub-project board (list/search: filter; create/update: assign). Omit for the whole project."
-      ),
-      limit: z3.number().optional().describe("Max tasks to return (default 50)")
+      assigneeId: z4.string().optional().describe("Filter by assigned user ID"),
+      unassigned: z4.boolean().optional().describe("Only return tasks with no assignee (mutually exclusive with assigneeId)"),
+      subProjectId: BOARD_FILTER,
+      limit: z4.number().optional().describe("Max tasks to return (default 50)")
     },
     async (params) => {
       const tasks = await conn2.listTasks(params);
@@ -319,8 +365,8 @@ function registerGetTask(server2, conn2) {
     "get_task",
     "Get full task details including plan, chat history, PR info, subtasks, and build status. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      taskId: z3.string().describe("The task ID or slug (the value in a card URL, /cards/<slug>)")
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      taskId: z4.string().describe("The task ID or slug (the value in a card URL, /cards/<slug>)")
     },
     async (params) => {
       const task = await conn2.getTask(params.taskId, params.projectId);
@@ -333,8 +379,8 @@ function registerGetCardBySlug(server2, conn2) {
     "get_card_by_slug",
     "Get full card details by the slug from a card URL (/cards/<slug>) instead of a task ID. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      slug: z3.string().describe("The card slug from a Conveyor card URL, e.g. 'ship-it'")
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      slug: z4.string().describe("The card slug from a Conveyor card URL, e.g. 'ship-it'")
     },
     async (params) => {
       const task = await conn2.getCardBySlug(params.slug, params.projectId);
@@ -347,19 +393,22 @@ function registerCreateTask(server2, conn2) {
     "create_task",
     "Create a new task with title, description, and optional plan. Pass projectId to target a specific project; otherwise the configured default project is used. Icon, story points, and agent assignment are auto-filled when a task is created in (or later moved to) a status beyond Planning \u2014 don't spend turns on them.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      title: z3.string().describe("Task title"),
-      description: z3.string().optional().describe("Task description"),
-      plan: z3.string().optional().describe("Task implementation plan (markdown)"),
-      status: z3.enum(["Planning", "Open"]).optional().describe("Initial status (default: Planning)"),
-      subProjectId: z3.string().optional().describe(
-        "Scope to a sub-project board (list/search: filter; create/update: assign). Omit for the whole project."
-      )
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      title: z4.string().describe("Task title"),
+      description: z4.string().optional().describe("Task description"),
+      plan: z4.string().optional().describe("Task implementation plan (markdown)"),
+      status: z4.enum(["Planning", "Open"]).optional().describe("Initial status (default: Planning)"),
+      subProjectId: BOARD_ASSIGN
     },
     async (params) => {
       const task = await conn2.createTask(params);
       return {
-        content: [{ type: "text", text: `Task created: ${task.id} (slug: ${task.slug})` }]
+        content: [
+          {
+            type: "text",
+            text: `Task created: ${task.id} (slug: ${task.slug}). effectiveScope: ${JSON.stringify(task.effectiveScope)}`
+          }
+        ]
       };
     }
   );
@@ -369,17 +418,17 @@ function registerUpdateTask(server2, conn2) {
     "update_task",
     "Update task fields: title, description, plan, status, risk, or assignment. Set status to claim a card (InProgress), triage it (Open), or cancel it (Cancelled); for review approvals prefer approve_task / request_changes, which guard against stale-state races. Pass projectId to target a specific project; otherwise the configured default project is used. Moving a task beyond Planning auto-fills any missing icon, story points, and agent assignment \u2014 don't spend turns on them.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      taskId: z3.string().describe("The task ID"),
-      title: z3.string().optional().describe("New title"),
-      description: z3.string().optional().describe("New description"),
-      plan: z3.string().optional().describe("New plan (markdown)"),
-      status: z3.enum(STATUS_ENUM).optional().describe("New status"),
-      risk: z3.enum(RISK_ENUM).nullable().optional().describe(
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      taskId: z4.string().describe("The task ID"),
+      title: z4.string().optional().describe("New title"),
+      description: z4.string().optional().describe("New description"),
+      plan: z4.string().optional().describe("New plan (markdown)"),
+      status: z4.enum(STATUS_ENUM).optional().describe("New status"),
+      risk: z4.enum(RISK_ENUM).nullable().optional().describe(
         "Risk level \u2014 how much important surface the task touches (critical/high/medium/low). Pass null to clear."
       ),
-      assignedUserId: z3.string().nullable().optional().describe("User ID to assign, or null"),
-      subProjectId: z3.string().nullable().optional().describe(
+      assignedUserId: z4.string().nullable().optional().describe("User ID to assign, or null"),
+      subProjectId: z4.string().nullable().optional().describe(
         "Assign the task to a sub-project board; null moves it back to the parent board. Omit to leave unchanged."
       )
     },
@@ -396,9 +445,9 @@ function registerMoveCard(server2, conn2) {
     "move_card",
     "Move an eligible Planning or Open task, incident, or suggestion card to another project. Cards with identification or automation in progress, active compute, pull requests, deployments, releases, reviews, or delivered reporter email cannot move. Project-specific metadata is cleared instead of mapped by name. Pass projectId for the source project; otherwise the configured default project is used.",
     {
-      projectId: z3.string().optional().describe("Source Conveyor project ID"),
-      taskId: z3.string().describe("Card ID or slug"),
-      destinationProjectId: z3.string().describe("Destination Conveyor project ID")
+      projectId: z4.string().optional().describe("Source Conveyor project ID"),
+      taskId: z4.string().describe("Card ID or slug"),
+      destinationProjectId: z4.string().describe("Destination Conveyor project ID")
     },
     async (params) => {
       const result = await conn2.moveCard(params);
@@ -419,9 +468,9 @@ function registerChatTools(server2, conn2) {
     "read_task_chat",
     "Read messages from a task's chat. Pass projectId to target a specific project; otherwise the configured default project is used. For agent execution logs use get_task_logs.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      taskId: z3.string().describe("The task ID"),
-      limit: z3.number().optional().describe("Max messages to return (default 50)")
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      taskId: z4.string().describe("The task ID"),
+      limit: z4.number().optional().describe("Max messages to return (default 50)")
     },
     async (params) => {
       const messages = await conn2.getTaskChat(params.taskId, params.limit, params.projectId);
@@ -432,9 +481,9 @@ function registerChatTools(server2, conn2) {
     "post_to_chat",
     "Post a message to a task's chat. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      taskId: z3.string().describe("The task ID"),
-      content: z3.string().describe("Message content")
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      taskId: z4.string().describe("The task ID"),
+      content: z4.string().describe("Message content")
     },
     async (params) => {
       await conn2.postToTaskChat(params.taskId, params.content, params.projectId);
@@ -447,12 +496,12 @@ function registerGetTaskCli(server2, conn2) {
     "get_task_logs",
     "Read CLI execution logs from a task. Pass projectId to target a specific project; otherwise the configured default project is used. Returns agent reasoning, tool calls, setup output, and other execution events. For human chat use read_task_chat.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      taskId: z3.string().describe("The task ID or slug"),
-      source: z3.enum(["agent", "application"]).optional().describe(
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      taskId: z4.string().describe("The task ID or slug"),
+      source: z4.enum(["agent", "application"]).optional().describe(
         "Filter by log source: 'agent' for reasoning/tool calls, 'application' for setup/dev-server output"
       ),
-      limit: z3.number().optional().describe("Max entries to return (default 50, max 500)")
+      limit: z4.number().optional().describe("Max entries to return (default 50, max 500)")
     },
     async ({ taskId, source, limit, projectId: projectId2 }) => {
       const effectiveLimit = Math.min(limit ?? 50, 500);
@@ -471,8 +520,8 @@ function registerGetTaskSessions(server2, conn2) {
     "get_task_sessions",
     "Read compute-session state for a task: legacy CodespaceSession rows plus v3 workspaces, including purpose=review review workspaces. Shows pod identity, liveness, lifecycle, and code-review claim state. Use to diagnose stalled/dead agents or code-review runs. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      taskId: z3.string().describe("The task ID or slug")
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      taskId: z4.string().describe("The task ID or slug")
     },
     async ({ taskId, projectId: projectId2 }) => {
       const tasks = await conn2.getTaskSessions(taskId, projectId2);
@@ -490,19 +539,17 @@ function registerSearchTasks(server2, conn2) {
     "search_tasks",
     "Search cards by tag name, text query, status, type, and/or assignment. Defaults to type=task \u2014 pass typeFilters to include incidents/suggestions. Results are relevance-ordered: highest priority first then newest; suggestions-only queries rank by upvote score. Pass projectId to target a specific project; otherwise the configured default project is used. Use tag names like 'agent-runner', not IDs. Returns summaries \u2014 plan omitted, description truncated; use get_task for full details.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      tagNames: z3.array(z3.string()).optional().describe('Tag names to filter by (e.g., ["agent-runner", "chat"])'),
-      searchQuery: z3.string().optional().describe("Text search on title and description"),
-      statusFilters: z3.array(z3.enum(STATUS_ENUM)).optional().describe("Filter by one or more statuses"),
-      typeFilters: z3.array(z3.enum(CARD_TYPE_ENUM)).optional().describe(
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      tagNames: z4.array(z4.string()).optional().describe('Tag names to filter by (e.g., ["agent-runner", "chat"])'),
+      searchQuery: z4.string().optional().describe("Text search on title and description"),
+      statusFilters: z4.array(z4.enum(STATUS_ENUM)).optional().describe("Filter by one or more statuses"),
+      typeFilters: z4.array(z4.enum(CARD_TYPE_ENUM)).optional().describe(
         'Card types to include (default ["task"]). Pass e.g. ["incident"] or list several to search across types.'
       ),
-      assigneeId: z3.string().optional().describe("Filter by assigned user ID"),
-      unassigned: z3.boolean().optional().describe("Only return tasks with no assignee (mutually exclusive with assigneeId)"),
-      subProjectId: z3.string().optional().describe(
-        "Scope to a sub-project board (list/search: filter; create/update: assign). Omit for the whole project."
-      ),
-      limit: z3.number().optional().describe("Max results to return (default 20)")
+      assigneeId: z4.string().optional().describe("Filter by assigned user ID"),
+      unassigned: z4.boolean().optional().describe("Only return tasks with no assignee (mutually exclusive with assigneeId)"),
+      subProjectId: BOARD_FILTER,
+      limit: z4.number().optional().describe("Max results to return (default 20)")
     },
     async (params) => {
       const tasks = await conn2.searchTasks(params);
@@ -517,7 +564,7 @@ function registerListTags(server2, conn2) {
     "list_tags",
     "List all project tags with their names, IDs, and colors. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID")
+      projectId: z4.string().optional().describe("Target Conveyor project ID")
     },
     async (params) => {
       const tags = await conn2.listTags(params.projectId);
@@ -530,9 +577,9 @@ function registerReviewTools(server2, conn2) {
     "approve_task",
     "Move a task forward in the review flow (ReviewPR -> ReviewDev, or -> Complete). Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      taskId: z3.string().describe("The task ID"),
-      risk: z3.enum(RISK_ENUM).optional().describe("Optional risk level to record; defaults to a raise-only 'low' on approval.")
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      taskId: z4.string().describe("The task ID"),
+      risk: z4.enum(RISK_ENUM).optional().describe("Optional risk level to record; defaults to a raise-only 'low' on approval.")
     },
     async (params) => {
       const result = await conn2.approveTask(params.taskId, params.projectId, params.risk);
@@ -545,8 +592,8 @@ function registerReviewTools(server2, conn2) {
     "approve_and_merge_pr",
     "Approve and merge a child task's pull request. Pass projectId to target a specific project; otherwise the configured default project is used. Only succeeds if all CI/CD checks are passing. The child task must be in ReviewPR status with a PR.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      childTaskId: z3.string().describe("The child task ID whose PR should be approved and merged")
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      childTaskId: z4.string().describe("The child task ID whose PR should be approved and merged")
     },
     async (params) => {
       const result = await conn2.approveAndMergePR(params.childTaskId, params.projectId);
@@ -564,10 +611,10 @@ function registerReviewTools(server2, conn2) {
     "request_changes",
     "Post feedback and send task back to InProgress for more work. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      taskId: z3.string().describe("The task ID"),
-      feedback: z3.string().describe("Feedback message describing requested changes"),
-      risk: z3.enum(RISK_ENUM).optional().describe("Optional risk level to record; defaults to a raise-only 'medium' on changes.")
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      taskId: z4.string().describe("The task ID"),
+      feedback: z4.string().describe("Feedback message describing requested changes"),
+      risk: z4.enum(RISK_ENUM).optional().describe("Optional risk level to record; defaults to a raise-only 'medium' on changes.")
     },
     async (params) => {
       await conn2.requestChanges(params.taskId, params.feedback, params.projectId, params.risk);
@@ -584,9 +631,9 @@ function registerReviewerTools(server2, conn2) {
     "add_reviewer",
     "Add a project member as a reviewer on a task. Pass projectId to target a specific project; otherwise the configured default project is used. Idempotent \u2014 adding an existing reviewer is a no-op.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      taskId: z3.string().describe("The task ID or slug"),
-      userId: z3.string().describe("User ID of the reviewer (use list_project_members to resolve a name or email)")
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      taskId: z4.string().describe("The task ID or slug"),
+      userId: z4.string().describe("User ID of the reviewer (use list_project_members to resolve a name or email)")
     },
     async (params) => {
       const result = await conn2.addReviewer(params);
@@ -604,9 +651,9 @@ function registerReviewerTools(server2, conn2) {
     "remove_reviewer",
     "Remove a reviewer from a task. Pass projectId to target a specific project; otherwise the configured default project is used. Idempotent \u2014 removing a non-reviewer is a no-op.",
     {
-      projectId: z3.string().optional().describe("Target Conveyor project ID"),
-      taskId: z3.string().describe("The task ID or slug"),
-      userId: z3.string().describe("User ID of the reviewer to remove")
+      projectId: z4.string().optional().describe("Target Conveyor project ID"),
+      taskId: z4.string().describe("The task ID or slug"),
+      userId: z4.string().describe("User ID of the reviewer to remove")
     },
     async (params) => {
       const result = await conn2.removeReviewer(params);
@@ -638,7 +685,7 @@ function registerTaskTools(server2, conn2) {
 }
 
 // src/tools/builds.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 function textResult2(result) {
   return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
 }
@@ -647,8 +694,8 @@ function registerTaskLifecycleTools(server2, conn2) {
     "stop_task",
     "Compatibility alias for the legacy stop path. stop_task now performs the same durable sleep behavior as sleep_task, preserving task Claudespace state while stopping compute. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z4.string().optional().describe("Target Conveyor project ID"),
-      taskId: z4.string().describe("The task ID")
+      projectId: z5.string().optional().describe("Target Conveyor project ID"),
+      taskId: z5.string().describe("The task ID")
     },
     async (params) => textResult2(await conn2.sleepTask(params.taskId, params.projectId))
   );
@@ -656,8 +703,8 @@ function registerTaskLifecycleTools(server2, conn2) {
     "sleep_task",
     "Sleep a task Claudespace, stopping compute while preserving durable state. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z4.string().optional().describe("Target Conveyor project ID"),
-      taskId: z4.string().describe("The task ID")
+      projectId: z5.string().optional().describe("Target Conveyor project ID"),
+      taskId: z5.string().describe("The task ID")
     },
     async (params) => textResult2(await conn2.sleepTask(params.taskId, params.projectId))
   );
@@ -665,8 +712,8 @@ function registerTaskLifecycleTools(server2, conn2) {
     "resume_task",
     "Resume a sleeping task Claudespace. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z4.string().optional().describe("Target Conveyor project ID"),
-      taskId: z4.string().describe("The task ID")
+      projectId: z5.string().optional().describe("Target Conveyor project ID"),
+      taskId: z5.string().describe("The task ID")
     },
     async (params) => textResult2(await conn2.resumeTask(params.taskId, params.projectId))
   );
@@ -674,8 +721,8 @@ function registerTaskLifecycleTools(server2, conn2) {
     "delete_task_environment",
     "Delete a task environment, including durable Claudespace state. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z4.string().optional().describe("Target Conveyor project ID"),
-      taskId: z4.string().describe("The task ID")
+      projectId: z5.string().optional().describe("Target Conveyor project ID"),
+      taskId: z5.string().describe("The task ID")
     },
     async (params) => textResult2(await conn2.deleteTaskEnvironment(params.taskId, params.projectId))
   );
@@ -685,8 +732,8 @@ function registerBuildTools(server2, conn2) {
     "start_task",
     "Start a cloud build (codespace) for a task. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z4.string().optional().describe("Target Conveyor project ID"),
-      taskId: z4.string().describe("The task ID")
+      projectId: z5.string().optional().describe("Target Conveyor project ID"),
+      taskId: z5.string().describe("The task ID")
     },
     async (params) => {
       const result = await conn2.startBuild(params.taskId, params.projectId);
@@ -698,8 +745,8 @@ function registerBuildTools(server2, conn2) {
     "create_release",
     "Create a release for the project \u2014 the same flow as the Release button in the web UI. Pass projectId to target a specific project; otherwise the configured default project is used. Creates a release task with a release/YYYY.MM.N branch and a PR from the dev branch to the default branch. Omit taskIds to release ALL cards currently in Review (Dev); pass a subset to cherry-pick \u2014 a cloud build agent then cherry-picks those changes and resolves conflicts. Fails if a release is already in progress or no cards are in Review (Dev).",
     {
-      projectId: z4.string().optional().describe("Target Conveyor project ID"),
-      taskIds: z4.array(z4.string()).optional().describe(
+      projectId: z5.string().optional().describe("Target Conveyor project ID"),
+      taskIds: z5.array(z5.string()).optional().describe(
         "Task IDs in Review (Dev) to cherry-pick into the release. Omit to release all of them."
       )
     },
@@ -712,8 +759,8 @@ function registerBuildTools(server2, conn2) {
     "get_build_status",
     "Check codespace and agent status for a task. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z4.string().optional().describe("Target Conveyor project ID"),
-      taskId: z4.string().describe("The task ID")
+      projectId: z5.string().optional().describe("Target Conveyor project ID"),
+      taskId: z5.string().describe("The task ID")
     },
     async (params) => {
       const status = await conn2.getBuildStatus(params.taskId, params.projectId);
@@ -725,7 +772,7 @@ function registerBuildTools(server2, conn2) {
 // src/tools/attachments.ts
 import { readFile, stat } from "fs/promises";
 import { basename, extname } from "path";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 var MAX_FILE_SIZE_BYTES = 25 * 1024 * 1024;
 var MIME_BY_EXT = {
   ".png": "image/png",
@@ -762,8 +809,8 @@ function registerListTaskFiles(server2, conn2) {
     "list_task_files",
     "List all files attached to a task with metadata (no contents \u2014 fast and small). Pass projectId to target a specific project; otherwise the configured default project is used. Use before fetching a specific file to see what is available and how large each is. For file contents use get_attachment.",
     {
-      projectId: z5.string().optional().describe("Target Conveyor project ID"),
-      taskId: z5.string().describe("The task ID or slug")
+      projectId: z6.string().optional().describe("Target Conveyor project ID"),
+      taskId: z6.string().describe("The task ID or slug")
     },
     async (params) => {
       const files = await conn2.listTaskFiles(params.taskId, params.projectId);
@@ -805,11 +852,11 @@ function registerGetAttachment(server2, conn2) {
     "get_attachment",
     "Fetch one task file's content plus metadata by file ID (accepts task id or slug). Pass projectId to target a specific project; otherwise the configured default project is used. Images are returned as viewable image blocks. Large text files (logs, JSON) are returned in pages \u2014 use `offset`/`maxBytes` to read more, or fetch `downloadUrl` for the whole file. Call list_task_files first to discover IDs and sizes.",
     {
-      projectId: z5.string().optional().describe("Target Conveyor project ID"),
-      taskId: z5.string().describe("The task ID or slug"),
-      fileId: z5.string().describe("The file ID to fetch"),
-      offset: z5.number().int().nonnegative().optional().describe("Byte offset into text content (paging). Default 0."),
-      maxBytes: z5.number().int().positive().optional().describe("Max bytes of text content to return from offset.")
+      projectId: z6.string().optional().describe("Target Conveyor project ID"),
+      taskId: z6.string().describe("The task ID or slug"),
+      fileId: z6.string().describe("The file ID to fetch"),
+      offset: z6.number().int().nonnegative().optional().describe("Byte offset into text content (paging). Default 0."),
+      maxBytes: z6.number().int().positive().optional().describe("Max bytes of text content to return from offset.")
     },
     async (params) => {
       const file = await conn2.getAttachment(params.taskId, params.fileId, {
@@ -826,11 +873,11 @@ function registerUploadAttachment(server2, conn2) {
     "upload_attachment",
     "Upload a local file as a task attachment (any file type, up to 25MB). Pass projectId to target a specific project; otherwise the configured default project is used. The file appears under the task's Files. Pass `comment` to also post it to the task chat in the same step.",
     {
-      projectId: z5.string().optional().describe("Target Conveyor project ID"),
-      taskId: z5.string().describe("The task ID or slug"),
-      path: z5.string().describe("Absolute path to the local file to upload"),
-      comment: z5.string().optional().describe("When set, also posts the attachment to the task chat with this text"),
-      mimeType: z5.string().optional().describe("Override the mime type inferred from the file extension")
+      projectId: z6.string().optional().describe("Target Conveyor project ID"),
+      taskId: z6.string().describe("The task ID or slug"),
+      path: z6.string().describe("Absolute path to the local file to upload"),
+      comment: z6.string().optional().describe("When set, also posts the attachment to the task chat with this text"),
+      mimeType: z6.string().optional().describe("Override the mime type inferred from the file extension")
     },
     async (params) => {
       const info = await stat(params.path).catch(() => null);
@@ -893,18 +940,18 @@ function registerAttachmentTools(server2, conn2) {
 }
 
 // src/tools/pull-request.ts
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 function registerPullRequestTools(server2, conn2) {
   server2.tool(
     "create_pull_request",
     "Open a GitHub pull request for a task's existing branch (the branch must already be pushed to origin). Pass projectId to target a specific project; otherwise the configured default project is used. Moves the task to ReviewPR. Returns the PR number and URL.",
     {
-      projectId: z6.string().optional().describe("Target Conveyor project ID"),
-      taskId: z6.string().describe("The task ID whose branch should be opened as a PR"),
-      title: z6.string().describe("Pull request title"),
-      body: z6.string().describe("Pull request body (markdown)"),
-      head: z6.string().optional().describe("Source branch for the PR (defaults to the task's branch)"),
-      base: z6.string().optional().describe("Target branch for the PR (defaults to the repo default)")
+      projectId: z7.string().optional().describe("Target Conveyor project ID"),
+      taskId: z7.string().describe("The task ID whose branch should be opened as a PR"),
+      title: z7.string().describe("Pull request title"),
+      body: z7.string().describe("Pull request body (markdown)"),
+      head: z7.string().optional().describe("Source branch for the PR (defaults to the task's branch)"),
+      base: z7.string().optional().describe("Target branch for the PR (defaults to the repo default)")
     },
     async (params) => {
       const result = await conn2.createPullRequest(params);
@@ -916,7 +963,7 @@ function registerPullRequestTools(server2, conn2) {
 }
 
 // src/tools/subtasks.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 var STATUS_ENUM2 = [
   "Planning",
   "Open",
@@ -934,15 +981,15 @@ function registerCreateSubtask(server2, conn2) {
     "create_subtask",
     "Create a subtask under a parent task. Pass projectId to target a specific project; otherwise the configured default project is used. Subtasks break a larger task into independently buildable pieces. For children that instead ship on the parent's own branch/PR (e.g. per-theme tracking cards for one bundled PR), set followParentStatus so their status rides the parent's automatically.",
     {
-      projectId: z7.string().optional().describe("Target Conveyor project ID"),
-      parentTaskId: z7.string().describe("The parent task ID"),
-      title: z7.string().describe("Subtask title"),
-      description: z7.string().optional().describe("Subtask description"),
-      plan: z7.string().optional().describe("Subtask implementation plan (markdown)"),
-      ordinal: z7.number().optional().describe("Ordering position among siblings"),
-      storyPointValue: z7.number().optional().describe(SP_DESCRIPTION),
-      followParentStatus: z7.boolean().optional().describe(FOLLOW_PARENT_STATUS_DESCRIPTION),
-      dependsOn: z7.array(z7.string()).optional().describe(
+      projectId: z8.string().optional().describe("Target Conveyor project ID"),
+      parentTaskId: z8.string().describe("The parent task ID"),
+      title: z8.string().describe("Subtask title"),
+      description: z8.string().optional().describe("Subtask description"),
+      plan: z8.string().optional().describe("Subtask implementation plan (markdown)"),
+      ordinal: z8.number().optional().describe("Ordering position among siblings"),
+      storyPointValue: z8.number().optional().describe(SP_DESCRIPTION),
+      followParentStatus: z8.boolean().optional().describe(FOLLOW_PARENT_STATUS_DESCRIPTION),
+      dependsOn: z8.array(z8.string()).optional().describe(
         "Sibling subtask ids or slugs this subtask blocks on (it won't start until they merge to dev). Set explicit dependency metadata here instead of describing order in the plan text. Omit / leave empty for independent children so they run in parallel."
       )
     },
@@ -959,16 +1006,16 @@ function registerUpdateSubtask(server2, conn2) {
     "update_subtask",
     "Update a subtask's fields: title, description, plan, status, ordering, story points, or dependencies. Pass projectId to target a specific project; otherwise the configured default project is used. Moving a subtask beyond Planning auto-fills missing story points and agent assignment \u2014 don't spend turns on them.",
     {
-      projectId: z7.string().optional().describe("Target Conveyor project ID"),
-      subtaskId: z7.string().describe("The subtask ID"),
-      title: z7.string().optional().describe("New title"),
-      description: z7.string().optional().describe("New description"),
-      plan: z7.string().optional().describe("New plan (markdown)"),
-      status: z7.enum(STATUS_ENUM2).optional().describe("New status"),
-      ordinal: z7.number().optional().describe("New ordering position among siblings"),
-      storyPointValue: z7.number().optional().describe(SP_DESCRIPTION),
-      followParentStatus: z7.boolean().optional().describe(FOLLOW_PARENT_STATUS_DESCRIPTION),
-      dependsOn: z7.array(z7.string()).optional().describe(
+      projectId: z8.string().optional().describe("Target Conveyor project ID"),
+      subtaskId: z8.string().describe("The subtask ID"),
+      title: z8.string().optional().describe("New title"),
+      description: z8.string().optional().describe("New description"),
+      plan: z8.string().optional().describe("New plan (markdown)"),
+      status: z8.enum(STATUS_ENUM2).optional().describe("New status"),
+      ordinal: z8.number().optional().describe("New ordering position among siblings"),
+      storyPointValue: z8.number().optional().describe(SP_DESCRIPTION),
+      followParentStatus: z8.boolean().optional().describe(FOLLOW_PARENT_STATUS_DESCRIPTION),
+      dependsOn: z8.array(z8.string()).optional().describe(
         "Replace the sibling subtask ids/slugs this subtask blocks on (pass [] to clear). Omit to leave dependencies unchanged."
       )
     },
@@ -987,8 +1034,8 @@ function registerListSubtasks(server2, conn2) {
     "list_subtasks",
     "List all subtasks of a parent task with their status and ordering. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z7.string().optional().describe("Target Conveyor project ID"),
-      taskId: z7.string().describe("The parent task ID")
+      projectId: z8.string().optional().describe("Target Conveyor project ID"),
+      taskId: z8.string().describe("The parent task ID")
     },
     async (params) => {
       const subtasks = await conn2.listSubtasks(params.taskId, params.projectId);
@@ -1001,8 +1048,8 @@ function registerDeleteSubtask(server2, conn2) {
     "delete_subtask",
     "Delete a subtask by ID. Pass projectId to target a specific project; otherwise the configured default project is used. This is permanent \u2014 use update_subtask to set status to Cancelled if you only want to close it.",
     {
-      projectId: z7.string().optional().describe("Target Conveyor project ID"),
-      subtaskId: z7.string().describe("The subtask ID to delete")
+      projectId: z8.string().optional().describe("Target Conveyor project ID"),
+      subtaskId: z8.string().describe("The subtask ID to delete")
     },
     async (params) => {
       const result = await conn2.deleteSubtask(params.subtaskId, params.projectId);
@@ -1022,14 +1069,14 @@ function registerSubtaskTools(server2, conn2) {
 }
 
 // src/tools/dependencies.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 function registerGetDependencies(server2, conn2) {
   server2.tool(
     "get_dependencies",
     "Get a task's dependencies and their met/unmet status (met = merged to dev). Pass projectId to target a specific project; otherwise the configured default project is used. Use to confirm blockers merged, or see why a task cannot start. For task state use get_task.",
     {
-      projectId: z8.string().optional().describe("Target Conveyor project ID"),
-      taskId: z8.string().describe("The task ID")
+      projectId: z9.string().optional().describe("Target Conveyor project ID"),
+      taskId: z9.string().describe("The task ID")
     },
     async (params) => {
       const deps = await conn2.getDependencies(params.taskId, params.projectId);
@@ -1042,9 +1089,9 @@ function registerAddDependency(server2, conn2) {
     "add_dependency",
     "Add a blocking dependency \u2014 this task cannot start until the named task is merged to dev. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z8.string().optional().describe("Target Conveyor project ID"),
-      taskId: z8.string().describe("The task ID that will be blocked"),
-      dependsOnSlugOrId: z8.string().describe("Slug or ID of the task this one depends on")
+      projectId: z9.string().optional().describe("Target Conveyor project ID"),
+      taskId: z9.string().describe("The task ID that will be blocked"),
+      dependsOnSlugOrId: z9.string().describe("Slug or ID of the task this one depends on")
     },
     async (params) => {
       await conn2.addDependency(params);
@@ -1057,9 +1104,9 @@ function registerRemoveDependency(server2, conn2) {
     "remove_dependency",
     "Remove a previously added dependency from a task. Pass projectId to target a specific project; otherwise the configured default project is used. The task is no longer blocked by the named task. Returns: confirmation string.",
     {
-      projectId: z8.string().optional().describe("Target Conveyor project ID"),
-      taskId: z8.string().describe("The task ID to unblock"),
-      dependsOnSlugOrId: z8.string().describe("Slug or ID of the dependency to remove")
+      projectId: z9.string().optional().describe("Target Conveyor project ID"),
+      taskId: z9.string().describe("The task ID to unblock"),
+      dependsOnSlugOrId: z9.string().describe("Slug or ID of the dependency to remove")
     },
     async (params) => {
       await conn2.removeDependency(params);
@@ -1074,16 +1121,16 @@ function registerDependencyTools(server2, conn2) {
 }
 
 // src/tools/suggestions.ts
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 function registerSuggestionTools(server2, conn2) {
   server2.tool(
     "create_suggestion",
     "Suggest a feature, improvement, rule, or idea for the project. Pass projectId to target a specific project; otherwise the configured default project is used. Duplicates are deduped and your upvote is recorded.",
     {
-      projectId: z9.string().optional().describe("Target Conveyor project ID"),
-      title: z9.string().describe("Suggestion title"),
-      description: z9.string().optional().describe("Suggestion details (markdown)"),
-      tagNames: z9.array(z9.string()).optional().describe('Tag names to categorize the suggestion (e.g., ["agent-runner"])')
+      projectId: z10.string().optional().describe("Target Conveyor project ID"),
+      title: z10.string().describe("Suggestion title"),
+      description: z10.string().optional().describe("Suggestion details (markdown)"),
+      tagNames: z10.array(z10.string()).optional().describe('Tag names to categorize the suggestion (e.g., ["agent-runner"])')
     },
     async (params) => {
       const result = await conn2.createSuggestion(params);
@@ -1094,7 +1141,7 @@ function registerSuggestionTools(server2, conn2) {
 }
 
 // src/tools/checklists.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 function renderManualTestGroups(groups) {
   const lines = [];
   for (const g of groups) {
@@ -1117,8 +1164,8 @@ function registerListManualTests(server2, conn2) {
     "list_manual_tests",
     "List the manual test checklist items for a task. Pass projectId to target a specific project; otherwise the configured default project is used. Use to see what manual verification steps have already been recorded.",
     {
-      projectId: z10.string().optional().describe("Target Conveyor project ID"),
-      taskId: z10.string().describe("The task ID or slug (the value in a card URL, /cards/<slug>)")
+      projectId: z11.string().optional().describe("Target Conveyor project ID"),
+      taskId: z11.string().describe("The task ID or slug (the value in a card URL, /cards/<slug>)")
     },
     async (params) => {
       const items = await conn2.listManualTests(params.taskId, params.projectId);
@@ -1144,9 +1191,9 @@ function registerSetManualTests(server2, conn2) {
     "set_manual_tests",
     "Add manual test steps to a task's checklist. Pass projectId to target a specific project; otherwise the configured default project is used. Existing items with the same title are automatically skipped (deduplication). Use to record specific manual verification steps that reviewers should follow when testing the task's PR.",
     {
-      projectId: z10.string().optional().describe("Target Conveyor project ID"),
-      taskId: z10.string().describe("The task ID or slug"),
-      items: z10.array(z10.object({ title: z10.string().min(1).describe("A concise, actionable test step") })).min(1).describe("List of manual test steps to add")
+      projectId: z11.string().optional().describe("Target Conveyor project ID"),
+      taskId: z11.string().describe("The task ID or slug"),
+      items: z11.array(z11.object({ title: z11.string().min(1).describe("A concise, actionable test step") })).min(1).describe("List of manual test steps to add")
     },
     async (params) => {
       const result = await conn2.setManualTests(params.taskId, params.items, params.projectId);
@@ -1161,10 +1208,10 @@ function registerEditManualTest(server2, conn2) {
     "edit_manual_test",
     "Rename an existing manual test step on a task. Pass projectId to target a specific project; otherwise the configured default project is used. Identify the test by its current title (case-insensitive) and pass the new title to replace it.",
     {
-      projectId: z10.string().optional().describe("Target Conveyor project ID"),
-      taskId: z10.string().describe("The task ID or slug"),
-      title: z10.string().min(1).describe("The current title of the manual test to edit"),
-      newTitle: z10.string().min(1).describe("The new title for the manual test")
+      projectId: z11.string().optional().describe("Target Conveyor project ID"),
+      taskId: z11.string().describe("The task ID or slug"),
+      title: z11.string().min(1).describe("The current title of the manual test to edit"),
+      newTitle: z11.string().min(1).describe("The new title for the manual test")
     },
     async (params) => {
       await conn2.editManualTest(params.taskId, params.title, params.newTitle, params.projectId);
@@ -1177,9 +1224,9 @@ function registerRemoveManualTest(server2, conn2) {
     "remove_manual_test",
     "Remove an existing manual test step from a task's checklist. Pass projectId to target a specific project; otherwise the configured default project is used. Identify the test by its title (case-insensitive).",
     {
-      projectId: z10.string().optional().describe("Target Conveyor project ID"),
-      taskId: z10.string().describe("The task ID or slug"),
-      title: z10.string().min(1).describe("The title of the manual test to remove")
+      projectId: z11.string().optional().describe("Target Conveyor project ID"),
+      taskId: z11.string().describe("The task ID or slug"),
+      title: z11.string().min(1).describe("The title of the manual test to remove")
     },
     async (params) => {
       await conn2.removeManualTest(params.taskId, params.title, params.projectId);
@@ -1192,9 +1239,9 @@ function registerApproveManualTest(server2, conn2) {
     "approve_manual_test",
     "Sign off on (approve) a manual test step on a task on behalf of your authenticated user. Pass projectId to target a specific project; otherwise the configured default project is used. Identify the test by its title (case-insensitive). Use after you have verified the step passes.",
     {
-      projectId: z10.string().optional().describe("Target Conveyor project ID"),
-      taskId: z10.string().describe("The task ID or slug"),
-      title: z10.string().min(1).describe("The title of the manual test to approve")
+      projectId: z11.string().optional().describe("Target Conveyor project ID"),
+      taskId: z11.string().describe("The task ID or slug"),
+      title: z11.string().min(1).describe("The title of the manual test to approve")
     },
     async (params) => {
       await conn2.approveManualTest(params.taskId, params.title, params.projectId);
@@ -1207,10 +1254,10 @@ function registerRejectManualTest(server2, conn2) {
     "reject_manual_test",
     "Flag an issue with (reject) a manual test step on a task on behalf of your authenticated user, recording the reason. Pass projectId to target a specific project; otherwise the configured default project is used. Identify the test by its title (case-insensitive). Use when the step fails verification.",
     {
-      projectId: z10.string().optional().describe("Target Conveyor project ID"),
-      taskId: z10.string().describe("The task ID or slug"),
-      title: z10.string().min(1).describe("The title of the manual test to reject"),
-      reason: z10.string().min(1).max(2e3).describe("Why the test failed \u2014 what went wrong, shown to the team")
+      projectId: z11.string().optional().describe("Target Conveyor project ID"),
+      taskId: z11.string().describe("The task ID or slug"),
+      title: z11.string().min(1).describe("The title of the manual test to reject"),
+      reason: z11.string().min(1).max(2e3).describe("Why the test failed \u2014 what went wrong, shown to the team")
     },
     async (params) => {
       await conn2.rejectManualTest(params.taskId, params.title, params.reason, params.projectId);
@@ -1230,9 +1277,9 @@ function registerQueryManualTests(server2, conn2) {
     "query_manual_tests",
     "Query manual tests across many tasks in a project, grouped by task. Filter by card status (e.g. ReviewDev, ReviewLive, Complete) and/or test status (open | approved | rejected). Use to answer questions like 'show all OPEN manual tests in ReviewDev' or 'show all REJECTED manual tests in ReviewDev/ReviewLive with the failing reason'. With no filters it defaults to the needs-attention view: open+rejected tests on ReviewDev/ReviewLive cards. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z10.string().optional().describe("Target Conveyor project ID"),
-      cardStatuses: z10.array(z10.string()).optional().describe('Filter tasks by card/column status, e.g. ["ReviewDev", "ReviewLive"]'),
-      testStatuses: z10.array(z10.enum(["open", "approved", "rejected"])).optional().describe("Filter tests by status: open | approved | rejected")
+      projectId: z11.string().optional().describe("Target Conveyor project ID"),
+      cardStatuses: z11.array(z11.string()).optional().describe('Filter tasks by card/column status, e.g. ["ReviewDev", "ReviewLive"]'),
+      testStatuses: z11.array(z11.enum(["open", "approved", "rejected"])).optional().describe("Filter tests by status: open | approved | rejected")
     },
     async (params) => {
       const groups = await conn2.queryManualTests({
@@ -1258,7 +1305,7 @@ function registerChecklistTools(server2, conn2) {
 }
 
 // src/tools/workspace.ts
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 
 // src/workspace-ssh-tunnel.ts
 import net from "net";
@@ -1377,8 +1424,8 @@ function registerAttachInfoTool(server2, conn2) {
     "workspace_attach_info",
     "Return SSH/SFTP attach metadata for a running task Claudespace, plus hosted preview URLs and configured preview ports. Optionally installs an OpenSSH public key for this attach session.",
     {
-      taskId: z11.string().describe("The task ID"),
-      sshPublicKey: z11.string().optional().describe("Optional OpenSSH public key to install into the workspace")
+      taskId: z12.string().describe("The task ID"),
+      sshPublicKey: z12.string().optional().describe("Optional OpenSSH public key to install into the workspace")
     },
     async ({ taskId, sshPublicKey }) => {
       const info = await conn2.getWorkspaceAttachInfo(taskId, sshPublicKey);
@@ -1391,7 +1438,7 @@ function registerPreviewUrlsTool(server2, conn2) {
     "workspace_preview_urls",
     "Return the hosted preview URLs and preview ports for a running task Claudespace. This mirrors the web UI preview link metadata.",
     {
-      taskId: z11.string().describe("The task ID")
+      taskId: z12.string().describe("The task ID")
     },
     async ({ taskId }) => {
       const info = await conn2.getWorkspaceAttachInfo(taskId);
@@ -1420,10 +1467,10 @@ function registerStartTunnelTool(server2, conn2, startTunnel) {
     "workspace_start_tunnel",
     "Start a local loopback tunnel through the MCP server to a running task Claudespace port. Use port 2222 for SSH/SFTP, or one of previewPorts for app access.",
     {
-      taskId: z11.string().describe("The task ID"),
-      port: z11.number().optional().describe("Remote Claudespace port. Defaults to SSH port 2222."),
-      preferredLocalPort: z11.number().optional().describe("Preferred local loopback port. If omitted, the OS chooses one."),
-      sshPublicKey: z11.string().optional().describe("Optional OpenSSH public key to install before opening the tunnel")
+      taskId: z12.string().describe("The task ID"),
+      port: z12.number().optional().describe("Remote Claudespace port. Defaults to SSH port 2222."),
+      preferredLocalPort: z12.number().optional().describe("Preferred local loopback port. If omitted, the OS chooses one."),
+      sshPublicKey: z12.string().optional().describe("Optional OpenSSH public key to install before opening the tunnel")
     },
     async ({ taskId, port, preferredLocalPort, sshPublicKey }) => {
       const info = await conn2.getWorkspaceAttachInfo(taskId, sshPublicKey);
@@ -1476,7 +1523,7 @@ function registerStopTunnelTool(server2) {
     "workspace_stop_tunnel",
     "Stop a local workspace tunnel previously opened by workspace_start_tunnel.",
     {
-      tunnelId: z11.string().describe("Tunnel id returned by workspace_start_tunnel")
+      tunnelId: z12.string().describe("Tunnel id returned by workspace_start_tunnel")
     },
     async ({ tunnelId }) => {
       const tunnel = activeTunnels.get(tunnelId);
@@ -1495,7 +1542,7 @@ function registerWorkspaceTools(server2, conn2, deps = {}) {
 }
 
 // src/tools/logs.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 var SEVERITY_ENUM = [
   "DEBUG",
   "INFO",
@@ -1630,18 +1677,18 @@ function registerGrafanaLogTool(server2, conn2) {
     "query_grafana_logs",
     "Query the project's connected Grafana (Loki) logs \u2014 the application logs shipped to Grafana Cloud/Loki, complementing query_gcp_logs (GCP infrastructure logs). Start with structured filters (env, level=error, sinceMinutes=60, services), then narrow with search; pass raw LogQL via logql only when structured filters can't express the query (it REPLACES them). The response header echoes the composed LogQL \u2014 iterate on it. Returns compact lines: '<time> <SEVERITY> [<service>] <message>'.",
     {
-      projectId: z12.string().optional().describe("Target Conveyor project ID"),
-      env: z12.enum(["prod", "dev"]).optional().describe("Configured Grafana env mapping to scope by (default prod)"),
-      sinceMinutes: z12.number().int().min(1).max(10080).optional().describe(
+      projectId: z13.string().optional().describe("Target Conveyor project ID"),
+      env: z13.enum(["prod", "dev"]).optional().describe("Configured Grafana env mapping to scope by (default prod)"),
+      sinceMinutes: z13.number().int().min(1).max(10080).optional().describe(
         "Relative time window ending now, in minutes (default 60). Ignored if startTime is set."
       ),
-      startTime: z12.string().optional().describe("ISO 8601 lower bound (overrides sinceMinutes)"),
-      endTime: z12.string().optional().describe("ISO 8601 upper bound (default now)"),
-      level: z12.enum(["debug", "info", "warn", "error", "fatal"]).optional().describe("Minimum severity, inclusive \u2014 error returns error and above"),
-      services: z12.array(z12.string()).optional().describe("Restrict to these service_name label values"),
-      search: z12.string().max(256).optional().describe("Substring line filter (exact substring, not regex)"),
-      logql: z12.string().max(2e3).optional().describe("Advanced: raw LogQL query \u2014 REPLACES env/services/level/search composition"),
-      limit: z12.number().int().min(1).max(200).optional().describe("Max entries (default 50)")
+      startTime: z13.string().optional().describe("ISO 8601 lower bound (overrides sinceMinutes)"),
+      endTime: z13.string().optional().describe("ISO 8601 upper bound (default now)"),
+      level: z13.enum(["debug", "info", "warn", "error", "fatal"]).optional().describe("Minimum severity, inclusive \u2014 error returns error and above"),
+      services: z13.array(z13.string()).optional().describe("Restrict to these service_name label values"),
+      search: z13.string().max(256).optional().describe("Substring line filter (exact substring, not regex)"),
+      logql: z13.string().max(2e3).optional().describe("Advanced: raw LogQL query \u2014 REPLACES env/services/level/search composition"),
+      limit: z13.number().int().min(1).max(200).optional().describe("Max entries (default 50)")
     },
     async (params) => {
       const text = await runQueryGrafanaLogs(conn2, params);
@@ -1654,25 +1701,25 @@ function registerLogTools(server2, conn2) {
     "query_gcp_logs",
     "Query Google Cloud Logging for a project's linked GCP environments \u2014 use this to investigate production or dev issues directly ('something broke on prod'). Envs: 'prod' and 'dev' are the project's Cloud Run apps + Cloud SQL databases (scoped by default to the resources linked in project settings); 'claudespace' is the project's GKE agent-pod namespace. Start broad (severity=ERROR, sinceMinutes=60), then narrow with services/search. Returns compact lines: '<time> <SEVERITY> [<source>] <message> | key=value \u2026' (the key=value tail is the entry's structured payload \u2014 error details, service/method, actor and entity ids). When the response ends with a pageToken line, pass that token back as pageToken for the next page. Pass projectId to target a specific project; otherwise the configured default project is used.",
     {
-      projectId: z12.string().optional().describe("Target Conveyor project ID"),
-      env: z12.enum(["prod", "dev", "claudespace"]).optional().describe("GCP environment slot to query (default prod)"),
-      sinceMinutes: z12.number().int().min(1).max(10080).optional().describe(
+      projectId: z13.string().optional().describe("Target Conveyor project ID"),
+      env: z13.enum(["prod", "dev", "claudespace"]).optional().describe("GCP environment slot to query (default prod)"),
+      sinceMinutes: z13.number().int().min(1).max(10080).optional().describe(
         "Relative time window ending now, in minutes (default 60). Ignored if startTime is set."
       ),
-      startTime: z12.string().optional().describe("ISO 8601 lower bound (overrides sinceMinutes)"),
-      endTime: z12.string().optional().describe("ISO 8601 upper bound (default now)"),
-      severity: z12.enum(SEVERITY_ENUM).optional().describe("Minimum severity, inclusive \u2014 ERROR returns ERROR and above"),
-      services: z12.array(z12.string()).optional().describe(
+      startTime: z13.string().optional().describe("ISO 8601 lower bound (overrides sinceMinutes)"),
+      endTime: z13.string().optional().describe("ISO 8601 upper bound (default now)"),
+      severity: z13.enum(SEVERITY_ENUM).optional().describe("Minimum severity, inclusive \u2014 ERROR returns ERROR and above"),
+      services: z13.array(z13.string()).optional().describe(
         "Restrict to these Cloud Run service names (prod/dev only). Defaults to all services linked in project settings."
       ),
-      sqlInstances: z12.array(z12.string()).optional().describe("Restrict to these Cloud SQL instance names (prod/dev only)"),
-      allServices: z12.boolean().optional().describe(
+      sqlInstances: z13.array(z13.string()).optional().describe("Restrict to these Cloud SQL instance names (prod/dev only)"),
+      allServices: z13.boolean().optional().describe(
         "Set true to search ALL logs in the GCP project, ignoring the linked-resource scope"
       ),
-      search: z12.string().max(256).optional().describe("Free-text search across all log fields (exact substring, not regex)"),
-      filter: z12.string().max(1e3).optional().describe("Advanced: raw Cloud Logging filter expression, ANDed with the scope"),
-      limit: z12.number().int().min(1).max(200).optional().describe("Max entries per page (default 50)"),
-      pageToken: z12.string().optional().describe("Opaque token from a previous response to fetch the next page")
+      search: z13.string().max(256).optional().describe("Free-text search across all log fields (exact substring, not regex)"),
+      filter: z13.string().max(1e3).optional().describe("Advanced: raw Cloud Logging filter expression, ANDed with the scope"),
+      limit: z13.number().int().min(1).max(200).optional().describe("Max entries per page (default 50)"),
+      pageToken: z13.string().optional().describe("Opaque token from a previous response to fetch the next page")
     },
     async (params) => {
       const text = await runQueryGcpLogs(conn2, params);
@@ -1685,6 +1732,7 @@ function registerLogTools(server2, conn2) {
 // src/tools/index.ts
 function registerAllTools(server2, conn2) {
   registerProjectTools(server2, conn2);
+  registerConnectionTools(server2, conn2);
   registerProjectConfigTools(server2, conn2);
   registerTaskTools(server2, conn2);
   registerBuildTools(server2, conn2);
@@ -1703,13 +1751,14 @@ var { version } = createRequire(import.meta.url)("../package.json");
 var apiUrl = process.env.CONVEYOR_API_URL;
 var projectToken = process.env.CONVEYOR_USER_TOKEN ?? process.env.CONVEYOR_PROJECT_TOKEN;
 var projectId = process.env.CONVEYOR_PROJECT_ID;
+var subProjectId = process.env.CONVEYOR_SUBPROJECT_ID;
 if (!apiUrl || !projectToken) {
   process.stderr.write(
     "Error: CONVEYOR_API_URL and CONVEYOR_USER_TOKEN or CONVEYOR_PROJECT_TOKEN environment variables are required. CONVEYOR_PROJECT_ID is optional and sets the default project.\n"
   );
   process.exit(1);
 }
-var conn = new ConveyorConnection({ apiUrl, projectToken, projectId });
+var conn = new ConveyorConnection({ apiUrl, projectToken, projectId, subProjectId });
 try {
   await conn.connect();
   process.stderr.write("Connected to Conveyor API\n");