@12-apps/mcp 3.10.0 → 3.11.0

package/src/en-US.ts

@@ -0,0 +1,204 @@
+import type {
+  AiCapability,
+  AiConnectPromptSpec,
+  AiHostConfigureStage,
+  AiHostGuide,
+  AiPermissionModel,
+} from "./guide";
+
+/**
+ * The en-US pack for the AI-integration surface — NAMED constants a host passes
+ * by hand, never defaults.
+ *
+ * The guides are DATA as much as copy: which assistants are offered, their
+ * stage ids, their brands and their LINKS. Both halves travel together because
+ * a step label and the stage it labels are useless apart — and the parts that
+ * are not words do not change between languages:
+ *
+ *  - `id` and `brand` are the package's own keys, matched on by the component;
+ *  - the URLs point at Anthropic's and OpenAI's own pages;
+ *  - the UI labels a reader must FIND in those products stay in the product's
+ *    own English (`Add custom connector`, `Settings › Security and login`,
+ *    `Sign in with …`), which is the same rule that keeps a vendor's field name
+ *    untranslated everywhere else here.
+ *
+ * The pt-BR pack quotes those same labels in English for exactly this reason;
+ * what differs between the two packs is the instruction around them.
+ */
+
+const CONNECTOR_TAIL: readonly string[] = [
+  "Leave OAuth Client ID and Client Secret blank — there are no credentials to generate: the store registers the connector automatically on first access.",
+  "Confirm and click Connect: the store's sign-in screen opens — sign in with YOUR own owner account and authorise the access.",
+  "Done: enable the connector in the chat so the assistant can query and operate your store.",
+];
+
+/**
+ * ChatGPT's two-stage configuration (Developer mode is now required before a
+ * connector can be created). Stage 1 enables Developer mode in Security & login;
+ * stage 2 creates the connector and signs in — which registers the connection on
+ * the store side, so no prompt needs to be pasted afterwards.
+ */
+function chatgptConfigureStages(
+  platformName: string,
+): readonly AiHostConfigureStage[] {
+  return [
+    {
+      id: "enable-dev-mode",
+      label: "enable developer mode",
+      link: {
+        url: "https://chatgpt.com/plugins#settings/Security",
+        label: "Open Security and login",
+      },
+      steps: [
+        "Turn on Developer mode under Settings › Security and login.",
+      ],
+    },
+    {
+      id: "configurar",
+      label: "configure",
+      link: {
+        url: "https://chatgpt.com/plugins#settings/Connectors?create-connector=true&redirectAfter=%2Fplugins",
+        label: "Create the connector",
+      },
+      steps: [
+        "That opens a popup to create a new plugin. Give it your store's name, and put the link you copied in the previous step in the MCP field.",
+        'Tick "I understand and want to continue" — OpenAI has not reviewed this MCP server; they warn that sites may try to steal your data or push the model into harmful actions, including destroying data.',
+        `Click "Sign in with ${platformName}" and sign in with your owner account to authorise access. That is it: the connection is registered automatically.`,
+      ],
+    },
+  ];
+}
+
+/**
+ * The AI hosts a store owner can connect, in recommended order. Same OAuth flow
+ * everywhere (the host drives it) — only the menu path differs per app.
+ *
+ * A FUNCTION of the platform's name, because one step is not generic: the
+ * ChatGPT connector's consent screen shows an OAuth button labelled with
+ * whoever operates the server, and the owner is told which button to click. It
+ * used to name one particular STORE on one particular deployment — not even the
+ * product, a tenant of it — so every other adopter instructed its owners to
+ * click a button that does not exist.
+ */
+export function EN_US_AI_HOST_GUIDES(platformName: string): readonly AiHostGuide[] {
+  const chatgptStages = chatgptConfigureStages(platformName);
+  return [
+    {
+      id: "claude",
+      label: "Claude.ai",
+      brand: "claude",
+      kind: "In the browser",
+      link: {
+        url: "https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors",
+        label: "Open Claude's connectors",
+      },
+      docs: {
+        url: "https://support.anthropic.com/en/articles/11175166-how-do-i-connect-mcp-servers-to-claude-ai",
+        label: "Anthropic's own documentation — custom connectors",
+      },
+      steps: [
+        "Click the button above (or go to Settings › Customize › Connectors) and choose Add custom connector.",
+        "Name the connector (your store's name works) and paste your store's MCP server URL (copy it above) into the URL field.",
+        ...CONNECTOR_TAIL,
+      ],
+    },
+    {
+      id: "claude-desktop",
+      label: "Claude Desktop",
+      brand: "claude",
+      kind: "App (Windows/Mac)",
+      docs: {
+        url: "https://support.anthropic.com/en/articles/11175166-how-do-i-connect-mcp-servers-to-claude-ai",
+        label: "Anthropic's own documentation — custom connectors",
+      },
+      steps: [
+        "Open Claude Desktop and go to Settings (⚙️) › Connectors.",
+        "Click Add custom connector and paste your store's MCP server URL (copy it above).",
+        ...CONNECTOR_TAIL,
+      ],
+    },
+    {
+      id: "chatgpt",
+      label: "ChatGPT",
+      brand: "openai",
+      kind: "In the browser",
+      link: {
+        url: "https://chatgpt.com/plugins",
+        label: "Open ChatGPT's plugins",
+      },
+      docs: {
+        url: "https://developers.openai.com/apps-sdk/deploy/connect-chatgpt",
+        label: "OpenAI's own documentation — connecting an MCP server to ChatGPT",
+      },
+      configureStages: chatgptStages,
+      // Mirrors the flattened stage instructions so the MCP connect guide
+      // (`connectToChatGpt`) can never drift from what owners see in the wizard.
+      steps: chatgptStages.flatMap((stage) => stage.steps),
+    },
+    {
+      id: "codex",
+      label: "Codex",
+      brand: "openai",
+      kind: "Developer app / CLI",
+      link: {
+        url: "https://developers.openai.com/codex",
+        label: "Codex documentation",
+      },
+      docs: {
+        url: "https://developers.openai.com/apps-sdk/deploy/connect-chatgpt",
+        label: "OpenAI's own documentation — connecting an MCP server",
+      },
+      steps: [
+        "In Codex, open the MCP settings (Settings › MCP in the app, or the config file on the CLI).",
+        "Add an MCP server and paste your store's MCP server URL (copy it above) as a remote (HTTP) connector.",
+        ...CONNECTOR_TAIL,
+      ],
+    },
+  ];
+}
+
+export const EN_US_AI_CAPABILITIES: readonly AiCapability[] = [
+  // The `detail` of each is a QUESTION a reader could paste verbatim, so it is
+  // written as one rather than described.
+  {
+    id: "orders",
+    title: "Follow your orders",
+    detail: '"Which orders came in today?"',
+  },
+  {
+    id: "inventory",
+    title: "Keep on top of stock",
+    detail: '"How much of product X is left? Record 20 units received."',
+  },
+  {
+    id: "catalog",
+    title: "Manage the catalog",
+    detail: "Create and edit products and categories by chatting.",
+  },
+  {
+    id: "sales",
+    title: "Understand your sales",
+    detail: '"What was this week\'s revenue?"',
+  },
+];
+
+/**
+ * The permission model in one line, shown prominently: the assistant acts AS
+ * the signed-in owner (auth-passthrough) — it can do exactly what the owner
+ * can, nothing more, and no extra credential/API key is ever created.
+ */
+export const EN_US_AI_PERMISSION_MODEL: AiPermissionModel =
+  "The assistant acts on your behalf with exactly your permissions: it can do what you can do in your store — and nothing beyond that. There is no key or extra credential to create; the authorisation uses your own login.";
+
+/** The en-US paste-in prompt, built from the host's own tool names. */
+export function EN_US_AI_CONNECT_PROMPT(spec: AiConnectPromptSpec): string {
+  // The TOOL NAMES are the host's own identifiers and are interpolated, never
+  // translated: the assistant has to call them by the name they are registered
+  // under, so a translated verb here is a prompt that does nothing.
+  return (
+    "You now have access to my store's MCP connector. Do the following, in order:\n" +
+    `1) Run the ${spec.announceTool} tool, saying which assistant you are (host: "chatgpt", "claude" or "codex"), to register the connection with my store.\n` +
+    `2) Run the ${spec.probeTool} tool to confirm access to ${spec.probeSubject}.\n` +
+    `If you need the store identifier, ask me for the ${spec.identifierName}.`
+  );
+}

