@contractspec/lib.knowledge 2.4.0 → 2.6.0

package/dist/i18n/catalogs/index.js

@@ -0,0 +1,263 @@
+// @bun
+// src/i18n/catalogs/en.ts
+import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
+var enMessages = defineTranslation({
+  meta: {
+    key: "knowledge.messages",
+    version: "1.0.0",
+    domain: "knowledge",
+    description: "All user-facing and LLM-facing strings for the knowledge package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "en",
+  fallback: "en",
+  messages: {
+    "access.notBound": {
+      value: 'Knowledge space "{spaceKey}" is not bound in the resolved app config.',
+      description: "Denial reason when a knowledge space is not bound",
+      placeholders: [{ name: "spaceKey", type: "string" }]
+    },
+    "access.readOnly": {
+      value: 'Knowledge space "{spaceKey}" is category "{category}" and is read-only.',
+      description: "Denial reason when write is attempted on a read-only space",
+      placeholders: [
+        { name: "spaceKey", type: "string" },
+        { name: "category", type: "string" }
+      ]
+    },
+    "access.workflowUnauthorized": {
+      value: 'Workflow "{workflowName}" is not authorized to access knowledge space "{spaceKey}".',
+      description: "Denial reason when a workflow lacks space access",
+      placeholders: [
+        { name: "workflowName", type: "string" },
+        { name: "spaceKey", type: "string" }
+      ]
+    },
+    "access.agentUnauthorized": {
+      value: 'Agent "{agentName}" is not authorized to access knowledge space "{spaceKey}".',
+      description: "Denial reason when an agent lacks space access",
+      placeholders: [
+        { name: "agentName", type: "string" },
+        { name: "spaceKey", type: "string" }
+      ]
+    },
+    "access.ephemeralWarning": {
+      value: 'Knowledge space "{spaceKey}" is ephemeral; results may be transient.',
+      description: "Warning for ephemeral knowledge spaces",
+      placeholders: [{ name: "spaceKey", type: "string" }]
+    },
+    "query.systemPrompt": {
+      value: "You are a knowledge assistant that answers questions using the provided context. Cite relevant sources if possible.",
+      description: "Default LLM system prompt for knowledge queries"
+    },
+    "query.userMessage": {
+      value: `Question:
+{question}
+
+Context:
+{context}`,
+      description: "User message template combining question and context",
+      placeholders: [
+        { name: "question", type: "string" },
+        { name: "context", type: "string" }
+      ]
+    },
+    "query.noResults": {
+      value: "No relevant documents found.",
+      description: "Displayed when vector search returns zero results"
+    },
+    "query.sourceLabel": {
+      value: "Source {index} (score: {score}):",
+      description: "Label prefix for each source in the context block",
+      placeholders: [
+        { name: "index", type: "number" },
+        { name: "score", type: "string" }
+      ]
+    },
+    "ingestion.gmail.subject": {
+      value: "Subject: {subject}",
+      description: "Gmail thread subject label",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "ingestion.gmail.snippet": {
+      value: "Snippet: {snippet}",
+      description: "Gmail thread snippet label",
+      placeholders: [{ name: "snippet", type: "string" }]
+    },
+    "ingestion.gmail.from": {
+      value: "From: {from}",
+      description: "Gmail message sender label",
+      placeholders: [{ name: "from", type: "string" }]
+    },
+    "ingestion.gmail.to": {
+      value: "To: {to}",
+      description: "Gmail message recipients label",
+      placeholders: [{ name: "to", type: "string" }]
+    },
+    "ingestion.gmail.date": {
+      value: "Date: {date}",
+      description: "Gmail message date label",
+      placeholders: [{ name: "date", type: "string" }]
+    }
+  }
+});
+
+// src/i18n/catalogs/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation2({
+  meta: {
+    key: "knowledge.messages",
+    version: "1.0.0",
+    domain: "knowledge",
+    description: "All user-facing and LLM-facing strings for the knowledge package (French)",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "fr",
+  fallback: "en",
+  messages: {
+    "access.notBound": {
+      value: `L'espace de connaissances "{spaceKey}" n'est pas li\xE9 dans la configuration de l'application.`,
+      description: "Denial reason when a knowledge space is not bound"
+    },
+    "access.readOnly": {
+      value: `L'espace de connaissances "{spaceKey}" est de cat\xE9gorie "{category}" et est en lecture seule.`,
+      description: "Denial reason when write is attempted on a read-only space"
+    },
+    "access.workflowUnauthorized": {
+      value: `Le workflow "{workflowName}" n'est pas autoris\xE9 \xE0 acc\xE9der \xE0 l'espace de connaissances "{spaceKey}".`,
+      description: "Denial reason when a workflow lacks space access"
+    },
+    "access.agentUnauthorized": {
+      value: `L'agent "{agentName}" n'est pas autoris\xE9 \xE0 acc\xE9der \xE0 l'espace de connaissances "{spaceKey}".`,
+      description: "Denial reason when an agent lacks space access"
+    },
+    "access.ephemeralWarning": {
+      value: `L'espace de connaissances "{spaceKey}" est \xE9ph\xE9m\xE8re ; les r\xE9sultats peuvent \xEAtre transitoires.`,
+      description: "Warning for ephemeral knowledge spaces"
+    },
+    "query.systemPrompt": {
+      value: "Vous \xEAtes un assistant de connaissances qui r\xE9pond aux questions en utilisant le contexte fourni. Citez les sources pertinentes si possible.",
+      description: "Default LLM system prompt for knowledge queries"
+    },
+    "query.userMessage": {
+      value: `Question :
+{question}
+
+Contexte :
+{context}`,
+      description: "User message template combining question and context"
+    },
+    "query.noResults": {
+      value: "Aucun document pertinent trouv\xE9.",
+      description: "Displayed when vector search returns zero results"
+    },
+    "query.sourceLabel": {
+      value: "Source {index} (score : {score}) :",
+      description: "Label prefix for each source in the context block"
+    },
+    "ingestion.gmail.subject": {
+      value: "Objet : {subject}",
+      description: "Gmail thread subject label"
+    },
+    "ingestion.gmail.snippet": {
+      value: "Extrait : {snippet}",
+      description: "Gmail thread snippet label"
+    },
+    "ingestion.gmail.from": {
+      value: "De : {from}",
+      description: "Gmail message sender label"
+    },
+    "ingestion.gmail.to": {
+      value: "\xC0 : {to}",
+      description: "Gmail message recipients label"
+    },
+    "ingestion.gmail.date": {
+      value: "Date : {date}",
+      description: "Gmail message date label"
+    }
+  }
+});
+
+// src/i18n/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation3({
+  meta: {
+    key: "knowledge.messages",
+    version: "1.0.0",
+    domain: "knowledge",
+    description: "All user-facing and LLM-facing strings for the knowledge package (Spanish)",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "es",
+  fallback: "en",
+  messages: {
+    "access.notBound": {
+      value: 'El espacio de conocimiento "{spaceKey}" no est\xE1 vinculado en la configuraci\xF3n de la aplicaci\xF3n.',
+      description: "Denial reason when a knowledge space is not bound"
+    },
+    "access.readOnly": {
+      value: 'El espacio de conocimiento "{spaceKey}" es de categor\xEDa "{category}" y es de solo lectura.',
+      description: "Denial reason when write is attempted on a read-only space"
+    },
+    "access.workflowUnauthorized": {
+      value: 'El flujo de trabajo "{workflowName}" no est\xE1 autorizado para acceder al espacio de conocimiento "{spaceKey}".',
+      description: "Denial reason when a workflow lacks space access"
+    },
+    "access.agentUnauthorized": {
+      value: 'El agente "{agentName}" no est\xE1 autorizado para acceder al espacio de conocimiento "{spaceKey}".',
+      description: "Denial reason when an agent lacks space access"
+    },
+    "access.ephemeralWarning": {
+      value: 'El espacio de conocimiento "{spaceKey}" es ef\xEDmero; los resultados pueden ser transitorios.',
+      description: "Warning for ephemeral knowledge spaces"
+    },
+    "query.systemPrompt": {
+      value: "Eres un asistente de conocimiento que responde preguntas utilizando el contexto proporcionado. Cita las fuentes relevantes si es posible.",
+      description: "Default LLM system prompt for knowledge queries"
+    },
+    "query.userMessage": {
+      value: `Pregunta:
+{question}
+
+Contexto:
+{context}`,
+      description: "User message template combining question and context"
+    },
+    "query.noResults": {
+      value: "No se encontraron documentos relevantes.",
+      description: "Displayed when vector search returns zero results"
+    },
+    "query.sourceLabel": {
+      value: "Fuente {index} (puntuaci\xF3n: {score}):",
+      description: "Label prefix for each source in the context block"
+    },
+    "ingestion.gmail.subject": {
+      value: "Asunto: {subject}",
+      description: "Gmail thread subject label"
+    },
+    "ingestion.gmail.snippet": {
+      value: "Extracto: {snippet}",
+      description: "Gmail thread snippet label"
+    },
+    "ingestion.gmail.from": {
+      value: "De: {from}",
+      description: "Gmail message sender label"
+    },
+    "ingestion.gmail.to": {
+      value: "Para: {to}",
+      description: "Gmail message recipients label"
+    },
+    "ingestion.gmail.date": {
+      value: "Fecha: {date}",
+      description: "Gmail message date label"
+    }
+  }
+});
+export {
+  frMessages,
+  esMessages,
+  enMessages
+};

