@agent-native/core 0.99.2 → 0.100.0

package/corpus/core/docs/content/locales/hi-IN/a2a-protocol.mdx

@@ -384,6 +384,48 @@ dataset, or workflow. In production agent-native apps, set `A2A_SECRET` in each
 JWT वाहक टोकन के रूप में हस्ताक्षरित। `apiKeyEnv` का उपयोग केवल विरासती बाहरी समकक्षों के लिए करें
 एक स्थिर वाहक टोकन की अपेक्षा करें। स्वयं का आह्वान करने के बजाय स्थानीय actions का उपयोग करें।
 
+## सीएलआई: agent-native invoke {#cli-invoke}
+
+`agent-native invoke`, `agentNative.invoke()` के समान resolve-and-call primitive पर एक हल्का CLI wrapper है। इसका उपयोग किसी शेल स्क्रिप्ट, CI job, cron entry, या किसी भी बाहरी सिस्टम से किसी ऐप के एजेंट को ट्रिगर करने के लिए करें जो shell out कर सकता है — यह हाथ से `/_agent-native/a2a` पर पोस्ट करने के बराबर है।
+
+```bash
+agent-native invoke <app-or-url> "prompt" [options]
+```
+
+```bash
+# वर्कस्पेस रजिस्ट्री में "analytics" को resolve करें और जवाब की प्रतीक्षा करें
+agent-native invoke analytics "Summarize signups by source this month"
+
+# किसी डिप्लॉय किए गए ऐप को सीधे URL से कॉल करें, bearer token env से पढ़ते हुए
+agent-native invoke https://analytics.example.com "How many signups last week?" \
+  --api-key-env ANALYTICS_A2A_KEY
+
+# डिफ़ॉल्ट async+poll के बजाय एक ब्लॉकिंग message/send को बाध्य करें
+agent-native invoke analytics "Quick lookup" --sync
+
+# स्क्रिप्टिंग के लिए मशीन-रीडेबल आउटपुट
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| Option                    | विवरण                                                                        |
+| ------------------------- | ---------------------------------------------------------------------------- |
+| `--agent <id\|name\|url>` | लक्ष्य एजेंट (positional `<app-or-url>` का alias)                            |
+| `--message <text>`        | प्रॉम्प्ट (positional `"prompt"` का alias)                                   |
+| `--api-key-env <name>`    | एक environment variable से bearer token पढ़ें                                |
+| `--api-key <token>`       | Bearer token मान, inline पास किया गया                                        |
+| `--context-id <id>`       | A2A `contextId`, किसी मौजूदा task की बातचीत जारी रखने के लिए                 |
+| `--self-app-id <id>`      | वर्तमान app id, self-call रोकथाम के लिए उपयोग की जाती है                     |
+| `--self-url <url>`        | वर्तमान app URL, self-call रोकथाम के लिए उपयोग की जाती है                    |
+| `--timeout-ms <n>`        | Async polling timeout                                                        |
+| `--poll-interval-ms <n>`  | Async polling interval                                                       |
+| `--sync`                  | डिफ़ॉल्ट async+poll के बजाय एक blocking `message/send` request का उपयोग करें |
+| `--no-hint`               | प्रॉम्प्ट को cross-app invocation hint के बिना, ज्यों का त्यों भेजें         |
+| `--json`                  | Target metadata और response text को JSON के रूप में प्रिंट करें              |
+
+`callAgent()` की तरह, CLI डिफ़ॉल्ट रूप से async + poll (`invokeAgent` → अंदरूनी रूप से `callAgent`) का उपयोग करती है, जो hosted/serverless targets के विरुद्ध सुरक्षित विकल्प है — ऊपर [Serverless webhook and gateway timeouts](#json-rpc-methods) देखें। `--sync` का उपयोग तभी करें जब आप जानते हों कि लक्ष्य किसी छोटी execution limit वाले gateway के पीछे नहीं है।
+
+लक्ष्य वैसे ही resolve होता है जैसे `agentNative.invoke()` में होता है: workspace app id से, app name से, या पूरे URL से — इसलिए यही कमांड एक multi-app workspace में किसी sibling app के विरुद्ध या कहीं और किसी मनमाने A2A peer के विरुद्ध भी काम करता है।
+
 ## कार्य जीवनचक्र {#task-lifecycle}
 
 प्रत्येक संदेश एक कार्य बनाता है जो इन स्थितियों से होकर गुजरता है:

package/corpus/core/docs/content/locales/hi-IN/agent-surfaces.mdx

@@ -6,6 +6,37 @@ search: "हेडलेस एजेंट रिच चैट पूर्ण
 
 # एजेंट सतहें
 
+## पूरा Agent कार्यक्षेत्र {#agent-page}
+
+जब किसी पूर्ण ऐप को अपने एजेंट को देखने और कॉन्फ़िगर करने के लिए स्थायी स्थान
+चाहिए, तो `/agent` पर `AgentTabsPage` माउंट करें। ऐप नेविगेशन में यह रूट जोड़ें
+और `AgentSidebar` को `agentPageHref="/agent"` दें, ताकि Resources और Settings
+मोड इन प्रवाहों को दोहराए बिना पूरे पेज पर जा सकें।
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+साझा पेज में अभी पाँच टैब हैं:
+
+- **Context** — स्कोप प्रीव्यू, टोकन बजट, provenance और governance के साथ क्रमबद्ध सिस्टम सेक्शन, सूची/treemap दृश्य और नवीनतम live-thread snapshot।
+- **Files** — व्यक्तिगत या संगठन संसाधनों के लिए मौजूदा `ResourcesPanel` को फिर से उपयोग करता है।
+- **Connections** — MCP सर्वर प्रबंधन और A2A remote-agent सूची: यह ऐप का एजेंट क्या बुला सकता है।
+- **Jobs** — मौजूदा pause/resume, विवरण और delete प्रवाहों के साथ scoped recurring jobs और automations। Automations अभी केवल व्यक्तिगत हैं।
+- **Access** — MCP URL, उपलब्ध होने पर A2A agent card और साझा client setup guides; पूरा flow और token fallback `/mcp/connect` पर है।
+
+**Personal / Organization** टॉगल टैब का scope तय करता है। सदस्य संगठन का डेटा
+देख सकते हैं, जबकि जहाँ होस्ट किया गया component यह सीमा लागू करता है वहाँ
+संगठन प्रबंधन केवल मालिकों/व्यवस्थापकों तक सीमित रहता है। लक्ष्य context को
+inspectable, attributable और governable बनाना तथा capability को access से अलग
+रखना है। यह पेज मौजूदा components, actions और access checks की पतली shell है,
+नई admin console नहीं। Grants, scope editing, revocation या per-iteration
+provenance history की UI अभी उपलब्ध नहीं है।
+
 Agent-Native जानबूझकर रचना योग्य है। आप एजेंट का उपयोग बहुत अधिक UI के बिना कर सकते हैं,
 अंतर्निहित एजेंट रनटाइम के बिना UI का उपयोग करें, या दोनों को पूर्ण रूप में एक साथ उपयोग करें
 आवेदन.

package/corpus/core/docs/content/locales/hi-IN/external-agents.mdx

@@ -117,6 +117,15 @@ https://<your-app>.agent-native.com/mcp
 `https://&lt;app&gt;/mcp/connect` प्रतिलिपि योग्य URL और
 Claude, ChatGPT, कर्सर, Claude कोड, Codex और अन्य के लिए होस्ट-विशिष्ट टैब।
 
