@agen-ai/agent-protocol 0.2.4 → 0.3.0

package/dist/zod/environment.js

@@ -0,0 +1,336 @@
+import { z } from "zod/v4";
+import {
+  agentProtocolSerializedJsonBytes
+} from "../foundation/types.js";
+import {
+  AGENT_ENVIRONMENT_COMPLETENESSES,
+  AGENT_ENVIRONMENT_DOMAIN_CATALOG_BYTES_LIMIT,
+  AGENT_ENVIRONMENT_DOMAINS,
+  AGENT_ENVIRONMENT_EVIDENCE_EXTENTS,
+  AGENT_ENVIRONMENT_EFFECTIVE_ENTRIES_MAX_LENGTH,
+  AGENT_ENVIRONMENT_INTEGRATION_CONTRIBUTIONS_MAX_LENGTH,
+  AGENT_ENVIRONMENT_SCHEMA_VERSION,
+  AGENT_ENVIRONMENT_SNAPSHOT_BYTES_LIMIT
+} from "../environment/types.js";
+import {
+  AgentCommandCatalogPortableSchema,
+  AgentCommandCatalogSchema
+} from "../zod/commands.js";
+import {
+  AgentEffectiveContentCatalogPortableSchema,
+  AgentEffectiveContentCatalogSchema
+} from "../zod/effectiveContent.js";
+import {
+  AgentExtensionCatalogPortableSchema,
+  AgentExtensionCatalogSchema
+} from "./extensions.js";
+import {
+  AgentIntegrationCatalogPortableSchema,
+  AgentIntegrationCatalogSchema
+} from "./integrations.js";
+import {
+  AgentEnvironmentReasonSchema
+} from "./environmentFacts.js";
+import {
+  AgentEnvironmentIdSchema,
+  withAcyclicProtocolInput
+} from "./foundation.js";
+const PositiveSafeIntegerSchema = z.number().int().positive().max(Number.MAX_SAFE_INTEGER);
+const DomainSchema = z.enum(AGENT_ENVIRONMENT_DOMAINS);
+const ReasonSchema = AgentEnvironmentReasonSchema;
+const ReasonListBaseSchema = z.array(ReasonSchema).max(16);
+const ReasonListSchema = ReasonListBaseSchema.readonly();
+const NonEmptyReasonListSchema = ReasonListBaseSchema.min(1).readonly();
+function addUniqueIssues(values, path, label, context) {
+  const seen = /* @__PURE__ */ new Set();
+  values.forEach((value, index) => {
+    if (seen.has(value)) {
+      context.addIssue({
+        code: "custom",
+        path: [...path, index],
+        message: `${label} must be unique.`
+      });
+    }
+    seen.add(value);
+  });
+}
+const AvailableDomainResultBaseSchema = z.object({
+  kind: z.literal("available"),
+  extent: z.enum(AGENT_ENVIRONMENT_EVIDENCE_EXTENTS),
+  completeness: z.enum(AGENT_ENVIRONMENT_COMPLETENESSES),
+  reasons: ReasonListSchema
+}).strict();
+const UnavailableDomainResultSchema = z.discriminatedUnion("kind", [
+  z.object({ kind: z.literal("unsupported"), reasons: ReasonListSchema }).strict().readonly(),
+  z.object({ kind: z.literal("not_initialized"), reasons: ReasonListSchema }).strict().readonly(),
+  z.object({ kind: z.literal("unavailable"), reasons: NonEmptyReasonListSchema }).strict().readonly()
+]);
+function availableDomainResultSchema(catalog) {
+  return AvailableDomainResultBaseSchema.extend({ catalog }).strict().superRefine((result, context) => {
+    if (result.completeness === "complete" && result.reasons.length !== 0) {
+      context.addIssue({
+        code: "custom",
+        path: ["reasons"],
+        message: "Complete environment results cannot carry reasons."
+      });
+    }
+    if (result.completeness === "partial" && result.reasons.length === 0) {
+      context.addIssue({
+        code: "custom",
+        path: ["reasons"],
+        message: "Partial environment results require at least one reason."
+      });
+    }
+  }).readonly();
+}
+function domainResultSchema(catalog) {
+  return z.union([
+    availableDomainResultSchema(catalog),
+    UnavailableDomainResultSchema
+  ]);
+}
+const ContentResultPortableSchema = domainResultSchema(
+  AgentEffectiveContentCatalogPortableSchema
+);
+const CommandsResultPortableSchema = domainResultSchema(AgentCommandCatalogPortableSchema);
+const ExtensionsResultPortableSchema = domainResultSchema(AgentExtensionCatalogPortableSchema);
+const IntegrationsResultPortableSchema = domainResultSchema(AgentIntegrationCatalogPortableSchema);
+const AgentEnvironmentContentResultPortableSchema = ContentResultPortableSchema;
+const AgentEnvironmentCommandsResultPortableSchema = CommandsResultPortableSchema;
+const AgentEnvironmentExtensionsResultPortableSchema = ExtensionsResultPortableSchema;
+const AgentEnvironmentIntegrationsResultPortableSchema = IntegrationsResultPortableSchema;
+const ContentResultSchema = domainResultSchema(AgentEffectiveContentCatalogSchema);
+const CommandsResultSchema = domainResultSchema(AgentCommandCatalogSchema);
+const ExtensionsResultSchema = domainResultSchema(AgentExtensionCatalogSchema);
+const IntegrationsResultSchema = domainResultSchema(AgentIntegrationCatalogSchema);
+const AgentEnvironmentContentResultSchema = withAcyclicProtocolInput(ContentResultSchema, {
+  maxDepth: 16,
+  maxCollectionLength: AGENT_ENVIRONMENT_EFFECTIVE_ENTRIES_MAX_LENGTH * 8
+});
+const AgentEnvironmentCommandsResultSchema = withAcyclicProtocolInput(CommandsResultSchema, {
+  maxDepth: 16,
+  maxCollectionLength: AGENT_ENVIRONMENT_EFFECTIVE_ENTRIES_MAX_LENGTH * 8
+});
+const AgentEnvironmentExtensionsResultSchema = withAcyclicProtocolInput(ExtensionsResultSchema, {
+  maxDepth: 16,
+  maxCollectionLength: 16384
+});
+const AgentEnvironmentIntegrationsResultSchema = withAcyclicProtocolInput(IntegrationsResultSchema, {
+  maxDepth: 16,
+  maxCollectionLength: 16384
+});
+function addDomainByteBound(value, path, context) {
+  if (agentProtocolSerializedJsonBytes(value) > AGENT_ENVIRONMENT_DOMAIN_CATALOG_BYTES_LIMIT) {
+    context.addIssue({
+      code: "custom",
+      path: [...path],
+      message: "Environment domain exceeds its serialized UTF-8 byte limit."
+    });
+  }
+}
+function validateAvailableDomainBytes(result, path, context) {
+  if (typeof result !== "object" || result === null || !("kind" in result)) return;
+  if (result.kind !== "available") return;
+  addDomainByteBound(result, path, context);
+}
+const SnapshotBaseSchema = z.object({
+  schemaVersion: z.literal(AGENT_ENVIRONMENT_SCHEMA_VERSION),
+  environmentId: AgentEnvironmentIdSchema,
+  revision: PositiveSafeIntegerSchema
+}).strict();
+const AgentEnvironmentSnapshotPortableSchema = SnapshotBaseSchema.extend({
+  content: ContentResultPortableSchema,
+  commands: CommandsResultPortableSchema,
+  extensions: ExtensionsResultPortableSchema,
+  integrations: IntegrationsResultPortableSchema
+}).strict().readonly();
+function findContent(result, id, revision) {
+  if (result.kind !== "available") return null;
+  const entry = result.catalog.content.find((candidate) => candidate.contentId === id);
+  return entry && entry.revision === revision ? entry : null;
+}
+function findCommand(result, id, revision) {
+  if (result.kind !== "available") return null;
+  const entry = result.catalog.commands.find((candidate) => candidate.commandId === id);
+  return entry && entry.revision === revision ? entry : null;
+}
+function findIntegration(result, id, revision) {
+  if (result.kind !== "available") return null;
+  const entry = result.catalog.integrations.find((candidate) => candidate.integrationId === id);
+  return entry && entry.revision === revision ? entry : null;
+}
+function findExtension(result, id, revision) {
+  if (result.kind !== "available") return null;
+  const entry = result.catalog.extensions.find((candidate) => candidate.extensionId === id);
+  return entry && entry.revision === revision ? entry : null;
+}
+function validateContentExtensionReferences(snapshot, context) {
+  if (snapshot.content.kind !== "available") return;
+  snapshot.content.catalog.content.forEach((descriptor, descriptorIndex) => {
+    const reference = descriptor.extension;
+    if (reference === void 0) return;
+    const path = ["content", "catalog", "content", descriptorIndex, "extension"];
+    const entry = findExtension(
+      snapshot.extensions,
+      reference.extensionId,
+      reference.revision
+    );
+    if (snapshot.extensions.kind !== "available" || snapshot.extensions.catalog.revision !== reference.catalogRevision || entry === null) {
+      context.addIssue({
+        code: "custom",
+        path,
+        message: "Content extension reference must resolve in the exact catalog revision."
+      });
+    }
+  });
+}
+function validateComponentReferences(snapshot, context) {
+  if (snapshot.extensions.kind !== "available") return;
+  snapshot.extensions.catalog.extensions.forEach((extension, extensionIndex) => {
+    extension.components.forEach((component, componentIndex) => {
+      if (!("target" in component) || component.target === void 0) return;
+      const target = component.target;
+      const path = [
+        "extensions",
+        "catalog",
+        "extensions",
+        extensionIndex,
+        "components",
+        componentIndex,
+        "target"
+      ];
+      if (component.kind === "skill" || component.kind === "rule" || component.kind === "prompt" || component.kind === "agent_definition") {
+        if (target.domain !== "content") {
+          context.addIssue({ code: "custom", path: [...path, "domain"], message: "Content components require a content target." });
+          return;
+        }
+        const entry = findContent(snapshot.content, target.id, target.revision);
+        if (snapshot.content.kind !== "available" || snapshot.content.catalog.revision !== target.catalogRevision || entry === null) {
+          context.addIssue({ code: "custom", path, message: "Content target must resolve in the exact catalog revision." });
+          return;
+        }
+        if (entry.kind !== component.kind) {
+          context.addIssue({ code: "custom", path, message: "Content target kind contradicts the component kind." });
+        }
+        return;
+      }
+      if (component.kind === "command") {
+        if (target.domain !== "commands") {
+          context.addIssue({ code: "custom", path: [...path, "domain"], message: "Command components require a commands target." });
+          return;
+        }
+        const entry = findCommand(snapshot.commands, target.id, target.revision);
+        if (snapshot.commands.kind !== "available" || snapshot.commands.catalog.revision !== target.catalogRevision || entry === null) {
+          context.addIssue({ code: "custom", path, message: "Command target must resolve in the exact catalog revision." });
+        }
+        return;
+      }
+      if (component.kind === "mcp_server" || component.kind === "connector") {
+        if (target.domain !== "integrations") {
+          context.addIssue({ code: "custom", path: [...path, "domain"], message: "Integration components require an integrations target." });
+          return;
+        }
+        const entry = findIntegration(snapshot.integrations, target.id, target.revision);
+        if (snapshot.integrations.kind !== "available" || snapshot.integrations.catalog.revision !== target.catalogRevision || entry === null) {
+          context.addIssue({ code: "custom", path, message: "Integration target must resolve in the exact catalog revision." });
+          return;
+        }
+        const expectedKind = component.kind === "mcp_server" ? "mcp" : "connector";
+        if (entry.kind !== expectedKind) {
+          context.addIssue({ code: "custom", path, message: "Integration target kind contradicts the component kind." });
+        }
+      }
+    });
+  });
+}
+const AgentEnvironmentSnapshotSchema = withAcyclicProtocolInput(
+  SnapshotBaseSchema.extend({
+    content: ContentResultSchema,
+    commands: CommandsResultSchema,
+    extensions: ExtensionsResultSchema,
+    integrations: IntegrationsResultSchema
+  }).strict().readonly(),
+  {
+    maxDepth: 16,
+    maxCollectionLength: 32768
+  }
+).superRefine((snapshot, context) => {
+  validateAvailableDomainBytes(snapshot.content, ["content"], context);
+  validateAvailableDomainBytes(snapshot.commands, ["commands"], context);
+  validateAvailableDomainBytes(snapshot.extensions, ["extensions"], context);
+  validateAvailableDomainBytes(snapshot.integrations, ["integrations"], context);
+  const contentCount = snapshot.content.kind === "available" ? snapshot.content.catalog.content.length : 0;
+  const commandCount = snapshot.commands.kind === "available" ? snapshot.commands.catalog.commands.length : 0;
+  if (contentCount + commandCount > AGENT_ENVIRONMENT_EFFECTIVE_ENTRIES_MAX_LENGTH) {
+    context.addIssue({
+      code: "custom",
+      path: ["content"],
+      message: "Effective content and command entries exceed the aggregate limit."
+    });
+  }
+  const integrationContributions = snapshot.integrations.kind === "available" ? snapshot.integrations.catalog.integrations.reduce((total, integration) => total + (integration.kind === "mcp" ? integration.servers.reduce((serverTotal, server) => serverTotal + server.tools.length + server.resources.length, 0) : integration.tools?.length ?? 0), 0) : 0;
+  if (integrationContributions > AGENT_ENVIRONMENT_INTEGRATION_CONTRIBUTIONS_MAX_LENGTH) {
+    context.addIssue({
+      code: "custom",
+      path: ["integrations"],
+      message: "Integration tools and resources exceed the aggregate limit."
+    });
+  }
+  validateContentExtensionReferences(snapshot, context);
+  validateComponentReferences(snapshot, context);
+  if (agentProtocolSerializedJsonBytes(snapshot) > AGENT_ENVIRONMENT_SNAPSHOT_BYTES_LIMIT) {
+    context.addIssue({
+      code: "custom",
+      message: "Environment snapshot exceeds its serialized UTF-8 byte limit."
+    });
+  }
+});
+const AgentEnvironmentInvalidationSchema = withAcyclicProtocolInput(z.object({
+  environmentId: AgentEnvironmentIdSchema,
+  domains: z.array(DomainSchema).min(1).max(AGENT_ENVIRONMENT_DOMAINS.length).readonly()
+}).strict().readonly(), {
+  maxDepth: 4,
+  maxCollectionLength: AGENT_ENVIRONMENT_DOMAINS.length + 2
+}).superRefine((invalidation, context) => {
+  addUniqueIssues(invalidation.domains, ["domains"], "Invalidation domains", context);
+});
+const EnvironmentReadCapabilitySchema = z.union([
+  z.object({ kind: z.literal("unsupported") }).strict().readonly(),
+  z.object({
+    kind: z.literal("read"),
+    domains: z.array(DomainSchema).min(1).max(AGENT_ENVIRONMENT_DOMAINS.length).readonly()
+  }).strict().readonly(),
+  z.object({
+    kind: z.literal("read_and_watch"),
+    domains: z.array(DomainSchema).min(1).max(AGENT_ENVIRONMENT_DOMAINS.length).readonly()
+  }).strict().readonly()
+]);
+const AgentEnvironmentReadCapabilitySchema = withAcyclicProtocolInput(
+  EnvironmentReadCapabilitySchema,
+  { maxDepth: 4, maxCollectionLength: AGENT_ENVIRONMENT_DOMAINS.length + 2 }
+).superRefine((capability, context) => {
+  if (capability.kind === "unsupported") return;
+  addUniqueIssues(capability.domains, ["domains"], "Environment capability domains", context);
+});
+const AgentEnvironmentCapabilitySchema = withAcyclicProtocolInput(z.object({
+  instance: AgentEnvironmentReadCapabilitySchema,
+  session: AgentEnvironmentReadCapabilitySchema
+}).strict().readonly(), {
+  maxDepth: 6,
+  maxCollectionLength: AGENT_ENVIRONMENT_DOMAINS.length * 2 + 4
+});
+export {
+  AgentEnvironmentCapabilitySchema,
+  AgentEnvironmentCommandsResultPortableSchema,
+  AgentEnvironmentCommandsResultSchema,
+  AgentEnvironmentContentResultPortableSchema,
+  AgentEnvironmentContentResultSchema,
+  AgentEnvironmentExtensionsResultPortableSchema,
+  AgentEnvironmentExtensionsResultSchema,
+  AgentEnvironmentIntegrationsResultPortableSchema,
+  AgentEnvironmentIntegrationsResultSchema,
+  AgentEnvironmentInvalidationSchema,
+  AgentEnvironmentReadCapabilitySchema,
+  AgentEnvironmentSnapshotPortableSchema,
+  AgentEnvironmentSnapshotSchema
+};

