agentic-qe 3.3.4 → 3.4.0

package/v3/dist/adapters/a2a/agent-cards/schema.d.ts

@@ -0,0 +1,274 @@
+/**
+ * A2A Protocol Agent Card Schema
+ *
+ * Defines TypeScript interfaces for A2A v0.3 Agent Capability Cards.
+ * Reference: https://a2a-protocol.org/latest/specification/
+ *
+ * @module adapters/a2a/agent-cards/schema
+ */
+/**
+ * Information about the organization providing the agent
+ */
+export interface AgentProvider {
+    /** Organization name */
+    readonly organization: string;
+    /** Organization website URL */
+    readonly url?: string;
+}
+/**
+ * Security scheme types supported by A2A
+ */
+export type SecuritySchemeType = 'apiKey' | 'http' | 'oauth2' | 'openIdConnect' | 'mutualTLS';
+/**
+ * API Key security scheme
+ */
+export interface ApiKeySecurityScheme {
+    readonly type: 'apiKey';
+    /** Name of the header, query parameter, or cookie */
+    readonly name: string;
+    /** Location of the API key */
+    readonly in: 'header' | 'query' | 'cookie';
+    /** Description of the security scheme */
+    readonly description?: string;
+}
+/**
+ * HTTP security scheme (Bearer, Basic, etc.)
+ */
+export interface HttpSecurityScheme {
+    readonly type: 'http';
+    /** HTTP authentication scheme (e.g., 'bearer', 'basic') */
+    readonly scheme: string;
+    /** Format of the bearer token */
+    readonly bearerFormat?: string;
+    /** Description of the security scheme */
+    readonly description?: string;
+}
+/**
+ * OAuth 2.0 flow configuration
+ */
+export interface OAuthFlow {
+    /** Authorization URL for authorization code flow */
+    readonly authorizationUrl?: string;
+    /** Token URL for obtaining access tokens */
+    readonly tokenUrl?: string;
+    /** Refresh URL for token refresh */
+    readonly refreshUrl?: string;
+    /** Available scopes and their descriptions */
+    readonly scopes?: Record<string, string>;
+}
+/**
+ * OAuth 2.0 security scheme
+ */
+export interface OAuth2SecurityScheme {
+    readonly type: 'oauth2';
+    /** OAuth 2.0 flows configuration */
+    readonly flows: {
+        readonly implicit?: OAuthFlow;
+        readonly password?: OAuthFlow;
+        readonly clientCredentials?: OAuthFlow;
+        readonly authorizationCode?: OAuthFlow;
+    };
+    /** Description of the security scheme */
+    readonly description?: string;
+}
+/**
+ * OpenID Connect security scheme
+ */
+export interface OpenIdConnectSecurityScheme {
+    readonly type: 'openIdConnect';
+    /** OpenID Connect discovery URL */
+    readonly openIdConnectUrl: string;
+    /** Description of the security scheme */
+    readonly description?: string;
+}
+/**
+ * Mutual TLS security scheme
+ */
+export interface MutualTLSSecurityScheme {
+    readonly type: 'mutualTLS';
+    /** Description of the security scheme */
+    readonly description?: string;
+}
+/**
+ * Union of all security scheme types
+ */
+export type SecurityScheme = ApiKeySecurityScheme | HttpSecurityScheme | OAuth2SecurityScheme | OpenIdConnectSecurityScheme | MutualTLSSecurityScheme;
+/**
+ * Authentication configuration for the agent
+ */
+export interface AgentAuthentication {
+    /** Supported authentication schemes */
+    readonly schemes: string[];
+    /** Description of credential requirements */
+    readonly credentials?: string;
+}
+/**
+ * Capabilities supported by the agent
+ */
+export interface AgentCapabilities {
+    /** Whether the agent supports Server-Sent Events streaming */
+    readonly streaming?: boolean;
+    /** Whether the agent supports webhook push notifications */
+    readonly pushNotifications?: boolean;
+    /** Whether the agent exposes task state transition history */
+    readonly stateTransitionHistory?: boolean;
+}
+/**
+ * A skill represents a discrete capability or function an agent can perform
+ */
+export interface AgentSkill {
+    /** Unique skill identifier (kebab-case recommended) */
+    readonly id: string;
+    /** Human-readable skill name */
+    readonly name: string;
+    /** Detailed description of what the skill does */
+    readonly description: string;
+    /** Categorization tags for discovery and filtering */
+    readonly tags?: string[];
+    /** Example prompts or use cases */
+    readonly examples?: string[];
+    /** Input media types accepted (e.g., 'text/plain', 'application/json') */
+    readonly inputModes?: string[];
+    /** Output media types produced */
+    readonly outputModes?: string[];
+    /** Security scopes required for this skill */
+    readonly securityScopes?: string[];
+}
+/**
+ * Common input modes for agents
+ */
+export type InputMode = 'text/plain' | 'application/json' | 'text/markdown' | 'application/xml' | 'text/html' | 'image/png' | 'image/jpeg' | 'application/pdf' | 'application/octet-stream' | string;
+/**
+ * Common output modes for agents
+ */
+export type OutputMode = 'text/plain' | 'application/json' | 'text/markdown' | 'application/xml' | 'text/html' | 'application/sarif+json' | 'application/octet-stream' | string;
+/**
+ * A2A Agent Card - Digital "business card" for an AI agent
+ *
+ * Describes the agent's identity, capabilities, skills, service endpoints,
+ * and authentication requirements per A2A Protocol v0.3 specification.
+ */
+export interface AgentCard {
+    /** Human-readable agent name */
+    readonly name: string;
+    /** Detailed description of the agent's purpose and capabilities */
+    readonly description: string;
+    /** Service endpoint URL where the agent can be reached */
+    readonly url: string;
+    /** Agent version (semantic versioning recommended) */
+    readonly version: string;
+    /** Information about the organization providing the agent */
+    readonly provider?: AgentProvider;
+    /** URL to the agent's documentation */
+    readonly documentationUrl?: string;
+    /** Agent capabilities (streaming, notifications, history) */
+    readonly capabilities: AgentCapabilities;
+    /** Skills the agent can perform */
+    readonly skills: AgentSkill[];
+    /** Default input media types accepted */
+    readonly defaultInputModes?: InputMode[];
+    /** Default output media types produced */
+    readonly defaultOutputModes?: OutputMode[];
+    /** Supported security schemes */
+    readonly securitySchemes?: SecurityScheme[];
+    /** Authentication requirements */
+    readonly authentication?: AgentAuthentication;
+    /** Whether the agent provides an extended card for authenticated clients */
+    readonly supportsAuthenticatedExtendedCard?: boolean;
+}
+/**
+ * Extended agent card with additional details for authenticated clients
+ */
+export interface ExtendedAgentCard extends AgentCard {
+    /** Extended information only available to authenticated clients */
+    readonly extended?: {
+        /** Rate limiting information */
+        readonly rateLimits?: {
+            readonly requestsPerMinute?: number;
+            readonly requestsPerHour?: number;
+            readonly requestsPerDay?: number;
+        };
+        /** Support contact information */
+        readonly supportContact?: string;
+        /** SLA information */
+        readonly sla?: {
+            readonly uptimeTarget?: number;
+            readonly responseTimeTarget?: number;
+        };
+        /** Custom metadata */
+        readonly metadata?: Record<string, unknown>;
+    };
+}
+/**
+ * QE-specific agent card with additional AQE v3 metadata
+ */
+export interface QEAgentCard extends AgentCard {
+    /** QE-specific metadata */
+    readonly qeMetadata?: {
+        /** DDD domain the agent belongs to */
+        readonly domain?: string;
+        /** V2 compatibility mapping */
+        readonly v2Compatibility?: {
+            readonly name?: string;
+            readonly deprecatedIn?: string;
+            readonly removedIn?: string;
+        };
+        /** Memory namespaces the agent reads from */
+        readonly memoryReads?: string[];
+        /** Memory namespaces the agent writes to */
+        readonly memoryWrites?: string[];
+        /** Related agents for coordination */
+        readonly relatedAgents?: string[];
+        /** Implementation status */
+        readonly implementationStatus?: {
+            readonly working?: string[];
+            readonly partial?: string[];
+            readonly planned?: string[];
+        };
+    };
+}
+/**
+ * Type guard for AgentCard
+ */
+export declare function isAgentCard(value: unknown): value is AgentCard;
+/**
+ * Type guard for AgentSkill
+ */
+export declare function isAgentSkill(value: unknown): value is AgentSkill;
+/**
+ * Type guard for SecurityScheme
+ */
+export declare function isSecurityScheme(value: unknown): value is SecurityScheme;
+/**
+ * Type guard for QEAgentCard
+ */
+export declare function isQEAgentCard(value: unknown): value is QEAgentCard;
+/**
+ * Default agent capabilities
+ */
+export declare const DEFAULT_CAPABILITIES: AgentCapabilities;
+/**
+ * Default input modes
+ */
+export declare const DEFAULT_INPUT_MODES: InputMode[];
+/**
+ * Default output modes
+ */
+export declare const DEFAULT_OUTPUT_MODES: OutputMode[];
+/**
+ * Default QE provider information
+ */
+export declare const DEFAULT_QE_PROVIDER: AgentProvider;
+/**
+ * Create a minimal agent skill
+ */
+export declare function createAgentSkill(id: string, name: string, description: string, options?: Partial<Omit<AgentSkill, 'id' | 'name' | 'description'>>): AgentSkill;
+/**
+ * Create a minimal agent card
+ */
+export declare function createAgentCard(name: string, description: string, url: string, version: string, skills: AgentSkill[], options?: Partial<Omit<AgentCard, 'name' | 'description' | 'url' | 'version' | 'skills'>>): AgentCard;
+/**
+ * Create a QE-specific agent card
+ */
+export declare function createQEAgentCard(name: string, description: string, url: string, version: string, skills: AgentSkill[], qeMetadata: QEAgentCard['qeMetadata'], options?: Partial<Omit<AgentCard, 'name' | 'description' | 'url' | 'version' | 'skills'>>): QEAgentCard;
+//# sourceMappingURL=schema.d.ts.map

