@rallycry/conveyor-mcp 5.0.5 → 5.0.6

package/dist/cli.js

@@ -1118,6 +1118,11 @@ var uploadAttachmentContract = defineToolContract({
       title: f.optional(
         f.string({ desc: "Short caption posted with the file (defaults to the file name)" })
       ),
+      comment: f.optional(
+        f.string({
+          desc: "Alias of `title` (the external conveyor-mcp surface names this field `comment`). Provide at most one of the two."
+        })
+      ),
       tags: attachmentTags
     }
   },
@@ -1130,6 +1135,11 @@ var uploadAttachmentContract = defineToolContract({
       comment: f.optional(
         f.string({ desc: "When set, also posts the attachment to the task chat with this text" })
       ),
+      title: f.optional(
+        f.string({
+          desc: "Alias of `comment` (the in-pod agent surface names this field `title`). Provide at most one of the two."
+        })
+      ),
       tags: attachmentTags,
       mimeType: f.optional(
         f.string({ desc: "Override the mime type inferred from the file extension" })
@@ -1189,7 +1199,7 @@ var agentOption = f.object(
 var createDecisionContract = defineToolContract({
   name: "create_decision",
   agent: {
-    description: `Raise a product decision: a fork the plan cannot be right without. Two or three options, one default, a deadline. Run list_decisions FIRST \u2014 an answered decision is the answer, and re-asking it wastes everybody's time. Do NOT file a decision for an assumption you can simply state: an assumed behaviour belongs in the plan as a GIVEN / WHEN / THEN line under "Assumed behaviours". Returns the decision's id, slug, and url.`,
+    description: `Raise a product decision: a fork the plan cannot be right without. Two or three options, one default, a deadline. Run list_decisions FIRST \u2014 an answered decision is the answer, and re-asking it wastes everybody's time. Do NOT file a decision for an assumption you can simply state: an assumed behaviour belongs in the plan as a GIVEN / WHEN / THEN line under "Assumed behaviours". Returns the decision in full (the same JSON as get_decision, with option ids and the deadline) plus which cards were linked.`,
     fields: {
       question: f.string({
         min: 1,
@@ -1226,6 +1236,16 @@ var createDecisionContract = defineToolContract({
       ),
       raised_by_pr: f.optional(
         f.number({ int: true, min: 1, desc: "PR number that surfaced the question" })
+      ),
+      raised_by_card: f.optional(
+        f.string({
+          desc: "Slug or id of the card that raised the question. A link back, not a block \u2014 use impacted_cards to block a card."
+        })
+      ),
+      deadline_at: f.optional(
+        f.string({
+          desc: "Absolute deadline as an ISO 8601 timestamp, e.g. 2026-09-25T17:00:00Z. Wins over deadline_hours when both are given; must be in the future and within 720 hours."
+        })
       )
     }
   },
@@ -1249,6 +1269,16 @@ var createDecisionContract = defineToolContract({
       tagNames: f.optional(f.array(f.string(), { desc: "Tag names to categorize the decision" })),
       raisedByPr: f.optional(
         f.number({ int: true, min: 1, desc: "PR number that surfaced the question" })
+      ),
+      raisedByCard: f.optional(
+        f.string({
+          desc: "Slug or id of the card that raised the question. A link back, not a block \u2014 use impactedCards to block a card."
+        })
+      ),
+      deadlineAt: f.optional(
+        f.string({
+          desc: "Absolute deadline (ISO 8601). Wins over deadlineHours when both are given; must be in the future and within 720 hours."
+        })
       )
     }
   }
@@ -1256,7 +1286,7 @@ var createDecisionContract = defineToolContract({
 var listDecisionsContract = defineToolContract({
   name: "list_decisions",
   agent: {
-    description: `Search this project's decisions. Run this BEFORE planning anything in an area: "have we already decided how X behaves?" Decided rows carry their resolution, so the list doubles as the decision log. Filter by card to see what is blocking a specific card.`,
+    description: `Search this project's decisions. Run this BEFORE planning anything in an area: "have we already decided how X behaves?" Each row carries the summary, who raised it (and from which card or PR), when, and \u2014 once settled \u2014 the resolution, so the list doubles as the decision log. Filter by card to see what is blocking a specific card.`,
     fields: {
       status: f.optional(
         f.enum(STATUS_LABELS, {
@@ -1288,7 +1318,7 @@ var listDecisionsContract = defineToolContract({
 var getDecisionContract = defineToolContract({
   name: "get_decision",
   agent: {
-    description: "Read one decision in full: its context, every option with its GIVEN / WHEN / THEN, every vote with who cast it and why, the running tally, the cards it blocks, and the resolution once there is one. Use read_task_chat with the same id for the discussion thread.",
+    description: "Read one decision in full: its summary and context, who raised it and from where, every option with its GIVEN / WHEN / THEN, every vote with who cast it and why, the running tally, the cards it blocks, and the resolution once there is one. Use read_task_chat with the same id for the discussion thread.",
     fields: {
       decision: f.string({ min: 1, desc: "Decision slug or id" })
     }
@@ -1353,10 +1383,32 @@ var resolveDecisionContract = defineToolContract({
 var updateDecisionContract = defineToolContract({
   name: "update_decision",
   agent: {
-    description: "Change an open decision: extend its deadline, link or unlink the cards it blocks, or cancel it. Cancelling un-blocks the impacted cards without answering the question, so only do it when the question stopped mattering.",
+    description: "Change an open decision: fix the question, summary, context or tags, rewrite the options while nobody has voted, move the deadline, link or unlink the cards it blocks, or cancel it. Cancelling un-blocks the impacted cards without answering the question, so only do it when the question stopped mattering.",
     fields: {
       decision: f.string({ min: 1, desc: "Decision slug or id" }),
+      question: f.optional(f.string({ min: 1, desc: "New question, one plain sentence" })),
+      summary: f.optional(
+        f.string({ desc: cardDescriptionDesc("New one- or two-sentence summary") })
+      ),
+      context: f.optional(f.string({ min: 1, desc: "New markdown background" })),
+      options: f.optional(
+        f.array(agentOption, {
+          min: 2,
+          desc: "Replacement options. Accepted only while the decision has no votes \u2014 once somebody has voted, cancel it and raise a new one instead. Send default_option with it: the old default no longer exists."
+        })
+      ),
+      default_option: f.optional(
+        f.number({ int: true, min: 1, max: 3, desc: "1-based position of the new default" })
+      ),
+      tag_names: f.optional(
+        f.array(f.string(), { desc: "Replacement tag names (replaces the current set)" })
+      ),
       deadline_hours: f.optional(f.number({ desc: "New deadline, in hours from now. 1 to 720." })),
+      deadline_at: f.optional(
+        f.string({
+          desc: "New absolute deadline (ISO 8601). Wins over deadline_hours; must be in the future and within 720 hours."
+        })
+      ),
       add_impacted_cards: f.optional(
         f.array(f.string(), { desc: "Slugs or ids of cards to block on this decision" })
       ),
@@ -1371,13 +1423,29 @@ var updateDecisionContract = defineToolContract({
     }
   },
   mcp: {
-    description: "Change an open Conveyor decision: extend the deadline, link or unlink impacted cards, cancel it, or reopen a settled one.",
+    description: "Change an open Conveyor decision: fix the question, summary, context or tags, rewrite the options while nobody has voted, move the deadline, link or unlink impacted cards, cancel it, or reopen a settled one.",
     fields: {
       projectId: mcpProjectId,
       decision: f.string({ desc: "Decision slug or id" }),
+      question: f.optional(f.string({ desc: "New question" })),
+      summary: f.optional(f.string({ desc: cardDescriptionDesc("New summary") })),
+      context: f.optional(f.string({ desc: "New markdown background" })),
+      options: f.optional(
+        f.array(agentOption, {
+          min: 2,
+          desc: "Replacement options. Accepted only while the decision has no votes. Send defaultOption with it: the old default no longer exists."
+        })
+      ),
+      defaultOption: f.optional(
+        f.number({ int: true, min: 1, max: 3, desc: "1-based position of the new default" })
+      ),
+      tagNames: f.optional(f.array(f.string(), { desc: "Replacement tag names" })),
       deadlineHours: f.optional(
         f.number({ min: 1, max: 720, desc: "New deadline, in hours from now" })
       ),
+      deadlineAt: f.optional(
+        f.string({ desc: "New absolute deadline (ISO 8601). Wins over deadlineHours." })
+      ),
       addImpactedCards: f.optional(
         f.array(f.string(), { desc: "Slugs or ids of cards to block on this decision" })
       ),
@@ -2376,13 +2444,22 @@ function registerProjectConfigTools(server2, conn2) {
 import { z as z6 } from "zod";
 
 // src/tools/tasks-format.ts
+function formatCompletedMeta(data) {
+  const parts = [];
+  const usage = data.usage;
+  const total = typeof usage === "object" && usage !== null ? usage.totalTokens : void 0;
+  if (typeof total === "number" && total > 0) parts.push(`tokens: ${total}`);
+  if (typeof data.costUsd === "number") parts.push(`cost: $${data.costUsd}`);
+  parts.push(`duration: ${typeof data.durationMs === "number" ? data.durationMs : "?"}ms`);
+  return parts.join(", ");
+}
 var CLI_EVENT_FORMATTERS = {
   thinking: (data) => String(data.message ?? ""),
   tool_use: (data) => `${data.tool}: ${String(data.input ?? "").slice(0, 1e3)}`,
   tool_result: (data) => `${data.tool} \u2192 ${String(data.output ?? "").slice(0, 500)}${data.isError ? " [ERROR]" : ""}`,
   message: (data) => String(data.content ?? ""),
   error: (data) => `ERROR: ${String(data.message ?? "")}`,
-  completed: (data) => `Completed: ${data.summary ?? ""} (cost: $${data.costUsd ?? "?"}, duration: ${data.durationMs ?? "?"}ms)`,
+  completed: (data) => `Completed: ${data.summary ?? ""} (${formatCompletedMeta(data)})`,
   setup_output: (data) => `[${data.stream ?? "stdout"}] ${String(data.data ?? "")}`,
   start_command_output: (data) => `[${data.stream ?? "stdout"}] ${String(data.data ?? "")}`,
   turn_end: (data) => `Turn complete (${Array.isArray(data.toolCalls) ? data.toolCalls.length : 0} tool calls)`
@@ -2406,7 +2483,7 @@ function compactChatMessage(message) {
   return obj;
 }
 function formatLegacyComputeSession(s) {
-  return `  - session ${s.id} [${s.provider}] pod=${s.instanceName ?? "-"} status=${s.status} runner=${s.agentRunnerStatus ?? "-"} lastHeartbeat=${s.lastHeartbeatAt ?? "-"} created=${s.createdAt} stopped=${s.stoppedAt ?? "-"}` + (s.deletionRequestedAt ? ` deletionRequested=${s.deletionRequestedAt} (attempts ${s.deletionAttempts})` : "") + (s.lastAgentEvent ? ` lastAgentEvent=${s.lastAgentEvent}` : "");
+  return `  - session ${s.id} [${s.provider}] pod=${s.instanceName ?? "-"} status=${s.status} runner=${s.agentRunnerStatus ?? "-"} lastHeartbeat=${s.lastHeartbeatAt ?? "-"} created=${s.createdAt} stopped=${s.stoppedAt ?? "-"}` + (s.deletionRequestedAt ? ` deletionRequested=${s.deletionRequestedAt} (attempts ${s.deletionAttempts})` : "") + (s.lastAgentEvent ? ` lastAgentEvent=${s.lastAgentEvent}` : "") + (s.tokenUsage ? ` tokens=${s.tokenUsage.totalTokens} (${s.tokenUsage.turns} turns)` : "");
 }
 function formatWorkspaceSession(s) {
   return `    - workspaceSession ${s.id} role=${s.role} mode=${s.mode} status=${s.status} leaseUntil=${s.leaseUntil ?? "-"} created=${s.createdAt}`;
@@ -2471,7 +2548,7 @@ var STATUS_ENUM2 = [
   "Complete",
   "Cancelled"
 ];
-var CARD_TYPE_ENUM = ["task", "incident", "suggestion"];
+var CARD_TYPE_ENUM = ["task", "incident", "suggestion", "decision"];
 var RISK_ENUM2 = ["critical", "high", "medium", "low"];
 var BOARD_FILTER = z6.string().nullable().optional().describe(
   "Filter to a sub-project board. Omit to use the connection's default board (CONVEYOR_SUBPROJECT_ID) when set, else the whole project; pass null to force the whole project. Use list_accessible_subprojects to find board IDs."
@@ -2483,7 +2560,7 @@ function registerListTasks(server2, conn2) {
   registerHotTool(
     server2,
     "list_tasks",
-    "List project cards, optionally filtered by card type, status, or assignment (a specific assignee, or unassigned tasks). Defaults to type=task \u2014 pass typeFilters to list incidents/suggestions. Results are relevance-ordered: highest priority first then newest; suggestions-only queries rank by upvote score. Pass projectId to target a specific project; otherwise the configured default project is used. Returns summaries \u2014 plan omitted, description truncated; use get_task for full details.",
+    "List project cards, optionally filtered by card type, status, or assignment (a specific assignee, or unassigned tasks). Defaults to type=task \u2014 pass typeFilters to list incidents, suggestions or decisions. Results are relevance-ordered: highest priority first then newest; suggestions-only queries rank by upvote score. Pass projectId to target a specific project; otherwise the configured default project is used. Returns summaries \u2014 plan omitted, description truncated; use get_task for full details.",
     {
       projectId: z6.string().optional().describe("Target Conveyor project ID"),
       status: z6.enum(STATUS_ENUM2).optional().describe("Filter by task status"),
@@ -3029,10 +3106,11 @@ function registerUploadAttachment(server2, conn2) {
         ]
       };
     }
+    const comment = params.comment ?? params.title;
     const result = await conn2.confirmFileUpload(
       params.taskId,
       fileId,
-      params.comment,
+      comment,
       params.projectId,
       params.tags
     );
@@ -3041,6 +3119,11 @@ function registerUploadAttachment(server2, conn2) {
     ];
     if (result.downloadUrl) lines.push(`downloadUrl: ${result.downloadUrl}`);
     if (result.messageId) lines.push("Posted to the task chat.");
+    else if (comment === void 0) {
+      lines.push(
+        "Not posted to the task chat \u2014 pass `comment` (or `title`) to show it in the card thread."
+      );
+    }
     if (result.appliedTags?.length) lines.push(`Tagged: ${result.appliedTags.join(", ")}.`);
     if (result.unknownTags?.length) {
       lines.push(
@@ -3627,6 +3710,13 @@ var TurnEndToolCallSchema = z22.object({
   output: z22.string().optional(),
   timestamp: z22.string().optional()
 }).passthrough();
+var AgentTurnUsageSchema = z22.object({
+  inputTokens: z22.number(),
+  outputTokens: z22.number(),
+  cacheReadInputTokens: z22.number(),
+  cacheCreationInputTokens: z22.number(),
+  totalTokens: z22.number()
+});
 var KnownAgentEventSchema = z22.discriminatedUnion("type", [
   // ── Lifecycle / connection ────────────────────────────────────────────
   z22.object({
@@ -3666,7 +3756,11 @@ var KnownAgentEventSchema = z22.discriminatedUnion("type", [
   z22.object({
     type: z22.literal("completed"),
     summary: z22.string().optional(),
-    durationMs: z22.number().optional()
+    durationMs: z22.number().optional(),
+    /** Tokens this turn consumed, summed from the transcript's assistant
+     *  records. Optional: an older agent build sends none, and the server
+     *  then records nothing rather than zeroing the session's totals. */
+    usage: AgentTurnUsageSchema.optional()
   }).passthrough(),
   z22.object({ type: z22.literal("error"), message: z22.string() }).passthrough(),
   z22.object({ type: z22.literal("agent_typing_start") }).passthrough(),
@@ -5147,6 +5241,10 @@ var CreateProjectDecisionRequestSchema = z11.object({
   sessionId: z11.string().optional(),
   tagNames: z11.array(z11.string().min(1)).max(10).optional(),
   raisedByPr: z11.number().int().positive().optional(),
+  /** Slug or id of the card that raised the question. A link back, not a block. */
+  raisedByCard: z11.string().min(1).optional(),
+  /** Absolute deadline (ISO 8601). Wins over `deadlineHours` when both are sent. */
+  deadlineAt: z11.string().datetime({ offset: true }).optional(),
   requestingUserId: z11.string().optional()
 });
 var ListProjectDecisionsRequestSchema = z11.object({
@@ -5182,7 +5280,16 @@ var ResolveProjectDecisionRequestSchema = z11.object({
 var UpdateProjectDecisionRequestSchema = z11.object({
   projectId: z11.string(),
   decision: z11.string().min(1),
+  question: z11.string().min(1).max(200).optional(),
+  summary: z11.string().max(CARD_DESCRIPTION_MAX).optional(),
+  context: z11.string().min(1).optional(),
+  /** Accepted only while nobody has voted. */
+  options: optionsInput.optional(),
+  defaultOption: z11.number().int().min(1).max(DECISION_OPTIONS_MAX).optional(),
+  tagNames: z11.array(z11.string().min(1)).max(10).optional(),
   deadlineHours,
+  /** Absolute deadline (ISO 8601). Wins over `deadlineHours` when both are sent. */
+  deadlineAt: z11.string().datetime({ offset: true }).optional(),
   addImpactedCards: z11.array(z11.string().min(1)).max(50).optional(),
   removeImpactedCards: z11.array(z11.string().min(1)).max(50).optional(),
   status: z11.enum(["Cancelled", "Open"]).optional(),
@@ -5867,23 +5974,18 @@ function registerDecisionReads(server2, conn2) {
 }
 function registerDecisionWrites(server2, conn2) {
   registerContractTool(server2, createDecisionContract, async (params) => {
-    const { defaultOption, deadlineHours: deadlineHours2, impactedCards, tagNames, raisedByPr, ...rest } = params;
-    const res = await conn2.createDecision({
-      ...rest,
-      defaultOption,
-      deadlineHours: deadlineHours2,
-      impactedCards,
-      tagNames,
-      raisedByPr
-    });
-    const refused = res.refused.length > 0 ? `
-Not linked: ${res.refused.map((r) => `${r.ref} (${r.reason})`).join("; ")}` : "";
+    const res = await conn2.createDecision(params);
+    const { impactedLinked, refused, ...detail } = res;
+    const refusedLine = refused.length > 0 ? `
+Not linked: ${refused.map((r) => `${r.ref} (${r.reason})`).join("; ")}` : "";
     return {
       content: [
         {
           type: "text",
           text: `Raised decision ${res.slug} \u2014 ${res.url}
-Blocking ${res.impactedLinked.length} card(s).${refused}`
+Blocking ${impactedLinked.length} card(s).${refusedLine}
+
+${JSON.stringify(detail, null, 2)}`
         }
       ]
     };

package/dist/{connection-DclP31lm.d.ts → connection-DeBZ_T6f.d.ts}

@@ -585,6 +585,15 @@ declare class ConveyorConnection {
             lastHeartbeatAt: string | null;
             agentRunningAt: string | null;
             lastAgentEvent: string | null;
+            /** Tokens this session's turns consumed, or null when none recorded. */
+            tokenUsage: {
+                inputTokens: number;
+                outputTokens: number;
+                cacheReadInputTokens: number;
+                cacheCreationInputTokens: number;
+                totalTokens: number;
+                turns: number;
+            } | null;
             deletionRequestedAt: string | null;
             deletionAttempts: number;
             createdAt: string;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as ActivePtySession, d as ConveyorConnection, e as ConveyorMcpConfig, P as PtyAttachSnapshot, c as PtyDataChunk } from './connection-DclP31lm.js';
+export { A as ActivePtySession, d as ConveyorConnection, e as ConveyorMcpConfig, P as PtyAttachSnapshot, c as PtyDataChunk } from './connection-DeBZ_T6f.js';
 export { AttachTunnelOptions, ResolvedPtySession, RunTunnelOptions, TunnelConnection, TunnelHandle, TunnelSession, TunnelTty, WaitForPtySessionOptions, attachTunnel, runTunnel, waitForPtySession } from './tunnel.js';
 import 'socket.io-client';
 import '@project/shared';

package/dist/tunnel.d.ts

@@ -1,4 +1,4 @@
-import { A as ActivePtySession, P as PtyAttachSnapshot, c as PtyDataChunk } from './connection-DclP31lm.js';
+import { A as ActivePtySession, P as PtyAttachSnapshot, c as PtyDataChunk } from './connection-DeBZ_T6f.js';
 import 'socket.io-client';
 import '@project/shared';
 

package/dist/wait-runner.d.ts

@@ -1,4 +1,4 @@
-import { C as CardCollectionPage, a as CardCollectionDelta } from './connection-DclP31lm.js';
+import { C as CardCollectionPage, a as CardCollectionDelta } from './connection-DeBZ_T6f.js';
 import { WaitFilter, WaitResult } from './wait.js';
 import 'socket.io-client';
 import '@project/shared';

package/dist/wait.d.ts

@@ -1,4 +1,4 @@
-import { b as CardCollectionItem } from './connection-DclP31lm.js';
+import { b as CardCollectionItem } from './connection-DeBZ_T6f.js';
 import 'socket.io-client';
 import '@project/shared';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rallycry/conveyor-mcp",
-  "version": "5.0.5",
+  "version": "5.0.6",
   "description": "Conveyor MCP server for Claude Code PM integration",
   "keywords": [
     "claude",