@glie/mcp-polaris 0.20.0 → 0.21.0

package/README.md

@@ -63,7 +63,9 @@ approval Release Candidate flow), `polaris.agent.*`, `polaris.team.*`,
 `open`, `transition`, `add_task`). N tickets can dedup onto one issue, and one issue
 fans out into N tasks. A reply carries files through `attachment_ids`: upload each
 one to `POST /api/tickets/:id/attachments` first (this server does not carry bytes),
-then paste its `marker` into `body_md` to draw it inside the message.
+then paste its `marker` into `body_md` to draw it inside the message. `reply` with
+`internal: true` writes an internal NOTE instead: what you checked or suspect, in the
+thread for whoever works the ticket next and never sent to the customer.
 
 **Context, read-only.** `polaris.activity.list` (what happened),
 `polaris.chat.get` / `polaris.chat.messages` (comments agents left on a scope),

package/dist/index.js

@@ -30,7 +30,7 @@ var INLINE_MIMES = new Set([
 ]);
 
 // ../../src/mcp/index.ts
-var VERSION = "0.20.0";
+var VERSION = "0.21.0";
 var FRAMEWORK_KEY_DOC = "optional \u2014 a key from polaris.framework.list. Leave it out when none applies: a framework is for founding a large domain, and most milestones take none. An unknown key is refused (400) with the keys that exist.";
 var BASE = process.env.POLARIS_URL ?? "http://127.0.0.1:7843";
 var TOKEN = process.env.POLARIS_TOKEN ?? "";
@@ -118,6 +118,7 @@ var INSTRUCTIONS = [
   '\u2022 "This milestone was only a hunch" \u2192 polaris.milestone.demote \u2014 back to the idea list, only while it has no tasks (human-only)',
   `\u2022 "Triage support / what's waiting?" \u2192 polaris.ticket.list (status, project_key) \u2014 P1 first`,
   '\u2022 "Reply to a customer / hand off"  \u2192 polaris.ticket.reply then polaris.ticket.pass(to)',
+  '\u2022 "Leave the next person a note"    \u2192 polaris.ticket.reply with internal=true \u2014 what you checked or suspect, in the thread, never sent to the customer (it moves no counter, no ball, no status)',
   '\u2022 "Turn a report into work"         \u2192 polaris.ticket.frame_issue \u2192 polaris.issue.add_task \xD7N (framing is HUMAN-only; the helpdesker proposes it)',
   '\u2022 "Same bug reported again"         \u2192 polaris.ticket.link_issue (dedup onto the open issue; HUMAN-only) \u2192 say we already have it \u2192 close the duplicate ticket',
   "",
@@ -699,12 +700,17 @@ var TOOLS = [
         type: "array",
         items: { type: "integer" },
         description: "Ids from the attachment upload above (or from ticket.attachment_list, where sent=false). They ride on THIS message and become visible with it."
+      },
+      internal: {
+        type: "boolean",
+        description: "true writes an INTERNAL NOTE instead of a reply: it lands in the thread for whoever works the ticket next (what you checked, what you suspect, what you did elsewhere) and is never sent to the customer. A note is not part of the conversation, so it moves no counter, no ball and no status. Always on the team side."
       }
     }, ["id", "body_md"]),
     call: async (args) => (await apiCall("POST", `/api/tickets/${args.id}/messages`, {
       body_md: args.body_md,
       side: args.side,
-      attachment_ids: args.attachment_ids
+      attachment_ids: args.attachment_ids,
+      internal: args.internal
     })).body
   },
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glie/mcp-polaris",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Model Context Protocol (stdio) server exposing Polaris, glie's ops platform, as native tools in Claude Code and any MCP client.",
   "license": "Apache-2.0",
   "author": "glie <carlos@glie.ai>",