package/src/index.ts

@@ -104,3 +104,15 @@ export {
   PT_BR_AI_HOST_GUIDES,
   PT_BR_AI_PERMISSION_MODEL,
 } from "./pt-BR";
+export {
+  EN_US_AI_CAPABILITIES,
+  EN_US_AI_CONNECT_PROMPT,
+  EN_US_AI_HOST_GUIDES,
+  EN_US_AI_PERMISSION_MODEL,
+} from "./en-US";
+export {
+  AI_CAPABILITIES,
+  AI_CONNECT_PROMPT,
+  AI_HOST_GUIDES,
+  AI_PERMISSION_MODEL,
+} from "./locales";

package/src/locales.ts

@@ -0,0 +1,58 @@
+import {
+  EN_US_AI_CAPABILITIES,
+  EN_US_AI_CONNECT_PROMPT,
+  EN_US_AI_HOST_GUIDES,
+  EN_US_AI_PERMISSION_MODEL,
+} from "./en-US";
+import type {
+  AiCapability,
+  AiConnectPromptSpec,
+  AiHostGuide,
+  AiPermissionModel,
+} from "./guide";
+import {
+  PT_BR_AI_CAPABILITIES,
+  PT_BR_AI_CONNECT_PROMPT,
+  PT_BR_AI_HOST_GUIDES,
+  PT_BR_AI_PERMISSION_MODEL,
+} from "./pt-BR";
+
+/**
+ * The AI-integration surface in both languages, keyed by tag — what a host
+ * hands to `@12-apps/i18n` when the reader's language is a property of the
+ * request rather than of the deployment.
+ *
+ * Two of these are FUNCTIONS rather than tables, and stay so:
+ *
+ *  - `AI_HOST_GUIDES` takes the platform's name, because the ChatGPT consent
+ *    screen shows an OAuth button labelled with whoever operates the server and
+ *    the owner is told which button to click. It once named one particular
+ *    tenant of one deployment, so every other adopter instructed its owners to
+ *    click a button that does not exist.
+ *  - `AI_CONNECT_PROMPT` takes the host's own tool names, which the assistant
+ *    must call by the name they are registered under.
+ *
+ * `LocalePack` is mirrored here rather than imported so the package stays
+ * liftable into a repo that has never heard of `@12-apps/i18n`.
+ */
+type LocalePack<T> = { readonly "pt-BR": T; readonly "en-US": T };
+
+export const AI_HOST_GUIDES = {
+  "pt-BR": PT_BR_AI_HOST_GUIDES,
+  "en-US": EN_US_AI_HOST_GUIDES,
+} as const satisfies LocalePack<(platformName: string) => readonly AiHostGuide[]>;
+
+export const AI_CONNECT_PROMPT = {
+  "pt-BR": PT_BR_AI_CONNECT_PROMPT,
+  "en-US": EN_US_AI_CONNECT_PROMPT,
+} as const satisfies LocalePack<(spec: AiConnectPromptSpec) => string>;
+
+export const AI_CAPABILITIES = {
+  "pt-BR": PT_BR_AI_CAPABILITIES,
+  "en-US": EN_US_AI_CAPABILITIES,
+} as const satisfies LocalePack<readonly AiCapability[]>;
+
+export const AI_PERMISSION_MODEL = {
+  "pt-BR": PT_BR_AI_PERMISSION_MODEL,
+  "en-US": EN_US_AI_PERMISSION_MODEL,
+} as const satisfies LocalePack<AiPermissionModel>;

