@agent-native/core 0.99.2 → 0.100.0

package/corpus/README.md

@@ -27,5 +27,5 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- core files: 2241
-- template files: 5551
+- core files: 2255
+- template files: 5582

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @agent-native/core
 
+## 0.100.0
+
+### Minor Changes
+
+- 8e6f022: Add an Agent Jobs page tab for recurring jobs and personal automations, with scoped status views and management controls.
+- 8e6f022: Add the full-page Agent surface with scoped Context, Files, Connections, Jobs, and Access tabs, plus shared MCP connection guidance.
+- 8e6f022: Expose system-prompt sections in Context X-Ray and add a no-thread context preview with provenance, governance, and token breakdowns.
+
+### Patch Changes
+
+- 8e6f022: Document the full-page Agent surface, its tab responsibilities, and the in-app external-client Access flow.
+- 8e6f022: Align fullscreen chat thread width with the composer width.
+- 8e6f022: Preserve the registered root Google OAuth callback for workspace apps when deploy-time workspace metadata is available but a runtime relay flag is missing.
+- 8e6f022: Recover reasoning-only model completions before app-specific final-answer guards run, and keep guards anchored to the original user request across internal continuations.
+
+## 0.99.3
+
+### Patch Changes
+
+- 03cd25c: Document the `agent-native invoke` CLI usage and flags on the A2A protocol docs page, across all locales.
+
 ## 0.99.2
 
 ### Patch Changes

package/corpus/core/docs/content/a2a-protocol.mdx

@@ -392,6 +392,48 @@ app environment and pass the caller identity (`userEmail`) so outbound calls are
 signed as JWT bearer tokens. Use `apiKeyEnv` only for legacy external peers that
 expect a static bearer token. Use local actions instead of invoking yourself.
 
+## CLI: agent-native invoke {#cli-invoke}
+
+`agent-native invoke` is a thin CLI wrapper over the same resolve-and-call primitive as `agentNative.invoke()`. Use it to trigger an app's agent from a shell script, a CI job, a cron entry, or any external system that can shell out — the CLI equivalent of posting to `/_agent-native/a2a` by hand.
+
+```bash
+agent-native invoke <app-or-url> "prompt" [options]
+```
+
+```bash
+# Resolve "analytics" in the workspace registry and wait for the reply
+agent-native invoke analytics "Summarize signups by source this month"
+
+# Call a deployed app directly by URL, reading the bearer token from env
+agent-native invoke https://analytics.example.com "How many signups last week?" \
+  --api-key-env ANALYTICS_A2A_KEY
+
+# Force one blocking message/send instead of the default async+poll
+agent-native invoke analytics "Quick lookup" --sync
+
+# Machine-readable output for scripting
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| Option                    | Description                                                               |
+| ------------------------- | ------------------------------------------------------------------------- |
+| `--agent <id\|name\|url>` | Target agent (alias for the positional `<app-or-url>`)                    |
+| `--message <text>`        | Prompt (alias for the positional `"prompt"`)                              |
+| `--api-key-env <name>`    | Read the bearer token from an environment variable                        |
+| `--api-key <token>`       | Bearer token value, passed inline                                         |
+| `--context-id <id>`       | A2A `contextId`, to continue an existing task's conversation              |
+| `--self-app-id <id>`      | Current app id, used for self-call prevention                             |
+| `--self-url <url>`        | Current app URL, used for self-call prevention                            |
+| `--timeout-ms <n>`        | Async polling timeout                                                     |
+| `--poll-interval-ms <n>`  | Async polling interval                                                    |
+| `--sync`                  | Use one blocking `message/send` request instead of the async+poll default |
+| `--no-hint`               | Send the prompt as-is, without the cross-app invocation hint              |
+| `--json`                  | Print target metadata and response text as JSON                           |
+
+Like `callAgent()`, the CLI defaults to async + poll (`invokeAgent` → `callAgent` under the hood), which is the safe choice against hosted/serverless targets — see [Serverless webhook and gateway timeouts](#json-rpc-methods) above. Pass `--sync` only when you know the target isn't behind a gateway with a short execution limit.
+
+The target resolves the same way as `agentNative.invoke()`: by workspace app id, by app name, or by a full URL — so the same command works against a sibling app in a multi-app workspace or an arbitrary A2A peer elsewhere.
+
 ## Task lifecycle {#task-lifecycle}
 
 Each message creates a task that moves through these states:

package/corpus/core/docs/content/agent-surfaces.mdx

@@ -29,6 +29,49 @@ start in chat, appear as a native table or chart, become a durable page in the
 app, and still run from jobs, scripts, MCP, or A2A without changing the operation
 the agent calls.
 
+## Full-page Agent workspace {#agent-page}
+
+When a full application needs a durable place to inspect and configure its
+agent, mount `AgentTabsPage` at `/agent`. Current templates pair that route
+with an app-navigation entry and pass `agentPageHref="/agent"` to
+`AgentSidebar`; the sidebar's Resources and Settings modes can then link to the
+full page without duplicating those flows.
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+The shared page currently provides five tabs:
+
+- **Context** shows a scope preview, token budget, ordered system sections
+  grouped by provenance, governance, and source, a list/treemap view, and the
+  latest live-thread snapshot. It is a current snapshot, not per-iteration
+  provenance history.
+- **Files** re-hosts the existing `ResourcesPanel` for personal or
+  organization resources.
+- **Connections** re-hosts MCP server management and the A2A remote-agent list:
+  what this app's agent can call.
+- **Jobs** shows scoped recurring jobs and automations with the existing
+  pause/resume, details, and delete flows. Automations are personal-only today.
+- **Access** shows the app MCP URL, an A2A agent card when available, and shared
+  setup guides for Claude, ChatGPT, Cursor, Claude Code, Codex, and other
+  clients. It links to `/mcp/connect` for the full connect flow and token
+  fallback.
+
+The page-level **Personal / Organization** toggle supplies scope to the tabs.
+Members can inspect organization data while organization management remains
+restricted to owners/admins where the hosted component enforces that boundary.
+The design goal is inspectable, attributable, governable context, with
+capability separated from access: Connections describes what the app can call;
+Access describes how external clients connect to it. The page is a thin shell
+over existing components, actions, and access checks—not a new admin console.
+Grants, scope editing, revocation UI, and per-iteration provenance history are
+not provided by this page yet.
+
 <Diagram id="doc-block-hvdxgh" title="The surface spectrum" summary={"One action surface, four product shapes — each adds UI without changing the operation underneath."}>
 
 ```html

