@cleocode/lafs 2026.4.0 → 2026.4.3

package/dist/src/a2a/extensions.d.ts

@@ -4,6 +4,12 @@
  * Extension negotiation, LAFS extension builder, and Express middleware
  * for A2A Protocol v1.0+ compliance.
  *
+ * @remarks
+ * Implements extension negotiation per A2A spec Section 3.2.6. Extensions
+ * are declared in an Agent Card and negotiated at request time via the
+ * A2A-Extensions HTTP header. The middleware validates required extensions
+ * and attaches negotiation results to `res.locals.a2aExtensions`.
+ *
  * Reference: specs/external/extensions.md, A2A spec Section 3.2.6
  */
 import type { AgentExtension } from '@a2a-js/sdk';
@@ -14,11 +20,25 @@ export declare const LAFS_EXTENSION_URI = "https://lafs.dev/extensions/envelope/
 export declare const A2A_EXTENSIONS_HEADER = "A2A-Extensions";
 /** LAFS extension parameters declared in Agent Card */
 export interface LafsExtensionParams {
+    /** Whether the agent supports context ledger tracking */
     supportsContextLedger: boolean;
+    /** Whether the agent supports token budget enforcement */
     supportsTokenBudgets: boolean;
+    /** URL of the JSON Schema for the LAFS envelope */
     envelopeSchema: string;
+    /**
+     * Classification of the extension's behavior.
+     * @defaultValue undefined
+     */
     kind?: ExtensionKind;
 }