+### ऐप के अंदर Access टैब {#access-tab}
+
+`AgentTabsPage` माउंट करने वाले ऐप **Access** टैब में यही कनेक्शन फ्लो देते हैं।
+यह MCP URL, उपलब्ध होने पर A2A agent card और Claude, ChatGPT, Cursor, Claude
+Code, Codex तथा अन्य clients के साझा setup guides दिखाता है। इसे ऐप के अंदर
+शुरुआत के रूप में उपयोग करें और पूरे flow तथा token fallback के लिए
+`/mcp/connect` खोलें। यह connection setup UI है, सामान्य access console नहीं;
+टैब अभी grants, scope editing या revocation को manage नहीं करता।
+
 ### Claude और ChatGPT OAuth {#oauth}
 
 Claude / Claude डेस्कटॉप: एक कस्टम कनेक्टर जोड़ें, MCP URL पेस्ट करें, क्लिक करें

package/corpus/core/docs/content/locales/ja-JP/a2a-protocol.mdx

@@ -384,6 +384,48 @@ console.log(`Called ${result.target.name}: ${result.responseText}`);
 JWT ベアラー トークンとして署名されています。 `apiKeyEnv` は、
 静的なベアラー トークンが必要です。自分自身を呼び出す代わりに、ローカルの actions を使用してください。
 