package/corpus/core/docs/content/external-agents.mdx

@@ -118,6 +118,17 @@ Every hosted app also has a helper page at
 `https://<app>/mcp/connect` with the copyable URL and
 host-specific tabs for Claude, ChatGPT, Cursor, Claude Code, Codex, and Other.
 
+### The in-app Access tab {#access-tab}
+
+Apps that mount `AgentTabsPage` also expose this connection flow in the page's
+**Access** tab. It shows the app's MCP URL, an A2A agent card when available,
+and the same client setup instructions used by the full connect page. Use it as
+the in-app starting point for connecting Claude, ChatGPT, Cursor, Claude Code,
+Codex, or another MCP client; the tab links to `/mcp/connect` for the full flow
+and static-token fallback. This is connection setup UI, not a general access
+control console: grants, scope editing, and revocation management are not
+implemented in the tab yet.
+
 ### Claude and ChatGPT OAuth {#oauth}
 
 Claude / Claude Desktop: add a custom connector, paste the MCP URL, click

package/corpus/core/docs/content/locales/ar-SA/a2a-protocol.mdx

@@ -384,6 +384,48 @@ console.log(`Called ${result.target.name}: ${result.responseText}`);
 تم التوقيع عليها كرموز حاملة JWT. استخدم `apiKeyEnv` فقط للأقران الخارجيين القدامى الذين
 توقع رمزًا مميزًا لحامل ثابت. استخدم actions المحلي بدلاً من استدعاء نفسك.
 
