@bli-cockpit/mcp 0.1.8 → 0.1.9

package/dist/jarvis-answer-envelope.d.ts

@@ -53,7 +53,7 @@
  * Every key of the envelope, in the order it is written. The literal list IS
  * the contract: both copies assert against it, so a drift is a red suite.
  */
-export declare const JARVIS_ANSWER_ENVELOPE_KEYS: readonly ["ok", "answer", "sources", "turn_id", "thread_id", "trace_thread_id", "proposal_id", "degraded", "degraded_reasons"];
+export declare const JARVIS_ANSWER_ENVELOPE_KEYS: readonly ["ok", "answer", "sources", "turn_id", "thread_id", "trace_thread_id", "proposal_id", "next_action", "degraded", "degraded_reasons"];
 /**
  * One thing that backed the answer (BLI-3770).
  *
@@ -134,8 +134,25 @@ export interface JarvisAnswerEnvelope {
      * could approve with, and that is not approval. The person fetches the code
      * on a surface a person reads and hands it back. Null on every turn that
      * proposed no coding task, which is nearly all of them.
+     *
+     * BLI-3787: a null here is never on its own. When the arm ran at all,
+     * `next_action` below says what happened and what a person has to do — the
+     * field was `null` on every proposing turn for two QA ticks while the answer
+     * told the caller to spend an id nothing had issued.
      */
     proposal_id: string | null;
+    /**
+     * BLI-3787: what has to happen next, in a sentence naming an action a
+     * PERSON takes.
+     *
+     * Today only the coding arm produces one, and it is what makes
+     * `proposal_id`'s absence readable: "ask them to fetch the code for proposal
+     * X", "nothing was dispatched and no proposal was recorded, a person has to
+     * approve this where a person reads", "that approval code has already been
+     * used". Null on every turn that never reached the arm, which is nearly all
+     * of them — and never a substitute for the answer itself.
+     */
+    next_action: string | null;
     degraded: boolean;
     degraded_reasons: JarvisDegradedReason[];
 }
@@ -173,6 +190,13 @@ export interface JarvisAnswerEnvelopeInput {
     }> | null;
     /** `body.proposalId` — BLI-3755's coding-arm proposal id, when the turn made one. */
     proposalId?: string | null;
