Server definition
- Hash
- sha256:5332935a6967d72478daf9e9a468a1679aeb305c3934a8a34bde633bbae4dc63
- What it is
- What a remote MCP server returned when asked what it offers: 25 tools
The blob, as servednamed by its sha256
{
"instructions": "Symvanta gives your AI coding agent your codebase's real call graph over MCP, so it stops guessing and knows what breaks before it edits.\n\nDo NOT shell out to grep, rg, find, cat, or ls on indexed repos. Use these tools (one call per question):\n behavior / 'how does X work' -> ask_codebase (scope:\"all\" cross-repo)\n symbol definition + signature -> find_node\n who calls X -> relate (kind:callers)\n what X depends on -> relate (kind:dependencies)\n what breaks if X changes -> relate (kind:blast_radius)\n what implements interface X -> relate (kind:implementers)\n type hierarchy of X -> relate (kind:heritage)\n trace polymorphism / DI, or class runtime order -> relate (kind:chain[, staysWithinClass:true])\n how are X and Y connected -> relate (kind:path, selectors:[from, to])\n literal identifier or string -> locate (mode:text; queries:[...] for several terms)\n HTTP route by path+method -> find_http_route\n env var / config key usage -> locate (mode:config; queries:[...] for several keys)\n repo or subtree skeleton -> map\n symbols in a file -> list_file_symbols\n what a diff / branch breaks -> diff_impact\n record/read the WHY (decisions) -> adr (op:record|list); find_node attaches them\n pattern discovery -> locate (mode:semantic)\n locate (mode:text) empty -> locate with no mode (auto-routes to semantic); never retry mode:text reworded\nFeedback: every ask_codebase answer carries an answer_id; report the outcome with feedback:{answerId,outcome:\"useful\"|\"dead_end\"|\"corrected\"} on any later tool call, and read the `lesson`/`lessons` hints on find_node / context / citations for known-good vs contested anchors.\nSource: the index returns filePath + line bounds + signature, not full source. Local Read only if the signature is insufficient; trust the live file over the index.\nPaths: every filePath is repo-relative logical (e.g. \"src/user/email.js\"), NOT \"<repo>/<path>\". Map it to your local layout before reading; pass the logical form for filePath inputs too.\nBranches: reads default to the default branch. Pin a feature branch with ref(op:\"use\", repository, branch), revert with ref(op:\"clear\"); the branch must be tracked first (same-repo PR, dashboard, or SessionStart hook). For UNCOMMITTED edits use ref(op:\"index_working_tree\", repository, changedFiles:[{path,content}]) to overlay + auto-pin (source and locate mode:semantic do NOT reflect it). commitSha overrides any pin.",
"tools": [
{
"description": "Attach a public GitHub repository to the active project (owner + repo_name; clone URL derived). Idempotent. First attach dispatches an indexing job; response carries indexing_status (\"queued\" | \"already_indexed\") and indexing_job_id to poll. Data available once the index is stable.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"default_branch": {
"description": "Default branch (default main)",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"owner": {
"description": "GitHub owner (user or org)",
"maxLength": 255,
"minLength": 1,
"pattern": "^[a-zA-Z0-9\\-_.]+$",
"type": "string"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repo_name": {
"description": "Repository name",
"maxLength": 255,
"minLength": 1,
"pattern": "^[a-zA-Z0-9\\-_.]+$",
"type": "string"
}
},
"required": [
"owner",
"repo_name"
],
"type": "object"
},
"name": "add_repository",
"outputSchema": null
},
{
"description": "Architecture decision records: the WHY behind code, anchored to a symbol/file/project. Survive reindexes; find_node attaches a node's decisions. Ops:\n- record: needs title+decision. Anchor with repository+symbolPath or +filePath; omit both for project-wide. Optional context, consequences, status.\n- list: records for a project, filter by repository/symbolPath/filePath/status.\n- update: needs id; status:\"superseded\"+supersededById, or \"deprecated\".",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"consequences": {
"description": "Trade-offs accepted.",
"maxLength": 20000,
"type": "string"
},
"context": {
"description": "Why (constraints, alternatives rejected).",
"maxLength": 20000,
"type": "string"
},
"decision": {
"description": "record: what was decided.",
"maxLength": 20000,
"minLength": 3,
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"filePath": {
"description": "Anchor: repo-relative file path.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"id": {
"description": "update: record id (from adr list or find_node decisions).",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"limit": {
"description": "list: max records (default 20).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"op": {
"description": "record: create a decision record. list: read records. update: amend or supersede one.",
"enum": [
"record",
"list",
"update"
],
"type": "string"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
},
"status": {
"description": "record/update: lifecycle status.",
"enum": [
"proposed",
"accepted",
"superseded",
"deprecated"
],
"type": "string"
},
"supersededById": {
"description": "update: id of the replacement record.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"symbolPath": {
"description": "Anchor: symbolPath as find_node / locate returns.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"title": {
"description": "record: short imperative title, e.g. \"No pgvector\".",
"maxLength": 200,
"minLength": 3,
"type": "string"
}
},
"required": [
"op"
],
"type": "object"
},
"name": "adr",
"outputSchema": null
},
{
"description": "Synthesis Q&A for behavior/architecture questions: answer + citations in one call. HEAVY (~2-4 s, ~3-5 k tokens): prefer context, find_node, or locate when they suffice. scope:\"repo\" (default) = ONE repo; scope:\"all\" = cross-repo (repositoryIds narrows, omit spans all; rejects repository). If sufficient_to_answer=true, answer without further tool calls. commitSha pins a revision.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commitSha": {
"description": "Pin reads to one indexed revision (7-40 hex). Graph tools error with revision_not_indexed when it is not an indexed revision of the scoped repository, or revision_not_servable when that revision's graph was superseded by a later reindex, and echo the revision served back as commitSha; source ops read git objects, so any commit works there. Exception: a kept revision (revisions rows flagged architectureSnapshot) still serves map view:\"architecture\" as a preserved snapshot.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"limit": {
"default": 10,
"description": "Max candidate symbols fed to synthesis (default 10, max 30).",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"query": {
"description": "Alias of question.",
"minLength": 1,
"type": "string"
},
"question": {
"description": "The behavior question, e.g. \"how does X work\".",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
},
"repositoryIds": {
"description": "scope:all only. Restrict to these encoded repository ids.",
"items": {
"description": "Encoded repository id from list_repositories.",
"minLength": 1,
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"scope": {
"default": "repo",
"description": "repo (default) = single-repo. all = cross-repo; repositoryIds narrows, omit spans all.",
"enum": [
"repo",
"all"
],
"type": "string"
}
},
"type": "object"
},
"name": "ask_codebase",
"outputSchema": null
},
{
"description": "Run up to 10 independent tool calls in parallel in one round-trip. Calls share the bundle-level project/repository scope unless a call sets its own args.repository, which scopes that call alone. Supported: locate (args.mode text|symbol|semantic|file|config, not codebase), relate (kind:callers only), find_node, list_file_symbols, find_http_route. Returns results in input order; unsupported tool names return {error}.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"calls": {
"description": "Calls to run in parallel; each uses the bundle's project/repository scope unless its args.repository names another one.",
"items": {
"properties": {
"args": {
"additionalProperties": {},
"description": "Arguments for the call",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"tool": {
"description": "Tool name to call",
"minLength": 1,
"type": "string"
}
},
"required": [
"tool",
"args"
],
"type": "object"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"commitSha": {
"description": "Pin reads to one indexed revision (7-40 hex). Graph tools error with revision_not_indexed when it is not an indexed revision of the scoped repository, or revision_not_servable when that revision's graph was superseded by a later reindex, and echo the revision served back as commitSha; source ops read git objects, so any commit works there. Exception: a kept revision (revisions rows flagged architectureSnapshot) still serves map view:\"architecture\" as a preserved snapshot.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
}
},
"required": [
"calls"
],
"type": "object"
},
"name": "bundle",
"outputSchema": null
},
{
"description": "First-touch task orientation. Pass a natural-language task; returns the top 5 relevant files with their symbols and best-matching snippets in one call (~1-1.5k tokens, ~500 ms, no LLM). Replaces chaining locate (text) + locate (semantic) + list_file_symbols. Known symbol: find_node/locate. Synthesized explanation: ask_codebase.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commitSha": {
"description": "Pin reads to one indexed revision (7-40 hex). Graph tools error with revision_not_indexed when it is not an indexed revision of the scoped repository, or revision_not_servable when that revision's graph was superseded by a later reindex, and echo the revision served back as commitSha; source ops read git objects, so any commit works there. Exception: a kept revision (revisions rows flagged architectureSnapshot) still serves map view:\"architecture\" as a preserved snapshot.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
},
"task": {
"description": "Natural-language task. Returns ranked files with symbols and matching snippets, no LLM call.",
"maxLength": 1024,
"minLength": 3,
"type": "string"
}
},
"required": [
"task"
],
"type": "object"
},
"name": "context",
"outputSchema": null
},
{
"description": "Impact of a diff between two indexed revisions of one repo (base..head): changed files + symbols, union blast radius (layers + cross-repo fallout), affected endpoints, test suites, and co-change reminders. Replaces per-symbol relate (kind:blast_radius) loops before merging. Defaults: head = session's effective revision, base = previous indexed. For UNCOMMITTED edits, run ref (op:\"index_working_tree\"), then call with no shas.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"base": {
"description": "Base revision (7-40 hex). Omit for the previous indexed.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"expansionLimit": {
"description": "Cap on impacted nodes (default 25); totals always reported.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"head": {
"description": "Head revision (7-40 hex). Omit for the session's effective revision.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"includeCrossRepo": {
"description": "Include cross-repo fallout (default true).",
"type": "boolean"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "diff_impact",
"outputSchema": null
},
{
"description": "Pre-flight estimate before graph traversal: coarse count of files a task likely touches and whether it spans layers (common/browser/node/electron-main/...) or repositories. Decides single-file edit vs consulting the graph. Heuristic, from symbol-name + text matches.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"description": {
"description": "Natural-language description of the intended change.",
"maxLength": 2000,
"minLength": 3,
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
}
},
"required": [
"description"
],
"type": "object"
},
"name": "estimate_scope",
"outputSchema": null
},
{
"description": "Resolve an HTTP route by path + optional method to endpoint + handler (filePath + line bounds). Use instead of grep/locate for URL paths: follows framework router metadata (Express, Fastify, Hono, Laravel, FastAPI, etc.) and resolves dynamic segments, prefix groups, and middleware-mounted routers text search misses.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commitSha": {
"description": "Pin reads to one indexed revision (7-40 hex). Graph tools error with revision_not_indexed when it is not an indexed revision of the scoped repository, or revision_not_servable when that revision's graph was superseded by a later reindex, and echo the revision served back as commitSha; source ops read git objects, so any commit works there. Exception: a kept revision (revisions rows flagged architectureSnapshot) still serves map view:\"architecture\" as a preserved snapshot.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"method": {
"description": "HTTP method filter, e.g. GET or POST.",
"minLength": 1,
"type": "string"
},
"path": {
"description": "Route path, e.g. \"/api/users/:id\". Partial paths match.",
"minLength": 1,
"type": "string"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
},
"name": "find_http_route",
"outputSchema": null
},
{
"description": "Resolve 1-10 symbols to filePath + line bounds + signature. selectors: array keyed by symbol (bare name) / symbolPath / filePath / nodeId; a flat query/name/single field also works. includeSource=true adds the excerpt, includeSummaries=true AI summaries. A node from a SCIP-indexed package also carries scip_package_name (and scip_package_version / scip_manager when known). For a class/interface/struct/protocol it carries a compact heritage field (<=5 ancestors, <=20 descendants, omitted when empty); includeHeritage:false skips it, includeCrossRepo:true walks cross-repo heritage. {resolved:false, candidates} = no confident match.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commitSha": {
"description": "Pin reads to one indexed revision (7-40 hex). Graph tools error with revision_not_indexed when it is not an indexed revision of the scoped repository, or revision_not_servable when that revision's graph was superseded by a later reindex, and echo the revision served back as commitSha; source ops read git objects, so any commit works there. Exception: a kept revision (revisions rows flagged architectureSnapshot) still serves map view:\"architecture\" as a preserved snapshot.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"expansionLimit": {
"default": 15,
"description": "Cap on expanded related nodes (default 15, max 100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"includeCommunity": {
"default": false,
"description": "Attach the symbol's Louvain module (community name). Off by default (extra edge lookup).",
"type": "boolean"
},
"includeCrossRepo": {
"default": false,
"description": "With includeHeritage on, walk cross-repo heritage edges. No-op when includeHeritage is off.",
"type": "boolean"
},
"includeHeritage": {
"default": true,
"description": "Default true. Include a compact heritage field for a class/interface/struct/protocol. false skips it on bulk scans.",
"type": "boolean"
},
"includeSource": {
"default": false,
"description": "Attach source for resolved nodes.",
"type": "boolean"
},
"includeSummaries": {
"default": false,
"description": "Attach generated summaries when available.",
"type": "boolean"
},
"limit": {
"default": 5,
"description": "Max results (default 5, max 20).",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
},
"selectors": {
"description": "Symbols to resolve (1-10), each by nodeId, symbol, symbolPath, or filePath.",
"items": {
"properties": {
"filePath": {
"description": "Repo-relative file path holding the symbol.",
"minLength": 1,
"type": "string"
},
"nodeId": {
"description": "Graph node id from a prior result.",
"minLength": 1,
"type": "string"
},
"symbol": {
"description": "Symbol name, e.g. a function or class name.",
"minLength": 1,
"type": "string"
},
"symbolPath": {
"description": "Full symbolPath as find_node/locate returns.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"sourceMode": {
"description": "With includeSource: \"signature\" returns the declaration only.",
"enum": [
"none",
"signature"
],
"type": "string"
}
},
"required": [
"selectors"
],
"type": "object"
},
"name": "find_node",
"outputSchema": null
},
{
"description": "Returns lastIndexedSha, lastIndexedAt, and the current remote HEAD sha for a repository: detect index drift from remote. Reports what Symvanta knows, not local git. currentRemoteSha is null when no GitHub credential is configured. Echoes the active ref pin (pinnedBranch, pinnedSha).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "freshness",
"outputSchema": null
},
{
"description": "Indexed commit history. Ops:\n- commits: recent commits (metadata + file list); <=200/call, default 50. With a clone prefer git log.\n- commit: one commit by sha with its diff summary (added/modified/deleted/renamed); null if outside the indexed window.\n- recently_changed: files ranked by change frequency in the indexed window (\"what's hot\").",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"author": {
"description": "Filter by author name or email substring.",
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"limit": {
"description": "Max rows (default 50, max 200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"op": {
"description": "commits: recent commits (metadata + file list). commit: one commit in detail. recently_changed: most-changed files over the window.",
"enum": [
"commits",
"commit",
"recently_changed"
],
"type": "string"
},
"path": {
"description": "Restrict to commits touching this repo-relative path.",
"type": "string"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
},
"sha": {
"description": "op:commit. The commit to read (7-64 hex).",
"pattern": "^[0-9a-fA-F]{7,64}$",
"type": "string"
},
"since": {
"description": "ISO datetime lower bound.",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"until": {
"description": "ISO datetime upper bound.",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
}
},
"required": [
"op"
],
"type": "object"
},
"name": "history",
"outputSchema": null
},
{
"description": "Per-project index health. pendingLibraryVersions: cross-repo specifiers still indexing (an empty result may mean \"not indexed yet\", not \"not in code\"); call when a query is surprisingly empty. A row with status \"skipped\" is never going to arrive (a dev or optional dependency, which the catalog does not index) and status \"failed\" means discovery found no source, so only \"indexing\" is worth waiting on. architecture: per-repo Louvain module count + modularity Q (low Q = tangled), plus circular-dependency and mutually-recursive-symbol counts (inspect via map view:\"architecture\"). versionDrift: joined cross-repo SCIP edges whose consumer-pinned package version differs from the sibling's current version (package, pinned vs current, edge count). externalsCoverage: per-repo count of external references joined onto a sibling definition vs left as materialized stubs. unindexableRepositories: repos whose last index produced no graph and left a status (no_default_branch = the remote has no resolvable default branch, e.g. an empty repo; awaiting_upload = an upload-provider repo with no zip yet; remote_head_unresolvable = the remote could not be reached to resolve its head, so this is a network or credential problem, not a repository one), with the worker's log line as indexStatusDetail; explains a silently-empty repo. degradedRepositories: repos that DID index but lost a derived artifact (community_detection_skipped = Louvain clustering did not run, so map view:\"architecture\" has no modules; raise COMMUNITY_EDGE_CEILING or set COMMUNITY_DETECTION=true, then reindex). Both carry a human-readable reason.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "index_health",
"outputSchema": null
},
{
"description": "Call first. Returns the active project, repositories, and index health in one call, plus a `usage` field (decision matrix + routing). Non-empty repositories = proceed with graph queries; empty = tell the user to attach repos on the dashboard and stop, do not fall back to Grep.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
}
},
"type": "object"
},
"name": "init",
"outputSchema": null
},
{
"description": "Library catalog lookups. Ops:\n- packages: list indexed npm packages (specifier, ecosystem, owner/name, indexed-at, sha). Tenant-scoped, no projectId.\n- version: one package's resolved version for a project (sha, version, dep type, indexed-at, status indexed|indexing|failed|not_found). \"indexing\" means a job for that revision is in flight, so retrying later converges; \"failed\" carries a reason and does not change on its own.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"limit": {
"default": 50,
"description": "op:packages. Max rows (default 50, max 200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"op": {
"description": "packages: list indexed packages. version: resolve one specifier's indexed version.",
"enum": [
"packages",
"version"
],
"type": "string"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"specifier": {
"description": "op:version. Package specifier, e.g. \"react\".",
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"op"
],
"type": "object"
},
"name": "library",
"outputSchema": null
},
{
"description": "List symbols in one file (name + kind + line bounds). Step 1 of the two-step read: get line bounds, then pass startLine/endLine to source (op:read) for that slice only (~4-15x fewer tokens). For one symbol + signature, use find_node {symbol, filePath}.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commitSha": {
"description": "Pin reads to one indexed revision (7-40 hex). Graph tools error with revision_not_indexed when it is not an indexed revision of the scoped repository, or revision_not_servable when that revision's graph was superseded by a later reindex, and echo the revision served back as commitSha; source ops read git objects, so any commit works there. Exception: a kept revision (revisions rows flagged architectureSnapshot) still serves map view:\"architecture\" as a preserved snapshot.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"filePath": {
"description": "Repo-relative file path to list symbols for.",
"minLength": 1,
"type": "string"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
}
},
"required": [
"filePath"
],
"type": "object"
},
"name": "list_file_symbols",
"outputSchema": null
},
{
"description": "List all projects with indexing summaries. Find a project by name or check which exist.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
}
},
"type": "object"
},
"name": "list_projects",
"outputSchema": null
},
{
"description": "List repositories in a project. Find repository names to scope a query to one repo.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "list_repositories",
"outputSchema": null
},
{
"description": "Test suites and cases whose suite name matches a symbol name (case-insensitive substring). Call before adding tests to see existing coverage and mirror its shape.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commitSha": {
"description": "Pin reads to one indexed revision (7-40 hex). Graph tools error with revision_not_indexed when it is not an indexed revision of the scoped repository, or revision_not_servable when that revision's graph was superseded by a later reindex, and echo the revision served back as commitSha; source ops read git objects, so any commit works there. Exception: a kept revision (revisions rows flagged architectureSnapshot) still serves map view:\"architecture\" as a preserved snapshot.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
},
"selector": {
"description": "Symbol name to match against test suite names.",
"minLength": 1,
"type": "string"
}
},
"required": [
"selector"
],
"type": "object"
},
"name": "list_tests_for",
"outputSchema": null
},
{
"description": "Search/lookup. Pick a mode, or omit with a bare query to AUTO-ROUTE (text, then semantic on empty; response carries answered_by). Modes:\n- text (replaces grep): literal identifier/string, one row/occurrence. queries:[...] (<=10 terms) searches several in one call (and implies this mode when mode is omitted). pathsOnly:true = \"filePath:lineNumber\" only (~5x cheaper). maxPerFile caps rows/file (default 5). Empty carries did_you_mean; do NOT retry reworded, use semantic.\n- symbol: symbols by name/symbolPath in one repo. kind filters node kind, layer one layer. Tests last unless includeTests:true.\n- semantic: vector search for symbols similar to a natural-language query (names unknown).\n- file: fuzzy filename search (basename); filenames only.\n- config (replaces grep for env/config keys): key/env-var usages with nearest-symbol context; queries:[...] batches several keys.\n- codebase: cross-repo candidate scan; narrow with repositoryIds.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commitSha": {
"description": "Pin an indexed revision (text/symbol/semantic/config; ignored by file/codebase).",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"includeTests": {
"default": false,
"description": "text/symbol/semantic. Include test files. Default false ranks them last; auto-on for test queries.",
"type": "boolean"
},
"kind": {
"description": "mode:symbol. Filter by node kind.",
"enum": [
"module",
"class",
"function",
"interface",
"endpoint",
"schema",
"struct",
"enum",
"protocol",
"actor",
"extension",
"initializer",
"property",
"package",
"product",
"target",
"project",
"workspace",
"test_suite",
"test_case",
"test_hook",
"community",
"cycle",
"resource"
],
"type": "string"
},
"layer": {
"description": "mode:symbol. Scope to one layer (e.g. browser, node, common, test).",
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"limit": {
"default": 20,
"description": "Max results. Per-mode caps apply (text 200/20, symbol 20, semantic 5, file 10, config 20/20, codebase 20/10).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"maxPerFile": {
"default": 5,
"description": "mode:text. Cap occurrences/file (default 5; capped file carries moreInFileTruncated). 0 = uncapped.",
"maximum": 1000,
"minimum": 0,
"type": "integer"
},
"mode": {
"description": "Force a mode. Omit + bare query = AUTO-ROUTE (text, then semantic on empty). queries without a mode implies text.",
"enum": [
"text",
"symbol",
"semantic",
"file",
"config",
"codebase"
],
"type": "string"
},
"name": {
"description": "mode:file. Filename fragment; defaults to query.",
"minLength": 1,
"type": "string"
},
"pathPrefix": {
"description": "text/symbol/config. Restrict to paths under this prefix.",
"minLength": 1,
"type": "string"
},
"pathsOnly": {
"description": "mode:text. \"filePath:lineNumber\" only, no snippets (~5x fewer tokens).",
"type": "boolean"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"queries": {
"description": "text/config. Up to 10 terms; interleaved, deduped, each tagged matchedQuery. Without an explicit mode, implies mode:text. Accepts a JSON-array string.",
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"query": {
"description": "Search term or NL query. Required for symbol/semantic/codebase; text/config: query or queries; file: query or name.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Single-repo scope (not codebase; that is project-wide, use repositoryIds).",
"minLength": 1,
"type": "string"
},
"repositoryIds": {
"description": "mode:codebase. Narrow to these repository ids; omit to scan all.",
"items": {
"description": "Encoded repository id from list_repositories.",
"minLength": 1,
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
}
},
"type": "object"
},
"name": "locate",
"outputSchema": null
},
{
"description": "Token-efficient repo (or subtree) skeleton: directory tree with each file's classes (methods in parens), functions, and HTTP endpoints, from the graph. Orient before drilling in. Scope with \"path\", cap with \"maxDepth\", density:\"full\" adds properties. view:\"architecture\" instead returns a module map (Louvain clusters with hubs, paths and cross-module coupling), plus namedModules/totalModules: a module NAME comes from a generated summary and is provisional, its id (the member-set hash in the header) is the stable key, so pin modules by id and re-read names rather than caching them.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commitSha": {
"description": "Pin reads to one indexed revision (7-40 hex). Graph tools error with revision_not_indexed when it is not an indexed revision of the scoped repository, or revision_not_servable when that revision's graph was superseded by a later reindex, and echo the revision served back as commitSha; source ops read git objects, so any commit works there. Exception: a kept revision (revisions rows flagged architectureSnapshot) still serves map view:\"architecture\" as a preserved snapshot.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"density": {
"description": "\"compact\" (default): classes/methods/functions/endpoints. \"full\" adds properties.",
"enum": [
"compact",
"full"
],
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"maxDepth": {
"description": "Drop files deeper than this many path segments. Omit for no cap.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"path": {
"description": "Repo-relative subtree (e.g. \"src/v1/mcp\"). Omit for the whole repo.",
"minLength": 1,
"type": "string"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
},
"view": {
"description": "\"tree\" (default): file/symbol skeleton. \"architecture\": module map with hubs, coupling, cycles. Module names come from generated summaries: cite a module by its id (the member-set hash printed in the header), which is stable across calls and reindexes.",
"enum": [
"tree",
"architecture"
],
"type": "string"
}
},
"type": "object"
},
"name": "map",
"outputSchema": null
},
{
"description": "Fast substring lookup of symbol DEFINITIONS by name: rows {name, kind, filePath, startLine, repositoryName} (displayName only when distinct from name), no ranking, no semantic. Cheaper alternative to locate (mode:symbol) for latency-sensitive pre-fetch (grep-augment hook); interactive search should prefer locate/find_node. Reads the latest indexed revision, no ref pin.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"limit": {
"description": "Max results (max 20).",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"query": {
"description": "Substring to match against symbol names (no ranking).",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "quick_lookup",
"outputSchema": null
},
{
"description": "Session-scoped branch / working-tree overlay. Ops:\n- use: pin a repository's reads to a branch (latest indexed revision). Branch must be tracked+indexed (open a PR, or add on the dashboard); else \"indexing_in_progress\". commitSha overrides.\n- clear: remove the pin, revert to default.\n- index_working_tree: overlay UNCOMMITTED edits (changedFiles path+content, optional deletedPaths/baseSha) on a short-lived synthetic revision pinned here; find_node/locate/relate reflect them, source and locate mode:semantic do NOT. Cap 100 files/256KB.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"baseSha": {
"description": "Indexed base your edits sit on. Omit for the default-branch tip.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"branch": {
"description": "op:use. The tracked branch to pin.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"changedFiles": {
"description": "Changed/added files with current contents, repo-relative paths.",
"items": {
"properties": {
"content": {
"description": "Full current file content.",
"maxLength": 262144,
"type": "string"
},
"path": {
"description": "Repo-relative file path.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
}
},
"required": [
"path",
"content"
],
"type": "object"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"deletedPaths": {
"description": "Repo-relative deleted paths.",
"items": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"op": {
"description": "use: pin reads to a tracked branch. clear: revert to the default branch. index_working_tree: overlay uncommitted edits on a synthetic revision and pin it.",
"enum": [
"use",
"clear",
"index_working_tree"
],
"type": "string"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
}
},
"required": [
"op"
],
"type": "object"
},
"name": "ref",
"outputSchema": null
},
{
"description": "Dispatch a reindex job for an already-attached repository (repositoryId from list_repositories / add_repository). Optional commit_sha pin. force:true re-applies the current parser even when unchanged at HEAD: it bypasses the per-file hash-skip AND re-runs the SCIP indexer subprocesses (no same-sha .scip cache serve), so a parser fix inside a SCIP runner, an external-moniker re-pin, or a toolchain upgrade takes effect without a version bump.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commit_sha": {
"description": "Pin to a commit (omit for latest)",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"force": {
"description": "Re-parse every file AND re-run the SCIP indexer subprocesses even if unchanged at HEAD (for a parser fix without a version bump)",
"type": "boolean"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"repositoryId": {
"description": "Encoded repository ID (from list_repositories/add_repository)",
"minLength": 1,
"type": "string"
}
},
"required": [
"repositoryId"
],
"type": "object"
},
"name": "reindex_repository",
"outputSchema": null
},
{
"description": "Graph relationship traversal via one kind (real edges, not text). Kinds (1-10 symbols; heritage/chain one):\n- callers: direct callers. granularity:'file' (default) one row/file, 'site' one row/caller.\n- dependencies: outgoing calls/imports.\n- blast_radius: upstream impact walk (every caller, importer and referencer up to 3 hops, no per-hop sampling) + co-change siblings; risk {level,signals}. includeCrossRepo defaults ON here (off for others). blastRadiusTotalCount is the number of distinct symbols that 3-hop walk reached, not the row count: the blastRadius array is capped by expansionLimit. blastRadiusTruncated:true means the rows are a sample of that total; blastRadiusTotalAtLeast:true means the count stopped at its 10000 bound, so quote it as \"N+\". The walk stops at 3 hops, so it can miss impact further away; it never overcounts. Never report the number of listed rows as the impact size.\n- implementers: classes implementing interfaces via heritage edges.\n- heritage: full hierarchy (ancestors+descendants) of ONE type. maxDepth caps it.\n- chain: call-chain paths for a node (nodeId OR selectors[0]); chain params tune the walk.\n- path: shortest connection between selectors[0] (from) and selectors[1] (to). Direction-agnostic hop-labeled path; found:false when none within 6 hops.\nminimal:true = {id,name,filePath,startLine}-only (~50% cheaper) on callers/dependencies/blast_radius/implementers; granularity on callers/blast_radius. Rows may carry confidence (tiers in init usage); a cross-repo callers/dependencies row joined by a SCIP moniker also carries package (the package name that bridged the repos). 0 results: call locate (mode:text), not Grep; reason:\"no_edges_indexed\" = no edges.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commitSha": {
"description": "Pin reads to one indexed revision (7-40 hex). Graph tools error with revision_not_indexed when it is not an indexed revision of the scoped repository, or revision_not_servable when that revision's graph was superseded by a later reindex, and echo the revision served back as commitSha; source ops read git objects, so any commit works there. Exception: a kept revision (revisions rows flagged architectureSnapshot) still serves map view:\"architecture\" as a preserved snapshot.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"depth": {
"description": "chain. Chain length.",
"maximum": 6,
"minimum": 1,
"type": "integer"
},
"direction": {
"default": "both",
"description": "chain. 'downstream' leaves, 'upstream' entry points, 'both' (default).",
"enum": [
"upstream",
"downstream",
"both"
],
"type": "string"
},
"edgeFilter": {
"default": "calls_imports",
"description": "chain. 'calls' | 'imports' | 'calls_imports' (default).",
"enum": [
"calls",
"imports",
"calls_imports"
],
"type": "string"
},
"expansionLimit": {
"default": 15,
"description": "Caps returned count (not heritage/chain). Default 15.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"followPolymorphism": {
"description": "chain. Walk polymorphic dispatch edges (default false; untraversed hops in polymorphicBranchPoints).",
"type": "boolean"
},
"granularity": {
"default": "file",
"description": "callers/blast_radius. 'file' one row/file, 'site' one row/node.",
"enum": [
"file",
"site"
],
"type": "string"
},
"includeCrossRepo": {
"description": "Walk cross-repo edges. Default true for blast_radius, false otherwise.",
"type": "boolean"
},
"intent": {
"description": "Rerank by trigram similarity (not heritage/chain).",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"kind": {
"default": "callers",
"description": "Relationship to traverse. See the tool description for each kind.",
"enum": [
"callers",
"dependencies",
"blast_radius",
"implementers",
"heritage",
"chain",
"path"
],
"type": "string"
},
"landmarkFilter": {
"description": "chain. Keep only paths through a node matching this.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"limit": {
"default": 5,
"description": "Per-selector candidate cap (not heritage/chain).",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"maxDepth": {
"description": "Max depth for heritage; also caps the kind:path walk (clamped to <=6).",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"maxPaths": {
"description": "chain. Cap on returned paths.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"minimal": {
"default": false,
"description": "{id,name,filePath,startLine}-only, ~50% cheaper; not heritage/chain.",
"type": "boolean"
},
"minimalImplementers": {
"default": false,
"description": "Alias of minimal for implementers.",
"type": "boolean"
},
"nodeId": {
"description": "Start node for chain (OR selectors[0]).",
"minLength": 1,
"type": "string"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"pruneSetupMethods": {
"description": "chain. Drop framework bootstrap steps.",
"type": "boolean"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
},
"selectors": {
"description": "Symbols to traverse from (1-10). heritage uses selectors[0]; chain: OR nodeId.",
"items": {
"properties": {
"filePath": {
"description": "Repo-relative file path holding the symbol.",
"minLength": 1,
"type": "string"
},
"nodeId": {
"description": "Graph node id from a prior result.",
"minLength": 1,
"type": "string"
},
"symbol": {
"description": "Symbol name, e.g. a function or class name.",
"minLength": 1,
"type": "string"
},
"symbolPath": {
"description": "Full symbolPath as find_node/locate returns.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"staysWithinClass": {
"description": "chain. Surface intra-class dispatch order.",
"type": "boolean"
},
"terminalFilter": {
"description": "chain. Restrict to paths ending at a node matching this.",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "relate",
"outputSchema": null
},
{
"description": "Raw file/git access at the indexed commit, for cloud agents with no clone; with a clone prefer your own Read/Grep/git. Ops:\n- read: content of filePath, whole file or slice startLine..endLine. ifHash (a prior read's hash) returns {unchanged:true}, no content. compact:true strips blank/comment-only lines.\n- list: files+subdirs at path. grep: ripgrep pattern (glob/pathPrefix). tree: layout from path. stat: size/lines/language/binary for filePath. blame: authorship for filePath. diff: fromSha..toSha.\nKeys: {op:\"read\",filePath:\"src/a.ts\"}, {op:\"grep\",pattern:\"foo\"}, {op:\"list\",path:\"src\"}. filePath is the file, path the directory.\nGated by the Source Access add-on; else source_access_required.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"commitSha": {
"description": "Pin reads to one indexed revision (7-40 hex). Graph tools error with revision_not_indexed when it is not an indexed revision of the scoped repository, or revision_not_servable when that revision's graph was superseded by a later reindex, and echo the revision served back as commitSha; source ops read git objects, so any commit works there. Exception: a kept revision (revisions rows flagged architectureSnapshot) still serves map view:\"architecture\" as a preserved snapshot.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"compact": {
"default": false,
"description": "read: strip blank/comment-only lines (heuristic; content no longer maps 1:1 to lines).",
"type": "boolean"
},
"endLine": {
"description": "read/blame: last line, 1-based.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"feedback": {
"description": "Optional: report how a previous answer worked out; piggybacks on any call.",
"properties": {
"answerId": {
"description": "answer_id from a previous ask_codebase response",
"maxLength": 36,
"minLength": 36,
"type": "string"
},
"correction": {
"description": "Only when the user corrected the answer",
"maxLength": 2000,
"type": "string"
},
"outcome": {
"description": "How the answer worked out.",
"enum": [
"useful",
"dead_end",
"corrected"
],
"type": "string"
}
},
"required": [
"answerId",
"outcome"
],
"type": "object"
},
"filePath": {
"description": "read/stat/blame: the file to open (required; `path` is accepted as an alias).",
"minLength": 1,
"type": "string"
},
"fromSha": {
"description": "diff: base commit (required), reachable from the indexed branch.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
},
"glob": {
"description": "grep: limit to files matching this glob.",
"type": "string"
},
"ifHash": {
"description": "read: a prior read's hash; if it still matches, returns {unchanged:true}, no content.",
"minLength": 1,
"type": "string"
},
"limit": {
"description": "grep: max matches.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"maxDepth": {
"description": "tree: max recursion depth, default 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"op": {
"description": "See the tool description for each op. Omitted: inferred from the other args (pattern -> grep, fromSha/toSha -> diff, filePath/path -> read, nothing -> list).",
"enum": [
"read",
"list",
"grep",
"tree",
"stat",
"blame",
"diff"
],
"type": "string"
},
"path": {
"description": "list/tree/diff: dir path in the repo (default root). On read/stat/blame it is read as filePath, on grep as pathPrefix.",
"type": "string"
},
"pathPrefix": {
"description": "grep: limit to files under this prefix.",
"type": "string"
},
"pattern": {
"description": "grep: ripgrep pattern (required; `query` is accepted as an alias).",
"minLength": 1,
"type": "string"
},
"projectId": {
"description": "Project id from init/list_projects. Omit for the active project.",
"minLength": 1,
"type": "string"
},
"query": {
"description": "grep: alias for pattern.",
"minLength": 1,
"type": "string"
},
"repository": {
"description": "Repository full name, e.g. \"owner/repo\". Omit when the project has one repository.",
"minLength": 1,
"type": "string"
},
"startLine": {
"description": "read/blame: first line, 1-based.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"toSha": {
"description": "diff: target commit (required), reachable from the indexed branch.",
"pattern": "^[0-9a-fA-F]{7,40}$",
"type": "string"
}
},
"type": "object"
},
"name": "source",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:5332935a6967d72478daf9e9a468a1679aeb305c3934a8a34bde633bbae4dc63 | sha256sum