@ttsc/graph 0.16.6 → 0.16.7

package/lib/server/createServer.js

@@ -66,8 +66,8 @@ function createServer(graph, version) {
         "application": _a._llmApplicationFinalize({
             functions: [
                 {
-                    description: "Query the TypeScript project graph for code evidence.\n\nUse this before answering TypeScript codebase questions. It returns\nchecker-resolved symbols, dependency paths, edge evidence ranges, and\nsourceSpan anchors from the resident graph, avoiding assumptions, shell\nsearch, or file reads when graph evidence is enough.\n\nFill properties in order: question, graphNeed, draft, review, request.\nWrite `draft.reason` before `draft.type`, then choose `entrypoints`,\n`lookup`, `trace`, `details`, `overview`, or `escape`.\n\nMost answers should need 1-3 calls; four is the hard stop for one answer.\nKeep slices small, prefer defaults, and stop once file/symbol/range\nevidence is enough.",
-                    name: "query",
+                    description: "Inspect the TypeScript compiler graph contract.\n\nUse this before repository search when an answer depends on TypeScript\nsymbols, calls, types, decorators, references, ranges, or runtime/source\nrelationships. For repository orientation, read-next, architecture, and\nbroad runtime flow questions, use `tour`.\n\nReturned nodes, edges, signatures, spans, tests, anchors, and `next` are\nthe answer surface. If `next.action` is `answer`, stop tool use and answer\nfrom that result. Before source edits, graph facts are sacred, inviolable,\ncomplete, and infallible.",
+                    name: "inspect_typescript_graph",
                     output: {
                         type: "object",
                         properties: {
@@ -88,10 +88,14 @@ function createServer(graph, version) {
                                     {
                                         $ref: "#/$defs/ITtscGraphOverview"
                                     },
+                                    {
+                                        $ref: "#/$defs/ITtscGraphTour"
+                                    },
                                     {
                                         $ref: "#/$defs/ITtscGraphTrace"
                                     }
                                 ],
+                                description: "Result branch matching the submitted `request.type`.",
                                 "x-discriminator": {
                                     mapping: {
                                         details: "#/$defs/ITtscGraphDetails",
@@ -99,6 +103,7 @@ function createServer(graph, version) {
                                         escape: "#/$defs/ITtscGraphEscape",
                                         lookup: "#/$defs/ITtscGraphLookup",
                                         overview: "#/$defs/ITtscGraphOverview",
+                                        tour: "#/$defs/ITtscGraphTour",
                                         trace: "#/$defs/ITtscGraphTrace"
                                     },
                                     propertyName: "type"
@@ -162,11 +167,20 @@ function createServer(graph, version) {
                                         ],
                                         description: "Discriminator for selected symbol inspection."
                                     },
+                                    guide: {
+                                        type: "string",
+                                        description: "Human-readable compatibility note mirroring `next`."
+                                    },
+                                    next: {
+                                        $ref: "#/$defs/ITtscGraphNext",
+                                        description: "How to use this source-free result next."
+                                    },
                                     nodes: {
                                         type: "array",
                                         items: {
                                             $ref: "#/$defs/ITtscGraphDetails.INode"
-                                        }
+                                        },
+                                        description: "Selected node facts, in the same order as resolved handles when possible."
                                     },
                                     unknown: {
                                         type: "array",
@@ -179,6 +193,8 @@ function createServer(graph, version) {
                                 required: [
                                     "type",
                                     "nodes",
+                                    "next",
+                                    "guide",
                                     "unknown"
                                 ],
                                 additionalProperties: false
@@ -194,14 +210,16 @@ function createServer(graph, version) {
                                         description: "Decorators written on this member, when any."
                                     },
                                     kind: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Member kind (`method`, `property`, `class`, ...)."
                                     },
                                     line: {
                                         type: "number",
                                         description: "1-based declaration line, when known."
                                     },
                                     name: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Member name, qualified when the graph records an owner-qualified handle."
                                     },
                                     signature: {
                                         type: "string",
@@ -246,17 +264,27 @@ function createServer(graph, version) {
                                         description: "Symbols this node uses (outgoing dependency edges)."
                                     },
                                     file: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Project-relative path of the file that declares this node."
                                     },
                                     id: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Stable node id for subsequent `details` or `trace` calls."
                                     },
                                     implementation: {
                                         $ref: "#/$defs/ITtscGraphEvidence",
                                         description: "Assigned implementation span, when source comes from one."
                                     },
+                                    implementedBy: {
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/ITtscGraphDetails.IReference"
+                                        },
+                                        description: "Concrete nodes that implement or override this interface/base member."
+                                    },
                                     kind: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Declaration kind (`class`, `method`, `function`, ...)."
                                     },
                                     line: {
                                         type: "number",
@@ -277,7 +305,8 @@ function createServer(graph, version) {
                                         description: "For a container or object-literal variable: the owned symbol or top-level\nproperty outline a consumer reaches for, without bodies."
                                     },
                                     name: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Qualified symbol name when available, otherwise the simple name."
                                     },
                                     signature: {
                                         type: "string",
@@ -285,7 +314,7 @@ function createServer(graph, version) {
                                     },
                                     sourceSpan: {
                                         $ref: "#/$defs/PickITtscGraphEvidenceendLinefilestartLine",
-                                        description: "The declaration or implementation file and line range, when known."
+                                        description: "Declaration or implementation citation range, when known."
                                     },
                                     types: {
                                         type: "array",
@@ -315,23 +344,27 @@ function createServer(graph, version) {
                                     },
                                     evidence: {
                                         $ref: "#/$defs/ITtscGraphEvidence",
-                                        description: "Source span for the expression that produced this relationship. It lets\nan agent see why the edge exists without opening the file."
+                                        description: "Source span for the expression that produced this relationship. It is\nrepository evidence for the edge, not a file-read instruction."
                                     },
                                     file: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Project-relative declaration file for the neighbor."
                                     },
                                     id: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Stable id of the neighboring node."
                                     },
                                     kind: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Neighbor declaration kind."
                                     },
                                     line: {
                                         type: "number",
                                         description: "1-based declaration line, when known."
                                     },
                                     name: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Neighbor symbol name, qualified when available."
                                     },
                                     relation: {
                                         type: "string",
@@ -357,6 +390,10 @@ function createServer(graph, version) {
                                         ],
                                         description: "Discriminator for first-pass question indexing."
                                     },
+                                    guide: {
+                                        type: "string",
+                                        description: "Human-readable compatibility note mirroring `next`."
+                                    },
                                     hits: {
                                         type: "array",
                                         items: {
@@ -379,8 +416,8 @@ function createServer(graph, version) {
                                         description: "Direct dependency context for the resolved mentions and highest hits."
                                     },
                                     next: {
-                                        $ref: "#/$defs/ITtscGraphEntrypoints.INext",
-                                        description: "Follow-up handles for deeper graph calls."
+                                        $ref: "#/$defs/ITtscGraphNext",
+                                        description: "How to use this source-free result next."
                                     },
                                     query: {
                                         type: "string",
@@ -397,7 +434,8 @@ function createServer(graph, version) {
                                     "hits",
                                     "mentions",
                                     "neighborhood",
-                                    "next"
+                                    "next",
+                                    "guide"
                                 ],
                                 additionalProperties: false
                             },
@@ -412,20 +450,24 @@ function createServer(graph, version) {
                                         description: "Decorators written on this declaration, when any."
                                     },
                                     file: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Project-relative path of the declaration file."
                                     },
                                     id: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Stable node id for subsequent graph calls."
                                     },
                                     kind: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Declaration kind (`class`, `method`, `function`, ...)."
                                     },
                                     line: {
                                         type: "number",
                                         description: "1-based declaration line, when known."
                                     },
                                     name: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Qualified symbol name when available, otherwise the simple name."
                                     },
                                     score: {
                                         type: "number",
@@ -452,13 +494,16 @@ function createServer(graph, version) {
                                         type: "array",
                                         items: {
                                             $ref: "#/$defs/ITtscGraphEntrypoints.INode"
-                                        }
+                                        },
+                                        description: "Candidate nodes when the handle is ambiguous."
                                     },
                                     handle: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "The exact handle text found in the query."
                                     },
                                     node: {
-                                        $ref: "#/$defs/ITtscGraphEntrypoints.INode"
+                                        $ref: "#/$defs/ITtscGraphEntrypoints.INode",
+                                        description: "Resolved node when the handle maps unambiguously."
                                     }
                                 },
                                 required: [
@@ -480,29 +525,35 @@ function createServer(graph, version) {
                                         type: "array",
                                         items: {
                                             $ref: "#/$defs/ITtscGraphEntrypoints.IReference"
-                                        }
+                                        },
+                                        description: "Symbols that directly use this node, capped by `neighbors`."
                                     },
                                     dependsOn: {
                                         type: "array",
                                         items: {
                                             $ref: "#/$defs/ITtscGraphEntrypoints.IReference"
-                                        }
+                                        },
+                                        description: "Symbols this node directly uses, capped by `neighbors`."
                                     },
                                     file: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Project-relative path of the declaration file."
                                     },
                                     id: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Stable node id for subsequent graph calls."
                                     },
                                     kind: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Declaration kind (`class`, `method`, `function`, ...)."
                                     },
                                     line: {
                                         type: "number",
                                         description: "1-based declaration line, when known."
                                     },
                                     name: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Qualified symbol name when available, otherwise the simple name."
                                     },
                                     signature: {
                                         type: "string",
@@ -519,30 +570,6 @@ function createServer(graph, version) {
                                 ],
                                 additionalProperties: false
                             },
