@artinet/sdk 0.5.5 → 0.5.7

package/dist/types/schemas/a2a/notification.js

@@ -1,2 +1,204 @@
-export {};
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from "zod";
+import { JSONRPCErrorResponseSchema, JSONRPCRequestSchema, JSONRPCSuccessResponseSchema, } from "./rpc.js";
+import { TaskIdParamsSchema } from "./task.js";
+/**
+ * Defines parameters for fetching a specific push notification configuration for a task.
+ */
+export const GetTaskPushNotificationConfigParamSchema = TaskIdParamsSchema.extend({
+    /**
+     * @optional The ID of the push notification configuration to retrieve.
+     */
+    pushNotificationConfigId: z.string().optional(),
+});
+export const GetTaskPushNotificationConfigParamsSchema = z.union([
+    GetTaskPushNotificationConfigParamSchema,
+    TaskIdParamsSchema,
+]);
+/**
+ * Defines parameters for listing all push notification configurations for a task.
+ */
+export const ListTaskPushNotificationConfigsParamsSchema = TaskIdParamsSchema.extend({});
+/**
+ * Defines parameters for deleting a specific push notification configuration for a task.
+ */
+export const DeleteTaskPushNotificationConfigParamsSchema = TaskIdParamsSchema.extend({
+    /**
+     * @required The ID of the push notification configuration to delete.
+     */
+    pushNotificationConfigId: z.string(),
+});
+/**
+ * @description Defines authentication details for a push notification endpoint.
+ */
+export const PushNotificationAuthenticationInfoSchema = z
+    .object({
+    /**
+     * @required A list of supported authentication schemes (e.g., 'Basic', 'Bearer').
+     */
+    schemes: z
+        .array(z.string())
+        .describe("The authentication schemes supported by the endpoint."),
+    /**
+     * @optional Optional credentials required by the push notification endpoint.
+     */
+    credentials: z.string().optional(),
+})
+    .describe("Defines authentication details for a push notification endpoint.");
+/**
+ * @description Defines the configuration for setting up push notifications for task updates.
+ */
+export const PushNotificationConfigSchema = z
+    .object({
+    /**
+     * @optional A unique ID for the push notification configuration, created by the server
+     * to support multiple notification callbacks.
+     */
+    id: z
+        .string()
+        .optional()
+        .describe("A unique ID for the push notification configuration, created by the server to support multiple notification callbacks."),
+    /**
+     * @required The callback URL where the agent should send push notifications.
+     */
+    url: z
+        .string()
+        .url()
+        .describe("The callback URL where the agent should send push notifications."),
+    /**
+     * @optional A unique token for this task or session to validate incoming push notifications.
+     */
+    token: z
+        .string()
+        .optional()
+        .describe("A unique token for this task or session to validate incoming push notifications."),
+    /**
+     * @optional Authentication details for the agent to use when calling the notification URL.
+     */
+    authentication: PushNotificationAuthenticationInfoSchema.optional().describe("Authentication details for the agent to use when calling the notification URL."),
+})
+    .describe("Defines the configuration for setting up push notifications for task updates.");
+/**
+ * @description A container associating a push notification configuration with a specific task.
+ */
+export const TaskPushNotificationConfigSchema = z
+    .object({
+    /**
+     * @required The ID of the task to associate with the push notification configuration.
+     */
+    taskId: z
+        .string()
+        .describe("The ID of the task to associate with the push notification configuration."),
+    /**
+     * @required The push notification configuration to associate with the task.
+     */
+    pushNotificationConfig: PushNotificationConfigSchema.describe("The push notification configuration to associate with the task."),
+})
+    .describe("A container associating a push notification configuration with a specific task.");
+/**
+ * @description Request to set or update the push notification config for a task.
+ */
+export const SetTaskPushNotificationConfigRequestSchema = JSONRPCRequestSchema.extend({
+    method: z.literal("tasks/pushNotificationConfig/set"),
+    params: TaskPushNotificationConfigSchema.describe("Defines the parameters for a request to set or update the push notification config for a task."),
+}).describe("Represents a JSON-RPC request for the `tasks/pushNotificationConfig/set` method.");
+/**
+ * @description JSON-RPC success response model for the 'tasks/pushNotificationConfig/set' method.
+ */
+export const SetTaskPushNotificationConfigSuccessResponseSchema = JSONRPCSuccessResponseSchema.extend({
+    /**
+     * @required The result of the request, which can be a direct reply Message or the initial Task object.
+     */
+    result: TaskPushNotificationConfigSchema.describe("The result of the request, which can be a direct reply Message or the initial Task object."),
+}).describe("JSON-RPC success response model for the 'tasks/pushNotificationConfig/set' method.");
+/**
+ * @description Response to a `tasks/pushNotificationConfig/set` request.
+ */
+export const SetTaskPushNotificationConfigResponseSchema = z
+    .union([
+    SetTaskPushNotificationConfigSuccessResponseSchema,
+    JSONRPCErrorResponseSchema,
+])
+    .describe("Response to a `tasks/pushNotificationConfig/set` request.");
+/**
+ * @description Request to retrieve the currently configured push notification configuration for a task.
+ */
+export const GetTaskPushNotificationConfigRequestSchema = JSONRPCRequestSchema.extend({
+    method: z.literal("tasks/pushNotificationConfig/get"),
+    params: GetTaskPushNotificationConfigParamsSchema.describe("Defines the parameters for a request to retrieve the currently configured push notification configuration for a task."),
+}).describe("Represents a JSON-RPC request for the `tasks/pushNotificationConfig/get` method.");
+/**
+ * @description JSON-RPC success response model for the 'tasks/pushNotificationConfig/get' method.
+ */
+export const GetTaskPushNotificationConfigSuccessResponseSchema = JSONRPCSuccessResponseSchema.extend({
+    /**
+     * @required The result, containing the requested push notification configuration.
+     */
+    result: TaskPushNotificationConfigSchema.describe("The result, containing the requested push notification configuration."),
+}).describe("JSON-RPC success response model for the 'tasks/pushNotificationConfig/get' method.");
+/**
+ * @description Response to a `tasks/pushNotificationConfig/get` request.
+ */
+export const GetTaskPushNotificationConfigResponseSchema = z
+    .union([
+    GetTaskPushNotificationConfigSuccessResponseSchema,
+    JSONRPCErrorResponseSchema,
+])
+    .describe("Response to a `tasks/pushNotificationConfig/get` request.");
+/**
+ * @description Request to list all push notification configurations for a task.
+ */
+export const ListTaskPushNotificationConfigRequestSchema = JSONRPCRequestSchema.extend({
+    method: z.literal("tasks/pushNotificationConfig/list"),
+    params: ListTaskPushNotificationConfigsParamsSchema.describe("Defines the parameters for a request to list all push notification configurations for a task."),
+}).describe("Represents a JSON-RPC request for the `tasks/pushNotificationConfig/list` method.");
+export const ListTaskPushNotificationConfigResultSchema = z
+    .array(TaskPushNotificationConfigSchema)
+    .describe("The list of push notification configurations.");
+/**
+ * @description JSON-RPC success response model for the 'tasks/pushNotificationConfig/list' method.
+ */
+export const ListTaskPushNotificationConfigSuccessResponseSchema = JSONRPCSuccessResponseSchema.extend({
+    /**
+     * @required The result, containing the list of push notification configurations.
+     */
+    result: ListTaskPushNotificationConfigResultSchema.describe("The result, containing the list of push notification configurations."),
+}).describe("JSON-RPC success response model for the 'tasks/pushNotificationConfig/list' method.");
+/**
+ * @description Response to a `tasks/pushNotificationConfig/list` request.
+ */
+export const ListTaskPushNotificationConfigResponseSchema = z
+    .union([
+    ListTaskPushNotificationConfigSuccessResponseSchema,
+    JSONRPCErrorResponseSchema,
+])
+    .describe("Response to a `tasks/pushNotificationConfig/list` request.");
+/**
+ * @description Request to delete a specific push notification configuration for a task.
+ */
+export const DeleteTaskPushNotificationConfigRequestSchema = JSONRPCRequestSchema.extend({
+    method: z.literal("tasks/pushNotificationConfig/delete"),
+    params: DeleteTaskPushNotificationConfigParamsSchema.describe("Defines the parameters for a request to delete a specific push notification configuration for a task."),
+}).describe("Represents a JSON-RPC request for the `tasks/pushNotificationConfig/delete` method.");
+/**
+ * @description JSON-RPC success response model for the 'tasks/pushNotificationConfig/delete' method.
+ */
+export const DeleteTaskPushNotificationConfigSuccessResponseSchema = JSONRPCSuccessResponseSchema.extend({
+    /**
+     * @required The result is null on successful deletion.
+     */
+    result: z.null().describe("The result is null on successful deletion."),
+}).describe("JSON-RPC success response model for the 'tasks/pushNotificationConfig/delete' method.");
+/**
+ * @description Response to a `tasks/pushNotificationConfig/delete` request.
+ */
+export const DeleteTaskPushNotificationConfigResponseSchema = z
+    .union([
+    DeleteTaskPushNotificationConfigSuccessResponseSchema,
+    JSONRPCErrorResponseSchema,
+])
+    .describe("Response to a `tasks/pushNotificationConfig/delete` request.");
 //# sourceMappingURL=notification.js.map

