Q150: work can be sent back, reopened, moved to backlog, or blocked with a reason

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

src/shared/commands/organization.ts

@@ -123,6 +123,13 @@ export interface UpdateTaskInput {
   writingMode: WritingMode;
 }
 
+export interface SetTaskBlockedInput {
+  orgId: string;
+  taskId: string;
+  /** Why the task is blocked; null unblocks it. */
+  reason: string | null;
+}
+
 export interface DeleteTaskInput {
   orgId: string;
   taskId: string;

src/shared/desktop-api.ts

@@ -34,6 +34,7 @@ import type {
   DeleteAutomationRuleInput,
   DeleteDocumentInput,
   DeleteTaskInput,
+  SetTaskBlockedInput,
   DeleteKnowledgeEntryInput,
   ResumeGoalInput,
   UpdateAutomationRuleInput,
@@ -199,6 +200,8 @@ export interface DesktopApi {
   /** One thread in full, beyond the snapshot's recent window. */
   chatThreadHistory(input: { orgId: string; threadId: string }): Promise<DesktopResult<ThreadHistory>>;
   /** The page of a conversation before a loaded message, for history older than the snapshot holds. */
+  /** Blocks a task with a reason, or unblocks it with null. */
+  setTaskBlocked(input: SetTaskBlockedInput): Promise<DesktopResult<AppSnapshot>>;
   chatSpaceHistory(input: { orgId: string; spaceId: string; beforeMessageId: string | null } & ({ limit: number } | { fromMessageId: string })): Promise<DesktopResult<SpaceHistoryPage>>;
   revokeConnector(input: RevokeConnectorInput): Promise<DesktopResult<AppSnapshot>>;
   search(input: SearchInput): Promise<DesktopResult<SearchResultRecord[]>>;

src/shared/domain.ts

@@ -108,6 +108,8 @@ export interface TaskRecord {
   stalledReason: string | null;
   /** Why the heartbeat last failed to queue the task; cleared once it queues. */
   enqueueError: string | null;
+  /** Why the operator blocked the task; no session starts while it is set. */
+  blockedReason: string | null;
   /** Why the open task is not moving now, or null when nothing holds it. */
   hold: TaskHold | null;
   /** Runs at or below this task_runs rowid no longer count toward the run budget. */

src/shared/ipc.ts

@@ -83,6 +83,7 @@ export const IPC_CHANNELS = {
   runRequests: "agentcompany:run-requests",
   chatThreadHistory: "agentcompany:chat-thread-history",
   chatSpaceHistory: "agentcompany:chat-space-history",
+  setTaskBlocked: "agentcompany:set-task-blocked",
   revokeConnector: "agentcompany:revoke-connector",
   search: "agentcompany:search",
   rendererEvent: "agentcompany:renderer-event",