+/**
+ * Classification of an A2A extension's behavior.
+ *
+ * @remarks
+ * Used to group activated extensions by their declared kind.
+ * Valid values are `data-only`, `profile`, `method`, and `state-machine`.
+ */
 export type ExtensionKind = 'data-only' | 'profile' | 'method' | 'state-machine';
 /** Result of extension negotiation between client and agent */
 export interface ExtensionNegotiationResult {
@@ -35,66 +55,237 @@ export interface ExtensionNegotiationResult {
 }
 /**
  * Parse A2A-Extensions header value into URI array.
- * Splits comma-separated URIs, trims whitespace, removes empty strings.
+ *
+ * @remarks
+ * Splits comma-separated URIs, trims whitespace, and removes empty strings.
+ * Returns an empty array when the header is absent or empty.
+ *
+ * @param headerValue - Raw header value string, or undefined if absent
+ * @returns Array of trimmed extension URI strings
+ *
+ * @example
+ * ```typescript
+ * const uris = parseExtensionsHeader('https://lafs.dev/ext/v1, https://example.com/ext');
+ * // => ['https://lafs.dev/ext/v1', 'https://example.com/ext']
+ * ```
  */
 export declare function parseExtensionsHeader(headerValue: string | undefined): string[];
 /**
  * Negotiate extensions between client-requested and agent-declared sets.
+ *
+ * @remarks
  * Unsupported extensions are ignored per spec. Required agent extensions
- * not requested by the client are flagged in missingRequired.
+ * not requested by the client are flagged in `missingRequired`. Activated
+ * extensions are optionally grouped by their declared `kind` parameter.
+ *
+ * @param requestedUris - Extension URIs requested by the client
+ * @param agentExtensions - Extensions declared in the agent's Agent Card
+ * @returns Negotiation result with activated, unsupported, and missing required sets
+ *
+ * @example
+ * ```typescript
+ * const result = negotiateExtensions(
+ *   ['https://lafs.dev/extensions/envelope/v1'],
+ *   agentCard.capabilities.extensions,
+ * );
+ * if (result.missingRequired.length > 0) {
+ *   throw new ExtensionSupportRequiredError(result.missingRequired);
+ * }
+ * ```
  */
 export declare function negotiateExtensions(requestedUris: string[], agentExtensions: AgentExtension[]): ExtensionNegotiationResult;
 /**
  * Format activated extension URIs into header value.
- * Joins URIs with comma separator.
+ *
+ * @remarks
+ * Joins URIs with a comma separator suitable for the A2A-Extensions response header.
+ *
+ * @param activatedUris - Extension URIs that were successfully negotiated
+ * @returns Comma-separated header value string
+ *
+ * @example
+ * ```typescript
+ * res.setHeader('A2A-Extensions', formatExtensionsHeader(result.activated));
+ * ```
  */
 export declare function formatExtensionsHeader(activatedUris: string[]): string;
 /** Options for building the LAFS extension declaration */
 export interface BuildLafsExtensionOptions {
+    /**
+     * Whether the LAFS extension is required for all requests.
+     * @defaultValue undefined
+     */
     required?: boolean;
+    /**
+     * Whether the agent supports context ledger tracking.
+     * @defaultValue undefined
+     */
     supportsContextLedger?: boolean;
+    /**
+     * Whether the agent supports token budget enforcement.
+     * @defaultValue undefined
+     */
     supportsTokenBudgets?: boolean;
+    /**
+     * URL of the JSON Schema for the LAFS envelope.
+     * @defaultValue undefined
+     */
     envelopeSchema?: string;
 }
 /**
  * Build an A2A AgentExtension object declaring LAFS support.
- * Suitable for inclusion in Agent Card capabilities.extensions[].
+ *
+ * @remarks
+ * Creates a fully-formed extension declaration suitable for inclusion in
+ * Agent Card `capabilities.extensions[]`. Defaults to non-required with
+ * the canonical LAFS envelope schema URL and `profile` kind.
+ *
+ * @param options - Configuration options for the LAFS extension declaration
+ * @returns A2A AgentExtension object ready for inclusion in an Agent Card
+ *
+ * @example
+ * ```typescript
+ * const ext = buildLafsExtension({ required: true, supportsTokenBudgets: true });
+ * agentCard.capabilities.extensions.push(ext);
+ * ```
  */
 export declare function buildLafsExtension(options?: BuildLafsExtensionOptions): AgentExtension;
+/** Options for building a generic A2A extension declaration */
 export interface BuildExtensionOptions {
+    /** Canonical URI identifying the extension */
     uri: string;
+    /** Human-readable description of what the extension provides */
     description: string;
+    /**
+     * Whether the extension is required for all requests.
+     * @defaultValue undefined
+     */
     required?: boolean;
+    /** Classification of the extension's behavior */
     kind: ExtensionKind;
+    /**
+     * Additional parameters to include in the extension declaration.
+     * @defaultValue undefined
+     */
     params?: Record<string, unknown>;
 }
+/**
+ * Build a generic A2A AgentExtension object.
+ *
+ * @remarks
+ * Creates a fully-formed extension declaration with the specified kind
+ * merged into params. Use {@link buildLafsExtension} for LAFS-specific declarations.
+ *
+ * @param options - Configuration for the extension declaration
+ * @returns A2A AgentExtension object
+ *
+ * @example
+ * ```typescript
+ * const ext = buildExtension({
+ *   uri: 'https://example.com/ext/v1',
+ *   description: 'Custom extension',
+ *   kind: 'data-only',
+ * });
+ * ```
+ */
 export declare function buildExtension(options: BuildExtensionOptions): AgentExtension;
+/**
+ * Check whether a string is a valid extension kind.
+ *
+ * @remarks
+ * Validates against the set of recognized kinds: `data-only`, `profile`,
+ * `method`, and `state-machine`.
+ *
+ * @param kind - String value to validate
+ * @returns True if the value is a recognized ExtensionKind
+ *
+ * @example
+ * ```typescript
+ * if (isValidExtensionKind(userInput)) {
+ *   // userInput is now typed as ExtensionKind
+ * }
+ * ```
+ */
 export declare function isValidExtensionKind(kind: string): kind is ExtensionKind;
+/**
+ * Validate an A2A extension declaration for correctness.
+ *
+ * @remarks
+ * Checks that if a `kind` parameter is present, it must be one of the
+ * recognized ExtensionKind values. Extensions without a kind are valid.
+ *
+ * @param extension - The AgentExtension to validate
+ * @returns Object with `valid` boolean and optional `error` message
+ *
+ * @example
+ * ```typescript
+ * const { valid, error } = validateExtensionDeclaration(ext);
+ * if (!valid) {
+ *   console.error('Invalid extension:', error);
+ * }
+ * ```
+ */
 export declare function validateExtensionDeclaration(extension: AgentExtension): {
     valid: boolean;
     error?: string;
 };
 /**
  * Error thrown when required A2A extensions are not supported by the client.
- * Code -32008 (not in SDK, which stops at -32007).
+ *
+ * @remarks
+ * Uses JSON-RPC error code -32008, which is outside the SDK's range (stops at -32007).
+ * Provides conversion methods for JSON-RPC, RFC 9457 Problem Details, and LAFS error formats.
  */
 export declare class ExtensionSupportRequiredError extends Error {
+    /** JSON-RPC error code for extension support required */
     readonly code: -32008;
+    /** HTTP status code returned for this error */
     readonly httpStatus: 400;
+    /** gRPC status code equivalent */
     readonly grpcStatus: "FAILED_PRECONDITION";
+    /** URIs of the required extensions that the client did not provide */
     readonly missingExtensions: string[];
+    /**
+     * Create an ExtensionSupportRequiredError.
+     *
+     * @param missingExtensions - URIs of required extensions not provided by the client
+     */
     constructor(missingExtensions: string[]);
-    /** Convert to JSON-RPC error object */
+    /**
+     * Convert to JSON-RPC error object.
+     *
+     * @remarks
+     * Returns a JSON-RPC 2.0 compatible error with the missing extensions in `data`.
+     *
+     * @returns JSON-RPC error with code, message, and data containing missing extension URIs
+     */
     toJSONRPCError(): {
         code: number;
         message: string;
         data: Record<string, unknown>;
     };
-    /** Convert to RFC 9457 Problem Details object with agent-actionable fields */
+    /**
+     * Convert to RFC 9457 Problem Details object with agent-actionable fields.
+     *
+     * @remarks
+     * Includes `agentAction: 'retry_modified'` so consuming agents know they
+     * should retry the request with the required extensions activated.
+     *
+     * @returns Problem Details object with `agentAction` field for agent-driven retry
+     */
     toProblemDetails(): Record<string, unknown> & {
         agentAction: string;
     };
-    /** Convert to a LAFSError-compatible object */
+    /**
+     * Convert to a LAFSError-compatible object.
+     *
+     * @remarks
+     * Returns an object matching the LAFS error shape with category `CONTRACT`
+     * and code `E_CONTRACT_EXTENSION_REQUIRED`. Marked as retryable since
+     * the client can retry with the required extensions.
+     *
+     * @returns LAFS-compatible error object with code, message, category, and details
+     */
     toLafsError(): {
         code: string;
         message: string;
@@ -108,15 +299,33 @@ export declare class ExtensionSupportRequiredError extends Error {
 export interface ExtensionNegotiationMiddlewareOptions {
     /** Agent-declared extensions to negotiate against */
     extensions: AgentExtension[];
-    /** Return 400 if required extensions are missing (default: true) */
+    /**
+     * Return 400 if required extensions are missing.
+     * @defaultValue undefined
+     */
     enforceRequired?: boolean;
 }
 /**
  * Express middleware for A2A extension negotiation.
  *
- * Parses A2A-Extensions header (and X-A2A-Extensions for SDK compat),
- * validates against declared extensions, sets response header with
- * activated extensions, attaches result to res.locals.a2aExtensions.
+ * @remarks
+ * Parses the A2A-Extensions header (and X-A2A-Extensions for SDK compat),
+ * validates against declared extensions, sets the response header with
+ * activated extensions, and attaches the negotiation result to
+ * `res.locals.a2aExtensions`. When `enforceRequired` is true (default),
+ * returns a 400 RFC 9457 Problem Details response if required extensions
+ * are missing.
+ *
+ * @param options - Middleware configuration with extensions and enforcement settings
+ * @returns Express RequestHandler that performs extension negotiation
+ *
+ * @example
+ * ```typescript
+ * app.use(extensionNegotiationMiddleware({
+ *   extensions: agentCard.capabilities.extensions,
+ *   enforceRequired: true,
+ * }));
+ * ```
  */
 export declare function extensionNegotiationMiddleware(options: ExtensionNegotiationMiddlewareOptions): RequestHandler;
 //# sourceMappingURL=extensions.d.ts.map

package/dist/src/a2a/extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/a2a/extensions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/a2a/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAyB,cAAc,EAAY,MAAM,SAAS,CAAC;AAM/E,mCAAmC;AACnC,eAAO,MAAM,kBAAkB,4CAA4C,CAAC;AAE5E,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAYtD,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,qBAAqB,EAAE,OAAO,CAAC;IAC/B,0DAA0D;IAC1D,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,eAAe,CAAC;AAGjF,+DAA+D;AAC/D,MAAM,WAAW,0BAA0B;IACzC,mCAAmC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kEAAkE;IAClE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wDAAwD;IACxD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,oEAAoE;IACpE,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CAC3D;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAM/E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EAAE,EACvB,eAAe,EAAE,cAAc,EAAE,GAChC,0BAA0B,CAsC5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtE;AAED,0DAA0D;AAC1D,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,cAAc,CAYtF;AAED,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,IAAI,EAAE,aAAa,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAU7E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,aAAa,CAExE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,cAAc,GAAG;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAeA;AAMD;;;;;;GAMG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAG,CAAC,KAAK,CAAU;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAG,GAAG,CAAU;IACnC,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAG,qBAAqB,CAAU;IACrD,sEAAsE;IACtE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAErC;;;;OAIG;gBACS,iBAAiB,EAAE,MAAM,EAAE;IAMvC;;;;;;;OAOG;IACH,cAAc,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IAQlF;;;;;;;;OAQG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAWrE;;;;;;;;;OASG;IACH,WAAW,IAAI;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,UAAU,CAAC;QACrB,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,IAAI,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC;CAaF;AAMD,uDAAuD;AACvD,MAAM,WAAW,qCAAqC;IACpD,qDAAqD;IACrD,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,cAAc,CA8BhB"}

package/dist/src/a2a/extensions.js

@@ -4,6 +4,12 @@
  * Extension negotiation, LAFS extension builder, and Express middleware
  * for A2A Protocol v1.0+ compliance.
  *
+ * @remarks
+ * Implements extension negotiation per A2A spec Section 3.2.6. Extensions
+ * are declared in an Agent Card and negotiated at request time via the
+ * A2A-Extensions HTTP header. The middleware validates required extensions
+ * and attaches negotiation results to `res.locals.a2aExtensions`.
+ *
  * Reference: specs/external/extensions.md, A2A spec Section 3.2.6
  */
 // ============================================================================
@@ -24,7 +30,19 @@ const VALID_EXTENSION_KINDS = ['data-only', 'profile', 'method', 'state-machine'
 // ============================================================================
 /**
  * Parse A2A-Extensions header value into URI array.
- * Splits comma-separated URIs, trims whitespace, removes empty strings.
+ *
+ * @remarks
+ * Splits comma-separated URIs, trims whitespace, and removes empty strings.
+ * Returns an empty array when the header is absent or empty.
+ *
+ * @param headerValue - Raw header value string, or undefined if absent
+ * @returns Array of trimmed extension URI strings
+ *
+ * @example
+ * ```typescript
+ * const uris = parseExtensionsHeader('https://lafs.dev/ext/v1, https://example.com/ext');
+ * // => ['https://lafs.dev/ext/v1', 'https://example.com/ext']
+ * ```
  */
 export function parseExtensionsHeader(headerValue) {
     if (!headerValue)
@@ -36,8 +54,26 @@ export function parseExtensionsHeader(headerValue) {
 }
 /**
  * Negotiate extensions between client-requested and agent-declared sets.
+ *
+ * @remarks
  * Unsupported extensions are ignored per spec. Required agent extensions
- * not requested by the client are flagged in missingRequired.
+ * not requested by the client are flagged in `missingRequired`. Activated
+ * extensions are optionally grouped by their declared `kind` parameter.
+ *
+ * @param requestedUris - Extension URIs requested by the client
+ * @param agentExtensions - Extensions declared in the agent's Agent Card
+ * @returns Negotiation result with activated, unsupported, and missing required sets
+ *
+ * @example
+ * ```typescript
+ * const result = negotiateExtensions(
+ *   ['https://lafs.dev/extensions/envelope/v1'],
+ *   agentCard.capabilities.extensions,
+ * );
+ * if (result.missingRequired.length > 0) {
+ *   throw new ExtensionSupportRequiredError(result.missingRequired);
+ * }
+ * ```
  */
 export function negotiateExtensions(requestedUris, agentExtensions) {
     const declared = new Map(agentExtensions.map((ext) => [ext.uri, ext]));
@@ -76,14 +112,37 @@ export function negotiateExtensions(requestedUris, agentExtensions) {
 }
 /**
  * Format activated extension URIs into header value.
- * Joins URIs with comma separator.
+ *
+ * @remarks
+ * Joins URIs with a comma separator suitable for the A2A-Extensions response header.
+ *
+ * @param activatedUris - Extension URIs that were successfully negotiated
+ * @returns Comma-separated header value string
+ *
+ * @example
+ * ```typescript
+ * res.setHeader('A2A-Extensions', formatExtensionsHeader(result.activated));
+ * ```
  */
 export function formatExtensionsHeader(activatedUris) {
     return activatedUris.join(',');
 }
 /**
  * Build an A2A AgentExtension object declaring LAFS support.
- * Suitable for inclusion in Agent Card capabilities.extensions[].
+ *
+ * @remarks
+ * Creates a fully-formed extension declaration suitable for inclusion in
+ * Agent Card `capabilities.extensions[]`. Defaults to non-required with
+ * the canonical LAFS envelope schema URL and `profile` kind.
+ *
+ * @param options - Configuration options for the LAFS extension declaration
+ * @returns A2A AgentExtension object ready for inclusion in an Agent Card
+ *
+ * @example
+ * ```typescript
+ * const ext = buildLafsExtension({ required: true, supportsTokenBudgets: true });
+ * agentCard.capabilities.extensions.push(ext);
+ * ```
  */
 export function buildLafsExtension(options) {
     return {
@@ -98,6 +157,25 @@ export function buildLafsExtension(options) {
         },
     };
 }
+/**
+ * Build a generic A2A AgentExtension object.
+ *
+ * @remarks
+ * Creates a fully-formed extension declaration with the specified kind
+ * merged into params. Use {@link buildLafsExtension} for LAFS-specific declarations.
+ *
+ * @param options - Configuration for the extension declaration
+ * @returns A2A AgentExtension object
+ *
+ * @example
+ * ```typescript
+ * const ext = buildExtension({
+ *   uri: 'https://example.com/ext/v1',
+ *   description: 'Custom extension',
+ *   kind: 'data-only',
+ * });
+ * ```
+ */
 export function buildExtension(options) {
     return {
         uri: options.uri,
@@ -109,9 +187,44 @@ export function buildExtension(options) {
         },
     };
 }
+/**
+ * Check whether a string is a valid extension kind.
+ *
+ * @remarks
+ * Validates against the set of recognized kinds: `data-only`, `profile`,
+ * `method`, and `state-machine`.
+ *
+ * @param kind - String value to validate
+ * @returns True if the value is a recognized ExtensionKind
+ *
+ * @example
+ * ```typescript
+ * if (isValidExtensionKind(userInput)) {
+ *   // userInput is now typed as ExtensionKind
+ * }
+ * ```
+ */
 export function isValidExtensionKind(kind) {
     return VALID_EXTENSION_KINDS.includes(kind);
 }
+/**
+ * Validate an A2A extension declaration for correctness.
+ *
+ * @remarks
+ * Checks that if a `kind` parameter is present, it must be one of the
+ * recognized ExtensionKind values. Extensions without a kind are valid.
+ *
+ * @param extension - The AgentExtension to validate
+ * @returns Object with `valid` boolean and optional `error` message
+ *
+ * @example
+ * ```typescript
+ * const { valid, error } = validateExtensionDeclaration(ext);
+ * if (!valid) {
+ *   console.error('Invalid extension:', error);
+ * }
+ * ```
+ */
 export function validateExtensionDeclaration(extension) {
     const kind = extension.params && typeof extension.params === 'object'
         ? extension.params['kind']
@@ -129,19 +242,38 @@ export function validateExtensionDeclaration(extension) {
 // ============================================================================
 /**
  * Error thrown when required A2A extensions are not supported by the client.
- * Code -32008 (not in SDK, which stops at -32007).
+ *
+ * @remarks
+ * Uses JSON-RPC error code -32008, which is outside the SDK's range (stops at -32007).
+ * Provides conversion methods for JSON-RPC, RFC 9457 Problem Details, and LAFS error formats.
  */
 export class ExtensionSupportRequiredError extends Error {
+    /** JSON-RPC error code for extension support required */
     code = -32008;
+    /** HTTP status code returned for this error */
     httpStatus = 400;
+    /** gRPC status code equivalent */
     grpcStatus = 'FAILED_PRECONDITION';
+    /** URIs of the required extensions that the client did not provide */
     missingExtensions;
+    /**
+     * Create an ExtensionSupportRequiredError.
+     *
+     * @param missingExtensions - URIs of required extensions not provided by the client
+     */
     constructor(missingExtensions) {
         super(`Required extensions not supported: ${missingExtensions.join(', ')}`);
         this.name = 'ExtensionSupportRequiredError';
         this.missingExtensions = missingExtensions;
     }
-    /** Convert to JSON-RPC error object */
+    /**
+     * Convert to JSON-RPC error object.
+     *
+     * @remarks
+     * Returns a JSON-RPC 2.0 compatible error with the missing extensions in `data`.
+     *
+     * @returns JSON-RPC error with code, message, and data containing missing extension URIs
+     */
     toJSONRPCError() {
         return {
             code: this.code,
@@ -149,7 +281,15 @@ export class ExtensionSupportRequiredError extends Error {
             data: { missingExtensions: this.missingExtensions },
         };
     }
-    /** Convert to RFC 9457 Problem Details object with agent-actionable fields */
+    /**
+     * Convert to RFC 9457 Problem Details object with agent-actionable fields.
+     *
+     * @remarks
+     * Includes `agentAction: 'retry_modified'` so consuming agents know they
+     * should retry the request with the required extensions activated.
+     *
+     * @returns Problem Details object with `agentAction` field for agent-driven retry
+     */
     toProblemDetails() {
         return {
             type: 'https://a2a-protocol.org/errors/extension-support-required',
@@ -160,7 +300,16 @@ export class ExtensionSupportRequiredError extends Error {
             agentAction: 'retry_modified',
         };
     }
-    /** Convert to a LAFSError-compatible object */
+    /**
+     * Convert to a LAFSError-compatible object.
+     *
+     * @remarks
+     * Returns an object matching the LAFS error shape with category `CONTRACT`
+     * and code `E_CONTRACT_EXTENSION_REQUIRED`. Marked as retryable since
+     * the client can retry with the required extensions.
+     *
+     * @returns LAFS-compatible error object with code, message, category, and details
+     */
     toLafsError() {
         return {
             code: 'E_CONTRACT_EXTENSION_REQUIRED',
@@ -178,9 +327,24 @@ export class ExtensionSupportRequiredError extends Error {
 /**
  * Express middleware for A2A extension negotiation.
  *
- * Parses A2A-Extensions header (and X-A2A-Extensions for SDK compat),
- * validates against declared extensions, sets response header with
- * activated extensions, attaches result to res.locals.a2aExtensions.
+ * @remarks
+ * Parses the A2A-Extensions header (and X-A2A-Extensions for SDK compat),
+ * validates against declared extensions, sets the response header with
+ * activated extensions, and attaches the negotiation result to
+ * `res.locals.a2aExtensions`. When `enforceRequired` is true (default),
+ * returns a 400 RFC 9457 Problem Details response if required extensions
+ * are missing.
+ *
+ * @param options - Middleware configuration with extensions and enforcement settings
+ * @returns Express RequestHandler that performs extension negotiation
+ *
+ * @example
+ * ```typescript
+ * app.use(extensionNegotiationMiddleware({
+ *   extensions: agentCard.capabilities.extensions,
+ *   enforceRequired: true,
+ * }));
+ * ```
  */
 export function extensionNegotiationMiddleware(options) {
     const { extensions, enforceRequired = true } = options;

package/dist/src/a2a/extensions.js.map

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

package/dist/src/a2a/index.d.ts

@@ -1,6 +1,8 @@
 /**
  * LAFS Agent-to-Agent (A2A) Integration v2.0
  *
+ * @packageDocumentation
+ *
  * Full integration with the official @a2a-js/sdk for Agent-to-Agent communication.
  * Implements A2A Protocol v1.0+ specification.
  *

package/dist/src/a2a/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAMH,OAAO,EAEL,eAAe,EACf,kBAAkB,EAElB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EAErB,mBAAmB,EAEnB,aAAa,GACd,MAAM,aAAa,CAAC;AAMrB,YAAY,EACV,yBAAyB,EACzB,qCAAqC,EACrC,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAElB,6BAA6B,EAE7B,8BAA8B,EAC9B,sBAAsB,EAEtB,kBAAkB,EAClB,mBAAmB,EAEnB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAEL,kBAAkB,EAClB,kBAAkB,EAElB,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,EAEf,iBAAiB,EACjB,qBAAqB,EAErB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EAEnB,eAAe,EACf,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EACV,8BAA8B,EAC9B,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAM7B,cAAc,qBAAqB,CAAC;AAOpC,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,OAAO,EACP,wBAAwB,EACxB,IAAI,EACJ,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,EAC1B,IAAI,EACJ,uBAAuB,EACvB,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,YAAY,EAEV,aAAa,EACb,qBAAqB,GACtB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAMH,OAAO,EAEL,eAAe,EACf,kBAAkB,EAElB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EAErB,mBAAmB,EAEnB,aAAa,GACd,MAAM,aAAa,CAAC;AAMrB,YAAY,EACV,yBAAyB,EACzB,qCAAqC,EACrC,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAElB,6BAA6B,EAE7B,8BAA8B,EAC9B,sBAAsB,EAEtB,kBAAkB,EAClB,mBAAmB,EAEnB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAEL,kBAAkB,EAClB,kBAAkB,EAElB,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,EAEf,iBAAiB,EACjB,qBAAqB,EAErB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EAEnB,eAAe,EACf,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EACV,8BAA8B,EAC9B,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAM7B,cAAc,qBAAqB,CAAC;AAOpC,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,OAAO,EACP,wBAAwB,EACxB,IAAI,EACJ,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,EAC1B,IAAI,EACJ,uBAAuB,EACvB,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,YAAY,EAEV,aAAa,EACb,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/src/a2a/index.js

@@ -1,6 +1,8 @@
 /**
  * LAFS Agent-to-Agent (A2A) Integration v2.0
  *
+ * @packageDocumentation
+ *
  * Full integration with the official @a2a-js/sdk for Agent-to-Agent communication.
  * Implements A2A Protocol v1.0+ specification.
  *

package/dist/src/a2a/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,OAAO;AACL,YAAY;AACZ,eAAe,EACf,kBAAkB;AAClB,mBAAmB;AACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB;AACrB,oBAAoB;AACpB,mBAAmB;AACnB,iBAAiB;AACjB,aAAa,GACd,MAAM,aAAa,CAAC;AAYrB,OAAO,EACL,qBAAqB,EACrB,kBAAkB;AAClB,cAAc;AACd,6BAA6B;AAC7B,aAAa;AACb,8BAA8B,EAC9B,sBAAsB;AACtB,YAAY;AACZ,kBAAkB,EAClB,mBAAmB;AACnB,YAAY;AACZ,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,OAAO;AACL,mBAAmB;AACnB,kBAAkB,EAClB,kBAAkB;AAClB,gBAAgB;AAChB,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe;AACf,kBAAkB;AAClB,iBAAiB,EACjB,qBAAqB;AACrB,eAAe;AACf,WAAW,EACX,iBAAiB,EACjB,mBAAmB;AACnB,kBAAkB;AAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAY7B,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAQxB,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,OAAO;AACL,YAAY;AACZ,eAAe,EACf,kBAAkB;AAClB,mBAAmB;AACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB;AACrB,oBAAoB;AACpB,mBAAmB;AACnB,iBAAiB;AACjB,aAAa,GACd,MAAM,aAAa,CAAC;AAYrB,OAAO,EACL,qBAAqB,EACrB,kBAAkB;AAClB,cAAc;AACd,6BAA6B;AAC7B,aAAa;AACb,8BAA8B,EAC9B,sBAAsB;AACtB,YAAY;AACZ,kBAAkB,EAClB,mBAAmB;AACnB,YAAY;AACZ,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,OAAO;AACL,mBAAmB;AACnB,kBAAkB,EAClB,kBAAkB;AAClB,gBAAgB;AAChB,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe;AACf,kBAAkB;AAClB,iBAAiB,EACjB,qBAAqB;AACrB,eAAe;AACf,WAAW,EACX,iBAAiB,EACjB,mBAAmB;AACnB,kBAAkB;AAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAY7B,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAQxB,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,cAAc,qBAAqB,CAAC"}