package/dist/i18n/i18n.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/i18n/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Internationalization (i18n) module for @contractspec/lib.knowledge.
+ *
+ * Provides multi-language support for all strings in the package:
+ * - Access guard denial/warning messages
+ * - LLM system prompts and query templates
+ * - Gmail ingestion formatting labels
+ *
+ * @module i18n
+ *
+ * @example
+ * ```ts
+ * import { createKnowledgeI18n, I18N_KEYS } from '@contractspec/lib.knowledge/i18n';
+ *
+ * const i18n = createKnowledgeI18n("fr");
+ * const msg = i18n.t("access.notBound", { spaceKey: "docs" });
+ * ```
+ */
+export { createKnowledgeI18n, getDefaultI18n, resetI18nRegistry, } from './messages';
+export type { KnowledgeI18n } from './messages';
+export { resolveLocale, isSupportedLocale, DEFAULT_LOCALE, SUPPORTED_LOCALES, } from './locale';
+export type { SupportedLocale } from './locale';
+export { I18N_KEYS, ACCESS_KEYS, QUERY_KEYS, INGESTION_KEYS } from './keys';
+export type { KnowledgeMessageKey } from './keys';
+export { enMessages } from './catalogs/en';
+export { frMessages } from './catalogs/fr';
+export { esMessages } from './catalogs/es';