package/dist/types/schemas/a2a/notification.js.map

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

package/dist/types/schemas/a2a/parameters.js

@@ -1,2 +1,242 @@
-export {};
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from "zod";
+import { KindSchema } from "./kind.js";
+/**
+ * @description Defines base properties common to all message or artifact parts.
+ */
+export const PartBaseSchema = z
+    .object({
+    /**
+     * @optional Optional metadata associated with this part.
+     */
+    metadata: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("Optional metadata associated with this part."),
+})
+    .describe("Defines base properties common to all message or artifact parts.");
+/**
+ * @description Defines base properties for a file.
+ */
+export const FileBaseSchema = z
+    .object({
+    /**
+     * @optional An optional name for the file (e.g., "document.pdf").
+     */
+    name: z
+        .string()
+        .optional()
+        .describe("An optional name for the file (e.g., 'document.pdf')."),
+    /**
+     * @optional The MIME type of the file (e.g., "application/pdf").
+     */
+    mimeType: z
+        .string()
+        .optional()
+        .describe("The MIME type of the file (e.g., 'application/pdf')."),
+})
+    .describe("Defines base properties for a file.");
+/**
+ * @description Represents a file with its content provided directly as a base64-encoded string.
+ */
+export const FileWithBytesSchema = FileBaseSchema.extend({
+    /**
+     * @required The base64-encoded content of the file.
+     */
+    bytes: z.string().describe("The base64-encoded content of the file."),
+    /**
+     * @optional The `uri` property must be absent when `bytes` is present.
+     */
+    uri: z.never().optional().describe("The URI of the file."),
+}).describe("Represents a file with its content provided directly as a base64-encoded string.");
+/**
+ * @description Represents a file with its content located at a specific URI.
+ */
+export const FileWithUriSchema = FileBaseSchema.extend({
+    /**
+     * @required A URL pointing to the file's content. (keeping as string for now)
+     */
+    uri: z.string().describe("A URL pointing to the file's content."),
+    /**
+     * @optional The `bytes` property must be absent when `uri` is present.
+     */
+    bytes: z
+        .never()
+        .optional()
+        .describe("The base64-encoded content of the file."),
+}).describe("Represents a file with its content located at a specific URI.");
+/**
+ * @description Represents a file with its content provided directly as a base64-encoded string or located at a specific URI.
+ */
+export const FileSchema = z
+    .union([FileWithBytesSchema, FileWithUriSchema])
+    .describe("Represents a file with its content provided directly as a base64-encoded string or located at a specific URI.");
+/**
+ * @description Represents a file segment within a message or artifact. The file content can be
+ * provided either directly as bytes or as a URI.
+ */
+export const FilePartSchema = PartBaseSchema.extend({
+    /**
+     * @required The type of this part, used as a discriminator. Always 'file'.
+     */
+    kind: KindSchema.refine((kind) => kind === "file").describe("The type of this object, used as a discriminator. Always 'file' for a FilePart."),
+    /**
+     * @required The file content, represented as either a URI or as base64-encoded bytes.
+     */
+    file: FileSchema.describe("The file content, represented as either a URI or as base64-encoded bytes."),
+}).describe("Represents a file segment within a message or artifact.");
+/**
+ * @description Represents a text segment within a message or artifact.
+ */
+export const TextPartSchema = PartBaseSchema.extend({
+    /**
+     * @required The type of this object, used as a discriminator. Always 'text' for a TextPart.
+     */
+    kind: KindSchema.refine((kind) => kind === "text").describe("The type of this object, used as a discriminator. Always 'text' for a TextPart."),
+    /**
+     * @required The string content of the text part.
+     */
+    text: z.string().describe("The string content of the text part."),
+}).describe("Represents a text segment within a message or artifact.");
+/**
+ * @description Represents a structured data segment (e.g., JSON) within a message or artifact.
+ */
+export const DataPartSchema = PartBaseSchema.extend({
+    /**
+     * @required The type of this object, used as a discriminator. Always 'data' for a DataPart.
+     */
+    kind: KindSchema.refine((kind) => kind === "data").describe("The type of this object, used as a discriminator. Always 'data' for a DataPart."),
+    /**
+     * @required The structured data content of the data part.
+     */
+    data: z
+        .record(z.string(), z.unknown())
+        .describe("The structured data content of the data part."),
+}).describe("Represents a structured data segment (e.g., JSON) within a message or artifact.");
+/**
+ * @description A discriminated union representing a part of a message or artifact, which can
+ * be text, a file, or structured data.
+ */
+export const PartSchema = z
+    .union([TextPartSchema, FilePartSchema, DataPartSchema])
+    .describe("A discriminated union representing a part of a message or artifact, which can be text, a file, or structured data.");
+/**
+ * @description Represents a file, data structure, or other resource generated by an agent during a task.
+ */
+export const ArtifactSchema = z
+    .object({
+    /**
+     * @required A unique identifier for the artifact within the scope of the task.
+     */
+    artifactId: z
+        .string()
+        .describe("A unique identifier for the artifact within the scope of the task."),
+    /**
+     * @optional A human-readable name for the artifact.
+     */
+    name: z
+        .string()
+        .optional()
+        .describe("A human-readable name for the artifact."),
+    /**
+     * @optional A human-readable description of the artifact.
+     */
+    description: z
+        .string()
+        .optional()
+        .describe("A human-readable description of the artifact."),
+    /**
+     * @optional An array of content parts that make up the artifact.
+     */
+    parts: z
+        .array(PartSchema)
+        .describe("An array of content parts that make up the artifact."),
+    /**
+     * @optional Optional metadata for extensions. The key is an extension-specific identifier.
+     */
+    metadata: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("Optional metadata for extensions. The key is an extension-specific identifier."),
+    /**
+     * @optional The URIs of extensions that are relevant to this artifact.
+     */
+    extension: z
+        .array(z.string())
+        .optional()
+        .describe("The URIs of extensions that are relevant to this artifact."),
+})
+    .describe("Represents a file, data structure, or other resource generated by an agent during a task. It can be composed of multiple parts.");
+/**
+ * @description Represents the role of a message sender.
+ */
+export const MessageRoleSchema = z
+    .enum(["user", "agent"])
+    .describe("Identifies the sender of the message. `user` for the client, `agent` for the service.");
+/**
+ * @description Represents a single message in the conversation between a user and an agent.
+ */
+export const MessageSchema = z
+    .object({
+    /**
+     * @required Identifies the sender of the message. `user` for the client, `agent` for the service.
+     */
+    role: MessageRoleSchema.describe("Identifies the sender of the message. `user` for the client, `agent` for the service."),
+    /**
+     * @required An array of content parts that form the message body. A message can be
+     * composed of multiple parts of different types (e.g., text and files).
+     */
+    parts: z
+        .array(PartSchema)
+        .describe("An array of content parts that form the message body. A message can be composed of multiple parts of different types (e.g., text and files)."),
+    /**
+     * @optional Optional metadata for extensions. The key is an extension-specific identifier.
+     */
+    metadata: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("Optional metadata for extensions. The key is an extension-specific identifier."),
+    /**
+     * @optional The URIs of extensions that are relevant to this message.
+     */
+    extensions: z
+        .array(z.string())
+        .optional()
+        .describe("The URIs of extensions that are relevant to this message."),
+    /**
+     * @optional A list of other task IDs that this message references for additional context.
+     */
+    referenceTaskIds: z
+        .array(z.string())
+        .optional()
+        .describe("A list of other task IDs that this message references for additional context."),
+    /**
+     * @required A unique identifier for the message, typically a UUID, generated by the sender.
+     */
+    messageId: z
+        .string()
+        .describe("A unique identifier for the message, typically a UUID, generated by the sender."),
+    /**
+     * @optional The identifier of the task this message is part of. Can be omitted for the first message of a new task.
+     */
+    taskId: z
+        .string()
+        .optional()
+        .describe("The identifier of the task this message is part of. Can be omitted for the first message of a new task."),
+    /**
+     * @optional The context identifier for this message, used to group related interactions.
+     */
+    contextId: z
+        .string()
+        .optional()
+        .describe("The context identifier for this message, used to group related interactions."),
+    /**
+     * @required The type of this object, used as a discriminator. Always 'message' for a Message.
+     */
+    kind: KindSchema.refine((kind) => kind === "message").describe("The type of this object, used as a discriminator. Always 'message' for a Message."),
+})
+    .describe("Represents a single message in the conversation between a user and an agent.");
 //# sourceMappingURL=parameters.js.map

