@task-boards/mcp-server 0.22.0 → 0.25.0

package/build/cli.js

@@ -43,7 +43,10 @@ var require_agent_runs_api = __commonJS({
       retryAgentRun: (id) => `${exports.AGENT_RUNS_PREFIX}/${id}/retry`,
       acknowledgeAgentRun: (id) => `${exports.AGENT_RUNS_PREFIX}/${id}/acknowledge`,
       setAgentRunAttention: (id) => `${exports.AGENT_RUNS_PREFIX}/${id}/attention`,
-      completeAgentRun: (id) => `${exports.AGENT_RUNS_PREFIX}/${id}/complete`
+      completeAgentRun: (id) => `${exports.AGENT_RUNS_PREFIX}/${id}/complete`,
+      registerAgentRunProcess: (agentRunId) => `${exports.AGENT_RUNS_PREFIX}/${agentRunId}/process-registration`,
+      getAgentRunProcessRegistration: (agentRunId) => `${exports.AGENT_RUNS_PREFIX}/${agentRunId}/process-registration`,
+      unregisterAgentRunProcess: (agentRunId) => `${exports.AGENT_RUNS_PREFIX}/${agentRunId}/process-registration`
     };
   }
 });
@@ -656,7 +659,8 @@ var require_work_items_api = __commonJS({
       updateWorkItem: (id) => `${exports.WORK_ITEMS_PREFIX}/${id}`,
       deleteWorkItem: (id) => `${exports.WORK_ITEMS_PREFIX}/${id}`,
       getDeletePreview: (id) => `${exports.WORK_ITEMS_PREFIX}/${id}/delete-preview`,
-      moveWorkItem: (id) => `${exports.WORK_ITEMS_PREFIX}/${id}/move`
+      moveWorkItem: (id) => `${exports.WORK_ITEMS_PREFIX}/${id}/move`,
+      stopWorkItemAgent: (workItemId) => `${exports.WORK_ITEMS_PREFIX}/${workItemId}/stop-agent`
     };
   }
 });
@@ -829,13 +833,24 @@ var require_feedback_enum = __commonJS({
   "../api/build/feedback/feedback.enum.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.FEEDBACK_TYPE = void 0;
+    exports.FEEDBACK_PULSE_ACTIVE_VIEW_VALUES = exports.FEEDBACK_PULSE_ACTIVE_VIEW = exports.FEEDBACK_INTERFACE_MODE = exports.FEEDBACK_TYPE = void 0;
     exports.FEEDBACK_TYPE = {
       BUG: "BUG",
       IMPROVEMENT: "IMPROVEMENT",
       QUESTION: "QUESTION",
       OTHER: "OTHER"
     };
+    exports.FEEDBACK_INTERFACE_MODE = {
+      PULSE: "pulse",
+      LEGACY: "legacy"
+    };
+    exports.FEEDBACK_PULSE_ACTIVE_VIEW = {
+      LIST: "list",
+      BOARD: "board",
+      TIMELINE: "timeline",
+      AGENTS: "agents"
+    };
+    exports.FEEDBACK_PULSE_ACTIVE_VIEW_VALUES = Object.values(exports.FEEDBACK_PULSE_ACTIVE_VIEW);
   }
 });
 
@@ -902,7 +917,9 @@ var require_notifications_enum = __commonJS({
       AGENT_NEEDS_CLARIFICATION: "AGENT_NEEDS_CLARIFICATION",
       AGENT_RUN_FAILED: "AGENT_RUN_FAILED",
       AGENT_QA_HAS_BUGS: "AGENT_QA_HAS_BUGS",
-      AGENT_BATCH_COMPLETED: "AGENT_BATCH_COMPLETED"
+      AGENT_BATCH_COMPLETED: "AGENT_BATCH_COMPLETED",
+      WORK_ITEM_COMMENT: "WORK_ITEM_COMMENT",
+      WORK_ITEM_STATUS_CHANGE: "WORK_ITEM_STATUS_CHANGE"
     };
   }
 });
@@ -942,6 +959,74 @@ var require_notifications = __commonJS({
   }
 });
 