+    /**
+     * `body.nextAction` — BLI-3787's sentence for what a person must do next
+     * about the coding arm. Absent from a dashboard that predates it, which is
+     * why an older deployment reads as `next_action: null` rather than as a
+     * turn that said nothing.
+     */
+    nextAction?: string | null;
     /**
      * `body.sources` — BLI-3770's structured citations, straight from the door.
      * Typed as `unknown` on purpose: this is another process's JSON, and the

package/dist/jarvis-answer-envelope.js

@@ -61,6 +61,7 @@ export const JARVIS_ANSWER_ENVELOPE_KEYS = [
     "thread_id",
     "trace_thread_id",
     "proposal_id",
+    "next_action",
     "degraded",
     "degraded_reasons",
 ];
@@ -197,6 +198,7 @@ export function buildJarvisAnswerEnvelope(input) {
         thread_id: input.thread ?? null,
         trace_thread_id: input.traceThread ?? null,
         proposal_id: input.proposalId ?? null,
+        next_action: input.nextAction ?? null,
         degraded: reasons.length > 0,
         degraded_reasons: reasons,
     };

package/dist/jarvis-door.js

@@ -110,6 +110,9 @@ export async function takeTurn(deps, session, door, body, remember) {
         revised: reply.revised,
         trace: reply.trace,
         proposalId: reply.proposalId,
+        // BLI-3787: the sentence beside it, so a refusal names what a person must
+        // do rather than arriving as a bare `proposal_id: null`.
+        nextAction: reply.nextAction,
         // BLI-3770: the door's own structured citations, when it sent them.
         sources: reply.sources,
     });
@@ -122,6 +125,9 @@ export async function takeTurn(deps, session, door, body, remember) {
         // BLI-3755: whether this turn left a coding-arm proposal behind. The id
         // itself is in the envelope; this line says one was made.
         proposal_recorded: envelope.proposal_id !== null,
+        // BLI-3787: whether this turn said what to do next. A turn that reached
+        // the coding arm and said nothing is the defect, and it is visible here.
+        next_action_present: envelope.next_action !== null,
         degraded: envelope.degraded,
         degraded_reasons: envelope.degraded_reasons,
         has_turn_id: envelope.turn_id !== null,
@@ -134,6 +140,9 @@ export async function takeTurn(deps, session, door, body, remember) {
             ? `proposal_id: ${envelope.proposal_id} — the person fetches the approval code for it themself, `
                 + `in a Tower tab, their Slack DM, or their own \`cockpit jarvis\` terminal. You were not sent one.`
             : null,
+        // BLI-3787: printed whether or not there is a proposal id, because the
+        // turns that made none are exactly the ones a caller could not read.
+        envelope.next_action ? `next_action: ${envelope.next_action}` : null,
         envelope.degraded ? `degraded: ${envelope.degraded_reasons.join(", ")}` : null,
     ]
         .filter((line) => line !== null)

package/dist/jarvis-tools.js

@@ -78,13 +78,16 @@ export function registerJarvisTools(server, deps) {
     register("jarvis_ask", {
         title: "Ask JARVIS",
         description: "Asks JARVIS one question and returns its answer, the Source: lines behind it, this turn's "
-            + "turn_id and the conversation's thread_id. Same JARVIS, same tool belt and same evidence "
+            + "turn_id, the conversation's thread_id, and — when the turn reached the coding arm — a "
+            + "proposal_id and a next_action sentence. Same JARVIS, same tool belt and same evidence "
             + "rules as Tower web chat, the Slack DM and `cockpit jarvis`. A thread is SINGLE-WRITER: "
             + "omit thread and this turn gets a FRESH conversation of its own, so two questions asked at "
             + "the same time can never read each other's; pass the thread_id the answer returned to "
             + "continue that conversation deliberately. Pass the returned turn_id to jarvis_trace to see "
             + "how the answer was reached. JARVIS speaks as the person this machine is paired to and "
-            + "cannot be made to speak as anyone else.",
+            + "cannot be made to speak as anyone else. proposal_id is null on every turn that proposed no "
+            + "coding task, including one the arm refused; next_action is the sentence saying which it "
+            + "was and what a PERSON has to do about it, so a null proposal_id is never on its own.",
         inputSchema: {
             question: z.string().min(1).max(50_000).describe("What to ask, in plain words."),
             thread: z
@@ -194,10 +197,13 @@ export function registerJarvisTools(server, deps) {
             + "approval_code: you get the plan and a proposal_id back, and DELIBERATELY no code — a code "
             + "you can read is a code you could approve with. Show the person the plan and the "
             + "proposal_id and ask them to fetch the code themself, in a Tower browser tab, their Slack "
-            + "DM with JARVIS, or their own `cockpit jarvis` terminal. Then call this again with the code "
+            + "DM with JARVIS, or their own interactive `cockpit jarvis`. Then call this again with the code "
             + "THEY give you and the same instruction. A code approves exactly ONE run: a reused one is "
             + "refused (approval_code_spent) and the answer is a fresh approval, never a retry. Never "
-            + "derive, guess, or reuse a code the person has not just handed you.",
+            + "derive, guess, or reuse a code the person has not just handed you. If the answer comes "
+            + "back with no proposal_id, read next_action: the arm refused rather than proposed, and it "
+            + "names what a person has to do — never send a proposal_id back to JARVIS yourself, this is "
+            + "the surface it was withheld from and the read-back is refused here.",
         inputSchema: {
             instruction: z
                 .string()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/mcp",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "private": false,
   "description": "bli-tower — an MCP server over BLI Cockpit's agent doors: JARVIS (jarvis_*), documents (docs_*), channels (msg_*), issues (work_*), the daily page (brief_*), meeting notes (notes_*), the ops board (ops_status/slack_*), settings/team/model, Scout and the workbook, plus the legacy event-stream tools (emit_event, get_ticket_timeline, get_active_tickets).",
   "type": "module",