package/dist/types/schemas/a2a/parameters.js.map

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

package/dist/types/schemas/a2a/protocol.js

@@ -0,0 +1,60 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from "zod";
+import { SendMessageRequestSchema, SendMessageResponseSchema, SendStreamingMessageRequestSchema, SendStreamingMessageResponseSchema, } from "./message.js";
+import { GetTaskRequestSchema, GetTaskResponseSchema, CancelTaskRequestSchema, CancelTaskResponseSchema, TaskResubscriptionRequestSchema, } from "./task.js";
+import { SetTaskPushNotificationConfigRequestSchema, SetTaskPushNotificationConfigResponseSchema, GetTaskPushNotificationConfigRequestSchema, GetTaskPushNotificationConfigResponseSchema, DeleteTaskPushNotificationConfigRequestSchema, ListTaskPushNotificationConfigRequestSchema, DeleteTaskPushNotificationConfigResponseSchema, ListTaskPushNotificationConfigResponseSchema, } from "./notification.js";
+import { GetAuthenticatedExtendedCardRequestSchema, GetAuthenticatedExtendedCardResponseSchema, } from "./agent.js";
+import { JSONRPCSuccessResponseSchema, JSONRPCErrorResponseSchema, } from "./rpc.js";
+/**
+ * @description Union of all valid A2A request types defined in the protocol.
+ * @description Represents any valid JSON-RPC request defined in the A2A protocol.
+ */
+export const A2ARequestSchema = z.union([
+    SendMessageRequestSchema,
+    SendStreamingMessageRequestSchema,
+    TaskResubscriptionRequestSchema,
+    GetTaskRequestSchema,
+    CancelTaskRequestSchema,
+    SetTaskPushNotificationConfigRequestSchema,
+    GetTaskPushNotificationConfigRequestSchema,
+    ListTaskPushNotificationConfigRequestSchema,
+    DeleteTaskPushNotificationConfigRequestSchema,
+    GetAuthenticatedExtendedCardRequestSchema,
+]);
+/**
+ * @description Union of all valid A2A response types defined in the protocol.
+ * @description Represents any valid JSON-RPC response defined in the A2A protocol.
+ * (This is a helper type, not explicitly defined with `oneOf` in the spec like A2ARequest, but useful).
+ */
+export const A2AResponseSchema = z.union([
+    SendMessageResponseSchema,
+    SendStreamingMessageResponseSchema,
+    GetTaskResponseSchema,
+    CancelTaskResponseSchema,
+    SetTaskPushNotificationConfigResponseSchema,
+    GetTaskPushNotificationConfigResponseSchema,
+    ListTaskPushNotificationConfigResponseSchema,
+    DeleteTaskPushNotificationConfigResponseSchema,
+    GetAuthenticatedExtendedCardResponseSchema,
+]);
+/**
+ * @description Represents a JSON-RPC response object.
+ */
+export const JSONRPCResponseSchema = z
+    .union([
+    A2AResponseSchema,
+    JSONRPCSuccessResponseSchema.extend({
+        result: z.any(),
+    }),
+    JSONRPCErrorResponseSchema.extend({
+        error: z.any(),
+    }),
+])
+    .describe("Represents a JSON-RPC response object.");
+// // Re-export A2AError from error.js for convenience
+// export { A2AErrorSchema } from "./error.js";
+// export type { A2AError } from "./error.js";
+//# sourceMappingURL=protocol.js.map

