curador-de-biblioteca

Reutilize ativos que já existem na Biblioteca OD do usuário — imagens capturadas com o OD Clipper, uploads manuais, mídia gerada por agente e material do sistema de design — sem pedir ao usuário para reenviá-los.

Quando usar

• O usuário referencia um ativo que já possui ("a captura de tela que eu recortei", "meu logotipo", "aquela imagem principal de antes").
• Você precisa de uma imagem para a página que está construindo e o usuário prefere sua própria biblioteca em vez de mídia recém-gerada.

Ferramentas (trilha tool-token)

Ambos os endpoints autenticam com o token da ferramenta da execução (OD_TOOL_TOKEN, injetado pelo daemon) e operam no projeto ao qual a execução pertence.

Pesquisar

POST /api/tools/library/search

{ "query": "blue hero background", "kind": "image", "limit": 20 }

Retorna { "results": [{ "asset": { "id": "...", "kind": "image", "sourceTitle": "...", "width": 1600, "height": 900, "sources": [...] }, "score": 0 }], "semantic": false }.

semantic: false significa correspondência de palavra-chave/metadados (nenhum modelo de incorporação configurado). Filtre e classifique os resultados você mesmo a partir dos metadados do ativo.

Aplicar

POST /api/tools/library/apply

{ "assetId": "<id from search>", "dir": "assets" }

Copia o ativo para o projeto (subdiretório padrão library/, ou o dir que você passar) e retorna { "relPath": "assets/<hash>.png" }. Referencie esse relPath do HTML/CSS que você escrever (por exemplo, <img src="assets/ab12cd34ef.png">).

Receita

1. Pesquise com uma consulta precisa para o tipo que você precisa.
2. Escolha o melhor resultado por dimensões / título / origem.
3. Aplique-o para obter um caminho relativo ao projeto.
4. Conecte esse caminho ao artefato que você está editando.

Se a pesquisa não retornar nada, recorra à geração de mídia em vez de adivinhar um caminho — nunca invente um relPath que apply não retornou.