@artinet/sdk 0.5.4 → 0.5.6

package/dist/types/schemas/deployment/proxy.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=proxy.js.map

package/dist/types/schemas/deployment/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../../../src/types/schemas/deployment/proxy.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/schemas/deployment/request.js

@@ -0,0 +1,88 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from "zod/v4";
+import { JSONRPCErrorResponseSchema, JSONRPCRequestSchema, JSONRPCSuccessResponseSchema, AgentCardSchema, } from "../a2a/index.js";
+/**
+ * @description Represents the parameters for a server deployment request.
+ */
+export const ServerDeploymentRequestParamsSchema = z
+    .object({
+    /**
+     * @required The name of the server
+     */
+    name: z.string(),
+    /**
+     * @required The agent card of the server
+     */
+    agentCard: AgentCardSchema,
+    /**
+     * @required The minified code of the server
+     */
+    code: z.string(),
+    /**
+     * @optional The NPM dependencies of the server(currently unsupported)
+     */
+    dependencies: z.array(z.string()).optional(),
+})
+    .describe("Represents the parameters for a server deployment request.");
+/**
+ * @description Represents the base parameters for a server deployment response.
+ */
+export const BaseServerDeploymentResponseParamsSchema = z
+    .object({
+    /**
+     * @required The deployment ID(for full deployments the deployment ID is the same as the agent/registration ID)
+     */
+    deploymentId: z.string().describe("The deployment ID"),
+    /**
+     * @required Whether the deployment was successful
+     */
+    success: z.boolean().describe("Whether the deployment was successful"),
+})
+    .describe("Represents the base parameters for a server deployment response.");
+/**
+ * @description Represents the parameters for a server deployment success response.
+ */
+export const ServerDeploymentSuccessResponseParamsSchema = BaseServerDeploymentResponseParamsSchema.extend({
+    /**
+     * @required The name of the server
+     */
+    name: z.string().describe("The name of the server"),
+    /**
+     * @required The URL of the server
+     */
+    url: z.url().describe("The URL of the server"),
+    /**
+     * @required The base path of the server
+     */
+    basePath: z.string().describe("The base path of the server"),
+}).describe("Represents the parameters for a server deployment success response.");
+/**
+ * @description Represents the request for a server deployment.
+ */
+export const ServerDeploymentRequestSchema = JSONRPCRequestSchema.extend({
+    method: z.literal("/deploy").describe("The method name"),
+    params: ServerDeploymentRequestParamsSchema.describe("The deployment parameters"),
+}).describe("Represents the request for a server deployment.");
+/**
+ * @description Represents the request for a test server deployment.
+ */
+export const TestServerDeploymentRequestSchema = JSONRPCRequestSchema.extend({
+    method: z.literal("/test/deploy").describe("The method name"),
+    params: ServerDeploymentRequestParamsSchema.describe("The test deployment parameters"),
+}).describe("Represents the request for a test server deployment.");
+/**
+ * @description Represents the response for a server deployment success request.
+ */
+export const ServerDeploymentSuccessResponseSchema = JSONRPCSuccessResponseSchema.extend({
+    result: ServerDeploymentSuccessResponseParamsSchema.describe("The deployment result"),
+}).describe("Represents the response for a server deployment request.");
+/**
+ * @description Represents the response for a server deployment request.
+ */
+export const ServerDeploymentResponseSchema = z
+    .union([ServerDeploymentSuccessResponseSchema, JSONRPCErrorResponseSchema])
+    .describe("Represents the response for a server deployment request.");
+//# sourceMappingURL=request.js.map

