Files
oh-my-pi/packages/coding-agent/src/modes/utils/tools-markdown.ts
T
can1357 5ff277349c refactor(coding-agent): consolidated tool surface onto xd:// devices and hub
- Added the `xd://` virtual device protocol (`internal-urls/xd-protocol.ts`, `tools/xdev.ts`): tools declaring `loadMode: "discoverable"` are unmounted from the request tools array and driven via `read xd://` (list/docs+schema) and `write xd://<tool>` (execute), gated by the `tools.xdev` setting (default on) and inlined into the system prompt.
- Merged the `irc`, `job`, and `launch` tools into a single `hub` tool (`tools/hub/`, `async/job-manager.ts`): messaging keeps `send`/`inbox`/`list`, job control maps to `wait`/`cancel`/`jobs`, process supervision keeps `start`/`logs`/`stop`/`restart`/`describe` with `ps`, and the unified `wait` races background jobs against peer messages; SDK `IrcTool`/`JobTool`/`LaunchTool` are replaced by `HubTool`.
- Removed the hidden `resolve` tool in favor of the `xd://resolve`/`xd://reject`/`xd://propose` resolution devices, auto-including `write` whenever a deferrable tool or plan mode is present.
- Removed the BM25 tool-discovery system: the `search_tool_bm25` tool, the `tool-discovery` module, the `tools.discoveryMode`/`mcp.discoveryMode`/`mcp.discoveryDefaultServers`/`tools.essentialOverride` settings, per-tool MCP selection, and the `mcp_tool_selection` message type.
- Unified tool presentation on `ToolLoadMode` (`essential`|`discoverable`), replacing the custom-tool `xdev?: boolean` opt-out; custom, extension, MCP, RPC host, image-generation, and TTS tools now default to `discoverable`, and added a `satisfies` predicate to `SoftToolRequirement`.
- Removed the standalone `ssh` command tool and `ssh/ssh-executor` (the `ssh://` read/write/search protocol stays), and made `--tools` address hidden built-ins.
- Updated collab-web to render `xd://` dispatches and `hub` op families, dropped the `search_tool_bm25`/`ssh`/`report-finding` renderers, refreshed tool docs and prompts, and migrated the affected tests and changelogs.
2026-07-15 15:16:29 +02:00

32 lines
1.1 KiB
TypeScript

import type { Tool } from "../../tools";
export interface ToolsMarkdownBindings {
tools: ReadonlyArray<Pick<Tool, "description" | "name">>;
/** Tools mounted under `xd://` URLs, listed after the active set. */
xdevTools?: ReadonlyArray<{ name: string; summary: string }>;
}
function escapeTableCell(value: string): string {
return value
.replace(/\|/g, "\\|")
.replace(/\r?\n+/g, " ")
.trim();
}
export function buildToolsMarkdown(bindings: ToolsMarkdownBindings): string {
if (bindings.tools.length === 0 && !bindings.xdevTools?.length) {
return "No tools are currently visible to the agent.";
}
const rows: string[] = [];
for (const tool of bindings.tools) {
const description = escapeTableCell(tool.description) || "No description provided.";
rows.push(`| \`${tool.name}\` | ${description} |`);
}
for (const mounted of bindings.xdevTools ?? []) {
rows.push(`| \`xd://${mounted.name}\` | ${escapeTableCell(mounted.summary) || "No description provided."} |`);
}
return ["| Tool | Description |", "|------|-------------|", ...rows].join("\n");
}