+## واجهة سطر الأوامر: agent-native invoke {#cli-invoke}
+
+`agent-native invoke` عبارة عن غلاف رفيع لواجهة سطر الأوامر فوق نفس بدائية الحل والاستدعاء التي تستخدمها `agentNative.invoke()`. استخدمه لتشغيل وكيل أحد التطبيقات من نص برمجي في shell، أو مهمة CI، أو إدخال cron، أو أي نظام خارجي يمكنه تنفيذ أوامر shell — وهو المكافئ عبر سطر الأوامر لإرسال طلب POST يدويًا إلى `/_agent-native/a2a`.
+
+```bash
+agent-native invoke <app-or-url> "prompt" [options]
+```
+
+```bash
+# حلّ "analytics" في سجل مساحة العمل وانتظر الرد
+agent-native invoke analytics "Summarize signups by source this month"
+
+# استدعِ تطبيقًا منشورًا مباشرةً عبر عنوان URL، مع قراءة رمز الحامل من متغير بيئة
+agent-native invoke https://analytics.example.com "How many signups last week?" \
+  --api-key-env ANALYTICS_A2A_KEY
+
+# فرض طلب message/send حاجز واحد بدلاً من الوضع الافتراضي async+poll
+agent-native invoke analytics "Quick lookup" --sync
+
+# إخراج قابل للقراءة الآلية للبرمجة النصية
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| Option                    | الوصف                                                                    |
+| ------------------------- | ------------------------------------------------------------------------ |
+| `--agent <id\|name\|url>` | الوكيل المستهدف (اسم بديل للوسيطة الموضعية `<app-or-url>`)               |
+| `--message <text>`        | الطلب النصي (اسم بديل للوسيطة الموضعية `"prompt"`)                       |
+| `--api-key-env <name>`    | قراءة رمز الحامل (bearer token) من متغير بيئة                            |
+| `--api-key <token>`       | قيمة رمز الحامل، مُمرَّرة مباشرة                                         |
+| `--context-id <id>`       | `contextId` الخاص بـ A2A، لمتابعة محادثة مهمة موجودة بالفعل              |
+| `--self-app-id <id>`      | معرف التطبيق الحالي، يُستخدم لمنع الاستدعاء الذاتي                       |
+| `--self-url <url>`        | عنوان URL للتطبيق الحالي، يُستخدم لمنع الاستدعاء الذاتي                  |
+| `--timeout-ms <n>`        | مهلة الاستطلاع (polling) غير المتزامن                                    |
+| `--poll-interval-ms <n>`  | فاصل الاستطلاع غير المتزامن                                              |
+| `--sync`                  | استخدام طلب `message/send` حاجب واحد بدلاً من الوضع الافتراضي async+poll |
+| `--no-hint`               | إرسال الطلب النصي كما هو، دون تلميح الاستدعاء بين التطبيقات              |
+| `--json`                  | طباعة بيانات الهدف الوصفية ونص الاستجابة بصيغة JSON                      |
+
+مثل `callAgent()`، تعتمد واجهة سطر الأوامر افتراضيًا على async + poll (`invokeAgent` ← `callAgent` تحت الغطاء)، وهو الخيار الآمن عند استهداف بيئات مستضافة/serverless — انظر [مهلات بوابة الويب هوك وبوابة العبور بلا خادم](#json-rpc-methods) أعلاه. استخدم `--sync` فقط عندما تكون متأكدًا أن الهدف ليس خلف بوابة ذات مهلة تنفيذ قصيرة.
+
+يتم حل الهدف بنفس طريقة `agentNative.invoke()`: عبر معرف تطبيق مساحة العمل، أو اسم التطبيق، أو عنوان URL كامل — لذا يعمل نفس الأمر مع تطبيق شقيق في مساحة عمل متعددة التطبيقات أو مع أي نظير A2A تعسفي في مكان آخر.
+
 ## دورة حياة المهمة {#task-lifecycle}
 
 تنشئ كل رسالة مهمة تنتقل عبر هذه الحالات:

package/corpus/core/docs/content/locales/ar-SA/agent-surfaces.mdx

@@ -6,6 +6,36 @@ search: "التطبيق الكامل للدردشة الغنية للوكيل م
 
 # أسطح الوكيل
 
+## مساحة عمل Agent الكاملة {#agent-page}
+
+عندما يحتاج التطبيق الكامل إلى مكان دائم لفحص وكيله وتهيئته، اربط
+`AgentTabsPage` بالمسار `/agent`. أضف المسار إلى تنقل التطبيق ومرر
+`agentPageHref="/agent"` إلى `AgentSidebar` كي تصل وضعيّتا Resources وSettings
+إلى الصفحة الكاملة من دون تكرار التدفقات.
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+تحتوي الصفحة المشتركة حاليًا على خمس علامات تبويب:
+
+- **Context** — معاينة النطاق، وميزانية الرموز، وأقسام النظام المرتبة مع مصدرها وحوكمتها، وعرض القائمة أو الخريطة، وأحدث لقطة للمحادثة الحية.
+- **Files** — يعيد استخدام `ResourcesPanel` للموارد الشخصية أو الخاصة بالمؤسسة.
+- **Connections** — إدارة خوادم MCP وقائمة الوكلاء البعيدين عبر A2A؛ أي ما يستطيع وكيل التطبيق استدعاءه.
+- **Jobs** — الوظائف المتكررة والأتمتة مع تدفقات الإيقاف والاستئناف والتفاصيل والحذف الموجودة. الأتمتة شخصية اليوم.
+- **Access** — عنوان MCP وبطاقة وكيل A2A عند توفرها وتعليمات إعداد العملاء الخارجيين؛ ويربط بالمسار `/mcp/connect` للتدفق الكامل والرمز الاحتياطي.
+
+يحدد مفتاح **Personal / Organization** نطاق علامات التبويب. يمكن للأعضاء فحص
+بيانات المؤسسة، بينما تظل إدارة المؤسسة مقصورة على المالكين/المسؤولين حيث يفرض
+المكوّن المستضاف هذا الحد. الهدف هو جعل
+السياق قابلًا للفحص ونسبته وحوكمته، مع فصل القدرة عما يتعلق بالوصول. الصفحة
+غلاف رقيق للمكونات والإجراءات وفحوصات الوصول الموجودة، وليست لوحة إدارة جديدة.
+ولا توفر حاليًا واجهة لإدارة المنح أو النطاقات أو الإلغاء، ولا سجل مصدر لكل تكرار.
+
 Agent-Native قابل للتأليف بشكل متعمد. يمكنك استخدام الوكيل بدون الكثير من UI،
 استخدم UI بدون وقت تشغيل الوكيل المضمن، أو استخدمهما معًا بشكل كامل
 التطبيق.

package/corpus/core/docs/content/locales/ar-SA/external-agents.mdx

@@ -117,6 +117,15 @@ https://<your-app>.agent-native.com/mcp
 `https://&lt;app&gt;/mcp/connect` مع URL القابل للنسخ و
 علامات التبويب الخاصة بالمضيف لـ Claude، وChatGPT، والمؤشر، وClaude Code، وCodex، وغيرها.
 
