{"format":"fastapp.llm-catalog","catalogVersion":"1.0.0","generatedAt":"2026-07-15T05:40:14.069Z","routes":{"llmsTxt":"https://creator.fastapp.cloud/fastapp/public-docs/llms.txt","llmsFullTxt":"https://creator.fastapp.cloud/fastapp/public-docs/llms-full.txt","docsManifest":"https://creator.fastapp.cloud/fastapp/public-docs/manifest.json","llmCatalog":"https://creator.fastapp.cloud/fastapp/public-docs/catalog.json","apiLlmCatalog":"https://creator.fastapp.cloud/api/public-docs/catalog","mcp":"https://creator.fastapp.cloud/api/mcp","agentCatalog":"https://creator.fastapp.cloud/api/agent/catalog","agentExecute":"https://creator.fastapp.cloud/api/agent/execute"},"mcp":{"transport":"http-jsonrpc","endpoint":"https://creator.fastapp.cloud/api/mcp","protocolVersion":"2024-11-05","methods":["initialize","tools/list","tools/call"]},"docs":{"generatedAt":"2026-07-15T05:40:14.069Z","count":30,"documents":[{"id":"docs/api-parsers","source":"docs","sourceLabel":"docs/","sourcePath":"docs/api-parsers.md","routePath":"/fastapp/public-docs/page/docs/api-parsers","rawPath":"/fastapp/public-docs/raw/docs/api-parsers","slug":["docs","api-parsers"],"slugPath":"docs/api-parsers","title":"API Parsers e Exportacao","description":"As APIs dinamicas do FastApp suportam dois fluxos parecidos, mas com usos diferentes:","headings":["API Parsers e Exportacao","Parsers Inline","Exportacao De Arquivos","Escopos","Configuracao Por Objeto","UI","Limites"],"wordCount":320},{"id":"docs/backlog-agent","source":"docs","sourceLabel":"docs/","sourcePath":"docs/backlog-agent.md","routePath":"/fastapp/public-docs/page/docs/backlog-agent","rawPath":"/fastapp/public-docs/raw/docs/backlog-agent","slug":["docs","backlog-agent"],"slugPath":"docs/backlog-agent","title":"Autonomous Task Board worker","description":"The local worker polls Task Board, but only acquires cards explicitly moved to AGENT READY. The server control endpoint performs the lease operation in a Firestore transaction. The worker fails closed when that endpoint or its token is u...","headings":["Autonomous Task Board worker","Setup","Release adapter contract"],"wordCount":250},{"id":"docs/export-data/context","source":"docs","sourceLabel":"docs/","sourcePath":"docs/export-data/CONTEXT.md","routePath":"/fastapp/public-docs/page/docs/export-data/context","rawPath":"/fastapp/public-docs/raw/docs/export-data/context","slug":["docs","export-data","context"],"slugPath":"docs/export-data/context","title":"Contexto Exportacao de Dados","description":"Missao: adicionar exportacao/download de dados nas abas e views do FastApp que mostram registros de objetos. A feature deve respeitar o modelo do produto: apps sao definidos por JSON, objetos sao modulares e o runtime dinamico deve ofere...","headings":["Contexto Exportacao de Dados","Overview","Decisoes Tomadas","Evidencias Lidas","Estado das Tasks","Fase 0","Sprint feat/export data","Proximo Passo","Prompt de Continuacao"],"wordCount":1384},{"id":"docs/export-data/spec","source":"docs","sourceLabel":"docs/","sourcePath":"docs/export-data/SPEC.md","routePath":"/fastapp/public-docs/page/docs/export-data/spec","rawPath":"/fastapp/public-docs/raw/docs/export-data/spec","slug":["docs","export-data","spec"],"slugPath":"docs/export-data/spec","title":"Exportacao de Dados Spec Final","description":"Status: Sprint implementada na branch feat/export data.","headings":["Exportacao de Dados Spec Final","1. Evidencias Lidas no Repositorio","2. Como Esta Feature Deve Seguir o Modelo FastApp","3. Objetivo","4. Fora de Escopo Inicial","5. Estado Atual","6. UX Proposta","7. Contrato de API Proposto","8. Modelagem em App JSON","9. Permissionamento e Seguranca","10. Sprint feat/export data","Task 1 Contexto e planejamento SDD Concluida","Task 2 Contrato server side de exportacao Concluida","Task 3 Serializadores CSV/XLSX/PDF/JSON Concluida","Task 4 UI universal no CoreDynamicCRUD Concluida","Task 5 Escopos de exportacao Concluida","Task 6 Cobertura em CMS e views especiais Concluida","Task 7 Testes e regressao Concluida","Task 8 Documentacao final e handoff Concluida apos commit desta task","11. Decisoes Fechadas e Riscos Restantes","12. Handoff"],"wordCount":1117},{"id":"docs/fastapp-agent-project-bootstrap","source":"docs","sourceLabel":"docs/","sourcePath":"docs/FASTAPP_AGENT_PROJECT_BOOTSTRAP.md","routePath":"/fastapp/public-docs/page/docs/fastapp-agent-project-bootstrap","rawPath":"/fastapp/public-docs/raw/docs/fastapp-agent-project-bootstrap","slug":["docs","fastapp-agent-project-bootstrap"],"slugPath":"docs/fastapp-agent-project-bootstrap","title":"FastApp Agent Project Bootstrap","description":"This document defines the first structured LLM/MCP ready agent surface for FastApp.","headings":["FastApp Agent Project Bootstrap","Goal","Why This Layer Exists","First Agent","Routes","MCP Transport","Tool Model","Tool Families","Dry Run Support","Current Orchestration Status","Suggested Next Steps"],"wordCount":622},{"id":"docs/jean/contexto","source":"docs","sourceLabel":"docs/","sourcePath":"docs/jean/CONTEXTO.md","routePath":"/fastapp/public-docs/page/docs/jean/contexto","rawPath":"/fastapp/public-docs/raw/docs/jean/contexto","slug":["docs","jean","contexto"],"slugPath":"docs/jean/contexto","title":"Contexto de Trabalho Jean / FastApp","description":"Este documento registra o modo generico de trabalho no projeto FastApp. Ele deve servir para qualquer sprint, sem depender de uma feature especifica.","headings":["Contexto de Trabalho Jean / FastApp","Principios","Fluxo de Sprint","Task Board","Comunicados","Commits","Como a IA Deve Agir","Arquivos Para Entender a FastApp","Task 1 Como Fonte De Contexto"],"wordCount":617},{"id":"repo/agent-architecture","source":"repo","sourceLabel":"repository root","sourcePath":"AGENT_ARCHITECTURE.md","routePath":"/fastapp/public-docs/page/repo/agent-architecture","rawPath":"/fastapp/public-docs/raw/repo/agent-architecture","slug":["repo","agent-architecture"],"slugPath":"repo/agent-architecture","title":"🤖 FastApp Agent — Arquitetura e Guia Técnico","description":"Visão: O FastApp Agent não é apenas um chatbot. É uma camada de inteligência que lê, entende e modifica a própria estrutura de um app em tempo real — com parsing de linguagem natural, execução de APIs e feedback visual imediato.","headings":["🤖 FastApp Agent — Arquitetura e Guia Técnico","1. Os Dois Agentes Atuais","2. Arquitetura Geral","3. Contexto: O que o Agente Recebe","3.1 System Prompt (composto dinamicamente)","3.2 Escopos de Contexto (scopedContext)","4. Formatos de Output do LLM","4.1 AGENT DELTA (Schema Mutations)","AGENT DELTA","4.2 DATA ACTION (Execução de APIs)","4.3 SUGGESTION (Próximos Passos)","5. Parser: Como Funciona o parseDeltaBlocks()","Limpeza de JSON (cleanJson)","6. Merging Engine (useFastappArchitect)","Schema Sanitizer (validateAndSanitizeSchema)","7. Agent Presets System","8. Input Multimodal","Voz (Whisper STT)","Imagem (Vision)","9. Fluxo Completo de uma Interação","10. O que Funciona Bem Hoje","10.1 Estado Atual da Inteligencia AI","11. Gaps Atuais e Melhorias Propostas","🔴 Crítico"],"wordCount":1639},{"id":"repo/antigravity-guidelines","source":"repo","sourceLabel":"repository root","sourcePath":"ANTIGRAVITY_GUIDELINES.md","routePath":"/fastapp/public-docs/page/repo/antigravity-guidelines","rawPath":"/fastapp/public-docs/raw/repo/antigravity-guidelines","slug":["repo","antigravity-guidelines"],"slugPath":"repo/antigravity-guidelines","title":"🛰️ ANTIGRAVITY GUIDELINES — As Leis da Abstração Soberana (v3.1)","description":"\"Se algo é repetitivo, deve ser abstraído; se é específico, deve ser generalizado. Se é generalizável, o motor deve fazê lo sozinho.\"","headings":["🛰️ ANTIGRAVITY GUIDELINES — As Leis da Abstração Soberana (v3.1)","1. O Princípio da Generalização Soberana","2. Camadas de Core (A Escada de Abstração)","3. Orquestração de Dados (DataSources)","4. Protocolo FADAP 3.0 (Sovereign Sync & DDL)","11. Defensive Dynamic Rendering (L1/L2)","12. Metadata Integrity & Recovery","5. Alinhamento Laravel (Identity & RBAC)","6. Atributos de Comportamento (Ontologia v3)","7. AI Mutation Guard & Fetch Rule","8. Arquitetura de Performance (Architect Sync)","9. UX Singleton Pattern (The Designer Hub)","10. Taxonomy Driven GUI (Semantic Layer)"],"wordCount":1176},{"id":"repo/app-hierarchy","source":"repo","sourceLabel":"repository root","sourcePath":"APP_HIERARCHY.md","routePath":"/fastapp/public-docs/page/repo/app-hierarchy","rawPath":"/fastapp/public-docs/raw/repo/app-hierarchy","slug":["repo","app-hierarchy"],"slugPath":"repo/app-hierarchy","title":"🏛️ APP HIERARCHY — A Pirâmide de Metadados","description":"Este guia detalha a anatomia rigorosa de uma \"Aplicação\" no Fastapp Engine. A estrutura de metadados é o DNA que permite ao motor renderizar interfaces dinâmicas com inteligência.","headings":["🏛️ APP HIERARCHY — A Pirâmide de Metadados","🏛️ A Pirâmide de Abstração","📦 1. App (App)","🧱 2. Objeto (SystemObject)","🏷️ 3. Propriedades (Property)","📄 4. Páginas (Page)","🔗 Relacionamentos (Relation)","Estratégias de Persistência"],"wordCount":449},{"id":"repo/architecture","source":"repo","sourceLabel":"repository root","sourcePath":"ARCHITECTURE.md","routePath":"/fastapp/public-docs/page/repo/architecture","rawPath":"/fastapp/public-docs/raw/repo/architecture","slug":["repo","architecture"],"slugPath":"repo/architecture","title":"🏛️ Fastapp Engine — Arquitetura","description":"Documento vivo. Atualizado para refletir o motor Anti Gravity e a Sovereign Navigation Architecture .","headings":["🏛️ Fastapp Engine — Arquitetura","Visão Geral","📚 Dimensões de Documentação","Stack","Hierarquia: App → Module → Object → Property","Taxonomia Semântica de Objetos","1. Categoria Semântica (object.category)","2. Natureza Arquitetural (object.nature)","3. Relacionamentos (object.relations[])","Matriz Category × Nature","Exemplo Concreto: App Gestão de Ativos","Meta API & Gestão de Sistema","1. Snapshot (POST /api/system/snapshot)","2. Schema Evolution (PATCH /api/app/:id)","3. Storage Adaptation (POST /api/data/:object/storage) [Planejado]","4. Admin Portal (Ferramentas de Gestão)","5. Custom Pages & Dynamic Routing","Fluxo de Runtime — Onde vive a inteligência","API Dinâmica v1","Endpoints","Estratégia Híbrida: Native vs Generic","Validação Meta Driven","Filtragem & Ordenação (URL Driven)","Sistema de Snapshot"],"wordCount":1294},{"id":"repo/auth-rbac-data-scope-plan","source":"repo","sourceLabel":"repository root","sourcePath":"AUTH_RBAC_DATA_SCOPE_PLAN.md","routePath":"/fastapp/public-docs/page/repo/auth-rbac-data-scope-plan","rawPath":"/fastapp/public-docs/raw/repo/auth-rbac-data-scope-plan","slug":["repo","auth-rbac-data-scope-plan"],"slugPath":"repo/auth-rbac-data-scope-plan","title":"Auth/RBAC por App Membership em /api/v1/data","description":"Atualizado em: 2026 02 27","headings":["Auth/RBAC por App Membership em /api/v1/data","Objetivo","Status Atual","Implementado","Ajuste de abilities","Plano Tecnico por Camadas","1) Frontend","2) Backend (Nuxt BFF)","3) Backend (Laravel API)","4) Schema","5) Dados","Criterios de Aceite","Validacao de Regressao","Observacoes"],"wordCount":518},{"id":"repo/cms-v2-roadmap","source":"repo","sourceLabel":"repository root","sourcePath":"CMS_V2_ROADMAP.md","routePath":"/fastapp/public-docs/page/repo/cms-v2-roadmap","rawPath":"/fastapp/public-docs/raw/repo/cms-v2-roadmap","slug":["repo","cms-v2-roadmap"],"slugPath":"repo/cms-v2-roadmap","title":"CMS V2 Implementacao Atual e Guia Tecnico","description":"Atualizado em: 2026 02 26","headings":["CMS V2 Implementacao Atual e Guia Tecnico","Objetivo","Escopo Entregue (Sprint 1 + 1.5)","Mapa de Arquivos (Implementacao CMS)","Contratos e utilitarios","Core CMS components","Integracao nas paginas","Validacao de API","Contrato de Dados (PageSchemaV2)","Exemplo de Pagina CMS V2","Fluxo de Runtime e Persistencia","Runtime em pagina custom","Payload salvo no localStorage","Binding com Objetos (Query Mapping)","Grid 12 Colunas + Rows (Sprint 1.5)","Pontos Fortes Atuais","Gaps para ficar \"CMS real\" (mais faceis agora)","Diferencial FastApp (Abstracao + IA)","Guia Rapido para Adicionar Novo Tipo de Secao","Checklist de Validacao","Conclusao"],"wordCount":980},{"id":"repo/component-architecture","source":"repo","sourceLabel":"repository root","sourcePath":"COMPONENT_ARCHITECTURE.md","routePath":"/fastapp/public-docs/page/repo/component-architecture","rawPath":"/fastapp/public-docs/raw/repo/component-architecture","slug":["repo","component-architecture"],"slugPath":"repo/component-architecture","title":"🏗️ Arquitetura de Componentes — Padrão Dinâmico vs Concreto","description":"A estrutura de componentes do Fastapp segue a Escada de Abstração definida em ANTIGRAVITY GUIDELINES.md. A divisão de pastas reflete a intenção de separação entre o motor universal e as necessidades específicas:","headings":["🏗️ Arquitetura de Componentes — Padrão Dinâmico vs Concreto","📚 Princípio: Abstração Soberana","✅ Componentes Dinâmicos em core/","1. DynamicList.vue ✅","2. DynamicCRUD.vue ✅ [EVOLVED]","3. DynamicForm.vue ✅","4. RelationList.vue ✅","5. DynamicTable.vue ✅","6. BiWidget.vue ✅ [NEW]","7. DynamicFilter.vue ✅ [EVOLVED]","🎯 Componentes Concretos em Subpastas","components/fastapp/PropertyListEditor.vue ✅","components/crm/Kanban.vue ✅","components/crm/LeadCard.vue ✅","🏗️ Padrão de Decisão","📋 Estrutura Proposta (Pós Refactor)","🔄 Padrão de Integração","Fluxo Correto","❌ Anti Patterns","❌ Evitar","❌ Evitar Duplicação","❌ Evitar Lógica Específica em Core","✅ Boas Práticas","1️⃣ Componente Genérico em Core"],"wordCount":732},{"id":"repo/comunicado-system","source":"repo","sourceLabel":"repository root","sourcePath":"COMUNICADO_SYSTEM.md","routePath":"/fastapp/public-docs/page/repo/comunicado-system","rawPath":"/fastapp/public-docs/raw/repo/comunicado-system","slug":["repo","comunicado-system"],"slugPath":"repo/comunicado-system","title":"📣 Sistema de Comunicados — Manual Tecnico","description":"Painel de configuracao de notificacoes/alertas baseado em eventos. E mail nesta primeira fase, WhatsApp (via WAHA) na proxima. Segue o padrao do Fastapp Engine: o painel e um Object em app.objects[].","headings":["📣 Sistema de Comunicados — Manual Tecnico","1. Conceito","2. Posicionamento Arquitetural","3. Definicao do Object comunicado config","Properties","Placeholders","4. Como instalar em um App","Opcao A — Script (recomendado)","Apenas no app task board:","Em todos os apps:","Opcao B — Manual via Schema Manager","5. Roadmap — Fases","Fase 1 — Painel (✓ entregue)","Fase 2 — Dispatcher + Email (✓ entregue)","Fase 3 — WhatsApp (✓ entregue)","Fase 4 — UI Refinada","6. Como funciona o gatilho (vista geral, fase 2)","7. Exemplo Completo (caso do usuario)"],"wordCount":759},{"id":"repo/data-taxonomy","source":"repo","sourceLabel":"repository root","sourcePath":"DATA_TAXONOMY.md","routePath":"/fastapp/public-docs/page/repo/data-taxonomy","rawPath":"/fastapp/public-docs/raw/repo/data-taxonomy","slug":["repo","data-taxonomy"],"slugPath":"repo/data-taxonomy","title":"🧬 DATA TAXONOMY — A Semântica do Dado","description":"Este documento define os eixos de classificação semântica que permitem ao motor Fastapp reagir de forma inteligente à natureza dos dados. No motor Anti Gravity, a semântica governa a infraestrutura. Atualizado para a Ontologia v3 .","headings":["🧬 DATA TAXONOMY — A Semântica do Dado","🏗️ Os 3 Eixos da Taxonomia Semântica","1. Categoria Semântica (object.category)","2. Natureza Arquitetural (object.nature)","3. Orquestração Logística e Roteirização (object.routing type) [NEW]","4. Origem da API (app. e object. )","🛰️ Tipologia de Recursos e Espaço","Tipos de Recurso (object.resource type)","Tipos Espaciais (property.spatial type)","🎨 Os 2 Novos Eixos da Ontologia v3","4. Semântica de Campo (property.semantic)","5. Topologia de Apresentação (module.topology)","⛓️ Restrições de Governança (object.geo constraint)","⛓️ Relacionamentos e Persistência (object.relations)","🏗️ Reação do Motor (Behaviors)","📈 6. Extensões Analíticas (Ontologia v3) [NEW]","Propriedades Analíticas (property)","Eixos de Análise (object)","🔗 Contribuição Dimensional (relation)"],"wordCount":883},{"id":"repo/docker-run","source":"repo","sourceLabel":"repository root","sourcePath":"DOCKER_RUN.md","routePath":"/fastapp/public-docs/page/repo/docker-run","rawPath":"/fastapp/public-docs/raw/repo/docker-run","slug":["repo","docker-run"],"slugPath":"repo/docker-run","title":"Docker Commands","description":"Run these commands from g:\\FastApp in PowerShell:","headings":["Docker Commands"],"wordCount":37},{"id":"repo/drag-drop-summary","source":"repo","sourceLabel":"repository root","sourcePath":"DRAG_DROP_SUMMARY.md","routePath":"/fastapp/public-docs/page/repo/drag-drop-summary","rawPath":"/fastapp/public-docs/raw/repo/drag-drop-summary","slug":["repo","drag-drop-summary"],"slugPath":"repo/drag-drop-summary","title":"Resumo de Implementação: Reordenação Nativa Drag & Drop","description":"Integração Vuedraggable : Componente , >=, <, <=, between."},"value":{}}}},"sort":{"type":"object","additionalProperties":true,"description":"Sort map, e.g. { sale_at_max: \"desc\" } or { total: -1 }."},"search":{"type":"string","description":"Global search text."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_apply_filters","arguments":{}}}},{"name":"ui_set_wizard_step","title":"Set Wizard Step","description":"Set the active step index for wizard-style forms.","readOnly":false,"api":{"method":"POST","path":"/api/ui/wizard/set-step"},"inputSchema":{"type":"object","required":["step"],"additionalProperties":false,"properties":{"step":{"type":"integer","description":"Zero-based step index to activate."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_set_wizard_step","arguments":{}}}},{"name":"ui_next_wizard_step","title":"Next Wizard Step","description":"Advance the active wizard form to the next step.","readOnly":false,"api":{"method":"POST","path":"/api/ui/wizard/next-step"},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_next_wizard_step","arguments":{}}}},{"name":"ui_prev_wizard_step","title":"Previous Wizard Step","description":"Move the active wizard form back to the previous step.","readOnly":false,"api":{"method":"POST","path":"/api/ui/wizard/prev-step"},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_prev_wizard_step","arguments":{}}}},{"name":"upsert_module","title":"Upsert Module","description":"Create or update one module inside an existing app.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","module"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"module":{"type":"object","additionalProperties":true,"properties":{"key":{"type":"string","description":"Module key."},"slug":{"type":"string","description":"Optional module slug."},"name":{"type":"string","description":"Human-readable module name."},"icon":{"type":"string","description":"Optional icon token."},"centralObject":{"type":"string","description":"Optional central object name."},"objects":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional object references array."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_module","arguments":{}}}},{"name":"delete_module","title":"Delete Module","description":"Delete one module from an app by module key.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","moduleKey"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"moduleKey":{"type":"string","description":"Module key."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"delete_module","arguments":{}}}},{"name":"upsert_object","title":"Upsert Object","description":"Create or update one object schema inside an app, with optional module assignment.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","object"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"moduleKey":{"type":"string","description":"Optional module key to attach the object to."},"object":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","description":"Object technical name."},"key":{"type":"string","description":"Optional object key alias."},"label":{"type":"string","description":"Human-readable object label."},"description":{"type":"string","description":"Optional object description."},"semantic":{"type":"string","description":"Object semantic classification."},"topology":{"type":"string","description":"Object topology classification."},"is_agent":{"type":"boolean","description":"Whether the object represents an agent actor."},"agent_metadata":{"type":"object","additionalProperties":true,"description":"Optional agent metadata payload."},"properties":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional full property list."},"relations":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional full relation list."},"actions":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional full action list."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_object","arguments":{}}}},{"name":"delete_object","title":"Delete Object","description":"Delete one object schema from an app and remove module references to it.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Technical object name."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"delete_object","arguments":{}}}},{"name":"upsert_property","title":"Upsert Property","description":"Create or update one property inside an object schema.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","property"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Technical object name."},"property":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","description":"Property technical name."},"label":{"type":"string","description":"Human-readable property label."},"type":{"type":"string","description":"Property data type."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_property","arguments":{}}}},{"name":"delete_property","title":"Delete Property","description":"Delete one property from an object schema.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","propertyName"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Technical object name."},"propertyName":{"type":"string","description":"Property technical name."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"delete_property","arguments":{}}}},{"name":"upsert_relation","title":"Upsert Relation","description":"Create or update one relation inside an object schema.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","relation"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Source object name."},"relation":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","description":"Relation technical name."},"target":{"type":"string","description":"Target object name."},"type":{"type":"string","description":"Relation type."},"foreign_key":{"type":"string","description":"Foreign key field name."},"storage":{"type":"string","description":"Relation storage strategy."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_relation","arguments":{}}}},{"name":"delete_relation","title":"Delete Relation","description":"Delete one relation from an object schema by target and optional type.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","targetObject"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Source object name."},"targetObject":{"type":"string","description":"Target object name."},"relationType":{"type":"string","description":"Optional relation type."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"delete_relation","arguments":{}}}},{"name":"upsert_view","title":"Upsert View","description":"Create or update one visualization (table/kanban/list/calendar/map/gallery) on an object. Every view type has field requirements: bind the required role to an existing property (e.g. kanban.group_by → a status enum field; calendar.start → a date field; map.location → a location field). Ensure the bound property exists (via upsert_property) before adding the view.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","view"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Technical object name the view belongs to."},"view":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","description":"Stable view id (auto-generated from type+label if omitted)."},"type":{"type":"string","description":"View type: 'table' | 'kanban' | 'list' | 'calendar' | 'map' | 'gallery'."},"label":{"type":"string","description":"Human-readable view label."},"icon":{"type":"string","description":"Optional icon token."},"is_default":{"type":"boolean","description":"Whether this view opens by default."},"bindings":{"type":"object","additionalProperties":true,"description":"Maps view roles to property names. Each view type has REQUIRED roles: kanban→group_by (enum/foreign_key field), calendar→start (date field), map→location (location field), gallery→image, list→title.","properties":{"group_by":{"type":"string","description":"Kanban: property used for columns (enum or foreign_key)."},"title":{"type":"string","description":"Primary label property."},"subtitle":{"type":"string","description":"Secondary label property."},"start":{"type":"string","description":"Calendar: start date/datetime property."},"end":{"type":"string","description":"Calendar: end date/datetime property."},"location":{"type":"string","description":"Map: location property."},"color":{"type":"string","description":"Accent color property."},"image":{"type":"string","description":"Gallery/list: image url property."},"columns":{"type":"array","items":{"type":"string"},"description":"Table: explicit column order (property names)."}}},"filters":{"type":"object","additionalProperties":true,"description":"Optional saved filter applied when the view is active."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_view","arguments":{}}}},{"name":"delete_view","title":"Delete View","description":"Delete one visualization from an object schema by view id.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","viewId"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Technical object name."},"viewId":{"type":"string","description":"View id to remove."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"delete_view","arguments":{}}}},{"name":"upsert_action","title":"Upsert Action","description":"Create or update one action inside an object schema.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","action"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Technical object name."},"action":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","description":"Action technical name."},"label":{"type":"string","description":"Human-readable action label."},"method":{"type":"string","description":"HTTP verb used by the action."},"endpoint":{"type":"string","description":"Action endpoint path."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_action","arguments":{}}}},{"name":"delete_action","title":"Delete Action","description":"Delete one action from an object schema.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","actionName"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Technical object name."},"actionName":{"type":"string","description":"Action technical name."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"delete_action","arguments":{}}}},{"name":"upsert_page","title":"Upsert Page","description":"Create or update one app page.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","page"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"page":{"type":"object","additionalProperties":true,"properties":{"slug":{"type":"string","description":"Page slug."},"name":{"type":"string","description":"Page name."},"label":{"type":"string","description":"Page label."},"type":{"type":"string","description":"Page type, usually cms."},"path":{"type":"string","description":"Optional page path."},"icon":{"type":"string","description":"Optional icon token."},"sections":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional CMS sections array."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_page","arguments":{}}}},{"name":"delete_page","title":"Delete Page","description":"Delete one app page by slug.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","pageSlug"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"pageSlug":{"type":"string","description":"Page slug."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"delete_page","arguments":{}}}},{"name":"list_roles","title":"List Roles","description":"List role records scoped to an app.","readOnly":true,"api":{"method":"GET","path":"/api/v1/data/{app}/role"},"inputSchema":{"type":"object","required":["app"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"query":{"type":"object","additionalProperties":true,"description":"Optional querystring payload forwarded to the underlying Nuxt route."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"list_roles","arguments":{}}}},{"name":"create_role","title":"Create Role","description":"Create a role row scoped to an app. Requires platform/admin access or explicit role-create permission.","readOnly":false,"api":{"method":"POST","path":"/api/v1/data/{app}/role"},"inputSchema":{"type":"object","required":["app","name"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"name":{"type":"string","description":"Role name."},"label":{"type":"string","description":"Human-readable role label."},"data":{"type":"object","additionalProperties":true}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"create_role","arguments":{}}}},{"name":"update_role","title":"Update Role","description":"Update an existing role row.","readOnly":false,"api":{"method":"PATCH","path":"/api/v1/data/{app}/role/{id}"},"inputSchema":{"type":"object","required":["app","id","data"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"id":{"type":"integer","description":"Role record id."},"data":{"type":"object","additionalProperties":true}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"update_role","arguments":{}}}},{"name":"delete_role","title":"Delete Role","description":"Delete an existing role row.","readOnly":false,"api":{"method":"DELETE","path":"/api/v1/data/{app}/role/{id}"},"inputSchema":{"type":"object","required":["app","id"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"id":{"type":"integer","description":"Role record id."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"delete_role","arguments":{}}}},{"name":"list_permissions","title":"List Permissions","description":"List permission rows scoped to an app.","readOnly":true,"api":{"method":"GET","path":"/api/v1/data/{app}/permission"},"inputSchema":{"type":"object","required":["app"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"query":{"type":"object","additionalProperties":true,"description":"Optional querystring payload forwarded to the underlying Nuxt route."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"list_permissions","arguments":{}}}},{"name":"create_permission","title":"Create Permission","description":"Create a permission row for an app, role, object, and action.","readOnly":false,"api":{"method":"POST","path":"/api/v1/data/{app}/permission"},"inputSchema":{"type":"object","required":["app"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"role":{"type":"string","description":"Role name."},"object":{"type":"string","description":"Target object name."},"targetObject":{"type":"string","description":"Alias for the target object name."},"action":{"type":"string","description":"Permission action."},"name":{"type":"string","description":"Optional explicit permission name."},"data":{"type":"object","additionalProperties":true}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"create_permission","arguments":{}}}},{"name":"update_permission","title":"Update Permission","description":"Update a permission row.","readOnly":false,"api":{"method":"PATCH","path":"/api/v1/data/{app}/permission/{id}"},"inputSchema":{"type":"object","required":["app","id","data"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"id":{"type":"integer","description":"Permission record id."},"data":{"type":"object","additionalProperties":true}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"update_permission","arguments":{}}}},{"name":"delete_permission","title":"Delete Permission","description":"Delete a permission row.","readOnly":false,"api":{"method":"DELETE","path":"/api/v1/data/{app}/permission/{id}"},"inputSchema":{"type":"object","required":["app","id"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"id":{"type":"integer","description":"Permission record id."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"delete_permission","arguments":{}}}},{"name":"list_memberships","title":"List Memberships","description":"List app membership rows from the user_app object.","readOnly":true,"api":{"method":"GET","path":"/api/v1/data/{app}/user_app"},"inputSchema":{"type":"object","required":["app"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"query":{"type":"object","additionalProperties":true,"description":"Optional querystring payload forwarded to the underlying Nuxt route."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"list_memberships","arguments":{}}}},{"name":"assign_membership","title":"Assign Membership","description":"Create one user_app membership row for a user and role.","readOnly":false,"api":{"method":"POST","path":"/api/v1/data/{app}/user_app"},"inputSchema":{"type":"object","required":["app","userId","role"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"userId":{"type":"integer","description":"User id."},"role":{"type":"string","description":"Role name."},"referenceObject":{"type":"string","description":"Optional constrained reference object."},"referenceId":{"type":"integer","description":"Optional constrained reference id."},"data":{"type":"object","additionalProperties":true}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"assign_membership","arguments":{}}}},{"name":"update_membership","title":"Update Membership","description":"Update one user_app membership row.","readOnly":false,"api":{"method":"PATCH","path":"/api/v1/data/{app}/user_app/{id}"},"inputSchema":{"type":"object","required":["app","id","data"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"id":{"type":"integer","description":"Membership record id."},"data":{"type":"object","additionalProperties":true}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"update_membership","arguments":{}}}},{"name":"remove_membership","title":"Remove Membership","description":"Delete one user_app membership row.","readOnly":false,"api":{"method":"DELETE","path":"/api/v1/data/{app}/user_app/{id}"},"inputSchema":{"type":"object","required":["app","id"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"id":{"type":"integer","description":"Membership record id."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"remove_membership","arguments":{}}}}]},{"id":"fastapp-wizard-agent","name":"FastApp App Wizard","description":"Guided conversational wizard that translates business problem descriptions into fully configured FastApp applications through a discovery-first, propose-then-build conversation.","status":"active","transport":"http","tags":["fastapp","wizard","onboarding","app-creation","guided","llm","mcp-ready"],"instructions":"You are the FastApp Wizard. Your job: read a business description and immediately build a rich, production-quality first-draft app — or extend/modify an existing one. Always overshoot on structure; the user will trim what they don't need.\n\n## IDENTITY\n- Always reply in the user's language (Portuguese if they write Portuguese, English if English).\n- Never expose: \"schema\", \"object\", \"property\", \"taxonomy\", \"slug\", \"entity\", \"CRUD\", \"FADAP\", \"provider\", \"physical\", \"embedded\", \"virtual\", \"transactional\", \"master\". Use \"seção\" (module), plain business names (item types), \"campo\" (property).\n- Say \"quadro\" not kanban. \"Mapa\" not map mode. \"Agenda\" not resource_schedule.\n- Tone: direct, confident, no filler, no apologies.\n\n---\n\n## WHEN TO ASK VS WHEN TO BUILD\n\n**Build immediately** (no questions) when the first message contains a recognizable business domain — a single word like \"floricultura\", \"imobiliária\", \"oficina\", \"clínica\" is enough. Infer the full domain structure.\n\n**Ask at most ONE round of 2 short questions** only when the domain is completely ambiguous (e.g. \"preciso de um app\" with zero context). After ONE answer — however brief — always build. Never ask a second round.\n\nNever ask for confirmation before building. Never present a plan and wait. Just announce and build.\n\n---\n\n## OVERSHOOT PRINCIPLE — CRITICAL\nAlways build MORE than the user described. Think like a domain expert who knows what a fully operational business needs. Use your training knowledge to enumerate the full set of objects a real operator would need — not just what the user mentioned.\n\nIf the user only mentions 2-3 things, still build the FULL domain picture. The user trims extras; missing objects slow the whole project.\n\n**Minimum quality bar:** Every app MUST have at least: 2 master objects (reference data), 1 transactional object (with quadro view), 1 embedded sub-object (line items), and at least 2 explicit FK relations. Fewer than this is insufficient.\n\n---\n\n## BUILD SEQUENCE (strict order)\n\n**Step 0 — App target:**\n- No context.app_slug, or app is empty (no modules): run full creation from Step 1.\n- context.app_slug set and app has structure: skip to Step 5, apply changes directly.\n- context.app_slug set but app is empty: skip Step 2 (app already exists), run from Step 1.\n\n**Step 1:** Call wizard_get_taxonomy_guide (silent) — get the classification rules.\n\n**Step 2:** Using your own knowledge of the {domain} business type, design the complete object set internally. Do not ask — you already know what a real business in this sector needs.\n\n**Step 3:** Call wizard_create_app_with_owner — name from domain, one-sentence description, ownerUserId = context.user_id. SKIP if context.app_slug already exists.\n\n**Step 4:** Announce in one line: \"Montando o app agora...\" — then execute Steps 5-9 without stopping.\n\n**Step 5:** upsert_module for each section. After each: \"✓ Seção [Name].\"\n\n**Step 6:** upsert_object for each item type with correct taxonomy (category, nature, ui_mode, crud_mode, is_agent). After each: \"✓ [Name].\"\n\n**Step 7:** upsert_property for each field — all fields per object in sequence without pausing. Use domain example field definitions. After all fields of an object: \"✓ [N] campos para [Name].\"\n- FK fields (e.g. cliente_id) MUST be type: integer\n- Status enums MUST use domain-appropriate Portuguese stage names from the domain example (not generic New/In Progress/Done)\n- Always include: status for transactional objects, valor for financial objects, telefone+email for contact objects\n\n**Step 8 — Visualizations (quadro/agenda/mapa/galeria):** For every object that benefits from a non-table visualization, call upsert_view AFTER its fields exist. A view is generic: it binds a ROLE to one of the object's fields. Respect each view's field requirement:\n- \"quadro\" (kanban): `{ type: 'kanban', label: 'Quadro', is_default: true, bindings: { group_by: '', title: '
' } }` — REQUIRES an enum/foreign_key field to group by. If none exists, create the status field first (Step 7).\n- \"agenda\" (calendar): `{ type: 'calendar', label: 'Agenda', bindings: { start: '', end: '', title: '' } }` — REQUIRES a date/datetime field.\n- \"mapa\" (map): `{ type: 'map', label: 'Mapa', bindings: { location: '', title: '' } }` — REQUIRES a field of type location.\n- \"galeria\" (gallery): `{ type: 'gallery', bindings: { image: '', title: '' } }` — REQUIRES an image field.\nSet the most useful view as is_default. Table is always implicitly available — do not create it explicitly. NEVER bind a role to a field that doesn't exist or whose type doesn't match.\n\n**Step 8b:** DO NOT call upsert_relation in this pass. Relations are handled automatically by the system in a dedicated second pass. Your job here is ONLY objects, properties, modules, views, and pages — do not output any upsert_relation calls.\n\n**Step 9:** upsert_page for each item type (auto list page).\n\n**Step 10:** If roles mentioned: create_role for each, then assign_membership.\n\n**Done:** Short summary (N seções, N tipos, N campos). Say: \"Estrutura criada! As ligações entre os tipos serão verificadas automaticamente.\"\n\n---\n\n## TAXONOMY (internal — never expose)\n- Stable reference data (clients, products, suppliers) → category: master, nature: physical\n- Event/flow records (orders, tickets, tasks) → category: transactional, nature: physical\n- Sub-items inside a parent (order lines, checklist items) → nature: embedded\n- Has status/stage field → add a kanban view (upsert_view, bindings.group_by = the status field)\n- Has location/address field → add a map view (upsert_view, bindings.location = the location field)\n- Scheduling/appointments → add a calendar view (upsert_view, bindings.start = the date field)\n- Represents a human role → is_agent: true, agent_metadata.role = role name\n- ≤8 fields → crud_mode: modal; 8–15 → crud_mode: sidebar; more → crud_mode: page\n\n## STANDARD FIELDS (apply silently — no asking)\n- Any entity with stages → status (enum, domain-specific options)\n- Any entity with ownership → responsavel (string)\n- Any entity with a deadline → data_entrega (date)\n- Any entity with money → valor (number, semantic: money)\n- People/contacts → email (semantic: email), telefone (semantic: phone)\n\n## EDITING AN EXISTING APP\nWhen context.app_slug is set and the app has structure, interpret user message as a change:\n- New section → upsert_module\n- New item type → upsert_object + upsert_page\n- New/changed fields → upsert_property\n- New relation → upsert_relation\n- New/changed visualization (\"quadro\", \"agenda\", \"mapa\", \"galeria\") → upsert_view with the correct bindings (create the required field first if missing)\n- New role/access → create_role + assign_membership\nAct immediately. No discovery phase. Confirm each change in one sentence.\n\n## ERROR HANDLING\nIf a tool call fails, say plainly what failed and ask to retry or skip. Never swallow errors.","tools":[{"name":"wizard_get_templates","title":"Get App Templates","description":"Return available app templates with descriptions and example use cases. Use this to suggest a starting point based on the user's business description.","readOnly":true,"api":{"method":"GET","path":"/api/wizard/templates"},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"examples":[],"mcp":{"method":"tools/call","params":{"name":"wizard_get_templates","arguments":{}}}},{"name":"wizard_get_taxonomy_guide","title":"Get Taxonomy Guide","description":"Return the FastApp taxonomy classification rules. Call this before creating objects to correctly classify each entity's category, nature, view mode, and actor designation.","readOnly":true,"api":{"method":"GET","path":"/api/wizard/taxonomy-guide"},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"examples":[],"mcp":{"method":"tools/call","params":{"name":"wizard_get_taxonomy_guide","arguments":{}}}},{"name":"wizard_create_app_with_owner","title":"Create App with Owner","description":"Create a new app and immediately assign the owner user as admin. Use this instead of create_app to ensure the creator has admin access from the start.","readOnly":false,"api":{"method":"POST","path":"/api/app"},"inputSchema":{"type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"type":"string","description":"Human-readable app name."},"slug":{"type":"string","description":"URL-safe slug. Inferred from name when omitted."},"description":{"type":"string","description":"One-sentence app purpose."},"icon":{"type":"string","description":"Optional icon token, e.g. pi pi-box."},"ownerUserId":{"type":"integer","description":"User ID to assign as admin. Pass context.user_id here when available."}}},"examples":[{"title":"Create a CRM app for the current user","input":{"name":"CRM Comercial","description":"Gestão de leads e oportunidades comerciais.","ownerUserId":1}}],"mcp":{"method":"tools/call","params":{"name":"wizard_create_app_with_owner","arguments":{}}}},{"name":"upsert_module","title":"Upsert Module","description":"Create or update one module inside an existing app.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","module"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"module":{"type":"object","additionalProperties":true,"properties":{"key":{"type":"string","description":"Module key."},"slug":{"type":"string","description":"Optional module slug."},"name":{"type":"string","description":"Human-readable module name."},"icon":{"type":"string","description":"Optional icon token."},"centralObject":{"type":"string","description":"Optional central object name."},"objects":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional object references array."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_module","arguments":{}}}},{"name":"upsert_object","title":"Upsert Object","description":"Create or update one object schema inside an app, with optional module assignment.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","object"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"moduleKey":{"type":"string","description":"Optional module key to attach the object to."},"object":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","description":"Object technical name."},"key":{"type":"string","description":"Optional object key alias."},"label":{"type":"string","description":"Human-readable object label."},"description":{"type":"string","description":"Optional object description."},"semantic":{"type":"string","description":"Object semantic classification."},"topology":{"type":"string","description":"Object topology classification."},"is_agent":{"type":"boolean","description":"Whether the object represents an agent actor."},"agent_metadata":{"type":"object","additionalProperties":true,"description":"Optional agent metadata payload."},"properties":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional full property list."},"relations":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional full relation list."},"actions":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional full action list."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_object","arguments":{}}}},{"name":"upsert_property","title":"Upsert Property","description":"Create or update one property inside an object schema.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","property"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Technical object name."},"property":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","description":"Property technical name."},"label":{"type":"string","description":"Human-readable property label."},"type":{"type":"string","description":"Property data type."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_property","arguments":{}}}},{"name":"upsert_relation","title":"Upsert Relation","description":"Create or update one relation inside an object schema.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","relation"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Source object name."},"relation":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","description":"Relation technical name."},"target":{"type":"string","description":"Target object name."},"type":{"type":"string","description":"Relation type."},"foreign_key":{"type":"string","description":"Foreign key field name."},"storage":{"type":"string","description":"Relation storage strategy."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_relation","arguments":{}}}},{"name":"upsert_view","title":"Upsert View","description":"Create or update one visualization (table/kanban/list/calendar/map/gallery) on an object. Every view type has field requirements: bind the required role to an existing property (e.g. kanban.group_by → a status enum field; calendar.start → a date field; map.location → a location field). Ensure the bound property exists (via upsert_property) before adding the view.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","view"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Technical object name the view belongs to."},"view":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","description":"Stable view id (auto-generated from type+label if omitted)."},"type":{"type":"string","description":"View type: 'table' | 'kanban' | 'list' | 'calendar' | 'map' | 'gallery'."},"label":{"type":"string","description":"Human-readable view label."},"icon":{"type":"string","description":"Optional icon token."},"is_default":{"type":"boolean","description":"Whether this view opens by default."},"bindings":{"type":"object","additionalProperties":true,"description":"Maps view roles to property names. Each view type has REQUIRED roles: kanban→group_by (enum/foreign_key field), calendar→start (date field), map→location (location field), gallery→image, list→title.","properties":{"group_by":{"type":"string","description":"Kanban: property used for columns (enum or foreign_key)."},"title":{"type":"string","description":"Primary label property."},"subtitle":{"type":"string","description":"Secondary label property."},"start":{"type":"string","description":"Calendar: start date/datetime property."},"end":{"type":"string","description":"Calendar: end date/datetime property."},"location":{"type":"string","description":"Map: location property."},"color":{"type":"string","description":"Accent color property."},"image":{"type":"string","description":"Gallery/list: image url property."},"columns":{"type":"array","items":{"type":"string"},"description":"Table: explicit column order (property names)."}}},"filters":{"type":"object","additionalProperties":true,"description":"Optional saved filter applied when the view is active."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_view","arguments":{}}}},{"name":"upsert_action","title":"Upsert Action","description":"Create or update one action inside an object schema.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","objectName","action"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"objectName":{"type":"string","description":"Technical object name."},"action":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","description":"Action technical name."},"label":{"type":"string","description":"Human-readable action label."},"method":{"type":"string","description":"HTTP verb used by the action."},"endpoint":{"type":"string","description":"Action endpoint path."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_action","arguments":{}}}},{"name":"upsert_page","title":"Upsert Page","description":"Create or update one app page.","readOnly":false,"api":{"method":"PATCH","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["appId","page"],"additionalProperties":false,"properties":{"appId":{"type":"integer","description":"Numeric app id."},"page":{"type":"object","additionalProperties":true,"properties":{"slug":{"type":"string","description":"Page slug."},"name":{"type":"string","description":"Page name."},"label":{"type":"string","description":"Page label."},"type":{"type":"string","description":"Page type, usually cms."},"path":{"type":"string","description":"Optional page path."},"icon":{"type":"string","description":"Optional icon token."},"sections":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional CMS sections array."}}}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"upsert_page","arguments":{}}}},{"name":"list_roles","title":"List Roles","description":"List role records scoped to an app.","readOnly":true,"api":{"method":"GET","path":"/api/v1/data/{app}/role"},"inputSchema":{"type":"object","required":["app"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"query":{"type":"object","additionalProperties":true,"description":"Optional querystring payload forwarded to the underlying Nuxt route."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"list_roles","arguments":{}}}},{"name":"create_role","title":"Create Role","description":"Create a role row scoped to an app. Requires platform/admin access or explicit role-create permission.","readOnly":false,"api":{"method":"POST","path":"/api/v1/data/{app}/role"},"inputSchema":{"type":"object","required":["app","name"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"name":{"type":"string","description":"Role name."},"label":{"type":"string","description":"Human-readable role label."},"data":{"type":"object","additionalProperties":true}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"create_role","arguments":{}}}},{"name":"update_role","title":"Update Role","description":"Update an existing role row.","readOnly":false,"api":{"method":"PATCH","path":"/api/v1/data/{app}/role/{id}"},"inputSchema":{"type":"object","required":["app","id","data"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"id":{"type":"integer","description":"Role record id."},"data":{"type":"object","additionalProperties":true}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"update_role","arguments":{}}}},{"name":"list_permissions","title":"List Permissions","description":"List permission rows scoped to an app.","readOnly":true,"api":{"method":"GET","path":"/api/v1/data/{app}/permission"},"inputSchema":{"type":"object","required":["app"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"query":{"type":"object","additionalProperties":true,"description":"Optional querystring payload forwarded to the underlying Nuxt route."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"list_permissions","arguments":{}}}},{"name":"create_permission","title":"Create Permission","description":"Create a permission row for an app, role, object, and action.","readOnly":false,"api":{"method":"POST","path":"/api/v1/data/{app}/permission"},"inputSchema":{"type":"object","required":["app"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"role":{"type":"string","description":"Role name."},"object":{"type":"string","description":"Target object name."},"targetObject":{"type":"string","description":"Alias for the target object name."},"action":{"type":"string","description":"Permission action."},"name":{"type":"string","description":"Optional explicit permission name."},"data":{"type":"object","additionalProperties":true}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"create_permission","arguments":{}}}},{"name":"list_memberships","title":"List Memberships","description":"List app membership rows from the user_app object.","readOnly":true,"api":{"method":"GET","path":"/api/v1/data/{app}/user_app"},"inputSchema":{"type":"object","required":["app"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"query":{"type":"object","additionalProperties":true,"description":"Optional querystring payload forwarded to the underlying Nuxt route."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"list_memberships","arguments":{}}}},{"name":"assign_membership","title":"Assign Membership","description":"Create one user_app membership row for a user and role.","readOnly":false,"api":{"method":"POST","path":"/api/v1/data/{app}/user_app"},"inputSchema":{"type":"object","required":["app","userId","role"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"userId":{"type":"integer","description":"User id."},"role":{"type":"string","description":"Role name."},"referenceObject":{"type":"string","description":"Optional constrained reference object."},"referenceId":{"type":"integer","description":"Optional constrained reference id."},"data":{"type":"object","additionalProperties":true}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"assign_membership","arguments":{}}}},{"name":"list_apps","title":"List Apps","description":"List all apps visible through the Nuxt app catalog.","readOnly":true,"api":{"method":"GET","path":"/api/app"},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"examples":[],"mcp":{"method":"tools/call","params":{"name":"list_apps","arguments":{}}}},{"name":"get_app","title":"Get App","description":"Load one app by numeric id.","readOnly":true,"api":{"method":"GET","path":"/api/app/{id}"},"inputSchema":{"type":"object","required":["id"],"additionalProperties":false,"properties":{"id":{"type":"integer","description":"Numeric app id."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"get_app","arguments":{}}}},{"name":"ui_navigate","title":"Navigate UI","description":"Trigger a navigation to a specific path in the application (e.g. object list, dashboard, page).","readOnly":true,"api":{"method":"POST","path":"/api/ui/navigate"},"inputSchema":{"type":"object","required":["path"],"additionalProperties":false,"properties":{"path":{"type":"string","description":"Target application path."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_navigate","arguments":{}}}},{"name":"ui_set_wizard_step","title":"Set Wizard Step","description":"Set the active step index for wizard-style forms.","readOnly":false,"api":{"method":"POST","path":"/api/ui/wizard/set-step"},"inputSchema":{"type":"object","required":["step"],"additionalProperties":false,"properties":{"step":{"type":"integer","description":"Zero-based step index to activate."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_set_wizard_step","arguments":{}}}},{"name":"ui_next_wizard_step","title":"Next Wizard Step","description":"Advance the active wizard form to the next step.","readOnly":false,"api":{"method":"POST","path":"/api/ui/wizard/next-step"},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_next_wizard_step","arguments":{}}}}]},{"id":"cs-buddy","name":"CS Buddy","description":"Customer Success Specialist","status":"active","transport":"http","tags":["dynamic","app"],"instructions":"Você é um especialista em Customer Success. Ajude o usuário a gerenciar seus clientes e leads com empatia e precisão.","tools":[{"name":"list_records","title":"List Records","description":"List records from a generic app object using the existing /api/v1/data route.","readOnly":true,"api":{"method":"GET","path":"/api/v1/data/{app}/{object}"},"inputSchema":{"type":"object","required":["app","object"],"additionalProperties":false,"properties":{"app":{"type":"string","description":"App route segment, usually slug or id string."},"object":{"type":"string","description":"Technical object name."},"query":{"type":"object","additionalProperties":true,"description":"Optional querystring payload forwarded to the Nuxt data API."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"list_records","arguments":{}}}},{"name":"ui_update_fields","title":"Update UI Fields","description":"Update the fields of the currently active form in the user interface. Use this to fill forms, change addresses, or update record data live.","readOnly":false,"api":{"method":"POST","path":"/api/ui/update-fields"},"inputSchema":{"type":"object","required":["fields"],"additionalProperties":false,"properties":{"fields":{"type":"object","additionalProperties":true,"description":"KV map of field names and their new values."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_update_fields","arguments":{}}}},{"name":"ui_navigate","title":"Navigate UI","description":"Trigger a navigation to a specific path in the application (e.g. object list, dashboard, page).","readOnly":true,"api":{"method":"POST","path":"/api/ui/navigate"},"inputSchema":{"type":"object","required":["path"],"additionalProperties":false,"properties":{"path":{"type":"string","description":"Target application path."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_navigate","arguments":{}}}},{"name":"ui_apply_filters","title":"Apply UI Filters","description":"Apply generic filters, search, and sorting to the active object list/table UI by updating the frontend query state. Use after list_records when the user is on a frontend data surface and expects the table/list to reflect the same filtered result.","readOnly":true,"api":{"method":"POST","path":"/api/ui/apply-filters"},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"app":{"type":"string","description":"Optional app slug for navigation when the target object is not the active object."},"module":{"type":"string","description":"Optional module slug for navigation."},"object":{"type":"string","description":"Optional target object technical name."},"path":{"type":"string","description":"Optional target path. If omitted, the active route is used."},"mode":{"type":"string","enum":["replace","merge"],"description":"replace clears existing filters/sort; merge keeps existing query keys."},"query":{"type":"object","additionalProperties":true,"description":"Query payload accepted by generic data views, e.g. filters[field][operator], field[operator], field=value, q, or $sort[field]."},"filters":{"type":"array","description":"Structured filters to apply.","items":{"type":"object","required":["field","value"],"additionalProperties":false,"properties":{"field":{"type":"string"},"operator":{"type":"string","description":"Generic operator such as =, $like, contains, in, >, >=, <, <=, between."},"value":{}}}},"sort":{"type":"object","additionalProperties":true,"description":"Sort map, e.g. { sale_at_max: \"desc\" } or { total: -1 }."},"search":{"type":"string","description":"Global search text."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_apply_filters","arguments":{}}}},{"name":"ui_set_wizard_step","title":"Set Wizard Step","description":"Set the active step index for wizard-style forms.","readOnly":false,"api":{"method":"POST","path":"/api/ui/wizard/set-step"},"inputSchema":{"type":"object","required":["step"],"additionalProperties":false,"properties":{"step":{"type":"integer","description":"Zero-based step index to activate."}}},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_set_wizard_step","arguments":{}}}},{"name":"ui_next_wizard_step","title":"Next Wizard Step","description":"Advance the active wizard form to the next step.","readOnly":false,"api":{"method":"POST","path":"/api/ui/wizard/next-step"},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_next_wizard_step","arguments":{}}}},{"name":"ui_prev_wizard_step","title":"Previous Wizard Step","description":"Move the active wizard form back to the previous step.","readOnly":false,"api":{"method":"POST","path":"/api/ui/wizard/prev-step"},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"examples":[],"mcp":{"method":"tools/call","params":{"name":"ui_prev_wizard_step","arguments":{}}}}]}],"validation":{"valid":true,"errors":[],"warnings":[]}}