Skip to content

docs(agents): document server route tools in tool_configs - #176

Merged
yardend-wix merged 2 commits into
mainfrom
claude/agent-server-route-tools
Oct 25, 2026
Merged

yardend-wix merged 2 commits into
mainfrom
claude/agent-server-route-tools

Conversation

@claude

@claude claude Bot commented Oct 25, 2026

Copy link
Copy Markdown
Contributor

Requested by Yarden Danan · Slack thread

Before: The agent schema in the base44-cli and base44-sandbox skills lists only entity tools and backend-function tools, so an agent editing base44/agents/*.jsonc doesn't know about server route tools, the tool type that lets an in-app agent in a full-stack app call one of the app's own server routes.

After: Both skills document the server route tool shape (tool_name, route_path, method, description), with the backend's rules and defaults, and include an example.

How: base44-cli/SKILL.md (schema template and the tool-type list), base44-cli/references/agents-push.md (schema template plus a new "Server Route Tools" field table and example), base44-sandbox/SKILL.md (the tool-type sentence). Field rules mirror apper's ServerRouteToolConfig / validated_route_path: tool_name is 1-64 of [A-Za-z0-9_-]; route_path is app-relative, a single leading /, at most 2000 characters, with no query string; method is one of get/post/put/patch/delete (default post); description defaults to "agent server route".

Related: BUG-1059 (https://issue-tracker.base44.app/issue/BUG-1059). The CLI side is base44/cli#680. Until a CLI release includes it, agents pull/push reject agent files that have route tools. Merge this after #680 ships. The sandbox flow doesn't depend on it, because there the file syncs server-side. The automated sync-cli-skill job only diffs src/cli, so it wouldn't pick up the change in #680 (src/core/resources/agent/schema.ts). That's why these edits are made by hand.

Not tested: docs-only change.


Generated by Claude Code

Agents in full-stack apps can call the app's own server routes as tools
({tool_name, route_path, method, description}). Add that tool shape to the
agent schema in the base44-cli and base44-sandbox skills.

BUG-1059

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FH6Ycrnejz2JBWgXbshcnr
@claude

claude Bot commented Oct 25, 2026

Copy link
Copy Markdown
Contributor Author

claude-review fails on this PR before reviewing anything: Workflow initiated by non-human actor: claude (type: Bot). Add bot to allowed_bots list or use '*' to allow all bots. That's the workflow's allowed_bots setting, not this diff (docs-only change; readme-check passes). A re-run would hit the same gate, so I haven't re-run it. A maintainer can add the bot to allowed_bots in the claude-review workflow or review manually.


Generated by Claude Code

@yardend-wix
yardend-wix marked this pull request as ready for review October 25, 2026 14:56
@yardend-wix
yardend-wix merged commit 061d036 into main Oct 25, 2026
2 checks passed
@yardend-wix
yardend-wix deleted the claude/agent-server-route-tools branch October 25, 2026 15:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants