@cleocode/lafs 2026.4.0 → 2026.4.3

package/dist/src/a2a/bindings/jsonrpc.d.ts

@@ -4,75 +4,259 @@
  * Method constants, error codes, and request/response builders
  * for JSON-RPC 2.0 transport per A2A spec Section 5.3-5.4.
  */
-/** All JSON-RPC method names defined by the A2A protocol */
+/**
+ * All JSON-RPC method names defined by the A2A protocol.
+ *
+ * @remarks
+ * Each key corresponds to an A2A operation and each value is the
+ * JSON-RPC method string sent on the wire per spec Section 5.3.
+ */
 export declare const JSONRPC_METHODS: {
+    /** Send a single message to an agent */
     readonly SendMessage: "message/send";
+    /** Send a streaming message to an agent */
     readonly SendStreamingMessage: "message/stream";
+    /** Retrieve a task by identifier */
     readonly GetTask: "tasks/get";
+    /** List tasks matching query criteria */
     readonly ListTasks: "tasks/list";
+    /** Cancel a running task */
     readonly CancelTask: "tasks/cancel";
+    /** Resubscribe to task events */
     readonly SubscribeToTask: "tasks/resubscribe";
+    /** Set push notification configuration for a task */
     readonly SetTaskPushNotificationConfig: "tasks/pushNotificationConfig/set";
+    /** Get push notification configuration for a task */
     readonly GetTaskPushNotificationConfig: "tasks/pushNotificationConfig/get";
+    /** List push notification configurations for a task */
     readonly ListTaskPushNotificationConfig: "tasks/pushNotificationConfig/list";
+    /** Delete push notification configuration for a task */
     readonly DeleteTaskPushNotificationConfig: "tasks/pushNotificationConfig/delete";
+    /** Retrieve the authenticated extended agent card */
     readonly GetExtendedAgentCard: "agent/getAuthenticatedExtendedCard";
 };
+/** Union of all valid JSON-RPC method string values from {@link JSONRPC_METHODS} */
 export type JsonRpcMethod = (typeof JSONRPC_METHODS)[keyof typeof JSONRPC_METHODS];
-/** Standard JSON-RPC 2.0 error codes */
+/**
+ * Standard JSON-RPC 2.0 error codes.
+ *
+ * @remarks
+ * These are the error codes defined in the JSON-RPC 2.0 specification
+ * and are not A2A-specific.
+ */
 export declare const JSONRPC_STANDARD_ERROR_CODES: {
+    /** Invalid JSON was received by the server */
     readonly ParseError: -32700;
+    /** The JSON sent is not a valid Request object */
     readonly InvalidRequest: -32600;
+    /** The method does not exist or is not available */
     readonly MethodNotFound: -32601;
+    /** Invalid method parameter(s) */
     readonly InvalidParams: -32602;
+    /** Internal JSON-RPC error */
     readonly InternalError: -32603;
 };
-/** A2A-specific error codes (-32001 through -32009) */
+/**
+ * A2A-specific error codes (-32001 through -32009).
+ *
+ * @remarks
+ * These codes occupy the JSON-RPC server error range and are
+ * defined by the A2A protocol spec Section 5.4.
+ */
 export declare const JSONRPC_A2A_ERROR_CODES: {
+    /** The requested task was not found */
     readonly TaskNotFound: -32001;
+    /** The task cannot be canceled in its current state */
     readonly TaskNotCancelable: -32002;
+    /** Push notifications are not supported by the agent */
     readonly PushNotificationNotSupported: -32003;
+    /** The requested operation is not supported */
     readonly UnsupportedOperation: -32004;
+    /** The provided content type is not supported */
     readonly ContentTypeNotSupported: -32005;
+    /** The downstream agent returned an invalid response */
     readonly InvalidAgentResponse: -32006;
+    /** The authenticated extended card is not configured */
     readonly AuthenticatedExtendedCardNotConfigured: -32007;
+    /** A required extension is not supported by the peer */
     readonly ExtensionSupportRequired: -32008;
+    /** The requested protocol version is not supported */
     readonly VersionNotSupported: -32009;
 };
+/** Union of A2A error type key names from {@link JSONRPC_A2A_ERROR_CODES} */
 export type A2AErrorType = keyof typeof JSONRPC_A2A_ERROR_CODES;
