@qodeca/xezar 0.13.1 → 0.14.0

package/dist/mcp/tools/execution-control.js

@@ -0,0 +1,513 @@
+import { attachmentInputSchema, mcpExpectedVersionSchema, operationIdSchema, runIdParamSchema, staleVersionRejectionSchema, } from '../../contract/index.js';
+import { hc } from 'hono/client';
+import { z } from 'zod';
+import { MCP_ORIGIN, McpServiceAdapter } from '../service-adapter.js';
+import { staleRejectionIn } from '../stale-write.js';
+import { defineTool, errorResult, textResult } from '../tool.js';
+/**
+ * Execution control and session messaging for the bound project's own tasks (#94, F-08, F-09,
+ * M-03, M-04; inventory I-032, I-034–I-040).
+ *
+ * WHAT IT CAN TARGET. A task of the project this connection is bound to, named by its run id —
+ * and nothing else. Every action first reads the task through the shared service adapter (#89),
+ * whose scope is the connection's project, so another project's task is a 404 before anything
+ * is dispatched. There is no argument for a process id, a signal, a command or a path, and this
+ * module starts or signals no process itself: every effect is one of the cockpit's own routes,
+ * and the RunManager behind that route is the only thing that ever touches an agent process.
+ * F-08 is explicit that a generic "kill PID" does not meet the boundary; none exists here.
+ *
+ * THE SAME STATE MACHINE AS THE COCKPIT. Each action is offered in exactly the states the
+ * cockpit offers it (`run-actions.ts` `runActionFlags`, `task-thread.tsx`'s composer routing,
+ * `ask-answer.ts` `askDeliveryMode`), and refused — with nothing changed — in every other one.
+ * The refusal is checked here AND again by the route, so a state that moved between the read and
+ * the write is still refused by the service.
+ *
+ * NO NEW STATES. Every action lands the task in a state the cockpit already reaches, through the
+ * cockpit's own route, so every exit a state already has — a user message, the autonomous
+ * nudge, the monitoring wake timer, cancel, finish, the idle close — still applies to it.
+ * Nothing here parks a task, holds a session open or schedules anything.
+ *
+ * WHERE THE SERVICE COMES FROM. `McpToolContext` does not carry the service's in-process entry
+ * yet (#86 shipped it without one, #89 left widening it to later work). This tool reads it from
+ * an optional `service` field on the context and answers an honest tool error when it is absent;
+ * the service passing its app there is the one wiring step this tool cannot take from its own
+ * file.
+ *
+ * STALE WRITES (#250, N-03). Every action changes the task, so every action requires the
+ * `expectedVersion` a `task_read` of it handed out, and sends it to the route, which compares it
+ * with the task's current version in the same synchronous stretch as the engine call. A task that
+ * moved since is refused with nothing applied (`status: "conflict"`, `error: "stale_version"`,
+ * `currentVersion`). The version moves with every event a task records, so a RUNNING task's
+ * version moves while its agent works: read it right before acting on a running task. The same holds
+ * for an answer that meets an idle close: the close changes the task, so the resume after it is
+ * refused as stale rather than retried with a fresh version — the leader reads again and answers
+ * again (D-06 § 4.4 rule 3).
+ */
+export const EXECUTION_CONTROL_ACTIONS = [
+    'cancel',
+    'finish',
+    'continue',
+    'send_message',
+    'answer_question',
+    'edit_queued_message',
+    'remove_queued_message',
+    'cancel_auto_resume',
+];
+/** The cockpit's own schedule (`ask-answer.ts`): the idle timer closes the backend before the
+ *  RunManager has released the run, so a resume can arrive a few milliseconds early. Only that
+ *  exact refusal is retried; every other 409 is an answer. */
+export const IDLE_TEARDOWN_RETRY_DELAYS_MS = [50, 100, 200, 400, 800, 1_000, 1_000, 1_000, 1_000];
+const IDLE_TEARDOWN_REFUSAL = 'run is still active';
+/** The review panel's Send back prefix (`review-panel.tsx`). */
+const REVIEW_FEEDBACK_PREFIX = 'Review feedback:\n';
+const answerSchema = z
+    .object({
+    choices: z
+        .array(z.string().min(1).max(60))
+        .min(1)
+        .max(4)
+        .describe('Option labels for this question, exactly as the question lists them. One for a single-select question.'),
+})
+    .strict();
+const FIELDS = ['text', 'images', 'finishAs', 'questionId', 'answers', 'messageId'];
+/** Which arguments each action takes. Anything else is refused rather than silently dropped. */
+const ACTION_FIELDS = {
+    cancel: { required: [], optional: [] },
+    finish: { required: ['finishAs'], optional: [] },
+    continue: { required: [], optional: ['text', 'images'] },
+    send_message: { required: [], optional: ['text', 'images'] },
+    answer_question: { required: ['questionId'], optional: ['answers', 'text'] },
+    edit_queued_message: { required: ['messageId'], optional: ['text', 'images'] },
+    remove_queued_message: { required: ['messageId'], optional: [] },
+    cancel_auto_resume: { required: [], optional: [] },
+};
+const hasText = (text) => text !== undefined && text.trim().length > 0;
+export const executionControlInputSchema = z
+    .object({
+    action: z.enum(EXECUTION_CONTROL_ACTIONS).describe('What to do with the task.'),
+    runId: z.string().min(1).max(128).describe("The task's run id, in the project this connection is bound to."),
+    expectedVersion: mcpExpectedVersionSchema.describe('The `version` task_read returned for this task. Echo it verbatim; if the task changed since, nothing is applied.'),
+    // D-06 § 5.2 (#264). Required on every call, because every action of this tool changes the task:
+    // there is no read here to exempt.
+    operationId: operationIdSchema.describe('Client-generated key for this operation (8–128 chars). Reuse it only to repeat the same operation: a repeat returns the first answer and controls the task once.'),
+    text: z
+        .string()
+        .max(100_000)
+        .optional()
+        .describe('Message, continuation prompt, review feedback, free-form answer, or the new text of a queued message.'),
+    images: z
+        .array(attachmentInputSchema)
+        .max(4)
+        .optional()
+        .describe('Attachments (base64) for send_message, continue or edit_queued_message — the same four the composer allows.'),
+    finishAs: z
+        .enum(['close_session', 'accept_review'])
+        .optional()
+        .describe('Which finish you mean: close_session for a waiting task, accept_review to accept a task at review without a PR. Refused when it does not match the task.'),
+    questionId: z.string().min(1).max(128).optional().describe("The pending question's id (its ask requestId)."),
+    answers: z
+        .array(answerSchema)
+        .min(1)
+        .max(4)
+        .optional()
+        .describe('One entry per question, in the order the question card lists them.'),
+    messageId: z.string().min(1).max(128).optional().describe("A queued message's id."),
+})
+    .strict()
+    .superRefine((args, ctx) => {
+    const allowed = ACTION_FIELDS[args.action];
+    for (const field of FIELDS) {
+        const present = args[field] !== undefined;
+        if (allowed.required.includes(field) && !present) {
+            ctx.addIssue({ code: 'custom', path: [field], message: `${args.action} needs ${field}` });
+        }
+        if (present && !allowed.required.includes(field) && !allowed.optional.includes(field)) {
+            ctx.addIssue({ code: 'custom', path: [field], message: `${field} does not apply to ${args.action}` });
+        }
+    }
+    const bodyActions = ['send_message', 'edit_queued_message'];
+    if (bodyActions.includes(args.action) && !hasText(args.text) && !args.images?.length) {
+        ctx.addIssue({ code: 'custom', path: ['text'], message: `${args.action} needs text or at least one attachment` });
+    }
+    if (args.action === 'answer_question' && (args.answers !== undefined) === hasText(args.text)) {
+        ctx.addIssue({ code: 'custom', path: ['answers'], message: 'answer_question needs exactly one of answers or text' });
+    }
+});
+/** The result, text block and `structuredContent` alike (D-05 § 6.8: the text is authoritative,
+ *  and the result is a slim projection rather than the task record). */
+export const executionControlResultSchema = z.object({
+    action: z.enum(EXECUTION_CONTROL_ACTIONS),
+    accepted: z.boolean(),
+    /** D-05's closed set, narrowed to what a control can report. `accepted` never means done. */
+    status: z.enum(['accepted', 'done', 'cancelled', 'conflict', 'failed']),
+    subject: z.object({ type: z.literal('run'), id: z.string() }),
+    runStatus: z.string().optional(),
+    /** Which seam a message or answer travelled on — the state routing made visible. */
+    delivery: z.enum(['live', 'deferred', 'amended', 'continued', 'resumed']).optional(),
+    questionId: z.string().optional(),
+    messageId: z.string().optional(),
+    hadPendingAutoResume: z.boolean().optional(),
+    reason: z.string().optional(),
+    // A stale-version refusal (#250) carries D-06 § 4.4's payload keys verbatim beside the above.
+    ...staleVersionRejectionSchema.omit({ status: true }).partial().shape,
+    origin: z.literal(MCP_ORIGIN),
+});
+// ---- the routes the shared adapter does not name yet -------------------------------------------
+const IN_PROCESS_BASE = 'http://127.0.0.1';
+const IN_PROCESS_HOST = '127.0.0.1';
+/** The same in-process client the adapter builds (`service-adapter.ts`): loopback host, no Origin. */
+const scopedApi = (service) => hc(IN_PROCESS_BASE, {
+    fetch: async (input, init) => {
+        const headers = new Headers(init?.headers);
+        headers.set('host', IN_PROCESS_HOST);
+        headers.delete('origin');
+        const url = input instanceof Request ? input.url : String(input);
+        return service.request(url, { ...init, headers });
+    },
+}).api.v1.p[':projectId'];
+/** Map a service answer. A success without a JSON body is an error, never an empty value. */
+async function settle(pending, success) {
+    const res = await pending;
+    const body = await res.json().catch(() => undefined);
+    if (success.includes(res.status)) {
+        if (body === undefined)
+            return { ok: false, status: 502, error: `service answered ${res.status} without a body` };
+        return { ok: true, status: res.status, value: body };
+    }
+    const error = body && typeof body === 'object' && typeof body.error === 'string'
+        ? body.error
+        : `service answered ${res.status}`;
+    return { ok: false, status: res.status, error, body };
+}
+/** The adapter's rule for a path parameter: a valid id that is not a dot segment. */
+const validPathId = (id) => id !== '.' && id !== '..' && runIdParamSchema.safeParse({ id }).success;
+/** `run-actions.ts` `isRunActive`: the engine still owns the run. */
+const isActive = (run) => run.status === 'running' || run.status === 'queued' || run.status === 'waiting';
+/** `task-thread.tsx`: the composer delivers into a live session while running or waiting. */
+const sessionOpen = (run) => run.status === 'running' || run.status === 'waiting';
+/** `run-actions.ts` `lastSessionId` — Continue needs a recorded agent session. */
+const hasSession = (run) => run.steps.some((step) => step.sessionId);
+/** `ask-answer.ts` `askDeliveryMode`. */
+export function askDeliveryMode(run) {
+    if (isActive(run))
+        return 'live';
+    return hasSession(run) ? 'resume' : 'unavailable';
+}
+const askQuestionSchema = z
+    .object({
+    header: z.string(),
+    options: z.array(z.object({ label: z.string() }).passthrough()),
+    multiSelect: z.boolean().optional(),
+})
+    .passthrough();
+/**
+ * The one question an answer can reach: the newest `ask.requested` with no `user-message` after
+ * it — the cockpit's reducer (`thread-state.ts`), which resolves whichever ask is pending with
+ * the next user message. An older ask that a newer one superseded is NOT pending, however
+ * unanswered it looks: a message sent for it would be read as the answer to the newer one.
+ * `events` may be in any order; a malformed ask is skipped, exactly as the reducer skips it.
+ */
+export function pendingQuestionIn(events) {
+    const newestFirst = [...events].sort((a, b) => b.seq - a.seq);
+    for (const event of newestFirst) {
+        if (event.type === 'user-message')
+            return null;
+        if (event.type !== 'ask.requested' || typeof event.requestId !== 'string' || !Array.isArray(event.questions))
+            continue;
+        const questions = event.questions.flatMap((q) => {
+            const parsed = askQuestionSchema.safeParse(q);
+            return parsed.success ? [parsed.data] : [];
+        });
+        if (questions.length > 0)
+            return { requestId: event.requestId, questions };
+    }
+    // Neither found in these events: the caller must read older ones before concluding "none".
+    return undefined;
+}
+/** The ask card's answer text (`ask-card.tsx` `formatAnswer`), one line per question. */
+export function formatAnswers(questions, answers) {
+    if (answers.length !== questions.length) {
+        return { ok: false, error: `answer every question: this one has ${questions.length}, the call gave ${answers.length}` };
+    }
+    const lines = [];
+    for (const [index, question] of questions.entries()) {
+        const choices = answers[index].choices;
+        const labels = question.options.map((option) => option.label);
+        const unknown = choices.find((choice) => !labels.includes(choice));
+        if (unknown !== undefined) {
+            return { ok: false, error: `"${unknown}" is not an option of "${question.header}" (${labels.join(', ')})` };
+        }
+        if (new Set(choices).size !== choices.length)
+            return { ok: false, error: `"${question.header}" repeats a choice` };
+        if (question.multiSelect !== true && choices.length !== 1) {
+            return { ok: false, error: `"${question.header}" takes exactly one choice` };
+        }
+        lines.push(`${question.header}: ${choices.join(', ')}`);
+    }
+    return { ok: true, text: lines.join('\n') };
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function result(args, fields) {
+    const value = {
+        action: args.action,
+        subject: { type: 'run', id: args.runId },
+        ...fields,
+        origin: MCP_ORIGIN,
+    };
+    const structured = value;
+    const text = JSON.stringify(value);
+    return value.status === 'failed' ? errorResult(text, structured) : textResult(text, structured);
+}
+/** A state that does not allow the action: an ordinary result (D-05: a business conflict is not
+ *  `isError`), and nothing was changed. */
+const conflict = (args, run, reason) => result(args, { accepted: false, status: 'conflict', runStatus: run.status, reason });
+/** A bad target or a service failure: a tool error the model can correct. */
+const failed = (args, reason) => result(args, { accepted: false, status: 'failed', reason });
+/** The task changed after the leader read it (#250): refused, nothing applied, never retried here. */
+function staleConflict(args, run, stale) {
+    const { status: _conflict, ...payload } = stale;
+    return result(args, { accepted: false, status: 'conflict', runStatus: run.status, reason: stale.guidance, ...payload });
+}
+/** The service refused: a stale version, a state conflict (409), or a failure. */
+const refused = (args, run, answer) => {
+    const stale = staleRejectionIn(answer.body);
+    if (stale)
+        return staleConflict(args, run, stale);
+    return answer.status === 409 ? conflict(args, run, answer.error) : failed(args, answer.error);
+};
+async function currentStatus(s, runId, fallback) {
+    const read = await s.adapter.getRun(runId);
+    return read.ok ? read.value.status : fallback;
+}
+async function pendingQuestion(s, runId) {
+    let cursor;
+    // Newest page first, then older ones, until a user message or an ask is found or history ends.
+    for (;;) {
+        const page = await settle(s.api.runs[':id'].history.$get({ param: { projectId: s.projectId, id: runId }, query: cursor ? { cursor } : {} }), [200]);
+        if (!page.ok)
+            return page;
+        const found = pendingQuestionIn(page.value.events);
+        if (found !== undefined)
+            return { ok: true, status: 200, value: found };
+        if (!page.value.hasOlder || !page.value.olderCursor)
+            return { ok: true, status: 200, value: null };
+        cursor = page.value.olderCursor;
+    }
+}
+async function postMessage(s, runId, text, images, expectedVersion) {
+    return settle(s.api.runs[':id'].messages.$post({
+        param: { projectId: s.projectId, id: runId },
+        json: { text: text ?? '', images: images ?? [], expectedVersion },
+    }), [200]);
+}
+async function postContinue(s, runId, text, images, expectedVersion) {
+    return settle(s.api.runs[':id'].continue.$post({
+        param: { projectId: s.projectId, id: runId },
+        json: { ...(text !== undefined ? { text } : {}), ...(images?.length ? { images } : {}), expectedVersion },
+    }), [200]);
+}
+/** `ask-answer.ts` `resumeAfterIdleTeardown`: retry only the idle-teardown 409, on its schedule. A
+ *  stale-version refusal is never retried: it is not the teardown, it is the answer. */
+async function continueAfterIdleTeardown(s, runId, text, expectedVersion) {
+    for (let retries = 0;; retries += 1) {
+        const answer = await postContinue(s, runId, text, undefined, expectedVersion);
+        const delay = IDLE_TEARDOWN_RETRY_DELAYS_MS[retries];
+        if (answer.ok || answer.status !== 409 || answer.error !== IDLE_TEARDOWN_REFUSAL || delay === undefined)
+            return answer;
+        await s.wait(delay);
+    }
+}
+const messageDelivery = (value) => 'queued' in value ? 'amended' : 'deferred' in value ? 'deferred' : 'live';
+async function control(args, s) {
+    // The target is read first, through the adapter: an id outside the bound project is a 404 and
+    // a malformed one is refused before anything is dispatched.
+    const read = await s.adapter.getRun(args.runId);
+    if (!read.ok)
+        return failed(args, read.error);
+    const run = read.value;
+    const id = run.id;
+    // Sent with every effect below; the route compares it with the task's current version (#250).
+    const version = args.expectedVersion;
+    const guard = { expectedVersion: version };
+    switch (args.action) {
+        case 'cancel': {
+            if (!isActive(run))
+                return conflict(args, run, `cancel is offered only while the task is active; it is ${run.status}`);
+            const answer = await s.adapter.cancelRun(id, version);
+            if (!answer.ok)
+                return refused(args, run, answer);
+            if (!answer.value.cancelled)
+                return conflict(args, run, 'the task was no longer active, so nothing was cancelled');
+            const after = await currentStatus(s, id, run.status);
+            // A queued task is dropped at once; an active one stops asynchronously. Its worktree stays.
+            return result(args, { accepted: true, status: after === 'cancelled' ? 'cancelled' : 'accepted', runStatus: after });
+        }
+        case 'finish': {
+            const meaning = run.status === 'waiting' ? 'close_session' : run.status === 'review' ? 'accept_review' : undefined;
+            if (!meaning) {
+                return conflict(args, run, `finish is offered only for a waiting task (close the session) or a task at review (accept without a PR); it is ${run.status}`);
+            }
+            if (args.finishAs !== meaning) {
+                return conflict(args, run, `the task is ${run.status}, so finish means ${meaning} here, not ${args.finishAs}; nothing was changed`);
+            }
+            const answer = await settle(s.api.runs[':id'].finish.$post({ param: { projectId: s.projectId, id }, json: guard }), [200]);
+            if (!answer.ok)
+                return refused(args, run, answer);
+            const after = await currentStatus(s, id, run.status);
+            return result(args, { accepted: true, status: meaning === 'accept_review' ? 'done' : 'accepted', runStatus: after });
+        }
+        case 'continue': {
+            if (isActive(run))
+                return conflict(args, run, `the task is ${run.status}, not closed — send a message instead`);
+            if (!hasSession(run))
+                return conflict(args, run, 'no agent session to resume');
+            let text = args.text;
+            if (run.status === 'review') {
+                // Send back (`review-panel.tsx`): feedback is required and rides with its prefix.
+                if (!hasText(text))
+                    return conflict(args, run, 'sending a task at review back needs feedback: write what to change first');
+                text = `${REVIEW_FEEDBACK_PREFIX}${text}`;
+            }
+            const answer = await postContinue(s, id, text, args.images, version);
+            if (!answer.ok)
+                return refused(args, run, answer);
+            const after = await currentStatus(s, id, run.status);
+            return result(args, { accepted: true, status: 'accepted', runStatus: after, delivery: 'continued' });
+        }
+        case 'send_message': {
+            // The composer's routing (`task-thread.tsx`): open session → send, queued → amend,
+            // closed with a session → continue with the text, anything else → disabled.
+            if (sessionOpen(run) || run.status === 'queued') {
+                const answer = await postMessage(s, id, args.text, args.images, version);
+                if (!answer.ok)
+                    return refused(args, run, answer);
+                const delivery = messageDelivery(answer.value);
+                const after = await currentStatus(s, id, run.status);
+                return result(args, {
+                    accepted: true,
+                    status: delivery === 'amended' ? 'done' : 'accepted',
+                    runStatus: after,
+                    delivery,
+                    ...('queued' in answer.value ? { messageId: answer.value.message.id } : {}),
+                });
+            }
+            if (!hasSession(run))
+                return conflict(args, run, 'Session closed — no session to resume.');
+            const answer = await postContinue(s, id, args.text, args.images, version);
+            if (!answer.ok)
+                return refused(args, run, answer);
+            const after = await currentStatus(s, id, run.status);
+            return result(args, { accepted: true, status: 'accepted', runStatus: after, delivery: 'continued' });
+        }
+        case 'answer_question': {
+            const pending = await pendingQuestion(s, id);
+            if (!pending.ok)
+                return refused(args, run, pending);
+            if (!pending.value)
+                return conflict(args, run, 'this task has no pending question; nothing was sent');
+            // THE TARGETING CHECK: an answer is delivered as the task's next user message, which the
+            // task reads as the answer to ITS pending question. Any other question id — a superseded
+            // ask, or another task's — would have its answer land on the wrong question.
+            if (pending.value.requestId !== args.questionId) {
+                return conflict(args, run, `that question is not this task's pending question (${pending.value.requestId}); nothing was sent`);
+            }
+            let text;
+            if (args.answers) {
+                const formatted = formatAnswers(pending.value.questions, args.answers);
+                if (!formatted.ok)
+                    return failed(args, formatted.error);
+                text = formatted.text;
+            }
+            else {
+                text = args.text;
+            }
+            const mode = askDeliveryMode(run);
+            if (mode === 'unavailable') {
+                return conflict(args, run, 'This session has ended and no agent session was recorded, so the answer cannot be delivered.');
+            }
+            const questionId = pending.value.requestId;
+            if (mode === 'live') {
+                const answer = await postMessage(s, id, text, undefined, version);
+                if (answer.ok) {
+                    const after = await currentStatus(s, id, run.status);
+                    return result(args, { accepted: true, status: 'accepted', runStatus: after, delivery: messageDelivery(answer.value), questionId });
+                }
+                // The record said live but the session had just closed: resume rather than drop it. A
+                // stale version is not that case — the task moved, and the leader must read it again.
+                if (answer.status !== 409 || !hasSession(run) || staleRejectionIn(answer.body))
+                    return refused(args, run, answer);
+            }
+            const answer = await continueAfterIdleTeardown(s, id, text, version);
+            if (!answer.ok)
+                return refused(args, run, answer);
+            const after = await currentStatus(s, id, run.status);
+            return result(args, { accepted: true, status: 'accepted', runStatus: after, delivery: 'resumed', questionId });
+        }
+        case 'edit_queued_message':
+        case 'remove_queued_message': {
+            const messageId = args.messageId;
+            // A fixed message: a refusal never echoes what the caller sent (#88, N-01).
+            if (!validPathId(messageId))
+                return failed(args, 'not a message id');
+            if (run.status !== 'queued') {
+                return conflict(args, run, `queued messages can be changed only while the task is queued; it is ${run.status}`);
+            }
+            const param = { projectId: s.projectId, id, msgId: messageId };
+            const answer = args.action === 'edit_queued_message'
+                ? await settle(s.api.runs[':id']['queued-messages'][':msgId'].$patch({
+                    param,
+                    json: {
+                        ...(args.text !== undefined ? { text: args.text } : {}),
+                        ...(args.images ? { images: args.images } : {}),
+                        ...guard,
+                    },
+                }), [200])
+                : await settle(s.api.runs[':id']['queued-messages'][':msgId'].$delete({ param, json: guard }), [200]);
+            if (!answer.ok)
+                return refused(args, run, answer);
+            return result(args, { accepted: true, status: 'done', runStatus: run.status, messageId });
+        }
+        case 'cancel_auto_resume': {
+            const answer = await settle(s.api.runs[':id']['auto-resume'].$delete({ param: { projectId: s.projectId, id }, json: guard }), [200]);
+            if (!answer.ok)
+                return refused(args, run, answer);
+            return result(args, {
+                accepted: true,
+                status: 'done',
+                runStatus: run.status,
+                hadPendingAutoResume: run.autoResumeAt !== undefined,
+            });
+        }
+    }
+}
+/** Build the tool over an injectable wait, so the idle-teardown schedule is testable. */
+export function createExecutionControlTool(wait = sleep) {
+    return defineTool({
+        name: 'execution_control',
+        title: 'Control a task and talk to its session',
+        description: [
+            "Control one of this project's own tasks, as the cockpit's buttons and composer do. Each action is allowed only in the states the cockpit allows it and is otherwise refused with nothing changed (status \"conflict\" and a reason).",
+            'cancel — stop a queued, running or waiting task; it ends cancelled and keeps its worktree.',
+            'finish — finishAs "close_session" closes a waiting task\'s session; finishAs "accept_review" accepts a task at review without a PR.',
+            'continue — reopen a closed task\'s last session, with optional text; for a task at review, text is required and is sent back as review feedback.',
+            'send_message — routed by state: an open session receives it, a queued task gets it folded into its prompt, a closed task with a session is continued with it; otherwise refused.',
+            'answer_question — answer the task\'s pending question by its questionId, with the option labels (answers) or free text; only the pending question can be answered, and a closed session is reopened to deliver it.',
+            'edit_queued_message / remove_queued_message — change a message stacked on a queued task.',
+            'cancel_auto_resume — stop a scheduled automatic resume after a usage limit.',
+            'Every action needs expectedVersion: the `version` task_read (view task) returned for this task. If the task changed since you read it, nothing is applied and the answer is status "conflict" with error "stale_version": read it again and decide again. A running task\'s version moves as its agent works, so read it right before acting.',
+            'Targets tasks only by run id in the bound project; there is no process-level control. Plan approval and decisions outside the approved goal stay with the human.',
+        ].join('\n'),
+        inputSchema: executionControlInputSchema,
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
+        async call(args, ctx) {
+            const service = ctx.service;
+            if (!service) {
+                return errorResult('execution_control is not connected to this cockpit\'s task services yet; nothing was changed. Use the cockpit for this action.');
+            }
+            const projectId = ctx.project.id;
+            return control(args, { adapter: new McpServiceAdapter({ projectId, service }), api: scopedApi(service), projectId, wait });
+        },
+    });
+}
+export const executionControlTool = createExecutionControlTool();
+//# sourceMappingURL=execution-control.js.map

package/dist/mcp/tools/execution-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-control.js","sourceRoot":"","sources":["../../../src/mcp/tools/execution-control.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/handoff-git.d.ts

@@ -0,0 +1,26 @@
+import { type GithubPrMergeState } from '../../contract/index.js';
+import { z } from 'zod';
+export declare const HANDOFF_ACTIONS: readonly ['repo', 'commit', 'push', 'create_pr', 'merge_state', 'ready', 'merge', 'branch'];
+/** The next legitimate action after a quality blocker. It offers no waiver, to anyone (A-22). */
+export declare const QUALITY_BLOCKER_NEXT_ACTION: string;
+/**
+ * Every reason this pull request's quality is not proven, from the fresh merge state. A check the
+ * forge could not classify (`required: null`) counts as required: unknown evidence is never a
+ * pass. An empty list is the only answer that lets a merge be dispatched at all.
+ */
+export declare function qualityBlockers(state: GithubPrMergeState): Array<{
+    code: string;
+    message: string;
+}>;
+/**
+ * Every reason a draft should NOT be marked ready yet (#262): a required check that is already
+ * failing, and a review that asked for changes. Readying such a pull request asks reviewers to look
+ * at work whose own gate says it is not done. A pending check or a review nobody has given yet is
+ * not on this list: those are exactly what "ready for review" invites, and a draft never gets them
+ * otherwise. Like `qualityBlockers`, a check the forge could not classify counts as required.
+ */
+export declare function readyBlockers(state: GithubPrMergeState): Array<{
+    code: string;
+    message: string;
+}>;
+export declare const handoffGitTool: import("../tool.ts").McpTool<z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>>;