brainfile 0.19.0 → 0.21.0

package/dist/mcp/schemas.js

@@ -0,0 +1,328 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.briefOutputSchema = exports.taskCompleteOutputSchema = exports.contractOutputSchema = exports.subtaskOutputSchema = exports.taskDeleteOutputSchema = exports.taskPatchOutputSchema = exports.taskMoveOutputSchema = exports.taskAddOutputSchema = exports.searchOutputSchema = exports.getTaskOutputSchema = exports.listTasksOutputSchema = void 0;
+/**
+ * Output schemas for the 11 consolidated MCP tools.
+ *
+ * Each tool declares one of these as `outputSchema`, and every non-error
+ * success path returns the matching object as `structuredContent` alongside
+ * the `content` text block it already emitted. The text block is never
+ * removed, so clients that read only `content` are unaffected.
+ *
+ * Three SDK behaviours (v2.0.0) shape everything here — all verified against
+ * the installed `@modelcontextprotocol/server` runtime:
+ *
+ * 1. Declaring `outputSchema` makes `structuredContent` MANDATORY on every
+ *    result that is not `isError: true`. `McpServer.validateToolOutput`
+ *    throws `Output validation error: … no structured content was provided`
+ *    otherwise. Adding a schema to a tool therefore means auditing *every*
+ *    success `return` in that tool, not just the main one.
+ *
+ * 2. Output validation is SKIPPED when `isError: true`, so error paths need
+ *    neither `structuredContent` nor schema conformance. Error returns are
+ *    left exactly as they were.
+ *
+ * 3. Root shape decides whether the two protocol eras agree. The 2025-era
+ *    wire codec re-wraps `structuredContent` as `{result: …}` whenever the
+ *    ADVERTISED schema root is not `type: "object"`, while the 2026-era codec
+ *    is identity — so a non-object root would hand the two eras different
+ *    bytes. Unions are still safe: the SDK's `standardSchemaToJsonSchema`
+ *    injects `type: "object"` for any `oneOf`/`anyOf` whose members are all
+ *    object-shaped (`isProvablyObjectShapedRoot`). Every union below is a
+ *    union of objects for exactly that reason — adding a non-object member
+ *    (a bare `z.string()`, say) would silently split the eras apart.
+ *
+ * Enum-ish fields that originate in hand-editable YAML (notably `priority`)
+ * are typed `z.string()` rather than `z.enum([...])`. A board carrying
+ * `priority: urgent` would otherwise fail output validation and turn a
+ * working call into an error result.
+ */
+const zod_1 = require("zod");
+// ── shared fragments ───────────────────────────────────────────────────────
+/** A task as projected into list/search results (never the raw task file). */
+const taskSummaryShape = {
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    priority: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    assignee: zod_1.z.string().optional(),
+};
+// `column` is the column *id* (same as `get_task`), so a subsequent `task_move`
+// can pass the value back without resolving titles.
+const subtaskSchema = zod_1.z.looseObject({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    completed: zod_1.z.boolean().optional(),
+});
+// ── list_tasks ─────────────────────────────────────────────────────────────
+exports.listTasksOutputSchema = zod_1.z.object({
+    tasks: zod_1.z.array(zod_1.z.object({ ...taskSummaryShape, column: zod_1.z.string() })),
+    count: zod_1.z.number(),
+});
+// ── get_task ───────────────────────────────────────────────────────────────
+/**
+ * `get_task` spreads the raw `Task`, whose TypeScript type carries an open
+ * `[key: string]: unknown` index signature so extension fields (`x-otto`,
+ * `x-cursor`, …) round-trip. Modelled with `z.looseObject` so the advertised
+ * JSON Schema says `additionalProperties: {}` instead of `false` — a closed
+ * object would advertise those extension fields as illegal.
+ *
+ * `id` and `title` are required because `parseTaskContent` returns null for
+ * any task file missing either, so a task that reached this point has both.
+ * `column` is always set by the handler.
+ */
+exports.getTaskOutputSchema = zod_1.z.looseObject({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    column: zod_1.z.string(),
+    type: zod_1.z.string().optional(),
+    description: zod_1.z.string().optional(),
+    parentId: zod_1.z.string().optional(),
+    dependsOn: zod_1.z.array(zod_1.z.string()).optional(),
+    blockedBy: zod_1.z.array(zod_1.z.string()).optional(),
+    relatedFiles: zod_1.z.array(zod_1.z.string()).optional(),
+    assignee: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    priority: zod_1.z.string().optional(),
+    dueDate: zod_1.z.string().optional(),
+    subtasks: zod_1.z.array(subtaskSchema).optional(),
+    contract: zod_1.z.looseObject({}).optional(),
+    createdAt: zod_1.z.string().optional(),
+    updatedAt: zod_1.z.string().optional(),
+    completedAt: zod_1.z.string().optional(),
+    position: zod_1.z.number().optional(),
+    archived: zod_1.z.boolean().optional(),
+});
+// ── search ─────────────────────────────────────────────────────────────────
+/** `task:` — a single task/log entry rendered with its description and log. */
+const searchTaskViewSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    completedAt: zod_1.z.string().optional(),
+    isLog: zod_1.z.boolean(),
+    description: zod_1.z.string().optional(),
+    log: zod_1.z.string().optional(),
+});
+/** `recent: true` — the most recently completed tasks. */
+const searchRecentSchema = zod_1.z.object({
+    logs: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        title: zod_1.z.string(),
+        completedAt: zod_1.z.string().optional(),
+    })),
+    count: zod_1.z.number(),
+});
+/** `query:` — ranked matches across board and logs. */
+const searchResultsSchema = zod_1.z.object({
+    results: zod_1.z.array(zod_1.z.object({
+        ...taskSummaryShape,
+        column: zod_1.z.string().optional(),
+        score: zod_1.z.number(),
+        isLog: zod_1.z.boolean().optional(),
+    })),
+    count: zod_1.z.number(),
+});
+/**
+ * Three genuinely different payloads selected by which input was supplied.
+ * The variants' required-field sets don't overlap (`isLog` scalar vs `logs`
+ * array vs `results` array), so an untagged union discriminates structurally
+ * and no payload had to change to add a tag.
+ */
+exports.searchOutputSchema = zod_1.z.union([
+    searchTaskViewSchema,
+    searchRecentSchema,
+    searchResultsSchema,
+]);
+// ── task_add ───────────────────────────────────────────────────────────────
+/** New payload: `task_add` previously returned only a prose confirmation. */
+exports.taskAddOutputSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+});
+// ── task_move / task_patch ─────────────────────────────────────────────────
+/**
+ * Both tools branch their TEXT on single-vs-batch, but the structured payload
+ * is always the batch shape (a one-element `results` array for a single move),
+ * so agents parse one shape regardless of how many IDs they passed.
+ */
+exports.taskMoveOutputSchema = zod_1.z.object({
+    success: zod_1.z.boolean(),
+    successCount: zod_1.z.number(),
+    failureCount: zod_1.z.number(),
+    results: zod_1.z.array(zod_1.z.object({
+        taskId: zod_1.z.string(),
+        success: zod_1.z.boolean(),
+        message: zod_1.z.string().optional(),
+        warning: zod_1.z.string().optional(),
+        error: zod_1.z.string().optional(),
+    })),
+});
+exports.taskPatchOutputSchema = zod_1.z.object({
+    success: zod_1.z.boolean(),
+    successCount: zod_1.z.number(),
+    failureCount: zod_1.z.number(),
+    results: zod_1.z.array(zod_1.z.object({
+        taskId: zod_1.z.string(),
+        success: zod_1.z.boolean(),
+        error: zod_1.z.string().optional(),
+    })),
+});
+// ── task_delete ────────────────────────────────────────────────────────────
+/** New payload: `task_delete` previously returned only a prose confirmation. */
+exports.taskDeleteOutputSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    deleted: zod_1.z.literal(true),
+});
+// ── subtask ────────────────────────────────────────────────────────────────
+/**
+ * `toggle` and `update` both key their payload `updated` but carry different
+ * item shapes (`{id, completed}` vs `{id, title}`), which is ambiguous without
+ * a tag. The tool's own `action` input is echoed into the output to
+ * discriminate — an added field, nothing renamed.
+ *
+ * The singular paths (which used to emit prose only) now emit the same plural
+ * array shape, so item count never changes the structure.
+ */
+exports.subtaskOutputSchema = zod_1.z.discriminatedUnion('action', [
+    zod_1.z.object({
+        action: zod_1.z.literal('add'),
+        added: zod_1.z.array(zod_1.z.object({ id: zod_1.z.string(), title: zod_1.z.string() })),
+        count: zod_1.z.number(),
+    }),
+    zod_1.z.object({
+        action: zod_1.z.literal('delete'),
+        deleted: zod_1.z.array(zod_1.z.string()),
+        missing: zod_1.z.array(zod_1.z.string()),
+        count: zod_1.z.number(),
+    }),
+    zod_1.z.object({
+        action: zod_1.z.literal('toggle'),
+        updated: zod_1.z.array(zod_1.z.object({ id: zod_1.z.string(), completed: zod_1.z.boolean().optional() })),
+        count: zod_1.z.number(),
+    }),
+    zod_1.z.object({
+        action: zod_1.z.literal('update'),
+        updated: zod_1.z.array(zod_1.z.object({ id: zod_1.z.string(), title: zod_1.z.string() })),
+        count: zod_1.z.number(),
+    }),
+]);
+// ── contract ───────────────────────────────────────────────────────────────
+const deliverableSchema = zod_1.z.looseObject({
+    // Hand-edited YAML often omits `type` (path-only deliverables). Required here
+    // would fail output validation on a successful validate after the task was
+    // already completed.
+    type: zod_1.z.string().optional(),
+    path: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+});
+/**
+ * Six heterogeneous actions, tagged by the `action` input the caller already
+ * supplied. `pickup`'s payload is genuinely free-text agent-context markdown,
+ * so its variant is deliberately thin — an output schema does not have to
+ * invent structure that the payload does not have.
+ */
+exports.contractOutputSchema = zod_1.z.discriminatedUnion('action', [
+    zod_1.z.object({
+        action: zod_1.z.literal('attach'),
+        task: zod_1.z.string(),
+        status: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        action: zod_1.z.literal('pickup'),
+        task: zod_1.z.string(),
+        markdown: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        action: zod_1.z.literal('deliver'),
+        task: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        action: zod_1.z.literal('validate'),
+        ok: zod_1.z.boolean(),
+        status: zod_1.z.string(),
+        deliverables: zod_1.z.array(zod_1.z.looseObject({
+            deliverable: deliverableSchema,
+            ok: zod_1.z.boolean(),
+            resolvedPath: zod_1.z.string().optional(),
+            error: zod_1.z.string().optional(),
+        })),
+        commands: zod_1.z.array(zod_1.z.looseObject({
+            command: zod_1.z.string(),
+            exitCode: zod_1.z.number(),
+            stdout: zod_1.z.string(),
+            stderr: zod_1.z.string(),
+        })),
+        warnings: zod_1.z.array(zod_1.z.looseObject({
+            command: zod_1.z.string(),
+            message: zod_1.z.string(),
+        })),
+    }),
+    zod_1.z.object({
+        action: zod_1.z.literal('graph'),
+        attached: zod_1.z.array(zod_1.z.string()),
+        count: zod_1.z.number(),
+        order: zod_1.z.array(zod_1.z.string()),
+        graph: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        action: zod_1.z.literal('activate'),
+        activated: zod_1.z.array(zod_1.z.string()),
+        count: zod_1.z.number(),
+    }),
+]);
+// ── task_complete ──────────────────────────────────────────────────────────
+/**
+ * New payload: every success path previously returned prose only, with the
+ * interesting values (`completedAt`, issue number/id, issue URL) interpolated
+ * into the message. They are now also returned as real fields.
+ *
+ * Tagged by the `destination` input. The default path (no `destination`) and
+ * `destination: 'local'` share the `local` variant and are told apart by
+ * `archived`.
+ */
+exports.taskCompleteOutputSchema = zod_1.z.discriminatedUnion('destination', [
+    zod_1.z.object({
+        destination: zod_1.z.literal('local'),
+        taskId: zod_1.z.string(),
+        completedAt: zod_1.z.string().optional(),
+        archived: zod_1.z.boolean(),
+    }),
+    zod_1.z.object({
+        destination: zod_1.z.literal('github'),
+        taskId: zod_1.z.string(),
+        issueNumber: zod_1.z.number().optional(),
+        issueUrl: zod_1.z.string().optional(),
+    }),
+    zod_1.z.object({
+        destination: zod_1.z.literal('linear'),
+        taskId: zod_1.z.string(),
+        issueId: zod_1.z.string().optional(),
+        issueUrl: zod_1.z.string().optional(),
+    }),
+]);
+/**
+ * `brief` — per-agent attention digest.
+ *
+ * Object root (not a bare array of lanes) so both protocol eras hand clients
+ * identical bytes, per note 3 above. `lastBriefAt` is nullable rather than
+ * optional: "this agent has never briefed" is a meaningful state a client must
+ * be able to distinguish from an omitted field.
+ */
+exports.briefOutputSchema = zod_1.z.object({
+    agent: zod_1.z.string(),
+    mode: zod_1.z.enum(['full', 'delta']),
+    generatedAt: zod_1.z.string(),
+    lastBriefAt: zod_1.z.string().nullable(),
+    peek: zod_1.z.boolean(),
+    lanes: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        label: zod_1.z.string(),
+        items: zod_1.z.array(zod_1.z.object({
+            taskId: zod_1.z.string().optional(),
+            text: zod_1.z.string(),
+            why: zod_1.z.string(),
+            at: zod_1.z.string().optional(),
+        })),
+    })),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/mcp/schemas.js.map

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