+/**
+ * A JSON-RPC 2.0 request object.
+ *
+ * @remarks
+ * Represents a well-formed JSON-RPC request per the JSON-RPC 2.0 specification.
+ */
 export interface JsonRpcRequest {
+    /** JSON-RPC protocol version, always `"2.0"` */
     jsonrpc: '2.0';
+    /** Client-assigned request identifier */
     id: string | number;
+    /** The RPC method name to invoke */
     method: string;
+    /**
+     * Named parameters for the method call.
+     * @defaultValue undefined
+     */
     params?: Record<string, unknown>;
 }
+/**
+ * A JSON-RPC 2.0 success response object.
+ *
+ * @remarks
+ * Returned when the method call succeeds. The `result` field contains the
+ * method return value and `error` is absent.
+ */
 export interface JsonRpcResponse {
+    /** JSON-RPC protocol version, always `"2.0"` */
     jsonrpc: '2.0';
+    /** Identifier matching the originating request, or `null` for notifications */
     id: string | number | null;
+    /** The return value of the invoked method */
     result: unknown;
 }
+/**
+ * A JSON-RPC 2.0 error response object.
+ *
+ * @remarks
+ * Returned when the method call fails. The `error` field contains the
+ * error details and `result` is absent.
+ */
 export interface JsonRpcErrorResponse {
+    /** JSON-RPC protocol version, always `"2.0"` */
     jsonrpc: '2.0';
+    /** Identifier matching the originating request, or `null` for notifications */
     id: string | number | null;
+    /** Error descriptor containing code, message, and optional data */
     error: {
+        /** Numeric error code indicating the type of failure */
         code: number;
+        /** Short human-readable description of the error */
         message: string;
+        /**
+         * Additional structured error data.
+         * @defaultValue undefined
+         */
         data?: Record<string, unknown>;
     };
 }
-/** Create a JSON-RPC 2.0 request object */
+/**
+ * Create a JSON-RPC 2.0 request object.
+ *
+ * @remarks
+ * Builds a spec-compliant request with the `jsonrpc: "2.0"` field set
+ * automatically. The `params` field is omitted when not provided.
+ *
+ * @param id - Client-assigned request identifier
+ * @param method - The RPC method name to invoke
+ * @param params - Optional named parameters for the method call
+ * @returns A fully formed {@link JsonRpcRequest} object
+ *
+ * @example
+ * ```ts
+ * const req = createJsonRpcRequest(1, 'tasks/get', { id: 'abc' });
+ * // { jsonrpc: '2.0', id: 1, method: 'tasks/get', params: { id: 'abc' } }
+ * ```
+ */
 export declare function createJsonRpcRequest(id: string | number, method: string, params?: Record<string, unknown>): JsonRpcRequest;
-/** Create a JSON-RPC 2.0 success response */
+/**
+ * Create a JSON-RPC 2.0 success response.
+ *
+ * @remarks
+ * Wraps an arbitrary result value in the standard JSON-RPC 2.0 response
+ * envelope with the `jsonrpc: "2.0"` field set automatically.
+ *
+ * @param id - Identifier matching the originating request, or `null` for notifications
+ * @param result - The return value of the invoked method
+ * @returns A fully formed {@link JsonRpcResponse} object
+ *
+ * @example
+ * ```ts
+ * const res = createJsonRpcResponse(1, { status: 'ok' });
+ * // { jsonrpc: '2.0', id: 1, result: { status: 'ok' } }
+ * ```
+ */
 export declare function createJsonRpcResponse(id: string | number | null, result: unknown): JsonRpcResponse;
-/** Create a JSON-RPC 2.0 error response */
+/**
+ * Create a JSON-RPC 2.0 error response.
+ *
+ * @remarks
+ * Builds an error response with the standard `error` object containing
+ * the numeric code, message, and optional structured data.
+ *
+ * @param id - Identifier matching the originating request, or `null` for notifications
+ * @param code - Numeric error code (standard or A2A-specific)
+ * @param message - Short human-readable description of the error
+ * @param data - Optional additional structured error data
+ * @returns A fully formed {@link JsonRpcErrorResponse} object
+ *
+ * @example
+ * ```ts
+ * const err = createJsonRpcErrorResponse(1, -32001, 'Task not found');
+ * // { jsonrpc: '2.0', id: 1, error: { code: -32001, message: 'Task not found' } }
+ * ```
+ */
 export declare function createJsonRpcErrorResponse(id: string | number | null, code: number, message: string, data?: Record<string, unknown>): JsonRpcErrorResponse;