+## CLI: agent-native invoke {#cli-invoke}
+
+`agent-native invoke` は、`agentNative.invoke()` と同じ解決・呼び出しプリミティブを薄くラップした CLI です。シェル スクリプト、CI ジョブ、cron エントリ、またはシェルアウトできる任意の外部システムからアプリのエージェントをトリガーするために使用します。手動で `/_agent-native/a2a` に POST するのと同等の CLI 版です。
+
+```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
+
+# デフォルトの async+poll の代わりに、ブロッキングの message/send を1回だけ強制する
+agent-native invoke analytics "Quick lookup" --sync
+
+# スクリプト用の機械可読な出力
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| Option                    | Description                                                                         |
+| ------------------------- | ----------------------------------------------------------------------------------- |
+| `--agent <id\|name\|url>` | 対象のエージェント（位置引数 `<app-or-url>` のエイリアス）                          |
+| `--message <text>`        | プロンプト（位置引数 `"prompt"` のエイリアス）                                      |
+| `--api-key-env <name>`    | 環境変数からベアラー トークンを読み取る                                             |
+| `--api-key <token>`       | ベアラー トークンの値をインラインで渡す                                             |
+| `--context-id <id>`       | A2A の `contextId`。既存タスクの会話を継続するために使用                            |
+| `--self-app-id <id>`      | 自己呼び出し防止に使われる、現在のアプリ id                                         |
+| `--self-url <url>`        | 自己呼び出し防止に使われる、現在のアプリ URL                                        |
+| `--timeout-ms <n>`        | 非同期ポーリングのタイムアウト                                                      |
+| `--poll-interval-ms <n>`  | 非同期ポーリングの間隔                                                              |
+| `--sync`                  | デフォルトの async+poll の代わりに、ブロッキングの `message/send` を1回だけ使用する |
+| `--no-hint`               | クロスアプリ呼び出しのヒントを付けずに、プロンプトをそのまま送信する                |
+| `--json`                  | ターゲットのメタデータと応答テキストを JSON として出力する                          |
+
+`callAgent()` と同様に、この CLI もデフォルトで async + poll を使用します（内部的には `invokeAgent` → `callAgent`）。これはホスト型/サーバーレスのターゲットに対して安全な選択です。上記の [サーバーレスの Webhook とゲートウェイのタイムアウト](#json-rpc-methods) を参照してください。ターゲットが短い実行時間制限のあるゲートウェイの背後にないとわかっている場合にのみ `--sync` を渡してください。
+
+ターゲットは `agentNative.invoke()` と同じ方法で解決されます: ワークスペースのアプリ id、アプリ名、または完全な URL のいずれかです。そのため、同じコマンドがマルチアプリ ワークスペース内の兄弟アプリに対しても、どこか別の場所にある任意の A2A ピアに対しても機能します。
+
 ## タスクのライフサイクル {#task-lifecycle}
 
 各メッセージは、次の状態を通過するタスクを作成します。

package/corpus/core/docs/content/locales/ja-JP/agent-surfaces.mdx

@@ -6,6 +6,38 @@ search: "ヘッドレス エージェント リッチ チャット フル アプ
 
 # エージェント サーフェス
 
+## フルページの Agent ワークスペース {#agent-page}
+
+完全なアプリケーションでエージェントを確認・設定する常設の場所が必要な
+場合は、`/agent` に `AgentTabsPage` をマウントします。アプリのナビゲーション
+にこのルートを追加し、`AgentSidebar` に `agentPageHref="/agent"` を渡すと、
+Resources と Settings から同じフローを重複させずにフルページへ移動できます。
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+共有ページには現在、5 つのタブがあります。
+
+- **Context** — スコープのプレビュー、トークン予算、provenance・governance・source で整理された順序付きシステムセクション、リスト/treemap 表示、最新の live thread スナップショット。
+- **Files** — 個人または組織のリソース用に既存の `ResourcesPanel` を再ホストします。
+- **Connections** — MCP サーバー管理と A2A リモートエージェント一覧。アプリのエージェントが呼び出せるものを示します。
+- **Jobs** — 既存の一時停止/再開、詳細、削除フローを備えたスコープ別の定期ジョブと自動化。自動化は現在個人用です。
+- **Access** — MCP URL、利用可能なら A2A エージェントカード、共通のクライアント設定ガイドを表示します。完全な接続フローとトークンのフォールバックは `/mcp/connect` にあります。
+
+ページの **Personal / Organization** 切り替えが各タブのスコープを指定します。
+メンバーは組織データを確認できますが、ホストされたコンポーネントがその境界を
+適用する箇所では、組織管理は所有者/管理者に制限されます。
+目的はコンテキストを inspectable・attributable・governable にし、capability と
+access を分離することです。このページは既存のコンポーネント、アクション、
+アクセスチェックを再利用する薄いシェルであり、新しい管理コンソールでは
+ありません。grants、スコープ編集、revoke、反復ごとの provenance 履歴の UI は
+まだ提供していません。
+
 Agent-Native は意図的に構成可能です。 UI をあまり必要とせずにエージェントを使用できます。
 組み込みエージェント ランタイムなしで UI を使用するか、両方を完全なものとして一緒に使用します
 アプリケーション。

package/corpus/core/docs/content/locales/ja-JP/external-agents.mdx

@@ -117,6 +117,16 @@ https://<your-app>.agent-native.com/mcp
 `https://&lt;app&gt;/mcp/connect` とコピー可能な URL および
 Claude、ChatGPT、カーソル、Claude コード、Codex、その他のホスト固有のタブ。
 
+### アプリ内の Access タブ {#access-tab}
+
+`AgentTabsPage` をマウントするアプリでは、同じ接続フローを **Access** タブ
+から利用できます。MCP URL、利用可能な場合は A2A エージェント カード、Claude、
+ChatGPT、Cursor、Claude Code、Codex、その他のクライアント向けの共通設定ガイドを
+表示します。アプリ内の開始点として使い、完全なフローとトークンのフォールバック
+には `/mcp/connect` を開きます。これは接続設定 UI であり、一般的なアクセス管理
+コンソールではありません。grants、スコープ編集、revoke はこのタブではまだ管理
+できません。
+
 ### Claude および ChatGPT OAuth {#oauth}
 
 Claude / Claude デスクトップ: カスタム コネクタを追加し、MCP URL を貼り付け、クリックします

package/corpus/core/docs/content/locales/ko-KR/a2a-protocol.mdx

@@ -384,6 +384,48 @@ console.log(`Called ${result.target.name}: ${result.responseText}`);
 JWT 전달자 토큰으로 서명되었습니다. 다음과 같은 레거시 외부 피어에만 `apiKeyEnv`를 사용하세요.
 정적 전달자 토큰이 필요합니다. 자신을 호출하는 대신 로컬 actions를 사용하세요.
 
