@artinet/sdk 0.5.16 → 0.5.18

package/dist/services/a2a/methods/send-message.js

@@ -3,6 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { createContext } from "../factory/context.js";
+import { getLatestHistory } from "../helpers/index.js";
 export async function sendMessage(input, params) {
     const { service, engine, contextManager, signal } = params;
     const contextId = input.message.contextId;
@@ -13,7 +14,23 @@ export async function sendMessage(input, params) {
     context.events.on("error", () => {
         context.events.onComplete();
     });
+    if (input.configuration?.blocking === false) {
+        const result = await Promise.race([
+            service.execute(engine, context).then(() => {
+                const state = context.events.getState();
+                return state.task ?? state;
+            }),
+            new Promise((resolve) => {
+                context.events.on("start", (_, state) => {
+                    resolve(state.task ?? state);
+                });
+            }),
+        ]);
+        return result;
+    }
     await service.execute(engine, context);
     const state = context.events.getState();
-    return state.task ?? state;
+    const task = state.task ?? state;
+    task.history = getLatestHistory(task, input.configuration?.historyLength);
+    return task;
 }

package/dist/services/a2a/service.d.ts

@@ -12,7 +12,8 @@ export declare class A2AService implements A2AServiceInterface {
     private contexts;
     private methods;
     readonly eventOverrides: EventManagerOptions<Command, State, Update> | undefined;
-    constructor(agentCard: AgentCard, engine: A2AEngine, contexts: ContextManagerInterface<Command, State, Update>, connections: ConnectionManagerInterface, cancellations: CancellationManagerInterface, tasks: TaskManagerInterface<TaskAndHistory>, methods: MethodOptions, eventOverrides?: EventManagerOptions<Command, State, Update>);
+    private enforceParamValidation;
+    constructor(agentCard: AgentCard, engine: A2AEngine, contexts: ContextManagerInterface<Command, State, Update>, connections: ConnectionManagerInterface, cancellations: CancellationManagerInterface, tasks: TaskManagerInterface<TaskAndHistory>, methods: MethodOptions, eventOverrides?: EventManagerOptions<Command, State, Update>, enforceParamValidation?: boolean);
     execute(engine: A2AEngine, context: CoreContext<Command, State, Update>): Promise<void>;
     stop(): Promise<void>;
     addConnection(id: string): void;
@@ -32,101 +33,101 @@ export declare class A2AService implements A2AServiceInterface {
                 parts: ({
                     file: {
                         bytes: string;
-                        name?: string | null | undefined;
-                        mimeType?: string | null | undefined;
-                        uri?: null | undefined;
+                        name?: string | undefined;
+                        mimeType?: string | undefined;
+                        uri?: undefined;
                     } | {
                         uri: string;
-                        name?: string | null | undefined;
-                        bytes?: null | undefined;
-                        mimeType?: string | null | undefined;
+                        name?: string | undefined;
+                        bytes?: undefined;
+                        mimeType?: string | undefined;
                     };
                     kind: "file";
-                    metadata?: Record<string, unknown> | null | undefined;
+                    metadata?: Record<string, unknown> | undefined;
                 } | {
                     text: string;
                     kind: "text";
-                    metadata?: Record<string, unknown> | null | undefined;
+                    metadata?: Record<string, unknown> | undefined;
                 } | {
                     data: Record<string, unknown>;
                     kind: "data";
-                    metadata?: Record<string, unknown> | null | undefined;
+                    metadata?: Record<string, unknown> | undefined;
                 })[];
                 messageId: string;
-                metadata?: Record<string, unknown> | null | undefined;
-                extensions?: string[] | null | undefined;
-                referenceTaskIds?: string[] | null | undefined;
-                taskId?: string | null | undefined;
-                contextId?: string | null | undefined;
-            } | null | undefined;
-            timestamp?: string | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                extensions?: string[] | undefined;
+                referenceTaskIds?: string[] | undefined;
+                taskId?: string | undefined;
+                contextId?: string | undefined;
+            } | undefined;
+            timestamp?: string | undefined;
         };
         kind: "task";
         contextId: string;
