struere 0.7.1 → 0.7.3

package/dist/bin/struere.js

@@ -20657,34 +20657,13 @@ function getResourceDirectories(cwd) {
 }
 
 // src/cli/commands/docs.ts
-var DOCS_URL = "https://docs.struere.dev/llms-full.txt";
+var DOCS_BASE = "https://docs.struere.dev";
 var ALL_TARGETS = ["claude", "cursor", "copilot"];
 var TARGET_FILES = {
   claude: "CLAUDE.md",
   cursor: ".cursorrules",
   copilot: ".github/copilot-instructions.md"
 };
-var TARGET_HEADERS = {
-  claude: `# Struere Workspace
-
-> This is a Struere workspace project. You define agents, entity types, roles, and custom tools here. The CLI syncs them to Convex.
-`,
-  cursor: `# Struere Workspace
-
-This is a Struere workspace project. You define agents, entity types, roles, and custom tools here. The CLI syncs them to Convex.
-`,
-  copilot: `# Struere Workspace
-
-This is a Struere workspace project. You define agents, entity types, roles, and custom tools here. The CLI syncs them to Convex.
-`
-};
-async function fetchFrameworkDocs() {
-  const response = await fetch(DOCS_URL, { signal: AbortSignal.timeout(15000) });
-  if (!response.ok) {
-    throw new Error(`Failed to fetch docs: ${response.status} ${response.statusText}`);
-  }
-  return await response.text();
-}
 function buildProjectContext(orgName, resources) {
   const lines = [];
   lines.push(`## This Project`);
@@ -20695,7 +20674,7 @@ function buildProjectContext(orgName, resources) {
     lines.push(`### Agents (${resources.agents.length})`);
     for (const agent of resources.agents) {
       const tools = agent.tools?.length ? ` \u2014 tools: ${agent.tools.join(", ")}` : "";
-      lines.push(`- ${agent.name} (${agent.slug}) - v${agent.version}${tools}`);
+      lines.push(`- **${agent.name}** (\`${agent.slug}\`) v${agent.version}${tools}`);
     }
   }
   if (resources.entityTypes.length > 0) {
@@ -20704,7 +20683,7 @@ function buildProjectContext(orgName, resources) {
     for (const et of resources.entityTypes) {
       const fields = et.schema?.properties ? Object.keys(et.schema.properties).join(", ") : "";
       const fieldStr = fields ? ` \u2014 fields: ${fields}` : "";
-      lines.push(`- ${et.name} (${et.slug})${fieldStr}`);
+      lines.push(`- **${et.name}** (\`${et.slug}\`)${fieldStr}`);
     }
   }
   if (resources.roles.length > 0) {
@@ -20712,37 +20691,167 @@ function buildProjectContext(orgName, resources) {
     lines.push(`### Roles (${resources.roles.length})`);
     for (const role of resources.roles) {
       const policyCount = role.policies?.length || 0;
-      lines.push(`- ${role.name} \u2014 ${policyCount} ${policyCount === 1 ? "policy" : "policies"}`);
+      lines.push(`- **${role.name}** \u2014 ${policyCount} ${policyCount === 1 ? "policy" : "policies"}`);
     }
   }
   if (resources.triggers.length > 0) {
     lines.push("");
     lines.push(`### Triggers (${resources.triggers.length})`);
     for (const trigger of resources.triggers) {
-      lines.push(`- ${trigger.name} (${trigger.slug}) \u2014 on ${trigger.on.entityType}.${trigger.on.action}`);
+      lines.push(`- **${trigger.name}** (\`${trigger.slug}\`) \u2014 on \`${trigger.on.entityType}.${trigger.on.action}\``);
     }
   }
   if (resources.customTools.length > 0) {
     lines.push("");
     lines.push(`### Custom Tools (${resources.customTools.length})`);
     for (const tool of resources.customTools) {
-      lines.push(`- ${tool.name} \u2014 ${tool.description}`);
+      lines.push(`- **${tool.name}** \u2014 ${tool.description}`);
     }
   }
-  lines.push("");
   return lines.join(`
 `);
 }
-function assembleDocument(target, projectContext, frameworkDocs) {
-  const parts = [];
-  parts.push(TARGET_HEADERS[target]);
+function buildDocument(projectContext) {
+  const lines = [];
+  lines.push(`# Struere Workspace`);
+  lines.push("");
+  lines.push(`> This is a Struere workspace project. You define agents, entity types, roles, triggers, and custom tools here. The CLI syncs them to the Convex backend.`);
+  lines.push("");
   if (projectContext) {
-    parts.push(projectContext);
+    lines.push(projectContext);
+    lines.push("");
   }
-  parts.push(`---
-`);
-  parts.push(frameworkDocs);
-  return parts.join(`
+  lines.push(`## Project Structure`);
+  lines.push("");
+  lines.push("```");
+  lines.push("agents/              # Agent definitions (one file per agent)");
+  lines.push("entity-types/        # Entity type schemas (like DB tables)");
+  lines.push("roles/               # RBAC roles with policies, scope rules, field masks");
+  lines.push("triggers/            # Automation rules (react to entity changes)");
+  lines.push("tools/index.ts       # Custom tools shared by all agents");
+  lines.push("evals/*.eval.yaml    # Test suites for agent evaluation");
+  lines.push("struere.json         # Organization config (auto-generated)");
+  lines.push("```");
+  lines.push("");
+  lines.push(`## CLI Commands`);
+  lines.push("");
+  lines.push("| Command | Description |");
+  lines.push("|---------|-------------|");
+  lines.push("| `struere dev` | Watch files and sync to Convex on save |");
+  lines.push("| `struere deploy` | Push development config to production |");
+  lines.push("| `struere add agent\\|entity-type\\|role\\|trigger\\|eval <name>` | Scaffold a new resource |");
+  lines.push("| `struere status` | Compare local vs remote state |");
+  lines.push("| `struere pull` | Download remote resources to local files |");
+  lines.push("| `struere entities types` | List entity types in an environment |");
+  lines.push("| `struere entities list <type>` | List entities (supports `--status`, `--limit`, `--json`) |");
+  lines.push("| `struere entities get <id>` | Get entity details |");
+  lines.push("| `struere entities create <type>` | Create entity (interactive or `--data <json>`) |");
+  lines.push("| `struere entities update <id>` | Update entity (`--data <json>`, `--status`) |");
+  lines.push("| `struere entities delete <id>` | Delete entity (with confirmation) |");
+  lines.push("| `struere entities search <type> <query>` | Search entities by text |");
+  lines.push("| `struere docs` | Regenerate this file |");
+  lines.push("");
+  lines.push(`## Key Patterns`);
+  lines.push("");
+  lines.push("- **Imports**: `import { defineAgent, defineEntityType, defineRole, defineTrigger, defineTools } from 'struere'`");
+  lines.push("- **Default model**: `claude-sonnet-4` (provider: `anthropic`). Also supports `openai` and `google`");
+  lines.push("- **Scope rule values**: `actor.userId`, `actor.entityId`, `actor.organizationId`, `actor.relatedIds:TYPE`, `literal:VALUE`");
+  lines.push("- **Policy actions**: `create`, `read`, `update`, `delete`, `list` (deny overrides allow)");
+  lines.push("- **Entity link/unlink params**: `fromId`, `toId`, `relationType`");
+  lines.push("- **Trigger template vars**: `{{trigger.entityId}}`, `{{trigger.data.X}}`, `{{steps.NAME.X}}`");
+  lines.push("");
+  lines.push(`## Dynamic System Prompts`);
+  lines.push("");
+  lines.push("System prompts are **not static strings** \u2014 they are templates evaluated at runtime before every LLM call. This is one of the most powerful features in Struere because it enables completely different agent behavior depending on conditions, live data, and even other agents' responses.");
+  lines.push("");
+  lines.push("### Template Variables");
+  lines.push("Simple variable substitution: `{{agentName}}`, `{{organizationName}}`, `{{currentTime}}`, `{{entityTypes}}`, `{{roles}}`, `{{message}}`, `{{thread.metadata.X}}`");
+  lines.push("");
+  lines.push("### Embedded Queries (Function Calls)");
+  lines.push("Pull live data from the database directly into the system prompt:");
+  lines.push("```");
+  lines.push('{{entity.query({"type": "customer", "limit": 5})}}');
+  lines.push('{{entity.get({"id": "ent_123"})}}');
+  lines.push("```");
+  lines.push("This means the agent always sees the latest data \u2014 no stale context.");
+  lines.push("");
+  lines.push("### Custom Tools in Prompts");
+  lines.push("Since custom tools can run arbitrary logic, you can create tools specifically to generate dynamic prompt sections. A custom tool can fetch external APIs, compute conditions, aggregate data, or format context \u2014 and its output gets embedded into the system prompt at runtime.");
+  lines.push("");
+  lines.push("### Agent-to-Agent in Prompts");
+  lines.push('You can even use `agent.chat` in the template to have another agent\'s response injected into the system prompt. This enables patterns like a "context agent" that summarizes relevant info before the main agent starts reasoning.');
+  lines.push("");
+  lines.push(`For full template syntax: [System Prompt Templates](${DOCS_BASE}/tools/system-prompt-templates.md)`);
+  lines.push("");
+  lines.push(`## Multi-Agent Communication (agent.chat)`);
+  lines.push("");
+  lines.push("The `agent.chat` tool lets agents delegate work to other agents. This is a core building block for complex systems:");
+  lines.push("");
+  lines.push("- **Orchestrator pattern**: A coordinator agent routes tasks to specialist agents based on the request");
+  lines.push("- **Trigger actions**: Use `agent.chat` inside trigger action pipelines to have an agent reason about entity changes");
+  lines.push("- **Chained delegation**: Agents can call other agents up to 3 levels deep (A\u2192B\u2192C), with cycle detection");
+  lines.push("- **Isolated execution**: Each agent runs its own LLM loop with its own system prompt, tools, and permissions");
+  lines.push("");
+  lines.push("```typescript");
+  lines.push("// Orchestrator that delegates to specialists");
+  lines.push('tools: ["agent.chat", "entity.query"]');
+  lines.push("// In trigger actions:");
+  lines.push('{ tool: "agent.chat", args: { agent: "billing-agent", message: "Process refund for {{trigger.data.orderId}}" } }');
+  lines.push("```");
+  lines.push("");
+  lines.push(`For details: [Agents](${DOCS_BASE}/platform/agents.md)`);
+  lines.push("");
+  lines.push(`## Best Practices`);
+  lines.push("");
+  lines.push("- **Keep tools under 10 per agent.** Agents perform significantly worse when they have too many tools to choose from. If an agent needs more, split it into specialist agents and use `agent.chat` to orchestrate");
+  lines.push("- **Always ask the user before making assumptions.** The user may not be technical \u2014 help them accomplish what they want by asking the right questions and offering clear options");
+  lines.push("- **Always check the documentation before making changes.** Fetch the relevant doc link below to verify the correct API, field names, and patterns. Do not guess \u2014 wrong field names or patterns will cause silent failures");
+  lines.push("- **Use `struere dev` to validate changes.** Every save triggers a sync \u2014 check the terminal for errors before testing");
+  lines.push("- **Test with evals.** Write eval suites to catch regressions in agent behavior (`struere add eval <name>`)");
+  lines.push("");
+  lines.push(`## Documentation`);
+  lines.push("");
+  lines.push(`Fetch these URLs for detailed documentation on each topic:`);
+  lines.push("");
+  lines.push("### SDK");
+  lines.push(`- [SDK Overview](${DOCS_BASE}/sdk/overview.md)`);
+  lines.push(`- [defineAgent](${DOCS_BASE}/sdk/define-agent.md)`);
+  lines.push(`- [defineEntityType](${DOCS_BASE}/sdk/define-entity-type.md)`);
+  lines.push(`- [defineRole](${DOCS_BASE}/sdk/define-role.md)`);
+  lines.push(`- [defineTrigger](${DOCS_BASE}/sdk/define-trigger.md)`);
+  lines.push(`- [defineTools](${DOCS_BASE}/sdk/define-tools.md)`);
+  lines.push("");
+  lines.push("### Tools");
+  lines.push(`- [Built-in Tools](${DOCS_BASE}/tools/built-in-tools.md)`);
+  lines.push(`- [Custom Tools](${DOCS_BASE}/tools/custom-tools.md)`);
+  lines.push(`- [System Prompt Templates](${DOCS_BASE}/tools/system-prompt-templates.md)`);
+  lines.push("");
+  lines.push("### Platform");
+  lines.push(`- [Entities](${DOCS_BASE}/platform/entities.md)`);
+  lines.push(`- [Permissions](${DOCS_BASE}/platform/permissions.md)`);
+  lines.push(`- [Agents](${DOCS_BASE}/platform/agents.md)`);
+  lines.push(`- [Events](${DOCS_BASE}/platform/events.md)`);
+  lines.push(`- [Triggers](${DOCS_BASE}/platform/triggers.md)`);
+  lines.push(`- [Environment Isolation](${DOCS_BASE}/platform/environment-isolation.md)`);
+  lines.push("");
+  lines.push("### CLI");
+  lines.push(`- [CLI Overview](${DOCS_BASE}/cli/overview.md)`);
+  lines.push(`- [struere init](${DOCS_BASE}/cli/init.md)`);
+  lines.push(`- [struere dev](${DOCS_BASE}/cli/dev.md)`);
+  lines.push(`- [struere add](${DOCS_BASE}/cli/add.md)`);
+  lines.push(`- [struere deploy](${DOCS_BASE}/cli/deploy.md)`);
+  lines.push("");
+  lines.push("### API & Integrations");
+  lines.push(`- [Chat API](${DOCS_BASE}/api/chat.md)`);
+  lines.push(`- [Webhooks](${DOCS_BASE}/api/webhooks.md)`);
+  lines.push(`- [WhatsApp Integration](${DOCS_BASE}/integrations/whatsapp.md)`);
+  lines.push("");
+  lines.push("### Reference");
+  lines.push(`- [Project Structure](${DOCS_BASE}/reference/project-structure.md)`);
+  lines.push(`- [Model Configuration](${DOCS_BASE}/reference/model-configuration.md)`);
+  lines.push("");
+  lines.push(`Full docs: ${DOCS_BASE}/llms-full.txt`);
+  return lines.join(`
 `);
 }
 function writeTarget(cwd, target, content) {
@@ -20755,12 +20864,6 @@ function writeTarget(cwd, target, content) {
 }
 async function generateDocs(cwd, targets) {
   const generated = [];
-  let frameworkDocs;
-  try {
-    frameworkDocs = await fetchFrameworkDocs();
-  } catch (err) {
-    return { generated, error: err instanceof Error ? err.message : String(err) };
-  }
   let projectContext = null;
   const project = loadProject(cwd);
   if (project) {
@@ -20779,8 +20882,8 @@ async function generateDocs(cwd, targets) {
       });
     }
   }
+  const content = buildDocument(projectContext);
   for (const target of targets) {
-    const content = assembleDocument(target, projectContext, frameworkDocs);
     writeTarget(cwd, target, content);
     generated.push(TARGET_FILES[target]);
   }
@@ -20804,10 +20907,10 @@ var docsCommand = new Command("docs").description("Generate AI context files (CL
   } else {
     targets = [...ALL_TARGETS];
   }
-  spinner.start("Fetching docs and generating context files");
+  spinner.start("Generating context files");
   const { generated, error } = await generateDocs(cwd, targets);
   if (error) {
-    spinner.fail("Failed to fetch docs");
+    spinner.fail("Failed to generate docs");
     console.log(source_default.red("Error:"), error);
     process.exit(1);
   }
@@ -23160,7 +23263,7 @@ entitiesCommand.command("search <type> <query>").description("Search entities").
 // package.json
 var package_default = {
   name: "struere",
-  version: "0.7.1",
+  version: "0.7.3",
   description: "Build, test, and deploy AI agents",
   keywords: [
     "ai",

package/dist/cli/commands/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAUnC,KAAK,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AAkG7C,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BnH;AAED,eAAO,MAAM,WAAW,SAsCpB,CAAA"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAUnC,KAAK,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AAiO7C,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBnH;AAED,eAAO,MAAM,WAAW,SAsCpB,CAAA"}

package/dist/cli/index.js

@@ -1323,34 +1323,13 @@ function getResourceDirectories(cwd) {
 }
 
 // src/cli/commands/docs.ts
-var DOCS_URL = "https://docs.struere.dev/llms-full.txt";
+var DOCS_BASE = "https://docs.struere.dev";
 var ALL_TARGETS = ["claude", "cursor", "copilot"];
 var TARGET_FILES = {
   claude: "CLAUDE.md",
   cursor: ".cursorrules",
   copilot: ".github/copilot-instructions.md"
 };
-var TARGET_HEADERS = {
-  claude: `# Struere Workspace
-
-> This is a Struere workspace project. You define agents, entity types, roles, and custom tools here. The CLI syncs them to Convex.
-`,
-  cursor: `# Struere Workspace
-
-This is a Struere workspace project. You define agents, entity types, roles, and custom tools here. The CLI syncs them to Convex.
-`,
-  copilot: `# Struere Workspace
-
-This is a Struere workspace project. You define agents, entity types, roles, and custom tools here. The CLI syncs them to Convex.
-`
-};
-async function fetchFrameworkDocs() {
-  const response = await fetch(DOCS_URL, { signal: AbortSignal.timeout(15000) });
-  if (!response.ok) {
-    throw new Error(`Failed to fetch docs: ${response.status} ${response.statusText}`);
-  }
-  return await response.text();
-}
 function buildProjectContext(orgName, resources) {
   const lines = [];
   lines.push(`## This Project`);
@@ -1361,7 +1340,7 @@ function buildProjectContext(orgName, resources) {
     lines.push(`### Agents (${resources.agents.length})`);
     for (const agent of resources.agents) {
       const tools = agent.tools?.length ? ` \u2014 tools: ${agent.tools.join(", ")}` : "";
-      lines.push(`- ${agent.name} (${agent.slug}) - v${agent.version}${tools}`);
+      lines.push(`- **${agent.name}** (\`${agent.slug}\`) v${agent.version}${tools}`);
     }
   }
   if (resources.entityTypes.length > 0) {
@@ -1370,7 +1349,7 @@ function buildProjectContext(orgName, resources) {
     for (const et of resources.entityTypes) {
       const fields = et.schema?.properties ? Object.keys(et.schema.properties).join(", ") : "";
       const fieldStr = fields ? ` \u2014 fields: ${fields}` : "";
-      lines.push(`- ${et.name} (${et.slug})${fieldStr}`);
+      lines.push(`- **${et.name}** (\`${et.slug}\`)${fieldStr}`);
     }
   }
   if (resources.roles.length > 0) {
@@ -1378,37 +1357,167 @@ function buildProjectContext(orgName, resources) {
     lines.push(`### Roles (${resources.roles.length})`);
     for (const role of resources.roles) {
       const policyCount = role.policies?.length || 0;
-      lines.push(`- ${role.name} \u2014 ${policyCount} ${policyCount === 1 ? "policy" : "policies"}`);
+      lines.push(`- **${role.name}** \u2014 ${policyCount} ${policyCount === 1 ? "policy" : "policies"}`);
     }
   }
   if (resources.triggers.length > 0) {
     lines.push("");
     lines.push(`### Triggers (${resources.triggers.length})`);
     for (const trigger of resources.triggers) {
-      lines.push(`- ${trigger.name} (${trigger.slug}) \u2014 on ${trigger.on.entityType}.${trigger.on.action}`);
+      lines.push(`- **${trigger.name}** (\`${trigger.slug}\`) \u2014 on \`${trigger.on.entityType}.${trigger.on.action}\``);
     }
   }
   if (resources.customTools.length > 0) {
     lines.push("");
     lines.push(`### Custom Tools (${resources.customTools.length})`);
     for (const tool of resources.customTools) {
-      lines.push(`- ${tool.name} \u2014 ${tool.description}`);
+      lines.push(`- **${tool.name}** \u2014 ${tool.description}`);
     }
   }
-  lines.push("");
   return lines.join(`
 `);
 }
-function assembleDocument(target, projectContext, frameworkDocs) {
-  const parts = [];
-  parts.push(TARGET_HEADERS[target]);
+function buildDocument(projectContext) {
+  const lines = [];
+  lines.push(`# Struere Workspace`);
+  lines.push("");
+  lines.push(`> This is a Struere workspace project. You define agents, entity types, roles, triggers, and custom tools here. The CLI syncs them to the Convex backend.`);
+  lines.push("");
   if (projectContext) {
-    parts.push(projectContext);
+    lines.push(projectContext);
+    lines.push("");
   }
-  parts.push(`---
-`);
-  parts.push(frameworkDocs);
-  return parts.join(`
+  lines.push(`## Project Structure`);
+  lines.push("");
+  lines.push("```");
+  lines.push("agents/              # Agent definitions (one file per agent)");
+  lines.push("entity-types/        # Entity type schemas (like DB tables)");
+  lines.push("roles/               # RBAC roles with policies, scope rules, field masks");
+  lines.push("triggers/            # Automation rules (react to entity changes)");
+  lines.push("tools/index.ts       # Custom tools shared by all agents");
+  lines.push("evals/*.eval.yaml    # Test suites for agent evaluation");
+  lines.push("struere.json         # Organization config (auto-generated)");
+  lines.push("```");
+  lines.push("");
+  lines.push(`## CLI Commands`);
+  lines.push("");
+  lines.push("| Command | Description |");
+  lines.push("|---------|-------------|");
+  lines.push("| `struere dev` | Watch files and sync to Convex on save |");
+  lines.push("| `struere deploy` | Push development config to production |");
+  lines.push("| `struere add agent\\|entity-type\\|role\\|trigger\\|eval <name>` | Scaffold a new resource |");
+  lines.push("| `struere status` | Compare local vs remote state |");
+  lines.push("| `struere pull` | Download remote resources to local files |");
+  lines.push("| `struere entities types` | List entity types in an environment |");
+  lines.push("| `struere entities list <type>` | List entities (supports `--status`, `--limit`, `--json`) |");
+  lines.push("| `struere entities get <id>` | Get entity details |");
+  lines.push("| `struere entities create <type>` | Create entity (interactive or `--data <json>`) |");
+  lines.push("| `struere entities update <id>` | Update entity (`--data <json>`, `--status`) |");
+  lines.push("| `struere entities delete <id>` | Delete entity (with confirmation) |");
+  lines.push("| `struere entities search <type> <query>` | Search entities by text |");
+  lines.push("| `struere docs` | Regenerate this file |");
+  lines.push("");
+  lines.push(`## Key Patterns`);
+  lines.push("");
+  lines.push("- **Imports**: `import { defineAgent, defineEntityType, defineRole, defineTrigger, defineTools } from 'struere'`");
+  lines.push("- **Default model**: `claude-sonnet-4` (provider: `anthropic`). Also supports `openai` and `google`");
+  lines.push("- **Scope rule values**: `actor.userId`, `actor.entityId`, `actor.organizationId`, `actor.relatedIds:TYPE`, `literal:VALUE`");
+  lines.push("- **Policy actions**: `create`, `read`, `update`, `delete`, `list` (deny overrides allow)");
+  lines.push("- **Entity link/unlink params**: `fromId`, `toId`, `relationType`");
+  lines.push("- **Trigger template vars**: `{{trigger.entityId}}`, `{{trigger.data.X}}`, `{{steps.NAME.X}}`");
+  lines.push("");
+  lines.push(`## Dynamic System Prompts`);
+  lines.push("");
+  lines.push("System prompts are **not static strings** \u2014 they are templates evaluated at runtime before every LLM call. This is one of the most powerful features in Struere because it enables completely different agent behavior depending on conditions, live data, and even other agents' responses.");
+  lines.push("");
+  lines.push("### Template Variables");
+  lines.push("Simple variable substitution: `{{agentName}}`, `{{organizationName}}`, `{{currentTime}}`, `{{entityTypes}}`, `{{roles}}`, `{{message}}`, `{{thread.metadata.X}}`");
+  lines.push("");
+  lines.push("### Embedded Queries (Function Calls)");
+  lines.push("Pull live data from the database directly into the system prompt:");
+  lines.push("```");
+  lines.push('{{entity.query({"type": "customer", "limit": 5})}}');
+  lines.push('{{entity.get({"id": "ent_123"})}}');
+  lines.push("```");
+  lines.push("This means the agent always sees the latest data \u2014 no stale context.");
+  lines.push("");
+  lines.push("### Custom Tools in Prompts");
+  lines.push("Since custom tools can run arbitrary logic, you can create tools specifically to generate dynamic prompt sections. A custom tool can fetch external APIs, compute conditions, aggregate data, or format context \u2014 and its output gets embedded into the system prompt at runtime.");
+  lines.push("");
+  lines.push("### Agent-to-Agent in Prompts");
+  lines.push('You can even use `agent.chat` in the template to have another agent\'s response injected into the system prompt. This enables patterns like a "context agent" that summarizes relevant info before the main agent starts reasoning.');
+  lines.push("");
+  lines.push(`For full template syntax: [System Prompt Templates](${DOCS_BASE}/tools/system-prompt-templates.md)`);
+  lines.push("");
+  lines.push(`## Multi-Agent Communication (agent.chat)`);
+  lines.push("");
+  lines.push("The `agent.chat` tool lets agents delegate work to other agents. This is a core building block for complex systems:");
+  lines.push("");
+  lines.push("- **Orchestrator pattern**: A coordinator agent routes tasks to specialist agents based on the request");
+  lines.push("- **Trigger actions**: Use `agent.chat` inside trigger action pipelines to have an agent reason about entity changes");
+  lines.push("- **Chained delegation**: Agents can call other agents up to 3 levels deep (A\u2192B\u2192C), with cycle detection");
+  lines.push("- **Isolated execution**: Each agent runs its own LLM loop with its own system prompt, tools, and permissions");
+  lines.push("");
+  lines.push("```typescript");
+  lines.push("// Orchestrator that delegates to specialists");
+  lines.push('tools: ["agent.chat", "entity.query"]');
+  lines.push("// In trigger actions:");
+  lines.push('{ tool: "agent.chat", args: { agent: "billing-agent", message: "Process refund for {{trigger.data.orderId}}" } }');
+  lines.push("```");
+  lines.push("");
+  lines.push(`For details: [Agents](${DOCS_BASE}/platform/agents.md)`);
+  lines.push("");
+  lines.push(`## Best Practices`);
+  lines.push("");
+  lines.push("- **Keep tools under 10 per agent.** Agents perform significantly worse when they have too many tools to choose from. If an agent needs more, split it into specialist agents and use `agent.chat` to orchestrate");
+  lines.push("- **Always ask the user before making assumptions.** The user may not be technical \u2014 help them accomplish what they want by asking the right questions and offering clear options");
+  lines.push("- **Always check the documentation before making changes.** Fetch the relevant doc link below to verify the correct API, field names, and patterns. Do not guess \u2014 wrong field names or patterns will cause silent failures");
+  lines.push("- **Use `struere dev` to validate changes.** Every save triggers a sync \u2014 check the terminal for errors before testing");
+  lines.push("- **Test with evals.** Write eval suites to catch regressions in agent behavior (`struere add eval <name>`)");
+  lines.push("");
+  lines.push(`## Documentation`);
+  lines.push("");
+  lines.push(`Fetch these URLs for detailed documentation on each topic:`);
+  lines.push("");
+  lines.push("### SDK");
+  lines.push(`- [SDK Overview](${DOCS_BASE}/sdk/overview.md)`);
+  lines.push(`- [defineAgent](${DOCS_BASE}/sdk/define-agent.md)`);
+  lines.push(`- [defineEntityType](${DOCS_BASE}/sdk/define-entity-type.md)`);
+  lines.push(`- [defineRole](${DOCS_BASE}/sdk/define-role.md)`);
+  lines.push(`- [defineTrigger](${DOCS_BASE}/sdk/define-trigger.md)`);
+  lines.push(`- [defineTools](${DOCS_BASE}/sdk/define-tools.md)`);
+  lines.push("");
+  lines.push("### Tools");
+  lines.push(`- [Built-in Tools](${DOCS_BASE}/tools/built-in-tools.md)`);
+  lines.push(`- [Custom Tools](${DOCS_BASE}/tools/custom-tools.md)`);
+  lines.push(`- [System Prompt Templates](${DOCS_BASE}/tools/system-prompt-templates.md)`);
+  lines.push("");
+  lines.push("### Platform");
+  lines.push(`- [Entities](${DOCS_BASE}/platform/entities.md)`);
+  lines.push(`- [Permissions](${DOCS_BASE}/platform/permissions.md)`);
+  lines.push(`- [Agents](${DOCS_BASE}/platform/agents.md)`);
+  lines.push(`- [Events](${DOCS_BASE}/platform/events.md)`);
+  lines.push(`- [Triggers](${DOCS_BASE}/platform/triggers.md)`);
+  lines.push(`- [Environment Isolation](${DOCS_BASE}/platform/environment-isolation.md)`);
+  lines.push("");
+  lines.push("### CLI");
+  lines.push(`- [CLI Overview](${DOCS_BASE}/cli/overview.md)`);
+  lines.push(`- [struere init](${DOCS_BASE}/cli/init.md)`);
+  lines.push(`- [struere dev](${DOCS_BASE}/cli/dev.md)`);
+  lines.push(`- [struere add](${DOCS_BASE}/cli/add.md)`);
+  lines.push(`- [struere deploy](${DOCS_BASE}/cli/deploy.md)`);
+  lines.push("");
+  lines.push("### API & Integrations");
+  lines.push(`- [Chat API](${DOCS_BASE}/api/chat.md)`);
+  lines.push(`- [Webhooks](${DOCS_BASE}/api/webhooks.md)`);
+  lines.push(`- [WhatsApp Integration](${DOCS_BASE}/integrations/whatsapp.md)`);
+  lines.push("");
+  lines.push("### Reference");
+  lines.push(`- [Project Structure](${DOCS_BASE}/reference/project-structure.md)`);
+  lines.push(`- [Model Configuration](${DOCS_BASE}/reference/model-configuration.md)`);
+  lines.push("");
+  lines.push(`Full docs: ${DOCS_BASE}/llms-full.txt`);
+  return lines.join(`
 `);
 }
 function writeTarget(cwd, target, content) {
@@ -1421,12 +1530,6 @@ function writeTarget(cwd, target, content) {
 }
 async function generateDocs(cwd, targets) {
   const generated = [];
-  let frameworkDocs;
-  try {
-    frameworkDocs = await fetchFrameworkDocs();
-  } catch (err) {
-    return { generated, error: err instanceof Error ? err.message : String(err) };
-  }
   let projectContext = null;
   const project = loadProject(cwd);
   if (project) {
@@ -1445,8 +1548,8 @@ async function generateDocs(cwd, targets) {
       });
     }
   }
+  const content = buildDocument(projectContext);
   for (const target of targets) {
-    const content = assembleDocument(target, projectContext, frameworkDocs);
     writeTarget(cwd, target, content);
     generated.push(TARGET_FILES[target]);
   }
@@ -1470,10 +1573,10 @@ var docsCommand = new Command2("docs").description("Generate AI context files (C
   } else {
     targets = [...ALL_TARGETS];
   }
-  spinner.start("Fetching docs and generating context files");
+  spinner.start("Generating context files");
   const { generated, error } = await generateDocs(cwd, targets);
   if (error) {
-    spinner.fail("Failed to fetch docs");
+    spinner.fail("Failed to generate docs");
     console.log(chalk2.red("Error:"), error);
     process.exit(1);
   }
@@ -3854,7 +3957,7 @@ entitiesCommand.command("search <type> <query>").description("Search entities").
 // package.json
 var package_default = {
   name: "struere",
-  version: "0.7.1",
+  version: "0.7.3",
   description: "Build, test, and deploy AI agents",
   keywords: [
     "ai",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "struere",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Build, test, and deploy AI agents",
   "keywords": [
     "ai",