+## CLI: agent-native invoke {#cli-invoke}
+
+`agent-native invoke`는 `agentNative.invoke()`와 동일한 확인 후 호출(resolve-and-call) 기본 로직을 감싼 얇은 CLI 래퍼입니다. 셸 스크립트, CI 작업, cron 항목, 또는 셸 아웃이 가능한 다른 외부 시스템에서 앱의 에이전트를 트리거할 때 사용하세요 — `/_agent-native/a2a`에 직접 POST하는 것과 동일한 CLI 방식입니다.
+
+```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
+
+# 기본값인 async+poll 대신 블로킹 message/send 하나만 강제로 사용합니다
+agent-native invoke analytics "Quick lookup" --sync
+
+# 스크립팅을 위한 기계 판독 가능한 출력
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| 옵션                      | 설명                                                                  |
+| ------------------------- | --------------------------------------------------------------------- |
+| `--agent <id\|name\|url>` | 대상 에이전트 (위치 인수 `<app-or-url>`의 별칭)                       |
+| `--message <text>`        | 프롬프트 (위치 인수 `"prompt"`의 별칭)                                |
+| `--api-key-env <name>`    | 환경 변수에서 전달자 토큰을 읽습니다                                  |
+| `--api-key <token>`       | 전달자 토큰 값을 인라인으로 전달합니다                                |
+| `--context-id <id>`       | 기존 작업의 대화를 이어가기 위한 A2A `contextId`                      |
+| `--self-app-id <id>`      | 자체 호출 방지에 사용되는 현재 앱 id                                  |
+| `--self-url <url>`        | 자체 호출 방지에 사용되는 현재 앱 URL                                 |
+| `--timeout-ms <n>`        | 비동기 폴링 타임아웃                                                  |
+| `--poll-interval-ms <n>`  | 비동기 폴링 간격                                                      |
+| `--sync`                  | 기본값인 async+poll 대신 블로킹 `message/send` 요청 하나를 사용합니다 |
+| `--no-hint`               | 크로스 앱 호출 힌트 없이 프롬프트를 그대로 전송합니다                 |
+| `--json`                  | 대상 메타데이터와 응답 텍스트를 JSON으로 출력합니다                   |
+
+`callAgent()`와 마찬가지로 CLI는 기본적으로 async + poll을 사용하며(내부적으로 `invokeAgent` → `callAgent`), 이는 호스팅/서버리스 대상에 대한 안전한 선택입니다 — 위의 [서버리스 웹훅 및 게이트웨이 타임아웃](#json-rpc-methods)을 참조하세요. 대상이 짧은 실행 제한이 있는 게이트웨이 뒤에 있지 않다는 것을 알 때만 `--sync`를 전달하세요.
+
+대상은 `agentNative.invoke()`와 동일한 방식으로 확인됩니다. 작업공간 앱 id, 앱 이름, 또는 전체 URL로 확인되므로 동일한 명령이 멀티 앱 작업공간의 형제 앱이나 다른 곳의 임의의 A2A 피어 모두에 대해 작동합니다.
+
 ## 작업 수명 주기 {#task-lifecycle}
 
 각 메시지는 다음 상태를 거쳐 이동하는 작업을 생성합니다.

package/corpus/core/docs/content/locales/ko-KR/agent-surfaces.mdx

@@ -6,6 +6,38 @@ search: "헤드리스 에이전트 리치 채팅 전체 앱 BYO 에이전트 런
 
 # 에이전트 표면
 
+## 전체 Agent 작업 공간 {#agent-page}
+
+전체 애플리케이션에서 에이전트를 검사하고 구성할 영구 공간이 필요하면
+`/agent`에 `AgentTabsPage`를 마운트하세요. 앱 탐색에 이 경로를 추가하고
+`AgentSidebar`에 `agentPageHref="/agent"`를 전달하면 Resources 및 Settings
+모드에서 흐름을 중복하지 않고 전체 페이지로 이동할 수 있습니다.
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+공유 페이지에는 현재 다섯 개의 탭이 있습니다.
+
+- **Context** — 범위 미리보기, 토큰 예산, provenance·governance·source별 정렬된 시스템 섹션, 목록/treemap 보기, 최신 live-thread 스냅샷을 보여줍니다.
+- **Files** — 개인 또는 조직 리소스에 기존 `ResourcesPanel`을 다시 호스팅합니다.
+- **Connections** — MCP 서버 관리와 A2A 원격 에이전트 목록을 제공하며, 앱 에이전트가 호출할 수 있는 기능을 보여줍니다.
+- **Jobs** — 기존 일시 중지/재개, 상세, 삭제 흐름을 사용하는 범위별 반복 작업과 자동화입니다. 자동화는 현재 개인용입니다.
+- **Access** — MCP URL, 가능한 경우 A2A 에이전트 카드, 공통 클라이언트 설정 가이드를 보여줍니다. 전체 연결 흐름과 토큰 대체 경로는 `/mcp/connect`에 있습니다.
+
+페이지의 **Personal / Organization** 전환이 각 탭의 범위를 정합니다.
+구성원은 조직 데이터를 검사할 수 있지만, 호스팅된 컴포넌트가 이 경계를 적용하는
+곳에서는 조직 관리가 소유자/관리자로 제한됩니다. 목표는
+컨텍스트를 검사 가능하고 출처를 확인할 수 있으며 거버넌스 가능하게 만들고,
+기능(capability)과 접근(access)을 분리하는 것입니다. 이 페이지는 기존
+컴포넌트, 액션, 접근 검사를 재호스트하는 얇은 셸이며 새로운 관리자 콘솔이
+아닙니다. grants, 범위 편집, 취소 UI와 반복별 provenance 기록은 아직 제공하지
+않습니다.
+
 Agent-Native는 의도적으로 구성 가능합니다. UI를 많이 사용하지 않고도 에이전트를 사용할 수 있습니다,
 내장된 에이전트 런타임 없이 UI를 사용하거나 둘 다 전체로 함께 사용
 신청.

package/corpus/core/docs/content/locales/ko-KR/external-agents.mdx

@@ -117,6 +117,15 @@ https://<your-app>.agent-native.com/mcp
 복사 가능한 URL가 있는 `https://&lt;app&gt;/mcp/connect` 및
 Claude, ChatGPT, 커서, Claude 코드, Codex 및 기타에 대한 호스트별 탭.
 
