@agentskit/doc-bridge 1.2.4 → 1.2.6

package/dist/index.d.ts

@@ -1535,7 +1535,11 @@ type McpContext = {
 };
 declare const MCP_TOOLS: readonly [{
     readonly name: "handoff.resolve";
-    readonly description: "Resolve a package or ownership id to an AgentHandoff.";
+    readonly title: "Resolve repository handoff";
+    readonly description: "Resolve a package or ownership id to its deterministic AgentHandoff.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -1551,7 +1555,11 @@ declare const MCP_TOOLS: readonly [{
     };
 }, {
     readonly name: "doc.search";
-    readonly description: "Search the deterministic doc-bridge index.";
+    readonly title: "Search repository documentation";
+    readonly description: "Search the deterministic Doc Bridge index for repository documentation.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -1566,7 +1574,11 @@ declare const MCP_TOOLS: readonly [{
     };
 }, {
     readonly name: "doc.get";
-    readonly description: "Read an indexed agent documentation file by id or path.";
+    readonly title: "Read indexed documentation";
+    readonly description: "Read one indexed agent documentation file by id or indexed path.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -1580,14 +1592,22 @@ declare const MCP_TOOLS: readonly [{
     };
 }, {
     readonly name: "gate.status";
-    readonly description: "Run the index-freshness gate.";
+    readonly title: "Check documentation gates";
+    readonly description: "Evaluate documentation gates without writing files.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {};
     };
 }, {
     readonly name: "retriever.query";
-    readonly description: "Return local doc-bridge retriever chunks for a query.";
+    readonly title: "Retrieve documentation context";
+    readonly description: "Return relevant local Doc Bridge index chunks for a query.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -1602,21 +1622,33 @@ declare const MCP_TOOLS: readonly [{
     };
 }, {
     readonly name: "memory.classify";
-    readonly description: "Classify local memory candidates into agent/human/playbook/discard routes.";
+    readonly title: "Classify memory candidates";
+    readonly description: "Classify local memory candidates into agent, human, playbook, or discard routes.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {};
     };
 }, {
     readonly name: "memory.promoteDraft";
-    readonly description: "Build a safe draft promotion body for local memory candidates.";
+    readonly title: "Draft memory promotion";
+    readonly description: "Build a reviewable draft promotion body from local memory candidates without publishing it.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {};
     };
 }, {
     readonly name: "registry.topology";
-    readonly description: "Return the doc-curator registry topology.";
+    readonly title: "Inspect registry topology";
+    readonly description: "Return the static Doc Bridge curator and delegate topology.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {};
@@ -1813,7 +1845,7 @@ declare const chunksFromMarkdown: (property: string, raw: string, sourceUrl: str
 declare const loadFederatedChunks: (root: string, config: DocBridgeConfigV1, options?: FederatedRetrieverOptions) => Promise<DocBridgeRetrievedChunk[]>;
 declare const retrieveHybridChunks: (root: string, config: DocBridgeConfigV1, index: DocBridgeIndexV1, query: string, options?: FederatedRetrieverOptions) => Promise<DocBridgeRetrievedChunk[]>;
 
-declare const PACKAGE_VERSION = "1.2.4";
+declare const PACKAGE_VERSION = "1.2.6";
 
 type FrontmatterValue = string | boolean | readonly string[];
 type FrontmatterData = Record<string, FrontmatterValue>;

package/dist/index.js

@@ -1534,7 +1534,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "1.2.4";
+var PACKAGE_VERSION = "1.2.6";
 
 // src/index-builder/capabilities.ts
 var renderCapabilitiesJson = (config, index, paths) => {
@@ -3130,7 +3130,9 @@ var runQuery = (index, config, req) => {
 var MCP_TOOLS = [
   {
     name: "handoff.resolve",
-    description: "Resolve a package or ownership id to an AgentHandoff.",
+    title: "Resolve repository handoff",
+    description: "Resolve a package or ownership id to its deterministic AgentHandoff.",
+    annotations: { readOnlyHint: true },
     inputSchema: {
       type: "object",
       properties: { id: { type: "string" }, kind: { type: "string", enum: ["package", "ownership"] } },
@@ -3139,7 +3141,9 @@ var MCP_TOOLS = [
   },
   {
     name: "doc.search",
-    description: "Search the deterministic doc-bridge index.",
+    title: "Search repository documentation",
+    description: "Search the deterministic Doc Bridge index for repository documentation.",
+    annotations: { readOnlyHint: true },
     inputSchema: {
       type: "object",
       properties: { term: { type: "string" }, limit: { type: "number" } },
@@ -3148,7 +3152,9 @@ var MCP_TOOLS = [
   },
   {
     name: "doc.get",
-    description: "Read an indexed agent documentation file by id or path.",
+    title: "Read indexed documentation",
+    description: "Read one indexed agent documentation file by id or indexed path.",
+    annotations: { readOnlyHint: true },
     inputSchema: {
       type: "object",
       properties: { id: { type: "string" }, path: { type: "string" } }
@@ -3156,12 +3162,16 @@ var MCP_TOOLS = [
   },
   {
     name: "gate.status",
-    description: "Run the index-freshness gate.",
+    title: "Check documentation gates",
+    description: "Evaluate documentation gates without writing files.",
+    annotations: { readOnlyHint: true },
     inputSchema: { type: "object", properties: {} }
   },
   {
     name: "retriever.query",
-    description: "Return local doc-bridge retriever chunks for a query.",
+    title: "Retrieve documentation context",
+    description: "Return relevant local Doc Bridge index chunks for a query.",
+    annotations: { readOnlyHint: true },
     inputSchema: {
       type: "object",
       properties: { query: { type: "string" }, limit: { type: "number" } },
@@ -3170,17 +3180,23 @@ var MCP_TOOLS = [
   },
   {
     name: "memory.classify",
-    description: "Classify local memory candidates into agent/human/playbook/discard routes.",
+    title: "Classify memory candidates",
+    description: "Classify local memory candidates into agent, human, playbook, or discard routes.",
+    annotations: { readOnlyHint: true },
     inputSchema: { type: "object", properties: {} }
   },
   {
     name: "memory.promoteDraft",
-    description: "Build a safe draft promotion body for local memory candidates.",
+    title: "Draft memory promotion",
+    description: "Build a reviewable draft promotion body from local memory candidates without publishing it.",
+    annotations: { readOnlyHint: true },
     inputSchema: { type: "object", properties: {} }
   },
   {
     name: "registry.topology",
-    description: "Return the doc-curator registry topology.",
+    title: "Inspect registry topology",
+    description: "Return the static Doc Bridge curator and delegate topology.",
+    annotations: { readOnlyHint: true },
     inputSchema: { type: "object", properties: {} }
   }
 ];
@@ -3297,13 +3313,14 @@ var handleMcpRequest = (ctx, request) => {
   if (request.method?.startsWith("notifications/")) return void 0;
   throw new Error(`Unsupported MCP method "${request.method ?? ""}"`);
 };
-var writeFrame = (payload) => {
+var writeFrame = (payload, framing) => {
   const body = JSON.stringify(payload);
-  process.stdout.write(`Content-Length: ${Buffer.byteLength(body)}\r
+  process.stdout.write(framing === "json-line" ? `${body}
+` : `Content-Length: ${Buffer.byteLength(body)}\r
 \r
 ${body}`);
 };
-var respond = (ctx, request) => {
+var respond = (ctx, request, framing) => {
   if (request.id === void 0) {
     try {
       handleMcpRequest(ctx, request);
@@ -3313,13 +3330,13 @@ var respond = (ctx, request) => {
   }
   try {
     const result = handleMcpRequest(ctx, request);
-    writeFrame({ jsonrpc: "2.0", id: request.id, result: result ?? {} });
+    writeFrame({ jsonrpc: "2.0", id: request.id, result: result ?? {} }, framing);
   } catch (error) {
     writeFrame({
       jsonrpc: "2.0",
       id: request.id,
       error: { code: -32e3, message: error instanceof Error ? error.message : String(error) }
-    });
+    }, framing);
   }
 };
 var startMcpStdioServer = (ctx) => {
@@ -3327,21 +3344,34 @@ var startMcpStdioServer = (ctx) => {
   process.stdin.on("data", (chunk) => {
     buffer = Buffer.concat([buffer, chunk]);
     while (true) {
-      const headerEnd = buffer.indexOf("\r\n\r\n");
-      if (headerEnd === -1) return;
-      const header = buffer.subarray(0, headerEnd).toString("utf8");
-      const match = /content-length:\s*(\d+)/i.exec(header);
-      if (!match?.[1]) {
-        buffer = buffer.subarray(headerEnd + 4);
+      if (/^content-length:/i.test(buffer.subarray(0, Math.min(buffer.length, 32)).toString("utf8"))) {
+        const headerEnd = buffer.indexOf("\r\n\r\n");
+        if (headerEnd === -1) return;
+        const header = buffer.subarray(0, headerEnd).toString("utf8");
+        const match = /content-length:\s*(\d+)/i.exec(header);
+        if (!match?.[1]) {
+          buffer = buffer.subarray(headerEnd + 4);
+          continue;
+        }
+        const length = Number(match[1]);
+        const bodyStart = headerEnd + 4;
+        const bodyEnd = bodyStart + length;
+        if (buffer.length < bodyEnd) return;
+        const raw2 = buffer.subarray(bodyStart, bodyEnd).toString("utf8");
+        buffer = buffer.subarray(bodyEnd);
+        respond(ctx, JSON.parse(raw2), "content-length");
         continue;
       }
-      const length = Number(match[1]);
-      const bodyStart = headerEnd + 4;
-      const bodyEnd = bodyStart + length;
-      if (buffer.length < bodyEnd) return;
-      const raw = buffer.subarray(bodyStart, bodyEnd).toString("utf8");
-      buffer = buffer.subarray(bodyEnd);
-      respond(ctx, JSON.parse(raw));
+      const lineEnd = buffer.indexOf("\n");
+      if (lineEnd === -1) return;
+      const raw = buffer.subarray(0, lineEnd).toString("utf8").trim();
+      buffer = buffer.subarray(lineEnd + 1);
+      if (!raw) continue;
+      try {
+        respond(ctx, JSON.parse(raw), "json-line");
+      } catch {
+        writeFrame({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error" } }, "json-line");
+      }
     }
   });
   process.stdin.resume();