@artinet/sdk 0.5.4 → 0.5.6

package/dist/types/transport/trpc/a2a/trpc.d.ts

@@ -0,0 +1,272 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { A2AServiceInterface, Command, ExecutionEnvironment, State, Update } from "../../../types/index.js";
+export interface A2AExecutionEnvironment<TCommand extends Command = Command, TState extends State = State, TUpdate extends Update = Update> extends ExecutionEnvironment<TCommand, TState, TUpdate> {
+    /**
+     * The service is the main interface for the A2A protocol.
+     * It is used to send messages, get tasks, and cancel tasks.
+     * In the future, we may want to dynamically change the service based on the path.
+     * (e.g. multiple services for different paths/agents. an MCP Service. a factory function. etc.)
+     */
+    service: A2AServiceInterface<TCommand, TState, TUpdate>;
+}
+export declare const router: import("@trpc/server").TRPCRouterBuilder<{
+    ctx: A2AExecutionEnvironment<{
+        message: {
+            role: "user" | "agent";
+            parts: ({
+                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+                file: {
+                    bytes: string;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    uri?: undefined;
+                } | {
+                    uri: string;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    bytes?: undefined;
+                };
+                metadata?: Record<string, unknown> | undefined;
+            } | {
+                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+                text: string;
+                metadata?: Record<string, unknown> | undefined;
+            } | {
+                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+                data: Record<string, unknown>;
+                metadata?: Record<string, unknown> | undefined;
+            })[];
+            messageId: string;
+            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+            metadata?: Record<string, unknown> | undefined;
+            extensions?: string[] | undefined;
+            referenceTaskIds?: string[] | undefined;
+            taskId?: string | undefined;
+            contextId?: string | undefined;
+        };
+        configuration?: {
+            acceptedOutputModes?: string[] | undefined;
+            historyLength?: number | undefined;
+            pushNotificationConfig?: {
+                url: string;
+                id?: string | undefined;
+                token?: string | undefined;
+                authentication?: {
+                    schemes: string[];
+                    credentials?: string | undefined;
+                } | undefined;
+            } | undefined;
+            blocking?: boolean | undefined;
+        } | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }, import("../../../types/index.js").TaskAndHistory, import("../../../types/index.js").UpdateEvent>;
+    meta: object;
+    errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+    transformer: false;
+}>;
+export declare const publicProcedure: import("@trpc/server").TRPCProcedureBuilder<A2AExecutionEnvironment<{
+    message: {
+        role: "user" | "agent";
+        parts: ({
+            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+            file: {
+                bytes: string;
+                name?: string | undefined;
+                mimeType?: string | undefined;
+                uri?: undefined;
+            } | {
+                uri: string;
+                name?: string | undefined;
+                mimeType?: string | undefined;
+                bytes?: undefined;
+            };
+            metadata?: Record<string, unknown> | undefined;
+        } | {
+            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+            text: string;
+            metadata?: Record<string, unknown> | undefined;
+        } | {
+            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+            data: Record<string, unknown>;
+            metadata?: Record<string, unknown> | undefined;
+        })[];
+        messageId: string;
+        kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+        metadata?: Record<string, unknown> | undefined;
+        extensions?: string[] | undefined;
+        referenceTaskIds?: string[] | undefined;
+        taskId?: string | undefined;
+        contextId?: string | undefined;
+    };
+    configuration?: {
+        acceptedOutputModes?: string[] | undefined;
+        historyLength?: number | undefined;
+        pushNotificationConfig?: {
+            url: string;
+            id?: string | undefined;
+            token?: string | undefined;
+            authentication?: {
+                schemes: string[];
+                credentials?: string | undefined;
+            } | undefined;
+        } | undefined;
+        blocking?: boolean | undefined;
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, import("../../../types/index.js").TaskAndHistory, import("../../../types/index.js").UpdateEvent>, object, object, import("@trpc/server").TRPCUnsetMarker, import("@trpc/server").TRPCUnsetMarker, import("@trpc/server").TRPCUnsetMarker, import("@trpc/server").TRPCUnsetMarker, false>;
+export declare const createA2AEnviroment: (opts: any) => any;
+export declare const A2AProcedure: import("@trpc/server").TRPCProcedureBuilder<A2AExecutionEnvironment<{
+    message: {
+        role: "user" | "agent";
+        parts: ({
+            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+            file: {
+                bytes: string;
+                name?: string | undefined;
+                mimeType?: string | undefined;
+                uri?: undefined;
+            } | {
+                uri: string;
+                name?: string | undefined;
+                mimeType?: string | undefined;
+                bytes?: undefined;
+            };
+            metadata?: Record<string, unknown> | undefined;
+        } | {
+            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+            text: string;
+            metadata?: Record<string, unknown> | undefined;
+        } | {
+            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+            data: Record<string, unknown>;
+            metadata?: Record<string, unknown> | undefined;
+        })[];
+        messageId: string;
+        kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+        metadata?: Record<string, unknown> | undefined;
+        extensions?: string[] | undefined;
+        referenceTaskIds?: string[] | undefined;
+        taskId?: string | undefined;
+        contextId?: string | undefined;
+    };
+    configuration?: {
+        acceptedOutputModes?: string[] | undefined;
+        historyLength?: number | undefined;
+        pushNotificationConfig?: {
+            url: string;
+            id?: string | undefined;
+            token?: string | undefined;
+            authentication?: {
+                schemes: string[];
+                credentials?: string | undefined;
+            } | undefined;
+        } | undefined;
+        blocking?: boolean | undefined;
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, import("../../../types/index.js").TaskAndHistory, import("../../../types/index.js").UpdateEvent>, object, {
+    engine: import("../../../types/index.js").ExecutionEngine<{
+        message: {
+            role: "user" | "agent";
+            parts: ({
+                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+                file: {
+                    bytes: string;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    uri?: undefined;
+                } | {
+                    uri: string;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    bytes?: undefined;
+                };
+                metadata?: Record<string, unknown> | undefined;
+            } | {
+                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+                text: string;
+                metadata?: Record<string, unknown> | undefined;
+            } | {
+                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+                data: Record<string, unknown>;
+                metadata?: Record<string, unknown> | undefined;
+            })[];
+            messageId: string;
+            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+            metadata?: Record<string, unknown> | undefined;
+            extensions?: string[] | undefined;
+            referenceTaskIds?: string[] | undefined;
+            taskId?: string | undefined;
+            contextId?: string | undefined;
+        };
+        configuration?: {
+            acceptedOutputModes?: string[] | undefined;
+            historyLength?: number | undefined;
+            pushNotificationConfig?: {
+                url: string;
+                id?: string | undefined;
+                token?: string | undefined;
+                authentication?: {
+                    schemes: string[];
+                    credentials?: string | undefined;
+                } | undefined;
+            } | undefined;
+            blocking?: boolean | undefined;
+        } | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }, import("../../../types/index.js").TaskAndHistory, import("../../../types/index.js").UpdateEvent> | undefined;
+    service: A2AServiceInterface<{
+        message: {
+            role: "user" | "agent";
+            parts: ({
+                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+                file: {
+                    bytes: string;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    uri?: undefined;
+                } | {
+                    uri: string;
+                    name?: string | undefined;
+                    mimeType?: string | undefined;
+                    bytes?: undefined;
+                };
+                metadata?: Record<string, unknown> | undefined;
+            } | {
+                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+                text: string;
+                metadata?: Record<string, unknown> | undefined;
+            } | {
+                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+                data: Record<string, unknown>;
+                metadata?: Record<string, unknown> | undefined;
+            })[];
+            messageId: string;
+            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
+            metadata?: Record<string, unknown> | undefined;
+            extensions?: string[] | undefined;
+            referenceTaskIds?: string[] | undefined;
+            taskId?: string | undefined;
+            contextId?: string | undefined;
+        };
+        configuration?: {
+            acceptedOutputModes?: string[] | undefined;
+            historyLength?: number | undefined;
+            pushNotificationConfig?: {
+                url: string;
+                id?: string | undefined;
+                token?: string | undefined;
+                authentication?: {
+                    schemes: string[];
+                    credentials?: string | undefined;
+                } | undefined;
+            } | undefined;
+            blocking?: boolean | undefined;
+        } | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }, import("../../../types/index.js").TaskAndHistory, import("../../../types/index.js").UpdateEvent>;
+}, import("@trpc/server").TRPCUnsetMarker, import("@trpc/server").TRPCUnsetMarker, import("@trpc/server").TRPCUnsetMarker, import("@trpc/server").TRPCUnsetMarker, false>;
+//# sourceMappingURL=trpc.d.ts.map

package/dist/types/transport/trpc/a2a/trpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trpc.d.ts","sourceRoot":"","sources":["../../../../../src/transport/trpc/a2a/trpc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,mBAAmB,EACnB,OAAO,EACP,oBAAoB,EACpB,KAAK,EACL,MAAM,EACP,gCAAyB;AAE1B,MAAM,WAAW,uBAAuB,CACtC,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,MAAM,SAAS,KAAK,GAAG,KAAK,EAC5B,OAAO,SAAS,MAAM,GAAG,MAAM,CAC/B,SAAQ,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;IACvD;;;;;OAKG;IACH,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;CACzD;AAGD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAc,CAAC;AAClC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2RAAiB,CAAC;AAE9C,eAAO,MAAM,mBAAmB,GAAI,MAAM,GAAG,QAE5C,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yKAyBxB,CAAC"}

package/dist/types/transport/trpc/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./a2a/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/transport/trpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/transport/trpc/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/types/types/ext.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * For artinet specific conventions
+ * AgentInfo will expand to incorporate additional details required from other protocols
+ * (e.g. AgentFAQ(NANDA), AgentCard(A2A), etc.)
+ */
+export { AgentCardSchema as AgentInfoSchema } from "./schemas/a2a/index.js";
+export type { AgentCard as AgentInfo } from "./schemas/a2a/index.js";
+export type { A2AEngine as AgentEngine } from "./interfaces/services/a2a/index.js";
+export type { A2AServiceInterface as Agent } from "./interfaces/services/a2a/index.js";
+//# sourceMappingURL=ext.d.ts.map

package/dist/types/types/ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext.d.ts","sourceRoot":"","sources":["../../../src/types/ext.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,OAAO,EAAE,eAAe,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACnF,YAAY,EAAE,mBAAmB,IAAI,KAAK,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/types/types/index.d.ts

@@ -1,6 +1,5 @@
+export * from "./ext.js";
 export * from "./schemas/index.js";
-export * from "./extended-schema.js";
-export * from "./proxy.js";
-export * from "./services/context.js";
-export * from "./client.js";
+export * from "./interfaces/index.js";
+export * from "./utils/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/types/types/{client.d.ts → interfaces/client.d.ts}

@@ -1,5 +1,10 @@
-import { TaskPushNotificationConfig, TaskIdParams, Task } from "./extended-schema.js";
-import type { AgentCard, TaskQueryParams, MessageSendParams, Message, UpdateEvent } from "./extended-schema.js";
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TaskPushNotificationConfig, TaskIdParams, Task } from "../schemas/a2a/index.js";
+import type { AgentCard, TaskQueryParams, MessageSendParams, Message } from "../schemas/a2a/index.js";
+import { UpdateEvent } from "./services/a2a/index.js";
 /**
  * @interface Client
  * @description Defines the standard contract for an A2A (Agent-to-Agent) client implementation.

package/dist/types/types/interfaces/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/types/interfaces/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,0BAA0B,EAC1B,YAAY,EACZ,IAAI,EACL,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,OAAO,EACR,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;;;OAOG;IACH,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IAEvE;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IAEpE;;;;;;OAMG;IACH,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAE5E;;;;;;;OAOG;IACH,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAEvD;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAEvD;;;;;;;OAOG;IACH,uBAAuB,CACrB,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,uBAAuB,CACrB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;IAE9C;;;;;;OAMG;IACH,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAErE;;;;;OAKG;IACH,QAAQ,CACN,UAAU,EAAE,WAAW,GAAG,mBAAmB,GAAG,wBAAwB,GACvE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAElD;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7C;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,YAAY,IAAI,IAAI,CAAC;CACtB"}

package/dist/types/types/interfaces/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./services/index.js";
+export * from "./storage.js";
+export * from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/types/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/types/types/interfaces/services/a2a/builder.d.ts

@@ -0,0 +1,33 @@
+import { Context, Command, TextPart, DataPart, FilePart } from "../../../index.js";
+/**
+ * Restricting to command for now, but could be extended to other types of commands in the future.
+ * When we shift to CoreCommand, move this into core.
+ */
+export interface StepArgs<TCommand extends Command = Command> {
+    command: TCommand;
+}
+export type StepParams<TCommand extends Command = Command, TInboundArgs extends readonly unknown[] = []> = StepArgs<TCommand> & Partial<{
+    context: Context;
+    args: TInboundArgs;
+}>;
+export type StepOutput<TPart extends DataPart["data"] | FilePart["file"] | TextPart["text"]> = {
+    parts: Array<TPart> | TPart;
+};
+export type StepOutputWithForwardArgs<TPart extends DataPart["data"] | FilePart["file"] | TextPart["text"], TForwardArgs extends readonly unknown[] = []> = StepOutput<TPart> & {
+    args: TForwardArgs;
+};
+export type Step<TCommand extends Command = Command, TPart extends DataPart["data"] | FilePart["file"] | TextPart["text"] = TextPart["text"], TInboundArgs extends readonly unknown[] = [], TForwardArgs extends readonly unknown[] = [], TOutput extends StepOutput<TPart> | StepOutputWithForwardArgs<TPart, TForwardArgs> | Array<TPart> | TPart = StepOutput<TPart>> = (params: StepParams<TCommand, TInboundArgs>) => Promise<TOutput> | TOutput;
+export type StepWithKind<TCommand extends Command = Command, TPart extends DataPart["data"] | FilePart["file"] | TextPart["text"] = TextPart["text"], TInboundArgs extends readonly unknown[] = [], TForwardArgs extends readonly unknown[] = [], TOutput extends StepOutput<TPart> | StepOutputWithForwardArgs<TPart, TForwardArgs> | Array<TPart> | TPart = StepOutput<TPart>, TKind extends "text" | "file" | "data" = "text"> = {
+    step: Step<TCommand, TPart, TInboundArgs, TForwardArgs, TOutput>;
+    kind: TKind;
+};
+export type OutArgsOf<O> = O extends StepOutputWithForwardArgs<any, infer A> ? A : [];
+export interface StepBuilder<TCommand extends Command = Command, TInboundArgs extends readonly unknown[] = []> {
+    /**
+     * Add a step to the builder.
+     * @param step - The step to add.
+     * @returns A new builder with the step added.
+     */
+    addStep<TPart extends DataPart["data"] | FilePart["file"] | TextPart["text"] = TextPart["text"], TForwardArgs extends readonly unknown[] = [], TOutput extends StepOutput<TPart> | StepOutputWithForwardArgs<TPart, TForwardArgs> | Array<TPart> | TPart = StepOutput<TPart>, TKind extends "text" | "file" | "data" = "text">(step: StepWithKind<TCommand, TPart, TInboundArgs, TForwardArgs, TOutput, TKind>): StepBuilder<TCommand, OutArgsOf<TOutput>>;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/types/types/interfaces/services/a2a/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../../../src/types/interfaces/services/a2a/builder.ts"],"names":[],"mappings":"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"}

package/dist/types/types/interfaces/services/a2a/context.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview A2A (Agent-to-Agent) Context Type Definitions
+ *
+ * This module provides type definitions for the Agent-to-Agent communication context,
+ * extending the core context types with A2A-specific functionality for task handling,
+ * message processing, and event management.
+ *
+ * @module A2AContext
+ * @version 1.0.0
+ * @since 0.5.6
+ * @author The Artinet Project
+ */
+import { type TaskStatusUpdateEvent, type TaskArtifactUpdateEvent, type Task, type Message, A2ARequest, MessageSendParams } from "../../../schemas/a2a/index.js";
+import { CoreCommand, CoreState, CoreUpdate } from "../core/context/types.js";
+import { CoreContext } from "../core/context/context.js";
+import { TaskAndHistory } from "./legacy.js";
+/**
+ * Represents the possible types of updates that can be yielded by a TaskHandler.
+ *
+ * This union type encompasses all event types that can be emitted during A2A
+ * task processing, providing a type-safe way to handle different update scenarios.
+ *
+ * @description Either a Message, Task, TaskStatusUpdateEvent, or TaskArtifactUpdateEvent.
+ *
+ * @public
+ * @since 0.5.6
+ */
+export type UpdateEvent = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
+/**
+ * A2A Command type that extends CoreCommand with A2A-specific parameter constraints.
+ *
+ * This generic type provides type-safe command handling for A2A operations,
+ * ensuring that command parameters conform to the expected A2A request structure.
+ *
+ * @template TParams - The parameter type for the command, must extend A2ARequest params
+ * @default MessageSendParams - Default parameter type for message sending operations
+ *
+ * @example
+ * ```typescript
+ * // Using default MessageSendParams
+ * const messageCommand: Command = {
+ *   type: 'send_message',
+ *   params: { content: 'Hello', recipient: 'agent123' }
+ * };
+ *
+ * // Using custom parameter type
+ * interface CustomParams extends NonNullable<A2ARequest["params"]> {
+ *   customField: string;
+ * }
+ * const customCommand: Command<CustomParams> = {
+ *   type: 'custom_action',
+ *   params: { customField: 'value' }
+ * };
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export type Command<TParams extends NonNullable<A2ARequest["params"]> = MessageSendParams> = CoreCommand<TParams>;
+/**
+ * A2A State type that extends CoreState with task and history management.
+ *
+ * This type represents the state container for A2A operations, including
+ * task tracking and historical data management capabilities.
+ *
+ * @example
+ * ```typescript
+ * const state: State = {
+ *   data: {
+ *     currentTask: taskInstance,
+ *     history: [...previousTasks]
+ *   },
+ *   metadata: {
+ *     lastUpdated: new Date(),
+ *     version: '1.0.0'
+ *   }
+ * };
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export type State = CoreState<TaskAndHistory>;
+/**
+ * A2A Update type that extends CoreUpdate with A2A-specific update events.
+ *
+ * This generic type provides type-safe update handling for A2A operations,
+ * ensuring that updates conform to the expected UpdateEvent structure.
+ *
+ * @template TUpdate - The update event type, must extend UpdateEvent
+ * @default UpdateEvent - Default update event type
+ *
+ * @example
+ * ```typescript
+ * // Using default UpdateEvent
+ * const update: Update = {
+ *   type: 'task_status_update',
+ *   payload: statusUpdateEvent
+ * };
+ *
+ * // Using specific update type
+ * const messageUpdate: Update<Message> = {
+ *   type: 'message',
+ *   payload: messageEvent
+ * };
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export type Update<TUpdate extends UpdateEvent = UpdateEvent> = CoreUpdate<TUpdate>;
+/**
+ * A2A Context type that combines Command, State, and Update types for complete context management.
+ *
+ * This is the main context type for A2A operations, providing a comprehensive
+ * type-safe interface for handling commands, managing state, and processing updates
+ * within the Agent-to-Agent communication framework.
+ *
+ * @template TCommand - The command type, must extend Command
+ * @template TState - The state type, must extend State
+ * @template TUpdate - The update type, must extend Update<UpdateEvent>
+ *
+ * @default TCommand - Command<MessageSendParams>
+ * @default TState - State
+ * @default TUpdate - Update<UpdateEvent>
+ *
+ * @example
+ * ```typescript
+ * // Using default types
+ * const context: Context = {
+ *   command: messageCommand,
+ *   state: currentState,
+ *   update: latestUpdate,
+ *   // ... other context properties
+ * };
+ *
+ * // Using custom types
+ * interface CustomCommand extends Command<CustomParams> {
+ *   priority: number;
+ * }
+ *
+ * const customContext: Context<CustomCommand, State, Update<Task>> = {
+ *   command: customCommand,
+ *   state: currentState,
+ *   update: taskUpdate,
+ *   // ... other context properties
+ * };
+ * ```
+ *
+ * @remarks
+ * This context type is designed to be the primary interface for A2A service
+ * implementations, providing type safety and ensuring proper handling of
+ * agent-to-agent communication patterns.
+ *
+ * @public
+ * @since 0.5.6
+ */
+export type Context<TCommand extends Command = Command<MessageSendParams>, TState extends State = State, TUpdate extends Update<UpdateEvent> = Update<UpdateEvent>> = CoreContext<TCommand, TState, TUpdate>;
+//# sourceMappingURL=context.d.ts.map

package/dist/types/types/interfaces/services/a2a/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../../src/types/interfaces/services/a2a/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,IAAI,EACT,KAAK,OAAO,EACZ,UAAU,EACV,iBAAiB,EAClB,sCAAqC;AACtC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,IAAI,GACJ,qBAAqB,GACrB,uBAAuB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,OAAO,CACjB,OAAO,SAAS,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,iBAAiB,IACnE,WAAW,CAAC,OAAO,CAAC,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,MAAM,CAAC,OAAO,SAAS,WAAW,GAAG,WAAW,IAC1D,UAAU,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,MAAM,OAAO,CACjB,QAAQ,SAAS,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,EACrD,MAAM,SAAS,KAAK,GAAG,KAAK,EAC5B,OAAO,SAAS,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,IACvD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/types/types/interfaces/services/a2a/engine.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ExecutionEngine } from "../core/execution/index.js";
+import { Command, State, Update } from "./context.js";
+export type A2AEngine = ExecutionEngine<Command, State, Update>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/types/types/interfaces/services/a2a/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../../src/types/interfaces/services/a2a/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC"}

package/dist/types/types/interfaces/services/a2a/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./builder.js";
+export * from "./context.js";
+export * from "./engine.js";
+export * from "./legacy.js";
+export * from "./service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/types/interfaces/services/a2a/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/types/interfaces/services/a2a/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}