+### 앱 내 Access 탭 {#access-tab}
+
+`AgentTabsPage`를 마운트하는 앱은 **Access** 탭에서 동일한 연결 흐름을
+제공합니다. MCP URL, 가능한 경우 A2A 에이전트 카드, Claude, ChatGPT, Cursor,
+Claude Code, Codex 및 기타 클라이언트를 위한 공통 설정 가이드를 보여줍니다.
+앱 안에서 시작점으로 사용하고 전체 흐름과 토큰 대체 경로는 `/mcp/connect`에서
+여세요. 이 탭은 연결 설정 UI이지 일반 접근 제어 콘솔이 아니며, grants, 범위
+편집, 취소는 아직 관리하지 않습니다.
+
 ### Claude 및 ChatGPT OAuth {#oauth}
 
 Claude / Claude 데스크탑: 사용자 정의 커넥터를 추가하고 MCP URL를 붙여넣고 클릭하세요.

package/corpus/core/docs/content/locales/pt-BR/a2a-protocol.mdx

@@ -386,6 +386,48 @@ ambiente do aplicativo e passe a identidade do chamador (`userEmail`) para que a
 assinado como tokens ao portador JWT. Use `apiKeyEnv` apenas para pares externos legados que
 espera um token de portador estático. Use actions local em vez de invocar você mesmo.
 