package/src/react/en-US.ts

@@ -0,0 +1,125 @@
+import { EN_US_CONFIRM_ACTION_COPY } from "@12-apps/ui/en-US";
+
+import type { McpAiCopy } from "./copy";
+
+/**
+ * The en-US pack for the AI-integration screens — a NAMED constant a host
+ * passes by hand, never a default.
+ *
+ * `statusBoard.confirmAction` composes `@12-apps/ui`'s own English pack rather
+ * than restating it, exactly as the pt-BR side composes the Portuguese one.
+ *
+ * The assistant NAMES (Claude, ChatGPT, Codex) are products, not words: they
+ * are spelled the same in every language, and `hostLabel` arrives as an
+ * argument so a sentence can place it where its own grammar wants.
+ */
+export const EN_US_MCP_AI_COPY: McpAiCopy = {
+  capabilities: {
+    heading: "What the assistant does for you",
+    subheading: "No spreadsheets, no clicking — just ask it in the chat.",
+  },
+  landing: {
+    eyebrow: "AI integration",
+    // Three fragments the heading renders around an emphasised middle, so the
+    // seam has to survive: "Connect / AI assistants / to your store".
+    titleLead: "Connect",
+    titleEmphasis: "AI assistants",
+    titleTail: "to your store",
+    lede:
+      "Let Claude, ChatGPT and other assistants answer questions about your menu, stock and " +
+      "orders — and take actions for you, right in the chat. Securely, with nothing to install.",
+    trust: [
+      // The `id`s are the package's own and are NOT words: the component keys
+      // its icons off them.
+      {
+        id: "login",
+        label: "Uses your own login",
+        caption: "No extra keys or credentials",
+      },
+      { id: "install", label: "Nothing to install", caption: "Connects in minutes" },
+      {
+        id: "permissions",
+        label: "Only what you can do",
+        caption: "Your permissions, nothing beyond them",
+      },
+      { id: "surface", label: "Browser or app", caption: "Claude, ChatGPT, Codex" },
+    ],
+    start: "Get started",
+  },
+  flow: {
+    steps: {
+      select: "Choose",
+      copyUrl: "Copy URL",
+      configure: "Configure",
+      connect: "Connect",
+      install: "Install",
+      confirm: "Confirm",
+    },
+    back: "Back",
+    next: "Next",
+    advance: "Continue",
+    finish: "Finish",
+    copyUrl: "Copy URL",
+    copied: "Copied",
+    copyMessage: "Copy message",
+    copyUrlTitle: "Copy your store's URL",
+    urlCaption:
+      "It is the only thing you paste into the assistant — copying it moves you to the next step.",
+    promptCaption:
+      "That is how it connects, identifies itself (Claude, ChatGPT…) and how we record the connection.",
+    askTitle: "Ask the assistant to connect",
+    installBody:
+      "Open your store's plugin, click Install and authorise access — no URL to copy, no credentials to generate.",
+    installAction: "Install the store plugin",
+    pasteTitle: "Paste this message into the assistant",
+    pasteInstallCaption:
+      "Paste it into the assistant so it connects, identifies itself and confirms access.",
+    connectedTo: (hostLabel) => `${hostLabel} is connected to your store.`,
+    waitingTitle: "Waiting for the connection",
+    waitingBody: (hostLabel) =>
+      `As soon as you authorise access in ${hostLabel}, it appears here automatically.`,
+    testNow: "Test it now",
+  },
+  statusBoard: {
+    instructions: "Instructions",
+    connected: "Connected",
+    notConnected: "Not connected yet",
+    connect: "Connect",
+    disconnect: "Disconnect",
+    disconnectTitle: "Disconnect this assistant?",
+    disconnectBody:
+      "It loses access to your store immediately. To use it again you will have to connect it afresh.",
+    disconnectConfirm: "Disconnect",
+    disconnectError: "Could not disconnect. Try again.",
+    boardTitle: "Connected assistants",
+    boardCaption:
+      "Green are the ones already working with your store; red are the ones still to connect.",
+    confirmAction: EN_US_CONFIRM_ACTION_COPY,
+  },
+  summary: {
+    activeNow: "active now",
+    activeMinutes: (minutes) => `active ${minutes} min ago`,
+    activeHours: (hours) => `active ${hours} h ago`,
+    activeDays: (days) => `active ${days} days ago`,
+    configured: "Integration configured",
+    connectedSuffix: "Connected",
+    connectedSeveral: (names) => `${names} connected`,
+    connectedGeneric: "AI connected",
+  },
+  hostSelect: {
+    heading: "Choose your assistant",
+    caption: "Pick where you use AI — the walkthrough is tailored to it.",
+  },
+  connectGuide: {
+    urlLabel: "Your store's server URL",
+    urlHint: "Copy this URL and paste it into your assistant to connect it to the store.",
+    // Ends mid-sentence: the screen renders a documentation link straight after.
+    moreInfo: "For more, see the",
+    connectOn: (hostLabel) => `Connect in ${hostLabel}`,
+  },
+  onboarding: {
+    title: "Connect AI assistants to your store",
+    editLabel: "Connect AI",
+    collapseLabel: "Hide",
+  },
+};

