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

package/dist/index.cjs

@@ -22,6 +22,11 @@ var index_exports = {};
 __export(index_exports, {
   ApplicablePoliciesResponseSchema: () => ApplicablePoliciesResponseSchema,
   ApplicablePolicySchema: () => ApplicablePolicySchema,
+  AskFactSchema: () => AskFactSchema,
+  AskIntentSchema: () => AskIntentSchema,
+  AskMatchSchema: () => AskMatchSchema,
+  AskResultSchema: () => AskResultSchema,
+  AskSectionSchema: () => AskSectionSchema,
   BlastRadiusAffectedNodeSchema: () => BlastRadiusAffectedNodeSchema,
   BlastRadiusResultSchema: () => BlastRadiusResultSchema,
   BlastRadiusRuleSchema: () => BlastRadiusRuleSchema,
@@ -331,7 +336,18 @@ var EdgeEvidenceSchema = import_zod2.z.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: import_zod2.z.string().optional(),
-  pathTemplate: import_zod2.z.string().optional()
+  pathTemplate: import_zod2.z.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: import_zod2.z.enum(["literal", "config"]).optional()
 });
 var LatencyMsSchema = import_zod2.z.object({
   p50: import_zod2.z.number().nonnegative(),
@@ -869,6 +885,57 @@ var ObservedDependenciesResultSchema = import_zod5.z.object({
   window: import_zod5.z.enum(["7d", "lifetime"]).optional(),
   inboundLastObserved: import_zod5.z.string().datetime().optional()
 });
+var AskIntentSchema = import_zod5.z.enum([
+  "root-cause",
+  "blast-radius",
+  "dependencies",
+  "observed",
+  "incidents",
+  "divergence",
+  "overview"
+]);
+var AskMatchSchema = import_zod5.z.object({
+  nodeId: import_zod5.z.string(),
+  label: import_zod5.z.string(),
+  via: import_zod5.z.enum(["id", "label", "token", "embedding"]),
+  score: import_zod5.z.number().min(0).max(1)
+});
+var AskFactSchema = import_zod5.z.object({
+  text: import_zod5.z.string(),
+  provenance: ProvenanceSchema.optional(),
+  confidence: import_zod5.z.number().min(0).max(1).optional()
+});
+var AskSectionSchema = import_zod5.z.object({
+  heading: import_zod5.z.string(),
+  facts: import_zod5.z.array(AskFactSchema)
+});
+var AskResultSchema = import_zod5.z.object({
+  question: import_zod5.z.string(),
+  // The traversal the router chose from the question's intent keywords.
+  intent: AskIntentSchema,
+  // The entities the question resolved to, best match first.
+  matched: import_zod5.z.array(AskMatchSchema),
+  // The node the answer is anchored on — matched[0]'s id, absent when nothing
+  // in the question resolved to a node.
+  primaryNode: import_zod5.z.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: import_zod5.z.enum(["global", "node"]).optional(),
+  // The composed, provenance-tagged context, section by section.
+  sections: import_zod5.z.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: import_zod5.z.string(),
+  // Headline confidence of the leading section, when it has one.
+  confidence: import_zod5.z.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: import_zod5.z.array(ProvenanceSchema)
+});
 
 // src/identity.ts
 var SERVICE_PREFIX = "service:";
@@ -1365,6 +1432,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",
@@ -1552,6 +1622,11 @@ function passesExtractedFloor(confidence) {
 0 && (module.exports = {
   ApplicablePoliciesResponseSchema,
   ApplicablePolicySchema,
+  AskFactSchema,
+  AskIntentSchema,
+  AskMatchSchema,
+  AskResultSchema,
+  AskSectionSchema,
   BlastRadiusAffectedNodeSchema,
   BlastRadiusResultSchema,
   BlastRadiusRuleSchema,