-/** Create an A2A-specific JSON-RPC error response by error type name */
+/**
+ * Create an A2A-specific JSON-RPC error response by error type name.
+ *
+ * @remarks
+ * Convenience wrapper around {@link createJsonRpcErrorResponse} that resolves
+ * the numeric error code from {@link JSONRPC_A2A_ERROR_CODES} automatically.
+ *
+ * @param id - Identifier matching the originating request, or `null` for notifications
+ * @param errorType - The A2A error type name (e.g. `"TaskNotFound"`)
+ * @param message - Short human-readable description of the error
+ * @param data - Optional additional structured error data
+ * @returns A fully formed {@link JsonRpcErrorResponse} with the resolved A2A error code
+ *
+ * @example
+ * ```ts
+ * const err = createA2AErrorResponse(1, 'TaskNotFound', 'No task with id xyz');
+ * // error.code === -32001
+ * ```
+ */
 export declare function createA2AErrorResponse(id: string | number | null, errorType: A2AErrorType, message: string, data?: Record<string, unknown>): JsonRpcErrorResponse;
-/** Validate the structure of a JSON-RPC request */
+/**
+ * Validate the structure of a JSON-RPC request.
+ *
+ * @remarks
+ * Performs structural validation of an unknown input against the JSON-RPC 2.0
+ * request schema. Checks the `jsonrpc` version, `id` type, `method` string,
+ * and that the method is a known A2A method from {@link JSONRPC_METHODS}.
+ *
+ * @param input - The unknown value to validate
+ * @returns An object with `valid` indicating success and `errors` listing any violations
+ *
+ * @example
+ * ```ts
+ * const { valid, errors } = validateJsonRpcRequest({ jsonrpc: '2.0', id: 1, method: 'tasks/get' });
+ * // valid === true, errors === []
+ * ```
+ */
 export declare function validateJsonRpcRequest(input: unknown): {
     valid: boolean;
     errors: string[];
 };
-/** Check if a numeric error code is an A2A-specific error */
+/**
+ * Check if a numeric error code is an A2A-specific error.
+ *
+ * @remarks
+ * A2A error codes occupy the range -32009 through -32001 within the
+ * JSON-RPC server error code space.
+ *
+ * @param code - The numeric JSON-RPC error code to check
+ * @returns `true` if the code falls within the A2A error range
+ *
+ * @example
+ * ```ts
+ * isA2AError(-32001); // true  (TaskNotFound)
+ * isA2AError(-32700); // false (standard ParseError)
+ * ```
+ */
 export declare function isA2AError(code: number): boolean;
 //# sourceMappingURL=jsonrpc.d.ts.map

package/dist/src/a2a/bindings/jsonrpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../../../src/a2a/bindings/jsonrpc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,4DAA4D;AAC5D,eAAO,MAAM,eAAe;;;;;;;;;;;;CAYlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAMnF,wCAAwC;AACxC,eAAO,MAAM,4BAA4B;;;;;;CAM/B,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,uBAAuB;;;;;;;;;;CAU1B,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,uBAAuB,CAAC;AAMhE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;CACH;AAMD,2CAA2C;AAC3C,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,cAAc,CAOhB;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,MAAM,EAAE,OAAO,GACd,eAAe,CAMjB;AAED,2CAA2C;AAC3C,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,oBAAoB,CAUtB;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,oBAAoB,CAEtB;AAQD,mDAAmD;AACnD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA+B3F;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD"}
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../../../src/a2a/bindings/jsonrpc.ts"],"names":[],"mappings":"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"}

package/dist/src/a2a/bindings/jsonrpc.js

@@ -7,47 +7,107 @@
 // ============================================================================
 // Method Constants (spec Section 5.3)
 // ============================================================================
