strapi-plugin-mcp-chat 0.1.0 → 0.3.1

package/admin/src/pages/ProvisionPage.tsx

@@ -2,6 +2,9 @@ import { useRef, useState, useEffect } from 'react';
 import { Box, Flex, Typography, Button, Loader, Textarea } from '@strapi/design-system';
 import { useFetchClient } from '@strapi/strapi/admin';
 import { Link } from 'react-router-dom';
+import { useLang, makeT } from '../i18n';
+import { LangSwitcher } from '../components/LangSwitcher';
+import { StackLogos } from '../components/StackLogos';
 
 /**
  * Provisão de frontend em duas etapas (cenário Figma/Lovable, sem manifest):
@@ -41,6 +44,8 @@ const POLL_TIMEOUT_MS = 120000;
 const ProvisionPage = () => {
   const { post, get } = useFetchClient();
   const inputRef = useRef<HTMLInputElement | null>(null);
+  const [lang] = useLang();
+  const t = makeT(lang);
 
   const [file, setFile] = useState<File | null>(null);
   const [phase, setPhase] = useState<Phase>('idle');
@@ -96,11 +101,11 @@ const ProvisionPage = () => {
       setFilesAnalyzed(res.filesAnalyzed || []);
       setManifestText(res.manifest ? JSON.stringify(res.manifest, null, 2) : '');
       if (!res.ok && res.errors?.length) {
-        setError(`Aviso da análise:\n• ${res.errors.join('\n• ')}`);
+        setError(`${t('prov.analyzeWarn')}\n• ${res.errors.join('\n• ')}`);
       }
       setPhase('review');
     } catch (e: any) {
-      setError(errDetail(e, 'Falha ao analisar o projeto.'));
+      setError(errDetail(e, t('prov.analyzeFail')));
       setPhase('error');
     }
   };
@@ -111,7 +116,7 @@ const ProvisionPage = () => {
     try {
       manifest = JSON.parse(manifestText);
     } catch {
-      setError('O manifest não é um JSON válido. Corrija a sintaxe.');
+      setError(t('prov.invalidJson'));
       return;
     }
     setError(null);
@@ -126,7 +131,7 @@ const ProvisionPage = () => {
         setPhase('done-noreload');
       }
     } catch (e: any) {
-      setError(errDetail(e, 'Falha na provisão.'));
+      setError(errDetail(e, t('prov.provisionFail')));
       setPhase('error');
     }
   };
@@ -135,7 +140,7 @@ const ProvisionPage = () => {
     const startedAt = Date.now();
     while (!stopRef.current) {
       if (Date.now() - startedAt > POLL_TIMEOUT_MS) {
-        setError('A provisão demorou mais que o esperado. Verifique o terminal da Strapi.');
+        setError(t('prov.provisionFail'));
         setPhase('error');
         return;
       }
@@ -160,17 +165,12 @@ const ProvisionPage = () => {
     try {
       const { data } = await post('/mcp-chat/frontend/integrate', {});
       if (data.ok) {
-        setIntegrateMsg(
-          `✅ Religado! Arquivos atualizados: ${data.filesRewritten.join(', ')}. ` +
-          `Recarregue o preview para ver os dados do Strapi. (Original salvo como .bak.)`
-        );
+        setIntegrateMsg(t('prov.relinkOk', { files: data.filesRewritten.join(', ') }));
       } else {
-        setIntegrateMsg(
-          `⚠️ Não consegui religar: ${(data.errors || []).join('; ') || 'sem arquivo de dados'}.`
-        );
+        setIntegrateMsg(t('prov.relinkFail', { err: (data.errors || []).join('; ') || t('prov.noData') }));
       }
     } catch (e: any) {
-      setIntegrateMsg(`⚠️ ${errDetail(e, 'Falha ao religar.')}`);
+      setIntegrateMsg(`⚠️ ${errDetail(e, t('prov.relinkErr'))}`);
     } finally {
       setIntegrating(false);
     }
@@ -194,15 +194,15 @@ const ProvisionPage = () => {
     <Box padding={6} background="neutral100" style={{ minHeight: '100vh' }}>
       <Flex justifyContent="space-between" alignItems="center" paddingBottom={4}>
         <Box>
-          <Typography variant="alpha" tag="h1">Provisionar frontend</Typography>
-          <Typography variant="pi" textColor="neutral600">
-            Suba o .zip do seu frontend (Figma/Lovable, Next ou TanStack) — a IA infere o
-            modelo de conteúdo, você revisa, e o plugin cria tudo no Strapi.
-          </Typography>
+          <Typography variant="alpha" tag="h1">{t('prov.title')}</Typography>
+          <Typography variant="pi" textColor="neutral600">{t('prov.subtitle')}</Typography>
         </Box>
-        <Link to="..">
-          <Button variant="tertiary">← Voltar ao chat</Button>
-        </Link>
+        <Flex gap={2} alignItems="center">
+          <LangSwitcher />
+          <Link to="..">
+            <Button variant="tertiary">{t('prov.back')}</Button>
+          </Link>
+        </Flex>
       </Flex>
 
       <Box
@@ -213,12 +213,17 @@ const ProvisionPage = () => {
         style={{ maxWidth: 820, margin: '0 auto' }}
       >
         <Flex direction="column" alignItems="stretch" gap={4}>
+          {/* Stacks suportados */}
+          <Box>
+            <Typography variant="sigma" textColor="neutral600" tag="div">{t('prov.supported')}</Typography>
+            <Box paddingTop={2}><StackLogos /></Box>
+          </Box>
+
+          <Box height="1px" background="neutral200" />
+
           {/* Seleção do arquivo */}