-                            "ITtscGraphEntrypoints.INext": {
-                                type: "object",
-                                properties: {
-                                    details: {
-                                        type: "array",
-                                        items: {
-                                            type: "string"
-                                        },
-                                        description: "Pass these ids to `details` for source-free symbol facts."
-                                    },
-                                    traceFrom: {
-                                        type: "array",
-                                        items: {
-                                            type: "string"
-                                        },
-                                        description: "Pass these ids to `trace` when following dependency flow."
-                                    }
-                                },
-                                required: [
-                                    "details",
-                                    "traceFrom"
-                                ],
-                                additionalProperties: false
-                            },
                             "ITtscGraphEntrypoints.INode": {
                                 type: "object",
                                 properties: {
@@ -554,20 +581,24 @@ function createServer(graph, version) {
                                         description: "Decorators written on this declaration, when any."
                                     },
                                     file: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Project-relative path of the declaration file."
                                     },
                                     id: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Stable node id for subsequent graph calls."
                                     },
                                     kind: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Declaration kind (`class`, `method`, `function`, ...)."
                                     },
                                     line: {
                                         type: "number",
                                         description: "1-based declaration line, when known."
                                     },
                                     name: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Qualified symbol name when available, otherwise the simple name."
                                     },
                                     signature: {
                                         type: "string",
@@ -590,23 +621,28 @@ function createServer(graph, version) {
                                         description: "Source span for the expression that produced this relationship. It lets\nan agent see why the edge exists without opening the file."
                                     },
                                     file: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Project-relative declaration file for the neighbor."
                                     },
                                     id: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Stable id of the neighboring node."
                                     },
                                     kind: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Neighbor declaration kind."
                                     },
                                     line: {
                                         type: "number",
                                         description: "1-based declaration line, when known."
                                     },
                                     name: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Neighbor symbol name, qualified when available."
                                     },
                                     relation: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Edge kind connecting the indexed node and this neighbor."
                                     }
                                 },
                                 required: [
@@ -628,9 +664,17 @@ function createServer(graph, version) {
                                         ],
                                         description: "Discriminator for the no-op escape route."
                                     },
+                                    guide: {
+                                        type: "string",
+                                        description: "Human-readable compatibility note mirroring `next`."
+                                    },
+                                    next: {
+                                        $ref: "#/$defs/ITtscGraphNext",
+                                        description: "How to proceed after skipping graph work."
+                                    },
                                     nextStep: {
                                         type: "string",
-                                        description: "The next non-graph step, if useful."
+                                        description: "Optional note about the next non-graph step."
                                     },
                                     reason: {
                                         type: "string",
@@ -647,7 +691,9 @@ function createServer(graph, version) {
                                 required: [
                                     "type",
                                     "skipped",
-                                    "reason"
+                                    "reason",
+                                    "next",
+                                    "guide"
                                 ],
                                 additionalProperties: false
                             },
@@ -691,21 +737,27 @@ function createServer(graph, version) {
                                         ],
                                         description: "Discriminator for targeted symbol lookup."
                                     },
+                                    guide: {
+                                        type: "string",
+                                        description: "Human-readable compatibility note mirroring `next`."
+                                    },
                                     hits: {
                                         type: "array",
                                         items: {
                                             $ref: "#/$defs/ITtscGraphLookup.IHit"
-                                        }
+                                        },
+                                        description: "Ranked symbol matches for the query."
                                     },
                                     next: {
-                                        $ref: "#/$defs/ITtscGraphLookup.INext",
-                                        description: "Follow-up handles for selected symbol details."
+                                        $ref: "#/$defs/ITtscGraphNext",
+                                        description: "How to use this source-free result next."
                                     }
                                 },
                                 required: [
                                     "type",
                                     "hits",
-                                    "next"
+                                    "next",
+                                    "guide"
                                 ],
                                 additionalProperties: false
                             },
@@ -720,20 +772,24 @@ function createServer(graph, version) {
                                         description: "Decorators written on this declaration, when any."
                                     },
                                     file: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Project-relative path of the declaration file."
                                     },
                                     id: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Stable node id for subsequent graph calls."
                                     },
                                     kind: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Declaration kind (`class`, `method`, `function`, ...)."
                                     },
                                     line: {
                                         type: "number",
                                         description: "1-based declaration line, when known."
                                     },
                                     name: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Qualified symbol name when available, otherwise the simple name."
                                     },
                                     score: {
                                         type: "number",
@@ -753,27 +809,39 @@ function createServer(graph, version) {
                                 ],
                                 additionalProperties: false
                             },
