@neat.is/types 0.9.2-dev.20260822 → 0.9.3-dev.20260823

package/dist/index.js

@@ -168,7 +168,18 @@ var EdgeEvidenceSchema = z2.object({
   // client named, alongside the file:line it named them at. Absent on every
   // other edge — a config or infra edge has no HTTP method.
   method: z2.string().optional(),
-  pathTemplate: z2.string().optional()
+  pathTemplate: z2.string().optional(),
+  // How a datastore host was recovered (ADR-213). `config` when the host came
+  // from an env var / IConfiguration key / config file — the deployment's real
+  // target; `literal` when it was read from a hardcoded string literal in
+  // source. The divergence ranker reads this to tell a genuine declared store
+  // from a hardcoded fault-injection / flag-gated probe: a `literal` host
+  // production never observed, sitting beside a `config`-driven store of the
+  // same engine on the same service, is a dead alternate whose missing-observed
+  // is dampened rather than surfaced as a real gap. Present only on datastore
+  // CONNECTS_TO edges from a recogniser that distinguishes the two; absent on
+  // every other edge.
+  hostSource: z2.enum(["literal", "config"]).optional()
 });
 var LatencyMsSchema = z2.object({
   p50: z2.number().nonnegative(),
@@ -706,6 +717,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 +1264,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 +1453,11 @@ function passesExtractedFloor(confidence) {
 export {
   ApplicablePoliciesResponseSchema,
   ApplicablePolicySchema,
+  AskFactSchema,
+  AskIntentSchema,
+  AskMatchSchema,
+  AskResultSchema,
+  AskSectionSchema,
   BlastRadiusAffectedNodeSchema,
   BlastRadiusResultSchema,
   BlastRadiusRuleSchema,