package/dist/i18n/index.js

@@ -0,0 +1,321 @@
+// @bun
+// src/i18n/catalogs/en.ts
+import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
+var enMessages = defineTranslation({
+  meta: {
+    key: "knowledge.messages",
+    version: "1.0.0",
+    domain: "knowledge",
+    description: "All user-facing and LLM-facing strings for the knowledge package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "en",
+  fallback: "en",
+  messages: {
+    "access.notBound": {
+      value: 'Knowledge space "{spaceKey}" is not bound in the resolved app config.',
+      description: "Denial reason when a knowledge space is not bound",
+      placeholders: [{ name: "spaceKey", type: "string" }]
+    },
+    "access.readOnly": {
+      value: 'Knowledge space "{spaceKey}" is category "{category}" and is read-only.',
+      description: "Denial reason when write is attempted on a read-only space",
+      placeholders: [
+        { name: "spaceKey", type: "string" },
+        { name: "category", type: "string" }
+      ]
+    },
+    "access.workflowUnauthorized": {
+      value: 'Workflow "{workflowName}" is not authorized to access knowledge space "{spaceKey}".',
+      description: "Denial reason when a workflow lacks space access",
+      placeholders: [
+        { name: "workflowName", type: "string" },
+        { name: "spaceKey", type: "string" }
+      ]
+    },
+    "access.agentUnauthorized": {
+      value: 'Agent "{agentName}" is not authorized to access knowledge space "{spaceKey}".',
+      description: "Denial reason when an agent lacks space access",
+      placeholders: [
+        { name: "agentName", type: "string" },
+        { name: "spaceKey", type: "string" }
+      ]
+    },
+    "access.ephemeralWarning": {
+      value: 'Knowledge space "{spaceKey}" is ephemeral; results may be transient.',
+      description: "Warning for ephemeral knowledge spaces",
+      placeholders: [{ name: "spaceKey", type: "string" }]
+    },
+    "query.systemPrompt": {
+      value: "You are a knowledge assistant that answers questions using the provided context. Cite relevant sources if possible.",
+      description: "Default LLM system prompt for knowledge queries"
+    },
+    "query.userMessage": {
+      value: `Question:
+{question}
+
+Context:
+{context}`,
+      description: "User message template combining question and context",
+      placeholders: [
+        { name: "question", type: "string" },
+        { name: "context", type: "string" }
+      ]
+    },
+    "query.noResults": {
+      value: "No relevant documents found.",
+      description: "Displayed when vector search returns zero results"
+    },
+    "query.sourceLabel": {
+      value: "Source {index} (score: {score}):",
+      description: "Label prefix for each source in the context block",
+      placeholders: [
+        { name: "index", type: "number" },
+        { name: "score", type: "string" }
+      ]
+    },
+    "ingestion.gmail.subject": {
+      value: "Subject: {subject}",
+      description: "Gmail thread subject label",
+      placeholders: [{ name: "subject", type: "string" }]
+    },
+    "ingestion.gmail.snippet": {
+      value: "Snippet: {snippet}",
+      description: "Gmail thread snippet label",
+      placeholders: [{ name: "snippet", type: "string" }]
+    },
+    "ingestion.gmail.from": {
+      value: "From: {from}",
+      description: "Gmail message sender label",
+      placeholders: [{ name: "from", type: "string" }]
+    },
+    "ingestion.gmail.to": {
+      value: "To: {to}",
+      description: "Gmail message recipients label",
+      placeholders: [{ name: "to", type: "string" }]
+    },
+    "ingestion.gmail.date": {
+      value: "Date: {date}",
+      description: "Gmail message date label",
+      placeholders: [{ name: "date", type: "string" }]
+    }
+  }
+});
+
+// src/i18n/catalogs/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation2({
+  meta: {
+    key: "knowledge.messages",
+    version: "1.0.0",
+    domain: "knowledge",
+    description: "All user-facing and LLM-facing strings for the knowledge package (French)",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "fr",
+  fallback: "en",
+  messages: {
+    "access.notBound": {
+      value: `L'espace de connaissances "{spaceKey}" n'est pas li\xE9 dans la configuration de l'application.`,
+      description: "Denial reason when a knowledge space is not bound"
+    },
+    "access.readOnly": {
+      value: `L'espace de connaissances "{spaceKey}" est de cat\xE9gorie "{category}" et est en lecture seule.`,
+      description: "Denial reason when write is attempted on a read-only space"
+    },
+    "access.workflowUnauthorized": {
+      value: `Le workflow "{workflowName}" n'est pas autoris\xE9 \xE0 acc\xE9der \xE0 l'espace de connaissances "{spaceKey}".`,
+      description: "Denial reason when a workflow lacks space access"
+    },
+    "access.agentUnauthorized": {
+      value: `L'agent "{agentName}" n'est pas autoris\xE9 \xE0 acc\xE9der \xE0 l'espace de connaissances "{spaceKey}".`,
+      description: "Denial reason when an agent lacks space access"
+    },
+    "access.ephemeralWarning": {
+      value: `L'espace de connaissances "{spaceKey}" est \xE9ph\xE9m\xE8re ; les r\xE9sultats peuvent \xEAtre transitoires.`,
+      description: "Warning for ephemeral knowledge spaces"
+    },
+    "query.systemPrompt": {
+      value: "Vous \xEAtes un assistant de connaissances qui r\xE9pond aux questions en utilisant le contexte fourni. Citez les sources pertinentes si possible.",
+      description: "Default LLM system prompt for knowledge queries"
+    },
+    "query.userMessage": {
+      value: `Question :
+{question}
+
+Contexte :
+{context}`,
+      description: "User message template combining question and context"
+    },
+    "query.noResults": {
+      value: "Aucun document pertinent trouv\xE9.",
+      description: "Displayed when vector search returns zero results"
+    },
+    "query.sourceLabel": {
+      value: "Source {index} (score : {score}) :",
+      description: "Label prefix for each source in the context block"
+    },
+    "ingestion.gmail.subject": {
+      value: "Objet : {subject}",
+      description: "Gmail thread subject label"
+    },
+    "ingestion.gmail.snippet": {
+      value: "Extrait : {snippet}",
+      description: "Gmail thread snippet label"
+    },
+    "ingestion.gmail.from": {
+      value: "De : {from}",
+      description: "Gmail message sender label"
+    },
+    "ingestion.gmail.to": {
+      value: "\xC0 : {to}",
+      description: "Gmail message recipients label"
+    },
+    "ingestion.gmail.date": {
+      value: "Date : {date}",
+      description: "Gmail message date label"
+    }
+  }
+});
+
+// src/i18n/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation3({
+  meta: {
+    key: "knowledge.messages",
+    version: "1.0.0",
+    domain: "knowledge",
+    description: "All user-facing and LLM-facing strings for the knowledge package (Spanish)",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "es",
+  fallback: "en",
+  messages: {
+    "access.notBound": {
+      value: 'El espacio de conocimiento "{spaceKey}" no est\xE1 vinculado en la configuraci\xF3n de la aplicaci\xF3n.',
+      description: "Denial reason when a knowledge space is not bound"
+    },
+    "access.readOnly": {
+      value: 'El espacio de conocimiento "{spaceKey}" es de categor\xEDa "{category}" y es de solo lectura.',
+      description: "Denial reason when write is attempted on a read-only space"
+    },
+    "access.workflowUnauthorized": {
+      value: 'El flujo de trabajo "{workflowName}" no est\xE1 autorizado para acceder al espacio de conocimiento "{spaceKey}".',
+      description: "Denial reason when a workflow lacks space access"
+    },
+    "access.agentUnauthorized": {
+      value: 'El agente "{agentName}" no est\xE1 autorizado para acceder al espacio de conocimiento "{spaceKey}".',
+      description: "Denial reason when an agent lacks space access"
+    },
+    "access.ephemeralWarning": {
+      value: 'El espacio de conocimiento "{spaceKey}" es ef\xEDmero; los resultados pueden ser transitorios.',
+      description: "Warning for ephemeral knowledge spaces"
+    },
+    "query.systemPrompt": {
+      value: "Eres un asistente de conocimiento que responde preguntas utilizando el contexto proporcionado. Cita las fuentes relevantes si es posible.",
+      description: "Default LLM system prompt for knowledge queries"
+    },
+    "query.userMessage": {
+      value: `Pregunta:
+{question}
+
+Contexto:
+{context}`,
+      description: "User message template combining question and context"
+    },
+    "query.noResults": {
+      value: "No se encontraron documentos relevantes.",
+      description: "Displayed when vector search returns zero results"
+    },
+    "query.sourceLabel": {
+      value: "Fuente {index} (puntuaci\xF3n: {score}):",
+      description: "Label prefix for each source in the context block"
+    },
+    "ingestion.gmail.subject": {
+      value: "Asunto: {subject}",
+      description: "Gmail thread subject label"
+    },
+    "ingestion.gmail.snippet": {
+      value: "Extracto: {snippet}",
+      description: "Gmail thread snippet label"
+    },
+    "ingestion.gmail.from": {
+      value: "De: {from}",
+      description: "Gmail message sender label"
+    },
+    "ingestion.gmail.to": {
+      value: "Para: {to}",
+      description: "Gmail message recipients label"
+    },
+    "ingestion.gmail.date": {
+      value: "Fecha: {date}",
+      description: "Gmail message date label"
+    }
+  }
+});
+
+// src/i18n/messages.ts
+import {
+  createI18nFactory
+} from "@contractspec/lib.contracts-spec/translations";
+var factory = createI18nFactory({
+  specKey: "knowledge.messages",
+  catalogs: [enMessages, frMessages, esMessages]
+});
+var createKnowledgeI18n = factory.create;
+var getDefaultI18n = factory.getDefault;
+var resetI18nRegistry = factory.resetRegistry;
+
+// src/i18n/locale.ts
+import {
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  resolveLocale,
+  isSupportedLocale
+} from "@contractspec/lib.contracts-spec/translations";
+
+// src/i18n/keys.ts
+var ACCESS_KEYS = {
+  "access.notBound": "access.notBound",
+  "access.readOnly": "access.readOnly",
+  "access.workflowUnauthorized": "access.workflowUnauthorized",
+  "access.agentUnauthorized": "access.agentUnauthorized",
+  "access.ephemeralWarning": "access.ephemeralWarning"
+};
+var QUERY_KEYS = {
+  "query.systemPrompt": "query.systemPrompt",
+  "query.userMessage": "query.userMessage",
+  "query.noResults": "query.noResults",
+  "query.sourceLabel": "query.sourceLabel"
+};
+var INGESTION_KEYS = {
+  "ingestion.gmail.subject": "ingestion.gmail.subject",
+  "ingestion.gmail.snippet": "ingestion.gmail.snippet",
+  "ingestion.gmail.from": "ingestion.gmail.from",
+  "ingestion.gmail.to": "ingestion.gmail.to",
+  "ingestion.gmail.date": "ingestion.gmail.date"
+};
+var I18N_KEYS = {
+  ...ACCESS_KEYS,
+  ...QUERY_KEYS,
+  ...INGESTION_KEYS
+};
+export {
+  resolveLocale,
+  resetI18nRegistry,
+  isSupportedLocale,
+  getDefaultI18n,
+  frMessages,
+  esMessages,
+  enMessages,
+  createKnowledgeI18n,
+  SUPPORTED_LOCALES,
+  QUERY_KEYS,
+  INGESTION_KEYS,
+  I18N_KEYS,
+  DEFAULT_LOCALE,
+  ACCESS_KEYS
+};

