@agen-ai/agent-protocol 0.3.1 → 0.4.0

package/dist/public/index.d.ts

@@ -1,4 +1,5 @@
 export * from '../foundation/index.js';
+export * from '../failures/index.js';
 export * from '../accountQuota/index.js';
 export * from '../sessions/index.js';
 export * from '../turns/index.js';

package/dist/public/index.js

@@ -1,4 +1,5 @@
 export * from "../foundation/index.js";
+export * from "../failures/index.js";
 export * from "../accountQuota/index.js";
 export * from "../sessions/index.js";
 export * from "../turns/index.js";

package/dist/zod/accountQuota.d.ts

@@ -58,6 +58,14 @@ export declare const AgentAccountQuotaMeasurementSchema: z.ZodDiscriminatedUnion
     remainingMinorUnits: z.ZodOptional<z.ZodNumber>;
     usedPercent: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>>], "kind">;
+export declare const AgentAccountQuotaResetSchema: z.ZodReadonly<z.ZodObject<{
+    at: z.ZodType<import("../index.js").AgentIsoDateTime, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentIsoDateTime, unknown>>;
+    precision: z.ZodEnum<{
+        reported: "reported";
+        estimated: "estimated";
+    }>;
+    observedAt: z.ZodType<import("../index.js").AgentIsoDateTime, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentIsoDateTime, unknown>>;
+}, z.core.$strict>>;
 export declare const AgentAccountQuotaWindowPortableSchema: z.ZodReadonly<z.ZodObject<{
     poolId: z.ZodString;
     windowId: z.ZodString;

package/dist/zod/accountQuota.js

@@ -61,6 +61,11 @@ const AgentAccountQuotaMeasurementSchema = z.discriminatedUnion("kind", [
     usedPercent: NonnegativeQuantitySchema.optional()
   }).strict().readonly()
 ]);
