@softize/opus 24.0.1 → 24.1.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 `opus copy --check` · `base copy check` · `manifest:check`) — eles apontam o que a
 mudança cobra do seu código.
 
+## 24.1.0 — 2026-10-02
+
+O `Markdown` deixa de carregar imagem com endereço absoluto (`https:`, `http:` ou `//host`). No
+lugar dela fica o texto alternativo, num `span` com `data-slot="markdown-external-image"`, sem link.
+O conteúdo vem de modelo, e um `<img>` é buscado pelo navegador sem clique: um modelo induzido por
+injeção de prompt poderia levar dados da conversa no endereço da imagem (ADR 0050). Imagem com
+endereço relativo e as imagens `data:` que o markdown-it já aceitava continuam renderizando. A
+regra vale para a instância compartilhada, então chat, painéis e documentação mudam juntos. Quem
+exibia imagem absoluta da própria origem passa a usar o endereço relativo.
+
 ## 24.0.1 — 2026-10-01
 
 Em `DialogHeader` e `DrawerHeader` com navegação e título, os dois passam a formar um grupo com

package/docs/adr/0050-markdown-does-not-load-external-images.md

@@ -0,0 +1,64 @@
+# ADR 0050 — Markdown não carrega imagem externa
+
+- **Status:** aceita.
+- **Data:** 2026-10-02.
+- **Complementa:** a decisão registrada em `markdown.tsx` de renderizar com `html: false`, porque o
+  conteúdo vem de pessoas e de modelos.
+
+## Contexto
+
+O `Markdown` é o renderer único do pacote: o chat, os painéis e a documentação usam a mesma
+instância do markdown-it. Ele já escapa HTML do fonte e o markdown-it já recusa links
+`javascript:` e `data:text/html`. Faltava uma terceira via: `![](https://host/x.png?d=…)` virava um
+`<img>` que o navegador busca sozinho, sem nenhum clique.
+
+Isso importa porque boa parte desse conteúdo é escrita por um modelo. Um modelo induzido por
+injeção de prompt (um documento, uma resposta de ferramenta, uma mensagem de terceiro) pode montar
+o endereço de uma imagem com dados da conversa e deixar que o navegador de quem lê os entregue ao
+host. Num relatório salvo, isso acontece também com quem abre o relatório depois.
+
+Nenhum consumidor conhecido depende de imagem externa no Markdown: a documentação do pacote não usa
+imagem em Markdown, e a plataforma Grand Brasil não tem imagem externa em documentos, Base de
+conhecimento nem relatórios.
+
+## Decisão
+
+1. O `Markdown` não renderiza `<img>` para endereço absoluto, com esquema (`https:`, `http:`) ou
+   relativo ao protocolo (`//host`). No lugar da imagem fica o texto alternativo dela, num
+   `span` com `data-slot="markdown-external-image"`, sem link: seguir o endereço exigiria um
+   clique, mas um link montado pelo modelo não deve ser oferecido como se fosse da imagem.
+2. Endereço relativo (`/caminho`, `./arquivo.png`) continua renderizando a imagem, porque é servido
+   pela própria aplicação. As imagens em `data:` que o markdown-it já aceita (`png`, `gif`, `jpeg`,
+   `webp`) também continuam: não fazem requisição.
+3. A regra vale para a instância compartilhada `markdownIt`, então chat, painéis e documentação
+   seguem o mesmo comportamento. Não há opção para liberar imagem externa; um consumidor que
+   precise disso traz o caso concreto para uma decisão nova.
+
+## Consequências
+
+- Uma resposta ou um relatório com imagem externa mostra o texto alternativo no lugar da imagem.
+- A defesa não depende de cada aplicação configurar uma Content Security Policy com `img-src`,
+  embora uma CSP continue sendo uma segunda camada recomendada.
+- Imagem absoluta da própria origem também deixa de carregar. Não há uso conhecido; se aparecer,
+  o caminho é usar o endereço relativo.
+- A imagem relativa continua fazendo uma requisição à própria origem, com os cookies de quem lê. Se
+  a aplicação tiver um redirecionamento aberto ou um proxy de imagem, o mesmo vetor volta por ali.
+  É mais um motivo para manter a CSP com `img-src` como segunda camada.
+
+## Alternativas consideradas
+
+- **Bloquear toda imagem.** Fecharia também o resíduo da imagem relativa, mas tiraria imagens que a
+  própria aplicação serve (anexos, ilustrações de documentação) sem um vetor conhecido que o
+  justifique hoje.
+- **Transformar a imagem externa em link.** Mantém o endereço acessível, mas oferece com aparência
+  legítima um link montado pelo modelo; o texto alternativo basta para a leitura.
+- **Lista de origens permitidas ou proxy de imagem.** Exigiriam configuração por aplicação e um
+  serviço novo para um uso que não existe. Ficam para quando um consumidor trouxer o caso.
+- **Só CSP na aplicação.** Depende de cada consumidor configurar e não vale fora do navegador da
+  aplicação (por exemplo, na documentação publicada). Fica como segunda camada, não como a defesa.
+
+## Verificação
+
+- Teste do `Markdown`: imagem `https:`, `//host`, com maiúsculas, com esquema em entidade, por
+  referência, dentro de link e em célula de tabela não geram `<img>` e mostram o texto alternativo;
+  imagem relativa e `data:image/png` continuam gerando `<img>`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softize/opus",
-  "version": "24.0.1",
+  "version": "24.1.0",
   "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
   "license": "MIT",
   "type": "module",

package/src/ui/components/primitives/markdown.tsx

@@ -17,6 +17,23 @@ import MarkdownIt from 'markdown-it'
  *  opções próprias divergiriam no primeiro edge case, e "mesmo motor" viraria promessa. */
 export const markdownIt = new MarkdownIt({ html: false, linkify: true })
 
+/**
+ * Imagem com endereço absoluto não carrega (ADR 0050). O conteúdo vem de modelo, e um `<img>` é
+ * buscado pelo navegador sem clique: um modelo induzido por injeção de prompt poderia levar dados
+ * da conversa no endereço. Fica o texto alternativo; imagem relativa e `data:` seguem normais.
+ */
+const EXTERNAL_IMAGE = /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i
+const renderImage = markdownIt.renderer.rules.image
+markdownIt.renderer.rules.image = (tokens, idx, options, env, self) => {
+  const token = tokens[idx]!
+  const src = token.attrGet('src') ?? ''
+  if (EXTERNAL_IMAGE.test(src) && !src.toLowerCase().startsWith('data:')) {
+    const alt = self.renderInlineAsText(token.children ?? [], options, env)
+    return `<span data-slot="markdown-external-image">${markdownIt.utils.escapeHtml(alt)}</span>`
+  }
+  return renderImage!(tokens, idx, options, env, self)
+}
+
 export interface MarkdownProps {
   content: string
   className?: string