Skip to content

feat: [AI-7392] humanize tool-call titles at the source#980

Open
ralphstodomingo wants to merge 3 commits into
mainfrom
feat/AI-7392-tool-title-labels
Open

feat: [AI-7392] humanize tool-call titles at the source#980
ralphstodomingo wants to merge 3 commits into
mainfrom
feat/AI-7392-tool-title-labels

Conversation

@ralphstodomingo

@ralphstodomingo ralphstodomingo commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

What

Makes the Altimate Code server the source of truth for a tool call's display label and its origin, so any client (chat webview, TUI, …) renders them without re-deriving anything:

  1. Humanized titlesstate.title is a readable label. File tools get "Reading customers model" / "Searching **/*.sql" (dbt-aware, degrading to the filename off-dbt); MCP tools get a Title-Cased label from their <client>_<tool> key (they previously had title: ""); every other tool keeps its own rich title.
  2. Authoritative source — each tool part carries state.metadata.source = builtin | altimate | mcp, so clients badge it without prefix-guessing. Datamates-over-MCP is folded into altimate.

How

  • src/altimate/tool-label.tsdescribeToolCall (file-tool humanizing), applied in the execute() wrapper.
  • src/altimate/tool-source.tsregistryToolSource (native-set inversion: any non-native registry tool is Altimate, so new Altimate tools classify with zero maintenance), mcpToolSource (Datamates client → altimate), humanizeMcpTitle.
  • session/prompt.ts resolveTools — the two-loop choke point: stamps metadata.source on registry tools; sets both source + humanized title on MCP tools.

Why here

Replaces client-side labeling/classification (previously in the chat webview) with one server-side source of truth, per review. Paired webview change: AltimateAI/vscode-altimate-mcp-server#388 (now a pure renderer of state.title + state.metadata.source).

Testing

  • bun testtool-label (7) + tool-source (12); updated write title test.
  • E2E: built this branch's binary, ran under altimate serve in code-server with the paired webview — sql_analyze/datamate_manager render the Altimate badge and read/glob the built-in icon, all from state.metadata.source (the webview no longer classifies).

🤖 Generated with Claude Code

Rewrite each tool's state.title in the execute() wrapper so any client
(chat webview, TUI, ...) can render a readable label straight from
state.title — e.g. "Reading customers model" for a dbt model read,
"Searching **/*.sql" for a glob. File-acting tools get a gerund verb
plus a dbt-aware target (model/seed/macro, degrading to the filename
off-dbt); every other tool keeps the rich title it already emits.
@ralphstodomingo ralphstodomingo self-assigned this Jul 1, 2026
@coderabbitai

coderabbitai Bot commented Jul 1, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Adds tool-call title humanization for file-oriented tools, classifies tool sources for registry and MCP tools, wires both into execution and session prompt flows, and updates tests for the new labeling and source metadata behavior.

Changes

Tool metadata formatting

Layer / File(s) Summary
describeToolCall utility implementation
packages/opencode/src/altimate/tool-label.ts
Adds verb and dbt kind maps, string normalization, friendly target formatting, file target extraction per tool type, and the exported describeToolCall() function.
Execution wrapper wiring
packages/opencode/src/tool/tool.ts
Imports describeToolCall and rewrites result.title after execute() using its output, falling back to the original title when undefined.
Tool source classification and prompt wiring
packages/opencode/src/altimate/tool-source.ts, packages/opencode/src/session/prompt.ts
Adds ToolSource helpers, classifies registry and MCP tools, humanizes MCP titles, and stamps tool metadata in session prompt execution flows.
Tests for label and source helpers
packages/opencode/test/altimate/tool-label.test.ts, packages/opencode/test/altimate/tool-source.test.ts, packages/opencode/test/tool/write.test.ts
Adds coverage for dbt path labeling, non-dbt fallback, glob/grep/list targets, rich-title passthrough, missing-path fallback, registry and MCP source classification, humanized MCP titles, and the updated write tool title expectation.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Caller
  participant ToolExecute as tool.ts execute()
  participant DescribeToolCall

  Caller->>ToolExecute: invoke tool (id, args)
  ToolExecute->>ToolExecute: run tool logic, produce result.title
  ToolExecute->>DescribeToolCall: describeToolCall(id, args, result.title)
  DescribeToolCall->>DescribeToolCall: build verb + friendly target (dbt-aware)
  DescribeToolCall-->>ToolExecute: humanized title or undefined
  ToolExecute->>ToolExecute: result.title = humanized ?? original title
  ToolExecute-->>Caller: return result