package/v3/dist/adapters/a2a/agent-cards/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/adapters/a2a/agent-cards/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,eAAe,GACf,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3C,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;QAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;QAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;QACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;KACxC,CAAC;IACF,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,2BAA2B,GAC3B,uBAAuB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,8DAA8D;IAC9D,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC3C;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CACpC;AAMD;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,WAAW,GACX,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,0BAA0B,GAC1B,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,WAAW,GACX,wBAAwB,GACxB,0BAA0B,GAC1B,MAAM,CAAC;AAMX;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IAKxB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAMzB,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAElC,uCAAuC;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAMnC,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IAMzC,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IAM9B,yCAAyC;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC;IAEzC,0CAA0C;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,UAAU,EAAE,CAAC;IAM3C,iCAAiC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAE5C,kCAAkC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAE9C,4EAA4E;IAC5E,QAAQ,CAAC,iCAAiC,CAAC,EAAE,OAAO,CAAC;CACtD;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,gCAAgC;QAChC,QAAQ,CAAC,UAAU,CAAC,EAAE;YACpB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;YACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;YAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;SAClC,CAAC;QACF,kCAAkC;QAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QACjC,sBAAsB;QACtB,QAAQ,CAAC,GAAG,CAAC,EAAE;YACb,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;YAC/B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;SACtC,CAAC;QACF,sBAAsB;QACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC7C,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,sCAAsC;QACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,+BAA+B;QAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE;YACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;YAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;SAC7B,CAAC;QACF,6CAA6C;QAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAChC,4CAA4C;QAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACjC,sCAAsC;QACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAClC,4BAA4B;QAC5B,QAAQ,CAAC,oBAAoB,CAAC,EAAE;YAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;YAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;YAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;SAC7B,CAAC;KACH,CAAC;CACH;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAe9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAWhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAcxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAMD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBAIlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,EAAuC,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,EAAuC,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAGjC,CAAC;AAMF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,CAAM,GACrE,UAAU,CAOZ;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAM,GAC5F,SAAS,CAgBX;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAAE,EACpB,UAAU,EAAE,WAAW,CAAC,YAAY,CAAC,EACrC,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAM,GAC5F,WAAW,CAQb"}