package/src/react/index.ts

@@ -47,6 +47,22 @@ export {
   PT_BR_AI_PERMISSION_MODEL,
 } from "../pt-BR";
 
+// The English twins and the tag-keyed records, re-exported beside them so a
+// screen reaching for the AI surface finds all of it on one subpath — which is
+// how the pt-BR names have always been reachable from here.
+export {
+  EN_US_AI_CAPABILITIES,
+  EN_US_AI_CONNECT_PROMPT,
+  EN_US_AI_HOST_GUIDES,
+  EN_US_AI_PERMISSION_MODEL,
+} from "../en-US";
+export {
+  AI_CAPABILITIES,
+  AI_CONNECT_PROMPT,
+  AI_HOST_GUIDES,
+  AI_PERMISSION_MODEL,
+} from "../locales";
+
 export type {
   AiCapabilitiesCopy,
   AiConnectGuideCopy,
@@ -60,3 +76,5 @@ export type {
   McpAiCopy,
 } from "./copy";
 export { PT_BR_MCP_AI_COPY } from "./pt-BR";
+export { EN_US_MCP_AI_COPY } from "./en-US";
+export { MCP_AI_COPY } from "./locales";

package/src/react/locales.ts

@@ -0,0 +1,17 @@
+import type { McpAiCopy } from "./copy";
+import { EN_US_MCP_AI_COPY } from "./en-US";
+import { PT_BR_MCP_AI_COPY } from "./pt-BR";
+
+/**
+ * The AI-integration screens in both languages, keyed by tag.
+ *
+ * `LocalePack` is mirrored here rather than imported so the package stays
+ * liftable into a repo that has never heard of `@12-apps/i18n`. The named
+ * single-language packs stay exported and unchanged.
+ */
+type LocalePack<T> = { readonly "pt-BR": T; readonly "en-US": T };
+
+export const MCP_AI_COPY = {
+  "pt-BR": PT_BR_MCP_AI_COPY,
+  "en-US": EN_US_MCP_AI_COPY,
+} as const satisfies LocalePack<McpAiCopy>;

package/dist/chunk-HRAQKMDC.js

@@ -1,154 +0,0 @@
-import {
-  __name
-} from "./chunk-7QVYU63E.js";
-
-// src/pt-BR.ts
-var CONNECTOR_TAIL = [
-  "Deixe OAuth Client ID e Client Secret em branco \u2014 n\xE3o \xE9 preciso gerar credenciais: a loja registra o conector automaticamente no primeiro acesso.",
-  "Confirme e clique em Connect: abre a tela de login da loja \u2014 entre com a SUA conta de lojista e autorize o acesso.",
-  "Pronto: ative o conector na conversa para o assistente consultar e operar a sua loja."
-];
-function chatgptConfigureStages(platformName) {
-  return [
-    {
-      id: "enable-dev-mode",
-      label: "enable developer mode",
-      link: {
-        url: "https://chatgpt.com/plugins#settings/Security",
-        label: "Abrir Seguran\xE7a e login"
-      },
-      steps: [
-        "Ative o Modo desenvolvedor em Settings \u203A Security and login (Seguran\xE7a e login)."
-      ]
-    },
-    {
-      id: "configurar",
-      label: "configurar",
-      link: {
-        url: "https://chatgpt.com/plugins#settings/Connectors?create-connector=true&redirectAfter=%2Fplugins",
-        label: "Criar o conector"
-      },
-      steps: [
-        "Isso vai abrir um popup para voc\xEA criar um plugin novo. Coloque como nome o nome da sua loja e, no campo MCP, o link copiado no passo anterior.",
-        'Marque a caixa "I understand and want to continue" \u2014 a OpenAI n\xE3o revisou este servidor MCP; ela avisa que sites podem tentar roubar seus dados ou induzir o modelo a a\xE7\xF5es indevidas, incluindo destruir dados.',
-        `Clique em "Sign in with ${platformName}" e entre com a sua conta de lojista para autorizar o acesso. Pronto: a conex\xE3o \xE9 registrada automaticamente.`
-      ]
-    }
-  ];
-}
-__name(chatgptConfigureStages, "chatgptConfigureStages");
-function PT_BR_AI_HOST_GUIDES(platformName) {
-  const chatgptStages = chatgptConfigureStages(platformName);
-  return [
-    {
-      id: "claude",
-      label: "Claude.ai",
-      brand: "claude",
-      kind: "No navegador",
-      link: {
-        url: "https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors",
-        label: "Abrir os conectores do Claude"
-      },
-      docs: {
-        url: "https://support.anthropic.com/en/articles/11175166-how-do-i-connect-mcp-servers-to-claude-ai",
-        label: "documenta\xE7\xE3o oficial da Anthropic \u2014 conectores personalizados"
-      },
-      steps: [
-        "Clique no bot\xE3o acima (ou v\xE1 em Settings \u203A Customize \u203A Connectors) e escolha Add custom connector.",
-        "D\xEA 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.",
-        ...CONNECTOR_TAIL
-      ]
-    },
-    {
-      id: "claude-desktop",
-      label: "Claude Desktop",
-      brand: "claude",
-      kind: "Aplicativo (Windows/Mac)",
-      docs: {
-        url: "https://support.anthropic.com/en/articles/11175166-how-do-i-connect-mcp-servers-to-claude-ai",
-        label: "documenta\xE7\xE3o oficial da Anthropic \u2014 conectores personalizados"
-      },
-      steps: [
-        "Abra o Claude Desktop e v\xE1 em Settings (\u2699\uFE0F) \u203A Connectors.",
-        "Clique em Add custom connector e cole a URL do servidor MCP da sua loja (copie acima).",
-        ...CONNECTOR_TAIL
-      ]
-    },
-    {
-      id: "chatgpt",
-      label: "ChatGPT",
-      brand: "openai",
-      kind: "No navegador",
-      link: {
-        url: "https://chatgpt.com/plugins",
-        label: "Abrir os plugins do ChatGPT"
-      },
-      docs: {
-        url: "https://developers.openai.com/apps-sdk/deploy/connect-chatgpt",
-        label: "documenta\xE7\xE3o oficial da OpenAI \u2014 conectar um servidor MCP ao ChatGPT"
-      },
-      configureStages: chatgptStages,
-      // Mirrors the flattened stage instructions so the MCP connect guide
-      // (`connectToChatGpt`) can never drift from what owners see in the wizard.
-      steps: chatgptStages.flatMap((stage) => stage.steps)
-    },
-    {
-      id: "codex",
-      label: "Codex",
-      brand: "openai",
-      kind: "App / CLI de desenvolvedor",
-      link: {
-        url: "https://developers.openai.com/codex",
-        label: "Documenta\xE7\xE3o do Codex"
-      },
-      docs: {
-        url: "https://developers.openai.com/apps-sdk/deploy/connect-chatgpt",
-        label: "documenta\xE7\xE3o oficial da OpenAI \u2014 conectar um servidor MCP"
-      },
-      steps: [
-        "No Codex, abra as configura\xE7\xF5es de MCP (Settings \u203A MCP no app, ou o arquivo de configura\xE7\xE3o na CLI).",
-        "Adicione um servidor MCP e cole a URL do servidor MCP da sua loja (copie acima) como um conector remoto (HTTP).",
-        ...CONNECTOR_TAIL
-      ]
-    }
-  ];
-}
-__name(PT_BR_AI_HOST_GUIDES, "PT_BR_AI_HOST_GUIDES");
-var PT_BR_AI_CAPABILITIES = [
-  {
-    id: "orders",
-    title: "Acompanhe seus pedidos",
-    detail: '"Quais pedidos entraram hoje?"'
-  },
-  {
-    id: "inventory",
-    title: "Controle o estoque",
-    detail: '"Quanto ainda tenho do produto X? Registre a entrada de 20 unidades."'
-  },
-  {
-    id: "catalog",
-    title: "Gerencie o cat\xE1logo",
-    detail: "Crie e edite produtos e categorias conversando."
-  },
-  {
-    id: "sales",
-    title: "Entenda suas vendas",
-    detail: '"Qual foi o faturamento da semana?"'
-  }
-];
-var PT_BR_AI_PERMISSION_MODEL = "O assistente age em seu nome, com exatamente as suas permiss\xF5es: ele pode fazer o que voc\xEA pode fazer na sua loja \u2014 nada al\xE9m disso. N\xE3o \xE9 preciso criar nenhuma chave ou credencial extra; a autoriza\xE7\xE3o usa o seu pr\xF3prio login.";
-function PT_BR_AI_CONNECT_PROMPT(spec) {
-  return `Voc\xEA agora tem acesso ao conector MCP da minha loja. Fa\xE7a, nesta ordem:
-1) Execute a ferramenta ${spec.announceTool} informando qual assistente voc\xEA \xE9 (host: "chatgpt", "claude" ou "codex") para registrar a conex\xE3o com a minha loja.
-2) Execute a ferramenta ${spec.probeTool} para confirmar o acesso a ${spec.probeSubject}.
-Se precisar do identificador da loja, me pergunte o ${spec.identifierName}.`;
-}
-__name(PT_BR_AI_CONNECT_PROMPT, "PT_BR_AI_CONNECT_PROMPT");
-
-export {
-  PT_BR_AI_HOST_GUIDES,
-  PT_BR_AI_CAPABILITIES,
-  PT_BR_AI_PERMISSION_MODEL,
-  PT_BR_AI_CONNECT_PROMPT
-};
-//# sourceMappingURL=chunk-HRAQKMDC.js.map

package/dist/chunk-HRAQKMDC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/pt-BR.ts"],"sourcesContent":["import type {\n  AiCapability,\n  AiConnectPromptSpec,\n  AiHostConfigureStage,\n  AiHostGuide,\n  AiPermissionModel,\n} from \"./guide\";\n\n/**\n * The pt-BR pack for the AI-integration surface — NAMED constants a host passes\n * by hand, never defaults (FUT-760).\n *\n * The filename is what exempts this file from the copy-portability gate:\n * Portuguese may ship, it may not be silent. Every sentence here is VERBATIM\n * what `guide.ts` used to compile in, so a host adopting it sees no change on\n * screen — what changes is that the walkthrough is chosen in a diff.\n *\n * The guides are DATA as much as copy: which assistants are offered, their\n * stage ids and brands. Both halves travel together because a step label and\n * the stage it labels are useless apart.\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 PT_BR_AI_HOST_GUIDES(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 const PT_BR_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 PT_BR_AI_PERMISSION_MODEL: AiPermissionModel =\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 pt-BR paste-in prompt, built from the host's own tool names. */\nexport function PT_BR_AI_CONNECT_PROMPT(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":";;;;;AAsBA,IAAM,iBAAoC;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF;AAQA,SAAS,uBACP,cACiC;AACjC,SAAO;AAAA,IACL;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,OAAO;AAAA,MACT;AAAA,MACA,OAAO;AAAA,QACL;AAAA,MACF;AAAA,IACF;AAAA,IACA;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,OAAO;AAAA,MACT;AAAA,MACA,OAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,2BAA2B,YAAY;AAAA,MACzC;AAAA,IACF;AAAA,EACF;AACF;AA7BS;AA0CF,SAAS,qBAAqB,cAA8C;AACjF,QAAM,gBAAgB,uBAAuB,YAAY;AACzD,SAAO;AAAA,IACL;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,OAAO;AAAA,MACP,MAAM;AAAA,MACN,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,OAAO;AAAA,MACT;AAAA,MACA,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,OAAO;AAAA,MACT;AAAA,MACA,OAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,GAAG;AAAA,MACL;AAAA,IACF;AAAA,IACA;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,OAAO;AAAA,MACP,MAAM;AAAA,MACN,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,OAAO;AAAA,MACT;AAAA,MACA,OAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,GAAG;AAAA,MACL;AAAA,IACF;AAAA,IACA;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,OAAO;AAAA,MACP,MAAM;AAAA,MACN,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,OAAO;AAAA,MACT;AAAA,MACA,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,OACE;AAAA,MACJ;AAAA,MACA,iBAAiB;AAAA;AAAA;AAAA,MAGjB,OAAO,cAAc,QAAQ,CAAC,UAAU,MAAM,KAAK;AAAA,IACrD;AAAA,IACA;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,OAAO;AAAA,MACP,MAAM;AAAA,MACN,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,OAAO;AAAA,MACT;AAAA,MACA,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,OAAO;AAAA,MACT;AAAA,MACA,OAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,GAAG;AAAA,MACL;AAAA,IACF;AAAA,EACF;AACF;AA5EgB;AA8ET,IAAM,wBAAiD;AAAA,EAC5D;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,EACV;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QACE;AAAA,EACJ;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,EACV;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,EACV;AACF;AAOO,IAAM,4BACX;AAGK,SAAS,wBAAwB,MAAmC;AACzE,SACE;AAAA,0BAC2B,KAAK,YAAY;AAAA,0BACjB,KAAK,SAAS,8BAA8B,KAAK,YAAY;AAAA,sDACjC,KAAK,cAAc;AAE9E;AAPgB;","names":[]}

