@agen-ai/agent-protocol 0.2.1 → 0.2.3

package/dist/events/types.d.ts

@@ -1,11 +1,14 @@
 import type { AgentArtifactDescriptor } from '../artifacts/index.js';
+import type { AgentCollaborationNode } from '../collaboration/index.js';
 import type { AgentArtifactId, AgentError, AgentErrorContext, AgentIsoDateTime, AgentItemId, AgentProviderRefs, AgentRequestId, AgentSessionId, AgentTurnId } from '../foundation/index.js';
 import type { AgentRequest } from '../requests/index.js';
+import type { AgentOperationResult } from '../operations/index.js';
+import type { AgentGeneratedResourceDescriptor } from '../resources/index.js';
 import type { AgentContentStreamKind, AgentContextUsage, AgentDiffSummary, AgentItemSnapshot, AgentPlanStep, AgentTurnCompletedPayload, AgentTurnState } from '../turns/index.js';
-export declare const AGENT_EVENT_TYPES: readonly ["turn.started", "turn.state_changed", "turn.completed", "item.started", "item.updated", "item.completed", "content.delta", "turn.plan.updated", "turn.plan.proposed", "turn.diff.updated", "request.opened", "progress.updated", "context.usage.updated", "artifact.referenced", "runtime.warning", "runtime.error", "provider.diagnostic"];
+export declare const AGENT_EVENT_TYPES: readonly ["turn.started", "turn.state_changed", "turn.completed", "item.started", "item.updated", "item.completed", "content.delta", "turn.plan.updated", "turn.plan.proposed", "turn.diff.updated", "request.opened", "progress.updated", "context.usage.updated", "artifact.referenced", "operation.updated", "collaboration.updated", "resource.updated", "runtime.warning", "runtime.error", "provider.diagnostic"];
 export type AgentEventType = (typeof AGENT_EVENT_TYPES)[number];
 interface AgentEventBase<Type extends AgentEventType, Payload> {
-    readonly protocolVersion: 7;
+    readonly protocolVersion: 8;
     readonly type: Type;
     readonly sessionId: AgentSessionId;
     readonly providerRefs?: AgentProviderRefs;
@@ -60,6 +63,15 @@ export type AgentContextUsageUpdatedEvent = AgentTurnEventBase<'context.usage.up
 export type AgentArtifactReferencedEvent = AgentOptionallyTurnScopedEventBase<'artifact.referenced', Readonly<{
     artifact: AgentArtifactDescriptor;
 }>>;
+export type AgentOperationUpdatedEvent = AgentOptionallyTurnScopedEventBase<'operation.updated', Readonly<{
+    result: AgentOperationResult;
+}>>;
+export type AgentCollaborationUpdatedEvent = AgentOptionallyTurnScopedEventBase<'collaboration.updated', Readonly<{
+    node: AgentCollaborationNode;
+}>>;
+export type AgentResourceUpdatedEvent = AgentOptionallyTurnScopedEventBase<'resource.updated', Readonly<{
+    resource: AgentGeneratedResourceDescriptor;
+}>>;
 export type AgentRuntimeWarningEvent = AgentOptionallyTurnScopedEventBase<'runtime.warning', Readonly<{
     code: string;
     message: string;
@@ -74,6 +86,6 @@ export type AgentProviderDiagnosticEvent = AgentOptionallyTurnScopedEventBase<'p
     message: string;
     context?: AgentErrorContext;
 }>>;
-export type AgentEvent = AgentTurnStartedEvent | AgentTurnStateChangedEvent | AgentTurnCompletedEvent | AgentItemStartedEvent | AgentItemUpdatedEvent | AgentItemCompletedEvent | AgentContentDeltaEvent | AgentPlanUpdatedEvent | AgentPlanProposedEvent | AgentDiffUpdatedEvent | AgentRequestOpenedEvent | AgentProgressUpdatedEvent | AgentContextUsageUpdatedEvent | AgentArtifactReferencedEvent | AgentRuntimeWarningEvent | AgentRuntimeErrorEvent | AgentProviderDiagnosticEvent;
+export type AgentEvent = AgentTurnStartedEvent | AgentTurnStateChangedEvent | AgentTurnCompletedEvent | AgentItemStartedEvent | AgentItemUpdatedEvent | AgentItemCompletedEvent | AgentContentDeltaEvent | AgentPlanUpdatedEvent | AgentPlanProposedEvent | AgentDiffUpdatedEvent | AgentRequestOpenedEvent | AgentProgressUpdatedEvent | AgentContextUsageUpdatedEvent | AgentArtifactReferencedEvent | AgentOperationUpdatedEvent | AgentCollaborationUpdatedEvent | AgentResourceUpdatedEvent | AgentRuntimeWarningEvent | AgentRuntimeErrorEvent | AgentProviderDiagnosticEvent;
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/events/types.js

@@ -13,6 +13,9 @@ const AGENT_EVENT_TYPES = [
   "progress.updated",
   "context.usage.updated",
   "artifact.referenced",
+  "operation.updated",
+  "collaboration.updated",
+  "resource.updated",
   "runtime.warning",
   "runtime.error",
   "provider.diagnostic"

package/dist/foundation/parsers.d.ts

@@ -1,4 +1,4 @@
-import type { AgentArtifactId, AgentApprovalOptionId, AgentConfigurationRevisionId, AgentError, AgentInstanceId, AgentIsoDateTime, AgentItemId, AgentJsonValue, AgentProviderConversationId, AgentProviderHistoryAnchor, AgentProviderItemRef, AgentProviderKey, AgentProviderRefs, AgentProviderRequestRef, AgentProviderTurnRef, AgentRequestFieldId, AgentRequestId, AgentSessionId, AgentTurnId } from './types.js';
+import type { AgentArtifactId, AgentApprovalOptionId, AgentCollaborationId, AgentConfigurationRevisionId, AgentError, AgentGeneratedResourceId, AgentInstanceId, AgentIntegrationId, AgentIntegrationResourceId, AgentIntegrationServerId, AgentIntegrationToolId, AgentIsoDateTime, AgentItemId, AgentJsonValue, AgentManagedContentId, AgentOperationId, AgentOperationInvocationId, AgentProviderConversationId, AgentProviderHistoryAnchor, AgentProviderItemRef, AgentProviderKey, AgentProviderRefs, AgentProviderRequestRef, AgentProviderTurnRef, AgentRequestFieldId, AgentRequestId, AgentSessionId, AgentTurnId } from './types.js';
 import type { AgentProtocolParseResult } from './validation.js';
 export declare const parseAgentInstanceId: (input: unknown) => AgentInstanceId;
 export declare const safeParseAgentInstanceId: (input: unknown) => AgentProtocolParseResult<AgentInstanceId>;
@@ -16,6 +16,24 @@ export declare const parseAgentRequestFieldId: (input: unknown) => AgentRequestF
 export declare const safeParseAgentRequestFieldId: (input: unknown) => AgentProtocolParseResult<AgentRequestFieldId>;
 export declare const parseAgentArtifactId: (input: unknown) => AgentArtifactId;
 export declare const safeParseAgentArtifactId: (input: unknown) => AgentProtocolParseResult<AgentArtifactId>;
+export declare const parseAgentOperationId: (input: unknown) => AgentOperationId;
+export declare const safeParseAgentOperationId: (input: unknown) => AgentProtocolParseResult<AgentOperationId>;
+export declare const parseAgentOperationInvocationId: (input: unknown) => AgentOperationInvocationId;
+export declare const safeParseAgentOperationInvocationId: (input: unknown) => AgentProtocolParseResult<AgentOperationInvocationId>;
+export declare const parseAgentManagedContentId: (input: unknown) => AgentManagedContentId;
+export declare const safeParseAgentManagedContentId: (input: unknown) => AgentProtocolParseResult<AgentManagedContentId>;
+export declare const parseAgentIntegrationId: (input: unknown) => AgentIntegrationId;
+export declare const safeParseAgentIntegrationId: (input: unknown) => AgentProtocolParseResult<AgentIntegrationId>;
+export declare const parseAgentIntegrationServerId: (input: unknown) => AgentIntegrationServerId;
+export declare const safeParseAgentIntegrationServerId: (input: unknown) => AgentProtocolParseResult<AgentIntegrationServerId>;
+export declare const parseAgentIntegrationToolId: (input: unknown) => AgentIntegrationToolId;
+export declare const safeParseAgentIntegrationToolId: (input: unknown) => AgentProtocolParseResult<AgentIntegrationToolId>;
+export declare const parseAgentIntegrationResourceId: (input: unknown) => AgentIntegrationResourceId;
+export declare const safeParseAgentIntegrationResourceId: (input: unknown) => AgentProtocolParseResult<AgentIntegrationResourceId>;
+export declare const parseAgentCollaborationId: (input: unknown) => AgentCollaborationId;
+export declare const safeParseAgentCollaborationId: (input: unknown) => AgentProtocolParseResult<AgentCollaborationId>;
+export declare const parseAgentGeneratedResourceId: (input: unknown) => AgentGeneratedResourceId;
+export declare const safeParseAgentGeneratedResourceId: (input: unknown) => AgentProtocolParseResult<AgentGeneratedResourceId>;
 export declare const parseAgentConfigurationRevisionId: (input: unknown) => AgentConfigurationRevisionId;
 export declare const safeParseAgentConfigurationRevisionId: (input: unknown) => AgentProtocolParseResult<AgentConfigurationRevisionId>;
 export declare const parseAgentProviderConversationId: (input: unknown) => AgentProviderConversationId;

package/dist/foundation/parsers.js

@@ -2,12 +2,21 @@ import { parseWithSchema, safeParseWithSchema } from "../internal/parsers.js";
 import {
   AgentArtifactIdSchema,
   AgentApprovalOptionIdSchema,
+  AgentCollaborationIdSchema,
   AgentConfigurationRevisionIdSchema,
+  AgentGeneratedResourceIdSchema,
   AgentErrorSchema,
   AgentInstanceIdSchema,
+  AgentIntegrationIdSchema,
+  AgentIntegrationResourceIdSchema,
+  AgentIntegrationServerIdSchema,
+  AgentIntegrationToolIdSchema,
   AgentIsoDateTimeSchema,
   AgentItemIdSchema,
   AgentJsonValueSchema,
+  AgentManagedContentIdSchema,
+  AgentOperationIdSchema,
+  AgentOperationInvocationIdSchema,
   AgentProviderConversationIdSchema,
   AgentProviderHistoryAnchorSchema,
   AgentProviderItemRefSchema,
@@ -38,6 +47,31 @@ const requestFieldIdParser = idParser(
   AgentRequestFieldIdSchema
 );
 const artifactIdParser = idParser(AgentArtifactIdSchema);
+const operationIdParser = idParser(AgentOperationIdSchema);
+const operationInvocationIdParser = idParser(
+  AgentOperationInvocationIdSchema
+);
+const managedContentIdParser = idParser(
+  AgentManagedContentIdSchema
+);
+const integrationIdParser = idParser(
+  AgentIntegrationIdSchema
+);
+const integrationServerIdParser = idParser(
+  AgentIntegrationServerIdSchema
+);
+const integrationToolIdParser = idParser(
+  AgentIntegrationToolIdSchema
+);
+const integrationResourceIdParser = idParser(
+  AgentIntegrationResourceIdSchema
+);
+const collaborationIdParser = idParser(
+  AgentCollaborationIdSchema
+);
+const generatedResourceIdParser = idParser(
+  AgentGeneratedResourceIdSchema
+);
 const revisionIdParser = idParser(
   AgentConfigurationRevisionIdSchema
 );
@@ -72,6 +106,24 @@ const parseAgentRequestFieldId = requestFieldIdParser.parse;
 const safeParseAgentRequestFieldId = requestFieldIdParser.safeParse;
 const parseAgentArtifactId = artifactIdParser.parse;
 const safeParseAgentArtifactId = artifactIdParser.safeParse;
+const parseAgentOperationId = operationIdParser.parse;
+const safeParseAgentOperationId = operationIdParser.safeParse;
+const parseAgentOperationInvocationId = operationInvocationIdParser.parse;
+const safeParseAgentOperationInvocationId = operationInvocationIdParser.safeParse;
+const parseAgentManagedContentId = managedContentIdParser.parse;
+const safeParseAgentManagedContentId = managedContentIdParser.safeParse;
+const parseAgentIntegrationId = integrationIdParser.parse;
+const safeParseAgentIntegrationId = integrationIdParser.safeParse;
+const parseAgentIntegrationServerId = integrationServerIdParser.parse;
+const safeParseAgentIntegrationServerId = integrationServerIdParser.safeParse;
+const parseAgentIntegrationToolId = integrationToolIdParser.parse;
+const safeParseAgentIntegrationToolId = integrationToolIdParser.safeParse;
+const parseAgentIntegrationResourceId = integrationResourceIdParser.parse;
+const safeParseAgentIntegrationResourceId = integrationResourceIdParser.safeParse;
+const parseAgentCollaborationId = collaborationIdParser.parse;
+const safeParseAgentCollaborationId = collaborationIdParser.safeParse;
+const parseAgentGeneratedResourceId = generatedResourceIdParser.parse;
+const safeParseAgentGeneratedResourceId = generatedResourceIdParser.safeParse;
 const parseAgentConfigurationRevisionId = revisionIdParser.parse;
 const safeParseAgentConfigurationRevisionId = revisionIdParser.safeParse;
 const parseAgentProviderConversationId = conversationIdParser.parse;
@@ -117,12 +169,21 @@ function safeParseAgentError(input) {
 export {
   parseAgentApprovalOptionId,
   parseAgentArtifactId,
+  parseAgentCollaborationId,
   parseAgentConfigurationRevisionId,
   parseAgentError,
+  parseAgentGeneratedResourceId,
   parseAgentInstanceId,
+  parseAgentIntegrationId,
+  parseAgentIntegrationResourceId,
+  parseAgentIntegrationServerId,
+  parseAgentIntegrationToolId,
   parseAgentIsoDateTime,
   parseAgentItemId,
   parseAgentJsonValue,
+  parseAgentManagedContentId,
+  parseAgentOperationId,
+  parseAgentOperationInvocationId,
   parseAgentProviderConversationId,
   parseAgentProviderHistoryAnchor,
   parseAgentProviderItemRef,
@@ -136,12 +197,21 @@ export {
   parseAgentTurnId,
   safeParseAgentApprovalOptionId,
   safeParseAgentArtifactId,
+  safeParseAgentCollaborationId,
   safeParseAgentConfigurationRevisionId,
   safeParseAgentError,
+  safeParseAgentGeneratedResourceId,
   safeParseAgentInstanceId,
+  safeParseAgentIntegrationId,
+  safeParseAgentIntegrationResourceId,
+  safeParseAgentIntegrationServerId,
+  safeParseAgentIntegrationToolId,
   safeParseAgentIsoDateTime,
   safeParseAgentItemId,
   safeParseAgentJsonValue,
+  safeParseAgentManagedContentId,
+  safeParseAgentOperationId,
+  safeParseAgentOperationInvocationId,
   safeParseAgentProviderConversationId,
   safeParseAgentProviderHistoryAnchor,
   safeParseAgentProviderItemRef,

package/dist/foundation/types.d.ts

@@ -1,6 +1,6 @@
 export type { AgentProtocolParseFailure, AgentProtocolParseResult, AgentProtocolParseSuccess, ValidationIssue, ValidationPathSegment, } from './validation.js';
 export { AgentProtocolValidationError } from './validation.js';
-export declare const AGENT_PROTOCOL_VERSION: 7;
+export declare const AGENT_PROTOCOL_VERSION: 8;
 export declare const AGENT_PROTOCOL_ID_MAX_LENGTH = 256;
 export declare const AGENT_PROTOCOL_PROVIDER_REFERENCE_MAX_LENGTH = 512;
 export declare const AGENT_PROTOCOL_PROVIDER_KEY_MAX_LENGTH = 100;
@@ -25,6 +25,15 @@ export type AgentRequestId = AgentProtocolId<'AgentRequestId'>;
 export type AgentApprovalOptionId = AgentProtocolId<'AgentApprovalOptionId'>;
 export type AgentRequestFieldId = AgentProtocolId<'AgentRequestFieldId'>;
 export type AgentArtifactId = AgentProtocolId<'AgentArtifactId'>;
+export type AgentOperationId = AgentProtocolId<'AgentOperationId'>;
+export type AgentOperationInvocationId = AgentProtocolId<'AgentOperationInvocationId'>;
+export type AgentManagedContentId = AgentProtocolId<'AgentManagedContentId'>;
+export type AgentIntegrationId = AgentProtocolId<'AgentIntegrationId'>;
+export type AgentIntegrationServerId = AgentProtocolId<'AgentIntegrationServerId'>;
+export type AgentIntegrationToolId = AgentProtocolId<'AgentIntegrationToolId'>;
+export type AgentIntegrationResourceId = AgentProtocolId<'AgentIntegrationResourceId'>;
+export type AgentCollaborationId = AgentProtocolId<'AgentCollaborationId'>;
+export type AgentGeneratedResourceId = AgentProtocolId<'AgentGeneratedResourceId'>;
 export type AgentConfigurationRevisionId = AgentProtocolId<'AgentConfigurationRevisionId'>;
 export type AgentProviderConversationId = AgentProtocolId<'AgentProviderConversationId'>;
 export type AgentProviderHistoryAnchor = AgentProtocolId<'AgentProviderHistoryAnchor'>;

package/dist/foundation/types.js

@@ -1,5 +1,5 @@
 import { AgentProtocolValidationError } from "./validation.js";
-const AGENT_PROTOCOL_VERSION = 7;
+const AGENT_PROTOCOL_VERSION = 8;
 const AGENT_PROTOCOL_ID_MAX_LENGTH = 256;
 const AGENT_PROTOCOL_PROVIDER_REFERENCE_MAX_LENGTH = 512;
 const AGENT_PROTOCOL_PROVIDER_KEY_MAX_LENGTH = 100;

package/dist/integrations/index.d.ts

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

package/dist/integrations/index.js

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

package/dist/integrations/parsers.d.ts

@@ -0,0 +1,7 @@
+import type { AgentProtocolParseResult } from '../foundation/index.js';
+import type { AgentIntegrationCatalog, AgentIntegrationDescriptor } from './types.js';
+export declare function parseAgentIntegrationDescriptor(input: unknown): AgentIntegrationDescriptor;
+export declare function safeParseAgentIntegrationDescriptor(input: unknown): AgentProtocolParseResult<AgentIntegrationDescriptor>;
+export declare function parseAgentIntegrationCatalog(input: unknown): AgentIntegrationCatalog;
+export declare function safeParseAgentIntegrationCatalog(input: unknown): AgentProtocolParseResult<AgentIntegrationCatalog>;
+//# sourceMappingURL=parsers.d.ts.map

package/dist/integrations/parsers.js

@@ -0,0 +1,23 @@
+import { parseWithSchema, safeParseWithSchema } from "../internal/parsers.js";
+import {
+  AgentIntegrationCatalogSchema,
+  AgentIntegrationDescriptorSchema
+} from "../zod/integrations.js";
+function parseAgentIntegrationDescriptor(input) {
+  return parseWithSchema(AgentIntegrationDescriptorSchema, input);
+}
+function safeParseAgentIntegrationDescriptor(input) {
+  return safeParseWithSchema(AgentIntegrationDescriptorSchema, input);
+}
+function parseAgentIntegrationCatalog(input) {
+  return parseWithSchema(AgentIntegrationCatalogSchema, input);
+}
+function safeParseAgentIntegrationCatalog(input) {
+  return safeParseWithSchema(AgentIntegrationCatalogSchema, input);
+}
+export {
+  parseAgentIntegrationCatalog,
+  parseAgentIntegrationDescriptor,
+  safeParseAgentIntegrationCatalog,
+  safeParseAgentIntegrationDescriptor
+};

package/dist/integrations/types.d.ts

@@ -0,0 +1,43 @@
+import type { AgentIntegrationId, AgentIntegrationResourceId, AgentIntegrationServerId, AgentIntegrationToolId, AgentIsoDateTime } from '../foundation/index.js';
+export declare const AGENT_INTEGRATION_STATUSES: readonly ["starting", "ready", "degraded", "unavailable"];
+export declare const AGENT_INTEGRATION_KINDS: readonly ["mcp"];
+export declare const AGENT_INTEGRATION_NAME_MAX_LENGTH = 200;
+export declare const AGENT_INTEGRATION_DESCRIPTION_MAX_LENGTH = 2000;
+export declare const AGENT_INTEGRATION_CATALOG_MAX_LENGTH = 32;
+export declare const AGENT_INTEGRATION_SERVERS_MAX_LENGTH = 32;
+export declare const AGENT_INTEGRATION_TOOLS_MAX_LENGTH = 100;
+export declare const AGENT_INTEGRATION_RESOURCES_MAX_LENGTH = 100;
+export type AgentIntegrationStatus = (typeof AGENT_INTEGRATION_STATUSES)[number];
+export type AgentIntegrationKind = (typeof AGENT_INTEGRATION_KINDS)[number];
+export interface AgentIntegrationToolDescriptor {
+    readonly toolId: AgentIntegrationToolId;
+    readonly name: string;
+    readonly description?: string;
+}
+export interface AgentIntegrationResourceDescriptor {
+    readonly resourceId: AgentIntegrationResourceId;
+    readonly name: string;
+    readonly description?: string;
+    readonly mediaType?: string;
+}
+export interface AgentIntegrationServerDescriptor {
+    readonly serverId: AgentIntegrationServerId;
+    readonly name: string;
+    readonly status: AgentIntegrationStatus;
+    readonly tools: readonly AgentIntegrationToolDescriptor[];
+    readonly resources: readonly AgentIntegrationResourceDescriptor[];
+}
+export interface AgentIntegrationDescriptor {
+    readonly integrationId: AgentIntegrationId;
+    readonly revision: number;
+    readonly kind: AgentIntegrationKind;
+    readonly name: string;
+    readonly status: AgentIntegrationStatus;
+    readonly servers: readonly AgentIntegrationServerDescriptor[];
+}
+export interface AgentIntegrationCatalog {
+    readonly revision: number;
+    readonly observedAt: AgentIsoDateTime;
+    readonly integrations: readonly AgentIntegrationDescriptor[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/integrations/types.js

@@ -0,0 +1,23 @@
+const AGENT_INTEGRATION_STATUSES = [
+  "starting",
+  "ready",
+  "degraded",
+  "unavailable"
+];
+const AGENT_INTEGRATION_KINDS = ["mcp"];
+const AGENT_INTEGRATION_NAME_MAX_LENGTH = 200;
+const AGENT_INTEGRATION_DESCRIPTION_MAX_LENGTH = 2e3;
+const AGENT_INTEGRATION_CATALOG_MAX_LENGTH = 32;
+const AGENT_INTEGRATION_SERVERS_MAX_LENGTH = 32;
+const AGENT_INTEGRATION_TOOLS_MAX_LENGTH = 100;
+const AGENT_INTEGRATION_RESOURCES_MAX_LENGTH = 100;
+export {
+  AGENT_INTEGRATION_CATALOG_MAX_LENGTH,
+  AGENT_INTEGRATION_DESCRIPTION_MAX_LENGTH,
+  AGENT_INTEGRATION_KINDS,
+  AGENT_INTEGRATION_NAME_MAX_LENGTH,
+  AGENT_INTEGRATION_RESOURCES_MAX_LENGTH,
+  AGENT_INTEGRATION_SERVERS_MAX_LENGTH,
+  AGENT_INTEGRATION_STATUSES,
+  AGENT_INTEGRATION_TOOLS_MAX_LENGTH
+};