Skip to content

Commit 34f40e0

Browse files
improve description
Co-Authored-By: Waffleophagus <2243507+Waffleophagus@users.noreply.github.com>
1 parent b5f705e commit 34f40e0

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

‎packages/core/execution/src/description.ts‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,10 +41,12 @@ const formatDescription = (
4141
"",
4242
"- `tools.search()` returns ranked matches, best-first. Use short intent phrases like `github issues`, `repo details`, or `create calendar event`.",
4343
"- When you already know the namespace, narrow with `tools.search({ namespace: \"github\", query: \"issues\" })`.",
44-
"- Use `tools.executor.sources.list()` to inspect configured sources and their tool counts.",
44+
"- Use `tools.executor.sources.list()` to inspect configured sources and their tool counts. Returns `[{ id, toolCount, ... }]`.",
45+
"- Always use the namespace prefix when calling tools: `tools.<namespace>.<tool>(args)`. Example: `tools.home_assistant_rest_api.states.getState(...)` — not `tools.states.getState(...)`.",
4546
"- The `tools` object is a lazy proxy — `Object.keys(tools)` won't work. Use `tools.search()` or `tools.executor.sources.list()` instead.",
4647
"- Pass an object to system tools, e.g. `tools.search({ query: \"...\" })`, `tools.executor.sources.list()`, and `tools.describe.tool({ path })`.",
4748
"- `tools.describe.tool()` returns compact TypeScript shapes. Use `inputTypeScript`, `outputTypeScript`, and `typeScriptDefinitions`.",
49+
"- For tools that return large collections (e.g. `getStates`, `getAll`), filter results in code rather than calling per-item tools.",
4850
"- Do not use `fetch` — all API calls go through `tools.*`.",
4951
"- If execution pauses for interaction, resume it with the returned `resumePayload`.",
5052
];

0 commit comments

Comments
 (0)