@agen-ai/agent-protocol 0.2.1 → 0.2.3

package/dist/requests/types.d.ts

@@ -4,8 +4,13 @@ export declare const AGENT_APPROVAL_SCOPE_KINDS: readonly ["exact_action", "comm
 export declare const AGENT_APPROVAL_OPTIONS_MAX_LENGTH = 16;
 export declare const AGENT_APPROVAL_LABEL_MAX_LENGTH = 120;
 export declare const AGENT_APPROVAL_DESCRIPTION_MAX_LENGTH = 1000;
+export declare const AGENT_ELICITATION_FIELD_KINDS: readonly ["text", "single_select", "multi_select", "boolean", "confirmation"];
+export declare const AGENT_ELICITATION_FIELDS_MAX_LENGTH = 16;
+export declare const AGENT_ELICITATION_OPTIONS_MAX_LENGTH = 100;
+export declare const AGENT_ELICITATION_TEXT_VALUE_MAX_LENGTH = 4000;
 export type AgentApprovalPersistence = (typeof AGENT_APPROVAL_PERSISTENCES)[number];
 export type AgentApprovalScopeKind = (typeof AGENT_APPROVAL_SCOPE_KINDS)[number];
+export type AgentElicitationFieldKind = (typeof AGENT_ELICITATION_FIELD_KINDS)[number];
 interface AgentApprovalSubjectBase {
     readonly title: string;
     readonly description?: string;
@@ -45,21 +50,32 @@ interface AgentElicitationFieldBase {
     readonly label: string;
     readonly description?: string;
     readonly required: boolean;
+    readonly sensitivity: 'ordinary' | 'sensitive';
 }
 export interface AgentTextElicitationField extends AgentElicitationFieldBase {
     readonly kind: 'text';
-    readonly multiline?: boolean;
+    readonly multiline: boolean;
+    readonly maxLength: number;
 }
-export interface AgentChoiceElicitationField extends AgentElicitationFieldBase {
-    readonly kind: 'choice';
+export interface AgentSingleSelectElicitationField extends AgentElicitationFieldBase {
+    readonly kind: 'single_select';
     readonly options: readonly AgentRequestChoice[];
-    readonly multiple: boolean;
     readonly allowOther: boolean;
 }
+export interface AgentMultiSelectElicitationField extends AgentElicitationFieldBase {
+    readonly kind: 'multi_select';
+    readonly options: readonly AgentRequestChoice[];
+    readonly allowOther: boolean;
+    readonly maxSelections: number;
+}
 export interface AgentBooleanElicitationField extends AgentElicitationFieldBase {
     readonly kind: 'boolean';
 }
-export type AgentElicitationField = AgentTextElicitationField | AgentChoiceElicitationField | AgentBooleanElicitationField;
+export interface AgentConfirmationElicitationField extends AgentElicitationFieldBase {
+    readonly kind: 'confirmation';
+    readonly confirmLabel: string;
+}
+export type AgentElicitationField = AgentTextElicitationField | AgentSingleSelectElicitationField | AgentMultiSelectElicitationField | AgentBooleanElicitationField | AgentConfirmationElicitationField;
 export interface AgentElicitationRequest {
     readonly requestKind: 'elicitation';
     readonly requestId: AgentRequestId;
@@ -83,9 +99,15 @@ export interface AgentTextElicitationAnswer {
     readonly kind: 'text';
     readonly value: string;
 }
-export interface AgentChoiceElicitationAnswer {
+export interface AgentSingleSelectElicitationAnswer {
     readonly fieldId: AgentRequestFieldId;
-    readonly kind: 'choice';
+    readonly kind: 'single_select';
+    readonly value?: string;
+    readonly other?: string;
+}
+export interface AgentMultiSelectElicitationAnswer {
+    readonly fieldId: AgentRequestFieldId;
+    readonly kind: 'multi_select';
     readonly values: readonly string[];
     readonly other?: string;
 }
@@ -94,7 +116,12 @@ export interface AgentBooleanElicitationAnswer {
     readonly kind: 'boolean';
     readonly value: boolean;
 }
-export type AgentElicitationAnswer = AgentTextElicitationAnswer | AgentChoiceElicitationAnswer | AgentBooleanElicitationAnswer;
+export interface AgentConfirmationElicitationAnswer {
+    readonly fieldId: AgentRequestFieldId;
+    readonly kind: 'confirmation';
+    readonly confirmed: boolean;
+}
+export type AgentElicitationAnswer = AgentTextElicitationAnswer | AgentSingleSelectElicitationAnswer | AgentMultiSelectElicitationAnswer | AgentBooleanElicitationAnswer | AgentConfirmationElicitationAnswer;
 export interface AgentAnsweredElicitationResolution {
     readonly requestKind: 'elicitation';
     readonly requestId: AgentRequestId;

package/dist/requests/types.js

@@ -14,10 +14,24 @@ const AGENT_APPROVAL_SCOPE_KINDS = [
 const AGENT_APPROVAL_OPTIONS_MAX_LENGTH = 16;
 const AGENT_APPROVAL_LABEL_MAX_LENGTH = 120;
 const AGENT_APPROVAL_DESCRIPTION_MAX_LENGTH = 1e3;
+const AGENT_ELICITATION_FIELD_KINDS = [
+  "text",
+  "single_select",
+  "multi_select",
+  "boolean",
+  "confirmation"
+];
+const AGENT_ELICITATION_FIELDS_MAX_LENGTH = 16;
+const AGENT_ELICITATION_OPTIONS_MAX_LENGTH = 100;
+const AGENT_ELICITATION_TEXT_VALUE_MAX_LENGTH = 4e3;
 export {
   AGENT_APPROVAL_DESCRIPTION_MAX_LENGTH,
   AGENT_APPROVAL_LABEL_MAX_LENGTH,
   AGENT_APPROVAL_OPTIONS_MAX_LENGTH,
   AGENT_APPROVAL_PERSISTENCES,
-  AGENT_APPROVAL_SCOPE_KINDS
+  AGENT_APPROVAL_SCOPE_KINDS,
+  AGENT_ELICITATION_FIELDS_MAX_LENGTH,
+  AGENT_ELICITATION_FIELD_KINDS,
+  AGENT_ELICITATION_OPTIONS_MAX_LENGTH,
+  AGENT_ELICITATION_TEXT_VALUE_MAX_LENGTH
 };

package/dist/resources/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './parsers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.js

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export * from "./parsers.js";

package/dist/resources/parsers.d.ts

@@ -0,0 +1,5 @@
+import type { AgentProtocolParseResult } from '../foundation/index.js';
+import type { AgentGeneratedResourceDescriptor } from './types.js';
+export declare function parseAgentGeneratedResourceDescriptor(input: unknown): AgentGeneratedResourceDescriptor;
+export declare function safeParseAgentGeneratedResourceDescriptor(input: unknown): AgentProtocolParseResult<AgentGeneratedResourceDescriptor>;
+//# sourceMappingURL=parsers.d.ts.map

package/dist/resources/parsers.js

@@ -0,0 +1,12 @@
+import { parseWithSchema, safeParseWithSchema } from "../internal/parsers.js";
+import { AgentGeneratedResourceDescriptorSchema } from "../zod/resources.js";
+function parseAgentGeneratedResourceDescriptor(input) {
+  return parseWithSchema(AgentGeneratedResourceDescriptorSchema, input);
+}
+function safeParseAgentGeneratedResourceDescriptor(input) {
+  return safeParseWithSchema(AgentGeneratedResourceDescriptorSchema, input);
+}
+export {
+  parseAgentGeneratedResourceDescriptor,
+  safeParseAgentGeneratedResourceDescriptor
+};

package/dist/resources/types.d.ts

@@ -0,0 +1,39 @@
+import type { AgentArtifactId, AgentCollaborationId, AgentError, AgentGeneratedResourceId, AgentIsoDateTime, AgentOperationInvocationId, AgentSessionId, AgentTurnId } from '../foundation/index.js';
+export declare const AGENT_GENERATED_RESOURCE_KINDS: readonly ["image", "document", "archive"];
+export declare const AGENT_GENERATED_RESOURCE_STATUSES: readonly ["pending", "available", "unavailable", "expired"];
+export declare const AGENT_GENERATED_RESOURCE_DISPLAY_NAME_MAX_LENGTH = 200;
+export declare const AGENT_GENERATED_RESOURCE_SUMMARY_MAX_LENGTH = 2000;
+export type AgentGeneratedResourceKind = (typeof AGENT_GENERATED_RESOURCE_KINDS)[number];
+export type AgentGeneratedResourceStatus = (typeof AGENT_GENERATED_RESOURCE_STATUSES)[number];
+export type AgentGeneratedResourceProducer = Readonly<{
+    kind: 'session';
+    sessionId: AgentSessionId;
+}> | Readonly<{
+    kind: 'turn';
+    turnId: AgentTurnId;
+}> | Readonly<{
+    kind: 'operation';
+    invocationId: AgentOperationInvocationId;
+}> | Readonly<{
+    kind: 'collaboration';
+    collaborationId: AgentCollaborationId;
+}>;
+export interface AgentGeneratedResourceDescriptor {
+    readonly resourceId: AgentGeneratedResourceId;
+    readonly kind: AgentGeneratedResourceKind;
+    readonly status: AgentGeneratedResourceStatus;
+    readonly displayName: string;
+    readonly producer: AgentGeneratedResourceProducer;
+    readonly summary?: string;
+    readonly mediaType?: string;
+    readonly byteSize?: number;
+    readonly sha256?: string;
+    readonly widthPixels?: number;
+    readonly heightPixels?: number;
+    readonly pageCount?: number;
+    readonly artifactId?: AgentArtifactId;
+    readonly createdAt: AgentIsoDateTime;
+    readonly expiresAt?: AgentIsoDateTime;
+    readonly error?: AgentError;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/resources/types.js

@@ -0,0 +1,19 @@
+const AGENT_GENERATED_RESOURCE_KINDS = [
+  "image",
+  "document",
+  "archive"
+];
+const AGENT_GENERATED_RESOURCE_STATUSES = [
+  "pending",
+  "available",
+  "unavailable",
+  "expired"
+];
+const AGENT_GENERATED_RESOURCE_DISPLAY_NAME_MAX_LENGTH = 200;
+const AGENT_GENERATED_RESOURCE_SUMMARY_MAX_LENGTH = 2e3;
+export {
+  AGENT_GENERATED_RESOURCE_DISPLAY_NAME_MAX_LENGTH,
+  AGENT_GENERATED_RESOURCE_KINDS,
+  AGENT_GENERATED_RESOURCE_STATUSES,
+  AGENT_GENERATED_RESOURCE_SUMMARY_MAX_LENGTH
+};

package/dist/sessions/types.d.ts

@@ -1,12 +1,23 @@
-import type { AgentConfigurationRevisionId, AgentJsonValue, AgentProviderConversationId, AgentProviderHistoryAnchor, AgentSessionId, AgentTurnId } from '../foundation/index.js';
+import type { AgentConfigurationRevisionId, AgentProviderConversationId, AgentProviderHistoryAnchor, AgentSessionId, AgentTurnId } from '../foundation/index.js';
+import type { AgentConfigurationValue } from '../configuration/index.js';
 export interface AgentSessionBinding {
     readonly conversationId: AgentProviderConversationId;
     readonly historyAnchor?: AgentProviderHistoryAnchor;
 }
-export interface AgentSessionConfiguration {
-    readonly revision: AgentConfigurationRevisionId;
-    readonly values: Readonly<Record<string, AgentJsonValue>>;
+export interface AgentSessionConfigurationSelection {
+    readonly key: string;
+    readonly fieldRevision: number;
+    readonly value: AgentConfigurationValue;
 }
+export type AgentSessionConfiguration = Readonly<{
+    kind: 'managed';
+    revision: AgentConfigurationRevisionId;
+}> | Readonly<{
+    kind: 'selected';
+    revision: AgentConfigurationRevisionId;
+    catalogRevision: number;
+    selections: readonly AgentSessionConfigurationSelection[];
+}>;
 export interface AgentSessionCreateInput {
     readonly operation: 'create';
     readonly sessionId: AgentSessionId;

package/dist/zod/capabilities.d.ts

@@ -68,7 +68,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<7>;
+    protocolVersion: z.ZodLiteral<8>;
     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>;
@@ -140,9 +140,16 @@ export declare const AgentCapabilitiesPortableSchema: z.ZodReadonly<z.ZodObject<
         elicitation: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
             kind: z.ZodLiteral<"unsupported">;
         }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
-            kind: z.ZodLiteral<"text">;
-        }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
-            kind: z.ZodLiteral<"structured">;
+            kind: z.ZodLiteral<"supported">;
+            fieldKinds: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                boolean: "boolean";
+                single_select: "single_select";
+                text: "text";
+                multi_select: "multi_select";
+                confirmation: "confirmation";
+            }>>>;
+            maxFields: z.ZodNumber;
+            sensitiveFields: z.ZodBoolean;
         }, z.core.$strict>>], "kind">;
     }, z.core.$strict>>;
     context: z.ZodReadonly<z.ZodObject<{
@@ -207,9 +214,9 @@ export declare const AgentCapabilitiesPortableSchema: z.ZodReadonly<z.ZodObject<
         streaming: z.ZodBoolean;
         plans: z.ZodBoolean;
         fileChanges: z.ZodEnum<{
-            structured: "structured";
             none: "none";
             final_diff: "final_diff";
+            structured: "structured";
         }>;
         artifactKinds: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
             file: "file";
@@ -225,17 +232,98 @@ export declare const AgentCapabilitiesPortableSchema: z.ZodReadonly<z.ZodObject<
         kind: z.ZodLiteral<"managed">;
     }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
         kind: z.ZodLiteral<"selectable">;
-        fields: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
-            key: z.ZodString;
-            optionIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
-        }, z.core.$strict>>>>;
+        fieldKinds: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            boolean: "boolean";
+            single_select: "single_select";
+            bounded_integer: "bounded_integer";
+            bounded_text: "bounded_text";
+        }>>>;
+        maxFields: z.ZodNumber;
+    }, z.core.$strict>>], "kind">;
+    operations: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"unsupported">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"supported">;
+        operationKinds: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            session_control: "session_control";
+            managed_content_invoke: "managed_content_invoke";
+            configuration_select: "configuration_select";
+            integration_control: "integration_control";
+            collaboration_control: "collaboration_control";
+            resource_generate: "resource_generate";
+        }>>>;
+        fieldKinds: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            boolean: "boolean";
+            single_select: "single_select";
+            text: "text";
+            multi_select: "multi_select";
+            integer: "integer";
+        }>>>;
+        executionModes: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            immediate: "immediate";
+            request_continuation: "request_continuation";
+            durable_job: "durable_job";
+        }>>>;
+        maxOperations: z.ZodNumber;
+        maxFieldsPerOperation: z.ZodNumber;
+    }, z.core.$strict>>], "kind">;
+    managedContent: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"unsupported">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"supported">;
+        contentKinds: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            prompt: "prompt";
+            skill: "skill";
+            rule: "rule";
+            agent_definition: "agent_definition";
+        }>>>;
+        maxEntries: z.ZodNumber;
+    }, z.core.$strict>>], "kind">;
+    integrations: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"unsupported">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"supported">;
+        integrationKinds: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            mcp: "mcp";
+        }>>>;
+        maxIntegrations: z.ZodNumber;
+        maxServersPerIntegration: z.ZodNumber;
+        maxToolsPerServer: z.ZodNumber;
+        maxResourcesPerServer: z.ZodNumber;
+    }, z.core.$strict>>], "kind">;
+    collaboration: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"unsupported">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"supported">;
+        roles: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            delegate: "delegate";
+            reviewer: "reviewer";
+            researcher: "researcher";
+            specialist: "specialist";
+        }>>>;
+        controlActions: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            spawn: "spawn";
+            steer: "steer";
+            stop: "stop";
+            close: "close";
+            inspect: "inspect";
+        }>>>;
+        maxDepth: z.ZodNumber;
+        maxChildrenPerNode: z.ZodNumber;
+        maxActiveNodes: z.ZodNumber;
+    }, z.core.$strict>>], "kind">;
+    generatedResources: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"unsupported">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"supported">;
+        resourceKinds: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            image: "image";
+            document: "document";
+            archive: "archive";
+        }>>>;
+        maxResourcesPerTurn: z.ZodNumber;
+        maxBytesPerResource: z.ZodNumber;
     }, z.core.$strict>>], "kind">;
-    interactionExtensions: z.ZodReadonly<z.ZodObject<{
-        slashCommands: z.ZodBoolean;
-        mcp: z.ZodBoolean;
-        subagents: z.ZodBoolean;
-        imageGeneration: z.ZodBoolean;
-    }, z.core.$strict>>;
     authentication: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
         kind: z.ZodLiteral<"unsupported">;
     }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{