@orboto/mcp 0.186.0 → 0.187.0

package/dist/manifest-size.test.js

@@ -63,7 +63,9 @@ afterEach(() => { vi.restoreAllMocks(); });
 // (286 chars); the remaining ~4.2k chars are input/output schemas and the
 // per-tool keys the SDK emits. Decision by the operator, 2026-09-06.
 const CURATED_MAX_CHARS = 37_500;
-const FULL_MAX_CHARS = 155_000;
+// ORB-2000 - orboto_draft_customer_reply joins the full tier (measured
+// 155,669 chars with it); ceiling re-pinned with ~6 % headroom.
+const FULL_MAX_CHARS = 165_000;
 /**
  * ORB-1805 - the estimator the ticket measured the failure with
  * (`n_keep: 13533 >= n_ctx: 8192` in LM Studio): characters / 3.6. It is

package/dist/server.js

@@ -23,6 +23,7 @@ import { registerWithMetrics } from './with-metrics.js';
 import { resolveToolset, toolInToolset } from './toolset.js';
 import { createNudgeState } from './session-nudge.js';
 import { aiStatusToolConfig, makeAiStatusHandler } from './tools/ai-status.js';
+import { draftCustomerReplyToolConfig, makeDraftCustomerReplyHandler } from './tools/customer-draft.js';
 import { embeddingStatusToolConfig, makeEmbeddingStatusHandler } from './tools/embedding-status.js';
 import { aiUsageToolConfig, makeAiUsageHandler } from './tools/ai-usage.js';
 import { sessionStartToolConfig, makeSessionStartHandler } from './tools/session-start.js';
@@ -264,6 +265,7 @@ export async function buildOrbotoMcpServer(opts) {
     // Tools - alphabetical-ish by concept. Each tool file owns its
     // input/output schema; the server just glues names to handlers.
     reg('orboto_ai_status', aiStatusToolConfig, makeAiStatusHandler(client));
+    reg('orboto_draft_customer_reply', draftCustomerReplyToolConfig, makeDraftCustomerReplyHandler(client)); // ORB-2000
     reg('orboto_embedding_status', embeddingStatusToolConfig, makeEmbeddingStatusHandler(client));
     reg('orboto_ai_usage', aiUsageToolConfig, makeAiUsageHandler(client));
     // ORB-1093 - session-start / post-compact re-orientation digest.

package/dist/tools/customer-draft.js

@@ -0,0 +1,41 @@
+/**
+ * ORB-2000 - orboto_draft_customer_reply: a customer-facing DRAFT for a
+ * ticket, built server-side from customer-safe facts only (ticket key,
+ * title, status, due date, customer summary, non-internal comments, the
+ * caller's ask) - never from the internal description or internal
+ * comments. Returns the draft plus the facts-used list and what was left
+ * out. It never posts: the agent shows the draft and posts it only with
+ * orboto_comment after the user approved the text.
+ */
+import { z } from 'zod';
+import { resolveTicketByKey } from './shared.js';
+export const draftCustomerReplyToolConfig = {
+    title: 'Draft a customer-facing reply for a ticket',
+    description: 'Draft a reply or status update for a CUSTOMER / external reader about a ticket (by key), built server-side from customer-safe facts only (key, title, status, due date, customer summary, non-internal comments, your `ask`) - never from internal notes. Returns the draft, the facts used and what was excluded. Never posts: show it to the user, then `orboto_comment` only after approval. Use it for every customer-facing text.',
+    inputSchema: z.object({
+        ticketKey: z.string().describe('Ticket key like "ORB-42".'),
+        ask: z.string().min(3).max(1000).describe('What the reply should do, in the user\'s words, e.g. "tell them the fix ships with the next release" or "ask for the browser version".'),
+    }).shape,
+    outputSchema: z.object({
+        draft: z.string(),
+        factsUsed: z.array(z.object({ source: z.string(), text: z.string() })),
+        excluded: z.object({ internalComments: z.number(), internalDescription: z.boolean() }),
+    }).shape,
+    annotations: { readOnlyHint: true, idempotentHint: false },
+};
+export function makeDraftCustomerReplyHandler(client) {
+    return async ({ ticketKey, ask }) => {
+        const ticket = await resolveTicketByKey(client, ticketKey);
+        const res = await client.post('/ai/draft-customer-reply', { ticketId: ticket.id, ask });
+        const lines = [`Draft for ${ticketKey} (not posted - show it to the user first):`, '', res.draft.trim(), '', 'Facts used:'];
+        for (const f of res.factsUsed)
+            lines.push(`  - ${f.source}: ${f.text.length > 160 ? f.text.slice(0, 160) + '...' : f.text}`);
+        if (res.excluded.internalComments > 0 || res.excluded.internalDescription) {
+            lines.push('', `Left out on purpose: ${res.excluded.internalComments} internal comment(s)${res.excluded.internalDescription ? ' and the internal description' : ''}.`);
+        }
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+            structuredContent: { draft: res.draft, factsUsed: res.factsUsed, excluded: res.excluded },
+        };
+    };
+}