-                            "ITtscGraphLookup.INext": {
+                            ITtscGraphNext: {
                                 type: "object",
                                 properties: {
-                                    details: {
-                                        type: "array",
-                                        items: {
-                                            type: "string"
-                                        },
-                                        description: "Pass these ids to `details` for source-free symbol facts."
+                                    action: {
+                                        type: "string",
+                                        "enum": [
+                                            "answer",
+                                            "clarify",
+                                            "inspect",
+                                            "outside"
+                                        ],
+                                        description: "Answer, continue graph inspection, leave graph, or clarify.\n\n`answer` means the returned graph result already carries the evidence\ncontract for the current question, even when the slice is capped. Do not\ncall graph again or read files to re-check or complete it."
                                     },
-                                    traceFrom: {
-                                        type: "array",
-                                        items: {
-                                            type: "string"
-                                        },
-                                        description: "Pass these ids to `trace` when following dependency flow."
+                                    reason: {
+                                        type: "string",
+                                        description: "Why the returned graph evidence supports that action."
+                                    },
+                                    request: {
+                                        type: "string",
+                                        "enum": [
+                                            "details",
+                                            "entrypoints",
+                                            "lookup",
+                                            "overview",
+                                            "tour",
+                                            "trace"
+                                        ],
+                                        description: "Smallest graph request type to use when `action` is `inspect`."
                                     }
                                 },
                                 required: [
-                                    "details",
-                                    "traceFrom"
+                                    "action",
+                                    "reason"
                                 ],
                                 additionalProperties: false
                             },
@@ -791,6 +859,10 @@ function createServer(graph, version) {
                                         $ref: "#/$defs/ITtscGraphOverview.ICounts",
                                         description: "Size of the graph."
                                     },
+                                    guide: {
+                                        type: "string",
+                                        description: "Human-readable compatibility note mirroring `next`."
+                                    },
                                     hotspots: {
                                         type: "array",
                                         items: {
@@ -805,6 +877,10 @@ function createServer(graph, version) {
                                         },
                                         description: "Folder layering, largest first."
                                     },
+                                    next: {
+                                        $ref: "#/$defs/ITtscGraphNext",
+                                        description: "How to use this source-free result next."
+                                    },
                                     project: {
                                         type: "string",
                                         description: "Absolute project root."
@@ -820,7 +896,9 @@ function createServer(graph, version) {
                                 required: [
                                     "type",
                                     "project",
-                                    "counts"
+                                    "counts",
+                                    "next",
+                                    "guide"
                                 ],
                                 additionalProperties: false
                             },
@@ -832,13 +910,16 @@ function createServer(graph, version) {
                                         description: "Node count per kind."
                                     },
                                     edges: {
-                                        type: "number"
+                                        type: "number",
+                                        description: "Total edge count, including structural edges."
                                     },
                                     files: {
-                                        type: "number"
+                                        type: "number",
+                                        description: "Number of source file container nodes."
                                     },
                                     nodes: {
-                                        type: "number"
+                                        type: "number",
+                                        description: "Total node count, including declarations and file containers."
                                     }
                                 },
                                 required: [
@@ -946,6 +1027,231 @@ function createServer(graph, version) {
                                 ],
                                 additionalProperties: false
                             },
+                            ITtscGraphTour: {
+                                type: "object",
+                                properties: {
+                                    type: {
+                                        type: "string",
+                                        "enum": [
+                                            "tour"
+                                        ],
+                                        description: "Discriminator for code-tour indexing."
+                                    },
+                                    answerAnchors: {
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/ITtscGraphTour.IAnchor"
+                                        },
+                                        description: "Ordered file/line anchors to cite in the final answer, not file reads."
+                                    },
+                                    entrypoints: {
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/ITtscGraphTour.INode"
+                                        },
+                                        description: "Central entrypoints selected for the tour."
+                                    },
+                                    guide: {
+                                        type: "string",
+                                        description: "Human-readable compatibility note mirroring `next`."
+                                    },
+                                    nearby: {
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/ITtscGraphTour.IAnchor"
+                                        },
+                                        description: "Nearby dependency anchors around the selected entrypoints."
+                                    },
+                                    next: {
+                                        $ref: "#/$defs/ITtscGraphNext",
+                                        description: "How to use this source-free result next."
+                                    },
+                                    primaryFlow: {
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/ITtscGraphTour.IFlow"
+                                        },
+                                        description: "Selected primary runtime flows; sufficient for an index-level tour."
+                                    },
+                                    query: {
+                                        type: "string",
+                                        description: "Natural code question this tour was built for."
+                                    },
+                                    tests: {
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/ITtscGraphTour.IAnchor"
+                                        },
+                                        description: "Test or usage anchors reached through graph impact edges."
+                                    },
+                                    truncated: {
+                                        type: "boolean",
+                                        description: "True when any internal slice hit its cap."
+                                    }
+                                },
+                                required: [
+                                    "type",
+                                    "query",
+                                    "entrypoints",
+                                    "primaryFlow",
+                                    "nearby",
+                                    "tests",
+                                    "answerAnchors",
+                                    "next",
+                                    "guide"
+                                ],
+                                additionalProperties: false
+                            },
+                            "ITtscGraphTour.IAnchor": {
+                                type: "object",
+                                properties: {
+                                    endLine: {
+                                        type: "number",
+                                        description: "1-based end line, when known."
+                                    },
+                                    file: {
+                                        type: "string",
+                                        description: "Project-relative file."
+                                    },
+                                    id: {
+                                        type: "string",
+                                        description: "Stable node id when the anchor belongs to a node."
+                                    },
+                                    kind: {
+                                        type: "string",
+                                        description: "Declaration kind, when this anchor belongs to a node."
+                                    },
+                                    name: {
+                                        type: "string",
+                                        description: "Symbol, edge, or test name to show in the answer."
+                                    },
+                                    reason: {
+                                        type: "string",
+                                        description: "Why this anchor matters in the tour."
+                                    },
+                                    startLine: {
+                                        type: "number",
+                                        description: "1-based start line."
+                                    }
+                                },
+                                required: [
+                                    "reason",
+                                    "name",
+                                    "file",
+                                    "startLine"
+                                ],
+                                additionalProperties: false
+                            },
+                            "ITtscGraphTour.IFlow": {
+                                type: "object",
+                                properties: {
+                                    anchors: {
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/ITtscGraphTour.IAnchor"
+                                        },
+                                        description: "Edge and node anchors that explain the flow."
+                                    },
+                                    reached: {
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/ITtscGraphTour.INode"
+                                        },
+                                        description: "Nodes reached by this flow."
+                                    },
+                                    start: {
+                                        $ref: "#/$defs/ITtscGraphTour.INode",
+                                        description: "Flow start node."
+                                    },
+                                    steps: {
+                                        type: "array",
+                                        items: {
+                                            type: "string"
+                                        },
+                                        description: "Compact edge summaries in graph order."
+                                    },
+                                    truncated: {
+                                        type: "boolean",
+                                        description: "True when the flow hit graph caps."
+                                    }
+                                },
+                                required: [
+                                    "start",
+                                    "steps",
+                                    "reached",
+                                    "anchors"
+                                ],
+                                additionalProperties: false
+                            },
+                            "ITtscGraphTour.INode": {
+                                type: "object",
+                                properties: {
+                                    decorators: {
+                                        type: "array",
+                                        items: {
+                                            $ref: "#/$defs/ITtscGraphDecorator"
+                                        },
+                                        description: "Decorators written on the declaration, when any."
+                                    },
+                                    file: {
+                                        type: "string",
+                                        description: "Project-relative declaration file."
+                                    },
+                                    id: {
+                                        type: "string",
+                                        description: "Stable node id for later graph calls."
+                                    },
+                                    kind: {
+                                        type: "string",
+                                        description: "Declaration kind (`class`, `method`, `function`, ...)."
+                                    },
+                                    line: {
+                                        type: "number",
+                                        description: "1-based declaration line, when known."
+                                    },
+                                    name: {
+                                        type: "string",
+                                        description: "Qualified symbol name when available, otherwise the simple name."
+                                    },
+                                    signature: {
+                                        type: "string",
+                                        description: "Declaration head, when available."
+                                    },
+                                    sourceSpan: {
+                                        $ref: "#/$defs/ITtscGraphTour.ISpan",
+                                        description: "Declaration or implementation range, when known."
+                                    }
+                                },
+                                required: [
+                                    "id",
+                                    "name",
+                                    "kind",
+                                    "file"
+                                ],
+                                additionalProperties: false
+                            },
+                            "ITtscGraphTour.ISpan": {
+                                type: "object",
+                                properties: {
+                                    endLine: {
+                                        type: "number",
+                                        description: "1-based end line, when known."
+                                    },
+                                    file: {
+                                        type: "string",
+                                        description: "Project-relative file."
+                                    },
+                                    startLine: {
+                                        type: "number",
+                                        description: "1-based start line."
+                                    }
+                                },
+                                required: [
+                                    "file",
+                                    "startLine"
+                                ],
+                                additionalProperties: false
+                            },
                             ITtscGraphTrace: {
                                 type: "object",
                                 properties: {
@@ -964,7 +1270,12 @@ function createServer(graph, version) {
                                         description: "When `from` was an ambiguous name, the matches to disambiguate with."
                                     },
                                     direction: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Trace direction actually used by this result."
+                                    },
+                                    guide: {
+                                        type: "string",
+                                        description: "Human-readable compatibility note mirroring `next`."
                                     },
                                     hops: {
                                         type: "array",
@@ -974,8 +1285,8 @@ function createServer(graph, version) {
                                         description: "Edges traversed, in breadth-first order."
                                     },
                                     next: {
-                                        $ref: "#/$defs/ITtscGraphTrace.INext",
-                                        description: "Follow-up handles for inspecting or continuing the trace."
+                                        $ref: "#/$defs/ITtscGraphNext",
+                                        description: "How to use this source-free result next."
                                     },
                                     path: {
                                         type: "array",
@@ -1016,7 +1327,9 @@ function createServer(graph, version) {
                                     "direction",
                                     "hops",
                                     "reached",
-                                    "truncated"
+                                    "truncated",
+                                    "next",
+                                    "guide"
                                 ],
                                 additionalProperties: false
                             },
@@ -1036,16 +1349,19 @@ function createServer(graph, version) {
                                     },
                                     evidence: {
                                         $ref: "#/$defs/ITtscGraphEvidence",
-                                        description: "Source span for the expression that produced this hop. It lets an agent\nexplain why the trace moves from one symbol to the next without opening\nthe file."
+                                        description: "Source span for the expression that produced this hop. It is repository\nevidence for the hop and can be cited without opening the file."
                                     },
                                     from: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Source node id for this traversed edge."
                                     },
                                     kind: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Edge kind (`calls`, `type_ref`, `accesses`, ...)."
                                     },
                                     to: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Target node id for this traversed edge."
                                     }
                                 },
                                 required: [
@@ -1056,30 +1372,6 @@ function createServer(graph, version) {
                                 ],
                                 additionalProperties: false
                             },