+## CLI: agent-native invoke {#cli-invoke}
+
+`agent-native invoke` é um wrapper de CLI simples sobre a mesma primitiva de resolver-e-chamar usada por `agentNative.invoke()`. Use-o para acionar o agente de um aplicativo a partir de um script de shell, um job de CI, uma entrada de cron ou qualquer sistema externo que possa executar comandos de shell — o equivalente em CLI de postar manualmente em `/_agent-native/a2a`.
+
+```bash
+agent-native invoke <app-or-url> "prompt" [options]
+```
+
+```bash
+# Resolve "analytics" no registro do espaço de trabalho e aguarda a resposta
+agent-native invoke analytics "Summarize signups by source this month"
+
+# Chama um aplicativo implantado diretamente por URL, lendo o token de portador a partir de uma variável de ambiente
+agent-native invoke https://analytics.example.com "How many signups last week?" \
+  --api-key-env ANALYTICS_A2A_KEY
+
+# Força uma única mensagem/envio bloqueante em vez do padrão assíncrono+polling
+agent-native invoke analytics "Quick lookup" --sync
+
+# Saída legível por máquina para uso em scripts
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| Option                    | Description                                                                            |
+| ------------------------- | -------------------------------------------------------------------------------------- |
+| `--agent <id\|name\|url>` | Agente de destino (alias para o argumento posicional `<app-or-url>`)                   |
+| `--message <text>`        | Prompt (alias para o argumento posicional `"prompt"`)                                  |
+| `--api-key-env <name>`    | Lê o token de portador a partir de uma variável de ambiente                            |
+| `--api-key <token>`       | Valor do token de portador, passado diretamente                                        |
+| `--context-id <id>`       | `contextId` do A2A, para continuar a conversa de uma tarefa existente                  |
+| `--self-app-id <id>`      | ID do aplicativo atual, usado para evitar autochamadas                                 |
+| `--self-url <url>`        | URL do aplicativo atual, usada para evitar autochamadas                                |
+| `--timeout-ms <n>`        | Tempo limite do polling assíncrono                                                     |
+| `--poll-interval-ms <n>`  | Intervalo do polling assíncrono                                                        |
+| `--sync`                  | Usa uma única requisição `message/send` bloqueante em vez do padrão assíncrono+polling |
+| `--no-hint`               | Envia o prompt como está, sem a dica de invocação entre aplicativos                    |
+| `--json`                  | Imprime os metadados do destino e o texto da resposta como JSON                        |
+
+Assim como `callAgent()`, a CLI usa por padrão o modo assíncrono + polling (`invokeAgent` → `callAgent` internamente), que é a escolha segura contra destinos hospedados/serverless — veja [Tempos limite de webhook e gateway serverless](#json-rpc-methods) acima. Passe `--sync` somente quando você souber que o destino não está atrás de um gateway com um limite de execução curto.
+
+O destino é resolvido da mesma forma que em `agentNative.invoke()`: pelo ID do aplicativo no espaço de trabalho, pelo nome do aplicativo ou por uma URL completa — assim, o mesmo comando funciona tanto contra um aplicativo irmão em um espaço de trabalho com múltiplos aplicativos quanto contra um par A2A arbitrário em outro lugar.
+
 ## Ciclo de vida da tarefa {#task-lifecycle}
 
 Cada mensagem cria uma tarefa que passa por estes estados:

package/corpus/core/docs/content/locales/pt-BR/agent-surfaces.mdx

@@ -6,6 +6,39 @@ search: "aplicativo completo de bate-papo rico com agente sem cabeça BYO tempo
 
 # Superfícies do agente
 
+## Espaço de trabalho completo do Agent {#agent-page}
+
+Quando um aplicativo completo precisa de um lugar permanente para inspecionar e
+configurar seu agente, monte `AgentTabsPage` em `/agent`. Adicione a rota à
+navegação do aplicativo e passe `agentPageHref="/agent"` para `AgentSidebar`,
+para que os modos Resources e Settings apontem para a página completa sem
+duplicar esses fluxos.
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+A página compartilhada oferece atualmente cinco abas:
+
+- **Context** — prévia do escopo, orçamento de tokens, seções de sistema ordenadas por procedência, governança e fonte, visualização em lista/treemap e o snapshot da thread ativa mais recente.
+- **Files** — reutiliza `ResourcesPanel` para recursos pessoais ou da organização.
+- **Connections** — gerenciamento de servidores MCP e lista de agentes remotos A2A: o que o agente deste app pode chamar.
+- **Jobs** — jobs recorrentes e automações com os fluxos existentes de pausar/retomar, detalhes e excluir. As automações são pessoais por enquanto.
+- **Access** — URL MCP, cartão de agente A2A quando disponível e guias compartilhados de configuração; o fluxo completo e o fallback de token ficam em `/mcp/connect`.
+
+O seletor **Personal / Organization** fornece o escopo às abas. Os membros
+podem inspecionar os dados da organização, enquanto sua administração continua
+restrita a proprietários/administradores onde o componente hospedado impõe esse
+limite. O objetivo é
+tornar o contexto inspecionável, atribuível e governável, separando capacidade
+de acesso. A página é uma camada fina sobre componentes, ações e verificações de
+acesso existentes, não um novo console administrativo. Ela ainda não oferece UI
+para grants, edição de escopo, revogação ou histórico de procedência por iteração.
+
 Agent-Native é deliberadamente combinável. Você pode usar o agente sem muito UI,
 use o UI sem o tempo de execução do agente integrado ou use os dois juntos como um pacote completo
 aplicativo.

package/corpus/core/docs/content/locales/pt-BR/external-agents.mdx

@@ -117,6 +117,16 @@ Todo aplicativo hospedado também tem uma página auxiliar em
 `https://<app>/mcp/connect` com o URL copiável e
 guias específicas do host para Claude, ChatGPT, Cursor, Código Claude, Codex e Outros.
 
+### A aba Access no aplicativo {#access-tab}
+
+Os aplicativos que montam `AgentTabsPage` oferecem o mesmo fluxo de conexão na
+aba **Access**. Ela mostra a URL MCP, um cartão de agente A2A quando disponível e
+os guias compartilhados de configuração para Claude, ChatGPT, Cursor, Claude
+Code, Codex e outros clientes. Use-a como ponto de partida dentro do app e abra
+`/mcp/connect` para o fluxo completo e o fallback de token. É uma UI de
+configuração de conexão, não um console geral de acesso: a aba ainda não gerencia
+grants, edição de escopo ou revogação.
+
 ### Claude e ChatGPT OAuth {#oauth}
 
 Claude / Claude Desktop: adicione um conector personalizado, cole o MCP URL, clique em

package/corpus/core/docs/content/locales/zh-CN/a2a-protocol.mdx

@@ -384,6 +384,48 @@ console.log(`Called ${result.target.name}: ${result.responseText}`);
 签名为 JWT 不记名代币。仅将 `apiKeyEnv` 用于旧版外部对等点
 需要静态不记名令牌。使用本地actions而不是自己调用。
 
+## CLI：agent-native invoke {#cli-invoke}
+
+`agent-native invoke` 是对与 `agentNative.invoke()` 相同的解析并调用原语的一层轻量 CLI 包装。用它可以从 shell 脚本、CI 任务、cron 条目或任何能够执行 shell 命令的外部系统触发某个应用的代理——相当于手动向 `/_agent-native/a2a` 发送 POST 请求的命令行等价形式。
+
+```bash
+agent-native invoke <app-or-url> "prompt" [options]
+```
+
+```bash
+# 在工作区注册表中解析 "analytics" 并等待回复
+agent-native invoke analytics "Summarize signups by source this month"
+
+# 通过 URL 直接调用一个已部署的应用，从环境变量中读取 bearer token
+agent-native invoke https://analytics.example.com "How many signups last week?" \
+  --api-key-env ANALYTICS_A2A_KEY
+
+# 强制使用一次阻塞式 message/send，而不是默认的异步+轮询方式
+agent-native invoke analytics "Quick lookup" --sync
+
+# 输出机器可读的结果，便于脚本处理
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| Option                    | Description                                                 |
+| ------------------------- | ----------------------------------------------------------- |
+| `--agent <id\|name\|url>` | 目标代理（是位置参数 `<app-or-url>` 的别名）                |
+| `--message <text>`        | 提示词（是位置参数 `"prompt"` 的别名）                      |
+| `--api-key-env <name>`    | 从环境变量中读取 bearer token                               |
+| `--api-key <token>`       | 直接内联传入的 bearer token 值                              |
+| `--context-id <id>`       | A2A 的 `contextId`，用于延续已有任务的对话                  |
+| `--self-app-id <id>`      | 当前应用 id，用于防止自我调用                               |
+| `--self-url <url>`        | 当前应用 URL，用于防止自我调用                              |
+| `--timeout-ms <n>`        | 异步轮询超时时间                                            |
+| `--poll-interval-ms <n>`  | 异步轮询间隔                                                |
+| `--sync`                  | 使用一次阻塞式 `message/send` 请求，而非默认的异步+轮询方式 |
+| `--no-hint`               | 原样发送提示词，不附加跨应用调用提示                        |
+| `--json`                  | 以 JSON 形式打印目标元数据和响应文本                        |
+
+与 `callAgent()` 一样，该 CLI 默认使用异步+轮询方式（底层是 `invokeAgent` → `callAgent`），这是针对托管/无服务器目标的安全选择——参见上文的[无服务器 webhook 与网关超时](#json-rpc-methods)。只有在确定目标不在执行时间受限的网关之后时，才传入 `--sync`。
+
+目标的解析方式与 `agentNative.invoke()` 相同：通过工作区应用 id、应用名称，或完整 URL——因此同一条命令既适用于多应用工作区中的同级应用，也适用于其他地方任意的 A2A 对等端。
+
 ## 任务生命周期 {#task-lifecycle}
 
 每条消息都会创建一个在以下状态之间移动的任务：

package/corpus/core/docs/content/locales/zh-CN/agent-surfaces.mdx

@@ -6,6 +6,35 @@ search: "无头代理丰富聊天完整应用程序 BYO 代理运行时 AgentCha
 
 # 特工表面
 
+## 完整的 Agent 工作区 {#agent-page}
+
+当完整应用需要一个持久位置来检查和配置代理时，请在 `/agent` 挂载
+`AgentTabsPage`。将此路由加入应用导航，并向 `AgentSidebar` 传入
+`agentPageHref="/agent"`，这样 Resources 和 Settings 模式就可以链接到完整
+页面，而不必重复这些流程。
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+共享页面目前提供五个选项卡：
+
+- **Context** — 显示范围预览、令牌预算、按来源/治理/来源引用分组的有序系统部分、列表/treemap 视图和最新实时线程快照。
+- **Files** — 为个人或组织资源重新托管现有的 `ResourcesPanel`。
+- **Connections** — MCP 服务器管理和 A2A 远程代理列表，即此应用的代理可以调用什么。
+- **Jobs** — 使用现有暂停/恢复、详情和删除流程的范围化定期作业与自动化。自动化目前仅属于个人。
+- **Access** — MCP URL、可用时的 A2A 代理卡片以及共享客户端设置指南；完整连接流程和令牌回退位于 `/mcp/connect`。
+
+页面级 **Personal / Organization** 切换器为选项卡提供范围。成员可以检查组织
+数据；在托管组件实施该边界的地方，组织管理仍仅限所有者/管理员。目标是让上下文
+可检查、可归因、可治理，并将能力与访问分开。该页面只是对现有组件、操作和
+访问检查的薄封装，不是新的管理控制台。目前还没有 grants、范围编辑、撤销
+界面或逐迭代 provenance 历史。
+
 Agent-Native 是故意可组合的。不用太多就可以使用代理UI，
 在没有内置代理运行时的情况下使用 UI，或者将两者一起用作完整的
 应用程序。

package/corpus/core/docs/content/locales/zh-CN/external-agents.mdx

@@ -117,6 +117,14 @@ https://<your-app>.agent-native.com/mcp
 `https://&lt;app&gt;/mcp/connect` 与可复制的 URL 和
 Claude、ChatGPT、光标、Claude 代码、Codex 和其他的主机特定选项卡。
 
+### 应用内的 Access 选项卡 {#access-tab}
+
+挂载 `AgentTabsPage` 的应用也会在 **Access** 选项卡中提供相同的连接流程。
+它显示 MCP URL、可用时的 A2A 代理卡片，以及 Claude、ChatGPT、Cursor、Claude
+Code、Codex 和其他客户端的共享设置指南。可将它作为应用内的起点，并打开
+`/mcp/connect` 查看完整流程和令牌回退。这是连接设置界面，不是通用访问控制
+台；该选项卡目前还不管理 grants、范围编辑或撤销。
+
 ### Claude 和 ChatGPT OAuth {#oauth}
 
 Claude / Claude 桌面：添加自定义连接器，粘贴 MCP URL，点击

package/corpus/core/docs/content/locales/zh-TW/a2a-protocol.mdx

@@ -384,6 +384,48 @@ console.log(`Called ${result.target.name}: ${result.responseText}`);
 簽名為 JWT 不記名代幣。僅將 `apiKeyEnv` 用於舊版外部對等點
 需要靜態不記名權杖。使用本機actions而不是自己呼叫。
 
+## CLI：agent-native invoke {#cli-invoke}
+
+`agent-native invoke` 是一個薄的 CLI 包裝器，架構在與 `agentNative.invoke()` 相同的解析並呼叫的基本操作之上。使用它可以從 shell 腳本、CI 工作、cron 項目，或任何可以執行外部指令的系統觸發應用程式的代理——相當於手動向 `/_agent-native/a2a` 發送 POST 請求的 CLI 版本。
+
+```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，而非預設的非同步+輪詢
+agent-native invoke analytics "Quick lookup" --sync
+
+# 為腳本編寫提供機器可讀輸出
+agent-native invoke analytics "Summarize signups" --json
+```
+
+| 選項                      | 描述                                                      |
+| ------------------------- | --------------------------------------------------------- |
+| `--agent <id\|name\|url>` | 目標代理（位置參數 `<app-or-url>` 的別名）                |
+| `--message <text>`        | 提示（位置參數 `"prompt"` 的別名）                        |
+| `--api-key-env <name>`    | 從環境變數讀取不記名權杖                                  |
+| `--api-key <token>`       | 直接內嵌傳入的不記名權杖值                                |
+| `--context-id <id>`       | A2A `contextId`，用於延續現有工作的對話                   |
+| `--self-app-id <id>`      | 目前應用程式 ID，用於防止自我呼叫                         |
+| `--self-url <url>`        | 目前應用程式 URL，用於防止自我呼叫                        |
+| `--timeout-ms <n>`        | 非同步輪詢逾時時間                                        |
+| `--poll-interval-ms <n>`  | 非同步輪詢間隔                                            |
+| `--sync`                  | 使用一次阻塞式 `message/send` 請求，取代預設的非同步+輪詢 |
+| `--no-hint`               | 按原樣傳送提示，不加入跨應用程式呼叫提示                  |
+| `--json`                  | 以 JSON 格式輸出目標中繼資料與回應文字                    |
+
+與 `callAgent()` 一樣，此 CLI 預設使用非同步+輪詢（底層是 `invokeAgent` → `callAgent`），這是針對託管/無伺服器目標的安全選擇——請參閱上方的[無伺服器 webhook 與閘道逾時](#json-rpc-methods)。只有在確定目標不在具有短執行限制的閘道之後時，才傳入 `--sync`。
+
+目標的解析方式與 `agentNative.invoke()` 相同：透過工作區應用程式 ID、應用程式名稱，或完整 URL——因此同一指令在多應用程式工作區中的同級應用程式，或其他地方的任意 A2A 對等點上都能運作。
+
 ## 工作生命週期 {#task-lifecycle}
 
 每條訊息都會建立一個在以下狀態之間移動的工作：

package/corpus/core/docs/content/locales/zh-TW/agent-surfaces.mdx

@@ -6,6 +6,35 @@ search: "無頭代理豐富聊天完整應用程式 BYO 代理執行時 AgentCha
 
 # 代理表面
 
+## 完整的 Agent 工作區 {#agent-page}
+
+當完整應用程式需要一個持久位置來檢查和設定代理時，請在 `/agent` 掛載
+`AgentTabsPage`。將此路由加入應用程式導覽，並向 `AgentSidebar` 傳入
+`agentPageHref="/agent"`，這樣 Resources 和 Settings 模式就能連結到完整頁面，
+而不必重複這些流程。
+
+```tsx filename="app/routes/agent.tsx"
+import { AgentTabsPage } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return <AgentTabsPage />;
+}
+```
+
+共用頁面目前提供五個分頁：
+
+- **Context** — 顯示範圍預覽、權杖預算、按來源/治理/來源參照分組的有序系統區段、清單/treemap 檢視和最新即時執行緒快照。
+- **Files** — 為個人或組織資源重新託管現有的 `ResourcesPanel`。
+- **Connections** — MCP 伺服器管理和 A2A 遠端代理清單，也就是此應用程式的代理可以呼叫什麼。
+- **Jobs** — 使用現有暫停/恢復、詳細資料和刪除流程的範圍化定期工作與自動化。自動化目前僅限個人。
+- **Access** — MCP URL、可用時的 A2A 代理卡片以及共用用戶端設定指南；完整連線流程和權杖備援位於 `/mcp/connect`。
+
+頁面級 **Personal / Organization** 切換器為分頁提供範圍。成員可以檢查組織
+資料；在託管元件實施該界線的地方，組織管理仍僅限擁有者/管理員。目標是讓內容可
+檢查、可歸因、可治理，並將能力與存取分開。此頁面只是對現有元件、動作和
+存取檢查的薄封裝，不是新的管理主控台。目前還沒有 grants、範圍編輯、撤銷
+介面或逐次迭代的 provenance 歷史。
+
 Agent-Native 是故意可組合的。不用太多就可以使用代理 UI，
 在沒有內建代理執行時的情況下使用 UI，或者將兩者一起用作完整的
 應用程式。