@agen-ai/agent-protocol 0.4.0 → 0.4.2

package/dist/zod/requests.d.ts

@@ -1,5 +1,32 @@
 import { z } from 'zod/v4';
 import type { AgentApprovalRequest, AgentApprovalResolution, AgentElicitationRequest, AgentRequest, AgentRequestResolution } from '../requests/types.js';
+export declare const AgentApprovalConsequenceSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"scoped">;
+    persistence: z.ZodEnum<{
+        session: "session";
+        once: "once";
+        workspace: "workspace";
+    }>;
+    scope: z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodEnum<{
+            exact_action: "exact_action";
+            command_pattern: "command_pattern";
+            domain: "domain";
+            tool: "tool";
+            server: "server";
+            all_edits: "all_edits";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"provider_managed_remembrance">;
+    duration: z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"unknown">;
+    }, z.core.$strict>>;
+    applicability: z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"unknown">;
+    }, z.core.$strict>>;
+    explanation: z.ZodString;
+}, z.core.$strict>>], "kind">;
 export declare const AgentApprovalRequestPortableSchema: z.ZodReadonly<z.ZodObject<{
     requestKind: z.ZodLiteral<"approval">;
     requestId: z.ZodType<import("../index.js").AgentRequestId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestId, unknown>>;
@@ -11,10 +38,10 @@ export declare const AgentApprovalRequestPortableSchema: z.ZodReadonly<z.ZodObje
         artifactId: z.ZodType<import("../index.js").AgentArtifactId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentArtifactId, unknown>>;
     }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
         kind: z.ZodEnum<{
-            other: "other";
-            file_change: "file_change";
             tool: "tool";
             command: "command";
+            file_change: "file_change";
+            other: "other";
         }>;
         title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -28,25 +55,104 @@ export declare const AgentApprovalRequestPortableSchema: z.ZodReadonly<z.ZodObje
             approved: "approved";
             denied: "denied";
         }>;
-        persistence: z.ZodEnum<{
-            session: "session";
-            once: "once";
-            workspace: "workspace";
-        }>;
-        scope: z.ZodReadonly<z.ZodObject<{
-            kind: z.ZodEnum<{
-                exact_action: "exact_action";
-                command_pattern: "command_pattern";
-                domain: "domain";
-                tool: "tool";
-                server: "server";
-                all_edits: "all_edits";
+        consequence: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodLiteral<"scoped">;
+            persistence: z.ZodEnum<{
+                session: "session";
+                once: "once";
+                workspace: "workspace";
             }>;
-        }, z.core.$strict>>;
+            scope: z.ZodReadonly<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    exact_action: "exact_action";
+                    command_pattern: "command_pattern";
+                    domain: "domain";
+                    tool: "tool";
+                    server: "server";
+                    all_edits: "all_edits";
+                }>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodLiteral<"provider_managed_remembrance">;
+            duration: z.ZodReadonly<z.ZodObject<{
+                kind: z.ZodLiteral<"unknown">;
+            }, z.core.$strict>>;
+            applicability: z.ZodReadonly<z.ZodObject<{
+                kind: z.ZodLiteral<"unknown">;
+            }, z.core.$strict>>;
+            explanation: z.ZodString;
+        }, z.core.$strict>>], "kind">;
     }, z.core.$strict>>>>;
     expiresAt: z.ZodOptional<z.ZodType<import("../index.js").AgentIsoDateTime, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentIsoDateTime, unknown>>>;
 }, z.core.$strict>>;
 export declare const AgentApprovalRequestSchema: z.ZodType<AgentApprovalRequest>;