package/dist/pt-BR-e1RnV2v8.d.ts

@@ -1,25 +0,0 @@
-import { A as AiCapability, b as AiConnectPromptSpec, e as AiHostGuide, i as AiPermissionModel } from './guide-KQNcXlMG.js';
-
-/**
- * The AI hosts a store owner can connect, in recommended order. Same OAuth flow
- * everywhere (the host drives it) — only the menu path differs per app.
- *
- * A FUNCTION of the platform's name, because one step is not generic: the
- * ChatGPT connector's consent screen shows an OAuth button labelled with
- * whoever operates the server, and the owner is told which button to click. It
- * used to name one particular STORE on one particular deployment — not even the
- * product, a tenant of it — so every other adopter instructed its owners to
- * click a button that does not exist.
- */
-declare function PT_BR_AI_HOST_GUIDES(platformName: string): readonly AiHostGuide[];
-declare const PT_BR_AI_CAPABILITIES: readonly AiCapability[];
-/**
- * The permission model in one line, shown prominently: the assistant acts AS
- * the signed-in owner (auth-passthrough) — it can do exactly what the owner
- * can, nothing more, and no extra credential/API key is ever created.
- */
-declare const PT_BR_AI_PERMISSION_MODEL: AiPermissionModel;
-/** The pt-BR paste-in prompt, built from the host's own tool names. */
-declare function PT_BR_AI_CONNECT_PROMPT(spec: AiConnectPromptSpec): string;
-
-export { PT_BR_AI_CAPABILITIES as P, PT_BR_AI_CONNECT_PROMPT as a, PT_BR_AI_HOST_GUIDES as b, PT_BR_AI_PERMISSION_MODEL as c };