package/dist/types/schemas/deployment/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../../src/types/schemas/deployment/request.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,4BAA4B,EAC5B,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC;KACjD,MAAM,CAAC;IACN;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB;;OAEG;IACH,SAAS,EAAE,eAAe;IAC1B;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB;;OAEG;IACH,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC;KACD,QAAQ,CAAC,4DAA4D,CAAC,CAAC;AAM1E;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC;KACtD,MAAM,CAAC;IACN;;OAEG;IACH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACtD;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CACvE,CAAC;KACD,QAAQ,CAAC,kEAAkE,CAAC,CAAC;AAMhF;;GAEG;AACH,MAAM,CAAC,MAAM,2CAA2C,GACtD,wCAAwC,CAAC,MAAM,CAAC;IAC9C;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACnD;;OAEG;IACH,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC9C;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CAC7D,CAAC,CAAC,QAAQ,CACT,qEAAqE,CACtE,CAAC;AAMJ;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC,MAAM,CAAC;IACvE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACxD,MAAM,EAAE,mCAAmC,CAAC,QAAQ,CAClD,2BAA2B,CAC5B;CACF,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC,CAAC;AAM/D;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAC3E,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC7D,MAAM,EAAE,mCAAmC,CAAC,QAAQ,CAClD,gCAAgC,CACjC;CACF,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC,CAAC;AAMpE;;GAEG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAChD,4BAA4B,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,2CAA2C,CAAC,QAAQ,CAC1D,uBAAuB,CACxB;CACF,CAAC,CAAC,QAAQ,CAAC,0DAA0D,CAAC,CAAC;AAK1E;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC5C,KAAK,CAAC,CAAC,qCAAqC,EAAE,0BAA0B,CAAC,CAAC;KAC1E,QAAQ,CAAC,0DAA0D,CAAC,CAAC"}

package/dist/types/schemas/index.js

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

package/dist/types/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,yCAAyC"}

package/dist/types/server/express/errors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type ErrorRequestHandler } from "express";
+/**
+ * Express error handler middleware.
+ */
+export declare const errorHandler: ErrorRequestHandler;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/server/express/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/server/express/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,mBAuC1B,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from "./server.js";
+export * from "./middeware.js";
+export * from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/express/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/types/server/express/middeware.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { NextFunction, Request, Response } from "express";
+import { A2AServiceInterface } from "../../types/index.js";
+export declare function jsonRPCMiddleware(service: A2AServiceInterface, req: Request, res: Response, next: NextFunction): Promise<void>;
+//# sourceMappingURL=middeware.d.ts.map

package/dist/types/server/express/middeware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middeware.d.ts","sourceRoot":"","sources":["../../../../src/server/express/middeware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,6BAAyB;AAiCvD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAkGf"}