-/** All JSON-RPC method names defined by the A2A protocol */
+/**
+ * All JSON-RPC method names defined by the A2A protocol.
+ *
+ * @remarks
+ * Each key corresponds to an A2A operation and each value is the
+ * JSON-RPC method string sent on the wire per spec Section 5.3.
+ */
 export const JSONRPC_METHODS = {
+    /** Send a single message to an agent */
     SendMessage: 'message/send',
+    /** Send a streaming message to an agent */
     SendStreamingMessage: 'message/stream',
+    /** Retrieve a task by identifier */
     GetTask: 'tasks/get',
+    /** List tasks matching query criteria */
     ListTasks: 'tasks/list',
+    /** Cancel a running task */
     CancelTask: 'tasks/cancel',
+    /** Resubscribe to task events */
     SubscribeToTask: 'tasks/resubscribe',
+    /** Set push notification configuration for a task */
     SetTaskPushNotificationConfig: 'tasks/pushNotificationConfig/set',
+    /** Get push notification configuration for a task */
     GetTaskPushNotificationConfig: 'tasks/pushNotificationConfig/get',
+    /** List push notification configurations for a task */
     ListTaskPushNotificationConfig: 'tasks/pushNotificationConfig/list',
+    /** Delete push notification configuration for a task */
     DeleteTaskPushNotificationConfig: 'tasks/pushNotificationConfig/delete',
+    /** Retrieve the authenticated extended agent card */
     GetExtendedAgentCard: 'agent/getAuthenticatedExtendedCard',
 };
 // ============================================================================
 // Error Code Constants (spec Section 5.4)
 // ============================================================================
-/** Standard JSON-RPC 2.0 error codes */
+/**
+ * Standard JSON-RPC 2.0 error codes.
+ *
+ * @remarks
+ * These are the error codes defined in the JSON-RPC 2.0 specification
+ * and are not A2A-specific.
+ */
 export const JSONRPC_STANDARD_ERROR_CODES = {
+    /** Invalid JSON was received by the server */
     ParseError: -32700,
+    /** The JSON sent is not a valid Request object */
     InvalidRequest: -32600,
+    /** The method does not exist or is not available */
     MethodNotFound: -32601,
+    /** Invalid method parameter(s) */
     InvalidParams: -32602,
+    /** Internal JSON-RPC error */
     InternalError: -32603,
 };
-/** A2A-specific error codes (-32001 through -32009) */
+/**
+ * A2A-specific error codes (-32001 through -32009).
+ *
+ * @remarks
+ * These codes occupy the JSON-RPC server error range and are
+ * defined by the A2A protocol spec Section 5.4.
+ */
 export const JSONRPC_A2A_ERROR_CODES = {
+    /** The requested task was not found */
     TaskNotFound: -32001,
+    /** The task cannot be canceled in its current state */
     TaskNotCancelable: -32002,
+    /** Push notifications are not supported by the agent */
     PushNotificationNotSupported: -32003,
+    /** The requested operation is not supported */
     UnsupportedOperation: -32004,
+    /** The provided content type is not supported */
     ContentTypeNotSupported: -32005,
+    /** The downstream agent returned an invalid response */
     InvalidAgentResponse: -32006,
+    /** The authenticated extended card is not configured */
     AuthenticatedExtendedCardNotConfigured: -32007,
+    /** A required extension is not supported by the peer */
     ExtensionSupportRequired: -32008,
+    /** The requested protocol version is not supported */
     VersionNotSupported: -32009,
 };
 // ============================================================================
 // Builders
 // ============================================================================