package/dist/mcp/tools/brief_tool.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+/**
+ * `brief` — "what changed that I should care about?" for one agent.
+ *
+ * The first call for an agent returns a full orientation; later calls return a
+ * delta against that agent's stored checkpoint in `.brainfile/state/`. `peek`
+ * reads without advancing the checkpoint, so a client can inspect pending work
+ * without consuming it.
+ *
+ * Note that `buildBrief` itself is read-only — advancing the checkpoint is this
+ * handler's decision, which is what makes `peek` a no-op on the write step.
+ */
+export declare function registerBriefTool(server: McpServer, defaultFile: string): void;
+//# sourceMappingURL=brief_tool.d.ts.map

package/dist/mcp/tools/brief_tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/brief_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAS9D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAmD9E"}

package/dist/mcp/tools/brief_tool.js

@@ -0,0 +1,96 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) 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 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerBriefTool = registerBriefTool;
+const zod_1 = require("zod");
+const core_1 = require("@brainfile/core");
+const v2_detect_1 = require("../../utils/v2-detect");
+const helpers_1 = require("../helpers");
+const schemas_1 = require("../schemas");
+const board_sync_1 = require("../../utils/board-sync");
+const path = __importStar(require("path"));
+/**
+ * `brief` — "what changed that I should care about?" for one agent.
+ *
+ * The first call for an agent returns a full orientation; later calls return a
+ * delta against that agent's stored checkpoint in `.brainfile/state/`. `peek`
+ * reads without advancing the checkpoint, so a client can inspect pending work
+ * without consuming it.
+ *
+ * Note that `buildBrief` itself is read-only — advancing the checkpoint is this
+ * handler's decision, which is what makes `peek` a no-op on the write step.
+ */
+function registerBriefTool(server, defaultFile) {
+    server.registerTool('brief', {
+        title: 'Agent Brief',
+        description: 'Get a per-agent brief: what changed on the board since this agent last checked in. '
+            + 'First call returns a full orientation; later calls return only what is new.',
+        inputSchema: zod_1.z.object({
+            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
+            agent: zod_1.z.string().describe('Agent identifier (required — brief state is per-agent)'),
+            peek: zod_1.z.boolean().optional().describe('Read the brief without marking it as seen'),
+            offline: zod_1.z.boolean().optional().describe('Skip syncing a shared board before the brief'),
+        }),
+        outputSchema: schemas_1.briefOutputSchema,
+    }, async ({ file, agent, peek, offline }) => {
+        const filePath = file || defaultFile;
+        const guard = (0, helpers_1.requireV2)(filePath);
+        if (guard)
+            return guard;
+        const agentName = agent?.trim();
+        if (!agentName) {
+            return {
+                content: [{ type: 'text', text: 'Error: agent is required' }],
+                isError: true,
+            };
+        }
+        const resolvedPath = (0, helpers_1.resolveBrainfile)(filePath);
+        if (!offline)
+            (0, board_sync_1.syncBoard)(path.dirname(resolvedPath), { agent: agentName });
+        const dirs = (0, v2_detect_1.getV2Dirs)(resolvedPath);
+        const isPeek = peek === true;
+        const state = (0, core_1.readBriefState)(resolvedPath, agentName);
+        const result = (0, core_1.buildBrief)(dirs, agentName, { lastBriefAt: state.lastBriefAt });
+        if (!isPeek) {
+            (0, core_1.writeBriefState)(resolvedPath, agentName, result.generatedAt);
+        }
+        const output = { ...result, peek: isPeek };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+            structuredContent: output,
+        };
+    });
+}
+//# sourceMappingURL=brief_tool.js.map