package/dist/types/schemas/a2a/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../../src/types/schemas/a2a/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,0CAA0C,EAC1C,2CAA2C,EAC3C,0CAA0C,EAC1C,2CAA2C,EAC3C,6CAA6C,EAC7C,2CAA2C,EAC3C,8CAA8C,EAC9C,4CAA4C,GAC7C,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yCAAyC,EACzC,0CAA0C,GAC3C,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC;IACtC,wBAAwB;IACxB,iCAAiC;IACjC,+BAA+B;IAC/B,oBAAoB;IACpB,uBAAuB;IACvB,0CAA0C;IAC1C,0CAA0C;IAC1C,2CAA2C;IAC3C,6CAA6C;IAC7C,yCAAyC;CAC1C,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC;IACvC,yBAAyB;IACzB,kCAAkC;IAClC,qBAAqB;IACrB,wBAAwB;IACxB,2CAA2C;IAC3C,2CAA2C;IAC3C,4CAA4C;IAC5C,8CAA8C;IAC9C,0CAA0C;CAC3C,CAAC,CAAC;AACH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,KAAK,CAAC;IACL,iBAAiB;IACjB,4BAA4B,CAAC,MAAM,CAAC;QAClC,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE;KAChB,CAAC;IACF,0BAA0B,CAAC,MAAM,CAAC;QAChC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE;KACf,CAAC;CACH,CAAC;KACD,QAAQ,CAAC,wCAAwC,CAAC,CAAC;AAMtD,sDAAsD;AACtD,+CAA+C;AAC/C,8CAA8C"}