-          <Typography variant="delta" tag="h2">1. Escolha o .zip do frontend</Typography>
-          <Typography textColor="neutral600">
-            Não precisa de <code>strapi.manifest.json</code>: se ele não existir, a IA cria um
-            analisando os dados do código (ex.: <code>src/data/*.ts</code>).
-          </Typography>
+          <Typography variant="delta" tag="h2">{t('prov.step1')}</Typography>
+          <Typography textColor="neutral600">{t('prov.step1desc')}</Typography>
 
           <input
             ref={inputRef}
@@ -236,27 +241,25 @@ const ProvisionPage = () => {
 
           <Flex gap={2} alignItems="center">
             <Button variant="secondary" onClick={() => inputRef.current?.click()} disabled={busy}>
-              Selecionar arquivo…
+              {t('prov.selectFile')}
             </Button>
             <Typography textColor={file ? 'neutral800' : 'neutral500'}>
-              {file ? file.name : 'Nenhum arquivo selecionado'}
+              {file ? file.name : t('prov.noFile')}
             </Typography>
           </Flex>
 
           {(phase === 'idle' || phase === 'analyzing') && (
             <Box paddingTop={2}>
               <Button onClick={analyze} loading={phase === 'analyzing'} disabled={!file || busy}>
-                Analisar projeto
+                {t('prov.analyze')}
               </Button>
             </Box>
           )}
 
           {phase === 'analyzing' && (
             <Flex gap={3} alignItems="center" background="primary100" padding={4} hasRadius>
-              <Loader small>Analisando…</Loader>
-              <Typography textColor="primary700">
-                Lendo o código e inferindo o modelo de conteúdo (content-types + seed)…
-              </Typography>
+              <Loader small>{t('prov.analyzing')}</Loader>
+              <Typography textColor="primary700">{t('prov.analyzingDesc')}</Typography>
             </Flex>
           )}
 
@@ -264,23 +267,21 @@ const ProvisionPage = () => {
           {phase === 'review' && (
             <>
               <Box height="1px" background="neutral200" />
-              <Typography variant="delta" tag="h2">2. Revise o modelo de conteúdo</Typography>
+              <Typography variant="delta" tag="h2">{t('prov.step2')}</Typography>
               <Flex gap={2} alignItems="center" wrap="wrap">
                 <Box background={inferred ? 'warning100' : 'success100'} padding={2} hasRadius>
                   <Typography variant="pi" textColor={inferred ? 'warning700' : 'success700'}>
-                    {inferred ? '🤖 Inferido pela IA' : '✓ Manifest do projeto'} • framework: {framework}
+                    {inferred ? t('prov.inferred') : t('prov.fromManifest')} • {t('prov.framework')}: {framework}
                   </Typography>
                 </Box>
                 {filesAnalyzed.length > 0 && (
                   <Typography variant="pi" textColor="neutral600">
-                    Analisou: {filesAnalyzed.slice(0, 6).join(', ')}
+                    {t('prov.analyzed')}: {filesAnalyzed.slice(0, 6).join(', ')}
                     {filesAnalyzed.length > 6 ? ` +${filesAnalyzed.length - 6}` : ''}
                   </Typography>
                 )}
               </Flex>
-              <Typography variant="pi" textColor="neutral600">
-                Edite o JSON se quiser ajustar nomes, tipos ou o conteúdo semeado antes de criar.
-              </Typography>
+              <Typography variant="pi" textColor="neutral600">{t('prov.editJson')}</Typography>
               <Textarea
                 name="manifest"
                 value={manifestText}
@@ -289,9 +290,9 @@ const ProvisionPage = () => {
               />
               <Flex gap={2}>
                 <Button onClick={provision} disabled={!manifestText.trim()}>
-                  Provisionar
+                  {t('prov.provision')}
                 </Button>
-                <Button variant="tertiary" onClick={reset}>Recomeçar</Button>
+                <Button variant="tertiary" onClick={reset}>{t('prov.restart')}</Button>
               </Flex>
             </>
           )}
@@ -300,15 +301,10 @@ const ProvisionPage = () => {
           {phase === 'provisioning' && (
             <Flex direction="column" gap={2} background="primary100" padding={4} hasRadius>
               <Flex gap={3} alignItems="center">
-                <Loader small>Provisionando…</Loader>
-                <Typography fontWeight="bold" textColor="primary700">
-                  Configurando tudo — isso leva alguns segundos
-                </Typography>
+                <Loader small>{t('prov.provisioning')}</Loader>
+                <Typography fontWeight="bold" textColor="primary700">{t('prov.provisioningTitle')}</Typography>
               </Flex>
-              <Typography variant="pi" textColor="neutral700">
-                A Strapi está reiniciando para reconhecer as content-types, depois semeia o
-                conteúdo, libera leitura pública e liga o preview. Não feche esta página.
-              </Typography>
+              <Typography variant="pi" textColor="neutral700">{t('prov.provisioningDesc')}</Typography>
             </Flex>
           )}
 
@@ -322,24 +318,24 @@ const ProvisionPage = () => {
           {phase === 'ready' && done && (
             <Box background="success100" padding={4} hasRadius>
               <Typography variant="beta" textColor="success700" tag="div">
-                ✅ Tudo pronto! Você já pode ver o preview.
+                {t('prov.doneTitle')}
               </Typography>
               <Box paddingTop={3}>
                 <Typography variant="pi" textColor="neutral700" tag="div">
-                  Content-types criadas: {done.contentTypes.join(', ')}
+                  {t('prov.typesCreated')} {done.contentTypes.join(', ')}
                 </Typography>
                 {done.seedCreated.length > 0 && (
                   <Typography variant="pi" textColor="neutral700" tag="div">
-                    Conteúdo semeado: {done.seedCreated.map((s) => `${s.uid} (${s.count})`).join(', ')}
+                    {t('prov.seeded')} {done.seedCreated.map((s) => `${s.uid} (${s.count})`).join(', ')}
                   </Typography>
                 )}
                 <Typography variant="pi" textColor="neutral700" tag="div">
-                  Frontend em: <code>{done.frontendDir}</code>
+                  {t('prov.frontendAt')} <code>{done.frontendDir}</code>
                 </Typography>
               </Box>
               <Box paddingTop={3}>
                 <Typography variant="pi" textColor="neutral700" tag="div">
-                  Para ver o preview, rode o frontend (uma vez):
+                  {t('prov.runFrontend')}
                 </Typography>
                 <Box background="neutral0" padding={2} hasRadius marginTop={1}
                   style={{ fontFamily: 'monospace', fontSize: 12 }}>
@@ -348,12 +344,11 @@ const ProvisionPage = () => {
               </Box>
               <Box paddingTop={3}>
                 <Typography variant="pi" textColor="neutral700" tag="div">
-                  Religar o frontend ao Strapi (snapshot): troca os dados hardcoded pelos do
-                  Strapi, mantendo as imagens. Os componentes não mudam.
+                  {t('prov.relinkDesc')}
                 </Typography>
                 <Box paddingTop={1}>
                   <Button onClick={integrate} loading={integrating} variant="default">
-                    Religar dados ao Strapi
+                    {t('prov.relink')}
                   </Button>
                 </Box>
                 {integrateMsg && (
@@ -367,9 +362,9 @@ const ProvisionPage = () => {
 
               <Flex gap={2} paddingTop={3}>
                 <a href={done.previewUrl} target="_blank" rel="noreferrer">
-                  <Button variant="success">Abrir {done.previewUrl} ↗</Button>
+                  <Button variant="success">{t('prov.open')} {done.previewUrl} ↗</Button>
                 </a>
-                <Button variant="tertiary" onClick={reset}>Provisionar outro</Button>
+                <Button variant="tertiary" onClick={reset}>{t('prov.provisionAnother')}</Button>
               </Flex>
             </Box>
           )}

package/dist/server/index.js

@@ -36,12 +36,12 @@ module.exports = __toCommonJS(index_exports);
 // server/src/controllers/chat.ts
 var chat_default = ({ strapi }) => ({
   async message(ctx) {
-    const { messages, image, lang, previewUrl } = ctx.request.body || {};
+    const { messages, image, lang, previewUrl, autoPublish } = ctx.request.body || {};
     if (!Array.isArray(messages) || messages.length === 0) {
       return ctx.badRequest('Campo "messages" (array) \xE9 obrigat\xF3rio.');
     }
     try {
-      const result = await strapi.plugin("mcp-chat").service("chat").chat({ messages, image, lang, previewUrl });
+      const result = await strapi.plugin("mcp-chat").service("chat").chat({ messages, image, lang, previewUrl, autoPublish });
       ctx.body = result;
     } catch (e) {
       strapi.log.error(`[mcp-chat] ${e?.message || e}`);
@@ -1712,6 +1712,18 @@ export function __getLocale(): string {
   } catch {}
   return __defaultLocale;
 }
+/** Status ativo: ?preview=1 ou ?status=draft na URL \u2192 rascunho (preview do
+ *  mcp-chat em modo Draft). Caso contr\xE1rio, publicado. S\xF3 no cliente; no SSR
+ *  cai para "published" (ver a nota de draft preview no README). */
+export function __getStatus(): "draft" | "published" {
+  try {
+    if (typeof window !== "undefined") {
+      const sp = new URL(window.location.href).searchParams;
+      if (sp.get("preview") === "1" || sp.get("status") === "draft") return "draft";
+    }
+  } catch {}
+  return "published";
+}
 
 ${mapperCode}
 
@@ -1719,11 +1731,13 @@ const __store: Record<string, any> = {};
 export function hydrate(d: any) { if (d) for (const k of Object.keys(d)) __store[k] = d[k]; }
 
 export async function loadAllData(opts: { locale?: string; status?: "draft" | "published" } = {}) {
+  // Sem status expl\xEDcito, herda do flag de preview na URL (?preview=1 \u2192 draft).
+  const __opts = { locale: opts.locale, status: opts.status || __getStatus() };
   const raw: Record<string, any> = {};
   await Promise.all(
     __cts.map(async (c: any) => {
       try {
-        raw[c.s] = c.k === "singleType" ? await fetchSingle(c.s, opts) : await fetchCollection(c.p, opts);
+        raw[c.s] = c.k === "singleType" ? await fetchSingle(c.s, __opts) : await fetchCollection(c.p, __opts);
       } catch {
         raw[c.s] = c.k === "singleType" ? null : [];
       }
@@ -2458,6 +2472,7 @@ function createContentTools(strapi) {
     (ct) => ct.uid?.startsWith("api::")
   );
   const attrsOf = (uid) => strapi.contentTypes?.[uid]?.attributes || strapi.components?.[uid]?.attributes || {};
+  const hasDraftAndPublish = (uid) => strapi.contentTypes?.[uid]?.options?.draftAndPublish === true;
   const buildPopulate = (attributes, seen = /* @__PURE__ */ new Set()) => {
     const populate = {};
     for (const [name, a] of Object.entries(attributes)) {
@@ -2517,6 +2532,7 @@ function createContentTools(strapi) {
       } catch {
         continue;
       }
+      const dp = hasDraftAndPublish(ct.uid);
       for (const e of entries) {
         walkFind(e, attributes, [], needle, (path9, campo, valor) => {
           matches.push({
@@ -2525,7 +2541,10 @@ function createContentTools(strapi) {
             documentId: e.documentId,
             path: path9,
             campo,
-            valor_atual: valor.length > 300 ? valor.slice(0, 300) + "\u2026" : valor
+            valor_atual: valor.length > 300 ? valor.slice(0, 300) + "\u2026" : valor,
+            // draftAndPublish=false → não há rascunho; a edição já é o conteúdo
+            // vivo e não há o que publicar (a IA deve avisar o usuário).
+            draftAndPublish: dp
           });
         });
       }
@@ -2572,7 +2591,7 @@ function createContentTools(strapi) {
     const loc = locale ? { locale } : {};
     if (p.length === 1 && ad && TEXTUAL.includes(ad.type)) {
       const updated2 = await strapi.documents(uid).update({ documentId, ...loc, data: { [topAttr]: novo_valor } });
-      return { ok: true, uid, documentId: updated2?.documentId || documentId, path: p, novo_valor, locale };
+      return { ok: true, uid, documentId: updated2?.documentId || documentId, path: p, novo_valor, locale, draftAndPublish: hasDraftAndPublish(uid) };
     }
     const populate = buildPopulate(attributes);
     const entry = await strapi.documents(uid).findOne({ documentId, status: "draft", ...loc, populate });
@@ -2586,13 +2605,22 @@ function createContentTools(strapi) {
     cur[p[p.length - 1]] = novo_valor;
     const data = { [topAttr]: sanitizeAttr(entry[topAttr], ad) };
     const updated = await strapi.documents(uid).update({ documentId, ...loc, data });
-    return { ok: true, uid, documentId: updated?.documentId || documentId, path: p, novo_valor, locale };
+    return { ok: true, uid, documentId: updated?.documentId || documentId, path: p, novo_valor, locale, draftAndPublish: hasDraftAndPublish(uid) };
   };
   const publicar = async ({
     uid,
     documentId,
     locale
   }) => {
+    if (!hasDraftAndPublish(uid)) {
+      return {
+        ok: true,
+        uid,
+        documentId,
+        status: "no-draft-publish",
+        nota: "Esta content-type n\xE3o tem Draft & Publish; n\xE3o h\xE1 rascunho a publicar \u2014 a altera\xE7\xE3o j\xE1 est\xE1 no ar."
+      };
+    }
     await strapi.documents(uid).publish({ documentId, ...locale ? { locale } : {} });
     return { ok: true, uid, documentId, status: "published", locale };
   };
@@ -2722,7 +2750,7 @@ function createContentTools(strapi) {
           if (!Object.keys(data).length) continue;
           await strapi.documents(ct.uid).update({ documentId: e.documentId, locale: tgt, data });
           documentos += 1;
-          if (publish) {
+          if (publish && hasDraftAndPublish(ct.uid)) {
             await strapi.documents(ct.uid).publish({ documentId: e.documentId, locale: tgt });
             publicados += 1;
           }
@@ -2779,7 +2807,7 @@ var openAiToolSpecs = [
     type: "function",
     function: {
       name: "publicar",
-      description: 'Publica a entrada (torna a altera\xE7\xE3o vis\xEDvel no site p\xFAblico). Passe "locale" para publicar um idioma espec\xEDfico, ou "*" para todos.',
+      description: 'Publica a entrada (torna a altera\xE7\xE3o vis\xEDvel no site p\xFAblico). Passe "locale" para publicar um idioma espec\xEDfico, ou "*" para todos. Se a content-type N\xC3O tiver Draft & Publish, n\xE3o h\xE1 o que publicar: retorna status "no-draft-publish" (a edi\xE7\xE3o j\xE1 est\xE1 no ar) \u2014 avise o usu\xE1rio em vez de tentar publicar de novo.',
       parameters: {
         type: "object",
         properties: {
@@ -2955,9 +2983,9 @@ Ferramentas de conte\xFAdo:
 Fluxo padr\xE3o quando o usu\xE1rio pede uma mudan\xE7a no site (por texto, voz ou mostrando a tela):
 1. Use buscar_texto com um trecho distintivo do texto a alterar (sem r\xF3tulos de status).
 2. Se houver mais de um resultado, escolha o mais prov\xE1vel pelo contexto (e diga qual escolheu); se amb\xEDguo de verdade, pergunte.
-3. editar_campo passando o mesmo uid, documentId e path do resultado, com o novo valor.
-4. publicar a entrada.
-5. Confirme em 1 frase o que foi alterado e publicado (content-type, campo, antes \u2192 depois).
+3. editar_campo passando o mesmo uid, documentId e path do resultado, com o novo valor. Isso salva como RASCUNHO (n\xE3o publica).
+4. Decida se publica ou n\xE3o conforme a POL\xCDTICA DE PUBLICA\xC7\xC3O indicada mais abaixo.
+5. Confirme em 1 frase o que foi alterado (content-type, campo, antes \u2192 depois) e se ficou como rascunho ou foi publicado.
 
 Ferramentas de tradu\xE7\xE3o / idiomas (i18n):
 - listar_locales(): mostra os idiomas configurados e o default.
@@ -2971,6 +2999,8 @@ Fluxo quando o usu\xE1rio pede tradu\xE7\xE3o (ex.: "quero o site todo em pt-BR"
 3. Ap\xF3s o restart, ao repetir, traduzir funciona e localiza tudo.
 4. Confirme em 1 frase: idiomas, quantos documentos e campos foram traduzidos/publicados (use o resumo retornado, n\xE3o despeje o conte\xFAdo).
 
+Draft & Publish: cada resultado de buscar_texto traz "draftAndPublish". Se for false, aquele tipo N\xC3O tem rascunho no Strapi \u2014 a edi\xE7\xE3o j\xE1 \xE9 o conte\xFAdo vivo e N\xC3O h\xE1 o que publicar; nesse caso, ao confirmar, avise que "esse conte\xFAdo n\xE3o tem rascunho, a altera\xE7\xE3o j\xE1 est\xE1 no ar" e N\xC3O chame publicar.
+
 Se o usu\xE1rio compartilhar a tela, uma imagem \xE9 anexada \xE0 \xFAltima mensagem \u2014 use-a para entender exatamente o que ele est\xE1 vendo e qual texto quer trocar.
 
 Seja objetivo e acion\xE1vel. Responda SEMPRE em portugu\xEAs.`,
@@ -2984,9 +3014,9 @@ Content tools:
 Default flow when the user asks for a site change (by text, voice or by showing their screen):
 1. Use buscar_texto with a distinctive snippet of the text to change (no status labels).
 2. If there is more than one result, pick the most likely from context (and say which); if truly ambiguous, ask.
-3. editar_campo passing the same uid, documentId and path from the result, with the new value.
-4. publicar the entry.
-5. Confirm in one sentence what was changed and published (content-type, field, before \u2192 after).
+3. editar_campo passing the same uid, documentId and path from the result, with the new value. This saves a DRAFT (does not publish).
+4. Decide whether to publish based on the PUBLISH POLICY stated below.
+5. Confirm in one sentence what was changed (content-type, field, before \u2192 after) and whether it stayed a draft or was published.
 
 Translation / language tools (i18n):
 - listar_locales(): shows configured languages and the default.
@@ -3000,12 +3030,14 @@ Flow when the user asks for translation (e.g. "I want the whole site in pt-BR"):
 3. After the restart, repeating the request makes traduzir localize everything.
 4. Confirm in one sentence: languages, how many documents and fields were translated/published (use the returned summary, don't dump the content).
 
+Draft & Publish: each buscar_texto result includes "draftAndPublish". If it is false, that type has NO draft in Strapi \u2014 the edit IS the live content and there is nothing to publish; in that case, when confirming, warn that "this content has no draft, the change is already live" and do NOT call publicar.
+
 If the user shares their screen, an image is attached to the last message \u2014 use it to understand exactly what they see and which text they want to change.
 
 Be concise and actionable. ALWAYS answer in English.`
 };
 var chat_default2 = ({ strapi }) => ({
-  async chat({ messages, image, lang = "pt", previewUrl }) {
+  async chat({ messages, image, lang = "pt", previewUrl, autoPublish = false }) {
     const apiKey = process.env.OPENAI_API_KEY;
     if (!apiKey) {
       throw new Error(
@@ -3062,7 +3094,19 @@ Voc\xEA tamb\xE9m controla um navegador real via ferramentas browser_* (Playwrig
 
 You also control a real browser via browser_* tools (Playwright), pointed at the STRAPI ADMIN at ${adminBase} (the backend \u2014 this is where content actually changes, NOT the public site). You can navigate (browser_navigate), click, type, scroll, take your own screenshots (browser_take_screenshot) and inspect console/errors. Always prefer your direct tools (buscar_texto/editar_campo/publicar) to change content; use the browser to VERIFY in the admin that the edit/publish landed, or for admin UI flows the direct tools don't cover.`
     };
-    const systemContent = SYSTEM[language] + (hasBrowser ? BROWSER_NOTE[language] : "");
+    const PUBLISH_POLICY = {
+      pt: autoPublish ? `
+
+POL\xCDTICA DE PUBLICA\xC7\xC3O: AUTO-PUBLICAR est\xE1 LIGADO. Depois de editar_campo, chame publicar para deixar a mudan\xE7a no ar. Em traduzir, use publish:true (default).` : `
+
+POL\xCDTICA DE PUBLICA\xC7\xC3O: MODO RASCUNHO (auto-publicar DESLIGADO). N\xC3O chame publicar a menos que o usu\xE1rio pe\xE7a explicitamente ("publica", "p\xF5e no ar", "publish"). Depois de editar_campo, PARE e avise que a altera\xE7\xE3o foi salva como RASCUNHO para revis\xE3o (ela j\xE1 aparece no preview em modo rascunho, mas ainda n\xE3o no site p\xFAblico). Em traduzir, passe publish:false. Se o usu\xE1rio pedir para publicar, a\xED sim use publicar (ou traduzir com publish:true).`,
+      en: autoPublish ? `
+
+PUBLISH POLICY: AUTO-PUBLISH is ON. After editar_campo, call publicar to make the change live. For traduzir, use publish:true (default).` : `
+
+PUBLISH POLICY: DRAFT MODE (auto-publish OFF). Do NOT call publicar unless the user explicitly asks ("publish", "make it live", "publica"). After editar_campo, STOP and tell them the change was saved as a DRAFT for review (it already shows in the preview when in draft mode, but not on the public site yet). For traduzir, pass publish:false. If the user asks to publish, then use publicar (or traduzir with publish:true).`
+    };
+    const systemContent = SYSTEM[language] + (hasBrowser ? BROWSER_NOTE[language] : "") + PUBLISH_POLICY[language];
     const convo = [{ role: "system", content: systemContent }];
     const pageNote = previewUrl ? language === "en" ? `
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strapi-plugin-mcp-chat",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "AI chat inside the Strapi 5 admin that reads and edits your content (incl. components & dynamic zones) via MCP, with voice and a side-by-side live preview.",
   "keywords": [
     "strapi",

package/server/src/content-tools.ts

@@ -37,6 +37,12 @@ export function createContentTools(strapi: any) {
       strapi.components?.[uid]?.attributes ||
       {}) as Record<string, any>;
 
+  // Draft & Publish é por content-type e vem DESLIGADO por padrão (docs Strapi 5).
+  // `publish()`/`unpublish()` SÓ existem quando está ligado — chamar sem D&P
+  // lança erro. Por isso checamos antes de publicar.
+  const hasDraftAndPublish = (uid: string): boolean =>
+    strapi.contentTypes?.[uid]?.options?.draftAndPublish === true;
+
   // Populate profundo: components (simples/repetíveis), dynamic zones (com `on`
   // por componente) e mídia/relações. `seen` evita recursão infinita.
   const buildPopulate = (attributes: Record<string, any>, seen = new Set<string>()): any => {
@@ -112,6 +118,7 @@ export function createContentTools(strapi: any) {
       } catch {
         continue;
       }
+      const dp = hasDraftAndPublish(ct.uid);
       for (const e of entries) {
         walkFind(e, attributes, [], needle, (path, campo, valor) => {
           matches.push({
@@ -121,6 +128,9 @@ export function createContentTools(strapi: any) {
             path,
             campo,
             valor_atual: valor.length > 300 ? valor.slice(0, 300) + '…' : valor,
+            // draftAndPublish=false → não há rascunho; a edição já é o conteúdo
+            // vivo e não há o que publicar (a IA deve avisar o usuário).
+            draftAndPublish: dp,
           });
         });
       }
@@ -179,7 +189,7 @@ export function createContentTools(strapi: any) {
       const updated = await strapi
         .documents(uid)
         .update({ documentId, ...loc, data: { [topAttr]: novo_valor } });
-      return { ok: true, uid, documentId: updated?.documentId || documentId, path: p, novo_valor, locale };
+      return { ok: true, uid, documentId: updated?.documentId || documentId, path: p, novo_valor, locale, draftAndPublish: hasDraftAndPublish(uid) };
     }
 
     // Campo aninhado → busca profunda, muta no caminho, sanitiza e regrava o
@@ -196,7 +206,7 @@ export function createContentTools(strapi: any) {
     cur[p[p.length - 1] as any] = novo_valor;
     const data = { [topAttr]: sanitizeAttr(entry[topAttr], ad) };
     const updated = await strapi.documents(uid).update({ documentId, ...loc, data });
-    return { ok: true, uid, documentId: updated?.documentId || documentId, path: p, novo_valor, locale };
+    return { ok: true, uid, documentId: updated?.documentId || documentId, path: p, novo_valor, locale, draftAndPublish: hasDraftAndPublish(uid) };
   };
 
   const publicar = async ({
@@ -209,6 +219,17 @@ export function createContentTools(strapi: any) {
     /** Locale a publicar; "*" publica todos os locales disponíveis. */
     locale?: string;
   }) => {
+    // Best practice Strapi 5: publish() só existe com Draft & Publish ligado;
+    // chamar sem D&P lança erro. Sem D&P não há rascunho — a edição já é o vivo.
+    if (!hasDraftAndPublish(uid)) {
+      return {
+        ok: true,
+        uid,
+        documentId,
+        status: 'no-draft-publish',
+        nota: 'Esta content-type não tem Draft & Publish; não há rascunho a publicar — a alteração já está no ar.',
+      };
+    }
     await strapi.documents(uid).publish({ documentId, ...(locale ? { locale } : {}) });
     return { ok: true, uid, documentId, status: 'published', locale };
   };
@@ -374,7 +395,8 @@ export function createContentTools(strapi: any) {
           // upsert idempotente da versão do locale
           await strapi.documents(ct.uid).update({ documentId: e.documentId, locale: tgt, data });
           documentos += 1;
-          if (publish) {
+          // Só publica se a CT tiver Draft & Publish (senão publish() lança erro).
+          if (publish && hasDraftAndPublish(ct.uid)) {
             await strapi.documents(ct.uid).publish({ documentId: e.documentId, locale: tgt });
             publicados += 1;
           }
@@ -439,7 +461,7 @@ export const openAiToolSpecs = [
     type: 'function',
     function: {
       name: 'publicar',
-      description: 'Publica a entrada (torna a alteração visível no site público). Passe "locale" para publicar um idioma específico, ou "*" para todos.',
+      description: 'Publica a entrada (torna a alteração visível no site público). Passe "locale" para publicar um idioma específico, ou "*" para todos. Se a content-type NÃO tiver Draft & Publish, não há o que publicar: retorna status "no-draft-publish" (a edição já está no ar) — avise o usuário em vez de tentar publicar de novo.',
       parameters: {
         type: 'object',
         properties: {

package/server/src/controllers/chat.ts

@@ -4,7 +4,7 @@
 
 export default ({ strapi }: { strapi: any }) => ({
   async message(ctx: any) {
-    const { messages, image, lang, previewUrl } = ctx.request.body || {};
+    const { messages, image, lang, previewUrl, autoPublish } = ctx.request.body || {};
     if (!Array.isArray(messages) || messages.length === 0) {
       return ctx.badRequest('Campo "messages" (array) é obrigatório.');
     }
@@ -12,7 +12,7 @@ export default ({ strapi }: { strapi: any }) => ({
       const result = await strapi
         .plugin('mcp-chat')
         .service('chat')
-        .chat({ messages, image, lang, previewUrl });
+        .chat({ messages, image, lang, previewUrl, autoPublish });
       ctx.body = result;
     } catch (e: any) {
       strapi.log.error(`[mcp-chat] ${e?.message || e}`);

package/server/src/provision/integrate.ts

@@ -558,6 +558,18 @@ export function __getLocale(): string {
   } catch {}
   return __defaultLocale;
 }
+/** Status ativo: ?preview=1 ou ?status=draft na URL → rascunho (preview do
+ *  mcp-chat em modo Draft). Caso contrário, publicado. Só no cliente; no SSR
+ *  cai para "published" (ver a nota de draft preview no README). */
+export function __getStatus(): "draft" | "published" {
+  try {
+    if (typeof window !== "undefined") {
+      const sp = new URL(window.location.href).searchParams;
+      if (sp.get("preview") === "1" || sp.get("status") === "draft") return "draft";
+    }
+  } catch {}
+  return "published";
+}
 
 ${mapperCode}
 
@@ -565,11 +577,13 @@ const __store: Record<string, any> = {};
 export function hydrate(d: any) { if (d) for (const k of Object.keys(d)) __store[k] = d[k]; }
 
 export async function loadAllData(opts: { locale?: string; status?: "draft" | "published" } = {}) {
+  // Sem status explícito, herda do flag de preview na URL (?preview=1 → draft).
+  const __opts = { locale: opts.locale, status: opts.status || __getStatus() };
   const raw: Record<string, any> = {};
   await Promise.all(
     __cts.map(async (c: any) => {
       try {
-        raw[c.s] = c.k === "singleType" ? await fetchSingle(c.s, opts) : await fetchCollection(c.p, opts);
+        raw[c.s] = c.k === "singleType" ? await fetchSingle(c.s, __opts) : await fetchCollection(c.p, __opts);
       } catch {
         raw[c.s] = c.k === "singleType" ? null : [];
       }