+### علامة التبويب Access داخل التطبيق {#access-tab}
+
+تعرض التطبيقات التي تستخدم `AgentTabsPage` تدفق الاتصال نفسه في علامة تبويب
+**Access**. وهي تعرض عنوان MCP، وبطاقة وكيل A2A عند توفرها، وتعليمات إعداد
+Claude وChatGPT وCursor وClaude Code وCodex والعملاء الآخرين. استخدمها كنقطة
+البداية داخل التطبيق، ثم افتح `/mcp/connect` للتدفق الكامل والرمز الاحتياطي.
+هذه واجهة لإعداد الاتصال وليست وحدة تحكم عامة بالوصول؛ لا توفر علامة التبويب
+بعد واجهة لإدارة المنح أو النطاقات أو الإلغاء.
+
 ### Claude وChatGPT OAuth {#oauth}
 
 Claude / Claude سطح المكتب: أضف موصلًا مخصصًا، والصق MCP URL، وانقر على

package/corpus/core/docs/content/locales/de-DE/a2a-protocol.mdx

@@ -386,6 +386,48 @@ App-Umgebung und übergeben Sie die Anruferidentität (`userEmail`), sodass ausg
 signiert als JWT-Inhaber-Token. Verwenden Sie `apiKeyEnv` nur für ältere externe Peers, die
 erwarten Sie ein statisches Inhabertoken. Verwenden Sie lokales actions, anstatt sich selbst aufzurufen.
 