package/dist/types/schemas/a2a/rpc.js

@@ -1,2 +1,127 @@
-export {};
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from "zod";
+/**
+ * @description Base interface for all JSON-RPC messages (Requests and Responses).
+ */
+export const JSONRPCMessageSchema = z
+    .object({
+    /**
+     * @required Specifies the JSON-RPC version. Must be "2.0".
+     * @default "2.0"
+     * @const "2.0"
+     */
+    jsonrpc: z
+        .literal("2.0")
+        .describe("Specifies the JSON-RPC version. Must be '2.0'."),
+    /**
+     * @optional An identifier established by the Client that MUST contain a String, Number.
+     * @description Can be a string, number. Responses must have the same ID as the request they relate to.
+     * Notifications (requests without an expected response) should omit the ID.
+     */
+    id: z
+        .union([z.string(), z.number()])
+        .optional()
+        .describe("An identifier established by the Client that MUST contain a String, Number. Responses must have the same ID as the request they relate to. Notifications (requests without an expected response) should omit the ID."),
+})
+    .describe("Base interface for all JSON-RPC messages (Requests and Responses).");
+/**
+ * @description Represents a JSON-RPC request object base structure.
+ */
+export const JSONRPCRequestSchema = JSONRPCMessageSchema.extend({
+    /**
+     * @required Request identifier.
+     */
+    id: z
+        .union([z.string(), z.number()])
+        .describe("Request identifier. Must be a String, Number, or NULL. The value MUST remain the same throughout the request."),
+    /**
+     * @required A string containing the name of the method to be invoked.
+     */
+    method: z
+        .string()
+        .describe("A String containing the name of the method to be invoked. Method names that begin with the word rpc are reserved and MUST NOT be used."),
+    /**
+     * @optional Parameters for the method. Can be a structured object, an array, or omitted.
+     * @description A Structured value that holds the parameter values to be used during the invocation of the method.
+     */
+    params: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("A Structured value that holds the parameter values to be used during the invocation of the method."),
+}).describe("Represents a JSON-RPC request object base structure.");
+// /**
+//  * @description Represents a JSON-RPC request object with parameters.
+//  */
+// export const JSONRPCRequestWithParamsSchema = JSONRPCRequestSchema.extend({
+//   params: z.unknown(),
+// });
+// export type JSONRPCRequestWithParams = z.infer<
+//   typeof JSONRPCRequestWithParamsSchema
+// >;
+/**
+ * @description Represents a JSON-RPC 2.0 Error object, included in an error response.
+ */
+export const JSONRPCErrorSchema = z
+    .object({
+    /**
+     * @required A number indicating the error type that occurred.
+     */
+    code: z
+        .number()
+        .describe("A Number indicating the error type that occurred. This MUST be an integer."),
+    /**
+     * @required A string providing a short description of the error.
+     */
+    message: z
+        .string()
+        .describe("A String providing a short description of the error. The message SHOULD be limited to a concise single sentence."),
+    /**
+     * @optional A Primitive or Structured value that contains additional information about the error.
+     */
+    data: z
+        .unknown()
+        .optional()
+        .describe("A Primitive or Structured value that contains additional information about the error."),
+})
+    .describe("Represents a JSON-RPC 2.0 Error object, included in an error response.");
+/**
+ * @description Represents a JSON-RPC 2.0 Success Response object.
+ */
+export const JSONRPCSuccessResponseSchema = JSONRPCMessageSchema.extend({
+    /**
+     * @required The result object on success
+     * @description The value of this member is determined by the method invoked on the Server.
+     */
+    result: z
+        .unknown()
+        .describe("The value of this member is determined by the method invoked on the Server."),
+    /**
+     * @optional The error object on failure
+     * @description Optional 'never' helps enforce exclusivity
+     */
+    error: z
+        .never()
+        .optional()
+        .describe("Optional 'never' helps enforce exclusivity"),
+}).describe("Represents a JSON-RPC 2.0 Success Response object.");
+/**
+ * @description Represents a JSON-RPC 2.0 Error Response object.
+ */
+export const JSONRPCErrorResponseSchema = JSONRPCMessageSchema.extend({
+    /**
+     * @optional The result object on success
+     * @description Optional 'never' helps enforce exclusivity
+     */
+    result: z
+        .never()
+        .optional()
+        .describe("Optional 'never' helps enforce exclusivity"),
+    /**
+     * @required The result object on failure
+     */
+    error: JSONRPCErrorSchema.extend({}).describe("Represents a JSON-RPC 2.0 Error Response object."),
+}).describe("Represents a JSON-RPC 2.0 Error Response object.");
 //# sourceMappingURL=rpc.js.map