@12-apps/mcp 3.5.0 → 3.6.0

package/src/react/ai-steps.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import type { McpAiCopy } from "./copy";
 import { type GuidedNav, type GuidedStep } from "@12-apps/onboarding";
 
 import { providerForHostId, type AiHostGuide } from "../guide";
@@ -24,11 +25,13 @@ export function StatusBoard({
   connections,
   hosts,
   onDisconnect,
+  copy,
 }: {
   nav: GuidedNav;
   connections: readonly AiConnection[];
   hosts: readonly AiHostGuide[];
   onDisconnect?: DisconnectHandler;
+  copy: McpAiCopy;
 }): React.JSX.Element {
   const legacyHostId = (nav.data.connectedHost ?? nav.data.selectedHost) as string | undefined;
 
@@ -43,7 +46,7 @@ export function StatusBoard({
     return {
       host,
       connected: connection !== null,
-      detail: connection ? activeAgo(connection.lastActiveAt) : undefined,
+      detail: connection ? activeAgo(connection.lastActiveAt, copy.summary) : undefined,
     };
   });
 
@@ -78,19 +81,20 @@ export function StatusBoard({
     : undefined;
 
   return (
-    <AiStatusBoard statuses={statuses} onConnect={goToConnect} onDisconnect={disconnect} />
+    <AiStatusBoard copy={copy.statusBoard} statuses={statuses} onConnect={goToConnect} onDisconnect={disconnect} />
   );
 }
 
 /** The first step (host picker) — picking a card advances to the right path. */
-function selectStep(hosts: readonly AiHostGuide[]): GuidedStep {
+function selectStep(hosts: readonly AiHostGuide[], copy: McpAiCopy): GuidedStep {
   return {
     id: "select",
-    label: "Escolher",
+    label: copy.flow.steps.select,
     render: (nav: GuidedNav) => (
       <HostSelectStep
         hosts={hosts}
         selectedId={(nav.data.selectedHost as string | undefined) ?? null}
+        copy={copy.hostSelect}
         onSelect={(hostId) =>
           nav.goTo(hosts.find((h) => h.id === hostId)?.pluginUrl ? "install" : "copy", {
             selectedHost: hostId,
@@ -102,11 +106,11 @@ function selectStep(hosts: readonly AiHostGuide[]): GuidedStep {
 }
 
 /** The Copiar-URL step, shared by every manual flow. */
-function copyStep(endpointUrl: string): GuidedStep {
+function copyStep(endpointUrl: string, copy: McpAiCopy): GuidedStep {
   return {
     id: "copy",
-    label: "Copiar URL",
-    render: (nav: GuidedNav) => <CopyUrlStep nav={nav} endpointUrl={endpointUrl} />,
+    label: copy.flow.steps.copyUrl,
+    render: (nav: GuidedNav) => <CopyUrlStep copy={copy} nav={nav} endpointUrl={endpointUrl} />,
   };
 }
 
@@ -120,44 +124,70 @@ function manualMiddle(
   hosts: readonly AiHostGuide[],
   endpointUrl: string,
   connectPrompt: string,
+  copy: McpAiCopy,
 ): GuidedStep[] {
   if (host.configureStages && host.configureStages.length > 0) {
     return [
-      copyStep(endpointUrl),
+      copyStep(endpointUrl, copy),
       ...host.configureStages.map((stage) => ({
         id: stage.id,
         label: stage.label,
         render: (nav: GuidedNav) => (
-          <ConfigureStageStep nav={nav} host={resolveHost(hosts, nav.data.selectedHost)} stage={stage} />
+          <ConfigureStageStep
+            nav={nav}
+            host={resolveHost(hosts, nav.data.selectedHost)}
+            stage={stage}
+            copy={copy}
+          />
         ),
       })),
     ];
   }
   return [
-    copyStep(endpointUrl),
+    copyStep(endpointUrl, copy),
     {
       id: "configure",
-      label: "Configurar",
-      render: (nav: GuidedNav) => <ConfigureStep nav={nav} host={resolveHost(hosts, nav.data.selectedHost)} />,
+      label: copy.flow.steps.configure,
+      render: (nav: GuidedNav) => (
+        <ConfigureStep
+          nav={nav}
+          host={resolveHost(hosts, nav.data.selectedHost)}
+          copy={copy}
+        />
+      ),
     },
     {
       id: "connect",
-      label: "Conectar",
+      label: copy.flow.steps.connect,
       render: (nav: GuidedNav) => (
-        <ConnectStep nav={nav} host={resolveHost(hosts, nav.data.selectedHost)} connectPrompt={connectPrompt} />
+        <ConnectStep
+          nav={nav}
+          host={resolveHost(hosts, nav.data.selectedHost)}
+          connectPrompt={connectPrompt}
+          copy={copy}
+        />
       ),
     },
   ];
 }
 
 /** The single middle step for the simplified plugin flow: install. */
-function simpleMiddle(hosts: readonly AiHostGuide[], connectPrompt: string): GuidedStep[] {
+function simpleMiddle(
+  hosts: readonly AiHostGuide[],
+  connectPrompt: string,
+  copy: McpAiCopy,
+): GuidedStep[] {
   return [
     {
       id: "install",
-      label: "Instalar",
+      label: copy.flow.steps.install,
       render: (nav: GuidedNav) => (
-        <InstallStep nav={nav} host={resolveHost(hosts, nav.data.selectedHost)} connectPrompt={connectPrompt} />
+        <InstallStep
+          nav={nav}
+          host={resolveHost(hosts, nav.data.selectedHost)}
+          connectPrompt={connectPrompt}
+          copy={copy}
+        />
       ),
     },
   ];
@@ -176,17 +206,24 @@ export function buildFlowSteps(opts: {
   connectPrompt: string;
   connections: readonly AiConnection[];
   onRetest: () => void;
+  copy: McpAiCopy;
 }): GuidedStep[] {
-  const { host, hosts, endpointUrl, connectPrompt, connections, onRetest } = opts;
+  const { host, hosts, endpointUrl, connectPrompt, connections, onRetest, copy } = opts;
   const middle = host.pluginUrl
-    ? simpleMiddle(hosts, connectPrompt)
-    : manualMiddle(host, hosts, endpointUrl, connectPrompt);
+    ? simpleMiddle(hosts, connectPrompt, copy)
+    : manualMiddle(host, hosts, endpointUrl, connectPrompt, copy);
   const confirm: GuidedStep = {
     id: "confirm",
-    label: "Confirmar",
+    label: copy.flow.steps.confirm,
     render: (nav: GuidedNav) => (
-      <ConfirmStep nav={nav} connections={connections} hosts={hosts} onRetest={onRetest} />
+      <ConfirmStep
+        nav={nav}
+        connections={connections}
+        hosts={hosts}
+        onRetest={onRetest}
+        copy={copy}
+      />
     ),
   };
-  return [selectStep(hosts), ...middle, confirm];
+  return [selectStep(hosts, copy), ...middle, confirm];
 }

package/src/react/copy.ts

@@ -0,0 +1,154 @@
+/**
+ * Every word the AI-integration screens render, as REQUIRED host config
+ * (FUT-760).
+ *
+ * These components used to take `capabilities` / `permissionModel` / `hosts` as
+ * OPTIONAL props defaulting to this package's own pt-BR, and to compile the rest
+ * of their sentences in outright. `guide.ts` even said so — "these are the
+ * shared defaults" — which is the anti-pattern named exactly: a host that
+ * configured nothing shipped one product's Portuguese, and nothing failed to
+ * say so.
+ *
+ * Split per screen rather than one flat map, because three of them
+ * (`AiLanding`, `AiCapabilities`, `AiStatusBoard`, `HostSelectStep`) are
+ * exported standalone and a host mounting only one should not have to supply
+ * words for screens it never renders.
+ */
+
+/** The marketing block's headline and its supporting line. */
+export interface AiCapabilitiesCopy {
+  heading: string;
+  subheading: string;
+}
+
+/** One reassurance chip on the landing: an icon's label and its caption. */
+export interface AiTrustPoint {
+  /** Stable id — maps to the icon in the component. */
+  id: string;
+  label: string;
+  caption: string;
+}
+
+export interface AiLandingCopy {
+  /** Small line above the headline. */
+  eyebrow: string;
+  /** The headline's second half, after the assistant names. */
+  titleTail: string;
+  /** The paragraph under the headline. */
+  lede: string;
+  /** The reassurance strip. Order is the order rendered. */
+  trust: readonly AiTrustPoint[];
+  /** The call to action that starts the guided flow. */
+  start: string;
+}
+
+/** The wizard's step labels, in the order the stepper shows them. */
+export interface AiFlowStepLabels {
+  select: string;
+  copyUrl: string;
+  configure: string;
+  connect: string;
+  install: string;
+  confirm: string;
+}
+
+/** The wizard's navigation words and each step's own sentences. */
+export interface AiFlowCopy {
+  /** The stepper's labels. Not sentences, but still the host's words. */
+  steps: AiFlowStepLabels;
+  back: string;
+  next: string;
+  advance: string;
+  finish: string;
+  copyUrl: string;
+  copied: string;
+  copyMessage: string;
+  /** The copy-the-URL step's heading. Names the host's own noun for a tenant. */
+  copyUrlTitle: string;
+  /** Under the MCP URL: what this value is and what happens on copy. */
+  urlCaption: string;
+  /** Under the paste-in prompt: what the assistant will do with it. */
+  promptCaption: string;
+  /** The "ask the assistant to connect" step heading. */
+  askTitle: string;
+  /** The one-click install step's body, for a host with a published plugin. */
+  installBody: string;
+  /** The install button on that step. */
+  installAction: string;
+  /** Heading over the paste-in message on the manual path. */
+  pasteTitle: string;
+  /** Caption under the paste-in message on the install path. */
+  pasteInstallCaption: string;
+  /** Confirmation once a host reports in. */
+  connectedTo(hostLabel: string): string;
+  waitingTitle: string;
+  waitingBody(hostLabel: string): string;
+  testNow: string;
+}
+
+export interface AiStatusBoardCopy {
+  instructions: string;
+  connected: string;
+  notConnected: string;
+  connect: string;
+  disconnect: string;
+  disconnectTitle: string;
+  disconnectBody: string;
+  disconnectConfirm: string;
+  boardTitle: string;
+  boardCaption: string;
+}
+
+/**
+ * The one-line summary of a connection's recency.
+ *
+ * Functions rather than strings because the number is interpolated and the
+ * plural rule is the host language's, not this package's.
+ */
+export interface AiConnectionSummaryCopy {
+  /** Active within the last minute — no number to interpolate. */
+  activeNow: string;
+  activeMinutes(minutes: number): string;
+  activeHours(hours: number): string;
+  activeDays(days: number): string;
+  /** Connected, but too long ago to state a recency for. */
+  configured: string;
+  /** Appended after a host's name: `Claude Conectado`. */
+  connectedSuffix: string;
+  /** Several assistants at once, from an already-joined list of names. */
+  connectedSeveral(names: string): string;
+  /** Connected, but the provider was never attributed to a known assistant. */
+  connectedGeneric: string;
+}
+
+export interface AiHostSelectCopy {
+  /** Why the owner is picking, under the host tiles. */
+  caption: string;
+}
+
+export interface AiConnectGuideCopy {
+  /** The label on the MCP URL field. Names the host's own noun for a tenant. */
+  urlLabel: string;
+  /** Above the MCP URL field. */
+  urlHint: string;
+  /** Lead-in to the vendor's official connector docs link. */
+  moreInfo: string;
+  connectOn(hostLabel: string): string;
+}
+
+export interface AiOnboardingCopy {
+  title: string;
+  editLabel: string;
+}
+
+/** Every screen's words, for a host mounting the whole flow. */
+export interface McpAiCopy {
+  capabilities: AiCapabilitiesCopy;
+  landing: AiLandingCopy;
+  flow: AiFlowCopy;
+  statusBoard: AiStatusBoardCopy;
+  summary: AiConnectionSummaryCopy;
+  hostSelect: AiHostSelectCopy;
+  connectGuide: AiConnectGuideCopy;
+  onboarding: AiOnboardingCopy;
+}

package/src/react/host-connect-guide.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import type { AiConnectGuideCopy, AiFlowCopy } from "./copy";
 import CheckIcon from "@mui/icons-material/Check";
 import ContentCopyOutlinedIcon from "@mui/icons-material/ContentCopyOutlined";
 import OpenInNewIcon from "@mui/icons-material/OpenInNew";
@@ -24,10 +25,14 @@ export function EndpointCopyBlock({
   endpointUrl,
   copied,
   onCopy,
+  flowCopy,
+  copy,
 }: {
   endpointUrl: string;
   copied: boolean;
   onCopy: () => void;
+  flowCopy: AiFlowCopy;
+  copy: AiConnectGuideCopy;
 }): React.JSX.Element {
   const handleClick = (): void => {
     if (typeof navigator !== "undefined" && navigator.clipboard) {
@@ -47,10 +52,10 @@ export function EndpointCopyBlock({
       }}
     >
       <Text variant="caption" as="p" weight="bold">
-        URL do servidor da sua loja
+        {copy.urlLabel}
       </Text>
       <Text variant="caption" as="p" color="secondary">
-        Copie esta URL e cole no seu assistente para conectá-lo à loja.
+        {copy.urlHint}
       </Text>
       <Box sx={{ mt: 1 }}>
         <McpEndpointUrl url={endpointUrl} copyable={false} />
@@ -62,7 +67,7 @@ export function EndpointCopyBlock({
           ) : (
             <ContentCopyOutlinedIcon sx={{ fontSize: 18, mr: 0.5 }} />
           )}
-          {copied ? "Copiado" : "Copiar URL"}
+          {copied ? flowCopy.copied : flowCopy.copyUrl}
         </Button>
       </Box>
     </Box>
@@ -78,10 +83,12 @@ export function PromptCopyBlock({
   title,
   caption,
   message,
+  flowCopy,
 }: {
   title: string;
   caption: string;
   message: string;
+  flowCopy: AiFlowCopy;
 }): React.JSX.Element {
   const [copied, setCopied] = useState(false);
 
@@ -130,7 +137,7 @@ export function PromptCopyBlock({
           ) : (
             <ContentCopyOutlinedIcon sx={{ fontSize: 18, mr: 0.5 }} />
           )}
-          {copied ? "Copiado" : "Copiar mensagem"}
+          {copied ? flowCopy.copied : flowCopy.copyMessage}
         </Button>
       </Box>
     </Box>
@@ -138,12 +145,18 @@ export function PromptCopyBlock({
 }
 
 /** The brand mark + "Conectar no <host>" header shared by the connect sub-steps. */
-export function HostConnectHeader({ host }: { host: AiHostGuide }): React.JSX.Element {
+export function HostConnectHeader({
+  host,
+  copy,
+}: {
+  host: AiHostGuide;
+  copy: AiConnectGuideCopy;
+}): React.JSX.Element {
   return (
     <Stack direction="row" spacing={1.5} alignItems="center">
       <HostBrandAvatar brand={host.brand} size={36} />
       <Text variant="heading" size="sm" as="h3">
-        Conectar no {host.label}
+        {copy.connectOn(host.label)}
       </Text>
     </Stack>
   );
@@ -179,11 +192,14 @@ export function HostOpenButton({
 }
 
 /** A "Para mais informações" reference to the host's official connector docs. */
-export function HostDocsLink({ host }: { host: AiHostGuide }): React.JSX.Element | null {
+export function HostDocsLink({ host,
+  copy,
+}: { host: AiHostGuide;
+  copy: AiConnectGuideCopy;}): React.JSX.Element | null {
   if (!host.docs) return null;
   return (
     <Text variant="caption" as="p" color="secondary">
-      Para mais informações, consulte a{" "}
+      {copy.moreInfo}{" "}
       <Box
         component="a"
         href={host.docs.url}

package/src/react/host-select-step.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import type { AiHostSelectCopy } from "./copy";
 import CheckCircleIcon from "@mui/icons-material/CheckCircle";
 
 import { Box } from "@12-apps/ui/mui/Box";
@@ -72,10 +73,12 @@ export function HostSelectStep({
   hosts,
   selectedId,
   onSelect,
+  copy,
 }: {
   hosts: readonly AiHostGuide[];
   selectedId: string | null;
   onSelect: (hostId: string) => void;
+  copy: AiHostSelectCopy;
 }): React.JSX.Element {
   return (
     <Stack spacing={3} data-testid="ai-host-select">
@@ -84,7 +87,7 @@ export function HostSelectStep({
           Escolha o seu assistente
         </Text>
         <Text variant="caption" as="p" color="secondary">
-          Selecione onde você usa a IA — o passo a passo é feito sob medida para ele.
+          {copy.caption}
         </Text>
       </Box>
 

package/src/react/index.ts

@@ -29,9 +29,6 @@ export { McpEndpointUrl } from "./mcp-endpoint-url";
 export { HostBrandAvatar, CapabilityIcon } from "./ai-icons";
 export { FeatureBadge, type FeatureBadgeItem } from "./feature-badge";
 export {
-  aiHostGuides,
-  AI_CAPABILITIES,
-  AI_PERMISSION_MODEL,
   aiConnectPrompt,
   type AiConnectPromptSpec,
   providerForHostId,
@@ -42,3 +39,24 @@ export {
   type AiProvider,
   type AiCapability,
 } from "../guide";
+
+export {
+  PT_BR_AI_CAPABILITIES,
+  PT_BR_AI_CONNECT_PROMPT,
+  PT_BR_AI_HOST_GUIDES,
+  PT_BR_AI_PERMISSION_MODEL,
+} from "../pt-BR";
+
+export type {
+  AiCapabilitiesCopy,
+  AiConnectGuideCopy,
+  AiConnectionSummaryCopy,
+  AiFlowCopy,
+  AiHostSelectCopy,
+  AiLandingCopy,
+  AiOnboardingCopy,
+  AiStatusBoardCopy,
+  AiTrustPoint,
+  McpAiCopy,
+} from "./copy";
+export { PT_BR_MCP_AI_COPY } from "./pt-BR";

package/src/react/pt-BR.ts

@@ -0,0 +1,109 @@
+import type { McpAiCopy } from "./copy";
+
+/**
+ * The pt-BR pack for the AI-integration screens — a NAMED constant a host
+ * passes by hand, never a default.
+ *
+ * The filename is what exempts this file from the copy-portability gate:
+ * Portuguese may ship, it may not be silent. Every sentence is VERBATIM what
+ * the components used to render, so a host adopting it sees no change on
+ * screen — what changes is that the words are chosen in a diff.
+ */
+export const PT_BR_MCP_AI_COPY: McpAiCopy = {
+  capabilities: {
+    heading: "O que o assistente faz por você",
+    subheading: "Sem planilhas, sem cliques — é só perguntar na conversa.",
+  },
+  landing: {
+    eyebrow: "Integração com IA",
+    titleTail: "à sua loja",
+    lede:
+      "Deixe o Claude, o ChatGPT e outros assistentes responderem sobre o seu cardápio, estoque e " +
+      "pedidos — e executarem ações por você, direto na conversa. Com segurança e sem instalar nada.",
+    trust: [
+      {
+        id: "login",
+        label: "Usa o seu próprio login",
+        caption: "Sem chaves ou credenciais extras",
+      },
+      { id: "install", label: "Sem instalar nada", caption: "Conecta em poucos minutos" },
+      {
+        id: "permissions",
+        label: "Só o que você pode",
+        caption: "As suas permissões, nada além",
+      },
+      { id: "surface", label: "Navegador ou app", caption: "Claude, ChatGPT, Codex" },
+    ],
+    start: "Começar",
+  },
+  flow: {
+    steps: {
+      select: "Escolher",
+      copyUrl: "Copiar URL",
+      configure: "Configurar",
+      connect: "Conectar",
+      install: "Instalar",
+      confirm: "Confirmar",
+    },
+    back: "Voltar",
+    next: "Próximo",
+    advance: "Continuar",
+    finish: "Concluir",
+    copyUrl: "Copiar URL",
+    copied: "Copiado",
+    copyMessage: "Copiar mensagem",
+    copyUrlTitle: "Copie a URL da sua loja",
+    urlCaption:
+      "É o único dado que você cola no assistente — ao copiar, seguimos para o próximo passo.",
+    promptCaption:
+      "Assim ele se conecta, se identifica (Claude, ChatGPT…) e registramos a conexão.",
+    askTitle: "Peça ao assistente para conectar",
+    installBody:
+      "Abra o plugin da sua loja, clique em Instalar e autorize o acesso — sem copiar URL nem gerar credenciais.",
+    installAction: "Instalar o plugin da loja",
+    pasteTitle: "Cole esta mensagem no assistente",
+    pasteInstallCaption:
+      "Cole no assistente para ele se conectar, se identificar e confirmar o acesso.",
+    connectedTo: (hostLabel) => `${hostLabel} está conectado à sua loja.`,
+    waitingTitle: "Esperando conexão",
+    waitingBody: (hostLabel) =>
+      `Assim que você autorizar o acesso no ${hostLabel}, ela aparece aqui automaticamente.`,
+    testNow: "Testar agora",
+  },
+  statusBoard: {
+    instructions: "Instruções",
+    connected: "Conectado",
+    notConnected: "Ainda não conectado",
+    connect: "Conectar",
+    disconnect: "Desconectar",
+    disconnectTitle: "Desconectar o assistente?",
+    disconnectBody:
+      "Ele perde o acesso à sua loja na hora. Para voltar a usar, será preciso conectar de novo.",
+    disconnectConfirm: "Desconectar",
+    boardTitle: "Assistentes conectados",
+    boardCaption: "Em verde os que já operam a sua loja; em vermelho os que faltam conectar.",
+  },
+  summary: {
+    activeNow: "ativo agora",
+    activeMinutes: (minutes) => `ativo há ${minutes} min`,
+    activeHours: (hours) => `ativo há ${hours} h`,
+    activeDays: (days) => `ativo há ${days} dias`,
+    configured: "Integração configurada",
+    connectedSuffix: "Conectado",
+    connectedSeveral: (names) => `${names} conectados`,
+    connectedGeneric: "IA conectada",
+  },
+  hostSelect: {
+    caption: "Selecione onde você usa a IA — o passo a passo é feito sob medida para ele.",
+  },
+  connectGuide: {
+    urlLabel: "URL do servidor da sua loja",
+    urlHint: "Copie esta URL e cole no seu assistente para conectá-lo à loja.",
+    moreInfo: "Para mais informações, consulte a",
+    connectOn: (hostLabel) => `Conectar no ${hostLabel}`,
+  },
+  onboarding: {
+    title: "Conecte assistentes de IA à sua loja",
+    editLabel: "Conectar IA",
+  },
+};

package/dist/chunk-FYEVBTDU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/guide.ts"],"sourcesContent":["/**\n * AI-integration guide content — the reusable copy for a store's \"Integração com\n * IA\" onboarding. Pure, public, non-sensitive text (no React) so the on-page\n * walkthrough stays a portable, testable content module. Host brand marks/icons\n * and colours live in the components. Apps may pass their own overrides to\n * `<AiIntegrationOnboarding>`; these are the shared defaults.\n *\n * The MCP endpoint URL is NOT hardcoded here — the app derives it per request\n * from the deployment origin and passes it in.\n */\n\n/** Which brand a host belongs to — drives the icon/accent in the UI. */\nexport type AiHostBrand = \"claude\" | \"openai\";\n\nexport interface AiHostLink {\n  /** Deep-link straight to the host's connector settings, when one exists. */\n  url: string;\n  label: string;\n}\n\n/**\n * One stage of the \"configure the connector\" part of the flow. A host can split\n * configuration across several stages, each with its OWN deep link, step label\n * and instructions — e.g. ChatGPT needs \"enable developer mode\" (Security\n * settings) and then \"configurar\" (create the connector). When a host declares\n * `configureStages`, the wizard renders one wizard step per stage (between\n * \"Copiar URL\" and \"Confirmar\") instead of the default Configurar/Conectar\n * split, and the sign-in happens inside a stage — no prompt to paste.\n */\nexport interface AiHostConfigureStage {\n  /** Stable id — also the wizard step id + test id suffix (`ai-stage-${id}`). */\n  id: string;\n  /** Step label shown in the stepper. */\n  label: string;\n  /** Optional deep link opened on this stage (unlocks \"Próximo\" once opened). */\n  link?: AiHostLink;\n  /** The instructions shown for this stage. */\n  steps: readonly string[];\n}\n\n/**\n * The AI providers a connection can be attributed to — derived server-side from\n * the OAuth client's redirect URIs (and confirmed by the `announceAiConnection`\n * tool). Drives which host card lights up green on the status board.\n */\nexport type AiProvider = \"claude\" | \"chatgpt\" | \"codex\";\n\n/** The provider a host id belongs to (claude-desktop shares Claude's provider). */\nexport function providerForHostId(hostId: string): AiProvider | null {\n  if (hostId === \"claude\" || hostId === \"claude-desktop\") return \"claude\";\n  if (hostId === \"chatgpt\") return \"chatgpt\";\n  if (hostId === \"codex\") return \"codex\";\n  return null;\n}\n\nexport interface AiHostGuide {\n  /** Stable id — also the panel test id suffix (`ai-setup-${id}`). */\n  id: string;\n  /** Tab label shown to the owner. */\n  label: string;\n  brand: AiHostBrand;\n  /** One-line hint of what this host is (web app, desktop app, CLI…). */\n  kind: string;\n  /** Optional direct link button (desktop apps have no deep link). */\n  link?: AiHostLink;\n  /**\n   * Optional link to the host's OFFICIAL connector docs — a stable vendor URL\n   * shown as a \"Para mais informações\" reference (never a deep link with a\n   * volatile connector id / UI params).\n   */\n  docs?: AiHostLink;\n  steps: readonly string[];\n  /**\n   * Optional per-stage configuration (each with its own deep link + label). When\n   * present, the wizard renders one step per stage in place of the default\n   * Configurar → Conectar split, and `steps` mirrors the flattened stage\n   * instructions so the MCP guide stays a single source of truth.\n   */\n  configureStages?: readonly AiHostConfigureStage[];\n  /**\n   * Optional deep link to a PUBLISHED one-click plugin/connector for this host\n   * (set per app via env, e.g. `CHATGPT_PLUGIN_URL` / `CLAUDE_PLUGIN_URL`). When\n   * present, the wizard swaps the manual \"copy URL + configure connector\" path\n   * for a simplified \"open → Install → authorize\" flow: the owner never copies\n   * the MCP URL. Absent → the full manual flow.\n   */\n  pluginUrl?: string;\n}\n\nconst CONNECTOR_TAIL: readonly string[] = [\n  \"Deixe OAuth Client ID e Client Secret em branco — não é preciso gerar credenciais: a loja registra o conector automaticamente no primeiro acesso.\",\n  \"Confirme e clique em Connect: abre a tela de login da loja — entre com a SUA conta de lojista e autorize o acesso.\",\n  \"Pronto: ative o conector na conversa para o assistente consultar e operar a sua loja.\",\n];\n\n/**\n * ChatGPT's two-stage configuration (Developer mode is now required before a\n * connector can be created). Stage 1 enables Developer mode in Security & login;\n * stage 2 creates the connector and signs in — which registers the connection on\n * the store side, so no prompt needs to be pasted afterwards.\n */\nfunction chatgptConfigureStages(\n  platformName: string,\n): readonly AiHostConfigureStage[] {\n  return [\n    {\n      id: \"enable-dev-mode\",\n      label: \"enable developer mode\",\n      link: {\n        url: \"https://chatgpt.com/plugins#settings/Security\",\n        label: \"Abrir Segurança e login\",\n      },\n      steps: [\n        \"Ative o Modo desenvolvedor em Settings › Security and login (Segurança e login).\",\n      ],\n    },\n    {\n      id: \"configurar\",\n      label: \"configurar\",\n      link: {\n        url: \"https://chatgpt.com/plugins#settings/Connectors?create-connector=true&redirectAfter=%2Fplugins\",\n        label: \"Criar o conector\",\n      },\n      steps: [\n        \"Isso vai abrir um popup para você criar um plugin novo. Coloque como nome o nome da sua loja e, no campo MCP, o link copiado no passo anterior.\",\n        'Marque a caixa \"I understand and want to continue\" — a OpenAI não revisou este servidor MCP; ela avisa que sites podem tentar roubar seus dados ou induzir o modelo a ações indevidas, incluindo destruir dados.',\n        `Clique em \"Sign in with ${platformName}\" e entre com a sua conta de lojista para autorizar o acesso. Pronto: a conexão é registrada automaticamente.`,\n      ],\n    },\n  ];\n}\n\n/**\n * The AI hosts a store owner can connect, in recommended order. Same OAuth flow\n * everywhere (the host drives it) — only the menu path differs per app.\n *\n * A FUNCTION of the platform's name, because one step is not generic: the\n * ChatGPT connector's consent screen shows an OAuth button labelled with\n * whoever operates the server, and the owner is told which button to click. It\n * used to name one particular STORE on one particular deployment — not even the\n * product, a tenant of it — so every other adopter instructed its owners to\n * click a button that does not exist.\n */\nexport function aiHostGuides(platformName: string): readonly AiHostGuide[] {\n  const chatgptStages = chatgptConfigureStages(platformName);\n  return [\n    {\n      id: \"claude\",\n      label: \"Claude.ai\",\n      brand: \"claude\",\n      kind: \"No navegador\",\n      link: {\n        url: \"https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors\",\n        label: \"Abrir os conectores do Claude\",\n      },\n      docs: {\n        url: \"https://support.anthropic.com/en/articles/11175166-how-do-i-connect-mcp-servers-to-claude-ai\",\n        label: \"documentação oficial da Anthropic — conectores personalizados\",\n      },\n      steps: [\n        \"Clique no botão acima (ou vá em Settings › Customize › Connectors) e escolha Add custom connector.\",\n        \"Dê um nome ao conector (ex.: o nome da sua loja) e cole a URL do servidor MCP da sua loja (copie acima) no campo de URL.\",\n        ...CONNECTOR_TAIL,\n      ],\n    },\n    {\n      id: \"claude-desktop\",\n      label: \"Claude Desktop\",\n      brand: \"claude\",\n      kind: \"Aplicativo (Windows/Mac)\",\n      docs: {\n        url: \"https://support.anthropic.com/en/articles/11175166-how-do-i-connect-mcp-servers-to-claude-ai\",\n        label: \"documentação oficial da Anthropic — conectores personalizados\",\n      },\n      steps: [\n        \"Abra o Claude Desktop e vá em Settings (⚙️) › Connectors.\",\n        \"Clique em Add custom connector e cole a URL do servidor MCP da sua loja (copie acima).\",\n        ...CONNECTOR_TAIL,\n      ],\n    },\n    {\n      id: \"chatgpt\",\n      label: \"ChatGPT\",\n      brand: \"openai\",\n      kind: \"No navegador\",\n      link: {\n        url: \"https://chatgpt.com/plugins\",\n        label: \"Abrir os plugins do ChatGPT\",\n      },\n      docs: {\n        url: \"https://developers.openai.com/apps-sdk/deploy/connect-chatgpt\",\n        label:\n          \"documentação oficial da OpenAI — conectar um servidor MCP ao ChatGPT\",\n      },\n      configureStages: chatgptStages,\n      // Mirrors the flattened stage instructions so the MCP connect guide\n      // (`connectToChatGpt`) can never drift from what owners see in the wizard.\n      steps: chatgptStages.flatMap((stage) => stage.steps),\n    },\n    {\n      id: \"codex\",\n      label: \"Codex\",\n      brand: \"openai\",\n      kind: \"App / CLI de desenvolvedor\",\n      link: {\n        url: \"https://developers.openai.com/codex\",\n        label: \"Documentação do Codex\",\n      },\n      docs: {\n        url: \"https://developers.openai.com/apps-sdk/deploy/connect-chatgpt\",\n        label: \"documentação oficial da OpenAI — conectar um servidor MCP\",\n      },\n      steps: [\n        \"No Codex, abra as configurações de MCP (Settings › MCP no app, ou o arquivo de configuração na CLI).\",\n        \"Adicione um servidor MCP e cole a URL do servidor MCP da sua loja (copie acima) como um conector remoto (HTTP).\",\n        ...CONNECTOR_TAIL,\n      ],\n    },\n  ];\n}\n\nexport interface AiCapability {\n  /** Stable id — maps to an icon in the component. */\n  id: string;\n  /** Card headline. */\n  title: string;\n  /** Short supporting line, usually an example prompt in quotes. */\n  detail: string;\n}\n\n/** What a connected assistant does for the owner — one marketing card each. */\nexport const AI_CAPABILITIES: readonly AiCapability[] = [\n  {\n    id: \"orders\",\n    title: \"Acompanhe seus pedidos\",\n    detail: '\"Quais pedidos entraram hoje?\"',\n  },\n  {\n    id: \"inventory\",\n    title: \"Controle o estoque\",\n    detail:\n      '\"Quanto ainda tenho do produto X? Registre a entrada de 20 unidades.\"',\n  },\n  {\n    id: \"catalog\",\n    title: \"Gerencie o catálogo\",\n    detail: \"Crie e edite produtos e categorias conversando.\",\n  },\n  {\n    id: \"sales\",\n    title: \"Entenda suas vendas\",\n    detail: '\"Qual foi o faturamento da semana?\"',\n  },\n];\n\n/**\n * The permission model in one line, shown prominently: the assistant acts AS\n * the signed-in owner (auth-passthrough) — it can do exactly what the owner\n * can, nothing more, and no extra credential/API key is ever created.\n */\nexport const AI_PERMISSION_MODEL =\n  \"O assistente age em seu nome, com exatamente as suas permissões: ele pode fazer o que você pode fazer na sua loja — nada além disso. Não é preciso criar nenhuma chave ou credencial extra; a autorização usa o seu próprio login.\";\n\n/** The two tools the paste-in prompt drives, and what to call the store id. */\nexport interface AiConnectPromptSpec {\n  /**\n   * The tool that REGISTERS the connection server-side, so the store learns\n   * which assistant connected.\n   */\n  announceTool: string;\n  /** A real READ tool, called straight after, to prove the access works. */\n  probeTool: string;\n  /** What that read returns, in the owner's own words (\"o estoque da loja\"). */\n  probeSubject: string;\n  /** What the assistant should ask for if it needs to identify the store. */\n  identifierName: string;\n}\n\n/**\n * The message the owner pastes into the assistant's chat right after\n * connecting: announce the connection, then read something real to prove it\n * works. The owner types nothing.\n *\n * BUILT from the host's tool names rather than shipped with them. This was a\n * constant naming two tools — `announceAiConnection` and `listInventory` — that\n * THIS PACKAGE does not define or serve; they belong to one adopter's surface.\n * Any other host handed its owner a prompt instructing the assistant to call\n * two tools that do not exist, and because nothing registered the connection,\n * the wizard's confirm step then waited forever for a state that could never\n * arrive.\n */\nexport function aiConnectPrompt(spec: AiConnectPromptSpec): string {\n  return (\n    \"Você agora tem acesso ao conector MCP da minha loja. Faça, nesta ordem:\\n\" +\n    `1) Execute a ferramenta ${spec.announceTool} informando qual assistente você é (host: \"chatgpt\", \"claude\" ou \"codex\") para registrar a conexão com a minha loja.\\n` +\n    `2) Execute a ferramenta ${spec.probeTool} para confirmar o acesso a ${spec.probeSubject}.\\n` +\n    `Se precisar do identificador da loja, me pergunte o ${spec.identifierName}.`\n  );\n}\n"],"mappings":"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","names":[]}