package/dist/tools/customer-draft.test.js

@@ -0,0 +1,37 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { OrbotoClient } from '../orboto-client.js';
+import { makeDraftCustomerReplyHandler } from './customer-draft.js';
+beforeEach(() => { vi.restoreAllMocks(); });
+afterEach(() => { vi.restoreAllMocks(); });
+function stubJSON(responses) {
+    const calls = [];
+    vi.spyOn(globalThis, 'fetch').mockImplementation(async (url, init) => {
+        calls.push({ url: url.toString(), method: init?.method ?? 'GET', body: typeof init?.body === 'string' ? JSON.parse(init.body) : init?.body });
+        const r = responses.shift();
+        if (!r)
+            throw new Error('unexpected extra fetch');
+        return { ok: r.ok ?? true, status: r.status ?? 200, statusText: 'OK', json: async () => ('json' in r ? r.json : {}), text: async () => '' };
+    });
+    return calls;
+}
+const client = new OrbotoClient({ baseUrl: 'https://orboto.example.com', apiKey: 'orb_x' });
+describe('orboto_draft_customer_reply (ORB-2000)', () => {
+    it('resolves the ticket key, POSTs the ask and renders draft + facts + exclusions', async () => {
+        const calls = stubJSON([
+            { json: { id: 'p1', key: 'ORB', name: 'orboto' } },
+            { json: { id: 't1', ticketKey: 'ORB-42', title: 'Blank page after payment' } },
+            { json: {
+                    draft: 'Thanks for the report - the blank page after payment is confirmed. We will follow up on the timeline.',
+                    factsUsed: [{ source: 'ticket.title', text: 'Blank page after payment' }, { source: 'user.ask', text: 'confirm it' }],
+                    excluded: { internalComments: 2, internalDescription: true },
+                } },
+        ]);
+        const res = await makeDraftCustomerReplyHandler(client)({ ticketKey: 'ORB-42', ask: 'confirm it' });
+        expect(calls[2]).toMatchObject({ method: 'POST', url: 'https://orboto.example.com/ai/draft-customer-reply', body: { ticketId: 't1', ask: 'confirm it' } });
+        const text = res.content[0].text;
+        expect(text).toContain('not posted');
+        expect(text).toContain('ticket.title');
+        expect(text).toContain('2 internal comment(s) and the internal description');
+        expect(res.structuredContent).toMatchObject({ excluded: { internalComments: 2, internalDescription: true } });
+    });
+});

package/dist/tools/docs-ai.js

@@ -53,6 +53,8 @@ export function makeAskDocsHandler(client) {
                 lines.push(`  [${c.index}] ${spaceTag}${c.title}  ${c.link}`);
             }
         }
+        if (res.abstained)
+            lines.push('', '(abstained: no claim in the answer could be tied to a retrieved doc - treat as "not in the docs", do not guess)');
         lines.push('', `(retrieval mode: ${res.mode})`);
         return {
             content: [{ type: 'text', text: lines.join('\n') }],
@@ -60,6 +62,7 @@ export function makeAskDocsHandler(client) {
                 answer: res.answer,
                 citations: res.citations,
                 mode: res.mode,
+                abstained: res.abstained ?? false,
             },
         };
     };

package/dist/tools/docs-ai.test.js

@@ -45,6 +45,7 @@ describe('orboto_ask_docs', () => {
                         { index: 1, title: 'Queue worker', link: '/docs/queue', spaceName: 'Runbooks' },
                     ],
                     mode: 'rag',
+                    abstained: false,
                 } },
         ]);
         const res = await makeAskDocsHandler(client)({
@@ -65,8 +66,15 @@ describe('orboto_ask_docs', () => {
         expect(res.structuredContent).toMatchObject({
             answer: 'The retry backoff is 200ms × 2^n.',
             mode: 'rag',
+            abstained: false,
         });
     });
+    it('ORB-1999 - marks an abstained answer in text and structured content', async () => {
+        stubJSON([{ json: { answer: "I couldn't find that in the sources provided.", citations: [], mode: 'empty', abstained: true } }]);
+        const res = await makeAskDocsHandler(client)({ question: 'What is the office wifi password?' });
+        expect(res.content[0].text).toContain('(abstained:');
+        expect(res.structuredContent).toMatchObject({ abstained: true, mode: 'empty' });
+    });
     it('surfaces a 400 (AI not configured) as OrbotoApiError', async () => {
         stubJSON([
             { ok: false, status: 400, json: { error: 'ai_provider_not_configured' } },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orboto/mcp",
-  "version": "0.186.0",
+  "version": "0.187.0",
   "description": "Model Context Protocol server for orboto - exposes tickets, projects, milestones, time, docs, primer-facts, alerts and absences as MCP tools for Claude Desktop / Cursor / Copilot Chat / any MCP-aware AI client.",
   "license": "MIT",
   "type": "module",