-/** Create a JSON-RPC 2.0 request object */
+/**
+ * Create a JSON-RPC 2.0 request object.
+ *
+ * @remarks
+ * Builds a spec-compliant request with the `jsonrpc: "2.0"` field set
+ * automatically. The `params` field is omitted when not provided.
+ *
+ * @param id - Client-assigned request identifier
+ * @param method - The RPC method name to invoke
+ * @param params - Optional named parameters for the method call
+ * @returns A fully formed {@link JsonRpcRequest} object
+ *
+ * @example
+ * ```ts
+ * const req = createJsonRpcRequest(1, 'tasks/get', { id: 'abc' });
+ * // { jsonrpc: '2.0', id: 1, method: 'tasks/get', params: { id: 'abc' } }
+ * ```
+ */
 export function createJsonRpcRequest(id, method, params) {
     return {
         jsonrpc: '2.0',
@@ -56,7 +116,23 @@ export function createJsonRpcRequest(id, method, params) {
         ...(params !== undefined && { params }),
     };
 }
-/** Create a JSON-RPC 2.0 success response */
+/**
+ * Create a JSON-RPC 2.0 success response.
+ *
+ * @remarks
+ * Wraps an arbitrary result value in the standard JSON-RPC 2.0 response
+ * envelope with the `jsonrpc: "2.0"` field set automatically.
+ *
+ * @param id - Identifier matching the originating request, or `null` for notifications
+ * @param result - The return value of the invoked method
+ * @returns A fully formed {@link JsonRpcResponse} object
+ *
+ * @example
+ * ```ts
+ * const res = createJsonRpcResponse(1, { status: 'ok' });
+ * // { jsonrpc: '2.0', id: 1, result: { status: 'ok' } }
+ * ```
+ */
 export function createJsonRpcResponse(id, result) {
     return {
         jsonrpc: '2.0',
@@ -64,7 +140,25 @@ export function createJsonRpcResponse(id, result) {
         result,
     };
 }
-/** Create a JSON-RPC 2.0 error response */
+/**
+ * Create a JSON-RPC 2.0 error response.
+ *
+ * @remarks
+ * Builds an error response with the standard `error` object containing
+ * the numeric code, message, and optional structured data.
+ *
+ * @param id - Identifier matching the originating request, or `null` for notifications
+ * @param code - Numeric error code (standard or A2A-specific)
+ * @param message - Short human-readable description of the error
+ * @param data - Optional additional structured error data
+ * @returns A fully formed {@link JsonRpcErrorResponse} object
+ *
+ * @example
+ * ```ts
+ * const err = createJsonRpcErrorResponse(1, -32001, 'Task not found');
+ * // { jsonrpc: '2.0', id: 1, error: { code: -32001, message: 'Task not found' } }
+ * ```
+ */
 export function createJsonRpcErrorResponse(id, code, message, data) {
     return {
         jsonrpc: '2.0',
@@ -76,7 +170,25 @@ export function createJsonRpcErrorResponse(id, code, message, data) {
         },
     };
 }
-/** Create an A2A-specific JSON-RPC error response by error type name */
+/**
+ * Create an A2A-specific JSON-RPC error response by error type name.
+ *
+ * @remarks
+ * Convenience wrapper around {@link createJsonRpcErrorResponse} that resolves
+ * the numeric error code from {@link JSONRPC_A2A_ERROR_CODES} automatically.
+ *
+ * @param id - Identifier matching the originating request, or `null` for notifications
+ * @param errorType - The A2A error type name (e.g. `"TaskNotFound"`)
+ * @param message - Short human-readable description of the error
+ * @param data - Optional additional structured error data
+ * @returns A fully formed {@link JsonRpcErrorResponse} with the resolved A2A error code
+ *
+ * @example
+ * ```ts
+ * const err = createA2AErrorResponse(1, 'TaskNotFound', 'No task with id xyz');
+ * // error.code === -32001
+ * ```
+ */
 export function createA2AErrorResponse(id, errorType, message, data) {
     return createJsonRpcErrorResponse(id, JSONRPC_A2A_ERROR_CODES[errorType], message, data);
 }
@@ -84,7 +196,23 @@ export function createA2AErrorResponse(id, errorType, message, data) {
 // Validation
 // ============================================================================
 const knownMethods = new Set(Object.values(JSONRPC_METHODS));
-/** Validate the structure of a JSON-RPC request */
+/**
+ * Validate the structure of a JSON-RPC request.
+ *
+ * @remarks
+ * Performs structural validation of an unknown input against the JSON-RPC 2.0
+ * request schema. Checks the `jsonrpc` version, `id` type, `method` string,
+ * and that the method is a known A2A method from {@link JSONRPC_METHODS}.
+ *
+ * @param input - The unknown value to validate
+ * @returns An object with `valid` indicating success and `errors` listing any violations
+ *
+ * @example
+ * ```ts
+ * const { valid, errors } = validateJsonRpcRequest({ jsonrpc: '2.0', id: 1, method: 'tasks/get' });
+ * // valid === true, errors === []
+ * ```
+ */
 export function validateJsonRpcRequest(input) {
     const errors = [];
     if (typeof input !== 'object' || input === null) {
@@ -109,7 +237,22 @@ export function validateJsonRpcRequest(input) {
     }
     return { valid: errors.length === 0, errors };
 }
-/** Check if a numeric error code is an A2A-specific error */
+/**
+ * Check if a numeric error code is an A2A-specific error.
+ *
+ * @remarks
+ * A2A error codes occupy the range -32009 through -32001 within the
+ * JSON-RPC server error code space.
+ *
+ * @param code - The numeric JSON-RPC error code to check
+ * @returns `true` if the code falls within the A2A error range
+ *
+ * @example
+ * ```ts
+ * isA2AError(-32001); // true  (TaskNotFound)
+ * isA2AError(-32700); // false (standard ParseError)
+ * ```
+ */
 export function isA2AError(code) {
     return code >= -32009 && code <= -32001;
 }

package/dist/src/a2a/bindings/jsonrpc.js.map

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