+## CLI: agent-native invoke {#cli-invoke}
+
+`agent-native invoke` ist ein schlanker CLI-Wrapper über dieselbe Resolve-and-Call-Primitive wie `agentNative.invoke()`. Verwenden Sie es, um den Agenten einer App aus einem Shell-Skript, einem CI-Job, einem Cron-Eintrag oder einem beliebigen externen System auszulösen, das Befehle ausführen kann — das CLI-Äquivalent zum manuellen Posten an `/_agent-native/a2a`.
+
+```bash
+agent-native invoke <app-or-url> "prompt" [options]
+```
+
+```bash
+# "analytics" in der Workspace-Registry auflösen und auf die Antwort warten
+agent-native invoke analytics "Summarize signups by source this month"
+
+# Eine bereitgestellte App direkt per URL aufrufen und das Bearer-Token aus der Umgebung lesen
+agent-native invoke https://analytics.example.com "How many signups last week?" \
+  --api-key-env ANALYTICS_A2A_KEY
+
+# Eine einzelne blockierende message/send-Anfrage erzwingen statt des standardmäßigen Async+Poll
+agent-native invoke analytics "Quick lookup" --sync
+
+# Maschinenlesbare Ausgabe für Skripting
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| Option                    | Beschreibung                                                                         |
+| ------------------------- | ------------------------------------------------------------------------------------ |
+| `--agent <id\|name\|url>` | Ziel-Agent (Alias für das positionelle `<app-or-url>`)                               |
+| `--message <text>`        | Prompt (Alias für das positionelle `"prompt"`)                                       |
+| `--api-key-env <name>`    | Liest das Bearer-Token aus einer Umgebungsvariable                                   |
+| `--api-key <token>`       | Bearer-Token-Wert, inline übergeben                                                  |
+| `--context-id <id>`       | A2A-`contextId`, um die Konversation einer bestehenden Aufgabe fortzusetzen          |
+| `--self-app-id <id>`      | Aktuelle App-ID, verwendet zur Selbstaufruf-Vermeidung                               |
+| `--self-url <url>`        | Aktuelle App-URL, verwendet zur Selbstaufruf-Vermeidung                              |
+| `--timeout-ms <n>`        | Timeout für Async-Polling                                                            |
+| `--poll-interval-ms <n>`  | Intervall für Async-Polling                                                          |
+| `--sync`                  | Eine blockierende `message/send`-Anfrage anstelle des Async+Poll-Standards verwenden |
+| `--no-hint`               | Den Prompt unverändert senden, ohne den App-übergreifenden Aufruf-Hinweis            |
+| `--json`                  | Zielmetadaten und Antworttext als JSON ausgeben                                      |
+
+Wie `callAgent()` verwendet die CLI standardmäßig Async + Poll (`invokeAgent` → `callAgent` unter der Haube), was die sichere Wahl gegenüber gehosteten/serverlosen Zielen ist — siehe [Serverless-Webhook- und Gateway-Timeouts](#json-rpc-methods) oben. Übergeben Sie `--sync` nur, wenn Sie wissen, dass sich das Ziel nicht hinter einem Gateway mit kurzem Ausführungslimit befindet.
+
+Das Ziel wird auf die gleiche Weise aufgelöst wie bei `agentNative.invoke()`: über die Workspace-App-ID, den App-Namen oder eine vollständige URL — sodass derselbe Befehl sowohl gegen eine Geschwister-App in einem Multi-App-Workspace als auch gegen einen beliebigen A2A-Peer anderswo funktioniert.
+
 ## Aufgabenlebenszyklus {#task-lifecycle}
 
 Jede Nachricht erstellt eine Aufgabe, die diese Zustände durchläuft:

package/corpus/core/docs/content/locales/de-DE/agent-surfaces.mdx

@@ -6,6 +6,40 @@ search: "Headless Agent Rich Chat, vollständige App BYO Agent Runtime AgentChat
 
 # Agentenoberflächen
 
+## Vollständiger Agent-Arbeitsbereich {#agent-page}
+
+Wenn eine vollständige Anwendung einen dauerhaften Ort zum Prüfen und
+Konfigurieren ihres Agents braucht, binde `AgentTabsPage` unter `/agent` ein.
+Füge die Route zur App-Navigation hinzu und übergib `agentPageHref="/agent"` an
+`AgentSidebar`, damit die Modi Resources und Settings auf die vollständige
+Seite verweisen können, ohne diese Abläufe zu duplizieren.
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+Die gemeinsame Seite bietet derzeit fünf Tabs:
+
+- **Context** — Bereichsvorschau, Tokenbudget, geordnete Systemabschnitte mit Herkunft und Governance, Listen-/Treemap-Ansicht und der aktuelle Live-Thread-Snapshot.
+- **Files** — verwendet `ResourcesPanel` für persönliche oder organisationsweite Ressourcen wieder.
+- **Connections** — MCP-Serververwaltung und A2A-Liste entfernter Agents: was der Agent dieser App aufrufen kann.
+- **Jobs** — wiederkehrende Jobs und Automatisierungen mit den vorhandenen Abläufen zum Pausieren/Fortsetzen, für Details und zum Löschen. Automatisierungen sind derzeit persönlich.
+- **Access** — MCP-URL, eine A2A-Agent-Card wenn verfügbar, und gemeinsame Einrichtungsanleitungen; die vollständige Verbindung und den Token-Fallback gibt es unter `/mcp/connect`.
+
+Der Umschalter **Personal / Organization** gibt den Tabs ihren Bereich.
+Mitglieder können Organisationsdaten einsehen; die Organisationsverwaltung
+bleibt dort, wo die gehostete Komponente diese Grenze durchsetzt, auf
+Inhaber/Administratoren beschränkt. Das Ziel
+sind prüfbarer, zuordenbarer und steuerbarer Kontext sowie eine klare Trennung
+zwischen Fähigkeit und Zugriff. Die Seite ist eine dünne Hülle um vorhandene
+Komponenten, Actions und Zugriffskontrollen, keine neue Admin-Konsole. Grants,
+Bereichsänderung, Widerruf und Verlauf der Provenienz pro Iteration sind hier
+noch nicht verfügbar.
+
 Agent-Native ist bewusst zusammensetzbar. Sie können den Agenten ohne großen Aufwand verwenden UI,
 Verwenden Sie UI ohne die integrierte Agent-Laufzeit oder verwenden Sie beide zusammen als Vollversion
 Anwendung.

package/corpus/core/docs/content/locales/de-DE/external-agents.mdx

@@ -117,6 +117,16 @@ Jede gehostete App verfügt auch über eine Hilfsseite unter
 `https://<app>/mcp/connect` mit dem kopierbaren URL und
 hostspezifische Registerkarten für Claude, ChatGPT, Cursor, Claude-Code, Codex und Andere.
 
+### Der In-App-Tab Access {#access-tab}
+
+Apps, die `AgentTabsPage` einbinden, stellen denselben Verbindungsablauf im Tab
+**Access** bereit. Er zeigt die MCP-URL, bei Verfügbarkeit eine A2A-Agent-Card
+und die gemeinsamen Einrichtungsanleitungen für Claude, ChatGPT, Cursor, Claude
+Code, Codex und andere Clients. Beginnen Sie dort und öffnen Sie `/mcp/connect`
+für den vollständigen Ablauf und den Token-Fallback. Dies ist eine Oberfläche
+für die Verbindungseinrichtung, keine allgemeine Zugriffskonsole; Grants,
+Bereichsänderung und Widerruf werden in diesem Tab noch nicht verwaltet.
+
 ### Claude und ChatGPT OAuth {#oauth}
 
 Claude / Claude Desktop: Fügen Sie einen benutzerdefinierten Connector hinzu, fügen Sie MCP URL ein und klicken Sie auf

