@@ -0,0 +1,10 @@
+---
+'@object-ui/i18n': patch
+---
+
+feat(i18n): `chatbot.tool.read_package_doc` and `chatbot.tool.search_package_docs` labels in all ten packs (#27002)
+
+The spec registry `PLATFORM_TOOLS_BY_PACKAGE['service-ai']` now lists the cloud ask agent's two package-doc tools, so the chatbot's tool timeline can show them. Each pack gets a sentence in its own language ("Read the app guide", "Search the app guides" in English; "阅读应用文档", "在应用文档中查找" in Chinese), keeping the `toolLabels-locale-parity-7481` and `toolLabels-sentences-12724` tests green.
+
+Clause-②: no
+Metadata-protocol: none
@@ -0,0 +1,10 @@
+---
+'@objectstack/spec': minor
+---
+
+feat(spec): `PLATFORM_TOOLS_BY_PACKAGE['service-ai']` lists `read_package_doc` and `search_package_docs`
+
+Clause-②: yes (widening)
+Metadata-protocol: added
+
+The cloud `ask` agent gains two `service-ai` tools that list and read the installed packages' `doc` items behind the `/meta/doc` audience gate (cloud#3335, the cloud half of #26691). The registry now lists both names, in its alphabetical order, so `PLATFORM_PROVIDED_TOOL_NAMES` carries them: a skill whose `tools[]` names either resolves under ADR-0109 reference integrity instead of being reported as a fictional tool (`ai-skill-tool-unresolved`). That is the whole widening: two more accepted `skill.tools[]` values. No schema shape changes, no export is added or removed, and every other name in the registry stays where it was.
@@ -205,6 +205,26 @@ describe('validate-ai-tool-references', () => {
     expect(control[0].message).toContain('archive_flow');
   });
 
+  /**
+   * [#27002] The two `service-ai` package-doc tools cloud#3335 adds to the
+   * `ask` agent (`search_package_docs`, `read_package_doc`): the same widening
+   * #16512 made for five `service-ai-studio` tools, so a skill naming either
+   * resolves instead of being reported as a fictional tool.
+   */
+  it('resolves the two service-ai package-doc tools (#27002)', () => {
+    const two = ['search_package_docs', 'read_package_doc'];
+    expect(validateAiToolReferences({ skills: [{ name: 's', tools: two }] })).toEqual([]);
+
+    // The control: a third name shaped like the two and registered by nobody
+    // is still reported, so this pin fails on a universe widened too far.
+    const control = validateAiToolReferences({
+      skills: [{ name: 's', tools: [...two, 'list_package_docs'] }],
+    });
+    expect(control).toHaveLength(1);
+    expect(control[0].path).toBe('skills[0].tools[2]');
+    expect(control[0].message).toContain('list_package_docs');
+  });
+
   it('reports stable paths and tolerates junk shapes', () => {
     const stack = {
       skills: [{ name: 's', tools: ['query_records', 'nope_tool'] }],
 
@@ -28,7 +28,9 @@
  * Maintenance contract: registering a new tool in a cloud AI package means
  * adding its name here. The owning package's conformance test fails
  * otherwise — an out-of-date registry is worse than no registry, because
- * consumers now trust it.
+ * consumers now trust it. A new name also needs its `chatbot.tool.<name>`
+ * label in every pack under `ui/packages/i18n/src/locales/` — the ui
+ * plugin-chatbot label-parity tests read this registry.
  */
 
 /**
@@ -38,14 +40,18 @@
 export const PLATFORM_TOOLS_BY_PACKAGE: Readonly<Record<string, readonly string[]>> = {
   /**
    * `@objectstack/service-ai` (cloud) — the `ask` data product's shared
-   * data/knowledge/visualization tools.
+   * data/knowledge/visualization tools, and the package-doc pair that reads the
+   * installed packages' `doc` items behind the `/meta/doc` audience gate
+   * (cloud#3335).
    */
   'service-ai': [
     'aggregate_data',
     'get_record',
     'query_data',
     'query_records',
+    'read_package_doc',
     'search_knowledge',
+    'search_package_docs',
     'visualize_data',
   ],
   /**
 
@@ -3926,7 +3926,9 @@ const ar = {
       get_record: "قراءة هذا السجل",
       query_data: "الاستعلام عن البيانات المطلوبة",
       query_records: "البحث عن السجلات المطابقة",
+      read_package_doc: "قراءة دليل التطبيق",
       search_knowledge: "البحث في قاعدة المعرفة عن معلومات",
+      search_package_docs: "البحث في أدلة التطبيق",
       visualize_data: "عرض البيانات في رسم بياني",
       add_field: "إضافة حقل إلى الكائن",
       apply_blueprint: "بناء التطبيق وفق الخطة",
 
@@ -3649,7 +3649,9 @@ const de = {
       get_record: "Den Datensatz lesen",
       query_data: "Die benötigten Daten abfragen",
       query_records: "Passende Datensätze suchen",
+      read_package_doc: "Die Anleitung der App lesen",
       search_knowledge: "In der Wissensdatenbank nachsehen",
+      search_package_docs: "In den Anleitungen der App suchen",
       visualize_data: "Die Daten als Diagramm darstellen",
       add_field: "Dem Objekt ein Feld hinzufügen",
       apply_blueprint: "Die App nach dem Plan erstellen",
 
@@ -4405,7 +4405,9 @@ const en = {
       get_record: 'Read the record',
       query_data: 'Query the data',
       query_records: 'Look up the records',
+      read_package_doc: 'Read the app guide',
       search_knowledge: 'Search the knowledge base',
+      search_package_docs: 'Search the app guides',
       visualize_data: 'Chart the data',
       add_field: 'Add a field',
       apply_blueprint: 'Build the app from the plan',
 
@@ -3719,7 +3719,9 @@ const es = {
       get_record: "Leer el registro",
       query_data: "Consultar los datos necesarios",
       query_records: "Buscar los registros",
+      read_package_doc: "Leer la guía de la aplicación",
       search_knowledge: "Consultar la base de conocimiento",
+      search_package_docs: "Buscar en las guías de la aplicación",
       visualize_data: "Representar los datos en un gráfico",
       add_field: "Añadir un campo",
       apply_blueprint: "Construir la aplicación según el plan",
 
@@ -3715,7 +3715,9 @@ const fr = {
       get_record: "Lire l’enregistrement",
       query_data: "Interroger les données nécessaires",
       query_records: "Rechercher les enregistrements",
+      read_package_doc: "Lire le guide de l’application",
       search_knowledge: "Consulter la base de connaissances",
+      search_package_docs: "Chercher dans les guides de l’application",
       visualize_data: "Représenter les données en graphique",
       add_field: "Ajouter un champ à l’objet",
       apply_blueprint: "Construire l’application selon le plan",
 
@@ -3651,7 +3651,9 @@ const ja = {
       get_record: "このレコードを読み込む",
       query_data: "必要なデータを照会する",
       query_records: "該当するレコードを探す",
+      read_package_doc: "アプリのガイドを読む",
       search_knowledge: "ナレッジベースで調べる",
+      search_package_docs: "アプリのガイドで調べる",
       visualize_data: "データをグラフにする",
       add_field: "オブジェクトに項目を追加する",
       apply_blueprint: "設計案どおりにアプリを構築する",