mindgraph-mcp 0.16.0 → 0.17.0

package/dist/index.js

@@ -777,13 +777,13 @@ function codeRefIdentityKey(ref) {
 
 // src/code-tool.ts
 var ok = (data) => ({
-  content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+  content: [{ type: "text", text: JSON.stringify(data) }]
 });
 var err = (code, message, details) => ({
   content: [
     {
       type: "text",
-      text: JSON.stringify({ error: message, code, details }, null, 2)
+      text: JSON.stringify({ error: message, code, details })
     }
   ],
   isError: true
@@ -1272,7 +1272,7 @@ var import_node_crypto3 = __toESM(require("crypto"));
 var import_node_fs3 = __toESM(require("fs"));
 var import_node_path3 = __toESM(require("path"));
 var ok2 = (data) => ({
-  content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+  content: [{ type: "text", text: JSON.stringify(data) }]
 });
 var err2 = (code, message) => ({
   content: [{ type: "text", text: JSON.stringify({ code, error: message }) }],
@@ -1502,12 +1502,23 @@ function clip(value, max, state) {
 }
 function isNodeShaped(value) {
   const node = obj(value);
-  return Boolean(node && str(node.uid) && (str(node.label) || str(node.node_type)));
+  return Boolean(
+    node && str(node.uid) && (str(node.label) || str(node.node_type) || obj(node.node_type))
+  );
+}
+function nodeDisplayType(node) {
+  const props = obj(node.props);
+  const plain = str(node.node_type);
+  return (plain && plain !== "Custom" ? plain : void 0) ?? str(obj(node.node_type)?.Custom) ?? str(props?.object_type) ?? str(props?.type_name) ?? str(obj(props?.data)?.domain_type) ?? plain ?? "Node";
+}
+function nodeFields(node) {
+  const props = obj(node.props);
+  return obj(props?.fields) ?? obj(obj(props?.data)?.fields);
 }
 function unwrapSearchResult(value) {
   if (isNodeShaped(value)) return value;
   const wrapper = obj(value);
-  const inner = obj(wrapper?.node);
+  const inner = obj(wrapper?.node) ?? obj(wrapper?.object);
   if (inner && isNodeShaped(inner)) {
     const score = num(wrapper.score);
     return score !== void 0 ? { ...inner, retrieval_score: score } : inner;
@@ -1545,7 +1556,7 @@ function sourceTag(node) {
   return `from: ${title}${extra}`;
 }
 function layer7Fields(node, state) {
-  const fields = obj(obj(node.props)?.fields);
+  const fields = nodeFields(node);
   if (!fields) return void 0;
   const pairs = Object.entries(fields).filter(([, value]) => value !== null && value !== void 0 && value !== "").map(([key, value]) => `${key}: ${Array.isArray(value) ? value.join(", ") : String(value)}`);
   if (pairs.length === 0) return void 0;
@@ -1557,7 +1568,7 @@ function nodeSummaryText(node, state) {
 }
 function nodeLines(node, state) {
   const label = clip(node.label, LABEL_MAX, state) || "(unlabeled)";
-  const type = str(node.node_type) || "Node";
+  const type = nodeDisplayType(node);
   const confidence = num(node.confidence);
   const score = num(node.retrieval_score);
   const parenthetical = [
@@ -1576,19 +1587,19 @@ function nodeLines(node, state) {
   if (source) lines.push(`  - ${source}`);
   const believers = Array.isArray(node.believed_by) ? node.believed_by : [];
   if (believers.length > 0) {
-    const rendered = believers.slice(0, 3).map((raw) => {
+    const rendered2 = believers.slice(0, 3).map((raw) => {
       const believer = obj(raw);
       const conf = num(believer?.confidence);
       return `${str(believer?.agent_label) || "?"}${conf !== void 0 ? ` (${conf})` : ""}`;
     }).join(", ");
-    lines.push(`  - believed by: ${rendered}`);
+    lines.push(`  - believed by: ${rendered2}`);
   }
   return lines.join("\n");
 }
 function groupedNodeSections(nodes, state, headingPrefix = "") {
   const groups = /* @__PURE__ */ new Map();
   for (const node of nodes) {
-    const type = str(node.node_type) || "Node";
+    const type = nodeDisplayType(node);
     const group = groups.get(type) ?? [];
     group.push(node);
     groups.set(type, group);
@@ -1604,7 +1615,7 @@ function groupedNodeSections(nodes, state, headingPrefix = "") {
   }
   return sections;
 }
-function relationshipItems(edges, labelByUid, state) {
+function relationshipItems(edges, labelByUid, state, options) {
   const lines = [];
   for (const raw of edges) {
     const edge = obj(raw);
@@ -1614,8 +1625,8 @@ function relationshipItems(edges, labelByUid, state) {
     const to = str(edge.to_uid);
     if (CURATION_EDGE_TYPES.has(type)) continue;
     if (!from || !to || from === to) continue;
-    const fromLabel = labelByUid.get(from);
-    const toLabel = labelByUid.get(to);
+    const fromLabel = labelByUid.get(from) ?? (options?.fallbackToUid ? `[${from}]` : void 0);
+    const toLabel = labelByUid.get(to) ?? (options?.fallbackToUid ? `[${to}]` : void 0);
     if (!fromLabel || !toLabel) continue;
     lines.push(`- ${fromLabel} \u2014${type}\u2192 ${toLabel}`);
   }
@@ -1658,8 +1669,8 @@ function assemble(header, sections, state) {
       sectionUsed += marker.length + 1;
     }
     lines.push(
-      section.items.length === 0 ? section.heading : `${section.heading}
-${kept.join("\n")}`
+      section.items.length === 0 ? section.heading : section.heading ? `${section.heading}
+${kept.join("\n")}` : kept.join("\n")
     );
     used += headingCost + sectionUsed;
   }
@@ -1822,6 +1833,157 @@ function renderTraversal(response) {
   }
   return assemble("# Graph traversal", sections, state);
 }
+function neighborLine(value) {
+  const node = obj(value);
+  if (!node) return void 0;
+  const label = str(node.label) || "(unlabeled)";
+  const uid = str(node.uid);
+  const type = str(node.node_type);
+  return `- ${label}${uid ? ` [${uid}]` : ""}${type ? ` (${type})` : ""}`;
+}
+function renderOntologyAnswer(response) {
+  const payload = obj(response);
+  if (!payload) return void 0;
+  const objects = Array.isArray(payload.objects) ? payload.objects.filter(isNodeShaped) : isNodeShaped(payload.object) ? [payload.object] : [];
+  const cognitive = obj(payload.cognitive_context);
+  const provenance = Array.isArray(payload.provenance) ? payload.provenance : [];
+  const hasQuerySignature = Array.isArray(payload.objects) || obj(payload.confidence) !== void 0;
+  const cognitiveEmpty = !cognitive || Object.values(cognitive).every((v) => !Array.isArray(v) || v.length === 0);
+  if (objects.length === 0 && cognitiveEmpty && provenance.length === 0) {
+    return hasQuerySignature ? "No matching domain objects." : void 0;
+  }
+  const state = { bounded: false };
+  const sections = [];
+  if (objects.length > 0) {
+    sections.push(...groupedNodeSections(objects, state));
+  }
+  const labelByUid = /* @__PURE__ */ new Map();
+  for (const node of objects) labelByUid.set(str(node.uid), str(node.label) || "?");
+  const graph = obj(payload.graph);
+  for (const raw of Array.isArray(graph?.nodes) ? graph.nodes : []) {
+    const node = obj(raw);
+    const uid = str(node?.uid);
+    if (uid && !labelByUid.has(uid)) labelByUid.set(uid, str(node?.label) || "?");
+  }
+  if (cognitive) {
+    for (const rawNodes of Object.values(cognitive)) {
+      if (!Array.isArray(rawNodes)) continue;
+      for (const raw of rawNodes) {
+        const node = obj(raw);
+        const uid = str(node?.uid);
+        if (uid && !labelByUid.has(uid)) labelByUid.set(uid, str(node?.label) || "?");
+      }
+    }
+  }
+  const relations = Array.isArray(payload.relations) ? payload.relations : [];
+  const relationLines = relationshipItems(relations, labelByUid, state, { fallbackToUid: true });
+  if (relationLines.length > 0) {
+    sections.push({ heading: "## Relations", items: relationLines });
+  }
+  if (cognitive) {
+    for (const [category, rawNodes] of Object.entries(cognitive)) {
+      if (!Array.isArray(rawNodes) || rawNodes.length === 0) continue;
+      const items = rawNodes.map(neighborLine).filter((line) => Boolean(line));
+      if (items.length > 0) {
+        sections.push({ heading: `### Cognitive context \u2014 ${category}`, items });
+      }
+    }
+  }
+  if (provenance.length > 0) {
+    const items = provenance.map((raw) => obj(raw)).filter((entry) => Boolean(entry)).map((entry) => {
+      const span = clip(entry.text_span, QUOTE_MAX, state) || "";
+      const by = str(entry.ingested_by_name);
+      const suffix = `${by ? ` (ingested by ${by})` : ""} [source ${str(entry.source_uid) || "?"}]`;
+      return str(entry.span_kind) === "anchor" ? `- "${span}"${suffix}` : `- context: ${span}${suffix}`;
+    });
+    sections.push({ heading: "## Sources", items });
+  }
+  const confidence = num(obj(payload.confidence)?.overall);
+  const notes = [];
+  if (confidence !== void 0) notes.push(`overall confidence ${confidence}`);
+  if (payload.has_more === true) notes.push("more results exist (has_more)");
+  if (payload.seed_cap_hit === true) notes.push("seed cap hit \u2014 narrow the query for a complete set");
+  if (notes.length > 0) sections.push({ heading: `Note: ${notes.join("; ")}.`, items: [] });
+  return assemble(
+    `# Ontology results (${objects.length} object${objects.length === 1 ? "" : "s"})`,
+    sections,
+    state
+  );
+}
+function renderObjectList(response, title) {
+  const payload = obj(response);
+  if (!payload) return void 0;
+  const rawItems = Array.isArray(payload.items) ? payload.items : Array.isArray(payload.rows) && payload.rows.some((row) => unwrapSearchResult(row)) ? payload.rows : void 0;
+  const items = (rawItems ?? []).map(unwrapSearchResult).filter((node) => Boolean(node));
+  if (items.length === 0) {
+    return rawItems ? `# ${title} (0 results)` : void 0;
+  }
+  const state = { bounded: false };
+  const sections = groupedNodeSections(items, state);
+  const total = num(payload.total_count);
+  const truncations = Array.isArray(payload.truncation_reasons) ? payload.truncation_reasons.filter((reason) => typeof reason === "string") : [];
+  const notes = [];
+  if (payload.has_more === true) notes.push("more results exist");
+  if (truncations.length > 0) notes.push(`truncated: ${truncations.join(", ")}`);
+  if (notes.length > 0) sections.push({ heading: `Note: ${notes.join("; ")}.`, items: [] });
+  const count = total !== void 0 && total !== items.length ? `${items.length} of ${total}` : `${items.length}`;
+  return assemble(`# ${title} (${count})`, sections, state);
+}
+var JOBS_RENDER_MAX = 20;
+function renderJobs(response) {
+  const jobs = Array.isArray(response) ? response : obj(response)?.jobs;
+  if (!Array.isArray(jobs)) return void 0;
+  if (jobs.length === 0) return "No ingestion jobs.";
+  const state = { bounded: false };
+  const sorted = jobs.map((raw) => obj(raw)).filter((job) => Boolean(job)).sort((a, b) => (num(b.created_at) ?? 0) - (num(a.created_at) ?? 0));
+  const shown = sorted.slice(0, JOBS_RENDER_MAX);
+  if (shown.length < sorted.length) state.bounded = true;
+  const items = shown.map((job) => {
+    const progress = obj(job.progress);
+    const done = num(progress?.processed_chunks);
+    const totalChunks = num(progress?.total_chunks);
+    const bits = [
+      str(job.status) || "?",
+      done !== void 0 && totalChunks !== void 0 ? `${done}/${totalChunks} chunks` : void 0,
+      num(progress?.nodes_created) !== void 0 ? `${num(progress?.nodes_created)} nodes` : void 0,
+      num(job.queue_position) !== void 0 ? `queue #${num(job.queue_position)}` : void 0,
+      str(job.error) ? `error: ${clip(job.error, 160, state)}` : void 0
+    ].filter(Boolean);
+    return `- [${str(job.id) || "?"}] ${clip(job.title, 120, state) || "(untitled)"} \u2014 ${bits.join(", ")}`;
+  });
+  return assemble(
+    `# Ingestion jobs (${shown.length}${shown.length < sorted.length ? ` of ${sorted.length}` : ""})`,
+    [{ heading: "", items }],
+    state
+  );
+}
+function renderSignals(response) {
+  const payload = obj(response);
+  if (!payload) return void 0;
+  const state = { bounded: false };
+  const sections = [];
+  for (const [key, value] of Object.entries(payload)) {
+    if (!Array.isArray(value) || value.length === 0) continue;
+    const items = value.map((raw) => obj(raw)).filter((item) => Boolean(item)).map((item) => {
+      const fromLabel = str(item.from_label);
+      const toLabel = str(item.to_label);
+      const anyLabelKey = Object.keys(item).find(
+        (k) => k.endsWith("_label") && str(item[k])
+      );
+      const label = str(item.label) ?? str(item.title) ?? str(item.name) ?? (fromLabel && toLabel ? `${fromLabel} \u2194 ${toLabel}` : void 0) ?? (anyLabelKey ? str(item[anyLabelKey]) : void 0) ?? str(item.uid) ?? str(item.target_uid) ?? "(item)";
+      const uid = str(item.uid) ?? str(item.target_uid);
+      const numbers = Object.entries(item).filter(([, v]) => typeof v === "number").slice(0, 4).map(([k, v]) => `${k} ${Math.round(v * 100) / 100}`);
+      const lists = Object.entries(item).filter(([, v]) => Array.isArray(v) && v.length > 0).slice(0, 2).map(([k, v]) => `${k}: ${v.length}`);
+      const meta = [...numbers, ...lists].join(", ");
+      return `- ${clip(label, 160, state)}${uid && uid !== label ? ` [${uid}]` : ""}${meta ? ` (${meta})` : ""}`;
+    });
+    if (items.length > 0) {
+      sections.push({ heading: `## ${key.replace(/_/g, " ")}`, items });
+    }
+  }
+  if (sections.length === 0) return void 0;
+  return assemble("# Synthesis signals", sections, state);
+}
 
 // src/tools.ts
 var TOOLS = [
@@ -2631,6 +2793,11 @@ var TOOLS = [
           type: "string",
           description: "Job ID to check status (for job_status action)"
         },
+        format: {
+          type: "string",
+          enum: ["text", "json"],
+          description: "job_status without job_id: 'text' (default) renders the 20 most recent jobs; 'json' returns the full raw list."
+        },
         agent_id: {
           type: "string",
           description: "Agent identity"
@@ -2666,6 +2833,11 @@ var TOOLS = [
           type: "string",
           description: "Job ID to poll (for action='job_status')"
         },
+        format: {
+          type: "string",
+          enum: ["text", "json"],
+          description: "signals action: 'text' (default) renders signal sections; 'json' returns the raw payload."
+        },
         agent_id: {
           type: "string",
           description: "Agent identity"
@@ -2774,6 +2946,11 @@ var TOOLS = [
           items: { type: "string" },
           description: "Chunk/document UIDs to extract from (for action=extract)"
         },
+        format: {
+          type: "string",
+          enum: ["text", "json"],
+          description: "Output format for the read actions query/search/objects/object/object_context (default 'text'): a compact rendered block. Pass 'json' for the raw server response."
+        },
         agent_id: {
           type: "string",
           description: "Agent identity"
@@ -2816,9 +2993,14 @@ function toolsForProfile(profile = process.env.MINDGRAPH_PROFILE || "general") {
 }
 function ok3(data) {
   return {
-    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+    content: [{ type: "text", text: JSON.stringify(data) }]
   };
 }
+function renderedResult(format, raw, render) {
+  if (format === "json") return ok3(raw);
+  const text = render(raw);
+  return text !== void 0 ? { content: [{ type: "text", text }] } : ok3(raw);
+}
 function err3(message) {
   return {
     content: [{ type: "text", text: JSON.stringify({ error: message }) }],
@@ -3430,15 +3612,11 @@ async function handleRetrieve(client2, args) {
     max_cost,
     agent_id
   } = args;
-  const rendered = (raw, render) => {
-    if (format === "json") return ok3(raw);
-    const text = render(raw);
-    return text !== void 0 ? { content: [{ type: "text", text }] } : ok3(raw);
-  };
+  const rendered2 = (raw, render) => renderedResult(format, raw, render);
   switch (action) {
     case "context":
       if (!query) return err3("query is required for context retrieval");
-      return rendered(
+      return rendered2(
         await client2.retrieveContext({
           query,
           node_limit: limit,
@@ -3463,7 +3641,7 @@ async function handleRetrieve(client2, args) {
       );
     case "text":
       if (!query) return err3("query is required for text search");
-      return rendered(
+      return rendered2(
         await client2.retrieve({
           action: "text",
           query,
@@ -3477,7 +3655,7 @@ async function handleRetrieve(client2, args) {
       );
     case "semantic":
       if (!query) return err3("query is required for semantic search");
-      return rendered(
+      return rendered2(
         await client2.retrieve({
           action: "semantic",
           query,
@@ -3491,7 +3669,7 @@ async function handleRetrieve(client2, args) {
       );
     case "hybrid":
       if (!query) return err3("query is required for hybrid search");
-      return rendered(
+      return rendered2(
         await client2.retrieve({
           action: "hybrid",
           query,
@@ -3513,7 +3691,7 @@ async function handleRetrieve(client2, args) {
     case "weak_claims":
     case "pending_approvals":
     case "unresolved_contradictions":
-      return rendered(
+      return rendered2(
         await client2.retrieve({
           action,
           limit,
@@ -3523,7 +3701,7 @@ async function handleRetrieve(client2, args) {
         (raw) => renderNodeList(raw, action.replace(/_/g, " "), limit)
       );
     case "stale_derivations":
-      return rendered(
+      return rendered2(
         await client2.retrieve({
           action: "stale_derivations",
           limit,
@@ -3532,7 +3710,7 @@ async function handleRetrieve(client2, args) {
         (raw) => renderNodeList(raw, "stale derivations", limit)
       );
     case "preferences":
-      return rendered(
+      return rendered2(
         await client2.retrieve({
           action: "preferences",
           ...query ? { query, k: limit } : {},
@@ -3543,7 +3721,7 @@ async function handleRetrieve(client2, args) {
       );
     case "layer":
       if (!layer) return err3("layer is required for layer retrieval");
-      return rendered(
+      return rendered2(
         await client2.retrieve({
           action: "layer",
           layer,
@@ -3554,7 +3732,7 @@ async function handleRetrieve(client2, args) {
         (raw) => renderNodeList(raw, `Layer: ${layer}`, limit)
       );
     case "recent":
-      return rendered(
+      return rendered2(
         await client2.retrieve({
           action: "recent",
           limit,
@@ -3569,7 +3747,7 @@ async function handleRetrieve(client2, args) {
       );
     // Document inventory
     case "document_index":
-      return rendered(
+      return rendered2(
         await client2.getNodes({
           node_type: "Document",
           limit: limit ?? 100
@@ -3579,7 +3757,7 @@ async function handleRetrieve(client2, args) {
     // Graph traversal
     case "chain":
       if (!start_uid) return err3("start_uid is required for chain traversal");
-      return rendered(
+      return rendered2(
         await client2.traverse({
           action: "chain",
           start_uid,
@@ -3592,7 +3770,7 @@ async function handleRetrieve(client2, args) {
       );
     case "neighborhood":
       if (!start_uid) return err3("start_uid is required for neighborhood traversal");
-      return rendered(
+      return rendered2(
         await client2.traverse({
           action: "neighborhood",
           start_uid,
@@ -3608,7 +3786,7 @@ async function handleRetrieve(client2, args) {
     case "path":
       if (!start_uid) return err3("start_uid is required for path traversal");
       if (!end_uid) return err3("end_uid is required for path traversal");
-      return rendered(
+      return rendered2(
         await client2.traverse({
           action: "path",
           start_uid,
@@ -3624,7 +3802,7 @@ async function handleRetrieve(client2, args) {
       );
     case "subgraph":
       if (!start_uid) return err3("start_uid is required for subgraph traversal");
-      return rendered(
+      return rendered2(
         await client2.traverse({
           action: "subgraph",
           start_uid,
@@ -3640,7 +3818,7 @@ async function handleRetrieve(client2, args) {
     case "top_k_paths":
       if (!start_uid) return err3("start_uid is required for top_k_paths");
       if (!end_uid) return err3("end_uid is required for top_k_paths");
-      return rendered(
+      return rendered2(
         await client2.traverse({
           action: "top_k_paths",
           start_uid,
@@ -3677,6 +3855,7 @@ async function handleIngest(client2, args) {
     chunk_size,
     chunk_overlap,
     job_id,
+    format,
     agent_id
   } = args;
   const src = source_uri ?? source;
@@ -3746,19 +3925,21 @@ async function handleIngest(client2, args) {
       if (job_id) {
         return ok3(await client2.getJob(job_id));
       }
-      return ok3(await client2.listJobs());
+      return renderedResult(format, await client2.listJobs(), renderJobs);
     default:
       return err3(`Unknown ingest action: ${action}`);
   }
 }
 async function handleSynthesize(client2, args) {
-  const { action, project_uid, signals, target_types, job_id } = args;
+  const { action, project_uid, signals, target_types, job_id, format } = args;
   switch (action) {
     case "signals":
       if (!project_uid)
         return err3("project_uid is required for action='signals'");
-      return ok3(
-        await client2.signals(project_uid, { signals, target_types })
+      return renderedResult(
+        format,
+        await client2.signals(project_uid, { signals, target_types }),
+        renderSignals
       );
     case "run":
       if (!project_uid)
@@ -3792,6 +3973,7 @@ async function handleOntology(client2, args) {
     relation_type,
     fields,
     source_uids,
+    format,
     agent_id
   } = args;
   switch (action) {
@@ -3807,7 +3989,8 @@ async function handleOntology(client2, args) {
           "schema_id is required for action='query' (use action='schemas' to find the active schema)"
         );
       }
-      return ok3(
+      return renderedResult(
+        format,
         await client2.queryOntology({
           query,
           schema_id,
@@ -3816,29 +3999,42 @@ async function handleOntology(client2, args) {
           include_sources: include_sources ?? true,
           depth,
           limit
-        })
+        }),
+        renderOntologyAnswer
       );
     }
     case "search":
       if (!query) return err3("query is required for action='search'");
-      return ok3(
+      return renderedResult(
+        format,
         await client2.searchDomainObjects(query, {
           schema_id,
           object_types,
           limit
-        })
+        }),
+        (raw) => renderObjectList(raw, `Domain search: ${query}`)
       );
     case "objects":
       if (!schema_id) return err3("schema_id is required for action='objects'");
-      return ok3(
-        await client2.listDomainObjects({ schema_id, object_type, limit })
+      return renderedResult(
+        format,
+        await client2.listDomainObjects({ schema_id, object_type, limit }),
+        (raw) => renderObjectList(raw, `Domain objects${object_type ? `: ${object_type}` : ""}`)
       );
     case "object":
       if (!uid) return err3("uid is required for action='object'");
-      return ok3(await client2.getDomainObject(uid));
+      return renderedResult(
+        format,
+        await client2.getDomainObject(uid),
+        (raw) => renderNodeList([raw], "Domain object")
+      );
     case "object_context":
       if (!uid) return err3("uid is required for action='object_context'");
-      return ok3(await client2.getDomainObjectContext(uid, depth));
+      return renderedResult(
+        format,
+        await client2.getDomainObjectContext(uid, depth),
+        renderOntologyAnswer
+      );
     case "proposals":
       return ok3(
         await client2.listOntologyProposals({
@@ -3892,8 +4088,14 @@ async function handleOntology(client2, args) {
 
 // src/generated-tools.ts
 var ok4 = (data) => ({
-  content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+  // Compact on purpose — pretty-printing doubled the token cost.
+  content: [{ type: "text", text: JSON.stringify(data) }]
 });
+var rendered = (format, raw, render) => {
+  if (format === "json") return ok4(raw);
+  const text = render(raw);
+  return text !== void 0 ? { content: [{ type: "text", text }] } : ok4(raw);
+};
 var err4 = (message) => ({
   content: [{ type: "text", text: JSON.stringify({ error: message }) }],
   isError: true
@@ -3932,10 +4134,21 @@ async function getGeneratedTools(client2) {
         );
       }
       byName.set(d.name, d);
+      const inputSchema = d.maps_to === "structured_query" ? d.input_schema : {
+        ...d.input_schema,
+        properties: {
+          ...d.input_schema.properties,
+          format: {
+            type: "string",
+            enum: ["text", "json"],
+            description: "Output format (default 'text': compact rendered block). Pass 'json' for the raw server response."
+          }
+        }
+      };
       tools.push({
         name: d.name,
         description: d.description,
-        inputSchema: d.input_schema
+        inputSchema
       });
     }
     cache = { tools, byName, fetchedAt: Date.now() };
@@ -3964,31 +4177,41 @@ async function handleGeneratedTool(client2, desc, args) {
         if (!query) return err4(`query is required for ${desc.name}`);
         const limit = typeof args.limit === "number" ? args.limit : void 0;
         const filters = Array.isArray(args.filters) ? args.filters : void 0;
-        return ok4(
+        return rendered(
+          args.format,
           await ontologyClient.searchDomainObjects(query, {
             schema_id: desc.schema_id,
             object_types: [desc.object_type],
             filters,
             limit
-          })
+          }),
+          (raw) => renderObjectList(raw, `${desc.object_type} search: ${query}`)
         );
       }
       case "object": {
         const uid = args.uid;
         if (!uid) return err4(`uid is required for ${desc.name}`);
-        return ok4(await ontologyClient.getDomainObject(uid, {
-          schema_id: desc.schema_id,
-          object_type: desc.object_type
-        }));
+        return rendered(
+          args.format,
+          await ontologyClient.getDomainObject(uid, {
+            schema_id: desc.schema_id,
+            object_type: desc.object_type
+          }),
+          (raw) => renderNodeList([raw], desc.object_type)
+        );
       }
       case "object_context": {
         const uid = args.uid;
         if (!uid) return err4(`uid is required for ${desc.name}`);
         const depth = typeof args.depth === "number" ? args.depth : void 0;
-        return ok4(await ontologyClient.getDomainObjectContext(uid, depth, {
-          schema_id: desc.schema_id,
-          object_type: desc.object_type
-        }));
+        return rendered(
+          args.format,
+          await ontologyClient.getDomainObjectContext(uid, depth, {
+            schema_id: desc.schema_id,
+            object_type: desc.object_type
+          }),
+          renderOntologyAnswer
+        );
       }
       case "related": {
         const uid = args.uid;
@@ -4001,18 +4224,22 @@ async function handleGeneratedTool(client2, desc, args) {
             "related ontology tools require a graph-aware version of the mindgraph SDK"
           );
         }
-        return ok4(await ontologyClient.queryRelatedDomainObjects({
-          schema_id: desc.schema_id,
-          entry_type: desc.object_type,
-          uid,
-          relation: desc.relation,
-          entry_role: desc.entry_role,
-          far_type: desc.far_type,
-          where: Array.isArray(args.where) ? args.where : void 0,
-          include_provenance: args.include_provenance === true,
-          limit: typeof args.limit === "number" ? args.limit : void 0,
-          offset: typeof args.offset === "number" ? args.offset : void 0
-        }));
+        return rendered(
+          args.format,
+          await ontologyClient.queryRelatedDomainObjects({
+            schema_id: desc.schema_id,
+            entry_type: desc.object_type,
+            uid,
+            relation: desc.relation,
+            entry_role: desc.entry_role,
+            far_type: desc.far_type,
+            where: Array.isArray(args.where) ? args.where : void 0,
+            include_provenance: args.include_provenance === true,
+            limit: typeof args.limit === "number" ? args.limit : void 0,
+            offset: typeof args.offset === "number" ? args.offset : void 0
+          }),
+          (raw) => renderObjectList(raw, `${desc.far_type} related via ${desc.relation}`)
+        );
       }
       case "structured_query": {
         const select = args.select;
@@ -4331,7 +4558,7 @@ var RESOURCE_TEMPLATES = [
 var RESOURCE_GOVERNANCE_TOOL = "mindgraph_retrieve";
 function json(uri, data) {
   return {
-    contents: [{ uri, mimeType: "application/json", text: JSON.stringify(data, null, 2) }]
+    contents: [{ uri, mimeType: "application/json", text: JSON.stringify(data) }]
   };
 }
 async function readResource(client2, uri) {
@@ -4504,7 +4731,7 @@ if (PROFILE === "coding") {
 var server = new import_server.Server(
   {
     name: "mindgraph",
-    version: "0.16.0"
+    version: "0.17.0"
   },
   {
     capabilities: {
@@ -4718,7 +4945,7 @@ async function main() {
   const transport = new import_stdio.StdioServerTransport();
   await server.connect(transport);
   console.error(
-    `MindGraph MCP server v${"0.16.0"} running on stdio (${BASE_URL})`
+    `MindGraph MCP server v${"0.17.0"} running on stdio (${BASE_URL})`
   );
 }
 main().catch((error) => {