package/dist/zod/environmentFacts.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod/v4';
+import { type AgentAvailabilityFact, type AgentEnvironmentOrigin, type AgentEnvironmentReason, type AgentEnvironmentScope, type AgentEnvironmentSource, type AgentInvocationPosture, type AgentQualifiedExtensionReference } from '../environment/facts.js';
+export declare const AgentEnvironmentScopeSchema: z.ZodType<AgentEnvironmentScope>;
+export declare const AgentEnvironmentOriginSchema: z.ZodType<AgentEnvironmentOrigin>;
+export declare const AgentInvocationPostureSchema: z.ZodType<AgentInvocationPosture>;
+export declare const AgentEnvironmentReasonSchema: z.ZodType<AgentEnvironmentReason>;
+export declare const AgentEnvironmentSourceSchema: z.ZodType<AgentEnvironmentSource>;
+export declare const AgentAvailabilityFactSchema: z.ZodType<AgentAvailabilityFact>;
+export declare const AgentQualifiedExtensionReferenceSchema: z.ZodType<AgentQualifiedExtensionReference>;
+//# sourceMappingURL=environmentFacts.d.ts.map

package/dist/zod/environmentFacts.js

@@ -0,0 +1,40 @@
+import { z } from "zod/v4";
+import {
+  AGENT_ENVIRONMENT_ORIGINS,
+  AGENT_ENVIRONMENT_REASONS,
+  AGENT_ENVIRONMENT_SCOPES,
+  AGENT_INVOCATION_POSTURES
+} from "../environment/facts.js";
+import { AgentExtensionIdSchema } from "./foundation.js";
+const PositiveSafeIntegerSchema = z.number().int().positive().max(Number.MAX_SAFE_INTEGER);
+const AgentEnvironmentScopeSchema = z.enum(AGENT_ENVIRONMENT_SCOPES);
+const AgentEnvironmentOriginSchema = z.enum(AGENT_ENVIRONMENT_ORIGINS);
+const AgentInvocationPostureSchema = z.enum(AGENT_INVOCATION_POSTURES);
+const AgentEnvironmentReasonSchema = z.enum(AGENT_ENVIRONMENT_REASONS);
+const AgentEnvironmentSourceSchema = z.object({
+  scope: AgentEnvironmentScopeSchema,
+  origin: AgentEnvironmentOriginSchema
+}).strict().readonly();
+const AgentAvailabilityFactSchema = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("known"),
+    value: z.boolean()
+  }).strict().readonly(),
+  z.object({
+    kind: z.literal("unknown")
+  }).strict().readonly()
+]);
+const AgentQualifiedExtensionReferenceSchema = z.object({
+  extensionId: AgentExtensionIdSchema,
+  revision: PositiveSafeIntegerSchema,
+  catalogRevision: PositiveSafeIntegerSchema
+}).strict().readonly();
+export {
+  AgentAvailabilityFactSchema,
+  AgentEnvironmentOriginSchema,
+  AgentEnvironmentReasonSchema,
+  AgentEnvironmentScopeSchema,
+  AgentEnvironmentSourceSchema,
+  AgentInvocationPostureSchema,
+  AgentQualifiedExtensionReferenceSchema
+};

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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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>>>;
@@ -344,8 +344,8 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
         kind: z.ZodEnum<{
             unknown: "unknown";
             tool: "tool";
-            task: "task";
             hook: "hook";
+            task: "task";
         }>;
         phase: z.ZodEnum<{
             completed: "completed";
@@ -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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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>>>;
@@ -531,10 +531,10 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
                 archive: "archive";
             }>;
             status: z.ZodEnum<{
+                unavailable: "unavailable";
+                available: "available";
                 pending: "pending";
                 expired: "expired";
-                available: "available";
-                unavailable: "unavailable";
             }>;
             displayName: z.ZodString;
             producer: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
@@ -563,7 +563,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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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>>>;
@@ -586,7 +586,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
             status: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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 +602,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<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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>>>;
@@ -624,7 +624,7 @@ export declare const AgentEventPortableSchema: z.ZodDiscriminatedUnion<[z.ZodRea
             status: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    protocolVersion: z.ZodLiteral<8>;
+    protocolVersion: z.ZodLiteral<9>;
     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>>>;