@meistrari/chat-ui-lang 0.3.0 → 0.4.0

package/dist/index.js

@@ -0,0 +1,935 @@
+// src/actions.ts
+import { defineAction } from "@openuidev/lang-core";
+import { z } from "zod";
+var CopyText = defineAction({
+  name: "CopyText",
+  description: "Copia um texto para a área de transferência do usuário.",
+  params: z.object({
+    text: z.string()
+  })
+});
+var actions = { CopyText };
+// src/answers.ts
+function formatQuestionAnswers(requestId, questions, answers) {
+  if (!requestId.trim() || questions.length === 0)
+    return null;
+  const lines = [];
+  for (const question of questions) {
+    const answer = Object.hasOwn(answers, question.id) ? answers[question.id] : undefined;
+    if (answer?.skipped) {
+      lines.push(`${question.title}: Pulada pelo usuário`);
+      continue;
+    }
+    const selected = question.options.filter((option) => answer?.selected.includes(option.id));
+    if (!selected.length || question.type === "single" && selected.length > 1)
+      return null;
+    lines.push(`${question.title}: ${selected.map((option) => option.label).join("; ")}`);
+  }
+  return `Respostas (${requestId.trim()}):
+${lines.join(`
+`)}`;
+}
+// src/components/actions.ts
+import { action } from "@openuidev/lang-core";
+import { z as z2 } from "zod";
+
+// src/define.ts
+import { defineComponent as defineLangComponent } from "@openuidev/lang-core";
+function defineUiComponent(config) {
+  return defineLangComponent({ ...config, component: null });
+}
+
+// src/components/actions.ts
+var Button = defineUiComponent({
+  name: "Button",
+  description: "Botão de ação. Com @ToAssistant envia uma mensagem como se o usuário tivesse digitado.",
+  props: z2.object({
+    label: z2.string(),
+    action: action().optional(),
+    variant: z2.enum(["primary", "secondary"]).optional().describe("Padrão secondary; no máximo um primary por grupo")
+  })
+});
+var Buttons = defineUiComponent({
+  name: "Buttons",
+  description: "Grupo horizontal de botões.",
+  props: z2.object({
+    buttons: z2.array(Button.ref).min(1).max(4)
+  })
+});
+// src/components/chart.ts
+import { z as z3 } from "zod";
+var Bar = defineUiComponent({
+  name: "Bar",
+  description: "Uma barra do gráfico.",
+  props: z3.object({
+    label: z3.string(),
+    value: z3.number().describe("Valor numérico usado para o tamanho da barra"),
+    display: z3.string().optional().describe('Valor formatado para exibir, ex: "R$ 1,2 mi"')
+  })
+});
+var BarChart = defineUiComponent({
+  name: "BarChart",
+  description: "Gráfico de barras horizontais para comparar até 8 valores da mesma unidade.",
+  props: z3.object({
+    title: z3.string(),
+    bars: z3.array(Bar.ref).min(2).max(8),
+    tone: z3.enum(["neutral", "positive", "negative"]).optional()
+  })
+});
+// src/components/chat.ts
+import { z as z4 } from "zod";
+var Option = defineUiComponent({
+  name: "Option",
+  description: "Uma alternativa de resposta.",
+  props: z4.object({
+    id: z4.string().describe("Identificador curto e único dentro da pergunta"),
+    label: z4.string(),
+    description: z4.string().optional().describe("Uma linha explicando a alternativa")
+  })
+});
+var Question = defineUiComponent({
+  name: "Question",
+  description: "Pergunta de múltipla escolha para o usuário. Entre 2 e 4 alternativas.",
+  props: z4.object({
+    id: z4.string(),
+    title: z4.string(),
+    options: z4.array(Option.ref).min(2).max(4),
+    multiple: z4.boolean().optional().describe("true permite marcar mais de uma alternativa")
+  })
+});
+var Questions = defineUiComponent({
+  name: "Questions",
+  description: "Bloco de perguntas de esclarecimento. As respostas voltam como uma mensagem do usuário. Use no máximo 3 perguntas e só quando a resposta depender delas.",
+  props: z4.object({
+    requestId: z4.string().describe('Identificador curto desta rodada de perguntas, ex: "q-prazos"'),
+    questions: z4.array(Question.ref).min(1).max(3)
+  })
+});
+var FileCard = defineUiComponent({
+  name: "FileCard",
+  description: "Cartão de um documento do vault, com preview e download.",
+  props: z4.object({
+    vaultRef: z4.string().describe("Referência vault:// do documento, exatamente como recebida"),
+    name: z4.string().describe("Nome exibido do arquivo")
+  })
+});
+var Citation = defineUiComponent({
+  name: "Citation",
+  description: "Chip de citação para um trecho de documento. Prefira citações inline no markdown; use este componente dentro de Card ou Stack quando a citação for o item em si.",
+  props: z4.object({
+    ref: z4.string().describe("Referência cite:// exatamente como recebida"),
+    label: z4.string().optional().describe("Texto curto exibido no chip")
+  })
+});
+var Image = defineUiComponent({
+  name: "Image",
+  description: "Imagem com legenda. Aceita referência vault:// de uma imagem gerada ou recebida, ou uma URL https pública.",
+  props: z4.object({
+    src: z4.string().describe("vault://... ou https://..., exatamente como recebida"),
+    alt: z4.string().describe("Descrição curta da imagem"),
+    caption: z4.string().optional()
+  })
+});
+// src/components/data.ts
+import { z as z5 } from "zod";
+var Metric = defineUiComponent({
+  name: "Metric",
+  description: "Um número de destaque com rótulo. Use para valores isolados, nunca para listas.",
+  props: z5.object({
+    label: z5.string().describe("O que o número representa"),
+    value: z5.string().describe('Valor já formatado, ex: "R$ 12.400,00"'),
+    delta: z5.string().optional().describe('Variação, ex: "+12%"'),
+    tone: z5.enum(["neutral", "positive", "negative"]).optional()
+  })
+});
+var Col = defineUiComponent({
+  name: "Col",
+  description: "Uma coluna de tabela: rótulo e a lista de valores, um por linha.",
+  props: z5.object({
+    label: z5.string(),
+    values: z5.array(z5.union([z5.string(), z5.number()])).describe("Um valor por linha, na mesma ordem em todas as colunas"),
+    align: z5.enum(["left", "right"]).optional().describe("right para números")
+  })
+});
+var Table = defineUiComponent({
+  name: "Table",
+  description: "Tabela orientada a colunas. Use para 3 ou mais linhas comparáveis.",
+  props: z5.object({
+    columns: z5.array(Col.ref).min(1),
+    caption: z5.string().optional()
+  })
+});
+// src/components/form.ts
+import { z as z6 } from "zod";
+var Input = defineUiComponent({
+  name: "Input",
+  description: "Campo de texto livre de uma linha.",
+  props: z6.object({
+    name: z6.string().describe("Identificador do campo dentro do formulário"),
+    label: z6.string(),
+    placeholder: z6.string().optional()
+  })
+});
+var Select = defineUiComponent({
+  name: "Select",
+  description: "Escolha única entre alternativas curtas.",
+  props: z6.object({
+    name: z6.string(),
+    label: z6.string(),
+    options: z6.array(z6.string()).min(2).max(8)
+  })
+});
+var Checkbox = defineUiComponent({
+  name: "Checkbox",
+  description: "Caixa de marcação sim/não.",
+  props: z6.object({
+    name: z6.string(),
+    label: z6.string()
+  })
+});
+var Form = defineUiComponent({
+  name: "Form",
+  description: "Formulário curto para coletar dados que faltam. Ao enviar, os valores voltam como uma mensagem do usuário.",
+  props: z6.object({
+    name: z6.string().describe('Identificador do formulário, ex: "dados-prazo"'),
+    fields: z6.array(z6.union([Input.ref, Select.ref, Checkbox.ref])).min(1).max(6),
+    submitLabel: z6.string().optional().describe('Padrão "Enviar"')
+  })
+});
+// src/components/layout.ts
+import { z as z8 } from "zod";
+
+// src/components/text.ts
+import { z as z7 } from "zod";
+var Markdown = defineUiComponent({
+  name: "Markdown",
+  description: "Texto em markdown. Use para qualquer prose dentro de um widget; suporta citações cite:// e links vault://.",
+  props: z7.object({
+    text: z7.string().describe("Conteúdo em markdown")
+  })
+});
+var Callout = defineUiComponent({
+  name: "Callout",
+  description: "Aviso destacado com tom. Use para alertas, prazos, ressalvas ou conclusões importantes.",
+  props: z7.object({
+    text: z7.string().describe("Conteúdo em markdown"),
+    tone: z7.enum(["info", "success", "warning", "error"]).optional().describe("Tom visual, padrão info"),
+    title: z7.string().optional()
+  })
+});
+
+// src/components/layout.ts
+var blockRef = z8.union([Markdown.ref, Callout.ref, Metric.ref, Table.ref, BarChart.ref, Buttons.ref, Form.ref, Questions.ref, FileCard.ref, Image.ref, Citation.ref]);
+var Card = defineUiComponent({
+  name: "Card",
+  description: "Cartão com borda que agrupa blocos relacionados. Não aninhe Card em Card.",
+  props: z8.object({
+    children: z8.array(blockRef).min(1),
+    title: z8.string().optional()
+  })
+});
+var Stack = defineUiComponent({
+  name: "Stack",
+  description: "Raiz do widget. Empilha blocos em coluna ou os distribui em linha.",
+  props: z8.object({
+    children: z8.array(z8.union([Card.ref, ...blockRef.options])).min(1),
+    direction: z8.enum(["column", "row"]).optional().describe("row só para Metric ou Card lado a lado")
+  })
+});
+var components = { Stack, Card, Markdown, Callout, Metric, Col, Table, Bar, BarChart, Button, Buttons, Input, Select, Checkbox, Form, Option, Question, Questions, FileCard, Image, Citation };
+// src/library.ts
+import { createLibrary } from "@openuidev/lang-core";
+var library = createLibrary({
+  root: "Stack",
+  components: Object.values(components),
+  actions: [CopyText],
+  componentGroups: [
+    {
+      name: "Layout",
+      components: ["Stack", "Card"],
+      notes: [
+        "- root é sempre Stack. Use Card só quando houver mais de um bloco relacionado.",
+        '- direction "row" apenas para Metric ou Card lado a lado, no máximo 3.'
+      ]
+    },
+    {
+      name: "Texto",
+      components: ["Markdown", "Callout"],
+      notes: [
+        "- Citações cite:// e links vault:// aparecem no markdown, em Markdown/Callout, ou nos props ref de Citation e vaultRef de FileCard. Nunca em labels, títulos ou valores de tabela."
+      ]
+    },
+    {
+      name: "Dados",
+      components: ["Metric", "Table", "Col", "BarChart", "Bar"],
+      notes: [
+        "- Table para 3 ou mais linhas comparáveis. Menos que isso, use markdown fora do widget.",
+        "- Cada Col tem exatamente o mesmo número de values. Declare cada Col como statement próprio.",
+        "- Metric só para valores isolados e já formatados. Nunca repita um valor da tabela como Metric.",
+        "- BarChart só para valores numéricos da mesma unidade; Bar.value é número puro e Bar.display é o texto formatado."
+      ]
+    },
+    {
+      name: "Documentos",
+      components: ["FileCard", "Image", "Citation"],
+      notes: [
+        "- Use FileCard para um arquivo gerado ou recebido que o usuário deve abrir, e Image para uma imagem que deve aparecer na resposta. Nunca invente referências vault://, cite:// ou URLs."
+      ]
+    },
+    {
+      name: "Perguntas e formulários",
+      components: ["Questions", "Question", "Option", "Form", "Input", "Select", "Checkbox"],
+      notes: [
+        "- Questions quando a resposta depender de uma escolha do usuário. Pergunte o mínimo; não pergunte o que já foi dito.",
+        "- Form quando faltarem dados concretos (datas, valores, nomes). Nunca combine Form e Questions no mesmo widget.",
+        "- Depois de um Questions ou Form, encerre a resposta: não responda o que ainda depende da resposta do usuário."
+      ]
+    },
+    {
+      name: "Ações",
+      components: ["Buttons", "Button"],
+      notes: [
+        '- Use Buttons para oferecer próximos passos concretos. Cada Button com @ToAssistant("mensagem") escrita na primeira pessoa, como o usuário diria.',
+        '- @CopyText("texto") para copiar um valor pronto, como um número de processo ou um trecho de petição.',
+        '- No máximo um Button com variant "primary".'
+      ]
+    }
+  ]
+});
+var componentNames = Object.keys(library.components);
+// src/profiles.ts
+import { createLibrary as createLibrary2 } from "@openuidev/lang-core";
+
+// src/version.ts
+var LIBRARY_VERSION = "0.4.0";
+var UI_LANG_FENCE = "openui-lang";
+
+// src/profiles.ts
+var UI_PROFILES = ["web", "slack"];
+var SLACK_UNSUPPORTED = ["BarChart", "Bar", "Form", "Input", "Select", "Checkbox", "Questions", "Question", "Option", "FileCard", "Image", "Citation"];
+var slackLibrary = createLibrary2({
+  root: "Stack",
+  components: Object.values(library.extend({ components: { remove: SLACK_UNSUPPORTED } }).components),
+  actions: [CopyText],
+  componentGroups: [
+    {
+      name: "Layout",
+      components: ["Stack", "Card"],
+      notes: [
+        "- root é sempre Stack. Use Card só quando houver mais de um bloco relacionado; o título do Card vira um cabeçalho.",
+        '- direction "row" apenas para Metric lado a lado, no máximo 3.'
+      ]
+    },
+    {
+      name: "Texto",
+      components: ["Markdown", "Callout"],
+      notes: [
+        "- Citações cite:// e links vault:// ficam no markdown fora do bloco ou em Markdown/Callout. Nunca em labels, títulos ou valores de tabela."
+      ]
+    },
+    {
+      name: "Dados",
+      components: ["Metric", "Table", "Col"],
+      notes: [
+        "- Table para 3 ou mais linhas comparáveis, no máximo uma por resposta. Menos que isso, use markdown fora do widget.",
+        "- Cada Col tem exatamente o mesmo número de values. Declare cada Col como statement próprio.",
+        "- Metric só para valores isolados e já formatados. Nunca repita um valor da tabela como Metric."
+      ]
+    },
+    {
+      name: "Ações",
+      components: ["Buttons", "Button"],
+      notes: [
+        '- Para pedir uma escolha, use Buttons com um Button por alternativa, cada um com @ToAssistant("mensagem") na primeira pessoa. Não há formulários nem perguntas de múltipla escolha.',
+        "- Depois de oferecer uma escolha, encerre a resposta: não responda o que ainda depende dela.",
+        '- @CopyText("texto") mostra um valor pronto para o usuário copiar, como um número de processo.',
+        '- No máximo um Button com variant "primary".'
+      ]
+    }
+  ]
+});
+var WEB_EXAMPLES = [
+  [
+    'Pergunta: "compare os prazos de recurso". Resposta com widget:',
+    "",
+    "Os prazos variam por tipo de recurso:",
+    "",
+    `\`\`\`${UI_LANG_FENCE}`,
+    "root = Stack([tbl, next])",
+    'tbl = Table([tipo, prazo, base], "Prazos recursais")',
+    'tipo = Col("Recurso", ["Apelação", "Agravo", "Embargos"])',
+    'prazo = Col("Prazo", ["15 dias", "15 dias", "5 dias"], "right")',
+    'base = Col("Base legal", ["CPC art. 1.003", "CPC art. 1.003", "CPC art. 1.023"])',
+    "next = Buttons([b1, b2])",
+    'b1 = Button("Detalhar a apelação", @ToAssistant("Detalhe os requisitos da apelação"), "primary")',
+    'b2 = Button("Ver contagem em dias úteis", @ToAssistant("Como conto esses prazos em dias úteis?"))',
+    "```",
+    "",
+    "Todos contados em dias úteis [cite://doc/123#p=4]."
+  ].join(`
+`)
+];
+var SLACK_EXAMPLES = [
+  [
+    'Pergunta: "qual recurso cabe contra a sentença?". Resposta com widget:',
+    "",
+    "Depende do que você quer contestar:",
+    "",
+    `\`\`\`${UI_LANG_FENCE}`,
+    "root = Stack([prazo, opcoes])",
+    'prazo = Callout("Os dois recursos contam o prazo em dias úteis a partir da intimação.", "warning", "Prazo")',
+    "opcoes = Buttons([a, b])",
+    'a = Button("Rever o mérito", @ToAssistant("Quero rever o mérito da sentença"), "primary")',
+    'b = Button("Esclarecer a decisão", @ToAssistant("Quero só esclarecer um ponto da sentença"))',
+    "```"
+  ].join(`
+`)
+];
+var profiles = {
+  web: { library, rules: [], examples: WEB_EXAMPLES },
+  slack: {
+    library: slackLibrary,
+    rules: ["A conversa acontece no Slack: prefira respostas curtas e no máximo um widget por resposta."],
+    examples: SLACK_EXAMPLES
+  }
+};
+// src/prompt.ts
+var PREAMBLE = `## Widgets na resposta
+
+Você responde em markdown normal. Quando parte da resposta ficar melhor como interface (tabela comparativa, números de destaque, aviso, próximos passos clicáveis), insira um bloco de código com a linguagem \`${UI_LANG_FENCE}\` contendo um programa OpenUI Lang. O bloco é renderizado como interface nativa no lugar do código; o texto fora do bloco continua markdown.
+
+Regras do envelope:
+- Zero ou mais blocos \`${UI_LANG_FENCE}\` por resposta, cada um com seu próprio \`root = Stack(...)\` na primeira linha.
+- Prose, citações cite:// e links vault:// ficam no markdown fora do bloco, ou dentro de Markdown/Callout.
+- Resposta curta ou puramente textual: nenhum bloco. A maioria das respostas não precisa de widget.
+- Nunca repita no markdown o que já está no widget, nem o contrário.
+- Dentro do bloco só OpenUI Lang: sem comentários, sem markdown solto, sem fences aninhados.`;
+var defaultPrompts = new Map;
+function prompt(options) {
+  if (options.additionalRules?.length)
+    return buildPrompt(options.profile, options.additionalRules);
+  let built = defaultPrompts.get(options.profile);
+  if (built === undefined) {
+    built = buildPrompt(options.profile, []);
+    defaultPrompts.set(options.profile, built);
+  }
+  return built;
+}
+function buildPrompt(profile, additionalRules) {
+  const definition = profiles[profile];
+  const rules = [...definition.rules, ...additionalRules];
+  return definition.library.prompt({
+    preamble: PREAMBLE,
+    examples: definition.examples,
+    inlineMode: false,
+    toolCalls: false,
+    bindings: false,
+    builtinFunctions: false,
+    ...rules.length ? { additionalRules: rules } : {}
+  });
+}
+// src/safe-url.ts
+var SAFE_PROTOCOLS = new Set(["https:", "http:", "mailto:"]);
+function isSafeUrl(url) {
+  if (!/^[a-z][a-z0-9+.-]*:/i.test(url))
+    return false;
+  try {
+    return SAFE_PROTOCOLS.has(new URL(url).protocol);
+  } catch {
+    return false;
+  }
+}
+// src/segments.ts
+var WIDGET_PENDING_TEXT = "Montando um widget…";
+var WIDGET_OPENER = new RegExp(`^[ \\t]{0,3}(\`\`\`|~~~)${UI_LANG_FENCE}(?![\\w-])`);
+var OPENER_TEXTS = [`\`\`\`${UI_LANG_FENCE}`, `~~~${UI_LANG_FENCE}`];
+var FENCE_OPENER = /^[ \t]{0,3}(`{3,}|~{3,})([^\n]*)$/;
+var FENCE_CLOSER = /^[ \t]{0,3}(`{3,}|~{3,})[ \t]*\r?$/;
+function openingFence(line) {
+  const match = FENCE_OPENER.exec(line);
+  if (!match || match[1][0] === "`" && match[2].includes("`"))
+    return null;
+  return { character: match[1][0], length: match[1].length };
+}
+function closesFence(line, fence) {
+  const match = FENCE_CLOSER.exec(line);
+  return !!match && match[1][0] === fence.character && match[1].length >= fence.length;
+}
+function closingLine(lines, opener, fence) {
+  const closer = fence === "```" ? /^[ \t]{0,3}```[ \t]*\r?$/ : /^[ \t]{0,3}~~~[ \t]*\r?$/;
+  for (let index = opener + 1;index < lines.length; index++) {
+    if (closer.test(lines[index]))
+      return index;
+  }
+  return -1;
+}
+function splitAnswer(content) {
+  const lines = content.split(`
+`);
+  const segments = [];
+  let markdown = [];
+  const flush = () => {
+    const text = markdown.join(`
+`).trim();
+    if (text)
+      segments.push({ kind: "markdown", text });
+    markdown = [];
+  };
+  let fence = null;
+  let index = 0;
+  while (index < lines.length) {
+    const line = lines[index];
+    if (fence) {
+      fence = closesFence(line, fence) ? null : fence;
+      markdown.push(line);
+      index++;
+      continue;
+    }
+    const opener = WIDGET_OPENER.exec(line);
+    if (!opener) {
+      fence = openingFence(line);
+      markdown.push(line);
+      index++;
+      continue;
+    }
+    flush();
+    const end = closingLine(lines, index, opener[1]);
+    segments.push({ kind: "widget", code: lines.slice(index + 1, end === -1 ? lines.length : end).join(`
+`), complete: end !== -1 });
+    index = end === -1 ? lines.length : end + 1;
+  }
+  flush();
+  return segments;
+}
+function mayOpenWidget(line) {
+  const rest = line.replace(/^[ \t]{0,3}/, "");
+  return line.length > 0 && (WIDGET_OPENER.test(line) || OPENER_TEXTS.some((opener) => opener.startsWith(rest)));
+}
+function maskWidgets(content, placeholder = WIDGET_PENDING_TEXT) {
+  const lines = content.split(`
+`);
+  const shown = [];
+  let fence = null;
+  let index = 0;
+  while (index < lines.length) {
+    const line = lines[index];
+    if (fence) {
+      fence = closesFence(line, fence) ? null : fence;
+      shown.push(line);
+      index++;
+      continue;
+    }
+    if (index === lines.length - 1 && mayOpenWidget(line))
+      return shown.length ? `${shown.join(`
+`)}
+` : "";
+    const opener = WIDGET_OPENER.exec(line);
+    if (opener) {
+      shown.push(placeholder);
+      const end = closingLine(lines, index, opener[1]);
+      if (end === -1)
+        return shown.join(`
+`);
+      index = end + 1;
+      continue;
+    }
+    fence = openingFence(line);
+    shown.push(line);
+    index++;
+  }
+  return shown.join(`
+`);
+}
+// src/slack.ts
+import { createParser, evaluateElementProps } from "@openuidev/lang-core";
+import { z as z9 } from "zod";
+
+// src/widget-context.ts
+var WIDGET_CONTEXT_LIMIT = 2000;
+function formatWidgetContext(context, options = {}) {
+  if (context === undefined || context === null)
+    return "";
+  const limit = options.limit ?? WIDGET_CONTEXT_LIMIT;
+  let json;
+  try {
+    json = JSON.stringify(context).replace(/</g, "\\u003c").replace(/>/g, "\\u003e");
+  } catch (error) {
+    options.onDrop?.({ reason: "not-serialisable", error: error instanceof Error ? error.message : String(error) });
+    return "";
+  }
+  if (json.length > limit) {
+    options.onDrop?.({ reason: "too-large", length: json.length, limit });
+    return "";
+  }
+  return `
+
+<widget_context>${json}</widget_context>`;
+}
+
+// src/slack.ts
+var WIDGET_FAILED_TEXT = "Não foi possível mostrar um widget desta resposta.";
+var CALLOUT_LABELS = { info: "Nota", success: "Concluído", warning: "Atenção", error: "Erro" };
+var BUTTON_TEXT_LIMIT = 75;
+var BUTTON_VALUE_LIMIT = 2000;
+var BUTTON_URL_LIMIT = 3000;
+var HEADER_TEXT_LIMIT = 150;
+var SECTION_TEXT_LIMIT = 3000;
+var SECTION_FIELDS_LIMIT = 10;
+var FIELD_TEXT_LIMIT = 2000;
+var TABLE_ROWS_LIMIT = 100;
+var TABLE_COLUMNS_LIMIT = 20;
+var TABLE_CHARACTERS_LIMIT = 1e4;
+var schema = library.toJSONSchema();
+var parser = createParser(schema, library.root);
+function isSlackWidgetSendAction(actionId) {
+  return /^openui_send_\d{1,3}$/.test(actionId);
+}
+function isSlackWidgetLinkAction(actionId) {
+  return /^openui_link_\d{1,3}$/.test(actionId);
+}
+var actionValueSchema = z9.object({
+  t: z9.string().regex(/^\d+\.\d+$/),
+  m: z9.string().min(1)
+});
+function parseSlackWidgetAction(value) {
+  let decoded;
+  try {
+    decoded = JSON.parse(value);
+  } catch {
+    return null;
+  }
+  const parsed = actionValueSchema.safeParse(decoded);
+  return parsed.success ? { threadTs: parsed.data.t, message: parsed.data.m } : null;
+}
+function renderSlackAnswer(content, options) {
+  const segments = splitAnswer(content);
+  if (!segments.some((segment) => segment.kind === "widget"))
+    return null;
+  const state = { options, buttons: 0, tables: 0 };
+  const rendered = join(segments.map((segment) => segment.kind === "markdown" ? prose(segment.text, state) : widget(segment.code, segment.complete, state)));
+  return { text: rendered.text, blocks: fitting(rendered.blocks, options) ?? fitting(options.prose(rendered.text), options) ?? [] };
+}
+function fitting(blocks, options) {
+  return blocks.length <= options.maxBlocks ? blocks : null;
+}
+function widget(code, complete, state) {
+  if (!complete)
+    return note(WIDGET_PENDING_TEXT);
+  const root = evaluate(code);
+  const rendered = root ? node(root, state) : null;
+  return rendered?.blocks.length ? rendered : note(WIDGET_FAILED_TEXT);
+}
+function evaluate(code) {
+  try {
+    const result = parser.parse(code);
+    if (!result.root)
+      return null;
+    return evaluateElementProps(result.root, {
+      ctx: { getState: () => null, resolveRef: () => null, actions: schema.actions },
+      library,
+      store: null
+    });
+  } catch {
+    return null;
+  }
+}
+function isElement(value) {
+  return typeof value === "object" && value !== null && value.type === "element";
+}
+function children(value, typeName) {
+  return (Array.isArray(value) ? value : []).filter((item) => isElement(item) && (!typeName || item.typeName === typeName));
+}
+function text(value) {
+  return typeof value === "string" ? value : typeof value === "number" ? String(value) : "";
+}
+function limit(value, max) {
+  let result = "";
+  for (const character of value) {
+    if (result.length + character.length > max)
+      break;
+    result += character;
+  }
+  return result;
+}
+function escapeMrkdwn(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function join(parts) {
+  return { text: parts.map((part) => part.text).filter(Boolean).join(`
+
+`), blocks: parts.flatMap((part) => part.blocks) };
+}
+function note(value) {
+  return { text: value, blocks: [{ type: "context", elements: [{ type: "plain_text", text: value, emoji: false }] }] };
+}
+function prose(value, state) {
+  const trimmed = value.trim();
+  return trimmed ? { text: trimmed, blocks: state.options.prose(trimmed) } : { text: "", blocks: [] };
+}
+function node(element, state) {
+  switch (element.typeName) {
+    case "Stack":
+      return stack(children(element.props.children), state);
+    case "Card":
+      return card(element, state);
+    case "Markdown":
+      return prose(text(element.props.text), state);
+    case "Callout":
+      return callout(element, state);
+    case "Metric":
+      return metrics([element]);
+    case "Table":
+      return table(element, state);
+    case "Buttons":
+      return buttons(children(element.props.buttons, "Button"), state);
+    case "Button":
+      return buttons([element], state);
+    default:
+      return prose(describe(element), state);
+  }
+}
+function stack(items, state) {
+  const parts = [];
+  let run = [];
+  for (const item of items) {
+    if (item.typeName === "Metric") {
+      run.push(item);
+      continue;
+    }
+    if (run.length) {
+      parts.push(metrics(run));
+      run = [];
+    }
+    parts.push(node(item, state));
+  }
+  if (run.length)
+    parts.push(metrics(run));
+  return join(parts);
+}
+function card(element, state) {
+  const title = text(element.props.title);
+  const body = stack(children(element.props.children), state);
+  return {
+    text: [title, body.text].filter(Boolean).join(`
+
+`),
+    blocks: [
+      ...title ? [{ type: "header", text: { type: "plain_text", text: limit(title, HEADER_TEXT_LIMIT), emoji: false } }] : [],
+      ...body.blocks,
+      { type: "divider" }
+    ]
+  };
+}
+function callout(element, state) {
+  const tone = element.props.tone;
+  const title = text(element.props.title) || CALLOUT_LABELS[tone === "success" || tone === "warning" || tone === "error" ? tone : "info"];
+  const body = text(element.props.text).trim();
+  const quoted = [`**${title}**`, ...body.split(`
+`)].map((line) => `> ${line}`).join(`
+`);
+  return { text: `${title}: ${body}`, blocks: state.options.prose(quoted) };
+}
+function metrics(items) {
+  const fields = items.map((item) => {
+    const label = text(item.props.label);
+    const delta = text(item.props.delta);
+    const value = delta ? `${text(item.props.value)} (${delta})` : text(item.props.value);
+    return { line: `${label}: ${value}`, field: { type: "mrkdwn", text: limit(`*${escapeMrkdwn(label)}*
+${escapeMrkdwn(value)}`, FIELD_TEXT_LIMIT) } };
+  });
+  const blocks = [];
+  for (let start = 0;start < fields.length; start += SECTION_FIELDS_LIMIT)
+    blocks.push({ type: "section", fields: fields.slice(start, start + SECTION_FIELDS_LIMIT).map((item) => item.field) });
+  return { text: fields.map((item) => item.line).join(`
+`), blocks };
+}
+function table(element, state) {
+  const columns = children(element.props.columns, "Col").map((column) => ({
+    label: text(column.props.label),
+    values: (Array.isArray(column.props.values) ? column.props.values : []).map(text),
+    align: column.props.align === "right" ? "right" : "left"
+  }));
+  if (!columns.length)
+    return { text: "", blocks: [] };
+  const rowCount = Math.max(...columns.map((column) => column.values.length));
+  const rows = [columns.map((column) => column.label), ...Array.from({ length: rowCount }, (_, row) => columns.map((column) => column.values[row] ?? ""))];
+  const caption = text(element.props.caption);
+  const written = [caption, tableMarkdown(columns, rows)].filter(Boolean).join(`
+
+`);
+  const cells = rows.map((row) => row.map((cell) => cell || "-"));
+  const characters = cells.flat().reduce((total, cell) => total + cell.length, 0);
+  if (state.tables > 0 || columns.length > TABLE_COLUMNS_LIMIT || rows.length > TABLE_ROWS_LIMIT || characters > TABLE_CHARACTERS_LIMIT)
+    return prose(written, state);
+  state.tables++;
+  return {
+    text: written,
+    blocks: [
+      ...caption ? [{ type: "section", text: { type: "plain_text", text: limit(caption, SECTION_TEXT_LIMIT), emoji: false } }] : [],
+      {
+        type: "table",
+        column_settings: columns.map((column) => ({ align: column.align, is_wrapped: true })),
+        rows: cells.map((row) => row.map((cell) => ({ type: "raw_text", text: cell })))
+      }
+    ]
+  };
+}
+function tableMarkdown(columns, rows) {
+  const cell = (value) => value.replace(/\|/g, "\\|").replace(/\n/g, " ");
+  const [header = [], ...body] = rows;
+  return [
+    `| ${header.map(cell).join(" | ")} |`,
+    `| ${columns.map((column) => column.align === "right" ? "---:" : "---").join(" | ")} |`,
+    ...body.map((row) => `| ${row.map(cell).join(" | ")} |`)
+  ].join(`
+`);
+}
+function buttonTarget(label, plan) {
+  const steps = plan?.steps ?? [];
+  if (!steps.length)
+    return { kind: "send", message: label, context: "" };
+  for (const step of steps) {
+    if (step.type === "continue_conversation")
+      return { kind: "send", message: step.message, context: formatWidgetContext(step.context) };
+    if (step.type === "open_url")
+      return /^https?:/i.test(step.url) && isSafeUrl(step.url) ? { kind: "link", url: step.url } : { kind: "none" };
+    if (step.type === "custom_action" && step.name === "CopyText" && typeof step.params.text === "string")
+      return { kind: "copy", text: step.params.text };
+  }
+  return { kind: "none" };
+}
+function buttonValue(threadTs, message) {
+  const value = JSON.stringify({ t: threadTs, m: message });
+  return value.length <= BUTTON_VALUE_LIMIT ? value : null;
+}
+function buttons(items, state) {
+  const elements = [];
+  const copies = [];
+  const plain = [];
+  const lines = [];
+  for (const item of items) {
+    const label = text(item.props.label);
+    if (!label)
+      continue;
+    const target = buttonTarget(label, item.props.action);
+    const buttonText = { type: "plain_text", text: limit(label, BUTTON_TEXT_LIMIT), emoji: false };
+    const style = item.props.variant === "primary" ? { style: "primary" } : {};
+    if (target.kind === "send") {
+      const threadTs = state.options.threadTs;
+      const value = threadTs ? buttonValue(threadTs, `${target.message}${target.context}`) : null;
+      lines.push(`• ${label}`);
+      if (value)
+        elements.push({ type: "button", action_id: `openui_send_${state.buttons++}`, text: buttonText, value, ...style });
+      else
+        plain.push(`• ${label}`);
+    } else if (target.kind === "link") {
+      lines.push(`• ${label}: ${target.url}`);
+      if (target.url.length <= BUTTON_URL_LIMIT)
+        elements.push({ type: "button", action_id: `openui_link_${state.buttons++}`, text: buttonText, url: target.url, ...style });
+      else
+        plain.push(`• ${label}: ${target.url}`);
+    } else if (target.kind === "copy") {
+      lines.push(`• ${label}: ${target.text}`);
+      const section = `*${escapeMrkdwn(label)}*
+\`${escapeMrkdwn(target.text)}\``;
+      if (section.length <= SECTION_TEXT_LIMIT)
+        copies.push({ type: "section", text: { type: "mrkdwn", text: section } });
+      else
+        plain.push(`• ${label}: ${target.text}`);
+    } else {
+      lines.push(`• ${label}`);
+      plain.push(`• ${label}`);
+    }
+  }
+  return {
+    text: lines.join(`
+`),
+    blocks: [
+      ...elements.length ? [{ type: "actions", elements }] : [],
+      ...copies,
+      ...plain.length ? state.options.prose(plain.join(`
+`)) : []
+    ]
+  };
+}
+function markdownLink(label, target, scheme) {
+  return scheme.test(target) && /^[^\s<>"'()]+$/.test(target) ? `[${label.replace(/[\\[\]]/g, "\\$&")}](${target})` : label;
+}
+function describe(element) {
+  const props = element.props;
+  switch (element.typeName) {
+    case "BarChart":
+      return [`**${text(props.title)}**`, ...children(props.bars, "Bar").map((bar) => `- ${text(bar.props.label)}: ${text(bar.props.display) || text(bar.props.value)}`)].join(`
+`);
+    case "Questions":
+      return [
+        ...children(props.questions, "Question").map((question) => [`**${text(question.props.title)}**`, ...children(question.props.options, "Option").map((option) => `- ${text(option.props.label)}`)].join(`
+`)),
+        "Responda nesta conversa."
+      ].join(`
+
+`);
+    case "Form": {
+      const fields = children(props.fields).map((field) => {
+        const options = field.typeName === "Select" && Array.isArray(field.props.options) ? field.props.options.map(text).filter(Boolean) : [];
+        return options.length ? `${text(field.props.label)} (${options.join(", ")})` : text(field.props.label);
+      }).filter(Boolean);
+      return fields.length ? `Para continuar, responda com: ${fields.join(", ")}.` : "";
+    }
+    case "FileCard":
+      return markdownLink(text(props.name), text(props.vaultRef), /^vault:\/\//);
+    case "Image":
+      return markdownLink(text(props.alt) || "Imagem", text(props.src), /^(?:https:|vault:)\/\//);
+    case "Citation":
+      return markdownLink(text(props.label) || "fonte", text(props.ref), /^cite:\/\//);
+    case "Col":
+      return [`**${text(props.label)}**`, ...(Array.isArray(props.values) ? props.values : []).map((value) => `- ${text(value)}`)].join(`
+`);
+    default:
+      return "";
+  }
+}
+export {
+  Bar,
+  BarChart,
+  Button,
+  Buttons,
+  Callout,
+  Card,
+  Checkbox,
+  Citation,
+  Col,
+  CopyText,
+  FileCard,
+  Form,
+  Image,
+  Input,
+  LIBRARY_VERSION,
+  Markdown,
+  Metric,
+  Option,
+  Question,
+  Questions,
+  Select,
+  Stack,
+  Table,
+  UI_LANG_FENCE,
+  UI_PROFILES,
+  WIDGET_PENDING_TEXT,
+  actions,
+  componentNames,
+  components,
+  defineUiComponent,
+  formatQuestionAnswers,
+  formatWidgetContext,
+  isSafeUrl,
+  isSlackWidgetLinkAction,
+  isSlackWidgetSendAction,
+  library,
+  maskWidgets,
+  parseSlackWidgetAction,
+  profiles,
+  prompt,
+  renderSlackAnswer,
+  splitAnswer
+};