-        metadata?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | undefined;
         history?: {
             role: "user" | "agent";
             kind: "message";
             parts: ({
                 file: {
                     bytes: string;
-                    name?: string | null | undefined;
-                    mimeType?: string | null | undefined;
-                    uri?: null | undefined;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    uri?: undefined;
                 } | {
                     uri: string;
-                    name?: string | null | undefined;
-                    bytes?: null | undefined;
-                    mimeType?: string | null | undefined;
+                    name?: string | undefined;
+                    bytes?: undefined;
+                    mimeType?: string | undefined;
                 };
                 kind: "file";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 text: string;
                 kind: "text";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 data: Record<string, unknown>;
                 kind: "data";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             })[];
             messageId: string;
-            metadata?: Record<string, unknown> | null | undefined;
-            extensions?: string[] | null | undefined;
-            referenceTaskIds?: string[] | null | undefined;
-            taskId?: string | null | undefined;
-            contextId?: string | null | undefined;
-        }[] | null | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            extensions?: string[] | undefined;
+            referenceTaskIds?: string[] | undefined;
+            taskId?: string | undefined;
+            contextId?: string | undefined;
+        }[] | undefined;
         artifacts?: {
             artifactId: string;
             parts: ({
                 file: {
                     bytes: string;
-                    name?: string | null | undefined;
-                    mimeType?: string | null | undefined;
-                    uri?: null | undefined;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    uri?: undefined;
                 } | {
                     uri: string;
-                    name?: string | null | undefined;
-                    bytes?: null | undefined;
-                    mimeType?: string | null | undefined;
+                    name?: string | undefined;
+                    bytes?: undefined;
+                    mimeType?: string | undefined;
                 };
                 kind: "file";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 text: string;
                 kind: "text";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 data: Record<string, unknown>;
                 kind: "data";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             })[];
-            name?: string | null | undefined;
-            metadata?: Record<string, unknown> | null | undefined;
-            description?: string | null | undefined;
-            extension?: string[] | null | undefined;
-        }[] | null | undefined;
+            name?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            description?: string | undefined;
+            extension?: string[] | undefined;
+        }[] | undefined;
     }>;
     cancelTask(input: TaskIdParams): Promise<{
         id: string;
@@ -138,101 +139,101 @@ export declare class A2AService implements A2AServiceInterface {
                 parts: ({
                     file: {
                         bytes: string;
-                        name?: string | null | undefined;
-                        mimeType?: string | null | undefined;
-                        uri?: null | undefined;
+                        name?: string | undefined;
+                        mimeType?: string | undefined;
+                        uri?: undefined;
                     } | {
                         uri: string;
-                        name?: string | null | undefined;
-                        bytes?: null | undefined;
-                        mimeType?: string | null | undefined;
+                        name?: string | undefined;
+                        bytes?: undefined;
+                        mimeType?: string | undefined;
                     };
                     kind: "file";
-                    metadata?: Record<string, unknown> | null | undefined;
+                    metadata?: Record<string, unknown> | undefined;
                 } | {
                     text: string;
                     kind: "text";
-                    metadata?: Record<string, unknown> | null | undefined;
+                    metadata?: Record<string, unknown> | undefined;
                 } | {
                     data: Record<string, unknown>;
                     kind: "data";
-                    metadata?: Record<string, unknown> | null | undefined;
+                    metadata?: Record<string, unknown> | undefined;
                 })[];
                 messageId: string;
-                metadata?: Record<string, unknown> | null | undefined;
-                extensions?: string[] | null | undefined;
-                referenceTaskIds?: string[] | null | undefined;
-                taskId?: string | null | undefined;
-                contextId?: string | null | undefined;
-            } | null | undefined;
-            timestamp?: string | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                extensions?: string[] | undefined;
+                referenceTaskIds?: string[] | undefined;
+                taskId?: string | undefined;
+                contextId?: string | undefined;
+            } | undefined;
+            timestamp?: string | undefined;
         };
         kind: "task";
         contextId: string;
