brainfile 0.18.1 → 0.20.0

package/dist/mcp/schemas.d.ts

@@ -0,0 +1,297 @@
+/**
+ * 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.
+ */
+import { z } from 'zod';
+export declare const listTasksOutputSchema: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        column: z.ZodString;
+        id: z.ZodString;
+        title: z.ZodString;
+        priority: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        assignee: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * `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.
+ */
+export declare const getTaskOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    column: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodOptional<z.ZodString>;
+    dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    blockedBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    relatedFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    assignee: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    priority: z.ZodOptional<z.ZodString>;
+    dueDate: z.ZodOptional<z.ZodString>;
+    subtasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        completed: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>>;
+    contract: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    completedAt: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodNumber>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+/**
+ * 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.
+ */
+export declare const searchOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    completedAt: z.ZodOptional<z.ZodString>;
+    isLog: z.ZodBoolean;
+    description: z.ZodOptional<z.ZodString>;
+    log: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    logs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        completedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        column: z.ZodOptional<z.ZodString>;
+        score: z.ZodNumber;
+        isLog: z.ZodOptional<z.ZodBoolean>;
+        id: z.ZodString;
+        title: z.ZodString;
+        priority: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        assignee: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+}, z.core.$strip>]>;
+/** New payload: `task_add` previously returned only a prose confirmation. */
+export declare const taskAddOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
+/**
+ * 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.
+ */
+export declare const taskMoveOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        success: z.ZodBoolean;
+        message: z.ZodOptional<z.ZodString>;
+        warning: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const taskPatchOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** New payload: `task_delete` previously returned only a prose confirmation. */
+export declare const taskDeleteOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    deleted: z.ZodLiteral<true>;
+}, z.core.$strip>;
+/**
+ * `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.
+ */
+export declare const subtaskOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"add">;
+    added: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"delete">;
+    deleted: z.ZodArray<z.ZodString>;
+    missing: z.ZodArray<z.ZodString>;
+    count: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"toggle">;
+    updated: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        completed: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"update">;
+    updated: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+}, z.core.$strip>], "action">;
+/**
+ * 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.
+ */
+export declare const contractOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"attach">;
+    task: z.ZodString;
+    status: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"pickup">;
+    task: z.ZodString;
+    markdown: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"deliver">;
+    task: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"validate">;
+    ok: z.ZodBoolean;
+    status: z.ZodString;
+    deliverables: z.ZodArray<z.ZodObject<{
+        deliverable: z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            path: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        ok: z.ZodBoolean;
+        resolvedPath: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    commands: z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        exitCode: z.ZodNumber;
+        stdout: z.ZodString;
+        stderr: z.ZodString;
+    }, z.core.$loose>>;
+    warnings: z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$loose>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"graph">;
+    attached: z.ZodArray<z.ZodString>;
+    count: z.ZodNumber;
+    order: z.ZodArray<z.ZodString>;
+    graph: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"activate">;
+    activated: z.ZodArray<z.ZodString>;
+    count: z.ZodNumber;
+}, z.core.$strip>], "action">;
+/**
+ * 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`.
+ */
+export declare const taskCompleteOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    destination: z.ZodLiteral<"local">;
+    taskId: z.ZodString;
+    completedAt: z.ZodOptional<z.ZodString>;
+    archived: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    destination: z.ZodLiteral<"github">;
+    taskId: z.ZodString;
+    issueNumber: z.ZodOptional<z.ZodNumber>;
+    issueUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    destination: z.ZodLiteral<"linear">;
+    taskId: z.ZodString;
+    issueId: z.ZodOptional<z.ZodString>;
+    issueUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "destination">;
+/**
+ * `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.
+ */
+export declare const briefOutputSchema: z.ZodObject<{
+    agent: z.ZodString;
+    mode: z.ZodEnum<{
+        full: "full";
+        delta: "delta";
+    }>;
+    generatedAt: z.ZodString;
+    lastBriefAt: z.ZodNullable<z.ZodString>;
+    peek: z.ZodBoolean;
+    lanes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+            taskId: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+            why: z.ZodString;
+            at: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/mcp/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/mcp/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAGhC,CAAC;AAIH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;iBAqB9B,CAAC;AAmCH;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;mBAI7B,CAAC;AAIH,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAIH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;iBAW/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;iBAShC,CAAC;AAIH,gFAAgF;AAChF,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;6BAsB9B,CAAC;AAaH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAgD/B,CAAC;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;kCAmBnC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;iBAgB5B,CAAC"}

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;AAO9D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAgD9E"}