+const AgentAccountQuotaResetSchema = z.object({
+  at: AgentIsoDateTimeSchema,
+  precision: z.enum(["reported", "estimated"]),
+  observedAt: AgentIsoDateTimeSchema
+}).strict().readonly();
 const AgentAccountQuotaWindowPortableSchema = z.object({
   poolId: AgentCanonicalIdValueSchema,
   windowId: AgentCanonicalIdValueSchema,
@@ -71,11 +76,7 @@ const AgentAccountQuotaWindowPortableSchema = z.object({
   measurement: AgentAccountQuotaMeasurementSchema,
   observedAt: AgentIsoDateTimeSchema,
   startsAt: AgentIsoDateTimeSchema.optional(),
-  reset: z.object({
-    at: AgentIsoDateTimeSchema,
-    precision: z.enum(["reported", "estimated"]),
-    observedAt: AgentIsoDateTimeSchema
-  }).strict().readonly().optional()
+  reset: AgentAccountQuotaResetSchema.optional()
 }).strict().readonly();
 function validateWindow(window, context, prefix = []) {
   if (window.applicability.kind === "models" && new Set(window.applicability.modelIds).size !== window.applicability.modelIds.length) {
@@ -148,6 +149,7 @@ export {
   AgentAccountQuotaApplicabilitySchema,
   AgentAccountQuotaMeasurementSchema,
   AgentAccountQuotaPeriodSchema,
+  AgentAccountQuotaResetSchema,
   AgentAccountQuotaSnapshotPortableSchema,
   AgentAccountQuotaSnapshotSchema,
   AgentAccountQuotaWindowPortableSchema,

package/dist/zod/capabilities.d.ts

@@ -106,7 +106,7 @@ export declare const AgentOperationInputCapabilitySchema: z.ZodReadonly<z.ZodObj
     }, z.core.$strict>>], "kind">;
 }, z.core.$strict>>;
 export declare const AgentCapabilitiesPortableSchema: z.ZodReadonly<z.ZodObject<{
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     providerKey: z.ZodType<import("../index.js").AgentProviderKey, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderKey, unknown>>;
     sessions: z.ZodReadonly<z.ZodObject<{
         create: z.ZodLiteral<true>;
@@ -234,10 +234,10 @@ export declare const AgentCapabilitiesPortableSchema: z.ZodReadonly<z.ZodObject<
             kind: z.ZodLiteral<"supported">;
             triggers: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
                 unknown: "unknown";
-                automatic: "automatic";
-                manual: "manual";
                 context_limit: "context_limit";
                 recovery: "recovery";
+                automatic: "automatic";
+                manual: "manual";
             }>>>;
             sameSessionContinuation: z.ZodBoolean;
         }, z.core.$strict>>], "kind">;

package/dist/zod/collaboration.js

@@ -1,4 +1,5 @@
 import { z } from "zod/v4";
+import { AgentErrorSchema } from "./failures.js";
 import { compareStringsByUnicodeCodePoint } from "../foundation/ordering.js";
 import {
   AGENT_COLLABORATION_OBJECTIVE_MAX_LENGTH,
@@ -13,7 +14,6 @@ import {
 import {
   AgentArtifactIdSchema,
   AgentCollaborationIdSchema,
-  AgentErrorSchema,
   AgentGeneratedResourceIdSchema,
   AgentIsoDateTimeSchema,
   createAgentCanonicalNonBlankStringSchema

package/dist/zod/events.d.ts

@@ -33,7 +33,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
     payload: z.ZodReadonly<z.ZodObject<{
         message: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -54,7 +54,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
         requestId: z.ZodOptional<z.ZodType<import("../index.js").AgentRequestId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestId, unknown>>>;
         message: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -77,7 +77,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
         reason: z.ZodOptional<z.ZodString>;
         error: z.ZodOptional<z.ZodType<import("../index.js").AgentError, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentError, unknown>>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -91,7 +91,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
     type: z.ZodLiteral<"item.started">;
     turnId: z.ZodType<import("../index.js").AgentTurnId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentTurnId, unknown>>;
     payload: z.ZodType<import("../index.js").AgentItemSnapshot, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentItemSnapshot, unknown>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -105,7 +105,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
     type: z.ZodLiteral<"item.updated">;
     turnId: z.ZodType<import("../index.js").AgentTurnId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentTurnId, unknown>>;
     payload: z.ZodType<import("../index.js").AgentItemSnapshot, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentItemSnapshot, unknown>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -119,7 +119,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
     type: z.ZodLiteral<"item.completed">;
     turnId: z.ZodType<import("../index.js").AgentTurnId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentTurnId, unknown>>;
     payload: z.ZodType<import("../index.js").AgentItemSnapshot, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentItemSnapshot, unknown>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -145,7 +145,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
         }>;
         delta: z.ZodString;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -162,7 +162,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
         explanation: z.ZodOptional<z.ZodString>;
         steps: z.ZodReadonly<z.ZodArray<z.ZodType<import("../index.js").AgentPlanStep, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentPlanStep, unknown>>>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -179,7 +179,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
         artifactId: z.ZodType<import("../index.js").AgentArtifactId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentArtifactId, unknown>>;
         requestId: z.ZodType<import("../index.js").AgentRequestId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestId, unknown>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -193,7 +193,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
     type: z.ZodLiteral<"turn.diff.updated">;
     turnId: z.ZodType<import("../index.js").AgentTurnId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentTurnId, unknown>>;
     payload: z.ZodType<import("../index.js").AgentDiffSummary, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentDiffSummary, unknown>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -326,7 +326,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
             expiresAt: z.ZodOptional<z.ZodType<import("../index.js").AgentIsoDateTime, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentIsoDateTime, unknown>>>;
         }, z.core.$strict>>], "requestKind">;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -357,7 +357,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
         current: z.ZodOptional<z.ZodNumber>;
         total: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -395,7 +395,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
             thresholdTokens: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -411,7 +411,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
     payload: z.ZodReadonly<z.ZodObject<{
         artifact: z.ZodType<import("../index.js").AgentArtifactDescriptor, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentArtifactDescriptor, unknown>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -440,7 +440,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
             error: z.ZodOptional<z.ZodType<import("../index.js").AgentError, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentError, unknown>>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -509,7 +509,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
             resourceIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<import("../index.js").AgentGeneratedResourceId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentGeneratedResourceId, unknown>>>>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -563,7 +563,27 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
             error: z.ZodOptional<z.ZodType<import("../index.js").AgentError, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentError, unknown>>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
+    sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
+    providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
+        historyAnchor: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderHistoryAnchor, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderHistoryAnchor, unknown>>>;
+        turnId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderTurnRef, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderTurnRef, unknown>>>;
+        itemId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderItemRef, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderItemRef, unknown>>>;
+        requestId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderRequestRef, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderRequestRef, unknown>>>;
+    }, z.core.$strict>>>;
+    occurredAt: z.ZodType<import("../index.js").AgentIsoDateTime, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentIsoDateTime, unknown>>;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    type: z.ZodLiteral<"runtime.retrying">;
+    turnId: z.ZodType<import("../index.js").AgentTurnId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentTurnId, unknown>>;
+    payload: z.ZodReadonly<z.ZodObject<{
+        owner: z.ZodLiteral<"provider">;
+        error: z.ZodType<import("../index.js").AgentError, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentError, unknown>>;
+        attempt: z.ZodOptional<z.ZodNumber>;
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        delayMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -579,14 +599,9 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
     payload: z.ZodReadonly<z.ZodObject<{
         code: z.ZodString;
         message: z.ZodString;
-        retryable: z.ZodOptional<z.ZodBoolean>;
-        context: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
-            operation: z.ZodOptional<z.ZodString>;
-            component: z.ZodOptional<z.ZodString>;
-            status: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>>;
+        context: z.ZodOptional<z.ZodType<import("../index.js").AgentErrorContext, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentErrorContext, unknown>>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -602,7 +617,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
     payload: z.ZodReadonly<z.ZodObject<{
         error: z.ZodType<import("../index.js").AgentError, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentError, unknown>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;
@@ -618,13 +633,9 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
     payload: z.ZodReadonly<z.ZodObject<{
         code: z.ZodString;
         message: z.ZodString;
-        context: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
-            operation: z.ZodOptional<z.ZodString>;
-            component: z.ZodOptional<z.ZodString>;
-            status: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>>;
+        context: z.ZodOptional<z.ZodType<import("../index.js").AgentErrorContext, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentErrorContext, unknown>>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<9>;
+    protocolVersion: z.ZodLiteral<10>;
     sessionId: z.ZodType<import("../index.js").AgentSessionId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentSessionId, unknown>>;
     providerRefs: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         conversationId: z.ZodOptional<z.ZodType<import("../index.js").AgentProviderConversationId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentProviderConversationId, unknown>>>;

package/dist/zod/events.js

@@ -1,4 +1,5 @@
 import { z } from "zod/v4";
+import { AgentErrorContextSchema, AgentErrorSchema } from "./failures.js";
 import { AgentArtifactDescriptorSchema } from "./artifacts.js";
 import { AgentCollaborationNodePortableSchema } from "./collaboration.js";
 import {
@@ -29,8 +30,6 @@ import {
   AgentCanonicalCodeSchema,
   AgentCanonicalIdValueSchema,
   AgentCanonicalNonBlankTextSchema,
-  AgentErrorContextSchema,
-  AgentErrorSchema,
   AgentIsoDateTimeSchema,
   AgentItemIdSchema,
   AgentProviderRefsPortableSchema,
@@ -77,6 +76,21 @@ const ProgressUpdatedPayloadSchema = z.object({
 }).strict().readonly();
 const NonNegativeSafeIntegerSchema = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
 const PositiveSafeIntegerSchema = z.number().int().positive().max(Number.MAX_SAFE_INTEGER);
+const RuntimeRetryingPayloadSchema = z.object({
+  owner: z.literal("provider"),
+  error: AgentErrorSchema,
+  attempt: PositiveSafeIntegerSchema.optional(),
+  maxAttempts: PositiveSafeIntegerSchema.optional(),
+  delayMs: NonNegativeSafeIntegerSchema.optional()
+}).strict().readonly().superRefine((retry, context) => {
+  if (retry.attempt !== void 0 && retry.maxAttempts !== void 0 && retry.attempt > retry.maxAttempts) {
+    context.addIssue({
+      code: "custom",
+      path: ["attempt"],
+      message: "Retry ordinal cannot exceed the maximum number of retries."
+    });
+  }
+});
 const AgentContextCumulativeUsageSchema = z.object({
   inputTokens: NonNegativeSafeIntegerSchema.optional(),
   outputTokens: NonNegativeSafeIntegerSchema.optional(),
@@ -169,12 +183,12 @@ const AgentEventPortableSchema = z.discriminatedUnion("type", [
     "resource.updated",
     z.object({ resource: AgentGeneratedResourceDescriptorPortableSchema }).strict().readonly()
   ),
+  turnEvent("runtime.retrying", RuntimeRetryingPayloadSchema),
   optionallyTurnScopedEvent(
     "runtime.warning",
     z.object({
       code: AgentCanonicalCodeSchema,
       message: AgentCanonicalNonBlankTextSchema,
-      retryable: z.boolean().optional(),
       context: AgentErrorContextSchema.optional()
     }).strict().readonly()
   ),

package/dist/zod/failures.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod/v4';
+import { type AgentError, type AgentErrorContext, type AgentFailureQuotaReference, type AgentRecoveryHint } from '../failures/types.js';
+export declare const AgentFailureCategorySchema: z.ZodEnum<{
+    unknown: "unknown";
+    rate_limited: "rate_limited";
+    quota_exhausted: "quota_exhausted";
+    budget_exhausted: "budget_exhausted";
+    execution_limit: "execution_limit";
+    context_limit: "context_limit";
+    authentication: "authentication";
+    permission: "permission";
+    invalid_request: "invalid_request";
+    overloaded: "overloaded";
+    transport: "transport";
+    provider: "provider";
+    protocol: "protocol";
+    internal: "internal";
+}>;
+export declare const AgentErrorContextSchema: z.ZodType<AgentErrorContext>;
+export declare const AgentFailureQuotaReferenceSchema: z.ZodType<AgentFailureQuotaReference>;
+export declare const AgentRecoveryHintSchema: z.ZodType<AgentRecoveryHint>;
+export declare const AgentErrorSchema: z.ZodType<AgentError>;
+//# sourceMappingURL=failures.d.ts.map

package/dist/zod/failures.js

@@ -0,0 +1,76 @@
+import { z } from "zod/v4";
+import {
+  AGENT_ERROR_CONTEXT_MAX_LENGTH,
+  AGENT_FAILURE_CATEGORIES
+} from "../failures/types.js";
+import {
+  AGENT_PROTOCOL_JSON_BYTES_LIMIT,
+  agentProtocolSerializedJsonBytes
+} from "../foundation/types.js";
+import { AgentAccountQuotaResetSchema } from "./accountQuota.js";
+import {
+  AgentCanonicalCodeSchema,
+  AgentCanonicalIdValueSchema,
+  AgentCanonicalNonBlankTextSchema,
+  AgentIsoDateTimeSchema,
+  createAgentCanonicalNonBlankStringSchema
+} from "./foundation.js";
+const AgentFailureCategorySchema = z.enum(AGENT_FAILURE_CATEGORIES);
+const AgentErrorContextSchema = z.object({
+  operation: createAgentCanonicalNonBlankStringSchema(AGENT_ERROR_CONTEXT_MAX_LENGTH).optional(),
+  component: createAgentCanonicalNonBlankStringSchema(AGENT_ERROR_CONTEXT_MAX_LENGTH).optional(),
+  status: createAgentCanonicalNonBlankStringSchema(AGENT_ERROR_CONTEXT_MAX_LENGTH).optional()
+}).strict().readonly();
+const AgentFailureQuotaReferenceSchema = z.object({
+  sourceId: AgentCanonicalIdValueSchema,
+  poolId: AgentCanonicalIdValueSchema,
+  windowId: AgentCanonicalIdValueSchema,
+  observedAt: AgentIsoDateTimeSchema,
+  reset: AgentAccountQuotaResetSchema.optional()
+}).strict().readonly().superRefine((reference, context) => {
+  if (reference.reset && Date.parse(reference.reset.observedAt) > Date.parse(reference.observedAt)) {
+    context.addIssue({
+      code: "custom",
+      path: ["reset", "observedAt"],
+      message: "Reset evidence cannot be newer than the quota observation."
+    });
+  }
+});
+const AgentRecoveryHintSchema = z.discriminatedUnion("kind", [
+  z.object({ kind: z.literal("unknown") }).strict().readonly(),
+  z.object({ kind: z.literal("none") }).strict().readonly(),
+  z.object({ kind: z.literal("retry"), notBefore: AgentIsoDateTimeSchema.optional() }).strict().readonly(),
+  z.object({ kind: z.literal("wait_for_quota"), quota: AgentFailureQuotaReferenceSchema.optional() }).strict().readonly(),
+  z.object({
+    kind: z.literal("user_action"),
+    action: z.enum(["authenticate", "review_access", "change_configuration", "review_allowance"])
+  }).strict().readonly()
+]);
+const AgentErrorSchema = z.object({
+  category: AgentFailureCategorySchema,
+  code: AgentCanonicalCodeSchema,
+  message: AgentCanonicalNonBlankTextSchema,
+  recovery: AgentRecoveryHintSchema,
+  context: AgentErrorContextSchema.optional()
+}).strict().readonly().superRefine((error, context) => {
+  if (error.recovery.kind === "wait_for_quota" && error.recovery.quota !== void 0 && error.category !== "rate_limited" && error.category !== "quota_exhausted") {
+    context.addIssue({
+      code: "custom",
+      path: ["recovery", "quota"],
+      message: "Quota references apply only to rate-limited or quota-exhausted failures."
+    });
+  }
+  if (agentProtocolSerializedJsonBytes(error) > AGENT_PROTOCOL_JSON_BYTES_LIMIT) {
+    context.addIssue({
+      code: "custom",
+      message: `Agent failures cannot exceed ${AGENT_PROTOCOL_JSON_BYTES_LIMIT} serialized bytes.`
+    });
+  }
+});
+export {
+  AgentErrorContextSchema,
+  AgentErrorSchema,
+  AgentFailureCategorySchema,
+  AgentFailureQuotaReferenceSchema,
+  AgentRecoveryHintSchema
+};

package/dist/zod/foundation.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod/v4';
-import { type AgentArtifactId, type AgentApprovalOptionId, type AgentCollaborationId, type AgentConfigurationRevisionId, type AgentError, type AgentInstanceId, type AgentIntegrationId, type AgentIntegrationResourceId, type AgentIntegrationServerId, type AgentIntegrationToolId, type AgentIsoDateTime, type AgentItemId, type AgentJsonValue, type AgentManagedContentId, type AgentEnvironmentId, type AgentEffectiveContentId, type AgentCommandId, type AgentExtensionId, type AgentOperationId, type AgentOperationInvocationId, type AgentProviderConversationId, type AgentProviderHistoryAnchor, type AgentProviderItemRef, type AgentProviderKey, type AgentProviderRefs, type AgentProviderRequestRef, type AgentProviderTurnRef, type AgentRequestFieldId, type AgentRequestId, type AgentSessionId, type AgentGeneratedResourceId, type AgentTurnId } from '../foundation/types.js';
+import { type AgentArtifactId, type AgentApprovalOptionId, type AgentCollaborationId, type AgentConfigurationRevisionId, type AgentInstanceId, type AgentIntegrationId, type AgentIntegrationResourceId, type AgentIntegrationServerId, type AgentIntegrationToolId, type AgentIsoDateTime, type AgentItemId, type AgentJsonValue, type AgentManagedContentId, type AgentEnvironmentId, type AgentEffectiveContentId, type AgentCommandId, type AgentExtensionId, type AgentOperationId, type AgentOperationInvocationId, type AgentProviderConversationId, type AgentProviderHistoryAnchor, type AgentProviderItemRef, type AgentProviderKey, type AgentProviderRefs, type AgentProviderRequestRef, type AgentProviderTurnRef, type AgentRequestFieldId, type AgentRequestId, type AgentSessionId, type AgentGeneratedResourceId, type AgentTurnId } from '../foundation/types.js';
 export declare function createAgentCanonicalOpaqueStringSchema(maxLength: number, message: string): z.ZodString;
 export declare const AgentCanonicalIdValueSchema: z.ZodString;
 export declare function createAgentCanonicalNonBlankStringSchema(maxLength: number): z.ZodString;
@@ -50,11 +50,5 @@ export declare const AgentProviderRefsPortableSchema: z.ZodReadonly<z.ZodObject<
     requestId: z.ZodOptional<z.ZodType<AgentProviderRequestRef, unknown, z.core.$ZodTypeInternals<AgentProviderRequestRef, unknown>>>;
 }, z.core.$strict>>;
 export declare const AgentProviderRefsSchema: z.ZodType<AgentProviderRefs>;
-export declare const AgentErrorContextSchema: z.ZodReadonly<z.ZodObject<{
-    operation: z.ZodOptional<z.ZodString>;
-    component: z.ZodOptional<z.ZodString>;
-    status: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>>;
-export declare const AgentErrorSchema: z.ZodType<AgentError>;
 export {};
 //# sourceMappingURL=foundation.d.ts.map

package/dist/zod/foundation.js

@@ -177,17 +177,6 @@ const AgentProviderRefsSchema = AgentProviderRefsPortableSchema.refine(
   (value) => Object.values(value).some((item) => item !== void 0),
   { message: "At least one provider reference is required." }
 );
-const AgentErrorContextSchema = z.object({
-  operation: createAgentCanonicalNonBlankStringSchema(160).optional(),
-  component: createAgentCanonicalNonBlankStringSchema(160).optional(),
-  status: createAgentCanonicalNonBlankStringSchema(160).optional()
-}).strict().readonly();
-const AgentErrorSchema = z.object({
-  code: AgentCanonicalCodeSchema,
-  message: AgentCanonicalNonBlankTextSchema,
-  retryable: z.boolean(),
-  context: AgentErrorContextSchema.optional()
-}).strict().readonly();
 export {
   AgentApprovalOptionIdSchema,
   AgentArtifactIdSchema,
@@ -199,8 +188,6 @@ export {
   AgentConfigurationRevisionIdSchema,
   AgentEffectiveContentIdSchema,
   AgentEnvironmentIdSchema,
-  AgentErrorContextSchema,
-  AgentErrorSchema,
   AgentExtensionIdSchema,
   AgentGeneratedResourceIdSchema,
   AgentInstanceIdSchema,

package/dist/zod/index.d.ts

@@ -1,4 +1,5 @@
-export { AgentApprovalOptionIdSchema, AgentArtifactIdSchema, AgentCollaborationIdSchema, AgentConfigurationRevisionIdSchema, AgentErrorContextSchema, AgentErrorSchema, AgentInstanceIdSchema, AgentIntegrationIdSchema, AgentIntegrationResourceIdSchema, AgentIntegrationServerIdSchema, AgentIntegrationToolIdSchema, AgentIsoDateTimeSchema, AgentItemIdSchema, AgentJsonValueSchema, AgentManagedContentIdSchema, AgentEnvironmentIdSchema, AgentEffectiveContentIdSchema, AgentCommandIdSchema, AgentExtensionIdSchema, AgentOperationIdSchema, AgentOperationInvocationIdSchema, AgentProviderConversationIdSchema, AgentProviderHistoryAnchorSchema, AgentProviderItemRefSchema, AgentProviderKeySchema, AgentProviderRefsSchema, AgentProviderRequestRefSchema, AgentProviderTurnRefSchema, AgentRequestFieldIdSchema, AgentRequestIdSchema, AgentSessionIdSchema, AgentGeneratedResourceIdSchema, AgentTurnIdSchema, } from './foundation.js';
+export { AgentApprovalOptionIdSchema, AgentArtifactIdSchema, AgentCollaborationIdSchema, AgentConfigurationRevisionIdSchema, AgentInstanceIdSchema, AgentIntegrationIdSchema, AgentIntegrationResourceIdSchema, AgentIntegrationServerIdSchema, AgentIntegrationToolIdSchema, AgentIsoDateTimeSchema, AgentItemIdSchema, AgentJsonValueSchema, AgentManagedContentIdSchema, AgentEnvironmentIdSchema, AgentEffectiveContentIdSchema, AgentCommandIdSchema, AgentExtensionIdSchema, AgentOperationIdSchema, AgentOperationInvocationIdSchema, AgentProviderConversationIdSchema, AgentProviderHistoryAnchorSchema, AgentProviderItemRefSchema, AgentProviderKeySchema, AgentProviderRefsSchema, AgentProviderRequestRefSchema, AgentProviderTurnRefSchema, AgentRequestFieldIdSchema, AgentRequestIdSchema, AgentSessionIdSchema, AgentGeneratedResourceIdSchema, AgentTurnIdSchema, } from './foundation.js';
+export { AgentErrorContextSchema, AgentErrorSchema, AgentFailureCategorySchema, AgentFailureQuotaReferenceSchema, AgentRecoveryHintSchema, } from './failures.js';
 export { AgentSessionBindingSchema, AgentSessionBranchSourceSchema, AgentSessionBranchInputSchema, AgentSessionConfigurationSchema, AgentSessionCreateInputSchema, AgentSessionOpenInputSchema, AgentSessionResumeInputSchema, } from './sessions.js';
 export { AgentBrowserActionDetailsSchema, AgentCollaborationToolCallDetailsSchema, AgentCommandExecutionDetailsSchema, AgentComputerActionDetailsSchema, AgentContentStreamKindSchema, AgentContextCompactionDetailsSchema, AgentDiffSummarySchema, AgentDynamicToolCallDetailsSchema, AgentFileChangeDetailsSchema, AgentFileChangeSchema, AgentImageViewDetailsSchema, AgentItemSnapshotSchema, AgentMcpToolCallDetailsSchema, AgentPlanStepSchema, AgentReviewDetailsSchema, AgentTurnCompletedPayloadSchema, AgentTurnInputContentCompositionSchema, AgentTurnInputContentSchema, AgentTurnInteractionModeSchema, AgentTurnInputPartSchema, AgentContentReferenceInputPartSchema, AgentTurnInterruptionInputSchema, AgentTurnRunInputSchema, AgentWebSearchDetailsSchema, } from './turns.js';
 export { AgentApprovalRequestSchema, AgentApprovalResolutionSchema, AgentElicitationRequestSchema, AgentRequestResolutionSchema, AgentRequestSchema, } from './requests.js';

package/dist/zod/index.js

@@ -3,8 +3,6 @@ import {
   AgentArtifactIdSchema,
   AgentCollaborationIdSchema,
   AgentConfigurationRevisionIdSchema,
-  AgentErrorContextSchema,
-  AgentErrorSchema,
   AgentInstanceIdSchema,
   AgentIntegrationIdSchema,
   AgentIntegrationResourceIdSchema,
@@ -33,6 +31,13 @@ import {
   AgentGeneratedResourceIdSchema,
   AgentTurnIdSchema
 } from "./foundation.js";
+import {
+  AgentErrorContextSchema,
+  AgentErrorSchema,
+  AgentFailureCategorySchema,
+  AgentFailureQuotaReferenceSchema,
+  AgentRecoveryHintSchema
+} from "./failures.js";
 import {
   AgentSessionBindingSchema,
   AgentSessionBranchSourceSchema,
@@ -152,6 +157,8 @@ export {
   AgentErrorSchema,
   AgentEventSchema,
   AgentExtensionIdSchema,
+  AgentFailureCategorySchema,
+  AgentFailureQuotaReferenceSchema,
   AgentFileChangeDetailsSchema,
   AgentFileChangeSchema,
   AgentGeneratedResourceDescriptorSchema,
@@ -188,6 +195,7 @@ export {
   AgentProviderRefsSchema,
   AgentProviderRequestRefSchema,
   AgentProviderTurnRefSchema,
+  AgentRecoveryHintSchema,
   AgentRequestFieldIdSchema,
   AgentRequestIdSchema,
   AgentRequestResolutionSchema,

package/dist/zod/operations.d.ts

@@ -163,16 +163,16 @@ declare const AgentOperationDescriptorPortableSchema: z.ZodReadonly<z.ZodObject<
         }>;
     }, z.core.$strict>>], "fieldKind">>>;
     confirmation: z.ZodEnum<{
-        required: "required";
         none: "none";
+        required: "required";
     }>;
     idempotency: z.ZodEnum<{
         required: "required";
         not_required: "not_required";
     }>;
     resultKind: z.ZodEnum<{
-        resource: "resource";
         none: "none";
+        resource: "resource";
         canonical_output: "canonical_output";
         artifact: "artifact";
     }>;
@@ -277,16 +277,16 @@ export declare const AgentOperationCatalogPortableSchema: z.ZodReadonly<z.ZodObj
             }>;
         }, z.core.$strict>>], "fieldKind">>>;
         confirmation: z.ZodEnum<{
-            required: "required";
             none: "none";
+            required: "required";
         }>;
         idempotency: z.ZodEnum<{
             required: "required";
             not_required: "not_required";
         }>;
         resultKind: z.ZodEnum<{
-            resource: "resource";
             none: "none";
+            resource: "resource";
             canonical_output: "canonical_output";
             artifact: "artifact";
         }>;

package/dist/zod/operations.js

@@ -1,4 +1,5 @@
 import { z } from "zod/v4";
+import { AgentErrorSchema } from "./failures.js";
 import { compareStringsByUnicodeCodePoint } from "../foundation/ordering.js";
 import {
   AGENT_OPERATION_CATALOG_MAX_LENGTH,
@@ -19,7 +20,6 @@ import {
 import {
   AgentArtifactIdSchema,
   AgentCanonicalIdValueSchema,
-  AgentErrorSchema,
   AgentGeneratedResourceIdSchema,
   AgentOperationIdSchema,
   AgentOperationInvocationIdSchema,

package/dist/zod/resources.js

@@ -1,4 +1,5 @@
 import { z } from "zod/v4";
+import { AgentErrorSchema } from "./failures.js";
 import { AGENT_ARTIFACT_BYTE_SIZE_MAX } from "../artifacts/types.js";
 import {
   AGENT_GENERATED_RESOURCE_DISPLAY_NAME_MAX_LENGTH,
@@ -9,7 +10,6 @@ import {
 import {
   AgentArtifactIdSchema,
   AgentCollaborationIdSchema,
-  AgentErrorSchema,
   AgentGeneratedResourceIdSchema,
   AgentIsoDateTimeSchema,
   AgentOperationInvocationIdSchema,