-        metadata?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | undefined;
         history?: {
             role: "user" | "agent";
             kind: "message";
             parts: ({
                 file: {
                     bytes: string;
-                    name?: string | null | undefined;
-                    mimeType?: string | null | undefined;
-                    uri?: null | undefined;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    uri?: undefined;
                 } | {
                     uri: string;
-                    name?: string | null | undefined;
-                    bytes?: null | undefined;
-                    mimeType?: string | null | undefined;
+                    name?: string | undefined;
+                    bytes?: undefined;
+                    mimeType?: string | undefined;
                 };
                 kind: "file";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 text: string;
                 kind: "text";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 data: Record<string, unknown>;
                 kind: "data";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             })[];
             messageId: string;
-            metadata?: Record<string, unknown> | null | undefined;
-            extensions?: string[] | null | undefined;
-            referenceTaskIds?: string[] | null | undefined;
-            taskId?: string | null | undefined;
-            contextId?: string | null | undefined;
-        }[] | null | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            extensions?: string[] | undefined;
+            referenceTaskIds?: string[] | undefined;
+            taskId?: string | undefined;
+            contextId?: string | undefined;
+        }[] | undefined;
         artifacts?: {
             artifactId: string;
             parts: ({
                 file: {
                     bytes: string;
-                    name?: string | null | undefined;
-                    mimeType?: string | null | undefined;
-                    uri?: null | undefined;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    uri?: undefined;
                 } | {
                     uri: string;
-                    name?: string | null | undefined;
-                    bytes?: null | undefined;
-                    mimeType?: string | null | undefined;
+                    name?: string | undefined;
+                    bytes?: undefined;
+                    mimeType?: string | undefined;
                 };
                 kind: "file";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 text: string;
                 kind: "text";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 data: Record<string, unknown>;
                 kind: "data";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             })[];
-            name?: string | null | undefined;
-            metadata?: Record<string, unknown> | null | undefined;
-            description?: string | null | undefined;
-            extension?: string[] | null | undefined;
-        }[] | null | undefined;
+            name?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            description?: string | undefined;
+            extension?: string[] | undefined;
+        }[] | undefined;
     }>;
     sendMessage(message: MessageSendParams | string, params?: Partial<Omit<MethodParams, "service" | "contextManager">>): Promise<{
         role: "user" | "agent";
@@ -240,32 +241,32 @@ export declare class A2AService implements A2AServiceInterface {
         parts: ({
             file: {
                 bytes: string;
-                name?: string | null | undefined;
-                mimeType?: string | null | undefined;
-                uri?: null | undefined;
+                name?: string | undefined;
+                mimeType?: string | undefined;
+                uri?: undefined;
             } | {
                 uri: string;
-                name?: string | null | undefined;
-                bytes?: null | undefined;
-                mimeType?: string | null | undefined;
+                name?: string | undefined;
+                bytes?: undefined;
+                mimeType?: string | undefined;
             };
             kind: "file";
-            metadata?: Record<string, unknown> | null | undefined;
+            metadata?: Record<string, unknown> | undefined;
         } | {
             text: string;
             kind: "text";
-            metadata?: Record<string, unknown> | null | undefined;
+            metadata?: Record<string, unknown> | undefined;
         } | {
             data: Record<string, unknown>;
             kind: "data";
-            metadata?: Record<string, unknown> | null | undefined;
+            metadata?: Record<string, unknown> | undefined;
         })[];
         messageId: string;
-        metadata?: Record<string, unknown> | null | undefined;
-        extensions?: string[] | null | undefined;
-        referenceTaskIds?: string[] | null | undefined;
-        taskId?: string | null | undefined;
-        contextId?: string | null | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        extensions?: string[] | undefined;
+        referenceTaskIds?: string[] | undefined;
+        taskId?: string | undefined;
+        contextId?: string | undefined;
     } | {
         id: string;
         status: {
@@ -276,101 +277,101 @@ export declare class A2AService implements A2AServiceInterface {
                 parts: ({
                     file: {
                         bytes: string;
-                        name?: string | null | undefined;
-                        mimeType?: string | null | undefined;
-                        uri?: null | undefined;
+                        name?: string | undefined;
+                        mimeType?: string | undefined;
+                        uri?: undefined;
                     } | {
                         uri: string;
-                        name?: string | null | undefined;
-                        bytes?: null | undefined;
-                        mimeType?: string | null | undefined;
+                        name?: string | undefined;
+                        bytes?: undefined;
+                        mimeType?: string | undefined;
                     };
                     kind: "file";
-                    metadata?: Record<string, unknown> | null | undefined;
+                    metadata?: Record<string, unknown> | undefined;
                 } | {
                     text: string;
                     kind: "text";
-                    metadata?: Record<string, unknown> | null | undefined;
+                    metadata?: Record<string, unknown> | undefined;
                 } | {
                     data: Record<string, unknown>;
                     kind: "data";
-                    metadata?: Record<string, unknown> | null | undefined;
+                    metadata?: Record<string, unknown> | undefined;
                 })[];
                 messageId: string;
-                metadata?: Record<string, unknown> | null | undefined;
-                extensions?: string[] | null | undefined;
-                referenceTaskIds?: string[] | null | undefined;
-                taskId?: string | null | undefined;
-                contextId?: string | null | undefined;
-            } | null | undefined;
-            timestamp?: string | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                extensions?: string[] | undefined;
+                referenceTaskIds?: string[] | undefined;
+                taskId?: string | undefined;
+                contextId?: string | undefined;
+            } | undefined;
+            timestamp?: string | undefined;
         };
         kind: "task";
         contextId: string;
-        metadata?: Record<string, unknown> | null | undefined;
+        metadata?: Record<string, unknown> | undefined;
         history?: {
             role: "user" | "agent";
             kind: "message";
             parts: ({
                 file: {
                     bytes: string;
-                    name?: string | null | undefined;
-                    mimeType?: string | null | undefined;
-                    uri?: null | undefined;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    uri?: undefined;
                 } | {
                     uri: string;
-                    name?: string | null | undefined;
-                    bytes?: null | undefined;
-                    mimeType?: string | null | undefined;
+                    name?: string | undefined;
+                    bytes?: undefined;
+                    mimeType?: string | undefined;
                 };
                 kind: "file";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 text: string;
                 kind: "text";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 data: Record<string, unknown>;
                 kind: "data";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             })[];
             messageId: string;
-            metadata?: Record<string, unknown> | null | undefined;
-            extensions?: string[] | null | undefined;
-            referenceTaskIds?: string[] | null | undefined;
-            taskId?: string | null | undefined;
-            contextId?: string | null | undefined;
-        }[] | null | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            extensions?: string[] | undefined;
+            referenceTaskIds?: string[] | undefined;
+            taskId?: string | undefined;
+            contextId?: string | undefined;
+        }[] | undefined;
         artifacts?: {
             artifactId: string;
             parts: ({
                 file: {
                     bytes: string;
-                    name?: string | null | undefined;
-                    mimeType?: string | null | undefined;
-                    uri?: null | undefined;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    uri?: undefined;
                 } | {
                     uri: string;
-                    name?: string | null | undefined;
-                    bytes?: null | undefined;
-                    mimeType?: string | null | undefined;
+                    name?: string | undefined;
+                    bytes?: undefined;
+                    mimeType?: string | undefined;
                 };
                 kind: "file";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 text: string;
                 kind: "text";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             } | {
                 data: Record<string, unknown>;
                 kind: "data";
-                metadata?: Record<string, unknown> | null | undefined;
+                metadata?: Record<string, unknown> | undefined;
             })[];
-            name?: string | null | undefined;
-            metadata?: Record<string, unknown> | null | undefined;
-            description?: string | null | undefined;
-            extension?: string[] | null | undefined;
-        }[] | null | undefined;
+            name?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            description?: string | undefined;
+            extension?: string[] | undefined;
+        }[] | undefined;
     }>;
     streamMessage(message: MessageSendParams | string, params?: Partial<Omit<MethodParams, "service" | "contextManager">>): AsyncGenerator<import("../../types/index.js").UpdateEvent, void, any>;
     resubscribe(input: TaskIdParams, params?: Partial<Omit<MethodParams, "service" | "contextManager">>): AsyncGenerator<import("../../types/index.js").UpdateEvent, void, any>;

package/dist/services/a2a/service.js

@@ -2,8 +2,10 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
+import { MessageSendParamsSchema, TaskQueryParamsSchema, TaskIdParamsSchema, } from "../../types/index.js";
 import { coreExecute } from "../core/execution/execute.js";
 import { createMessageSendParams } from "./helpers/message-builder.js";
+import { validateSchema } from "../../utils/common/schema-validation.js";
 export class A2AService {
     agentCard;
     engine;
@@ -13,7 +15,8 @@ export class A2AService {
     contexts;
     methods;
     eventOverrides;
-    constructor(agentCard, engine, contexts, connections, cancellations, tasks, methods, eventOverrides) {
+    enforceParamValidation = false;
+    constructor(agentCard, engine, contexts, connections, cancellations, tasks, methods, eventOverrides, enforceParamValidation = false) {
         this.engine = engine;
         this.agentCard = agentCard;
         this.contexts = contexts;
@@ -22,6 +25,7 @@ export class A2AService {
         this.tasks = tasks;
         this.methods = methods;
         this.eventOverrides = eventOverrides;
+        this.enforceParamValidation = enforceParamValidation;
     }
     async execute(engine, context) {
         await coreExecute(engine ?? this.engine, context);
@@ -55,16 +59,22 @@ export class A2AService {
         await this.tasks.setState(id, data);
     }
     async getTask(input) {
-        return await this.methods.getTask(input, { service: this });
+        return await this.methods.getTask(this.enforceParamValidation
+            ? await validateSchema(TaskQueryParamsSchema, input)
+            : input, { service: this });
     }
     async cancelTask(input) {
-        return await this.methods.cancelTask(input, {
+        return await this.methods.cancelTask(this.enforceParamValidation
+            ? await validateSchema(TaskIdParamsSchema, input)
+            : input, {
             service: this,
             contextManager: this.contexts,
         });
     }
     async sendMessage(message, params) {
-        return await this.methods.sendMessage(createMessageSendParams(message), {
+        return await this.methods.sendMessage(this.enforceParamValidation
+            ? await validateSchema(MessageSendParamsSchema, message)
+            : createMessageSendParams(message), {
             ...params, //we may include additional params in the future that may not need to be handled by the service
             service: this,
             engine: params?.engine ?? this.engine,
@@ -73,7 +83,9 @@ export class A2AService {
         });
     }
     async *streamMessage(message, params) {
-        yield* this.methods.streamMessage(createMessageSendParams(message), {
+        yield* this.methods.streamMessage(this.enforceParamValidation
+            ? await validateSchema(MessageSendParamsSchema, message)
+            : createMessageSendParams(message), {
             ...params,
             service: this,
             engine: params?.engine ?? this.engine,
@@ -82,7 +94,9 @@ export class A2AService {
         });
     }
     async *resubscribe(input, params) {
-        yield* this.methods.resubscribe(input, {
+        yield* this.methods.resubscribe(this.enforceParamValidation
+            ? await validateSchema(TaskIdParamsSchema, input)
+            : input, {
             ...params,
             service: this,
             engine: params?.engine ?? this.engine,

package/dist/services/mcp/service.js

@@ -61,7 +61,6 @@ export class BaseMCPService extends McpServer {
         this.registerResource("agent-card", uri, {
             title: "Agent Card",
             description: AgentCardSchema.description,
-            outputSchema: AgentCardSchema.shape,
             mimeType: "application/json",
         }, async (uri) => {
             return {

package/dist/transport/rpc/parser.js

@@ -3,8 +3,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { JSONRPCErrorSchema, } from "../../types/index.js";
-import { SystemError, PARSE_ERROR } from "../../utils/index.js";
-import { logError } from "../../utils/logging/index.js";
+import { SystemError, PARSE_ERROR } from "../../utils/common/errors.js";
+import { logError } from "../../utils/logging/log.js";
 /**
  * Parses a JSON-RPC response string and validates its structure.
  * If the response contains an error, it is thrown as an A2AError.

package/dist/transport/rpc/rpc-client.js

@@ -7,9 +7,9 @@
  * Handles the common pattern of sending JSON-RPC requests and processing responses.
  */
 import { v4 as uuidv4 } from "uuid";
-import { SystemError, INTERNAL_ERROR, PARSE_ERROR } from "../../utils/index.js";
+import { SystemError, INTERNAL_ERROR, PARSE_ERROR, } from "../../utils/common/errors.js";
 import { parseResponse } from "./parser.js";
-import { logError, logWarn } from "../../utils/logging/index.js";
+import { logError, logWarn } from "../../utils/logging/log.js";
 /**
  * Creates a JSON-RPC request body with the specified method and parameters.
  *, ErrorCodeParseError