package/dist/mcp/tools/brief_tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief_tool.js","sourceRoot":"","sources":["../../../src/mcp/tools/brief_tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,8CAmDC;AAtED,6BAAwB;AACxB,0CAA8E;AAC9E,qDAAkD;AAClD,wCAAyD;AACzD,wCAA+C;AAC/C,uDAAmD;AACnD,2CAA6B;AAE7B;;;;;;;;;;GAUG;AACH,SAAgB,iBAAiB,CAAC,MAAiB,EAAE,WAAmB;IACtE,MAAM,CAAC,YAAY,CACjB,OAAO,EACP;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,qFAAqF;cACnF,6EAA6E;QACjF,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YACpF,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YACpF,IAAI,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAClF,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;SACzF,CAAC;QACF,YAAY,EAAE,2BAAiB;KAChC,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QACvC,MAAM,QAAQ,GAAG,IAAI,IAAI,WAAW,CAAC;QAErC,MAAM,KAAK,GAAG,IAAA,mBAAS,EAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAExB,MAAM,SAAS,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;gBACtE,OAAO,EAAE,IAAa;aACvB,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,IAAA,0BAAgB,EAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO;YAAE,IAAA,sBAAS,EAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAE1E,MAAM,IAAI,GAAG,IAAA,qBAAS,EAAC,YAAY,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;QAE7B,MAAM,KAAK,GAAG,IAAA,qBAAc,EAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAA,iBAAU,EAAC,IAAI,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAE/E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAA,sBAAe,EAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAE3C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC3E,iBAAiB,EAAE,MAAM;SAC1B,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/contract_tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/contract_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAY9D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAmLjF"}
+{"version":3,"file":"contract_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/contract_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAc9D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA0MjF"}