package/dist/types/server/express/server.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import express from "express";
+import { Agent, FactoryParams as CreateAgentParams } from "../../types/index.js";
+import { CorsOptions } from "cors";
+export interface ServerParams {
+    app?: express.Express;
+    corsOptions?: CorsOptions;
+    basePath?: string;
+}
+export declare function createAgentServer(params: ServerParams & {
+    agent: Agent | CreateAgentParams;
+    agentCardPath?: string;
+    register?: boolean;
+}): {
+    app: express.Express;
+    agent: Agent<{
+        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>;
+};
+export type ExpressAgentServer = ReturnType<typeof createAgentServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/types/server/express/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/server/express/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,6BAAyB;AAE7E,OAAa,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAIzC,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmCD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,GAAG;IACrB,KAAK,EAAE,KAAK,GAAG,iBAAiB,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuDF;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

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

@@ -1,8 +1,2 @@
-export * from "./a2a-server.js";
-export * from "./interfaces/params.js";
-export * from "./interfaces/store.js";
-export * from "./lib/json-middleware.js";
-export * from "./lib/express-server.js";
-export * from "./lib/storage/file.js";
-export * from "./lib/storage/memory.js";
+export * from "./express/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,352 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview A2A Agent Builder and Execution Engine Factory
+ *
+ * This module provides a fluent builder API for constructing A2A agents and
+ * execution engines. It enables declarative definition of multi-step agent
+ * workflows with type-safe step composition and automatic execution orchestration.
+ *
+ * @module A2ABuilder
+ * @version 1.0.0
+ * @since 0.5.6
+ * @author The Artinet Project
+ */
+import { StepBuilder, Step, StepOutput, StepOutputWithForwardArgs, MessageSendParams, TextPart, DataPart, FilePart, AgentEngine, StepWithKind, FactoryParams } from "../../../types/index.js";
+/**
+ * Type alias for text-based workflow steps.
+ *
+ * This type represents a step that processes or generates text content
+ * within an agent workflow. Text steps are the most common type of step
+ * and are used for message processing, content generation, and text-based
+ * decision making.
+ *
+ * @template TCommand - The command type, defaults to MessageSendParams
+ * @template TPart - The text part type, defaults to TextPart["text"]
+ * @template TInboundArgs - Arguments received from previous step
+ * @template TForwardArgs - Arguments passed to next step
+ * @template TOutput - The output type of the step
+ *
+ * @example
+ * ```typescript
+ * const greetingStep: textStep = async ({ command, context, args }) => {
+ *   const userName = command.message.metadata?.userName || 'there';
+ *   return `Hello, ${userName}! How can I help you today?`;
+ * };
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export type textStep<TCommand extends MessageSendParams = MessageSendParams, TPart extends TextPart["text"] = TextPart["text"], TInboundArgs extends readonly unknown[] = [], TForwardArgs extends readonly unknown[] = [], TOutput extends StepOutput<TPart> | StepOutputWithForwardArgs<TPart, TForwardArgs> | Array<TPart> | TPart = StepOutput<TPart>> = Step<TCommand, TPart, TInboundArgs, TForwardArgs, TOutput>;
+/**
+ * Type alias for file-based workflow steps.
+ *
+ * This type represents a step that processes or generates file content
+ * within an agent workflow. File steps handle document processing,
+ * file generation, and file-based data operations.
+ *
+ * @template TCommand - The command type, defaults to MessageSendParams
+ * @template TPart - The file part type, defaults to FilePart["file"]
+ * @template TInboundArgs - Arguments received from previous step
+ * @template TForwardArgs - Arguments passed to next step
+ * @template TOutput - The output type of the step
+ *
+ * @example
+ * ```typescript
+ * const documentStep: fileStep = async ({ command, context, args }) => {
+ *   const content = generateDocument(command.message.content);
+ *   return {
+ *     name: 'report.pdf',
+ *     mimeType: 'application/pdf',
+ *     bytes: content
+ *   };
+ * };
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export type fileStep<TCommand extends MessageSendParams = MessageSendParams, TPart extends FilePart["file"] = FilePart["file"], TInboundArgs extends readonly unknown[] = [], TForwardArgs extends readonly unknown[] = [], TOutput extends StepOutput<TPart> | StepOutputWithForwardArgs<TPart, TForwardArgs> | Array<TPart> | TPart = StepOutput<TPart>> = Step<TCommand, TPart, TInboundArgs, TForwardArgs, TOutput>;
+/**
+ * Type alias for data-based workflow steps.
+ *
+ * This type represents a step that processes or generates structured data
+ * within an agent workflow. Data steps handle JSON processing, API responses,
+ * and structured data transformations.
+ *
+ * @template TCommand - The command type, defaults to MessageSendParams
+ * @template TPart - The data part type, defaults to DataPart["data"]
+ * @template TInboundArgs - Arguments received from previous step
+ * @template TForwardArgs - Arguments passed to next step
+ * @template TOutput - The output type of the step
+ *
+ * @example
+ * ```typescript
+ * const analyzeStep: dataStep = async ({ command, context, args }) => {
+ *   const analysis = await analyzeMessage(command.message.content);
+ *   return {
+ *     sentiment: analysis.sentiment,
+ *     entities: analysis.entities,
+ *     confidence: analysis.confidence
+ *   };
+ * };
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export type dataStep<TCommand extends MessageSendParams = MessageSendParams, TPart extends DataPart["data"] = DataPart["data"], TInboundArgs extends readonly unknown[] = [], TForwardArgs extends readonly unknown[] = [], TOutput extends StepOutput<TPart> | StepOutputWithForwardArgs<TPart, TForwardArgs> | Array<TPart> | TPart = StepOutput<TPart>> = Step<TCommand, TPart, TInboundArgs, TForwardArgs, TOutput>;
+/**
+ * Utility type to extract forward arguments from step output.
+ *
+ * This helper type extracts the forward arguments type from a step output,
+ * enabling proper type chaining between workflow steps.
+ *
+ * @template O - The output type to extract arguments from
+ * @internal
+ */
+type OutArgsOf<O> = O extends StepOutputWithForwardArgs<any, infer A> ? A : [];
+/**
+ * Fluent builder for constructing A2A agent execution engines.
+ *
+ * The EngineBuilder provides a type-safe, fluent API for composing multi-step
+ * agent workflows. It supports method chaining to build complex agent behaviors
+ * from individual processing steps, with automatic type inference and validation.
+ *
+ * @template TCommand - The command type, defaults to MessageSendParams
+ * @template TInboundArgs - The arguments type received from previous steps
+ *
+ * @example
+ * ```typescript
+ * const agent = EngineBuilder.create()
+ *   .text(async ({ command }) => {
+ *     return `Processing: ${command.message.content}`;
+ *   })
+ *   .data(async ({ args }) => {
+ *     return { processed: true, timestamp: Date.now() };
+ *   })
+ *   .text(async ({ args }) => {
+ *     return `Completed at ${new Date(args[0].timestamp)}`;
+ *   })
+ *   .createAgent({ agentCard: myAgentCard });
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export declare class EngineBuilder<TCommand extends MessageSendParams = MessageSendParams, TInboundArgs extends readonly unknown[] = []> implements StepBuilder<TCommand, TInboundArgs> {
+    private steps;
+    /**
+     * Private constructor to enforce factory method usage.
+     *
+     * @param steps - Initial steps array
+     */
+    private constructor();
+    /**
+     * Creates a new EngineBuilder instance.
+     *
+     * @template TCommand - The command type for the builder
+     * @template TInboundArgs - The initial arguments type
+     * @returns A new EngineBuilder instance
+     *
+     * @example
+     * ```typescript
+     * const builder = EngineBuilder.create<MyCommand, [string, number]>();
+     * ```
+     */
+    static create<TCommand extends MessageSendParams = MessageSendParams, TInboundArgs extends readonly unknown[] = []>(): EngineBuilder<TCommand, TInboundArgs>;
+    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>): EngineBuilder<TCommand, OutArgsOf<TOutput>>;
+    /**
+     * Adds a text processing step to the workflow.
+     *
+     * @template TPart - The text part type
+     * @template TForwardArgs - Arguments to forward to next step
+     * @template TOutput - The output type of the step
+     * @param step - The text step implementation
+     * @returns New builder instance with updated type parameters
+     *
+     * @example
+     * ```typescript
+     * builder.text(async ({ command, args }) => {
+     *   return `Hello, ${command.message.content}!`;
+     * });
+     * ```
+     */
+    text<TPart extends TextPart["text"] = TextPart["text"], TForwardArgs extends readonly unknown[] = [], TOutput extends StepOutput<TPart> | StepOutputWithForwardArgs<TPart, TForwardArgs> | Array<TPart> | TPart = StepOutput<TPart>>(step: textStep<TCommand, TPart, TInboundArgs, TForwardArgs, TOutput>): EngineBuilder<TCommand, OutArgsOf<TOutput>>;
+    /**
+     * Adds a file processing step to the workflow.
+     *
+     * @template TPart - The file part type
+     * @template TForwardArgs - Arguments to forward to next step
+     * @template TOutput - The output type of the step
+     * @param step - The file step implementation
+     * @returns New builder instance with updated type parameters
+     *
+     * @example
+     * ```typescript
+     * builder.file(async ({ command, args }) => {
+     *   return {
+     *     name: 'output.txt',
+     *     mimeType: 'text/plain',
+     *     bytes: Buffer.from(command.message.content)
+     *   };
+     * });
+     * ```
+     */
+    file<TPart extends FilePart["file"] = FilePart["file"], TForwardArgs extends readonly unknown[] = [], TOutput extends StepOutput<TPart> | StepOutputWithForwardArgs<TPart, TForwardArgs> | Array<TPart> | TPart = StepOutput<TPart>>(step: fileStep<TCommand, TPart, TInboundArgs, TForwardArgs, TOutput>): EngineBuilder<TCommand, OutArgsOf<TOutput>>;
+    /**
+     * Adds a data processing step to the workflow.
+     *
+     * @template TPart - The data part type
+     * @template TForwardArgs - Arguments to forward to next step
+     * @template TOutput - The output type of the step
+     * @param step - The data step implementation
+     * @returns New builder instance with updated type parameters
+     *
+     * @example
+     * ```typescript
+     * builder.data(async ({ command, args }) => {
+     *   return {
+     *     analysis: analyzeText(command.message.content),
+     *     timestamp: Date.now()
+     *   };
+     * });
+     * ```
+     */
+    data<TPart extends DataPart["data"] = DataPart["data"], TForwardArgs extends readonly unknown[] = [], TOutput extends StepOutput<TPart> | StepOutputWithForwardArgs<TPart, TForwardArgs> | Array<TPart> | TPart = StepOutput<TPart>>(step: dataStep<TCommand, TPart, TInboundArgs, TForwardArgs, TOutput>): EngineBuilder<TCommand, OutArgsOf<TOutput>>;
+    /**
+     * Creates a complete A2A agent using the built workflow.
+     *
+     * @param params - Agent factory parameters (excluding engine)
+     * @returns Configured A2A agent instance
+     *
+     * @example
+     * ```typescript
+     * const agent = builder.createAgent({
+     *   agentCard: {
+     *     id: 'my-agent',
+     *     name: 'Assistant Agent',
+     *     capabilities: ['text-processing']
+     *   }
+     * });
+     * ```
+     */
+    createAgent(params: Omit<FactoryParams, "engine">): import("../service.js").A2AService;
+    /**
+     * Creates an agent execution engine from the built workflow.
+     *
+     * @returns Agent execution engine function
+     *
+     * @example
+     * ```typescript
+     * const engine = builder.createAgentEngine();
+     * // Use engine with service execution
+     * ```
+     */
+    createAgentEngine(): AgentEngine;
+    /**
+     * Builds the step list for the workflow.
+     *
+     * @returns Array of workflow steps
+     * @throws Error if no steps have been added
+     *
+     * @example
+     * ```typescript
+     * const steps = builder.build();
+     * ```
+     */
+    build(): StepWithKind<TCommand, any, any, any, any, any>[];
+}
+/**
+ * Convenience factory function for creating an agent builder with default parameters.
+ *
+ * @returns New EngineBuilder instance with MessageSendParams command type
+ *
+ * @example
+ * ```typescript
+ * const agent = AgentBuilder()
+ *   .text(async ({ command }) => `Hello ${command.message.content}!`)
+ *   .createAgent({ agentCard: myCard });
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export declare const AgentBuilder: () => EngineBuilder<{
+    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;
+}, []>;
+/**
+ * Creates an agent execution engine from a list of workflow steps.
+ *
+ * This function transforms a list of step definitions into an executable
+ * agent engine that processes commands through the defined workflow,
+ * yielding updates as each step completes.
+ *
+ * @param stepsList - Array of workflow steps to execute
+ * @returns Agent execution engine function
+ *
+ * @example
+ * ```typescript
+ * const steps = [
+ *   { kind: 'text', step: greetingStep },
+ *   { kind: 'data', step: analysisStep }
+ * ];
+ * const engine = createAgentExecutor(steps);
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export declare function createAgentExecutor(stepsList: StepWithKind[]): AgentEngine;
+export {};
+//# sourceMappingURL=builder.d.ts.map

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

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