+// ../api/build/activity-feed/activity-feed.api.js
+var require_activity_feed_api = __commonJS({
+  "../api/build/activity-feed/activity-feed.api.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.ACTIVITY_FEED_ROUTES = exports.ACTIVITY_FEED_PREFIX = void 0;
+    exports.ACTIVITY_FEED_PREFIX = "/activity-feed";
+    exports.ACTIVITY_FEED_ROUTES = {
+      listActivityFeed: () => exports.ACTIVITY_FEED_PREFIX,
+      getUnreadCount: () => `${exports.ACTIVITY_FEED_PREFIX}/unread-count`
+    };
+  }
+});
+
+// ../api/build/activity-feed/activity-feed.enum.js
+var require_activity_feed_enum = __commonJS({
+  "../api/build/activity-feed/activity-feed.enum.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.ACTIVITY_FEED_KIND_VALUES = exports.ACTIVITY_FEED_KIND = void 0;
+    exports.ACTIVITY_FEED_KIND = {
+      AGENT_IDE_ATTENTION: "AGENT_IDE_ATTENTION",
+      AGENT_NEEDS_CLARIFICATION: "AGENT_NEEDS_CLARIFICATION",
+      AGENT_RUN_FAILED: "AGENT_RUN_FAILED",
+      AGENT_QA_HAS_BUGS: "AGENT_QA_HAS_BUGS",
+      AGENT_BATCH_COMPLETED: "AGENT_BATCH_COMPLETED",
+      WORK_ITEM_COMMENT: "WORK_ITEM_COMMENT",
+      WORK_ITEM_STATUS_CHANGE: "WORK_ITEM_STATUS_CHANGE"
+    };
+    exports.ACTIVITY_FEED_KIND_VALUES = Object.values(exports.ACTIVITY_FEED_KIND);
+  }
+});
+
+// ../api/build/activity-feed/activity-feed.types.js
+var require_activity_feed_types = __commonJS({
+  "../api/build/activity-feed/activity-feed.types.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+  }
+});
+
+// ../api/build/activity-feed/index.js
+var require_activity_feed = __commonJS({
+  "../api/build/activity-feed/index.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    }) : (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __exportStar = exports && exports.__exportStar || function(m, exports2) {
+      for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports2, p)) __createBinding(exports2, m, p);
+    };
+    Object.defineProperty(exports, "__esModule", { value: true });
+    __exportStar(require_activity_feed_api(), exports);
+    __exportStar(require_activity_feed_enum(), exports);
+    __exportStar(require_activity_feed_types(), exports);
+  }
+});
+
 // ../api/build/agent-runs/agent-runs.types.js
 var require_agent_runs_types = __commonJS({
   "../api/build/agent-runs/agent-runs.types.js"(exports) {
@@ -1007,6 +1092,7 @@ var require_build = __commonJS({
     __exportStar(require_comments(), exports);
     __exportStar(require_feedback(), exports);
     __exportStar(require_notifications(), exports);
+    __exportStar(require_activity_feed(), exports);
     __exportStar(require_agent_runs_api(), exports);
     __exportStar(require_agent_runs_types(), exports);
   }
@@ -2287,6 +2373,7 @@ var require_realtime_events = __commonJS({
       WORK_ITEM_UPDATED: "work_item.updated",
       WORK_ITEM_MOVED: "work_item.moved",
       AGENT_RUN_STATUS_CHANGED: "agent_run.status_changed",
+      AGENT_ACTIVITY: "agent.activity",
       COMMENT_CREATED: "comment.created",
       COMMENT_DELETED: "comment.deleted",
       WORK_ITEM_DELETED: "work_item.deleted",
@@ -3326,10 +3413,18 @@ var require_slug_util = __commonJS({
   "../shared/build/subagent/slug.util.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
+    exports.isValidSubagentSlugFormat = isValidSubagentSlugFormat;
     exports.nameToSubagentSlug = nameToSubagentSlug;
     exports.resolveSlugCollision = resolveSlugCollision;
     var MAX_SUBAGENT_SLUG_LENGTH2 = 64;
+    var SUBAGENT_SLUG_FORMAT_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
     var FALLBACK_SLUG = "subagent";
+    function isValidSubagentSlugFormat(slug) {
+      if (slug.length === 0 || slug.length > MAX_SUBAGENT_SLUG_LENGTH2) {
+        return false;
+      }
+      return SUBAGENT_SLUG_FORMAT_PATTERN.test(slug);
+    }
     function nameToSubagentSlug(name) {
       const normalized = name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-");
       if (normalized.length === 0) {
@@ -3432,7 +3527,7 @@ var require_subagent = __commonJS({
   "../shared/build/subagent/index.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.buildSubagentFileContentFromBody = exports.buildSubagentFileContent = exports.buildSubagentDefinition = exports.buildSubagentBodyMarkdown = exports.resolveSlugCollision = exports.nameToSubagentSlug = exports.SUBAGENT_PREVIEW_MODE = exports.validateSubagentLlmBodyMarkdown = exports.validateSubagentLlmInput = exports.BUILTIN_IDE_SUBAGENT_SLUGS = void 0;
+    exports.buildSubagentFileContentFromBody = exports.buildSubagentFileContent = exports.buildSubagentDefinition = exports.buildSubagentBodyMarkdown = exports.resolveSlugCollision = exports.nameToSubagentSlug = exports.isValidSubagentSlugFormat = exports.SUBAGENT_PREVIEW_MODE = exports.validateSubagentLlmBodyMarkdown = exports.validateSubagentLlmInput = exports.BUILTIN_IDE_SUBAGENT_SLUGS = void 0;
     var builtin_ide_subagents_const_1 = require_builtin_ide_subagents_const();
     Object.defineProperty(exports, "BUILTIN_IDE_SUBAGENT_SLUGS", { enumerable: true, get: function() {
       return builtin_ide_subagents_const_1.BUILTIN_IDE_SUBAGENT_SLUGS;
@@ -3450,6 +3545,9 @@ var require_subagent = __commonJS({
       return subagent_preview_mode_enum_1.SUBAGENT_PREVIEW_MODE;
     } });
     var slug_util_1 = require_slug_util();
+    Object.defineProperty(exports, "isValidSubagentSlugFormat", { enumerable: true, get: function() {
+      return slug_util_1.isValidSubagentSlugFormat;
+    } });
     Object.defineProperty(exports, "nameToSubagentSlug", { enumerable: true, get: function() {
       return slug_util_1.nameToSubagentSlug;
     } });
@@ -3752,7 +3850,7 @@ var require_build2 = __commonJS({
 });
 
 // src/orchestrator/orchestrator-transport.ts
-var import_agent_runs2 = __toESM(require_agent_runs_api(), 1);
+var import_agent_runs3 = __toESM(require_agent_runs_api(), 1);
 var import_shared5 = __toESM(require_build2(), 1);
 
 // src/tools/attachments.ts
@@ -3796,10 +3894,11 @@ var import_shared = __toESM(require_build2(), 1);
 import axios, { isAxiosError } from "axios";
 import FormData from "form-data";
 var RestClientError = class extends Error {
-  constructor(code, message, status) {
+  constructor(code, message, status, details) {
     super(message);
     this.code = code;
     this.status = status;
+    this.details = details;
     this.name = "RestClientError";
   }
 };
@@ -3859,7 +3958,7 @@ var RestClient = class {
       if (isAxiosError(error)) {
         const body = error.response?.data;
         if (this.isApiErrorBody(body)) {
-          throw new RestClientError(body.code, body.message, error.response?.status);
+          throw new RestClientError(body.code, body.message, error.response?.status, body.details);
         }
         throw new RestClientError("HTTP_ERROR", this.sanitizeHttpErrorMessage(error.message), error.response?.status);
       }
@@ -3875,7 +3974,7 @@ var RestClient = class {
       if (isAxiosError(error)) {
         const body = error.response?.data;
         if (this.isApiErrorBody(body)) {
-          throw new RestClientError(body.code, body.message, error.response?.status);
+          throw new RestClientError(body.code, body.message, error.response?.status, body.details);
         }
         throw new RestClientError("HTTP_ERROR", this.sanitizeHttpErrorMessage(error.message), error.response?.status);
       }
@@ -4022,21 +4121,75 @@ function shouldSanitizeResponses() {
   return serverConfig.sanitizeResponses !== false;
 }
 
-// src/tools/tool-utils.ts
-function jsonResult(data) {
+// src/tools/agent-version-stale.util.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function isAgentVersionStaleErrorBody(value) {
+  if (!isRecord(value)) {
+    return false;
+  }
+  return typeof value.expectedVersion === "number" && typeof value.serverVersion === "number" && typeof value.serverUpdatedAt === "string";
+}
+function extractFieldConflictsFromAgentVersionStale(details) {
+  if (details === void 0 || !isAgentVersionStaleErrorBody(details)) {
+    return [];
+  }
+  const conflictingFields = details.diffSummary?.conflictingFields;
+  if (!Array.isArray(conflictingFields)) {
+    return [];
+  }
+  return conflictingFields.filter((field) => typeof field === "string");
+}
+
+// src/tools/structured-tool-result.util.ts
+function buildSuccessStructuredResult(payload, textPayload) {
   return {
-    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+    content: [{ type: "text", text: JSON.stringify(textPayload, null, 2) }],
+    structuredContent: payload
   };
 }
-function toolError(code, message) {
-  const sanitizedMessage = shouldSanitizeResponses() ? (0, import_shared2.sanitizeMcpErrorMessage)(message) : message;
+function buildErrorStructuredResult(payload, textPayload) {
   return {
     isError: true,
-    content: [{ type: "text", text: JSON.stringify({ code, message: sanitizedMessage }) }]
+    content: [{ type: "text", text: JSON.stringify(textPayload) }],
+    structuredContent: payload
+  };
+}
+function successStructuredPayload(data) {
+  return { kind: "success", data };
+}
+function errorStructuredPayload(code, message, extras) {
+  return {
+    kind: "error",
+    code,
+    message,
+    ...extras?.fieldConflicts !== void 0 ? { fieldConflicts: extras.fieldConflicts } : {}
   };
 }
+
+// src/tools/tool-utils.ts
+function jsonResult(data) {
+  return buildSuccessStructuredResult(successStructuredPayload(data), data);
+}
+function toolError(code, message, extras) {
+  const sanitizedMessage = shouldSanitizeResponses() ? (0, import_shared2.sanitizeMcpErrorMessage)(message) : message;
+  const textPayload = { code, message: sanitizedMessage };
+  if (extras?.fieldConflicts !== void 0) {
+    textPayload.fieldConflicts = extras.fieldConflicts;
+  }
+  return buildErrorStructuredResult(errorStructuredPayload(code, sanitizedMessage, extras), textPayload);
+}
 function toToolError(error) {
-  if (error instanceof RestClientError || error instanceof WorkspaceError) {
+  if (error instanceof RestClientError) {
+    if (error.code === "AGENT_VERSION_STALE") {
+      return toolError(error.code, error.message, {
+        fieldConflicts: extractFieldConflictsFromAgentVersionStale(error.details)
+      });
+    }
+    return toolError(error.code, error.message);
+  }
+  if (error instanceof WorkspaceError) {
     return toolError(error.code, error.message);
   }
   const message = error instanceof Error ? error.message : "Unknown error";
@@ -4281,145 +4434,11 @@ async function syncProjectSubagents(client, params) {
 }
 
 // src/tools/wait-for-agent-runs.ts
-var import_agent_runs = __toESM(require_agent_runs_api(), 1);
+var import_agent_runs2 = __toESM(require_agent_runs_api(), 1);
 var import_agent_run_status = __toESM(require_agent_run_status_enum(), 1);
-var DEFAULT_RETRY_BASE_MS = 500;
-var DEFAULT_RETRY_MAX_MS = 3e4;
-var DEFAULT_INFLIGHT_LIMIT = 10;
-function sleep(ms) {
-  return new Promise((resolve4) => {
-    setTimeout(resolve4, ms);
-  });
-}
-function isTransientClaimError(error) {
-  if (!(error instanceof RestClientError)) {
-    return false;
-  }
-  if (error.status === void 0) {
-    return error.code === "HTTP_ERROR";
-  }
-  return error.status >= 500;
-}
-function computeBackoffMs(consecutiveFailures, baseMs, maxMs) {
-  const exponential = baseMs * 2 ** (consecutiveFailures - 1);
-  return Math.min(exponential, maxMs);
-}
-function compareInflightRuns(a, b) {
-  if (a.requiresAttention !== b.requiresAttention) {
-    return a.requiresAttention ? -1 : 1;
-  }
-  const aDispatched = a.dispatchedAt ?? "";
-  const bDispatched = b.dispatchedAt ?? "";
-  return aDispatched.localeCompare(bDispatched);
-}
-async function fetchInflightAgentRuns(client, options) {
-  const limit = options.limit ?? DEFAULT_INFLIGHT_LIMIT;
-  const page = await client.get(import_agent_runs.AGENT_RUNS_ROUTES.listAgentRuns(), {
-    projectId: options.projectId,
-    activeOnly: "true",
-    limit: String(limit)
-  });
-  const filtered = page.items.filter(
-    (run) => run.status === import_agent_run_status.AGENT_RUN_STATUS.DISPATCHED || run.status === import_agent_run_status.AGENT_RUN_STATUS.ACKNOWLEDGED
-  );
-  filtered.sort(compareInflightRuns);
-  return filtered.slice(0, limit);
-}
-async function pollAgentRuns(client, options, deps) {
-  const { projectId, timeoutMs, pollIntervalMs, limit } = options;
-  if (pollIntervalMs > timeoutMs) {
-    throw new WorkspaceError("VALIDATION_ERROR", "pollInterval must not exceed timeout");
-  }
-  const sleepFn = deps?.sleep ?? sleep;
-  const deadline = Date.now() + timeoutMs;
-  const claimLimit = limit ?? 1;
-  const retryBaseMs = options.retryBaseMs ?? DEFAULT_RETRY_BASE_MS;
-  const retryMaxMs = options.retryMaxMs ?? DEFAULT_RETRY_MAX_MS;
-  let consecutiveFailures = 0;
-  while (true) {
-    let response;
-    try {
-      response = await client.post(import_agent_runs.AGENT_RUNS_ROUTES.claimAgentRuns(), {
-        projectId,
-        limit: claimLimit
-      });
-      consecutiveFailures = 0;
-    } catch (error) {
-      if (!isTransientClaimError(error)) {
-        throw error;
-      }
-      if (Date.now() >= deadline) {
-        return { items: [], inflightRuns: [], timedOut: true };
-      }
-      consecutiveFailures += 1;
-      const backoffMs = computeBackoffMs(consecutiveFailures, retryBaseMs, retryMaxMs);
-      const remainingMs2 = deadline - Date.now();
-      await sleepFn(Math.min(backoffMs, remainingMs2));
-      continue;
-    }
-    if (response.items.length > 0) {
-      return { items: response.items, inflightRuns: [], timedOut: false };
-    }
-    const inflightRuns = await fetchInflightAgentRuns(client, { projectId, limit: claimLimit });
-    if (inflightRuns.length > 0) {
-      return { items: [], inflightRuns, timedOut: false };
-    }
-    if (Date.now() >= deadline) {
-      return { items: [], inflightRuns: [], timedOut: true };
-    }
-    const remainingMs = deadline - Date.now();
-    const waitMs = Math.min(pollIntervalMs, remainingMs);
-    await sleepFn(waitMs);
-  }
-}
 
-// src/orchestrator/orchestrator-transport.ts
-var OrchestratorTransport = class {
-  constructor(client, options = {}) {
-    this.client = client;
-    this.options = options;
-  }
-  async claimAndPoll(options, deps) {
-    return pollAgentRuns(this.client, options, deps);
-  }
-  async fetchInflightRuns(projectId, limit) {
-    return fetchInflightAgentRuns(this.client, { projectId, limit });
-  }
-  async ackRun(agentRunId, note) {
-    const body = note !== void 0 ? { note } : void 0;
-    return this.client.patch(import_agent_runs2.AGENT_RUNS_ROUTES.acknowledgeAgentRun(agentRunId), body);
-  }
-  async setAttention(agentRunId, requiresAttention, message) {
-    const body = requiresAttention ? { requiresAttention: true, attentionMessage: message ?? "" } : { requiresAttention: false };
-    return this.client.patch(import_agent_runs2.AGENT_RUNS_ROUTES.setAgentRunAttention(agentRunId), body);
-  }
-  async completeRun(agentRunId, body) {
-    return this.client.post(import_agent_runs2.AGENT_RUNS_ROUTES.completeAgentRun(agentRunId), body);
-  }
-  async listAttachments(workItemId) {
-    return fetchAttachments(this.client, workItemId);
-  }
-  async downloadAttachments(workItemId, workspaceRoot, attachmentIds) {
-    return downloadWorkItemAttachments(this.client, {
-      workItemId,
-      workspaceRoot,
-      attachmentIds,
-      blockSensitiveAttachments: this.options.blockSensitiveAttachments ?? true
-    });
-  }
-  async syncSubagents(projectId, workspaceRoot) {
-    return syncProjectSubagents(this.client, { projectId, workspaceRoot });
-  }
-  async createComment(workItemId, body) {
-    return postComment(this.client, workItemId, body);
-  }
-};
-function createOrchestratorTransport(client, config) {
-  return new OrchestratorTransport(client, {
-    workspaceRoot: config?.workspaceRoot,
-    blockSensitiveAttachments: config?.blockSensitiveAttachments
-  });
-}
+// src/agent-process/stop-signal.handler.ts
+var import_agent_runs = __toESM(require_agent_runs_api(), 1);
 
 // src/orchestrator/active-run-state.ts
 import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
@@ -4428,7 +4447,7 @@ var ACTIVE_RUN_STATE_RELATIVE_PATH = ".cursor/orchestrator-active-run.json";
 var ATTENTION_PENDING_RELATIVE_PATH = ".cursor/orchestrator-attention-pending.json";
 var ACTIVE_RUN_LEASE_MINUTES = 30;
 var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isUuid(value) {
@@ -4454,7 +4473,7 @@ function ensureCursorDir(workspaceRoot) {
   }
 }
 function parseActiveRunState(raw) {
-  if (!isRecord(raw)) {
+  if (!isRecord2(raw)) {
     return null;
   }
   const version = raw.version;
@@ -4476,7 +4495,7 @@ function parseActiveRunState(raw) {
   };
 }
 function parseAttentionPendingState(raw) {
-  if (!isRecord(raw)) {
+  if (!isRecord2(raw)) {
     return null;
   }
   const agentRunId = raw.agentRunId;
@@ -4563,6 +4582,248 @@ function clearOrchestratorBridgeState(workspaceRoot) {
   clearAttentionPendingState(workspaceRoot);
 }
 
+// src/agent-process/local-process-registry.ts
+var registrations = /* @__PURE__ */ new Map();
+function registerLocalProcess(agentRunId, workItemId, pid) {
+  const entry = {
+    agentRunId,
+    workItemId,
+    pid,
+    registeredAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  registrations.set(agentRunId, entry);
+  return entry;
+}
+function getLocalProcess(agentRunId) {
+  return registrations.get(agentRunId);
+}
+function unregisterLocalProcess(agentRunId) {
+  registrations.delete(agentRunId);
+}
+
+// src/agent-process/stop-signal.handler.ts
+var STOP_SIGTERM_GRACE_MS = 5e3;
+function defaultSleep(ms) {
+  return new Promise((resolve4) => {
+    setTimeout(resolve4, ms);
+  });
+}
+function resolveWorkspaceRootForConfig(config) {
+  try {
+    return resolveWorkspaceRoot(void 0, config.workspaceRoot);
+  } catch {
+    return null;
+  }
+}
+async function signalProcessGracefully(pid, deps) {
+  const kill = deps.kill ?? process.kill.bind(process);
+  const sleep2 = deps.sleep ?? defaultSleep;
+  try {
+    kill(pid, "SIGINT");
+  } catch (error) {
+    const code = error.code;
+    if (code === "ESRCH") {
+      return false;
+    }
+    deps.logWarn?.(`stop signal SIGINT failed for pid=${pid}: ${code ?? "unknown"}`);
+    return false;
+  }
+  await sleep2(STOP_SIGTERM_GRACE_MS);
+  try {
+    kill(pid, "SIGTERM");
+  } catch (error) {
+    const code = error.code;
+    if (code === "ESRCH") {
+      return true;
+    }
+    deps.logWarn?.(`stop signal SIGTERM failed for pid=${pid}: ${code ?? "unknown"}`);
+  }
+  return true;
+}
+async function applyStopSignal(client, config, agentRunId, deps = {}) {
+  let registration;
+  try {
+    registration = await client.get(
+      import_agent_runs.AGENT_RUNS_ROUTES.getAgentRunProcessRegistration(agentRunId)
+    );
+  } catch {
+    return false;
+  }
+  if (!registration.stopRequested) {
+    return false;
+  }
+  const local = getLocalProcess(agentRunId);
+  const pid = local?.pid ?? registration.pid;
+  const signaled = await signalProcessGracefully(pid, deps);
+  const workspaceRoot = resolveWorkspaceRootForConfig(config);
+  if (workspaceRoot !== null) {
+    const activeState = readActiveRunState(workspaceRoot);
+    if (activeState?.agentRunId === agentRunId) {
+      clearOrchestratorBridgeState(workspaceRoot);
+    }
+  }
+  try {
+    await client.delete(import_agent_runs.AGENT_RUNS_ROUTES.unregisterAgentRunProcess(agentRunId));
+  } catch {
+    deps.logWarn?.(`failed to unregister process registration for agentRunId=${agentRunId}`);
+  }
+  unregisterLocalProcess(agentRunId);
+  return signaled;
+}
+async function pollActiveRunStopSignal(client, config, deps = {}) {
+  const workspaceRoot = resolveWorkspaceRootForConfig(config);
+  if (workspaceRoot === null) {
+    return false;
+  }
+  const activeState = readActiveRunState(workspaceRoot);
+  if (activeState === null) {
+    return false;
+  }
+  return applyStopSignal(client, config, activeState.agentRunId, deps);
+}
+
+// src/tools/wait-for-agent-runs.ts
+var DEFAULT_RETRY_BASE_MS = 500;
+var DEFAULT_RETRY_MAX_MS = 3e4;
+var DEFAULT_INFLIGHT_LIMIT = 10;
+function sleep(ms) {
+  return new Promise((resolve4) => {
+    setTimeout(resolve4, ms);
+  });
+}
+function isTransientClaimError(error) {
+  if (!(error instanceof RestClientError)) {
+    return false;
+  }
+  if (error.status === void 0) {
+    return error.code === "HTTP_ERROR";
+  }
+  return error.status >= 500;
+}
+function computeBackoffMs(consecutiveFailures, baseMs, maxMs) {
+  const exponential = baseMs * 2 ** (consecutiveFailures - 1);
+  return Math.min(exponential, maxMs);
+}
+function compareInflightRuns(a, b) {
+  if (a.requiresAttention !== b.requiresAttention) {
+    return a.requiresAttention ? -1 : 1;
+  }
+  const aDispatched = a.dispatchedAt ?? "";
+  const bDispatched = b.dispatchedAt ?? "";
+  return aDispatched.localeCompare(bDispatched);
+}
+async function fetchInflightAgentRuns(client, options) {
+  const limit = options.limit ?? DEFAULT_INFLIGHT_LIMIT;
+  const page = await client.get(import_agent_runs2.AGENT_RUNS_ROUTES.listAgentRuns(), {
+    projectId: options.projectId,
+    activeOnly: "true",
+    limit: String(limit)
+  });
+  const filtered = page.items.filter(
+    (run) => run.status === import_agent_run_status.AGENT_RUN_STATUS.DISPATCHED || run.status === import_agent_run_status.AGENT_RUN_STATUS.ACKNOWLEDGED
+  );
+  filtered.sort(compareInflightRuns);
+  return filtered.slice(0, limit);
+}
+async function pollAgentRuns(client, options, deps) {
+  const { projectId, timeoutMs, pollIntervalMs, limit } = options;
+  if (pollIntervalMs > timeoutMs) {
+    throw new WorkspaceError("VALIDATION_ERROR", "pollInterval must not exceed timeout");
+  }
+  const sleepFn = deps?.sleep ?? sleep;
+  const deadline = Date.now() + timeoutMs;
+  const claimLimit = limit ?? 1;
+  const retryBaseMs = options.retryBaseMs ?? DEFAULT_RETRY_BASE_MS;
+  const retryMaxMs = options.retryMaxMs ?? DEFAULT_RETRY_MAX_MS;
+  let consecutiveFailures = 0;
+  while (true) {
+    if (options.stopSignal !== void 0) {
+      await pollActiveRunStopSignal(client, options.stopSignal.config);
+    }
+    let response;
+    try {
+      response = await client.post(import_agent_runs2.AGENT_RUNS_ROUTES.claimAgentRuns(), {
+        projectId,
+        limit: claimLimit
+      });
+      consecutiveFailures = 0;
+    } catch (error) {
+      if (!isTransientClaimError(error)) {
+        throw error;
+      }
+      if (Date.now() >= deadline) {
+        return { items: [], inflightRuns: [], timedOut: true };
+      }
+      consecutiveFailures += 1;
+      const backoffMs = computeBackoffMs(consecutiveFailures, retryBaseMs, retryMaxMs);
+      const remainingMs2 = deadline - Date.now();
+      await sleepFn(Math.min(backoffMs, remainingMs2));
+      continue;
+    }
+    if (response.items.length > 0) {
+      return { items: response.items, inflightRuns: [], timedOut: false };
+    }
+    const inflightRuns = await fetchInflightAgentRuns(client, { projectId, limit: claimLimit });
+    if (inflightRuns.length > 0) {
+      return { items: [], inflightRuns, timedOut: false };
+    }
+    if (Date.now() >= deadline) {
+      return { items: [], inflightRuns: [], timedOut: true };
+    }
+    const remainingMs = deadline - Date.now();
+    const waitMs = Math.min(pollIntervalMs, remainingMs);
+    await sleepFn(waitMs);
+  }
+}
+
+// src/orchestrator/orchestrator-transport.ts
+var OrchestratorTransport = class {
+  constructor(client, options = {}) {
+    this.client = client;
+    this.options = options;
+  }
+  async claimAndPoll(options, deps) {
+    return pollAgentRuns(this.client, options, deps);
+  }
+  async fetchInflightRuns(projectId, limit) {
+    return fetchInflightAgentRuns(this.client, { projectId, limit });
+  }
+  async ackRun(agentRunId, note) {
+    const body = note !== void 0 ? { note } : void 0;
+    return this.client.patch(import_agent_runs3.AGENT_RUNS_ROUTES.acknowledgeAgentRun(agentRunId), body);
+  }
+  async setAttention(agentRunId, requiresAttention, message) {
+    const body = requiresAttention ? { requiresAttention: true, attentionMessage: message ?? "" } : { requiresAttention: false };
+    return this.client.patch(import_agent_runs3.AGENT_RUNS_ROUTES.setAgentRunAttention(agentRunId), body);
+  }
+  async completeRun(agentRunId, body) {
+    return this.client.post(import_agent_runs3.AGENT_RUNS_ROUTES.completeAgentRun(agentRunId), body);
+  }
+  async listAttachments(workItemId) {
+    return fetchAttachments(this.client, workItemId);
+  }
+  async downloadAttachments(workItemId, workspaceRoot, attachmentIds) {
+    return downloadWorkItemAttachments(this.client, {
+      workItemId,
+      workspaceRoot,
+      attachmentIds,
+      blockSensitiveAttachments: this.options.blockSensitiveAttachments ?? true
+    });
+  }
+  async syncSubagents(projectId, workspaceRoot) {
+    return syncProjectSubagents(this.client, { projectId, workspaceRoot });
+  }
+  async createComment(workItemId, body) {
+    return postComment(this.client, workItemId, body);
+  }
+};
+function createOrchestratorTransport(client, config) {
+  return new OrchestratorTransport(client, {
+    workspaceRoot: config?.workspaceRoot,
+    blockSensitiveAttachments: config?.blockSensitiveAttachments
+  });
+}
+
 // src/workspace/parse-task-boards-yaml.ts
 import { existsSync as existsSync5, readFileSync as readFileSync3 } from "node:fs";
 import { join as join4 } from "node:path";
@@ -4741,7 +5002,7 @@ function buildSmartModeAttentionMessage(toolName, reason) {
 }
 
 // src/attention/hook-payload.util.ts
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readString(record, key) {
@@ -4758,7 +5019,7 @@ function parseHookPayloadJson(raw) {
   }
   try {
     const parsed = JSON.parse(trimmed);
-    if (!isRecord2(parsed)) {
+    if (!isRecord3(parsed)) {
       return null;
     }
     return parsed;
@@ -5514,7 +5775,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/tools/agent-runs.ts
-var import_agent_runs3 = __toESM(require_agent_runs_api(), 1);
+var import_agent_runs4 = __toESM(require_agent_runs_api(), 1);
 var import_agent_run_outcome = __toESM(require_agent_run_outcome_enum(), 1);
 var import_agent_run_status4 = __toESM(require_agent_run_status_enum(), 1);
 import { z as z3 } from "zod";
@@ -5770,7 +6031,7 @@ function registerAgentRunTools(server, client, config) {
     },
     async ({ status, projectId }) => runTool(async () => {
       const effectiveStatus = status ?? import_agent_run_status4.AGENT_RUN_STATUS.PENDING;
-      return client.get(import_agent_runs3.AGENT_RUNS_ROUTES.listAgentRuns(), {
+      return client.get(import_agent_runs4.AGENT_RUNS_ROUTES.listAgentRuns(), {
         status: effectiveStatus,
         projectId
       });
@@ -5792,7 +6053,8 @@ function registerAgentRunTools(server, client, config) {
         projectId,
         timeoutMs: timeout * 1e3,
         pollIntervalMs: pollInterval * 1e3,
-        limit
+        limit,
+        stopSignal: { config }
       });
       return enrichPollResult(pollResult.items, pollResult.inflightRuns, pollResult.timedOut);
     })
@@ -5808,8 +6070,13 @@ function registerAgentRunTools(server, client, config) {
     },
     async ({ agentRunId, note }) => runTool(async () => {
       const body = note !== void 0 ? { note } : void 0;
-      const response = await client.patch(import_agent_runs3.AGENT_RUNS_ROUTES.acknowledgeAgentRun(agentRunId), body);
+      const response = await client.patch(import_agent_runs4.AGENT_RUNS_ROUTES.acknowledgeAgentRun(agentRunId), body);
       writeActiveRunFromAck(config, response);
+      try {
+        await client.post(import_agent_runs4.AGENT_RUNS_ROUTES.registerAgentRunProcess(agentRunId), { pid: process.pid });
+        registerLocalProcess(agentRunId, response.workItemId, process.pid);
+      } catch {
+      }
       return response;
     })
   );
@@ -5827,7 +6094,7 @@ function registerAgentRunTools(server, client, config) {
         requiresAttention: true,
         attentionMessage: message
       };
-      return client.patch(import_agent_runs3.AGENT_RUNS_ROUTES.setAgentRunAttention(agentRunId), body);
+      return client.patch(import_agent_runs4.AGENT_RUNS_ROUTES.setAgentRunAttention(agentRunId), body);
     })
   );
   server.registerTool(
@@ -5842,7 +6109,7 @@ function registerAgentRunTools(server, client, config) {
       const body = {
         requiresAttention: false
       };
-      return client.patch(import_agent_runs3.AGENT_RUNS_ROUTES.setAgentRunAttention(agentRunId), body);
+      return client.patch(import_agent_runs4.AGENT_RUNS_ROUTES.setAgentRunAttention(agentRunId), body);
     })
   );
   server.registerTool(
@@ -5875,10 +6142,15 @@ function registerAgentRunTools(server, client, config) {
       }
       const hasBody = outcome !== void 0 || note !== void 0 || workItemPatch !== void 0 && workItemPatch !== null;
       const response = await client.post(
-        import_agent_runs3.AGENT_RUNS_ROUTES.completeAgentRun(agentRunId),
+        import_agent_runs4.AGENT_RUNS_ROUTES.completeAgentRun(agentRunId),
         hasBody ? body : void 0
       );
       clearActiveRunAfterComplete(config);
+      try {
+        await client.delete(import_agent_runs4.AGENT_RUNS_ROUTES.unregisterAgentRunProcess(agentRunId));
+      } catch {
+      }
+      unregisterLocalProcess(agentRunId);
       return response;
     })
   );
@@ -6088,8 +6360,12 @@ async function runOrchestratorOnce(client, options) {
     projectId,
     timeoutMs: options.timeoutMs,
     pollIntervalMs: options.pollIntervalMs,
-    limit: options.limit
+    limit: options.limit,
+    stopSignal: options.config !== void 0 ? { config: options.config } : void 0
   });
+  if (options.config !== void 0) {
+    await pollActiveRunStopSignal(client, options.config);
+  }
   const enriched = enrichPollResult(pollResult.items, pollResult.inflightRuns, pollResult.timedOut);
   return {
     projectId,
@@ -6120,7 +6396,8 @@ function registerOrchestratorTools(server, client, config) {
         pollIntervalMs: pollInterval * 1e3,
         limit,
         workspaceRootOverride: workspaceRoot,
-        envWorkspaceRoot: config.workspaceRoot
+        envWorkspaceRoot: config.workspaceRoot,
+        config
       })
     )
   );
@@ -6579,6 +6856,14 @@ async function deleteWorkItem(client, workItemId) {
   const body = { confirmCascade: false };
   await client.delete(import_work_items.WORK_ITEMS_ROUTES.deleteWorkItem(workItemId), body);
 }
+async function patchWorkItemWithCurrentVersion(client, workItemId, fields) {
+  const current = await client.get(import_work_items.WORK_ITEMS_ROUTES.getWorkItem(workItemId));
+  const body = {
+    ...fields,
+    version: current.version
+  };
+  return client.patch(import_work_items.WORK_ITEMS_ROUTES.updateWorkItem(workItemId), body);
+}
 function registerWorkItemTools(server, client) {
   server.registerTool(
     "list_work_items",
@@ -6681,7 +6966,7 @@ function registerWorkItemTools(server, client) {
   server.registerTool(
     "update_work_item",
     {
-      description: "Update work item fields (fetches current version first).",
+      description: "Update work item fields (fetches current version first). On stale version returns AGENT_VERSION_STALE with fieldConflicts \u2014 no automatic retry; re-fetch get_work_item and reconcile manually.",
       inputSchema: {
         workItemId: z11.string().uuid().describe("Work item UUID"),
         title: z11.string().min(1).max(512).optional().describe("Updated title"),
@@ -6714,9 +6999,8 @@ function registerWorkItemTools(server, client) {
       codeChangesRequired,
       completed,
       labelIds
-    }) => runTool(async () => {
-      const current = await client.get(import_work_items.WORK_ITEMS_ROUTES.getWorkItem(workItemId));
-      const body = {
+    }) => runTool(
+      async () => patchWorkItemWithCurrentVersion(client, workItemId, {
         title,
         description,
         acceptanceCriteria,
@@ -6728,11 +7012,9 @@ function registerWorkItemTools(server, client) {
         assigneeUserId,
         codeChangesRequired,
         completed,
-        labelIds,
-        version: current.version
-      };
-      return client.patch(import_work_items.WORK_ITEMS_ROUTES.updateWorkItem(workItemId), body);
-    })
+        labelIds
+      })
+    )
   );
   server.registerTool(
     "move_work_item",