package/v3/dist/adapters/a2a/agent-cards/schema.js

@@ -0,0 +1,135 @@
+/**
+ * A2A Protocol Agent Card Schema
+ *
+ * Defines TypeScript interfaces for A2A v0.3 Agent Capability Cards.
+ * Reference: https://a2a-protocol.org/latest/specification/
+ *
+ * @module adapters/a2a/agent-cards/schema
+ */
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard for AgentCard
+ */
+export function isAgentCard(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.name === 'string' &&
+        typeof obj.description === 'string' &&
+        typeof obj.url === 'string' &&
+        typeof obj.version === 'string' &&
+        typeof obj.capabilities === 'object' &&
+        obj.capabilities !== null &&
+        Array.isArray(obj.skills));
+}
+/**
+ * Type guard for AgentSkill
+ */
+export function isAgentSkill(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.id === 'string' &&
+        typeof obj.name === 'string' &&
+        typeof obj.description === 'string');
+}
+/**
+ * Type guard for SecurityScheme
+ */
+export function isSecurityScheme(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    const validTypes = [
+        'apiKey',
+        'http',
+        'oauth2',
+        'openIdConnect',
+        'mutualTLS',
+    ];
+    return validTypes.includes(obj.type);
+}
+/**
+ * Type guard for QEAgentCard
+ */
+export function isQEAgentCard(value) {
+    return isAgentCard(value) && 'qeMetadata' in value;
+}
+// ============================================================================
+// Default Values
+// ============================================================================
+/**
+ * Default agent capabilities
+ */
+export const DEFAULT_CAPABILITIES = {
+    streaming: true,
+    pushNotifications: false,
+    stateTransitionHistory: true,
+};
+/**
+ * Default input modes
+ */
+export const DEFAULT_INPUT_MODES = ['text/plain', 'application/json'];
+/**
+ * Default output modes
+ */
+export const DEFAULT_OUTPUT_MODES = ['application/json', 'text/plain'];
+/**
+ * Default QE provider information
+ */
+export const DEFAULT_QE_PROVIDER = {
+    organization: 'Agentic QE',
+    url: 'https://github.com/agentic-qe/agentic-qe',
+};
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create a minimal agent skill
+ */
+export function createAgentSkill(id, name, description, options = {}) {
+    return {
+        id,
+        name,
+        description,
+        ...options,
+    };
+}
+/**
+ * Create a minimal agent card
+ */
+export function createAgentCard(name, description, url, version, skills, options = {}) {
+    return {
+        name,
+        description,
+        url,
+        version,
+        capabilities: options.capabilities ?? DEFAULT_CAPABILITIES,
+        skills,
+        defaultInputModes: options.defaultInputModes ?? DEFAULT_INPUT_MODES,
+        defaultOutputModes: options.defaultOutputModes ?? DEFAULT_OUTPUT_MODES,
+        provider: options.provider,
+        documentationUrl: options.documentationUrl,
+        securitySchemes: options.securitySchemes,
+        authentication: options.authentication,
+        supportsAuthenticatedExtendedCard: options.supportsAuthenticatedExtendedCard,
+    };
+}
+/**
+ * Create a QE-specific agent card
+ */
+export function createQEAgentCard(name, description, url, version, skills, qeMetadata, options = {}) {
+    return {
+        ...createAgentCard(name, description, url, version, skills, {
+            ...options,
+            provider: options.provider ?? DEFAULT_QE_PROVIDER,
+        }),
+        qeMetadata,
+    };
+}
+//# sourceMappingURL=schema.js.map

package/v3/dist/adapters/a2a/agent-cards/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/adapters/a2a/agent-cards/schema.ts"],"names":[],"mappings":"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"}