@neat.is/types 0.9.2-dev.20260821 → 0.9.2

package/dist/index.js

@@ -706,6 +706,57 @@ var ObservedDependenciesResultSchema = z5.object({
   window: z5.enum(["7d", "lifetime"]).optional(),
   inboundLastObserved: z5.string().datetime().optional()
 });
+var AskIntentSchema = z5.enum([
+  "root-cause",
+  "blast-radius",
+  "dependencies",
+  "observed",
+  "incidents",
+  "divergence",
+  "overview"
+]);
+var AskMatchSchema = z5.object({
+  nodeId: z5.string(),
+  label: z5.string(),
+  via: z5.enum(["id", "label", "token", "embedding"]),
+  score: z5.number().min(0).max(1)
+});
+var AskFactSchema = z5.object({
+  text: z5.string(),
+  provenance: ProvenanceSchema.optional(),
+  confidence: z5.number().min(0).max(1).optional()
+});
+var AskSectionSchema = z5.object({
+  heading: z5.string(),
+  facts: z5.array(AskFactSchema)
+});
+var AskResultSchema = z5.object({
+  question: z5.string(),
+  // The traversal the router chose from the question's intent keywords.
+  intent: AskIntentSchema,
+  // The entities the question resolved to, best match first.
+  matched: z5.array(AskMatchSchema),
+  // The node the answer is anchored on — matched[0]'s id, absent when nothing
+  // in the question resolved to a node.
+  primaryNode: z5.string().optional(),
+  // Whether the answer is anchored on one node or spans the whole graph.
+  // `'node'` when an entity resolved; `'global'` when the question was
+  // inherently graph-wide (overview / divergences / incidents) and answered
+  // across the whole graph with no entity named. Absent when nothing resolved
+  // and the intent needs a subject (dependencies / blast-radius / root-cause /
+  // observed) — those return naming guidance, not a graph-wide answer.
+  scope: z5.enum(["global", "node"]).optional(),
+  // The composed, provenance-tagged context, section by section.
+  sections: z5.array(AskSectionSchema),
+  // The compact, answer-shaped summary the agent reads first — not a raw graph
+  // dump, so the graph reads as lower-friction than grep.
+  answer: z5.string(),
+  // Headline confidence of the leading section, when it has one.
+  confidence: z5.number().min(0).max(1).optional(),
+  // The distinct provenances across every fact in the answer, so the footer can
+  // tell the agent how much of this is OBSERVED vs EXTRACTED.
+  provenance: z5.array(ProvenanceSchema)
+});
 
 // src/identity.ts
 var SERVICE_PREFIX = "service:";
@@ -1202,6 +1253,9 @@ var MCP_TOOL_NAMES = [
   // Two-way RCA navigation (ADR-189): step the graph and confirm a link.
   "expand",
   "relate",
+  // Plain-language door over the fused graph (ADR-198): resolve a question to
+  // nodes, route to the right traversal, answer with provenance-tagged context.
+  "ask",
   // Six /neat extend tools (ADR-081, ADR-086, #387).
   "neat_list_uninstrumented",
   "neat_lookup_instrumentation",
@@ -1388,6 +1442,11 @@ function passesExtractedFloor(confidence) {
 export {
   ApplicablePoliciesResponseSchema,
   ApplicablePolicySchema,
+  AskFactSchema,
+  AskIntentSchema,
+  AskMatchSchema,
+  AskResultSchema,
+  AskSectionSchema,
   BlastRadiusAffectedNodeSchema,
   BlastRadiusResultSchema,
   BlastRadiusRuleSchema,