package/corpus/core/docs/content/locales/es-ES/a2a-protocol.mdx

@@ -386,6 +386,48 @@ entorno de la aplicación y pasar la identidad de la persona que llama (`userEma
 firmado como tokens al portador JWT. Utilice `apiKeyEnv` solo para pares externos heredados que
 espera un token de portador estático. Utilice actions local en lugar de invocarse a sí mismo.
 
+## CLI: agent-native invoke {#cli-invoke}
+
+`agent-native invoke` es un envoltorio de CLI ligero sobre la misma primitiva de resolución e invocación que `agentNative.invoke()`. Úselo para activar el agente de una aplicación desde un script de shell, un job de CI, una entrada de cron, o cualquier sistema externo que pueda ejecutar comandos — el equivalente en CLI de hacer un POST manual a `/_agent-native/a2a`.
+
+```bash
+agent-native invoke <app-or-url> "prompt" [options]
+```
+
+```bash
+# Resuelve "analytics" en el registro del espacio de trabajo y espera la respuesta
+agent-native invoke analytics "Summarize signups by source this month"
+
+# Llama directamente a una aplicación desplegada por URL, leyendo el token de portador desde una variable de entorno
+agent-native invoke https://analytics.example.com "How many signups last week?" \
+  --api-key-env ANALYTICS_A2A_KEY
+
+# Fuerza un único message/send bloqueante en lugar del valor predeterminado async+poll
+agent-native invoke analytics "Quick lookup" --sync
+
+# Salida legible por máquina para scripting
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| Option                    | Description                                                                                    |
+| ------------------------- | ---------------------------------------------------------------------------------------------- |
+| `--agent <id\|name\|url>` | Agente de destino (alias del argumento posicional `<app-or-url>`)                              |
+| `--message <text>`        | Prompt (alias del argumento posicional `"prompt"`)                                             |
+| `--api-key-env <name>`    | Lee el token de portador desde una variable de entorno                                         |
+| `--api-key <token>`       | Valor del token de portador, pasado en línea                                                   |
+| `--context-id <id>`       | `contextId` de A2A, para continuar la conversación de una tarea existente                      |
+| `--self-app-id <id>`      | ID de la aplicación actual, usado para prevenir autoinvocación                                 |
+| `--self-url <url>`        | URL de la aplicación actual, usada para prevenir autoinvocación                                |
+| `--timeout-ms <n>`        | Tiempo de espera del sondeo asíncrono                                                          |
+| `--poll-interval-ms <n>`  | Intervalo de sondeo asíncrono                                                                  |
+| `--sync`                  | Usa una única solicitud `message/send` bloqueante en lugar del valor predeterminado async+poll |
+| `--no-hint`               | Envía el prompt tal cual, sin la sugerencia de invocación entre aplicaciones                   |
+| `--json`                  | Imprime los metadatos del destino y el texto de respuesta como JSON                            |
+
+Al igual que `callAgent()`, la CLI usa de forma predeterminada async + poll (`invokeAgent` → `callAgent` internamente), que es la opción segura frente a destinos alojados/serverless — vea [Tiempos de espera de webhooks y gateways serverless](#json-rpc-methods) más arriba. Pase `--sync` solo cuando sepa que el destino no está detrás de un gateway con un límite de ejecución corto.
+
+El destino se resuelve de la misma manera que `agentNative.invoke()`: por ID de aplicación del espacio de trabajo, por nombre de aplicación, o por una URL completa — así que el mismo comando funciona contra una aplicación hermana en un espacio de trabajo multiaplicación o contra un par A2A arbitrario en otro lugar.
+
 ## Ciclo de vida de la tarea {#task-lifecycle}
 
 Cada mensaje crea una tarea que pasa por estos estados:

package/corpus/core/docs/content/locales/es-ES/agent-surfaces.mdx

@@ -6,6 +6,40 @@ search: "aplicación completa de chat enriquecido de agente sin cabeza BYO tiemp
 
 # Superficies de agentes
 
+## Espacio de trabajo completo del agente {#agent-page}
+
+Cuando una aplicación completa necesita un lugar permanente para inspeccionar y
+configurar su agente, monta `AgentTabsPage` en `/agent`. Añade la ruta a la
+navegación de la aplicación y pasa `agentPageHref="/agent"` a `AgentSidebar` para
+que los modos Resources y Settings enlacen a la página completa sin duplicar
+estos flujos.
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+La página compartida ofrece actualmente cinco pestañas:
+
+- **Context** — vista previa del ámbito, presupuesto de tokens, secciones de sistema ordenadas con procedencia y gobierno, vista de lista/treemap y la instantánea del hilo activo más reciente.
+- **Files** — vuelve a alojar `ResourcesPanel` para recursos personales o de la organización.
+- **Connections** — gestión de servidores MCP y lista de agentes remotos A2A: lo que puede llamar el agente de esta aplicación.
+- **Jobs** — trabajos recurrentes y automatizaciones con los flujos existentes de pausar/reanudar, detalles y borrar. Las automatizaciones son personales por ahora.
+- **Access** — URL de MCP, tarjeta de agente A2A cuando existe y guías de configuración compartidas; el flujo completo y el token alternativo están en `/mcp/connect`.
+
+El selector **Personal / Organization** proporciona el ámbito a las pestañas.
+Los miembros pueden inspeccionar los datos de la organización, mientras que su
+administración sigue restringida a propietarios/administradores donde el
+componente alojado impone ese límite. El
+objetivo es que el contexto sea inspeccionable, atribuible y gobernable, y
+separar capacidad de acceso. La página es una capa fina sobre componentes,
+acciones y comprobaciones existentes, no una nueva consola de administración.
+Todavía no ofrece interfaz para grants, edición de ámbitos, revocación ni
+historial de procedencia por iteración.
+
 Agent-Native es deliberadamente componible. Puedes utilizar el agente sin mucho UI,
 use el UI sin el tiempo de ejecución del agente integrado, o use ambos juntos como un completo
 solicitud.

package/corpus/core/docs/content/locales/es-ES/external-agents.mdx

@@ -117,6 +117,16 @@ Cada aplicación alojada también tiene una página de ayuda en
 `https://<app>/mcp/connect` con el URL copiable y
 pestañas específicas del host para Claude, ChatGPT, Cursor, Código Claude, Codex y Otros.
 
+### Pestaña Access dentro de la aplicación {#access-tab}
+
+Las aplicaciones que montan `AgentTabsPage` ofrecen el mismo flujo de conexión
+en la pestaña **Access**. Muestra la URL de MCP, una tarjeta del agente A2A si
+está disponible y las guías compartidas para Claude, ChatGPT, Cursor, Claude
+Code, Codex y otros clientes. Úsala como punto de partida dentro de la app y
+abre `/mcp/connect` para el flujo completo y el token alternativo. Es una
+interfaz de configuración de conexión, no una consola general de acceso: la
+pestaña todavía no gestiona grants, edición de ámbitos ni revocación.
+
 ### Claude y ChatGPT OAuth {#oauth}
 
 Escritorio Claude / Claude: agregue un conector personalizado, pegue el MCP URL, haga clic

package/corpus/core/docs/content/locales/fr-FR/a2a-protocol.mdx

@@ -384,6 +384,48 @@ environnement d'application et transmettre l'identité de l'appelant (`userEmail
 signé en tant que jetons au porteur JWT. Utilisez `apiKeyEnv` uniquement pour les anciens homologues externes qui
 attendez-vous à un jeton de porteur statique. Utilisez actions local au lieu de vous invoquer.
 
+## CLI : agent-native invoke {#cli-invoke}
+
+`agent-native invoke` est un mince wrapper CLI au-dessus de la même primitive de résolution et d'appel que `agentNative.invoke()`. Utilisez-la pour déclencher l'agent d'une application depuis un script shell, un job CI, une entrée cron, ou tout système externe capable de lancer une commande shell — l'équivalent CLI d'un POST manuel vers `/_agent-native/a2a`.
+
+```bash
+agent-native invoke <app-or-url> "prompt" [options]
+```
+
+```bash
+# Résoudre "analytics" dans le registre de l'espace de travail et attendre la réponse
+agent-native invoke analytics "Summarize signups by source this month"
+
+# Appeler une application déployée directement par URL, en lisant le jeton au porteur depuis l'environnement
+agent-native invoke https://analytics.example.com "How many signups last week?" \
+  --api-key-env ANALYTICS_A2A_KEY
+
+# Forcer un seul message/send bloquant au lieu du mode async+poll par défaut
+agent-native invoke analytics "Quick lookup" --sync
+
+# Sortie exploitable par machine pour le scripting
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| Option                    | Description                                                                              |
+| ------------------------- | ---------------------------------------------------------------------------------------- |
+| `--agent <id\|name\|url>` | Agent cible (alias de l'argument positionnel `<app-or-url>`)                             |
+| `--message <text>`        | Prompt (alias de l'argument positionnel `"prompt"`)                                      |
+| `--api-key-env <name>`    | Lit le jeton au porteur depuis une variable d'environnement                              |
+| `--api-key <token>`       | Valeur du jeton au porteur, passée directement                                           |
+| `--context-id <id>`       | `contextId` A2A, pour poursuivre la conversation d'une tâche existante                   |
+| `--self-app-id <id>`      | Identifiant de l'application courante, utilisé pour éviter les auto-appels               |
+| `--self-url <url>`        | URL de l'application courante, utilisée pour éviter les auto-appels                      |
+| `--timeout-ms <n>`        | Délai d'expiration du polling asynchrone                                                 |
+| `--poll-interval-ms <n>`  | Intervalle de polling asynchrone                                                         |
+| `--sync`                  | Utilise une seule requête `message/send` bloquante au lieu du mode async+poll par défaut |
+| `--no-hint`               | Envoie le prompt tel quel, sans l'indice d'invocation inter-application                  |
+| `--json`                  | Affiche les métadonnées de la cible et le texte de la réponse au format JSON             |
+
+Comme `callAgent()`, la CLI utilise par défaut le mode async + poll (`invokeAgent` → `callAgent` en interne), ce qui est le choix sûr face à des cibles hébergées/serverless — voir [Délais d'expiration des webhooks et passerelles serverless](#json-rpc-methods) ci-dessus. Ne passez `--sync` que lorsque vous savez que la cible n'est pas derrière une passerelle avec une limite d'exécution courte.
+
+La cible se résout de la même manière que `agentNative.invoke()` : par identifiant d'application de l'espace de travail, par nom d'application, ou par une URL complète — la même commande fonctionne donc aussi bien contre une application sœur dans un espace de travail multi-applications que contre un pair A2A arbitraire ailleurs.
+
 ## Cycle de vie des tâches {#task-lifecycle}
 
 Chaque message crée une tâche qui passe par ces états :

package/corpus/core/docs/content/locales/fr-FR/agent-surfaces.mdx

@@ -6,6 +6,40 @@ search: "Application complète de chat enrichi d'agent sans tête BYO runtime d'
 
 # Surfaces des agents
 
+## Espace de travail Agent complet {#agent-page}
+
+Lorsqu'une application complète a besoin d'un endroit durable pour inspecter et
+configurer son agent, montez `AgentTabsPage` sur `/agent`. Ajoutez la route à la
+navigation de l'application et passez `agentPageHref="/agent"` à
+`AgentSidebar` afin que les modes Resources et Settings puissent ouvrir la page
+complète sans dupliquer ces flux.
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+La page partagée propose actuellement cinq onglets :
+
+- **Context** — aperçu du périmètre, budget de tokens, sections système ordonnées avec provenance et gouvernance, vue liste/treemap et dernière capture du fil actif.
+- **Files** — réutilise `ResourcesPanel` pour les ressources personnelles ou de l'organisation.
+- **Connections** — gestion des serveurs MCP et liste des agents distants A2A : ce que l'agent de l'application peut appeler.
+- **Jobs** — tâches récurrentes et automatisations avec les flux existants de pause/reprise, détails et suppression. Les automatisations sont personnelles pour le moment.
+- **Access** — URL MCP, fiche d'agent A2A si disponible et guides de configuration partagés ; le flux complet et le repli par jeton sont disponibles sur `/mcp/connect`.
+
+Le sélecteur **Personal / Organization** fournit le périmètre aux onglets. Les
+membres peuvent inspecter les données de l'organisation, tandis que sa gestion
+reste réservée aux propriétaires/administrateurs là où le composant hébergé
+applique cette limite. Le
+but est de rendre le contexte inspectable, attribuable et gouvernable, tout en
+séparant capacité et accès. La page est une fine enveloppe autour des
+composants, actions et contrôles existants, pas une nouvelle console
+d'administration. Elle ne fournit pas encore d'interface pour les grants, la
+modification du périmètre, la révocation ou l'historique de provenance par itération.
+
 Agent-Native est délibérément composable. Vous pouvez utiliser l'agent sans trop dépenser UI,
 utilisez le UI sans le runtime d'agent intégré, ou utilisez les deux ensemble comme un ensemble complet
 application.

package/corpus/core/docs/content/locales/fr-FR/external-agents.mdx

@@ -117,6 +117,17 @@ Chaque application hébergée dispose également d'une page d'aide à l'adresse
 `https://<app>/mcp/connect` avec le URL copiable et
 Onglets spécifiques à l'hôte pour Claude, ChatGPT, Cursor, Claude Code, Codex et autres.
 
+### L'onglet Access dans l'application {#access-tab}
+
+Les applications qui montent `AgentTabsPage` proposent le même flux de connexion
+dans l'onglet **Access**. Il affiche l'URL MCP, une fiche d'agent A2A si elle est
+disponible et les guides de configuration communs pour Claude, ChatGPT, Cursor,
+Claude Code, Codex et les autres clients. Utilisez-le comme point de départ dans
+l'application, puis ouvrez `/mcp/connect` pour le flux complet et le repli par
+jeton. Il s'agit d'une interface de configuration, pas d'une console générale
+d'accès : l'onglet ne gère pas encore les grants, la modification du périmètre
+ou la révocation.
+
 ### Claude et ChatGPT OAuth {#oauth}
 
 Claude / Claude Desktop : ajoutez un connecteur personnalisé, collez le MCP URL, cliquez