package/dist/mcp/tools/contract_tool.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerContractTool = registerContractTool;
+const helpers_1 = require("../helpers");
 const zod_1 = require("zod");
 const core_1 = require("@brainfile/core");
 const v2_detect_1 = require("../../utils/v2-detect");
 const contractRunner_1 = require("../../lib/contractRunner");
 const contract_1 = require("./contract");
-const helpers_1 = require("../helpers");
+const helpers_2 = require("../helpers");
+const schemas_1 = require("../schemas");
 function registerContractTool(server, defaultFile) {
     server.registerTool('contract', {
         title: 'Contract',
@@ -40,15 +42,16 @@ function registerContractTool(server, defaultFile) {
                 dependsOn: zod_1.z.array(zod_1.z.string()).optional(),
             })).optional().describe('graph only: array of contract graph task specs'),
             activate: zod_1.z.boolean().optional().describe('graph only: when true, attached contracts start in ready instead of draft'),
-        })
-    }, async ({ action, file, task, parentId, ready: attachReady, deliverables, validation_commands, constraints, tasks, activate }) => {
+        }),
+        outputSchema: schemas_1.contractOutputSchema
+    }, (0, helpers_1.withBoardCommit)('contract', defaultFile, async ({ action, file, task, parentId, ready: attachReady, deliverables, validation_commands, constraints, tasks, activate }) => {
         const filePath = file || defaultFile;
         // ── attach ─────────────────────────────────────────────────────────────
         if (action === 'attach') {
             if (!task) {
                 return { content: [{ type: 'text', text: 'Error: task is required for action=attach' }], isError: true };
             }
-            const guard = (0, helpers_1.requireV2)(filePath);
+            const guard = (0, helpers_2.requireV2)(filePath);
             if (guard)
                 return guard;
             const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
@@ -66,7 +69,11 @@ function registerContractTool(server, defaultFile) {
                 if (!result.success || !result.task) {
                     return { content: [{ type: 'text', text: `Error: ${result.error || 'Failed to attach contract'}` }], isError: true };
                 }
-                return { content: [{ type: 'text', text: `Contract attached (${result.task.contract.status}): ${task}` }] };
+                const status = result.task.contract.status;
+                return {
+                    content: [{ type: 'text', text: `Contract attached (${status}): ${task}` }],
+                    structuredContent: { action: 'attach', task, status },
+                };
             }
             catch (e) {
                 return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
@@ -81,7 +88,12 @@ function registerContractTool(server, defaultFile) {
             if ('error' in result) {
                 return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
             }
-            return { content: [{ type: 'text', text: result.markdown }] };
+            // The payload is genuinely free-text agent-context markdown, so the
+            // structured variant just carries it verbatim.
+            return {
+                content: [{ type: 'text', text: result.markdown }],
+                structuredContent: { action: 'pickup', task, markdown: result.markdown },
+            };
         }
         // ── deliver ────────────────────────────────────────────────────────────
         if (action === 'deliver') {
@@ -92,7 +104,10 @@ function registerContractTool(server, defaultFile) {
             if ('error' in result) {
                 return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
             }
-            return { content: [{ type: 'text', text: `Contract delivered: ${task}` }] };
+            return {
+                content: [{ type: 'text', text: `Contract delivered: ${task}` }],
+                structuredContent: { action: 'deliver', task },
+            };
         }
         // ── validate ───────────────────────────────────────────────────────────
         if (action === 'validate') {
@@ -104,15 +119,19 @@ function registerContractTool(server, defaultFile) {
                 return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
             }
             const output = {
+                action: 'validate',
                 ok: result.ok,
                 status: result.ok ? 'done' : 'failed',
                 deliverables: result.deliverableChecks,
                 commands: result.commandResults,
                 warnings: result.warnings,
             };
+            // Failed validation is a successful tool result (`ok: false`), not a
+            // tool error. `isError: true` would skip outputSchema checks and hide
+            // deliverable/command details from clients that drop error payloads.
             return {
                 content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
-                isError: !result.ok,
+                structuredContent: output,
             };
         }
         // ── graph ──────────────────────────────────────────────────────────────
@@ -126,13 +145,16 @@ function registerContractTool(server, defaultFile) {
                     tasks,
                     activate,
                 });
+                const output = {
+                    action: 'graph',
+                    attached: result.attached,
+                    count: result.count,
+                    order: result.order,
+                    graph: result.graph,
+                };
                 return {
-                    content: [{ type: 'text', text: JSON.stringify({
-                                attached: result.attached,
-                                count: result.count,
-                                order: result.order,
-                                graph: result.graph,
-                            }, null, 2) }],
+                    content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+                    structuredContent: output,
                 };
             }
             catch (error) {
@@ -147,7 +169,7 @@ function registerContractTool(server, defaultFile) {
             if (!task && !parentId) {
                 return { content: [{ type: 'text', text: 'Error: task or parentId is required for action=activate' }], isError: true };
             }
-            const guard = (0, helpers_1.requireV2)(filePath);
+            const guard = (0, helpers_2.requireV2)(filePath);
             if (guard)
                 return guard;
             const activated = [];
@@ -167,10 +189,13 @@ function registerContractTool(server, defaultFile) {
                 // Bulk by parentId
                 activated.push(...(0, core_1.activateTaskContractsByParent)(dirs.boardDir, parentId).activated);
             }
-            const output = { activated, count: activated.length };
-            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+            const output = { action: 'activate', activated, count: activated.length };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+                structuredContent: output,
+            };
         }
         return { content: [{ type: 'text', text: `Error: Unknown action: ${action}` }], isError: true };
-    });
+    }));
 }
 //# sourceMappingURL=contract_tool.js.map