-                            "ITtscGraphTrace.INext": {
-                                type: "object",
-                                properties: {
-                                    details: {
-                                        type: "array",
-                                        items: {
-                                            type: "string"
-                                        },
-                                        description: "Pass these ids to `details` for selected symbol details."
-                                    },
-                                    traceFrom: {
-                                        type: "array",
-                                        items: {
-                                            type: "string"
-                                        },
-                                        description: "Continue tracing from these ids when the current result is intermediate."
-                                    }
-                                },
-                                required: [
-                                    "details",
-                                    "traceFrom"
-                                ],
-                                additionalProperties: false
-                            },
                             "ITtscGraphTrace.INode": {
                                 type: "object",
                                 properties: {
@@ -1088,16 +1380,24 @@ function createServer(graph, version) {
                                         description: "Hops from the start, on a reached node."
                                     },
                                     file: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Project-relative path of the declaration file."
                                     },
                                     id: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Stable node id for subsequent graph calls."
                                     },
                                     kind: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Declaration kind (`class`, `method`, `function`, ...)."
+                                    },
+                                    line: {
+                                        type: "number",
+                                        description: "1-based declaration line, when known."
                                     },
                                     name: {
-                                        type: "string"
+                                        type: "string",
+                                        description: "Qualified symbol name when available, otherwise the simple name."
                                     },
                                     roles: {
                                         type: "array",
@@ -1109,6 +1409,10 @@ function createServer(graph, version) {
                                     signature: {
                                         type: "string",
                                         description: "The node's signature, carried on path nodes so the path explains itself."
+                                    },
+                                    sourceSpan: {
+                                        $ref: "#/$defs/PickITtscGraphEvidenceendLinefilestartLine",
+                                        description: "Declaration or implementation citation range, when known."
                                     }
                                 },
                                 required: [
@@ -1155,16 +1459,12 @@ function createServer(graph, version) {
                         type: "object",
                         properties: {
                             draft: {
-                                $ref: "#/$defs/ITtscGraphApplication.IRequestDraft",
-                                description: "First request-type decision before arguments are filled.\n\nExplain why one operation class is smaller than the alternatives, then\nname it in `draft.type`. This is only the draft; the final arguments are\nin `request` after `review`."
-                            },
-                            graphNeed: {
                                 type: "string",
-                                description: "Why the resident graph is the next evidence source.\n\nState what graph evidence is needed and why assumptions or broad shell\nsearch are not the next step for this call. Name the smallest evidence\nthat would let the agent stop. If graph is not actually the right source,\nsay that and use `escape`."
+                                description: "Initial request plan before final arguments are filled.\n\nName the intended request type and why it seems smallest. Broad flow,\narchitecture, repository-orientation, and read-next questions should\nnormally draft `tour`; narrow named symbols can draft `lookup`, `trace`,\nor `details`."
                             },
                             question: {
                                 type: "string",
-                                description: "User's TypeScript code question.\n\nRestate the codebase question being answered. Keep this about TypeScript\nsource, symbols, call flow, type flow, or architecture. If the user is\nasking about scripts, config, generated output, or documentation instead,\nsay that boundary here."
+                                description: "User's TypeScript code question.\n\nRestate the code question being considered. If the next evidence is a\nscript, config, doc, generated output, exact text, non-TypeScript file,\nor source body text, choose `escape`."
                             },
                             request: {
                                 anyOf: [
@@ -1180,6 +1480,9 @@ function createServer(graph, version) {
                                     {
                                         $ref: "#/$defs/ITtscGraphOverview.IRequest"
                                     },
+                                    {
+                                        $ref: "#/$defs/ITtscGraphTour.IRequest"
+                                    },
                                     {
                                         $ref: "#/$defs/ITtscGraphTrace.IRequest"
                                     },
@@ -1187,7 +1490,7 @@ function createServer(graph, version) {
                                         $ref: "#/$defs/ITtscGraphEscape.IRequest"
                                     }
                                 ],
-                                description: "The graph operation chosen from the reasoning above, or a no-op escape.",
+                                description: "Final graph operation chosen after review, or a no-op escape.",
                                 "x-discriminator": {
                                     mapping: {
                                         details: "#/$defs/ITtscGraphDetails.IRequest",
@@ -1195,6 +1498,7 @@ function createServer(graph, version) {
                                         escape: "#/$defs/ITtscGraphEscape.IRequest",
                                         lookup: "#/$defs/ITtscGraphLookup.IRequest",
                                         overview: "#/$defs/ITtscGraphOverview.IRequest",
+                                        tour: "#/$defs/ITtscGraphTour.IRequest",
                                         trace: "#/$defs/ITtscGraphTrace.IRequest"
                                     },
                                     propertyName: "type"
@@ -1202,44 +1506,17 @@ function createServer(graph, version) {
                             },
                             review: {
                                 type: "string",
-                                description: "Critical review of the draft request.\n\nCheck whether the draft avoids overfetch, non-graph fallback, broad\nreads, and unnecessary neighbor expansion. If this would be a fourth\nbroad lookup, trace, or details call, prefer answering from evidence in\nhand or choose `escape`. Do not spend graph calls only to hunt for tests.\nIf the draft is wrong, choose the corrected type in `request`."
+                                description: "Final self-review before calling.\n\nCorrect a stale, broad, duplicate, or wrong draft here. If broad flow was\nsplit into search/detail steps, switch to `tour`. If graph facts already\nanswer, or prior `next.action` was `answer`, make `request.type` be\n`escape`; do not call graph or read files to re-confirm returned facts."
                             }
                         },
                         required: [
                             "question",
-                            "graphNeed",
                             "draft",
                             "review",
                             "request"
                         ],
                         additionalProperties: false,
                         $defs: {
-                            "ITtscGraphApplication.IRequestDraft": {
-                                type: "object",
-                                properties: {
-                                    type: {
-                                        type: "string",
-                                        "enum": [
-                                            "details",
-                                            "entrypoints",
-                                            "escape",
-                                            "lookup",
-                                            "overview",
-                                            "trace"
-                                        ],
-                                        description: "Draft discriminator for the intended graph operation."
-                                    },
-                                    reason: {
-                                        type: "string",
-                                        description: "Why this operation type is the smallest useful next step."
-                                    }
-                                },
-                                required: [
-                                    "reason",
-                                    "type"
-                                ],
-                                additionalProperties: false
-                            },
                             "ITtscGraphDetails.IRequest": {
                                 type: "object",
                                 properties: {
@@ -1252,26 +1529,30 @@ function createServer(graph, version) {
                                     },
                                     dependencyLimit: {
                                         type: "number",
-                                        description: "Maximum direct execution and type references to return per group. Raise\nonly when the first dependency slice is not enough."
+                                        description: "Maximum direct execution and type references to return per group. Raise\nonly when the first dependency slice is truncated and the missing\ndependency is named."
                                     },
                                     handles: {
                                         type: "array",
                                         items: {
                                             type: "string"
                                         },
-                                        description: "Node ids from another tool, or dotted symbol handles such as\n`OrderService.create`. Pass the few handles you need for source-free\ndetails; use `trace` when you need a path instead of widening this call."
+                                        description: "Node ids from another tool, or dotted symbol handles such as\n`OrderService.create`. Pass the few handles you need for source-free\ndetails. Prefer one to three handles. Use `trace` when you need a path\ninstead of widening this call."
+                                    },
+                                    includeExternal: {
+                                        type: "boolean",
+                                        description: "Include dependency-boundary references from node_modules or bundled\n`.d.ts` libraries. Leave false for source-architecture answers; enable\nonly when external type/API boundaries are the question."
                                     },
                                     memberLimit: {
                                         type: "number",
-                                        description: "Maximum owned members to return for a container or object literal. Raise\nonly when the first outline is truncated."
+                                        description: "Maximum owned members to return for a container or object literal. Raise\nonly when the first outline is truncated and the missing member is\nnamed."
                                     },
                                     neighborLimit: {
                                         type: "number",
-                                        description: "Maximum dependencies and dependents to return per side when\n`neighbors:true`."
+                                        description: "Maximum dependencies and dependents to return per side when\n`neighbors:true`.\n\nPrefer the default. Values above a few neighbors are usually overfetch;\ncall `trace` for flow instead."
                                     },
                                     neighbors: {
                                         type: "boolean",
-                                        description: "Also list each node's direct dependencies and dependents (the symbols it\nuses and the symbols that use it). The list is capped; raise\n`neighborLimit` only when the first slice is not enough."
+                                        description: "Also list each node's direct dependencies and dependents (the symbols it\nuses and the symbols that use it). The list is capped; raise\n`neighborLimit` when the first slice is truncated and the missing\nrelation is named. This remains a relationship summary, not a file body."
                                     }
                                 },
                                 required: [
@@ -1292,15 +1573,15 @@ function createServer(graph, version) {
                                     },
                                     limit: {
                                         type: "number",
-                                        description: "Maximum ranked hits to return."
+                                        description: "Maximum ranked hits to return.\n\nPrefer the default. Raise only when the first result was truncated and\nthe missing handle is named."
                                     },
                                     neighbors: {
                                         type: "number",
-                                        description: "Maximum direct dependencies and dependents to return per indexed symbol.\nThis is an orientation slice, not a dependency dump; use `trace` or\n`details` with `neighbors:true` after choosing the specific handles."
+                                        description: "Maximum direct dependencies and dependents to return per indexed symbol.\nThis is an orientation slice, not a dependency dump; use `trace` or\n`details` with `neighbors:true` after choosing the specific handles.\nPrefer the default zero for the first call."
                                     },
                                     query: {
                                         type: "string",
-                                        description: "A natural code question or search phrase. Mix prose with code handles,\nfor example `how Repository.find loads relations` or\n`SelectQueryBuilder.setFindOptions join aliases`."
+                                        description: "A natural code question or search phrase. Mix prose with code handles,\nfor example `how Repository.find loads relations` or\n`SelectQueryBuilder.setFindOptions join aliases`. Keep this close to the\nuser's question; do not turn it into a broad keyword dump."
                                     }
                                 },
                                 required: [
@@ -1321,11 +1602,11 @@ function createServer(graph, version) {
                                     },
                                     nextStep: {
                                         type: "string",
-                                        description: "The next non-graph step, if useful.\n\nKeep this short. Examples: `answer from the prior graph result`, `inspect\npackage.json`, or `ask the user for a concrete symbol`."
+                                        description: "The final non-graph note, if useful.\n\nKeep this short. Examples: `answer from the prior graph result`, `source\nbody needed at returned sourceSpan`, or `ask the user for a concrete\nsymbol`."
                                     },
                                     reason: {
                                         type: "string",
-                                        description: "Why no graph operation should run.\n\nUse this when the review finds the user is asking about package scripts,\nconfig files, generated output, prose documentation, or an answer that\nthe current graph result already settled."
+                                        description: "Why no graph operation should run.\n\nUse this only when the next evidence is outside the indexed TypeScript\ngraph: package scripts, config files, generated output, prose docs, exact\ntext, or exact source body text. Name the smallest returned sourceSpan\nwhen source body text is truly required."
                                     }
                                 },
                                 required: [
@@ -1344,13 +1625,17 @@ function createServer(graph, version) {
                                         ],
                                         description: "Discriminator for targeted symbol lookup."
                                     },
+                                    includeExternal: {
+                                        type: "boolean",
+                                        description: "Include dependency-boundary declarations from node_modules or bundled\n`.d.ts` libraries. Leave false for project-source answers; enable only\nwhen external type/API boundaries are the question."
+                                    },
                                     limit: {
                                         type: "number",
-                                        description: "Maximum hits to return."
+                                        description: "Maximum hits to return.\n\nPrefer the default. Large hit lists usually mean the query is too broad;\nrefine the name instead of raising this."
                                     },
                                     query: {
                                         type: "string",
-                                        description: "What to find, in natural language and code vocabulary mixed freely: a\nsymbol name, a dotted member (`OrderService.create`), or a phrase\n(`shopping order create`, `repository find relations`). Exact names are\nnot required; subword and CamelCase matches rank too."
+                                        description: "What to find, in natural language and code vocabulary mixed freely: a\nsymbol name, a dotted member (`Service.create`), or a short phrase\n(`request handler`). Exact names are not required, but this is not a\nsecond broad entrypoints call. Use it when a named handle is missing or\nambiguous."
                                     }
                                 },
                                 required: [
@@ -1377,7 +1662,7 @@ function createServer(graph, version) {
                                             "layers",
                                             "publicApi"
                                         ],
-                                        description: "The facet to project, or `all` for every facet. `layers` is the folder\nlayering, `hotspots` the highest-dependency symbols, `publicApi` the\nexported API symbols ranked by how depended-on they are."
+                                        description: "The facet to project, or `all` for every facet. `layers` is the folder\nlayering, `hotspots` the highest-dependency symbols, `publicApi` the\nexported API symbols ranked by how depended-on they are.\n\nUse this only for broad public API or layer orientation. For behavior,\nlifecycle, request-flow, rendering-flow, validation-flow, caller, or\ndependency questions, use `entrypoints` then `trace` instead."
                                     }
                                 },
                                 required: [
@@ -1385,6 +1670,35 @@ function createServer(graph, version) {
                                 ],
                                 additionalProperties: false
                             },
+                            "ITtscGraphTour.IRequest": {
+                                type: "object",
+                                properties: {
+                                    type: {
+                                        type: "string",
+                                        "enum": [
+                                            "tour"
+                                        ],
+                                        description: "Discriminator for code-tour indexing."
+                                    },
+                                    includeTests: {
+                                        type: "boolean",
+                                        description: "Include graph-reached test or usage anchors when available."
+                                    },
+                                    limit: {
+                                        type: "number",
+                                        description: "Maximum central entrypoints to seed the tour.\n\nPrefer the default. Raise only when the question names several distinct\npublic paths that must all appear in one answer."
+                                    },
+                                    query: {
+                                        type: "string",
+                                        description: "The user's natural code-tour question."
+                                    }
+                                },
+                                required: [
+                                    "type",
+                                    "query"
+                                ],
+                                additionalProperties: false
+                            },
                             "ITtscGraphTrace.IRequest": {
                                 type: "object",
                                 properties: {
@@ -1402,7 +1716,7 @@ function createServer(graph, version) {
                                             "impact",
                                             "reverse"
                                         ],
-                                        description: "`forward` follows what the start uses (callees, instantiations, renders);\n`reverse` follows what uses the start (callers); `impact` is a reverse\ntrace that flags the public API and tests a change would reach."
+                                        description: "`forward` follows what the start uses (callees, instantiations, renders);\n`reverse` follows what uses the start (callers); `impact` is a reverse\ntrace that prioritizes public API and test nodes a change would reach.\nIts test nodes are semantic usage edges, not a text-search inventory.\nCaller questions usually fit `reverse`."
                                     },
                                     focus: {
                                         type: "string",
@@ -1411,23 +1725,27 @@ function createServer(graph, version) {
                                             "execution",
                                             "types"
                                         ],
-                                        description: "Which non-structural edge family to follow: `execution` follows runtime\ncalls, instantiations, property access, and JSX renders; `types` follows\ntype references and inheritance; `all` preserves the full graph."
+                                        description: "Which non-structural edge family to follow: `execution` follows runtime\ncalls, instantiations, property access, and JSX renders; `types` follows\ntype references and inheritance; `all` preserves the full graph. Flow\nquestions should usually choose `execution` rather than `all`."
                                     },
                                     from: {
                                         type: "string",
                                         description: "Where to start: a node id from another tool, a simple symbol name, or a\ndotted member name such as `OrderService.create`. An ambiguous name\nreturns its candidates instead of a trace."
                                     },
+                                    includeExternal: {
+                                        type: "boolean",
+                                        description: "Include dependency-boundary nodes from node_modules or bundled `.d.ts`\nlibraries. Leave false for source-flow tours; enable only when the user\nasks about external type/API boundaries."
+                                    },
                                     maxDepth: {
                                         type: "number",
-                                        description: "How many hops deep to follow. Open traces are capped at 2; path mode is\ncapped at 12."
+                                        description: "How many hops deep to follow. Open forward/reverse traces are capped at\n2; impact traces at 4; path mode at 12.\n\nPrefer the default for open traces. Raise only for path mode or when the\nprevious trace named the missing next hop."
                                     },
                                     maxNodes: {
                                         type: "number",
-                                        description: "Cap on reached nodes; the trace stops and marks itself truncated past it.\nOpen traces are capped at 10 nodes so a broad graph cannot flood\ncontext."
+                                        description: "Cap on reached nodes; the trace stops and marks itself truncated past it.\nOpen forward/reverse traces are capped at 8 nodes, impact at 16 nodes.\n\nPrefer the default; use larger open traces only when a named missing edge\nrequires it."
                                     },
                                     to: {
                                         type: "string",
-                                        description: "A target symbol: node id, simple symbol name, or dotted member name. When\ngiven, the tool returns the dependency path from `from` to this target,\nthe one-call answer for \"how does A reach B\", instead of an open-ended\ntrace."
+                                        description: "A target symbol: node id, simple symbol name, or dotted member name. When\ngiven, the tool returns the dependency path from `from` to this target,\nthe one-call answer for \"how does A reach B\", instead of an open-ended\ntrace. Prefer this path mode whenever both ends are known."
                                     }
                                 },
                                 required: [
@@ -1439,22 +1757,24 @@ function createServer(graph, version) {
                         }
                     },
                     validate: (() => {
-                        const _io0 = input => "string" === typeof input.question && "string" === typeof input.graphNeed && ("object" === typeof input.draft && null !== input.draft && _io1(input.draft)) && "string" === typeof input.review && ("object" === typeof input.request && null !== input.request && _iu0(input.request));
-                        const _io1 = input => "string" === typeof input.reason && ("details" === input.type || "entrypoints" === input.type || "escape" === input.type || "lookup" === input.type || "overview" === input.type || "trace" === input.type);
-                        const _io2 = input => "details" === input.type && (Array.isArray(input.handles) && input.handles.every(elem => "string" === typeof elem)) && (undefined === input.neighbors || "boolean" === typeof input.neighbors) && (undefined === input.neighborLimit || "number" === typeof input.neighborLimit) && (undefined === input.memberLimit || "number" === typeof input.memberLimit) && (undefined === input.dependencyLimit || "number" === typeof input.dependencyLimit);
-                        const _io3 = input => "entrypoints" === input.type && "string" === typeof input.query && (undefined === input.limit || "number" === typeof input.limit) && (undefined === input.neighbors || "number" === typeof input.neighbors);
-                        const _io4 = input => "lookup" === input.type && "string" === typeof input.query && (undefined === input.limit || "number" === typeof input.limit);
-                        const _io5 = input => "overview" === input.type && (undefined === input.aspect || "all" === input.aspect || "hotspots" === input.aspect || "layers" === input.aspect || "publicApi" === input.aspect);
-                        const _io6 = input => "trace" === input.type && "string" === typeof input.from && (undefined === input.to || "string" === typeof input.to) && (undefined === input.direction || "forward" === input.direction || "impact" === input.direction || "reverse" === input.direction) && (undefined === input.focus || "all" === input.focus || "execution" === input.focus || "types" === input.focus) && (undefined === input.maxDepth || "number" === typeof input.maxDepth) && (undefined === input.maxNodes || "number" === typeof input.maxNodes);
+                        const _io0 = input => "string" === typeof input.question && "string" === typeof input.draft && "string" === typeof input.review && ("object" === typeof input.request && null !== input.request && _iu0(input.request));
+                        const _io1 = input => "details" === input.type && (Array.isArray(input.handles) && input.handles.every(elem => "string" === typeof elem)) && (undefined === input.neighbors || "boolean" === typeof input.neighbors) && (undefined === input.neighborLimit || "number" === typeof input.neighborLimit) && (undefined === input.memberLimit || "number" === typeof input.memberLimit) && (undefined === input.dependencyLimit || "number" === typeof input.dependencyLimit) && (undefined === input.includeExternal || "boolean" === typeof input.includeExternal);
+                        const _io2 = input => "entrypoints" === input.type && "string" === typeof input.query && (undefined === input.limit || "number" === typeof input.limit) && (undefined === input.neighbors || "number" === typeof input.neighbors);
+                        const _io3 = input => "lookup" === input.type && "string" === typeof input.query && (undefined === input.limit || "number" === typeof input.limit) && (undefined === input.includeExternal || "boolean" === typeof input.includeExternal);
+                        const _io4 = input => "overview" === input.type && (undefined === input.aspect || "all" === input.aspect || "hotspots" === input.aspect || "layers" === input.aspect || "publicApi" === input.aspect);
+                        const _io5 = input => "tour" === input.type && "string" === typeof input.query && (undefined === input.limit || "number" === typeof input.limit) && (undefined === input.includeTests || "boolean" === typeof input.includeTests);
+                        const _io6 = input => "trace" === input.type && "string" === typeof input.from && (undefined === input.to || "string" === typeof input.to) && (undefined === input.direction || "forward" === input.direction || "impact" === input.direction || "reverse" === input.direction) && (undefined === input.focus || "all" === input.focus || "execution" === input.focus || "types" === input.focus) && (undefined === input.maxDepth || "number" === typeof input.maxDepth) && (undefined === input.maxNodes || "number" === typeof input.maxNodes) && (undefined === input.includeExternal || "boolean" === typeof input.includeExternal);
                         const _io7 = input => "escape" === input.type && "string" === typeof input.reason && (undefined === input.nextStep || "string" === typeof input.nextStep);
                         const _iu0 = input => (() => {
                             if ("details" === input.type)
-                                return _io2(input);
+                                return _io1(input);
                             else if ("entrypoints" === input.type)
-                                return _io3(input);
+                                return _io2(input);
                             else if ("lookup" === input.type)
-                                return _io4(input);
+                                return _io3(input);
                             else if ("overview" === input.type)
+                                return _io4(input);
+                            else if ("tour" === input.type)
                                 return _io5(input);
                             else if ("trace" === input.type)
                                 return _io6(input);
@@ -1467,17 +1787,9 @@ function createServer(graph, version) {
                                 path: _path + ".question",
                                 expected: "string",
                                 value: input.question
-                            }), "string" === typeof input.graphNeed || _report(_exceptionable, {
-                                path: _path + ".graphNeed",
-                                expected: "string",
-                                value: input.graphNeed
-                            }), ("object" === typeof input.draft && null !== input.draft || _report(_exceptionable, {
+                            }), "string" === typeof input.draft || _report(_exceptionable, {
                                 path: _path + ".draft",
-                                expected: "ITtscGraphApplication.IRequestDraft",
-                                value: input.draft
-                            })) && _vo1(input.draft, _path + ".draft", true && _exceptionable) || _report(_exceptionable, {
-                                path: _path + ".draft",
-                                expected: "ITtscGraphApplication.IRequestDraft",
+                                expected: "string",
                                 value: input.draft
                             }), "string" === typeof input.review || _report(_exceptionable, {
                                 path: _path + ".review",
@@ -1485,23 +1797,14 @@ function createServer(graph, version) {
                                 value: input.review
                             }), ("object" === typeof input.request && null !== input.request || _report(_exceptionable, {
                                 path: _path + ".request",
-                                expected: "(ITtscGraphDetails.IRequest | ITtscGraphEntrypoints.IRequest | ITtscGraphEscape.IRequest | ITtscGraphLookup.IRequest | ITtscGraphOverview.IRequest | ITtscGraphTrace.IRequest)",
+                                expected: "(ITtscGraphDetails.IRequest | ITtscGraphEntrypoints.IRequest | ITtscGraphEscape.IRequest | ITtscGraphLookup.IRequest | ITtscGraphOverview.IRequest | ITtscGraphTour.IRequest | ITtscGraphTrace.IRequest)",
                                 value: input.request
                             })) && _vu0(input.request, _path + ".request", true && _exceptionable) || _report(_exceptionable, {
                                 path: _path + ".request",
-                                expected: "(ITtscGraphDetails.IRequest | ITtscGraphEntrypoints.IRequest | ITtscGraphEscape.IRequest | ITtscGraphLookup.IRequest | ITtscGraphOverview.IRequest | ITtscGraphTrace.IRequest)",
+                                expected: "(ITtscGraphDetails.IRequest | ITtscGraphEntrypoints.IRequest | ITtscGraphEscape.IRequest | ITtscGraphLookup.IRequest | ITtscGraphOverview.IRequest | ITtscGraphTour.IRequest | ITtscGraphTrace.IRequest)",
                                 value: input.request
                             })].every(flag => flag);
-                        const _vo1 = (input, _path, _exceptionable = true) => ["string" === typeof input.reason || _report(_exceptionable, {
-                                path: _path + ".reason",
-                                expected: "string",
-                                value: input.reason
-                            }), "details" === input.type || "entrypoints" === input.type || "escape" === input.type || "lookup" === input.type || "overview" === input.type || "trace" === input.type || _report(_exceptionable, {
-                                path: _path + ".type",
-                                expected: "(\"details\" | \"entrypoints\" | \"escape\" | \"lookup\" | \"overview\" | \"trace\")",
-                                value: input.type
-                            })].every(flag => flag);
-                        const _vo2 = (input, _path, _exceptionable = true) => ["details" === input.type || _report(_exceptionable, {
+                        const _vo1 = (input, _path, _exceptionable = true) => ["details" === input.type || _report(_exceptionable, {
                                 path: _path + ".type",
                                 expected: "\"details\"",
                                 value: input.type
@@ -1533,8 +1836,12 @@ function createServer(graph, version) {
                                 path: _path + ".dependencyLimit",
                                 expected: "(number | undefined)",
                                 value: input.dependencyLimit
+                            }), undefined === input.includeExternal || "boolean" === typeof input.includeExternal || _report(_exceptionable, {
+                                path: _path + ".includeExternal",
+                                expected: "(boolean | undefined)",
+                                value: input.includeExternal
                             })].every(flag => flag);
-                        const _vo3 = (input, _path, _exceptionable = true) => ["entrypoints" === input.type || _report(_exceptionable, {
+                        const _vo2 = (input, _path, _exceptionable = true) => ["entrypoints" === input.type || _report(_exceptionable, {
                                 path: _path + ".type",
                                 expected: "\"entrypoints\"",
                                 value: input.type
@@ -1551,7 +1858,7 @@ function createServer(graph, version) {
                                 expected: "(number | undefined)",
                                 value: input.neighbors
                             })].every(flag => flag);
-                        const _vo4 = (input, _path, _exceptionable = true) => ["lookup" === input.type || _report(_exceptionable, {
+                        const _vo3 = (input, _path, _exceptionable = true) => ["lookup" === input.type || _report(_exceptionable, {
                                 path: _path + ".type",
                                 expected: "\"lookup\"",
                                 value: input.type
@@ -1563,8 +1870,12 @@ function createServer(graph, version) {
                                 path: _path + ".limit",
                                 expected: "(number | undefined)",
                                 value: input.limit
+                            }), undefined === input.includeExternal || "boolean" === typeof input.includeExternal || _report(_exceptionable, {
+                                path: _path + ".includeExternal",
+                                expected: "(boolean | undefined)",
+                                value: input.includeExternal
                             })].every(flag => flag);
-                        const _vo5 = (input, _path, _exceptionable = true) => ["overview" === input.type || _report(_exceptionable, {
+                        const _vo4 = (input, _path, _exceptionable = true) => ["overview" === input.type || _report(_exceptionable, {
                                 path: _path + ".type",
                                 expected: "\"overview\"",
                                 value: input.type
@@ -1573,6 +1884,23 @@ function createServer(graph, version) {
                                 expected: "(\"all\" | \"hotspots\" | \"layers\" | \"publicApi\" | undefined)",
                                 value: input.aspect
                             })].every(flag => flag);
+                        const _vo5 = (input, _path, _exceptionable = true) => ["tour" === input.type || _report(_exceptionable, {
+                                path: _path + ".type",
+                                expected: "\"tour\"",
+                                value: input.type
+                            }), "string" === typeof input.query || _report(_exceptionable, {
+                                path: _path + ".query",
+                                expected: "string",
+                                value: input.query
+                            }), undefined === input.limit || "number" === typeof input.limit || _report(_exceptionable, {
+                                path: _path + ".limit",
+                                expected: "(number | undefined)",
+                                value: input.limit
+                            }), undefined === input.includeTests || "boolean" === typeof input.includeTests || _report(_exceptionable, {
+                                path: _path + ".includeTests",
+                                expected: "(boolean | undefined)",
+                                value: input.includeTests
+                            })].every(flag => flag);
                         const _vo6 = (input, _path, _exceptionable = true) => ["trace" === input.type || _report(_exceptionable, {
                                 path: _path + ".type",
                                 expected: "\"trace\"",
@@ -1601,6 +1929,10 @@ function createServer(graph, version) {
                                 path: _path + ".maxNodes",
                                 expected: "(number | undefined)",
                                 value: input.maxNodes
+                            }), undefined === input.includeExternal || "boolean" === typeof input.includeExternal || _report(_exceptionable, {
+                                path: _path + ".includeExternal",
+                                expected: "(boolean | undefined)",
+                                value: input.includeExternal
                             })].every(flag => flag);
                         const _vo7 = (input, _path, _exceptionable = true) => ["escape" === input.type || _report(_exceptionable, {
                                 path: _path + ".type",
@@ -1617,12 +1949,14 @@ function createServer(graph, version) {
                             })].every(flag => flag);
                         const _vu0 = (input, _path, _exceptionable = true) => (() => {
                             if ("details" === input.type)
-                                return _vo2(input, _path, true && _exceptionable);
+                                return _vo1(input, _path, true && _exceptionable);
                             else if ("entrypoints" === input.type)
-                                return _vo3(input, _path, true && _exceptionable);
+                                return _vo2(input, _path, true && _exceptionable);
                             else if ("lookup" === input.type)
-                                return _vo4(input, _path, true && _exceptionable);
+                                return _vo3(input, _path, true && _exceptionable);
                             else if ("overview" === input.type)
+                                return _vo4(input, _path, true && _exceptionable);
+                            else if ("tour" === input.type)
                                 return _vo5(input, _path, true && _exceptionable);
                             else if ("trace" === input.type)
                                 return _vo6(input, _path, true && _exceptionable);
@@ -1631,7 +1965,7 @@ function createServer(graph, version) {
                             else
                                 return _report(_exceptionable, {
                                     path: _path,
-                                    expected: "(ITtscGraphDetails.IRequest | ITtscGraphEntrypoints.IRequest | ITtscGraphLookup.IRequest | ITtscGraphOverview.IRequest | ITtscGraphTrace.IRequest | ITtscGraphEscape.IRequest)",
+                                    expected: "(ITtscGraphDetails.IRequest | ITtscGraphEntrypoints.IRequest | ITtscGraphLookup.IRequest | ITtscGraphOverview.IRequest | ITtscGraphTour.IRequest | ITtscGraphTrace.IRequest | ITtscGraphEscape.IRequest)",
                                     value: input
                                 });
                         })();