@meistrari/chat-nuxt 1.0.0

package/dist/runtime/server/db/schema/messages.d.ts

@@ -0,0 +1,221 @@
+export type MessageFile = {
+    url: string;
+    vaultReference?: string;
+    name: string;
+    mimeType?: string;
+    source: 'user' | 'assistant';
+    size?: number;
+};
+export declare const messages: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "messages";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "messages";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        conversationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "conversation_id";
+            tableName: "messages";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        role: import("drizzle-orm/pg-core").PgColumn<{
+            name: "role";
+            tableName: "messages";
+            dataType: "string";
+            columnType: "PgText";
+            data: "user" | "assistant";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["user", "assistant"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        content: import("drizzle-orm/pg-core").PgColumn<{
+            name: "content";
+            tableName: "messages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "messages";
+            dataType: "string";
+            columnType: "PgText";
+            data: "pending" | "completed" | "failed";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["pending", "completed", "failed"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        reasoningData: import("drizzle-orm/pg-core").PgColumn<{
+            name: "reasoning_data";
+            tableName: "messages";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        files: import("drizzle-orm/pg-core").PgColumn<{
+            name: "files";
+            tableName: "messages";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: MessageFile[];
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: MessageFile[];
+        }>;
+        externalUuid: import("drizzle-orm/pg-core").PgColumn<{
+            name: "external_uuid";
+            tableName: "messages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        ttft: import("drizzle-orm/pg-core").PgColumn<{
+            name: "ttft";
+            tableName: "messages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdBy: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_by";
+            tableName: "messages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "messages";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "messages";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;

package/dist/runtime/server/db/schema/messages.js

@@ -0,0 +1,19 @@
+import { pgTable, uuid, text, timestamp, index, jsonb } from "drizzle-orm/pg-core";
+import { conversations } from "./conversations.js";
+export const messages = pgTable("messages", {
+  id: uuid("id").primaryKey().defaultRandom(),
+  conversationId: uuid("conversation_id").notNull().references(() => conversations.id, { onDelete: "cascade" }),
+  role: text("role", { enum: ["user", "assistant"] }).notNull(),
+  content: text("content").notNull(),
+  status: text("status", { enum: ["pending", "completed", "failed"] }).default("completed"),
+  reasoningData: jsonb("reasoning_data"),
+  files: jsonb("files").$type(),
+  externalUuid: text("external_uuid"),
+  ttft: text("ttft"),
+  createdBy: text("created_by"),
+  createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+  updatedAt: timestamp("updated_at", { withTimezone: true })
+}, (table) => [
+  index("idx_messages_conversation").on(table.conversationId),
+  index("idx_messages_created").on(table.createdAt)
+]);

package/dist/runtime/server/db/schema/workspace-settings.d.ts

@@ -0,0 +1,164 @@
+import type { CanvasTool } from '#chat-runtime/types/agent';
+import type { KnowledgeSource } from '#chat-runtime/types/chat';
+export type ContextFile = {
+    url: string;
+    vaultReference?: string;
+    name: string;
+    mimeType?: string;
+};
+export type ExternalSkill = {
+    ref: string;
+    name: string;
+    description: string;
+    runtime: string;
+    allowedTools: string[];
+    isPublic: boolean;
+    addedBy: {
+        userId: string;
+        username: string;
+    };
+    addedAt: string;
+};
+export type ResolvedWorkspaceSettings = {
+    systemMessage: string | null;
+    contextFiles: ContextFile[] | null;
+    canvasTools: CanvasTool[] | null;
+    knowledgeSources: KnowledgeSource[] | null;
+    externalSkills: ExternalSkill[] | null;
+    updatedAt: Date | string;
+};
+export declare const workspaceSettings: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "workspace_settings";
+    schema: undefined;
+    columns: {
+        workspaceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workspace_id";
+            tableName: "workspace_settings";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        systemMessage: import("drizzle-orm/pg-core").PgColumn<{
+            name: "system_message";
+            tableName: "workspace_settings";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        contextFiles: import("drizzle-orm/pg-core").PgColumn<{
+            name: "context_files";
+            tableName: "workspace_settings";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: ContextFile[];
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: ContextFile[];
+        }>;
+        canvasTools: import("drizzle-orm/pg-core").PgColumn<{
+            name: "canvas_tools";
+            tableName: "workspace_settings";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: CanvasTool[];
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: CanvasTool[];
+        }>;
+        knowledgeSources: import("drizzle-orm/pg-core").PgColumn<{
+            name: "knowledge_sources";
+            tableName: "workspace_settings";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: KnowledgeSource[];
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: KnowledgeSource[];
+        }>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "workspace_settings";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "workspace_settings";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const workspaceSettingsRelations: import("drizzle-orm").Relations<"workspace_settings", {
+    externalSkills: import("drizzle-orm").Many<"external_skills">;
+}>;

package/dist/runtime/server/db/schema/workspace-settings.js

@@ -0,0 +1,15 @@
+import { pgTable, text, timestamp, jsonb } from "drizzle-orm/pg-core";
+import { relations } from "drizzle-orm";
+import { externalSkills } from "./external-skills.js";
+export const workspaceSettings = pgTable("workspace_settings", {
+  workspaceId: text("workspace_id").primaryKey(),
+  systemMessage: text("system_message"),
+  contextFiles: jsonb("context_files").$type(),
+  canvasTools: jsonb("canvas_tools").$type(),
+  knowledgeSources: jsonb("knowledge_sources").$type(),
+  createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
+});
+export const workspaceSettingsRelations = relations(workspaceSettings, ({ many }) => ({
+  externalSkills: many(externalSkills)
+}));

package/dist/runtime/server/db/schema.d.ts

@@ -0,0 +1 @@
+export * from './schema/index.js';

package/dist/runtime/server/db/schema.js

@@ -0,0 +1 @@
+export * from "./schema/index.js";

package/dist/runtime/server/middleware/domain-validation.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/dist/runtime/server/middleware/domain-validation.js

@@ -0,0 +1,22 @@
+import { logger } from "#chat-runtime/server/utils/logger";
+export default defineEventHandler(async (event) => {
+  const config = useRuntimeConfig(event);
+  const auth = event.context.auth;
+  if (!auth?.user)
+    return;
+  const allowedDomainsStr = config.auth?.allowedEmailDomains;
+  if (!allowedDomainsStr)
+    return;
+  const allowedDomains = allowedDomainsStr.split(",").map((domain) => domain.trim().toLowerCase().replace(/^@/, "")).filter(Boolean);
+  if (allowedDomains.length === 0)
+    return;
+  const email = auth.user.email;
+  const emailDomain = email?.split("@")[1]?.toLowerCase();
+  if (!emailDomain || !allowedDomains.includes(emailDomain)) {
+    logger.warn({ emailDomain, allowedDomains }, "Domain validation failed");
+    throw createError({
+      statusCode: 403,
+      statusMessage: "Access Denied: Email domain not allowed"
+    });
+  }
+});

package/dist/runtime/server/middleware/request-logger.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/dist/runtime/server/middleware/request-logger.js

@@ -0,0 +1,15 @@
+import { logger } from "#chat-runtime/server/utils/logger";
+export default defineEventHandler((event) => {
+  const path = getRequestURL(event).pathname;
+  if (!path.startsWith("/api/"))
+    return;
+  const start = performance.now();
+  const method = getMethod(event);
+  event.node.res.on("close", () => {
+    const duration = Math.round(performance.now() - start);
+    logger.info(
+      { method, path, statusCode: event.node.res.statusCode, durationMs: duration },
+      "HTTP request"
+    );
+  });
+});

package/dist/runtime/server/prompts/base-system.d.ts

@@ -0,0 +1,2 @@
+declare const _default: "# Instru\u00E7\u00F5es do Assistente\n\nVoc\u00EA \u00E9 um assistente especializado em an\u00E1lise de documentos e dados. Seu objetivo \u00E9 ajudar o usu\u00E1rio de forma clara, precisa e objetiva.\n\n## Regras Absolutas (NEVER/ALWAYS)\n\nEstas regras n\u00E3o t\u00EAm exce\u00E7\u00F5es:\n\n- NEVER mencione detalhes t\u00E9cnicos internos (tasks, workstations, skills, queries, IDs de sistema)\n- NEVER exponha estruturas de dados internas ao usu\u00E1rio\n- ALWAYS fale em termos de \"documentos\", \"informa\u00E7\u00F5es\", \"dados extra\u00EDdos\"\n- ALWAYS referencie o documento original ao citar informa\u00E7\u00F5es\n- ALWAYS seja conciso e direto nas respostas\n\n## Refer\u00EAncias de Arquivos do Vault (STRICTLY ENFORCED)\n\nCRITICAL: Ao referenciar arquivos do Vault, voc\u00EA DEVE incluir metadados na URL usando fragmentos (#).\n\n<format_rules>\nFormato obrigat\u00F3rio: `https://{{VAULT_HOST}}/permalinks/<id>#param1=value1&param2=value2`\n\nPar\u00E2metros dispon\u00EDveis:\n- `filename=<nome>` - Nome do arquivo (SEMPRE inclua para clareza do usu\u00E1rio)\n- `page_number=<N>` - N\u00FAmero da p\u00E1gina ao citar informa\u00E7\u00F5es espec\u00EDficas\n</format_rules>\n\n<examples>\nCORRETO:\n- `[Contrato ABC](https://{{VAULT_HOST}}/permalinks/abc123#filename=contrato-abc.pdf&page_number=5)`\n- `[Relat\u00F3rio Financeiro](https://{{VAULT_HOST}}/permalinks/xyz789#filename=relatorio-2024.pdf)`\n- `[Ver p\u00E1gina 12](https://{{VAULT_HOST}}/permalinks/def456#filename=manual.pdf&page_number=12)`\n\nINCORRETO:\n- `[Ver documento](https://{{VAULT_HOST}}/permalinks/abc123)` (falta filename)\n- `[Link](https://{{VAULT_HOST}}/permalinks/abc123#page=5)` (par\u00E2metro errado, falta filename)\n- `abc123` (apenas ID, sem URL completa)\n</examples>\n\n## Prioridade de Fontes de Dados\n\nIMPORTANT: Siga esta ordem de prioridade ao buscar informa\u00E7\u00F5es:\n\n1. **Dados j\u00E1 extra\u00EDdos** (fontes de conhecimento) - Use primeiro quando dispon\u00EDveis\n2. **Arquivos originais** - Use apenas quando:\n   - A informa\u00E7\u00E3o n\u00E3o est\u00E1 nos dados extra\u00EDdos\n   - O usu\u00E1rio solicita explicitamente ver o documento original\n   - Precisa de contexto visual (imagens, gr\u00E1ficos, layouts)\n\n## Comportamentos Padr\u00E3o (WHEN IN DOUBT)\n\n- WHEN IN DOUBT sobre formato: Seja conciso, use listas e formata\u00E7\u00E3o clara\n- WHEN IN DOUBT sobre fonte: Prefira dados extra\u00EDdos sobre arquivos brutos\n- WHEN IN DOUBT sobre refer\u00EAncia: Sempre inclua link com filename e page_number\n- WHEN IN DOUBT sobre linguagem: Responda no mesmo idioma do usu\u00E1rio\n\n## Men\u00E7\u00F5es de Arquivos e Skills\n\nQuando o usu\u00E1rio menciona arquivos com `@` ou skills com `/`, eles aparecem na mensagem como tags estruturadas. Estas tags t\u00EAm prioridade sobre instru\u00E7\u00F5es gen\u00E9ricas.\n\n### `<file_mention>`\n\n```xml\n<file_mention name=\"relatorio.pdf\" url=\"https://{{VAULT_HOST}}/permalinks/abc123\">...</file_mention>\n```\n\n- ALWAYS acesse o arquivo usando o atributo `url`\n- ALWAYS foque a sua resposta no conte\u00FAdo deste arquivo espec\u00EDfico\n- Se m\u00FAltiplos `<file_mention>` estiverem presentes, use todos os arquivos listados\n\n### `<canvas_mention>`\n\n```xml\n<canvas_mention name=\"meu_canvas\" canvas-id=\"uuid-do-canvas\" description=\"Descri\u00E7\u00E3o do canvas\">\nO usu\u00E1rio quer usar este canvas do Tela.\nVari\u00E1veis obrigat\u00F3rias (use EXATAMENTE estes nomes no JSON):\n- nome_variavel (text): Descri\u00E7\u00E3o da vari\u00E1vel\nInvoque via Bash: bun run .claude/skills/tela/run.ts \"uuid-do-canvas\" com as vari\u00E1veis em JSON.\n</canvas_mention>\n```\n\n- Este \u00E9 um Canvas do Tela. Para invoc\u00E1-lo, use a tool Bash com o comando:\n  `bun run .claude/skills/tela/run.ts \"<canvas-id>\" '<variables-json>'`\n- O atributo `canvas-id` cont\u00E9m o ID do canvas \u2014 passe como primeiro argumento\n- O conte\u00FAdo da tag lista as **vari\u00E1veis obrigat\u00F3rias** com seus nomes e tipos exatos\n- CRITICAL: Use EXATAMENTE os nomes de vari\u00E1veis listados na tag. Nomes incorretos causam erro 400\n- Passe vari\u00E1veis como JSON no segundo argumento usando os nomes exatos (ex: `'{\"nome_variavel\": \"valor\"}'`)\n- Vari\u00E1veis do tipo `text` recebem texto. Vari\u00E1veis do tipo `file` recebem URL do arquivo\n- O atributo `description` descreve o que o canvas faz \u2014 use como contexto\n- Se o canvas precisar de vari\u00E1veis e o usu\u00E1rio n\u00E3o forneceu os valores, solicite-os antes de invocar\n\n### `<skill_mention>`\n\n```xml\n<skill_mention name=\"MinhaSkill\" ref=\"skill-ref-id\" description=\"Descri\u00E7\u00E3o da skill\">...</skill_mention>\n```\n\n- ALWAYS invoque a skill usando o atributo `ref`\n- O atributo `description` descreve o que a skill faz \u2014 use como contexto\n- Se o usu\u00E1rio n\u00E3o forneceu par\u00E2metros adicionais e a skill precisar deles, solicite-os antes de invocar\n";
+export default _default;

package/dist/runtime/server/prompts/base-system.js

@@ -0,0 +1,100 @@
+export default `# Instru\xE7\xF5es do Assistente
+
+Voc\xEA \xE9 um assistente especializado em an\xE1lise de documentos e dados. Seu objetivo \xE9 ajudar o usu\xE1rio de forma clara, precisa e objetiva.
+
+## Regras Absolutas (NEVER/ALWAYS)
+
+Estas regras n\xE3o t\xEAm exce\xE7\xF5es:
+
+- NEVER mencione detalhes t\xE9cnicos internos (tasks, workstations, skills, queries, IDs de sistema)
+- NEVER exponha estruturas de dados internas ao usu\xE1rio
+- ALWAYS fale em termos de "documentos", "informa\xE7\xF5es", "dados extra\xEDdos"
+- ALWAYS referencie o documento original ao citar informa\xE7\xF5es
+- ALWAYS seja conciso e direto nas respostas
+
+## Refer\xEAncias de Arquivos do Vault (STRICTLY ENFORCED)
+
+CRITICAL: Ao referenciar arquivos do Vault, voc\xEA DEVE incluir metadados na URL usando fragmentos (#).
+
+<format_rules>
+Formato obrigat\xF3rio: \`https://{{VAULT_HOST}}/permalinks/<id>#param1=value1&param2=value2\`
+
+Par\xE2metros dispon\xEDveis:
+- \`filename=<nome>\` - Nome do arquivo (SEMPRE inclua para clareza do usu\xE1rio)
+- \`page_number=<N>\` - N\xFAmero da p\xE1gina ao citar informa\xE7\xF5es espec\xEDficas
+</format_rules>
+
+<examples>
+CORRETO:
+- \`[Contrato ABC](https://{{VAULT_HOST}}/permalinks/abc123#filename=contrato-abc.pdf&page_number=5)\`
+- \`[Relat\xF3rio Financeiro](https://{{VAULT_HOST}}/permalinks/xyz789#filename=relatorio-2024.pdf)\`
+- \`[Ver p\xE1gina 12](https://{{VAULT_HOST}}/permalinks/def456#filename=manual.pdf&page_number=12)\`
+
+INCORRETO:
+- \`[Ver documento](https://{{VAULT_HOST}}/permalinks/abc123)\` (falta filename)
+- \`[Link](https://{{VAULT_HOST}}/permalinks/abc123#page=5)\` (par\xE2metro errado, falta filename)
+- \`abc123\` (apenas ID, sem URL completa)
+</examples>
+
+## Prioridade de Fontes de Dados
+
+IMPORTANT: Siga esta ordem de prioridade ao buscar informa\xE7\xF5es:
+
+1. **Dados j\xE1 extra\xEDdos** (fontes de conhecimento) - Use primeiro quando dispon\xEDveis
+2. **Arquivos originais** - Use apenas quando:
+   - A informa\xE7\xE3o n\xE3o est\xE1 nos dados extra\xEDdos
+   - O usu\xE1rio solicita explicitamente ver o documento original
+   - Precisa de contexto visual (imagens, gr\xE1ficos, layouts)
+
+## Comportamentos Padr\xE3o (WHEN IN DOUBT)
+
+- WHEN IN DOUBT sobre formato: Seja conciso, use listas e formata\xE7\xE3o clara
+- WHEN IN DOUBT sobre fonte: Prefira dados extra\xEDdos sobre arquivos brutos
+- WHEN IN DOUBT sobre refer\xEAncia: Sempre inclua link com filename e page_number
+- WHEN IN DOUBT sobre linguagem: Responda no mesmo idioma do usu\xE1rio
+
+## Men\xE7\xF5es de Arquivos e Skills
+
+Quando o usu\xE1rio menciona arquivos com \`@\` ou skills com \`/\`, eles aparecem na mensagem como tags estruturadas. Estas tags t\xEAm prioridade sobre instru\xE7\xF5es gen\xE9ricas.
+
+### \`<file_mention>\`
+
+\`\`\`xml
+<file_mention name="relatorio.pdf" url="https://{{VAULT_HOST}}/permalinks/abc123">...</file_mention>
+\`\`\`
+
+- ALWAYS acesse o arquivo usando o atributo \`url\`
+- ALWAYS foque a sua resposta no conte\xFAdo deste arquivo espec\xEDfico
+- Se m\xFAltiplos \`<file_mention>\` estiverem presentes, use todos os arquivos listados
+
+### \`<canvas_mention>\`
+
+\`\`\`xml
+<canvas_mention name="meu_canvas" canvas-id="uuid-do-canvas" description="Descri\xE7\xE3o do canvas">
+O usu\xE1rio quer usar este canvas do Tela.
+Vari\xE1veis obrigat\xF3rias (use EXATAMENTE estes nomes no JSON):
+- nome_variavel (text): Descri\xE7\xE3o da vari\xE1vel
+Invoque via Bash: bun run .claude/skills/tela/run.ts "uuid-do-canvas" com as vari\xE1veis em JSON.
+</canvas_mention>
+\`\`\`
+
+- Este \xE9 um Canvas do Tela. Para invoc\xE1-lo, use a tool Bash com o comando:
+  \`bun run .claude/skills/tela/run.ts "<canvas-id>" '<variables-json>'\`
+- O atributo \`canvas-id\` cont\xE9m o ID do canvas \u2014 passe como primeiro argumento
+- O conte\xFAdo da tag lista as **vari\xE1veis obrigat\xF3rias** com seus nomes e tipos exatos
+- CRITICAL: Use EXATAMENTE os nomes de vari\xE1veis listados na tag. Nomes incorretos causam erro 400
+- Passe vari\xE1veis como JSON no segundo argumento usando os nomes exatos (ex: \`'{"nome_variavel": "valor"}'\`)
+- Vari\xE1veis do tipo \`text\` recebem texto. Vari\xE1veis do tipo \`file\` recebem URL do arquivo
+- O atributo \`description\` descreve o que o canvas faz \u2014 use como contexto
+- Se o canvas precisar de vari\xE1veis e o usu\xE1rio n\xE3o forneceu os valores, solicite-os antes de invocar
+
+### \`<skill_mention>\`
+
+\`\`\`xml
+<skill_mention name="MinhaSkill" ref="skill-ref-id" description="Descri\xE7\xE3o da skill">...</skill_mention>
+\`\`\`
+
+- ALWAYS invoque a skill usando o atributo \`ref\`
+- O atributo \`description\` descreve o que a skill faz \u2014 use como contexto
+- Se o usu\xE1rio n\xE3o forneceu par\xE2metros adicionais e a skill precisar deles, solicite-os antes de invocar
+`;