+export declare const AgentElicitationFieldSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"text">;
+    multiline: z.ZodBoolean;
+    maxLength: z.ZodNumber;
+    fieldId: z.ZodType<import("../index.js").AgentRequestFieldId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestFieldId, unknown>>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodBoolean;
+    sensitivity: z.ZodEnum<{
+        ordinary: "ordinary";
+        sensitive: "sensitive";
+    }>;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"single_select">;
+    options: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        value: z.ZodIntersection<z.ZodString, z.ZodString>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>>;
+    allowOther: z.ZodBoolean;
+    fieldId: z.ZodType<import("../index.js").AgentRequestFieldId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestFieldId, unknown>>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodBoolean;
+    sensitivity: z.ZodEnum<{
+        ordinary: "ordinary";
+        sensitive: "sensitive";
+    }>;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"multi_select">;
+    options: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        value: z.ZodIntersection<z.ZodString, z.ZodString>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>>;
+    allowOther: z.ZodBoolean;
+    maxSelections: z.ZodNumber;
+    fieldId: z.ZodType<import("../index.js").AgentRequestFieldId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestFieldId, unknown>>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodBoolean;
+    sensitivity: z.ZodEnum<{
+        ordinary: "ordinary";
+        sensitive: "sensitive";
+    }>;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"boolean">;
+    fieldId: z.ZodType<import("../index.js").AgentRequestFieldId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestFieldId, unknown>>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodBoolean;
+    sensitivity: z.ZodEnum<{
+        ordinary: "ordinary";
+        sensitive: "sensitive";
+    }>;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"confirmation">;
+    confirmLabel: z.ZodString;
+    fieldId: z.ZodType<import("../index.js").AgentRequestFieldId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestFieldId, unknown>>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodBoolean;
+    sensitivity: z.ZodEnum<{
+        ordinary: "ordinary";
+        sensitive: "sensitive";
+    }>;
+}, z.core.$strict>>], "kind">;
 export declare const AgentElicitationRequestPortableSchema: z.ZodReadonly<z.ZodObject<{
     requestKind: z.ZodLiteral<"elicitation">;
     requestId: z.ZodType<import("../index.js").AgentRequestId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestId, unknown>>;
@@ -120,6 +226,7 @@ export declare const AgentElicitationRequestPortableSchema: z.ZodReadonly<z.ZodO
     }, z.core.$strict>>], "kind">>>;
     expiresAt: z.ZodOptional<z.ZodType<import("../index.js").AgentIsoDateTime, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentIsoDateTime, unknown>>>;
 }, z.core.$strict>>;
+export declare function refineAgentElicitationFields(fields: readonly z.output<typeof AgentElicitationFieldSchema>[], context: z.RefinementCtx): void;
 export declare const AgentElicitationRequestSchema: z.ZodType<AgentElicitationRequest>;
 export declare const AgentRequestPortableSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
     requestKind: z.ZodLiteral<"approval">;
@@ -132,10 +239,10 @@ export declare const AgentRequestPortableSchema: z.ZodDiscriminatedUnion<[z.ZodR
         artifactId: z.ZodType<import("../index.js").AgentArtifactId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentArtifactId, unknown>>;
     }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
         kind: z.ZodEnum<{
-            other: "other";
-            file_change: "file_change";
             tool: "tool";
             command: "command";
+            file_change: "file_change";
+            other: "other";
         }>;
         title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -149,21 +256,33 @@ export declare const AgentRequestPortableSchema: z.ZodDiscriminatedUnion<[z.ZodR
             approved: "approved";
             denied: "denied";
         }>;
-        persistence: z.ZodEnum<{
-            session: "session";
-            once: "once";
-            workspace: "workspace";
-        }>;
-        scope: z.ZodReadonly<z.ZodObject<{
-            kind: z.ZodEnum<{
-                exact_action: "exact_action";
-                command_pattern: "command_pattern";
-                domain: "domain";
-                tool: "tool";
-                server: "server";
-                all_edits: "all_edits";
+        consequence: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodLiteral<"scoped">;
+            persistence: z.ZodEnum<{
+                session: "session";
+                once: "once";
+                workspace: "workspace";
             }>;
-        }, z.core.$strict>>;
+            scope: z.ZodReadonly<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    exact_action: "exact_action";
+                    command_pattern: "command_pattern";
+                    domain: "domain";
+                    tool: "tool";
+                    server: "server";
+                    all_edits: "all_edits";
+                }>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodLiteral<"provider_managed_remembrance">;
+            duration: z.ZodReadonly<z.ZodObject<{
+                kind: z.ZodLiteral<"unknown">;
+            }, z.core.$strict>>;
+            applicability: z.ZodReadonly<z.ZodObject<{
+                kind: z.ZodLiteral<"unknown">;
+            }, z.core.$strict>>;
+            explanation: z.ZodString;
+        }, z.core.$strict>>], "kind">;
     }, z.core.$strict>>>>;
     expiresAt: z.ZodOptional<z.ZodType<import("../index.js").AgentIsoDateTime, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentIsoDateTime, unknown>>>;
 }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
@@ -240,6 +359,29 @@ export declare const AgentRequestPortableSchema: z.ZodDiscriminatedUnion<[z.ZodR
     expiresAt: z.ZodOptional<z.ZodType<import("../index.js").AgentIsoDateTime, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentIsoDateTime, unknown>>>;
 }, z.core.$strict>>], "requestKind">;
 export declare const AgentRequestSchema: z.ZodType<AgentRequest>;
+export declare const AgentElicitationAnswerSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    fieldId: z.ZodType<import("../index.js").AgentRequestFieldId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestFieldId, unknown>>;
+    kind: z.ZodLiteral<"text">;
+    value: z.ZodString;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    fieldId: z.ZodType<import("../index.js").AgentRequestFieldId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestFieldId, unknown>>;
+    kind: z.ZodLiteral<"single_select">;
+    value: z.ZodOptional<z.ZodIntersection<z.ZodString, z.ZodString>>;
+    other: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    fieldId: z.ZodType<import("../index.js").AgentRequestFieldId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestFieldId, unknown>>;
+    kind: z.ZodLiteral<"multi_select">;
+    values: z.ZodReadonly<z.ZodArray<z.ZodIntersection<z.ZodString, z.ZodString>>>;
+    other: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    fieldId: z.ZodType<import("../index.js").AgentRequestFieldId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestFieldId, unknown>>;
+    kind: z.ZodLiteral<"boolean">;
+    value: z.ZodBoolean;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    fieldId: z.ZodType<import("../index.js").AgentRequestFieldId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestFieldId, unknown>>;
+    kind: z.ZodLiteral<"confirmation">;
+    confirmed: z.ZodBoolean;
+}, z.core.$strict>>], "kind">;
 export declare const AgentApprovalResolutionSchema: z.ZodType<AgentApprovalResolution>;
 export declare const AgentRequestResolutionPortableSchema: z.ZodUnion<readonly [z.ZodType<AgentApprovalResolution, unknown, z.core.$ZodTypeInternals<AgentApprovalResolution, unknown>>, z.ZodReadonly<z.ZodObject<{
     requestKind: z.ZodLiteral<"elicitation">;
@@ -273,5 +415,6 @@ export declare const AgentRequestResolutionPortableSchema: z.ZodUnion<readonly [
     requestId: z.ZodType<import("../index.js").AgentRequestId, unknown, z.core.$ZodTypeInternals<import("../index.js").AgentRequestId, unknown>>;
     disposition: z.ZodLiteral<"canceled">;
 }, z.core.$strict>>]>;
+export declare function refineAgentElicitationAnswers(answers: readonly z.output<typeof AgentElicitationAnswerSchema>[], context: z.RefinementCtx): void;
 export declare const AgentRequestResolutionSchema: z.ZodType<AgentRequestResolution>;
 //# sourceMappingURL=requests.d.ts.map

package/dist/zod/requests.js

@@ -25,13 +25,25 @@ import {
 const AgentApprovalLabelSchema = z.string().min(1).max(AGENT_APPROVAL_LABEL_MAX_LENGTH).regex(/^(?:\S|\S[\s\S]*\S)$/u);
 const AgentApprovalDescriptionSchema = z.string().min(1).max(AGENT_APPROVAL_DESCRIPTION_MAX_LENGTH).regex(/^(?:\S|\S[\s\S]*\S)$/u);
 const AgentApprovalPromptSchema = z.string().min(1).max(AGENT_PROTOCOL_TEXT_MAX_LENGTH).regex(/^(?:\S|\S[\s\S]*\S)$/u);
+const AgentApprovalConsequenceSchema = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("scoped"),
+    persistence: z.enum(AGENT_APPROVAL_PERSISTENCES),
+    scope: z.object({ kind: z.enum(AGENT_APPROVAL_SCOPE_KINDS) }).strict().readonly()
+  }).strict().readonly(),
+  z.object({
+    kind: z.literal("provider_managed_remembrance"),
+    duration: z.object({ kind: z.literal("unknown") }).strict().readonly(),
+    applicability: z.object({ kind: z.literal("unknown") }).strict().readonly(),
+    explanation: AgentApprovalDescriptionSchema
+  }).strict().readonly()
+]);
 const AgentApprovalOptionSchema = z.object({
   optionId: AgentApprovalOptionIdSchema,
   label: AgentApprovalLabelSchema,
   description: AgentApprovalDescriptionSchema.optional(),
   decision: z.enum(["approved", "denied"]),
-  persistence: z.enum(AGENT_APPROVAL_PERSISTENCES),
-  scope: z.object({ kind: z.enum(AGENT_APPROVAL_SCOPE_KINDS) }).strict().readonly()
+  consequence: AgentApprovalConsequenceSchema
 }).strict().readonly();
 const AgentApprovalRequestPortableSchema = z.object({
   requestKind: z.literal("approval"),
@@ -120,9 +132,9 @@ const AgentElicitationRequestPortableSchema = z.object({
   fields: z.array(AgentElicitationFieldSchema).min(1).max(AGENT_ELICITATION_FIELDS_MAX_LENGTH).readonly(),
   expiresAt: AgentIsoDateTimeSchema.optional()
 }).strict().readonly();
-const AgentElicitationRequestSchema = AgentElicitationRequestPortableSchema.superRefine((request, context) => {
+function refineAgentElicitationFields(fields, context) {
   const fieldIds = /* @__PURE__ */ new Set();
-  request.fields.forEach((field, fieldIndex) => {
+  fields.forEach((field, fieldIndex) => {
     if (fieldIds.has(field.fieldId)) {
       context.addIssue({
         code: "custom",
@@ -153,6 +165,9 @@ const AgentElicitationRequestSchema = AgentElicitationRequestPortableSchema.supe
       });
     }
   });
+}
+const AgentElicitationRequestSchema = AgentElicitationRequestPortableSchema.superRefine((request, context) => {
+  refineAgentElicitationFields(request.fields, context);
 });
 const AgentRequestPortableSchema = z.discriminatedUnion("requestKind", [
   AgentApprovalRequestPortableSchema,
@@ -226,11 +241,8 @@ const AgentRequestResolutionPortableSchema = z.union([
     disposition: z.literal("canceled")
   }).strict().readonly()
 ]);
-const AgentRequestResolutionSchema = AgentRequestResolutionPortableSchema.superRefine((resolution, context) => {
-  if (resolution.requestKind !== "elicitation" || resolution.disposition !== "answered") {
-    return;
-  }
-  resolution.answers.forEach((answer, answerIndex) => {
+function refineAgentElicitationAnswers(answers, context) {
+  answers.forEach((answer, answerIndex) => {
     if (answer.kind === "multi_select" && new Set(answer.values).size !== answer.values.length) {
       context.addIssue({
         code: "custom",
@@ -246,15 +258,26 @@ const AgentRequestResolutionSchema = AgentRequestResolutionPortableSchema.superR
       });
     }
   });
+}
+const AgentRequestResolutionSchema = AgentRequestResolutionPortableSchema.superRefine((resolution, context) => {
+  if (resolution.requestKind !== "elicitation" || resolution.disposition !== "answered") {
+    return;
+  }
+  refineAgentElicitationAnswers(resolution.answers, context);
 });
 export {
+  AgentApprovalConsequenceSchema,
   AgentApprovalRequestPortableSchema,
   AgentApprovalRequestSchema,
   AgentApprovalResolutionSchema,
+  AgentElicitationAnswerSchema,
+  AgentElicitationFieldSchema,
   AgentElicitationRequestPortableSchema,
   AgentElicitationRequestSchema,
   AgentRequestPortableSchema,
   AgentRequestResolutionPortableSchema,
   AgentRequestResolutionSchema,
-  AgentRequestSchema
+  AgentRequestSchema,
+  refineAgentElicitationAnswers,
+  refineAgentElicitationFields
 };