From 8d681098ad2553a1a41f1ce7b03749427c9325eb Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Thu, 29 Jan 2026 06:35:29 +0000 Subject: [PATCH 1/2] docs: add validation requirements for agent tool configs - Entity tools must reference existing entities in base44/entities/ - Backend function tools must reference existing functions in base44/functions/ - Updated agents-push.md and SKILL.md to clarify these requirements Closes #49 Co-authored-by: paveltarno --- skills/base44-cli/SKILL.md | 4 ++-- skills/base44-cli/references/agents-push.md | 5 +++++ 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index a726ee0..2ff0ce5 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -258,8 +258,8 @@ Agents are conversational AI assistants that can interact with users, access you **Naming rules:** Agent names must be lowercase alphanumeric with underscores only (e.g., `support_agent`, `order_bot`) **Tool config types:** -- **Entity tools**: `entity_name` + `allowed_operations` (array of: `read`, `create`, `update`, `delete`) -- **Backend function tools**: `function_name` + `description` +- **Entity tools**: `entity_name` (MUST reference an existing entity in `base44/entities/`) + `allowed_operations` (array of: `read`, `create`, `update`, `delete`) +- **Backend function tools**: `function_name` (MUST reference an existing function in `base44/functions/`) + `description` ### Site Deployment diff --git a/skills/base44-cli/references/agents-push.md b/skills/base44-cli/references/agents-push.md index 1607bf9..8182cbd 100644 --- a/skills/base44-cli/references/agents-push.md +++ b/skills/base44-cli/references/agents-push.md @@ -88,6 +88,11 @@ Each agent file should be a `.jsonc` file in `base44/agents/` with this structur - Valid: `support_agent`, `order_bot`, `task_helper` - Invalid: `Support-Agent`, `OrderBot`, `task helper` +**Tool configuration validation:** +- **Entity tools**: The `entity_name` MUST reference an existing entity defined in `base44/entities/` +- **Backend function tools**: The `function_name` MUST reference an existing backend function defined in `base44/functions/` +- **Allowed operations**: Must be one or more of: `read`, `create`, `update`, `delete` + ## Use Cases - After defining new agents in your project From eca9f856dc88282fa36908deaa0eebea1de1d8fa Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Thu, 29 Jan 2026 09:32:41 +0000 Subject: [PATCH 2/2] docs: clarify entity_name and function_name reference name fields - entity_name references the 'name' field in entity configs - function_name references the 'name' field in backend function configs Co-authored-by: paveltarno --- skills/base44-cli/SKILL.md | 4 ++-- skills/base44-cli/references/agents-push.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index 2ff0ce5..1c62dd8 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -258,8 +258,8 @@ Agents are conversational AI assistants that can interact with users, access you **Naming rules:** Agent names must be lowercase alphanumeric with underscores only (e.g., `support_agent`, `order_bot`) **Tool config types:** -- **Entity tools**: `entity_name` (MUST reference an existing entity in `base44/entities/`) + `allowed_operations` (array of: `read`, `create`, `update`, `delete`) -- **Backend function tools**: `function_name` (MUST reference an existing function in `base44/functions/`) + `description` +- **Entity tools**: `entity_name` (MUST reference an existing `name` field of an entity configuration defined in `base44/entities/`) + `allowed_operations` (array of: `read`, `create`, `update`, `delete`) +- **Backend function tools**: `function_name` (MUST reference an existing `name` of a backend function configuration defined in `base44/functions/`) + `description` ### Site Deployment diff --git a/skills/base44-cli/references/agents-push.md b/skills/base44-cli/references/agents-push.md index 8182cbd..b584e2c 100644 --- a/skills/base44-cli/references/agents-push.md +++ b/skills/base44-cli/references/agents-push.md @@ -89,8 +89,8 @@ Each agent file should be a `.jsonc` file in `base44/agents/` with this structur - Invalid: `Support-Agent`, `OrderBot`, `task helper` **Tool configuration validation:** -- **Entity tools**: The `entity_name` MUST reference an existing entity defined in `base44/entities/` -- **Backend function tools**: The `function_name` MUST reference an existing backend function defined in `base44/functions/` +- **Entity tools**: The `entity_name` MUST reference an existing `name` field of an entity configuration defined in `base44/entities/` +- **Backend function tools**: The `function_name` MUST reference an existing `name` of a backend function configuration defined in `base44/functions/` - **Allowed operations**: Must be one or more of: `read`, `create`, `update`, `delete` ## Use Cases