Loading
sequenceDiagram
  participant Prompt as session/prompt.ts
  participant RegistryToolSource
  participant McpToolSource
  participant HumanizeMcpTitle

  Prompt->>RegistryToolSource: registryToolSource(item.id)
  RegistryToolSource-->>Prompt: builtin or altimate
  Prompt->>McpToolSource: mcpToolSource(key)
  McpToolSource-->>Prompt: altimate or mcp
  Prompt->>HumanizeMcpTitle: humanizeMcpTitle(key)
  HumanizeMcpTitle-->>Prompt: readable MCP title
Loading

Poem

A rabbit found some tools astray,
And dressed their names in friendlier clay.
From dbt paths to MCP light,
Each title hopped out clear and bright,
With source tags neat at prompt and play. 🐇

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning It covers the change and testing, but it misses the required PINEAPPLE preface and the template's Summary/Test Plan/Checklist structure. Add PINEAPPLE at the top, then rewrite it with the required Summary, Test Plan, and Checklist sections, including the checklist items.
✅ Passed checks (4 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title is concise and accurately describes the main change: humanizing tool-call titles at the source.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/AI-7392-tool-title-labels

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ralphstodomingo

Copy link
Copy Markdown
Contributor Author

Paired chat-webview change (renders the humanized state.title from this PR): AltimateAI/vscode-altimate-mcp-server#388

The execute() wrapper now humanizes file-tool titles at the source, so
the write tool's title is "Writing <file>" rather than the raw relative
path. Update the assertion accordingly.
@ralphstodomingo ralphstodomingo marked this pull request as ready for review July 2, 2026 02:58
Copilot AI review requested due to automatic review settings July 2, 2026 02:58

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.

Tip: disable this comment in your organization's Code Review settings.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (2)
packages/opencode/test/altimate/tool-label.test.ts (1)

31-35: 🎯 Functional Correctness | 🔵 Trivial | ⚡ Quick win

Consider adding a case for list on a nested dbt subdirectory.

The existing case only covers a top-level directory ({ path: "models" }). A case like { path: "models/staging" } would have caught the mislabeling issue flagged in tool-label.ts (friendlyTarget applying the dbt "model" suffix to a directory name).

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/opencode/test/altimate/tool-label.test.ts` around lines 31 - 35, Add
a test in tool-label.test.ts for describeToolCall("list", ...) using a nested
dbt subdirectory target like models/staging, since the current list case only
covers the top-level models path and misses the friendlyTarget mislabeling in
tool-label.ts. Update the test set so it asserts the nested directory is labeled
correctly (without the dbt “model” suffix), keeping the existing glob/grep/list
coverage intact.
packages/opencode/src/altimate/tool-label.ts (1)

41-71: 🎯 Functional Correctness | 🔵 Trivial | ⚡ Quick win

list on a nested dbt subdirectory produces a misleading "model" label.

friendlyTarget strips extensions and appends the dbt "kind" noun whenever any ancestor segment matches DBT_DIR_KIND, regardless of whether the target is a file or a directory. This works fine for read/write/edit (always files) but for list the target is always a directory, so listing a nested dbt folder is mislabeled as if it were a single model:

  • describeToolCall("list", { path: "models" }, ...)"Listing models" (correct, top-level dir has no ancestor match)
  • describeToolCall("list", { path: "models/staging" }, ...)"Listing staging model" (wrong — this is a directory of many models, not one model)

Consider skipping the dbt kind-suffix rewrite for list, or only applying it when the base segment has a recognized dbt file extension (sql/yaml/csv).

💡 Possible fix
 function friendlyTarget(rawPath: string): string {
   const segments = rawPath.replace(/\\/g, "/").replace(/^\.\//, "").split("/").filter(Boolean)
   const base = segments[segments.length - 1] ?? rawPath
   for (const segment of segments.slice(0, -1)) {
     const kind = DBT_DIR_KIND[segment.toLowerCase()]
-    if (kind) {
+    if (kind && /\.(sql|ya?ml|csv)$/i.test(base)) {
       const name = base.replace(/\.(sql|ya?ml|csv)$/i, "")
       return `${name} ${kind}`
     }
   }
   return base
 }
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/opencode/src/altimate/tool-label.ts` around lines 41 - 71, The
`list` tool is incorrectly reusing `friendlyTarget`, which adds a dbt kind
suffix for any path with a dbt ancestor and makes directory listings like nested
folders look like a single model. Update `fileTarget` so the `list` branch does
not apply the file-oriented `friendlyTarget` rewrite, or make `friendlyTarget`
only append the dbt kind when the target is a file with a recognized dbt
extension. Keep the existing behavior for `read`/`write`/`edit`/`multiedit`, and
verify `describeToolCall("list", ...)` produces directory names without
misleading model labels.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@packages/opencode/src/altimate/tool-label.ts`:
- Around line 41-71: The `list` tool is incorrectly reusing `friendlyTarget`,
which adds a dbt kind suffix for any path with a dbt ancestor and makes
directory listings like nested folders look like a single model. Update
`fileTarget` so the `list` branch does not apply the file-oriented
`friendlyTarget` rewrite, or make `friendlyTarget` only append the dbt kind when
the target is a file with a recognized dbt extension. Keep the existing behavior
for `read`/`write`/`edit`/`multiedit`, and verify `describeToolCall("list",
...)` produces directory names without misleading model labels.

In `@packages/opencode/test/altimate/tool-label.test.ts`:
- Around line 31-35: Add a test in tool-label.test.ts for
describeToolCall("list", ...) using a nested dbt subdirectory target like
models/staging, since the current list case only covers the top-level models
path and misses the friendlyTarget mislabeling in tool-label.ts. Update the test
set so it asserts the nested directory is labeled correctly (without the dbt
“model” suffix), keeping the existing glob/grep/list coverage intact.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: d3e6e321-9dc3-4f33-9aca-1c5cc2a20592

📥 Commits

Reviewing files that changed from the base of the PR and between f0fb1e1 and 9e1853e.

📒 Files selected for processing (4)
  • packages/opencode/src/altimate/tool-label.ts
  • packages/opencode/src/tool/tool.ts
  • packages/opencode/test/altimate/tool-label.test.ts
  • packages/opencode/test/tool/write.test.ts

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR centralizes human-friendly tool-call titles in the tool execution layer so all clients can render state.title directly, with dbt-aware labels for file-acting tools.

Changes:

  • Adds describeToolCall() to generate readable, dbt-aware titles for file/path-oriented tools (read/write/edit/multiedit/glob/grep/list).
  • Rewrites result.title for every tool call inside the Tool.execute() wrapper to apply this labeling consistently.
  • Adds/updates Bun tests to validate title humanization behavior.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File Description
packages/opencode/src/tool/tool.ts Applies centralized title humanization in the tool execute wrapper.
packages/opencode/src/altimate/tool-label.ts Introduces describeToolCall() and dbt-aware target formatting logic.
packages/opencode/test/altimate/tool-label.test.ts Adds unit tests for tool-call title labeling behavior.
packages/opencode/test/tool/write.test.ts Updates expectations to match the new humanized title format for write.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +46 to +57
function friendlyTarget(rawPath: string): string {
const segments = rawPath.replace(/\\/g, "/").replace(/^\.\//, "").split("/").filter(Boolean)
const base = segments[segments.length - 1] ?? rawPath
for (const segment of segments.slice(0, -1)) {
const kind = DBT_DIR_KIND[segment.toLowerCase()]
if (kind) {
const name = base.replace(/\.(sql|ya?ml|csv)$/i, "")
return `${name} ${kind}`
}
}
return base
}
Comment on lines +80 to +89
export function describeToolCall(tool: string, input: unknown, rawTitle?: string): string | undefined {
const fallback = asString(rawTitle)
const verb = FILE_TOOL_VERBS[tool]
if (verb && input && typeof input === "object") {
const target = fileTarget(tool, input as Record<string, unknown>)
if (target) return `${verb} ${target}`
}
// Non-file / rich-title tools: keep the title the tool already emitted.
return fallback
}
Comment on lines +348 to +350
// The execute() wrapper humanizes file-tool titles at the source
// (see src/altimate/tool-label.ts) — a non-dbt path degrades to the
// filename, so the title is a readable "Writing <file>" label.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found across 4 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="packages/opencode/src/altimate/tool-label.ts">

<violation number="1" location="packages/opencode/src/altimate/tool-label.ts:50">
P3: Non-dbt files under common directories like `src/models` can be shown as dbt objects because `friendlyTarget()` applies the dbt noun to any path segment named `models`, `tests`, or `macros`, regardless of the target file type. That makes labels such as `Reading User.tsx model` possible outside dbt projects; consider only applying the dbt noun when the target looks like a dbt resource (for example known dbt file extensions) and otherwise falling back to the basename.</violation>

<violation number="2" location="packages/opencode/src/altimate/tool-label.ts:85">
P2: When `list` targets the worktree root (no path argument or empty relative path), `fileTarget()` returns `undefined` and `asString(rawTitle)` also returns `undefined` (since `path.relative(worktree, worktree)` is `""`). The `??` fallback in `tool.ts` then yields the original empty-string title, producing a blank UI label. Consider producing a fallback like `"Listing ."` when a file tool has a verb but neither a usable target nor a non-empty raw title.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

const verb = FILE_TOOL_VERBS[tool]
if (verb && input && typeof input === "object") {
const target = fileTarget(tool, input as Record<string, unknown>)
if (target) return `${verb} ${target}`

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: When list targets the worktree root (no path argument or empty relative path), fileTarget() returns undefined and asString(rawTitle) also returns undefined (since path.relative(worktree, worktree) is ""). The ?? fallback in tool.ts then yields the original empty-string title, producing a blank UI label. Consider producing a fallback like "Listing ." when a file tool has a verb but neither a usable target nor a non-empty raw title.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/opencode/src/altimate/tool-label.ts, line 85:

<comment>When `list` targets the worktree root (no path argument or empty relative path), `fileTarget()` returns `undefined` and `asString(rawTitle)` also returns `undefined` (since `path.relative(worktree, worktree)` is `""`). The `??` fallback in `tool.ts` then yields the original empty-string title, producing a blank UI label. Consider producing a fallback like `"Listing ."` when a file tool has a verb but neither a usable target nor a non-empty raw title.</comment>

<file context>
@@ -0,0 +1,89 @@
+  const verb = FILE_TOOL_VERBS[tool]
+  if (verb && input && typeof input === "object") {
+    const target = fileTarget(tool, input as Record<string, unknown>)
+    if (target) return `${verb} ${target}`
+  }
+  // Non-file / rich-title tools: keep the title the tool already emitted.
</file context>

const segments = rawPath.replace(/\\/g, "/").replace(/^\.\//, "").split("/").filter(Boolean)
const base = segments[segments.length - 1] ?? rawPath
for (const segment of segments.slice(0, -1)) {
const kind = DBT_DIR_KIND[segment.toLowerCase()]

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: Non-dbt files under common directories like src/models can be shown as dbt objects because friendlyTarget() applies the dbt noun to any path segment named models, tests, or macros, regardless of the target file type. That makes labels such as Reading User.tsx model possible outside dbt projects; consider only applying the dbt noun when the target looks like a dbt resource (for example known dbt file extensions) and otherwise falling back to the basename.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/opencode/src/altimate/tool-label.ts, line 50:

<comment>Non-dbt files under common directories like `src/models` can be shown as dbt objects because `friendlyTarget()` applies the dbt noun to any path segment named `models`, `tests`, or `macros`, regardless of the target file type. That makes labels such as `Reading User.tsx model` possible outside dbt projects; consider only applying the dbt noun when the target looks like a dbt resource (for example known dbt file extensions) and otherwise falling back to the basename.</comment>

<file context>
@@ -0,0 +1,89 @@
+  const segments = rawPath.replace(/\\/g, "/").replace(/^\.\//, "").split("/").filter(Boolean)
+  const base = segments[segments.length - 1] ?? rawPath
+  for (const segment of segments.slice(0, -1)) {
+    const kind = DBT_DIR_KIND[segment.toLowerCase()]
+    if (kind) {
+      const name = base.replace(/\.(sql|ya?ml|csv)$/i, "")
</file context>

@dev-punia-altimate dev-punia-altimate left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 Code Review — OpenCodeReview (Gemini) — 3 finding(s)

  • 2 anchored to a line (posted inline when the comment stream is on)
  • 1 without a line anchor
All findings (full text)

1. packages/opencode/src/altimate/tool-label.ts (L49-L50)

[🟠 MEDIUM] Iterating left-to-right (from the root down) can incorrectly match an outer directory that coincidentally shares a name with a dbt folder, rather than the intended specific directory (e.g., an absolute path like /Users/user/models/my_project/macros/utils.sql would match models instead of macros, returning utils model instead of utils macro).

Consider iterating right-to-left (from the file upwards) to match the most specific parent directory.

Suggested change:

  for (let i = segments.length - 2; i >= 0; i--) {
    const segment = segments[i]
    const kind = DBT_DIR_KIND[segment.toLowerCase()]

2. packages/opencode/src/altimate/tool-label.ts (L51-L54)

[🟠 MEDIUM] The regex misses .py (for Python models) and .md (for dbt documentation files), which are both common in dbt projects. Without these, a Python model would render as model.py model rather than model model. Consider adding them to the regex.

Suggested change:

    if (kind) {
      const name = base.replace(/\.(sql|ya?ml|csv|py|md)$/i, "")
      return `${name} ${kind}`
    }

3. packages/opencode/src/altimate/tool-label.ts

[🔵 LOW] FILE_TOOL_VERBS and DBT_DIR_KIND are plain objects. Looking up a string like constructor or toString could hit inherited Object.prototype properties, leading to unexpected string values in the label.

Consider using Object.assign(Object.create(null), {...}) to safely initialize these dictionaries without prototypes.

Suggested change:

const FILE_TOOL_VERBS: Record<string, string> = Object.assign(Object.create(null), {
  read: "Reading",
  write: "Writing",
  edit: "Editing",
  multiedit: "Editing",
  glob: "Searching",
  grep: "Searching",
  list: "Listing",
})

/** dbt directory → singular noun used in the label. */
const DBT_DIR_KIND: Record<string, string> = Object.assign(Object.create(null), {
  models: "model",
  seeds: "seed",
  macros: "macro",
  snapshots: "snapshot",
  tests: "test",
  analyses: "analysis",
  analysis: "analysis",
})

Comment on lines +49 to +50
for (const segment of segments.slice(0, -1)) {
const kind = DBT_DIR_KIND[segment.toLowerCase()]

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[🟠 MEDIUM] Iterating left-to-right (from the root down) can incorrectly match an outer directory that coincidentally shares a name with a dbt folder, rather than the intended specific directory (e.g., an absolute path like /Users/user/models/my_project/macros/utils.sql would match models instead of macros, returning utils model instead of utils macro).

Consider iterating right-to-left (from the file upwards) to match the most specific parent directory.

Suggested change:

Suggested change
for (const segment of segments.slice(0, -1)) {
const kind = DBT_DIR_KIND[segment.toLowerCase()]
for (let i = segments.length - 2; i >= 0; i--) {
const segment = segments[i]
const kind = DBT_DIR_KIND[segment.toLowerCase()]

Comment on lines +51 to +54
if (kind) {
const name = base.replace(/\.(sql|ya?ml|csv)$/i, "")
return `${name} ${kind}`
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[🟠 MEDIUM] The regex misses .py (for Python models) and .md (for dbt documentation files), which are both common in dbt projects. Without these, a Python model would render as model.py model rather than model model. Consider adding them to the regex.

Suggested change:

Suggested change
if (kind) {
const name = base.replace(/\.(sql|ya?ml|csv)$/i, "")
return `${name} ${kind}`
}
if (kind) {
const name = base.replace(/\.(sql|ya?ml|csv|py|md)$/i, "")
return `${name} ${kind}`
}

@dev-punia-altimate

Copy link
Copy Markdown
Contributor

🤖 Code Review — OpenCodeReview (Gemini) — 3 finding(s)

  • 2 anchored to a line (posted inline when the comment stream is on)
  • 1 without a line anchor
All findings (full text)

1. packages/opencode/src/altimate/tool-label.ts (L49-L50)

[🟠 MEDIUM] Iterating left-to-right (from the root down) can incorrectly match an outer directory that coincidentally shares a name with a dbt folder, rather than the intended specific directory (e.g., an absolute path like /Users/user/models/my_project/macros/utils.sql would match models instead of macros, returning utils model instead of utils macro).

Consider iterating right-to-left (from the file upwards) to match the most specific parent directory.

Suggested change:

  for (let i = segments.length - 2; i >= 0; i--) {
    const segment = segments[i]
    const kind = DBT_DIR_KIND[segment.toLowerCase()]

2. packages/opencode/src/altimate/tool-label.ts (L51-L54)

[🟠 MEDIUM] The regex misses .py (for Python models) and .md (for dbt documentation files), which are both common in dbt projects. Without these, a Python model would render as model.py model rather than model model. Consider adding them to the regex.

Suggested change:

    if (kind) {
      const name = base.replace(/\.(sql|ya?ml|csv|py|md)$/i, "")
      return `${name} ${kind}`
    }

3. packages/opencode/src/altimate/tool-label.ts

[🔵 LOW] FILE_TOOL_VERBS and DBT_DIR_KIND are plain objects. Looking up a string like constructor or toString could hit inherited Object.prototype properties, leading to unexpected string values in the label.

Consider using Object.assign(Object.create(null), {...}) to safely initialize these dictionaries without prototypes.

Suggested change:

const FILE_TOOL_VERBS: Record<string, string> = Object.assign(Object.create(null), {
  read: "Reading",
  write: "Writing",
  edit: "Editing",
  multiedit: "Editing",
  glob: "Searching",
  grep: "Searching",
  list: "Listing",
})

/** dbt directory → singular noun used in the label. */
const DBT_DIR_KIND: Record<string, string> = Object.assign(Object.create(null), {
  models: "model",
  seeds: "seed",
  macros: "macro",
  snapshots: "snapshot",
  tests: "test",
  analyses: "analysis",
  analysis: "analysis",
})

saravmajestic
saravmajestic previously approved these changes Jul 3, 2026
Classify every tool call's origin server-side and stamp it on the tool
part's state.metadata.source (builtin | altimate | mcp), so clients render
the source badge without re-deriving it from tool-name prefixes:

- tool-source.ts: native-set inversion (any non-native registry tool is
  Altimate, so new Altimate tools classify with no maintenance); Datamates
  MCP folded into "altimate"; humanizeMcpTitle for readable MCP labels.
- resolveTools: stamp metadata.source on registry tools; on MCP tools set
  both the source and a humanized title (they previously had title: "").
* the registry is Altimate-provided, so new Altimate tools classify correctly
* with no per-tool maintenance here.
*/
const NATIVE_TOOL_IDS = new Set<string>([

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[SUGGESTION]: The native batch tool would be misclassified as altimate

batch is a native opencode tool (Tool.define("batch", ...) in src/tool/batch.ts, registered in ToolRegistry.all() behind experimental.batch_tool), but it is absent from NATIVE_TOOL_IDS. As a result registryToolSource("batch") returns "altimate", contradicting the comment above the set that claims every non-listed registry tool is Altimate-provided. Adding "batch" to this set keeps its source badge correct.


Reply with @kilocode-bot fix it to have Kilo Code address this issue.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 3 files (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="packages/opencode/src/altimate/tool-source.ts">

<violation number="1" location="packages/opencode/src/altimate/tool-source.ts:58">
P2: MCP source badging can misclassify some third-party tools as Altimate because `mcpToolSource` matches `datamate` against the start of the entire key instead of the parsed `<client>` segment. Using a client-segment check (with `_` boundary) would avoid false Altimate badges for similarly named external MCP clients.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

/** Classify an MCP tool by its `<client>_<tool>` key: Altimate (Datamates) vs third-party. */
export function mcpToolSource(key: string): ToolSource {
const lower = key.toLowerCase()
return ALTIMATE_MCP_PREFIXES.some((p) => lower.startsWith(p)) ? "altimate" : "mcp"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: MCP source badging can misclassify some third-party tools as Altimate because mcpToolSource matches datamate against the start of the entire key instead of the parsed <client> segment. Using a client-segment check (with _ boundary) would avoid false Altimate badges for similarly named external MCP clients.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/opencode/src/altimate/tool-source.ts, line 58:

<comment>MCP source badging can misclassify some third-party tools as Altimate because `mcpToolSource` matches `datamate` against the start of the entire key instead of the parsed `<client>` segment. Using a client-segment check (with `_` boundary) would avoid false Altimate badges for similarly named external MCP clients.</comment>

<file context>
@@ -0,0 +1,72 @@
+/** Classify an MCP tool by its `<client>_<tool>` key: Altimate (Datamates) vs third-party. */
+export function mcpToolSource(key: string): ToolSource {
+  const lower = key.toLowerCase()
+  return ALTIMATE_MCP_PREFIXES.some((p) => lower.startsWith(p)) ? "altimate" : "mcp"
+}
+
</file context>

@kilo-code-bot

kilo-code-bot Bot commented Jul 3, 2026

Copy link
Copy Markdown

Code Review Summary

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 0
SUGGESTION 1
Issue Details (click to expand)

SUGGESTION

File Line Issue
packages/opencode/src/altimate/tool-source.ts 22 Native batch tool is missing from NATIVE_TOOL_IDS, so it is misclassified as altimate instead of builtin
Files Reviewed (7 files)
  • packages/opencode/src/altimate/tool-label.ts — no new findings (the dbt-labeling concerns are already covered by existing inline comments)
  • packages/opencode/src/altimate/tool-source.ts — 1 issue
  • packages/opencode/src/session/prompt.ts
  • packages/opencode/src/tool/tool.ts
  • packages/opencode/test/altimate/tool-label.test.ts
  • packages/opencode/test/altimate/tool-source.test.ts
  • packages/opencode/test/tool/write.test.ts

Fix these issues in Kilo Cloud


Reviewed by glm-5.2 · Input: 57.8K · Output: 16.5K · Cached: 545.6K

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants