@agent-native/core 0.106.1 → 0.106.3

package/dist/server/agent-engine-api-key-route.d.ts

@@ -27,11 +27,11 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
+    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
-    error?: undefined;
 }>>;
 export {};
 //# sourceMappingURL=agent-engine-api-key-route.d.ts.map

package/docs/content/external-agents.mdx

@@ -560,6 +560,14 @@ and `taskId`; the result includes `pollAfterMs` as a host-friendly interval.
 The task must be created before the first response can time out, so a polling
 URL returned only after a long call is not a reliable recovery contract.
 
+If a bounded transient status read is unavailable, `ask_app_status` can return
+`status: "unknown"`, `statusRead: "unavailable"`, `retryable: true`, the
+original `app` and `taskId`, and `pollAfterMs` / `poll`. This means the status
+read is unavailable—not that the durable task failed. Retry `ask_app_status`
+with that exact `app` and `taskId`; never resubmit `ask_app` to recover, because
+submission can duplicate work. Permanent authentication, not-found, and
+protocol failures remain errors.
+
 ### Per-app tour {#tour}
 
 Every allow-listed template that produces or lists a navigable resource ships a `link` builder, and the ingest-heavy ones ship a GET + `publicAgent` action so a connected agent can pull live state:

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

@@ -527,6 +527,13 @@ Claude Code calls: manage-draft(to: "john@example.com", subject: "Q3 Report", bo
 
 لا تشترك مضيفات وبوابات MCP في مهلة زمنية واحدة طويلة لاستدعاء الأداة؛ يفرض بعضها حدًا أقصى مدته خمس دقائق بينما يكون بعضها الآخر قابلاً للتكوين. لا تصمم تكامل الوكيل الخارجي بالاعتماد على استدعاء `tools/call` محظور لمدة عشر دقائق. يقر كل من `ask-agent` و`ask_app` بالعمل المستضاف بسرعة، ثم يُرجعان `taskId` دائمًا عند انتهاء مهلة الانتظار المضمّن. استطلع باستخدام `ask_app_status` مستخدمًا `app` و`taskId` المُرجعين؛ وتتضمن النتيجة `pollAfterMs` كفاصل زمني ملائم للمضيف. يجب إنشاء المهمة قبل أن تنتهي مهلة الاستجابة الأولى، لذا فإن رابط الاستطلاع الذي يُرجع فقط بعد استدعاء طويل ليس عقد استرداد يمكن الاعتماد عليه.
 
+عند عدم إتاحة قراءة حالة عابرة ومحدودة المدة، يمكن أن تُرجع `ask_app_status` القيم
+`status: "unknown"` و`statusRead: "unavailable"` و`retryable: true`، إلى جانب
+`app` و`taskId` الأصليين و`pollAfterMs` / `poll`. يعني ذلك أن قراءة الحالة غير
+متاحة، وليس أن المهمة الدائمة قد فشلت. أعد محاولة `ask_app_status` باستخدام `app`
+و`taskId` نفسيهما تمامًا؛ ولا تعِد إرسال `ask_app` للاسترداد مطلقًا، إذ قد يكرر
+الإرسال العمل. تظل أخطاء المصادقة الدائمة أو عدم العثور أو البروتوكول أخطاءً.
+
 ### جولة لكل تطبيق {#tour}
 
 يقوم كل قالب مدرج في القائمة المسموح بها ينتج موردًا قابلاً للملاحة أو يسرده بشحن أداة إنشاء `link`، وتقوم القوالب ذات الاستيعاب الثقيل بشحن إجراء GET + `publicAgent` حتى يتمكن الوكيل المتصل من سحب الحالة المباشرة:

package/docs/content/locales/ar-SA/mcp-protocol.mdx

@@ -231,6 +231,13 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
 
 استدعِ `ask_app_status` بتلك الوسيطات حتى تصل المهمة إلى حالة نهائية. يستخدم `ask_app` المملوك للتطبيق في Dispatch نفس عقد المهمة الدائمة والحالة، مع التحقق من صلاحية التطبيق المحدد عند كل من الإرسال والاستطلاع.
 
+عند عدم إتاحة قراءة حالة عابرة ومحدودة المدة، يمكن أن تُرجع `ask_app_status` القيم
+`status: "unknown"` و`statusRead: "unavailable"` و`retryable: true`، إلى جانب
+`app` و`taskId` الأصليين و`pollAfterMs` / `poll`. يعني ذلك أن قراءة الحالة غير
+متاحة، وليس أن المهمة الدائمة قد فشلت. أعد محاولة `ask_app_status` باستخدام `app`
+و`taskId` نفسيهما تمامًا؛ ولا تعِد إرسال `ask_app` للاسترداد مطلقًا، إذ قد يكرر
+الإرسال العمل. تظل أخطاء المصادقة الدائمة أو عدم العثور أو البروتوكول أخطاءً.
+
 ## المصادقة {#authentication}
 
 تدعم نقطة النهاية MCP MCP OAuth القياسي عن بعد بالإضافة إلى البديل الحالي للرمز المميز لحامله:

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

@@ -530,6 +530,15 @@ Für schnelle ChatGPT/Claude-Übergaben ist der ideale Pfad direkt: Rufen Sie di
 
 MCP-Hosts und -Gateways teilen sich kein einheitliches Zeitlimit für Tool-Aufrufe; manche erzwingen eine Obergrenze von fünf Minuten, andere sind konfigurierbar. Planen Sie eine externe Agentenintegration nicht um einen zehnminütigen, blockierenden `tools/call` herum. `ask-agent` und `ask_app` bestätigen gehostete Arbeit schnell und geben dann eine dauerhafte `taskId` zurück, sobald die Inline-Wartezeit abläuft. Fragen Sie mit `ask_app_status` unter Verwendung der zurückgegebenen `app` und `taskId` ab; das Ergebnis enthält `pollAfterMs` als host-freundliches Intervall. Die Aufgabe muss erstellt werden, bevor die erste Antwort in ein Timeout laufen kann – eine Polling-URL, die erst nach einem langen Aufruf zurückgegeben wird, ist kein zuverlässiger Recovery-Vertrag.
 
+Ist ein begrenzter, vorübergehender Statusabruf nicht verfügbar, kann
+`ask_app_status` `status: "unknown"`, `statusRead: "unavailable"` und
+`retryable: true` sowie das ursprüngliche `app`, `taskId` und `pollAfterMs` /
+`poll` zurückgeben. Das bedeutet, dass der Statusabruf nicht verfügbar ist –
+nicht, dass die dauerhafte Aufgabe fehlgeschlagen ist. Wiederholen Sie
+`ask_app_status` mit genau demselben `app` und `taskId`; reichen Sie zur
+Wiederherstellung niemals erneut `ask_app` ein, da dies Arbeit duplizieren kann.
+Dauerhafte Authentifizierungs-, Nicht-gefunden- und Protokollfehler bleiben Fehler.
+
 ### Tour pro App {#tour}
 
 Jede Vorlage auf der Zulassungsliste, die eine navigierbare Ressource erstellt oder auflistet, liefert einen `link`-Builder, und die aufnahmeintensiven Vorlagen liefern eine GET + `publicAgent`-Aktion, damit ein verbundener Agent den Live-Status abrufen kann:

package/docs/content/locales/de-DE/mcp-protocol.mdx

@@ -231,6 +231,15 @@ Der Agent führt die gleiche Schleife aus wie der interaktive Chat – er kann m
 
 Rufen Sie `ask_app_status` mit diesen Argumenten auf, bis die Aufgabe einen Endzustand erreicht. Das app-eigene `ask_app` von Dispatch verwendet denselben Vertrag für dauerhafte Aufgaben und Status, wobei die Berechtigung für die ausgewählte App sowohl bei der Übermittlung als auch beim Polling geprüft wird.
 
+Ist ein begrenzter, vorübergehender Statusabruf nicht verfügbar, kann
+`ask_app_status` `status: "unknown"`, `statusRead: "unavailable"` und
+`retryable: true` sowie das ursprüngliche `app`, `taskId` und `pollAfterMs` /
+`poll` zurückgeben. Das bedeutet, dass der Statusabruf nicht verfügbar ist –
+nicht, dass die dauerhafte Aufgabe fehlgeschlagen ist. Wiederholen Sie
+`ask_app_status` mit genau demselben `app` und `taskId`; reichen Sie zur
+Wiederherstellung niemals erneut `ask_app` ein, da dies Arbeit duplizieren kann.
+Dauerhafte Authentifizierungs-, Nicht-gefunden- und Protokollfehler bleiben Fehler.
+
 ## Authentifizierung {#authentication}
 
 Der MCP-Endpunkt unterstützt den Standard-Remote-MCP OAuth sowie den vorhandenen Bearer-Token-Fallback:

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

@@ -539,6 +539,15 @@ para hosts. La tarea debe crearse antes de que la primera respuesta pueda
 agotar el tiempo de espera, por lo que una URL de sondeo devuelta solo después
 de una llamada larga no es un contrato de recuperación confiable.
 
+Si no está disponible una lectura de estado transitoria y acotada,
+`ask_app_status` puede devolver `status: "unknown"`,
+`statusRead: "unavailable"`, `retryable: true`, el `app` y `taskId` originales,
+y `pollAfterMs` / `poll`. Esto significa que la lectura de estado no está
+disponible, no que la tarea duradera haya fallado. Vuelva a intentar
+`ask_app_status` con exactamente el mismo `app` y `taskId`; nunca reenvíe
+`ask_app` para recuperarse, porque el envío puede duplicar el trabajo. Los errores
+permanentes de autenticación, de no encontrado y de protocolo siguen siendo errores.
+
 ### Recorrido por aplicación {#tour}
 
 Cada plantilla incluida en la lista permitida que produce o enumera un recurso navegable incluye un generador `link`, y las de ingesta pesada incluyen una acción GET + `publicAgent` para que un agente conectado pueda obtener el estado en vivo:

package/docs/content/locales/es-ES/mcp-protocol.mdx

@@ -240,6 +240,15 @@ estado terminal. El `ask_app` propio de cada aplicación en Dispatch usa el
 mismo contrato de tarea y estado duraderos, con la concesión de la aplicación
 seleccionada verificada tanto en el envío como en el sondeo.
 
+Si no está disponible una lectura de estado transitoria y acotada,
+`ask_app_status` puede devolver `status: "unknown"`,
+`statusRead: "unavailable"`, `retryable: true`, el `app` y `taskId` originales,
+y `pollAfterMs` / `poll`. Esto significa que la lectura de estado no está
+disponible, no que la tarea duradera haya fallado. Vuelva a intentar
+`ask_app_status` con exactamente el mismo `app` y `taskId`; nunca reenvíe
+`ask_app` para recuperarse, porque el envío puede duplicar el trabajo. Los errores
+permanentes de autenticación, de no encontrado y de protocolo siguen siendo errores.
+
 ## Autenticación {#authentication}
 
 El punto final MCP admite MCP OAuth remoto estándar más el respaldo de token de portador existente:

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

@@ -531,6 +531,15 @@ Pour des transferts rapides ChatGPT/Claude, le chemin idéal est direct : appel
 
 Les hôtes et passerelles MCP ne partagent pas un seul et même délai d'expiration pour les appels d'outils : certains imposent un plafond de cinq minutes, d'autres sont configurables. Ne concevez pas une intégration d'agent externe autour d'un `tools/call` bloquant de dix minutes. `ask-agent` et `ask_app` accusent rapidement réception du travail hébergé, puis renvoient un `taskId` durable lorsque l'attente en ligne expire. Interrogez avec `ask_app_status` en utilisant les `app` et `taskId` renvoyés ; le résultat inclut `pollAfterMs` comme intervalle adapté à l'hôte. La tâche doit être créée avant que la première réponse ne puisse expirer, de sorte qu'une URL d'interrogation renvoyée seulement après un long appel n'est pas un contrat de récupération fiable.
 
+Si une lecture d'état transitoire et limitée est indisponible, `ask_app_status`
+peut renvoyer `status: "unknown"`, `statusRead: "unavailable"`,
+`retryable: true`, les `app` et `taskId` d'origine, ainsi que `pollAfterMs` /
+`poll`. Cela signifie que la lecture d'état est indisponible, et non que la tâche
+durable a échoué. Réessayez `ask_app_status` avec exactement les mêmes `app` et
+`taskId` ; ne soumettez jamais à nouveau `ask_app` pour récupérer, car la
+soumission peut dupliquer le travail. Les erreurs permanentes d'authentification,
+d'introuvable et de protocole restent des erreurs.
+
 ### Visite par application {#tour}
 
 Chaque modèle sur liste verte qui produit ou répertorie une ressource navigable est livré avec un générateur `link`, et ceux qui sont lourds à ingérer envoient une action GET + `publicAgent` afin qu'un agent connecté puisse extraire l'état en direct :

package/docs/content/locales/fr-FR/mcp-protocol.mdx

@@ -231,6 +231,15 @@ L'agent exécute la même boucle que le chat interactif : il peut appeler plusi
 
 Appelez `ask_app_status` avec ces arguments jusqu'à ce que la tâche atteigne un état terminal. Le `ask_app` propre à l'application de Dispatch utilise le même contrat de tâche durable et de statut, avec la vérification de l'autorisation de l'application sélectionnée effectuée à la fois lors de la soumission et de l'interrogation.
 
+Si une lecture d'état transitoire et limitée est indisponible, `ask_app_status`
+peut renvoyer `status: "unknown"`, `statusRead: "unavailable"`,
+`retryable: true`, les `app` et `taskId` d'origine, ainsi que `pollAfterMs` /
+`poll`. Cela signifie que la lecture d'état est indisponible, et non que la tâche
+durable a échoué. Réessayez `ask_app_status` avec exactement les mêmes `app` et
+`taskId` ; ne soumettez jamais à nouveau `ask_app` pour récupérer, car la
+soumission peut dupliquer le travail. Les erreurs permanentes d'authentification,
+d'introuvable et de protocole restent des erreurs.
+
 ## Authentification {#authentication}
 
 Le point de terminaison MCP prend en charge le modèle distant standard MCP OAuth, ainsi que le remplacement du jeton de support existant :

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

@@ -535,6 +535,14 @@ MCP होस्ट और गेटवे एक साझा लंबे ट
 टाइमआउट होने से पहले टास्क बनाया जाना चाहिए, इसलिए केवल लंबे कॉल के बाद
 लौटाया गया पोलिंग URL एक विश्वसनीय रिकवरी अनुबंध नहीं है।
 
+यदि सीमित, अस्थायी स्थिति-पठन उपलब्ध नहीं है, तो `ask_app_status`
+`status: "unknown"`, `statusRead: "unavailable"`, `retryable: true`, मूल `app`
+और `taskId`, तथा `pollAfterMs` / `poll` लौटा सकता है। इसका अर्थ है कि स्थिति-पठन
+अनुपलब्ध है, न कि स्थायी टास्क विफल हुआ है। ठीक उसी `app` और `taskId` के साथ
+`ask_app_status` को फिर आज़माएँ; पुनर्प्राप्ति के लिए `ask_app` को कभी फिर से सबमिट
+न करें, क्योंकि सबमिशन काम की नकल कर सकता है। स्थायी प्रमाणीकरण, न मिलने और
+प्रोटोकॉल त्रुटियाँ त्रुटियाँ ही रहती हैं।
+
 ### प्रति-ऐप टूर {#tour}
 
 प्रत्येक अनुमति-सूचीबद्ध टेम्पलेट जो एक नेविगेशन योग्य संसाधन का उत्पादन या सूचीबद्ध करता है, एक `link` बिल्डर को शिप करता है, और अंतर्ग्रहण-भारी वाले एक GET + `publicAgent` कार्रवाई को शिप करते हैं ताकि एक कनेक्टेड एजेंट लाइव स्थिति खींच सके:

package/docs/content/locales/hi-IN/mcp-protocol.mdx

@@ -238,6 +238,14 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
 अनुबंध का उपयोग करता है, जिसमें चयनित-ऐप अनुदान की जांच सबमिशन और पोलिंग दोनों
 पर की जाती है।
 
+यदि सीमित, अस्थायी स्थिति-पठन उपलब्ध नहीं है, तो `ask_app_status`
+`status: "unknown"`, `statusRead: "unavailable"`, `retryable: true`, मूल `app`
+और `taskId`, तथा `pollAfterMs` / `poll` लौटा सकता है। इसका अर्थ है कि स्थिति-पठन
+अनुपलब्ध है, न कि स्थायी टास्क विफल हुआ है। ठीक उसी `app` और `taskId` के साथ
+`ask_app_status` को फिर आज़माएँ; पुनर्प्राप्ति के लिए `ask_app` को कभी फिर से सबमिट
+न करें, क्योंकि सबमिशन काम की नकल कर सकता है। स्थायी प्रमाणीकरण, न मिलने और
+प्रोटोकॉल त्रुटियाँ त्रुटियाँ ही रहती हैं।
+
 ## प्रमाणीकरण {#authentication}
 
 MCP एंडपॉइंट मानक रिमोट MCP OAuth प्लस मौजूदा बियरर-टोकन फ़ॉलबैक का समर्थन करता है:

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

@@ -528,6 +528,14 @@ ChatGPT/Claude スタイルの OAuth アプリ ホストの場合、検出サー
 
 MCP ホストとゲートウェイは、単一の長いツール呼び出しタイムアウトを共有していません。5 分の上限を課すものもあれば、設定可能なものもあります。10 分間ブロックする `tools/call` を前提に外部エージェント連携を設計しないでください。 `ask-agent` と `ask_app` はホストされている処理をすぐに確認応答し、インライン待機が期限切れになると永続的な `taskId` を返します。返された `app` と `taskId` を使用して `ask_app_status` でポーリングしてください。結果にはホストにとって扱いやすい間隔として `pollAfterMs` が含まれます。タスクは最初のレスポンスがタイムアウトする前に作成されている必要があるため、長い呼び出しの後にのみ返されるポーリング URL は信頼できる復旧手段ではありません。
 
+制限された一時的なステータス取得を利用できない場合、`ask_app_status` は
+`status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、元の
+`app` と `taskId`、および `pollAfterMs` / `poll` を返すことがあります。これは
+ステータス取得が利用できないことを意味し、永続タスクが失敗したことを意味しません。
+まったく同じ `app` と `taskId` で `ask_app_status` を再試行してください。送信により
+作業が重複する可能性があるため、復旧のために `ask_app` を再送信してはいけません。
+永続的な認証、未検出、プロトコルのエラーは引き続きエラーです。
+
 ### アプリごとのツアー {#tour}
 
 ナビゲート可能なリソースを生成またはリストする許可リストに登録されたすべてのテンプレートには `link` ビルダーが同梱されており、取り込みが多いテンプレートには GET + `publicAgent` アクションが同梱されているため、接続されたエージェントはライブ状態を取得できます。

package/docs/content/locales/ja-JP/mcp-protocol.mdx

@@ -231,6 +231,14 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
 
 タスクが最終状態に達するまで、これらの引数を使用して `ask_app_status` を呼び出してください。Dispatch のアプリ所有の `ask_app` は同じ永続的なタスクとステータスの契約を使用し、選択されたアプリの許可は送信時とポーリング時の両方でチェックされます。
 
+制限された一時的なステータス取得を利用できない場合、`ask_app_status` は
+`status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、元の
+`app` と `taskId`、および `pollAfterMs` / `poll` を返すことがあります。これは
+ステータス取得が利用できないことを意味し、永続タスクが失敗したことを意味しません。
+まったく同じ `app` と `taskId` で `ask_app_status` を再試行してください。送信により
+作業が重複する可能性があるため、復旧のために `ask_app` を再送信してはいけません。
+永続的な認証、未検出、プロトコルのエラーは引き続きエラーです。
+
 ## 認証 {#authentication}
 
 MCP エンドポイントは、標準のリモート MCP OAuth に加えて、既存のベアラー トークン フォールバックをサポートします。

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

@@ -536,6 +536,14 @@ MCP 호스트와 게이트웨이는 하나의 긴 도구 호출 제한 시간을
 전에 작업이 생성되어야 하므로, 오랜 호출이 끝난 후에만 반환되는 폴링 URL은 신뢰할
 수 있는 복구 계약이 아닙니다.
 
+제한된 일시적 상태 읽기를 사용할 수 없으면 `ask_app_status`는
+`status: "unknown"`, `statusRead: "unavailable"`, `retryable: true`, 원래의
+`app`과 `taskId`, 그리고 `pollAfterMs` / `poll`을 반환할 수 있습니다. 이는 상태
+읽기를 사용할 수 없다는 뜻이지 내구성 있는 작업이 실패했다는 뜻은 아닙니다. 정확히 같은
+`app`과 `taskId`로 `ask_app_status`를 재시도하세요. 제출하면 작업이 중복될 수 있으므로
+복구를 위해 `ask_app`을 다시 제출하지 마세요. 영구적인 인증, 찾을 수 없음, 프로토콜
+오류는 계속 오류로 남습니다.
+
 ### 앱별 둘러보기 {#tour}
 
 탐색 가능한 리소스를 생성하거나 나열하는 모든 허용 목록 템플릿은 `link` 빌더를 제공하고, 수집이 많은 템플릿은 연결된 에이전트가 라이브 상태를 가져올 수 있도록 GET + `publicAgent` 작업을 제공합니다.

package/docs/content/locales/ko-KR/mcp-protocol.mdx

@@ -238,6 +238,14 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
 Dispatch의 앱 소유 `ask_app`은 제출과 폴링 모두에서 선택된 앱의 권한을
 확인하는, 동일한 내구성 있는 작업 및 상태 계약을 사용합니다.
 
+제한된 일시적 상태 읽기를 사용할 수 없으면 `ask_app_status`는
+`status: "unknown"`, `statusRead: "unavailable"`, `retryable: true`, 원래의
+`app`과 `taskId`, 그리고 `pollAfterMs` / `poll`을 반환할 수 있습니다. 이는 상태
+읽기를 사용할 수 없다는 뜻이지 내구성 있는 작업이 실패했다는 뜻은 아닙니다. 정확히 같은
+`app`과 `taskId`로 `ask_app_status`를 재시도하세요. 제출하면 작업이 중복될 수 있으므로
+복구를 위해 `ask_app`을 다시 제출하지 마세요. 영구적인 인증, 찾을 수 없음, 프로토콜
+오류는 계속 오류로 남습니다.
+
 ## 인증 {#authentication}
 
 MCP 엔드포인트는 표준 원격 MCP OAuth와 기존 베어러 토큰 폴백을 지원합니다.

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

@@ -539,6 +539,15 @@ amigável para hosts. A tarefa precisa ser criada antes que a primeira
 resposta possa expirar, então um URL de consulta retornado apenas após uma
 chamada longa não é um contrato de recuperação confiável.
 
+Se uma leitura de status transitória e limitada estiver indisponível,
+`ask_app_status` poderá retornar `status: "unknown"`,
+`statusRead: "unavailable"`, `retryable: true`, o `app` e o `taskId` originais,
+e `pollAfterMs` / `poll`. Isso significa que a leitura de status está
+indisponível, não que a tarefa durável falhou. Tente novamente `ask_app_status`
+com exatamente o mesmo `app` e `taskId`; nunca reenvie `ask_app` para recuperar,
+pois o envio pode duplicar o trabalho. Erros permanentes de autenticação, de não
+encontrado e de protocolo continuam sendo erros.
+
 ### Tour por aplicativo {#tour}
 
 Cada modelo listado como permitido que produz ou lista um recurso navegável envia um construtor `link`, e os modelos pesados enviam uma ação GET + `publicAgent` para que um agente conectado possa extrair o estado ativo:

package/docs/content/locales/pt-BR/mcp-protocol.mdx

@@ -234,6 +234,15 @@ terminal. O `ask_app` de propriedade do aplicativo no Dispatch usa o mesmo
 contrato de tarefa durável e status, com a concessão do aplicativo selecionado
 verificada tanto no envio quanto na consulta.
 
+Se uma leitura de status transitória e limitada estiver indisponível,
+`ask_app_status` poderá retornar `status: "unknown"`,
+`statusRead: "unavailable"`, `retryable: true`, o `app` e o `taskId` originais,
+e `pollAfterMs` / `poll`. Isso significa que a leitura de status está
+indisponível, não que a tarefa durável falhou. Tente novamente `ask_app_status`
+com exatamente o mesmo `app` e `taskId`; nunca reenvie `ask_app` para recuperar,
+pois o envio pode duplicar o trabalho. Erros permanentes de autenticação, de não
+encontrado e de protocolo continuam sendo erros.
+
 ## Autenticação {#authentication}
 
 O endpoint MCP suporta MCP remoto padrão OAuth mais o substituto de token de portador existente:

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

@@ -525,6 +525,12 @@ CSP 和沙箱权限等安全元数据存在于资源中
 
 MCP 主机和网关并不共享同一个较长的工具调用超时时间；有些强制执行五分钟的上限，有些则可配置。不要围绕一个阻塞十分钟的 `tools/call` 来设计外部代理集成。`ask-agent` 和 `ask_app` 会快速确认托管工作已开始，然后在内联等待到期时返回一个持久的 `taskId`。使用返回的 `app` 和 `taskId` 通过 `ask_app_status` 进行轮询；结果中包含 `pollAfterMs`，作为对主机友好的轮询间隔。任务必须在第一次响应超时之前就已创建，因此仅在长时间调用之后才返回的轮询 URL 并不是可靠的恢复约定。
 
+当有界的暂态状态读取不可用时，`ask_app_status` 可以返回
+`status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、原始的
+`app` 和 `taskId`，以及 `pollAfterMs` / `poll`。这表示状态读取不可用，并不表示
+持久任务失败。请使用完全相同的 `app` 和 `taskId` 重试 `ask_app_status`；切勿为恢复而
+重新提交 `ask_app`，因为提交可能会重复工作。永久性的身份验证、未找到和协议错误仍然是错误。
+
 ### 每应用游览 {#tour}
 
 每个生成或列出可导航资源的允许列表模板都会附带一个 `link` 构建器，而摄取量大的模板会附带一个 GET + `publicAgent` 操作，以便连接的代理可以提取实时状态：

package/docs/content/locales/zh-CN/mcp-protocol.mdx

@@ -231,6 +231,12 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
 
 使用这些参数调用 `ask_app_status` 进行轮询，直到任务达到终态。Dispatch 中应用自持的 `ask_app` 使用相同的持久任务和状态约定，在提交和轮询时都会检查所选应用的授权。
 
+当有界的暂态状态读取不可用时，`ask_app_status` 可以返回
+`status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、原始的
+`app` 和 `taskId`，以及 `pollAfterMs` / `poll`。这表示状态读取不可用，并不表示
+持久任务失败。请使用完全相同的 `app` 和 `taskId` 重试 `ask_app_status`；切勿为恢复而
+重新提交 `ask_app`，因为提交可能会重复工作。永久性的身份验证、未找到和协议错误仍然是错误。
+
 ## 身份验证 {#authentication}
 
 MCP 端点支持标准远程 MCP OAuth 以及现有的不记名令牌后备：

package/docs/content/locales/zh-TW/external-agents.mdx

@@ -525,6 +525,12 @@ CSP 和沙箱權限等安全中繼資料存在於資源中
 
 MCP 主機與閘道器並未共用單一的長工具呼叫逾時限制；有些強制五分鐘上限，有些則可設定。請勿將外部代理整合設計成依賴十分鐘的封鎖式 `tools/call`。`ask-agent` 與 `ask_app` 會快速確認託管工作，並在行內等待逾期時傳回持久的 `taskId`。請使用傳回的 `app` 與 `taskId` 呼叫 `ask_app_status` 進行輪詢；結果包含 `pollAfterMs` 作為對主機友善的輪詢間隔。任務必須在第一次回應逾時之前就已建立，因此僅在長時間呼叫後才傳回輪詢網址並非可靠的復原機制。
 
+若有界的暫時狀態讀取無法使用，`ask_app_status` 可傳回
+`status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、原始的
+`app` 與 `taskId`，以及 `pollAfterMs` / `poll`。這表示狀態讀取無法使用，並不表示
+持久任務失敗。請以完全相同的 `app` 與 `taskId` 重試 `ask_app_status`；切勿為了復原而
+重新提交 `ask_app`，因為提交可能重複工作。永久性的驗證、找不到與通訊協定錯誤仍然是錯誤。
+
 ### 每應用游覽 {#tour}
 
 每個生成或列出可導覽資源的允許清單範本都會附帶一個 `link` 建置器，而攝取量大的範本會附帶一個 GET + `publicAgent` 操作，以便連線的代理可以擷取即時狀態：

package/docs/content/locales/zh-TW/mcp-protocol.mdx

@@ -232,6 +232,12 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
 請使用這些引數呼叫 `ask_app_status`，直到任務進入終止狀態。Dispatch 應用程式自有的
 `ask_app` 使用相同的持久任務與狀態合約，並在提交與輪詢時都會檢查所選應用程式的授權。
 
+若有界的暫時狀態讀取無法使用，`ask_app_status` 可傳回
+`status: "unknown"`、`statusRead: "unavailable"`、`retryable: true`、原始的
+`app` 與 `taskId`，以及 `pollAfterMs` / `poll`。這表示狀態讀取無法使用，並不表示
+持久任務失敗。請以完全相同的 `app` 與 `taskId` 重試 `ask_app_status`；切勿為了復原而
+重新提交 `ask_app`，因為提交可能重複工作。永久性的驗證、找不到與通訊協定錯誤仍然是錯誤。
+
 ## 驗證 {#authentication}
 
 MCP 端點支援標準遠端 MCP OAuth 以及現有的不記名權杖後備：

package/docs/content/mcp-protocol.mdx

@@ -244,6 +244,14 @@ Call `ask_app_status` with those arguments until the task reaches a terminal
 state. Dispatch's app-owned `ask_app` uses the same durable task and status
 contract, with the selected-app grant checked on both submission and polling.
 
+If a bounded transient status read is unavailable, `ask_app_status` can return
+`status: "unknown"`, `statusRead: "unavailable"`, `retryable: true`, the
+original `app` and `taskId`, and `pollAfterMs` / `poll`. This means the status
+read is unavailable—not that the durable task failed. Retry `ask_app_status`
+with that exact `app` and `taskId`; never resubmit `ask_app` to recover, because
+submission can duplicate work. Permanent authentication, not-found, and
+protocol failures remain errors.
+
 ## Authentication {#authentication}
 
 The MCP endpoint supports standard remote MCP OAuth plus the existing bearer-token fallback:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.106.1",
+  "version": "0.106.3",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {