@agen-ai/agent-protocol 0.1.0 → 0.2.0

package/dist/zod/requests.js

@@ -5,31 +5,65 @@ import {
   AGENT_PROTOCOL_TEXT_MAX_LENGTH
 } from "../foundation/types.js";
 import {
+  AGENT_APPROVAL_DESCRIPTION_MAX_LENGTH,
+  AGENT_APPROVAL_LABEL_MAX_LENGTH,
+  AGENT_APPROVAL_OPTIONS_MAX_LENGTH,
+  AGENT_APPROVAL_PERSISTENCES,
+  AGENT_APPROVAL_SCOPE_KINDS
+} from "../requests/types.js";
+import {
+  AgentApprovalOptionIdSchema,
   AgentArtifactIdSchema,
   AgentCanonicalIdValueSchema,
+  AgentItemIdSchema,
   AgentIsoDateTimeSchema,
   AgentRequestFieldIdSchema,
   AgentRequestIdSchema
 } from "./foundation.js";
-const AgentApprovalRequestSchema = z.object({
+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 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()
+}).strict().readonly();
+const AgentApprovalRequestPortableSchema = z.object({
   requestKind: z.literal("approval"),
   requestId: AgentRequestIdSchema,
-  prompt: z.string().min(1).max(AGENT_PROTOCOL_TEXT_MAX_LENGTH),
+  prompt: AgentApprovalDescriptionSchema,
   subject: z.discriminatedUnion("kind", [
     z.object({
       kind: z.literal("plan"),
-      title: z.string().min(1).max(200),
-      description: z.string().max(AGENT_PROTOCOL_SUMMARY_MAX_LENGTH).optional(),
+      title: AgentApprovalLabelSchema,
+      description: AgentApprovalDescriptionSchema.optional(),
       artifactId: AgentArtifactIdSchema
     }).strict().readonly(),
     z.object({
       kind: z.enum(["command", "file_change", "tool", "other"]),
-      title: z.string().min(1).max(200),
-      description: z.string().max(AGENT_PROTOCOL_SUMMARY_MAX_LENGTH).optional()
+      title: AgentApprovalLabelSchema,
+      description: AgentApprovalDescriptionSchema.optional(),
+      itemId: AgentItemIdSchema
     }).strict().readonly()
   ]),
+  options: z.array(AgentApprovalOptionSchema).min(1).max(AGENT_APPROVAL_OPTIONS_MAX_LENGTH).readonly(),
   expiresAt: AgentIsoDateTimeSchema.optional()
 }).strict().readonly();
+const AgentApprovalRequestSchema = AgentApprovalRequestPortableSchema.superRefine((request, context) => {
+  const optionIds = /* @__PURE__ */ new Set();
+  request.options.forEach((option, optionIndex) => {
+    if (optionIds.has(option.optionId)) {
+      context.addIssue({
+        code: "custom",
+        path: ["options", optionIndex, "optionId"],
+        message: "Approval option IDs must be unique within a request."
+      });
+    }
+    optionIds.add(option.optionId);
+  });
+});
 const AgentRequestChoiceValueSchema = AgentCanonicalIdValueSchema.and(
   z.string().max(160)
 );
@@ -98,12 +132,11 @@ const AgentElicitationRequestSchema = AgentElicitationRequestPortableSchema.supe
   });
 });
 const AgentRequestPortableSchema = z.discriminatedUnion("requestKind", [
-  AgentApprovalRequestSchema,
+  AgentApprovalRequestPortableSchema,
   AgentElicitationRequestPortableSchema
 ]);
 const AgentRequestSchema = AgentRequestPortableSchema.superRefine((request, context) => {
-  if (request.requestKind !== "elicitation") return;
-  const parsed = AgentElicitationRequestSchema.safeParse(request);
+  const parsed = request.requestKind === "approval" ? AgentApprovalRequestSchema.safeParse(request) : AgentElicitationRequestSchema.safeParse(request);
   if (parsed.success) return;
   for (const issue of parsed.error.issues) {
     context.addIssue({
@@ -132,12 +165,21 @@ const AgentElicitationAnswerSchema = z.discriminatedUnion("kind", [
     value: z.boolean()
   }).strict().readonly()
 ]);
-const AgentRequestResolutionPortableSchema = z.union([
+const AgentApprovalResolutionSchema = z.discriminatedUnion("disposition", [
   z.object({
     requestKind: z.literal("approval"),
     requestId: AgentRequestIdSchema,
-    decision: z.enum(["approved", "denied", "canceled"])
+    disposition: z.literal("selected"),
+    optionId: AgentApprovalOptionIdSchema
   }).strict().readonly(),
+  z.object({
+    requestKind: z.literal("approval"),
+    requestId: AgentRequestIdSchema,
+    disposition: z.literal("canceled")
+  }).strict().readonly()
+]);
+const AgentRequestResolutionPortableSchema = z.union([
+  AgentApprovalResolutionSchema,
   z.object({
     requestKind: z.literal("elicitation"),
     requestId: AgentRequestIdSchema,
@@ -165,6 +207,9 @@ const AgentRequestResolutionSchema = AgentRequestResolutionPortableSchema.superR
   });
 });
 export {
+  AgentApprovalRequestPortableSchema,
+  AgentApprovalRequestSchema,
+  AgentApprovalResolutionSchema,
   AgentElicitationRequestPortableSchema,
   AgentElicitationRequestSchema,
   AgentRequestPortableSchema,

package/dist/zod/turns.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod/v4';
-import { type AgentBrowserActionDetails, type AgentCollaborationToolCallDetails, type AgentCommandExecutionDetails, type AgentComputerActionDetails, type AgentDiffSummary, type AgentDynamicToolCallDetails, type AgentFileChange, type AgentFileChangeDetails, type AgentImageViewDetails, type AgentItemSnapshot, type AgentMcpToolCallDetails, type AgentPlanStep, type AgentReviewDetails, type AgentTurnCompletedPayload, type AgentTurnInputContent, type AgentTurnInterruptionInput, type AgentTurnRunInput, type AgentWebSearchDetails } from '../turns/types.js';
+import { type AgentBrowserActionDetails, type AgentCollaborationToolCallDetails, type AgentCommandExecutionDetails, type AgentComputerActionDetails, type AgentContextCompactionDetails, type AgentDiffSummary, type AgentDynamicToolCallDetails, type AgentFileChange, type AgentFileChangeDetails, type AgentImageViewDetails, type AgentItemSnapshot, type AgentMcpToolCallDetails, type AgentPlanStep, type AgentReviewDetails, type AgentTurnCompletedPayload, type AgentTurnInputContent, type AgentTurnInterruptionInput, type AgentTurnRunInput, type AgentWebSearchDetails } from '../turns/types.js';
 export declare const AGENT_PROTOCOL_INLINE_IMAGE_BASE64_MAX_LENGTH = 500000;
 export declare const AgentImageInputSourceSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
     mediaType: z.ZodEnum<{
@@ -193,6 +193,7 @@ export declare const AgentBrowserActionDetailsSchema: z.ZodType<AgentBrowserActi
 export declare const AgentComputerActionDetailsSchema: z.ZodType<AgentComputerActionDetails>;
 export declare const AgentImageViewDetailsSchema: z.ZodType<AgentImageViewDetails>;
 export declare const AgentReviewDetailsSchema: z.ZodType<AgentReviewDetails>;
+export declare const AgentContextCompactionDetailsSchema: z.ZodType<AgentContextCompactionDetails>;
 export declare const AgentItemSnapshotSchema: z.ZodType<AgentItemSnapshot>;
 export declare const AgentContentStreamKindSchema: z.ZodEnum<{
     unknown: "unknown";

package/dist/zod/turns.js

@@ -9,6 +9,9 @@ import {
 import { compareStringsByUnicodeCodePoint } from "../foundation/ordering.js";
 import {
   AGENT_CONTENT_STREAM_KINDS,
+  AGENT_CONTEXT_COMPACTION_DURATION_MAX_MILLISECONDS,
+  AGENT_CONTEXT_COMPACTION_SUMMARY_PREVIEW_MAX_LENGTH,
+  AGENT_CONTEXT_COMPACTION_TRIGGERS,
   AGENT_FILE_CHANGE_KINDS,
   AGENT_IMAGE_INPUT_MEDIA_TYPES,
   AGENT_ITEM_STATUSES,
@@ -262,6 +265,31 @@ const AgentReviewDetailsSchema = z.discriminatedUnion("phase", [
     ...TruncatedShape
   }).strict().readonly()
 ]);
+const AgentContextCompactionDetailsSchema = z.object({
+  trigger: z.enum(AGENT_CONTEXT_COMPACTION_TRIGGERS),
+  beforeTokens: NonNegativeSafeIntegerSchema.optional(),
+  afterTokens: NonNegativeSafeIntegerSchema.optional(),
+  durationMs: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER).max(AGENT_CONTEXT_COMPACTION_DURATION_MAX_MILLISECONDS).optional(),
+  summaryPreview: createAgentCanonicalNonBlankStringSchema(
+    AGENT_CONTEXT_COMPACTION_SUMMARY_PREVIEW_MAX_LENGTH
+  ).optional()
+}).strict().superRefine((details, context) => {
+  if (details.beforeTokens === void 0 !== (details.afterTokens === void 0)) {
+    context.addIssue({
+      code: "custom",
+      path: ["beforeTokens"],
+      message: "Compaction before/after tokens must be present together."
+    });
+    return;
+  }
+  if (details.beforeTokens !== void 0 && details.afterTokens !== void 0 && details.afterTokens > details.beforeTokens) {
+    context.addIssue({
+      code: "custom",
+      path: ["afterTokens"],
+      message: "Compaction cannot increase retained context tokens."
+    });
+  }
+}).readonly();
 const AgentItemSnapshotCommonShape = {
   itemId: AgentItemIdSchema,
   status: z.enum(AGENT_ITEM_STATUSES),
@@ -329,7 +357,11 @@ const AgentItemSnapshotSchema = z.discriminatedUnion("itemKind", [
     itemKind: z.literal("review"),
     details: AgentReviewDetailsSchema
   }).strict().readonly(),
-  itemWithoutDetails("context_compaction"),
+  z.object({
+    ...AgentItemSnapshotCommonShape,
+    itemKind: z.literal("context_compaction"),
+    details: AgentContextCompactionDetailsSchema
+  }).strict().readonly(),
   itemWithoutDetails("unknown")
 ]);
 const AgentContentStreamKindSchema = z.enum(AGENT_CONTENT_STREAM_KINDS);
@@ -377,6 +409,7 @@ export {
   AgentCommandExecutionDetailsSchema,
   AgentComputerActionDetailsSchema,
   AgentContentStreamKindSchema,
+  AgentContextCompactionDetailsSchema,
   AgentDiffSummarySchema,
   AgentDynamicToolCallDetailsSchema,
   AgentFileChangeDetailsSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agen-ai/agent-protocol",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "description": "Provider-neutral sessions, turns, requests, capabilities, artifacts, and events for coding-agent runtimes.",
   "type": "module",
@@ -56,7 +56,7 @@
   },
   "dependencies": {
     "zod": "4.4.3",
-    "@agen-ai/validation": "^0.1.0"
+    "@agen-ai/validation": "^0.2.0"
   },
   "devDependencies": {
     "ajv": "8.17.1",