package/dist/i18n/keys.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Typed message keys for the knowledge i18n system.
+ *
+ * All translatable strings in the package are referenced by these keys.
+ * Organized by domain: access, query, ingestion.
+ *
+ * @module i18n/keys
+ */
+export declare const ACCESS_KEYS: {
+    /** 'Knowledge space "{spaceKey}" is not bound in the resolved app config.' */
+    readonly 'access.notBound': "access.notBound";
+    /** 'Knowledge space "{spaceKey}" is category "{category}" and is read-only.' */
+    readonly 'access.readOnly': "access.readOnly";
+    /** 'Workflow "{workflowName}" is not authorized to access knowledge space "{spaceKey}".' */
+    readonly 'access.workflowUnauthorized': "access.workflowUnauthorized";
+    /** 'Agent "{agentName}" is not authorized to access knowledge space "{spaceKey}".' */
+    readonly 'access.agentUnauthorized': "access.agentUnauthorized";
+    /** 'Knowledge space "{spaceKey}" is ephemeral; results may be transient.' */
+    readonly 'access.ephemeralWarning': "access.ephemeralWarning";
+};
+export declare const QUERY_KEYS: {
+    /** Default system prompt for the knowledge assistant LLM */
+    readonly 'query.systemPrompt': "query.systemPrompt";
+    /** Template for the user message: "Question:\n{question}\n\nContext:\n{context}" */
+    readonly 'query.userMessage': "query.userMessage";
+    /** "No relevant documents found." */
+    readonly 'query.noResults': "query.noResults";
+    /** "Source {index} (score: {score}):" */
+    readonly 'query.sourceLabel': "query.sourceLabel";
+};
+export declare const INGESTION_KEYS: {
+    /** "Subject: {subject}" */
+    readonly 'ingestion.gmail.subject': "ingestion.gmail.subject";
+    /** "Snippet: {snippet}" */
+    readonly 'ingestion.gmail.snippet': "ingestion.gmail.snippet";
+    /** "From: {from}" */
+    readonly 'ingestion.gmail.from': "ingestion.gmail.from";
+    /** "To: {to}" */
+    readonly 'ingestion.gmail.to': "ingestion.gmail.to";
+    /** "Date: {date}" */
+    readonly 'ingestion.gmail.date': "ingestion.gmail.date";
+};
+export declare const I18N_KEYS: {
+    /** "Subject: {subject}" */
+    readonly 'ingestion.gmail.subject': "ingestion.gmail.subject";
+    /** "Snippet: {snippet}" */
+    readonly 'ingestion.gmail.snippet': "ingestion.gmail.snippet";
+    /** "From: {from}" */
+    readonly 'ingestion.gmail.from': "ingestion.gmail.from";
+    /** "To: {to}" */
+    readonly 'ingestion.gmail.to': "ingestion.gmail.to";
+    /** "Date: {date}" */
+    readonly 'ingestion.gmail.date': "ingestion.gmail.date";
+    /** Default system prompt for the knowledge assistant LLM */
+    readonly 'query.systemPrompt': "query.systemPrompt";
+    /** Template for the user message: "Question:\n{question}\n\nContext:\n{context}" */
+    readonly 'query.userMessage': "query.userMessage";
+    /** "No relevant documents found." */
+    readonly 'query.noResults': "query.noResults";
+    /** "Source {index} (score: {score}):" */
+    readonly 'query.sourceLabel': "query.sourceLabel";
+    /** 'Knowledge space "{spaceKey}" is not bound in the resolved app config.' */
+    readonly 'access.notBound': "access.notBound";
+    /** 'Knowledge space "{spaceKey}" is category "{category}" and is read-only.' */
+    readonly 'access.readOnly': "access.readOnly";
+    /** 'Workflow "{workflowName}" is not authorized to access knowledge space "{spaceKey}".' */
+    readonly 'access.workflowUnauthorized': "access.workflowUnauthorized";
+    /** 'Agent "{agentName}" is not authorized to access knowledge space "{spaceKey}".' */
+    readonly 'access.agentUnauthorized': "access.agentUnauthorized";
+    /** 'Knowledge space "{spaceKey}" is ephemeral; results may be transient.' */
+    readonly 'access.ephemeralWarning': "access.ephemeralWarning";
+};
+/** Union type of all valid knowledge i18n keys */
+export type KnowledgeMessageKey = keyof typeof I18N_KEYS;