@artinet/sdk 0.5.18 → 0.6.0-preview.1

package/dist/browser/types/schemas/a2a/task.js

@@ -1,134 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from "zod";
-import { MessageSchema, ArtifactSchema } from "./parameters.js";
-import { JSONRPCErrorResponseSchema, JSONRPCRequestSchema, JSONRPCSuccessResponseSchema, } from "./rpc.js";
-import { KindSchema } from "./kind.js";
-/**
- * @description Represents the state of a task within the A2A protocol.
- */
-export const TaskStateSchema = z
-    .enum([
-    "submitted",
-    "working",
-    "input-required",
-    "completed",
-    "canceled",
-    "failed",
-    "rejected",
-    "auth-required",
-    "unknown",
-])
-    .describe("Defines the lifecycle states of a Task.");
-export const TaskState = TaskStateSchema.enum;
-/**
- * Basic parameters used for task ID operations.
- */
-export const TaskIdParamsSchema = z
-    .object({
-    id: z.string().describe("The ID of the task to query."),
-    metadata: z
-        .record(z.string(), z.unknown())
-        .optional()
-        .describe("Additional metadata to include in the request."),
-})
-    .describe("Defines the parameters for a request to get a task.");
-/**
- * Parameters used for querying task-related information by ID.
- */
-export const TaskQueryParamsSchema = TaskIdParamsSchema.extend({
-    historyLength: z.number().optional(),
-});
-/**
- * Represents the status of a task at a specific point in time.
- */
-export const TaskStatusSchema = z.object({
-    state: TaskStateSchema,
-    message: MessageSchema.optional(),
-    timestamp: z.string().datetime().optional(),
-});
-/**
- * Represents a task being processed by an agent.
- */
-export const TaskSchema = z.object({
-    id: z.string(),
-    contextId: z.string(),
-    status: TaskStatusSchema,
-    history: z.array(MessageSchema).optional(),
-    artifacts: z.array(ArtifactSchema).optional(),
-    metadata: z.record(z.string(), z.unknown()).optional(),
-    kind: KindSchema.refine((kind) => kind === "task"),
-});
-/**
- * Represents a status update event for a task, typically used in streaming scenarios.
- */
-export const TaskStatusUpdateEventSchema = z.object({
-    taskId: z.string(),
-    contextId: z.string(),
-    kind: KindSchema.refine((kind) => kind === "status-update"),
-    status: TaskStatusSchema,
-    final: z.boolean(),
-    metadata: z.record(z.string(), z.unknown()).optional(),
-});
-/**
- * Represents an artifact update event for a task, typically used in streaming scenarios.
- */
-export const TaskArtifactUpdateEventSchema = z.object({
-    taskId: z.string(),
-    contextId: z.string(),
-    kind: KindSchema.refine((kind) => kind === "artifact-update"),
-    artifact: ArtifactSchema,
-    append: z.boolean().optional(),
-    lastChunk: z.boolean().optional(),
-    metadata: z.record(z.string(), z.unknown()).optional(),
-});
-/**
- * @description Request to retrieve the current state of a task.
- */
-export const GetTaskRequestSchema = JSONRPCRequestSchema.extend({
-    method: z.literal("tasks/get"),
-    params: TaskQueryParamsSchema.describe("Defines the parameters for a request to get a task."),
-}).describe("Represents a JSON-RPC request for the `tasks/get` method.");
-/**
- * @description Represents a successful JSON-RPC response for the `tasks/get` method.
- */
-export const GetTaskSuccessResponseSchema = JSONRPCSuccessResponseSchema.extend({
-    /**
-     * @required The result of the request, which can be a direct reply Message or the initial Task object.
-     */
-    result: TaskSchema.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/get' method.");
-/**
- * @description Represents a JSON-RPC response for the `tasks/get` method.
- */
-export const GetTaskResponseSchema = z
-    .union([GetTaskSuccessResponseSchema, JSONRPCErrorResponseSchema])
-    .describe("Represents a JSON-RPC response for the `tasks/get` method.");
-/**
- * @description Request to re-subscribe to a task's updates.
- */
-export const TaskResubscriptionRequestSchema = JSONRPCRequestSchema.extend({
-    method: z.literal("tasks/resubscribe"),
-    params: TaskIdParamsSchema.describe("Defines the parameters for a request to re-subscribe to a task's updates."),
-}).describe("Represents a JSON-RPC request for the `tasks/resubscribe` method.");
-/**
- * @description Request to cancel a task.
- */
-export const CancelTaskRequestSchema = JSONRPCRequestSchema.extend({
-    method: z.literal("tasks/cancel"),
-    params: TaskIdParamsSchema.describe("Defines the parameters for a request to cancel a task."),
-}).describe("Represents a JSON-RPC request for the `tasks/cancel` method.");
-/**
- * @description Represents a successful JSON-RPC response for the `tasks/cancel` method.
- */
-export const CancelTaskSuccessResponseSchema = JSONRPCSuccessResponseSchema.extend({
-    result: TaskSchema.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/cancel' method.");
-/**
- * @description Represents a JSON-RPC response for the `tasks/cancel` method.
- */
-export const CancelTaskResponseSchema = z
-    .union([CancelTaskSuccessResponseSchema, JSONRPCErrorResponseSchema])
-    .describe("Represents a JSON-RPC response for the `tasks/cancel` method.");

package/dist/browser/types/schemas/a2a/transport.d.ts

@@ -1,31 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from "zod";
-/**
- * @description Supported A2A transport protocols.
- */
-export declare const TransportProtocolSchema: z.ZodEnum<["JSONRPC", "GRPC", "HTTP+JSON"]>;
-export type TransportProtocol = z.infer<typeof TransportProtocolSchema>;
-/**
- * @description Declares a combination of a target URL and a transport protocol for interacting with the agent.
- * This allows agents to expose the same functionality over multiple transport mechanisms.
- */
-export declare const AgentInterfaceSchema: z.ZodObject<{
-    /**
-     * @required The URL where this interface is available. Must be a valid absolute HTTPS URL in production.
-     */
-    url: z.ZodString;
-    /**
-     * @required The transport protocol supported at this URL.
-     */
-    transport: z.ZodUnion<[z.ZodEnum<["JSONRPC", "GRPC", "HTTP+JSON"]>, z.ZodString]>;
-}, "strip", z.ZodTypeAny, {
-    url: string;
-    transport: string;
-}, {
-    url: string;
-    transport: string;
-}>;
-export type AgentInterface = z.infer<typeof AgentInterfaceSchema>;

package/dist/browser/types/schemas/a2a/transport.js

@@ -1,28 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from "zod";
-/**
- * @description Supported A2A transport protocols.
- */
-export const TransportProtocolSchema = z.enum(["JSONRPC", "GRPC", "HTTP+JSON"]);
-/**
- * @description Declares a combination of a target URL and a transport protocol for interacting with the agent.
- * This allows agents to expose the same functionality over multiple transport mechanisms.
- */
-export const AgentInterfaceSchema = z.object({
-    /**
-     * @required The URL where this interface is available. Must be a valid absolute HTTPS URL in production.
-     */
-    url: z
-        .string()
-        .url()
-        .describe("The URL where this interface is available. Must be a valid absolute HTTPS URL in production."),
-    /**
-     * @required The transport protocol supported at this URL.
-     */
-    transport: z
-        .union([TransportProtocolSchema, z.string()])
-        .describe("The transport protocol supported at this URL."),
-});

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

@@ -1 +0,0 @@
-export * from "./a2a/index.js";

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

@@ -1 +0,0 @@
-export * from "./a2a/index.js";

package/dist/browser/utils/logging/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./log.js";
-export * from "./logger.js";

package/dist/browser/utils/logging/index.js

@@ -1,2 +0,0 @@
-export * from "./log.js";
-export * from "./logger.js";

package/dist/browser/utils/logging/log.d.ts

@@ -1,33 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Logger utility for server operations
- * @param context The context of the log (e.g., "A2AServer", "TaskStore")
- * @param message The message to log
- * @param data Optional data to include in the log
- */
-export declare function logDebug(context: string, message: string, data?: unknown): void;
-/**
- * Logger utility for server errors
- * @param context The context of the log (e.g., "A2AServer", "TaskStore")
- * @param message The message to log
- * @param error The error object
- * @param data Optional additional data
- */
-export declare function logError(context: string, message: string, error: unknown, data?: unknown): void;
-/**
- * Logger utility for server warnings
- * @param context The context of the log (e.g., "A2AServer", "TaskStore")
- * @param message The message to log
- * @param data Optional data to include in the log
- */
-export declare function logWarn(context: string, message: string, data?: unknown): void;
-/**
- * Logger utility for server information
- * @param context The context of the log (e.g., "A2AServer", "TaskStore")
- * @param message The message to log
- * @param data Optional data to include in the log
- */
-export declare function logInfo(context: string, message: string, data?: unknown): void;

package/dist/browser/utils/logging/log.js

@@ -1,75 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { logger, level } from "./logger.js";
-/**
- * Logger utility for server operations
- * @param context The context of the log (e.g., "A2AServer", "TaskStore")
- * @param message The message to log
- * @param data Optional data to include in the log
- */
-export function logDebug(context, message, data) {
-    const logData = { component: context };
-    if (data !== undefined) {
-        logData.data = data;
-    }
-    if (level === "silent" || level === "warning" || level === "error" || level === "info") {
-        return;
-    }
-    logger.debug(logData, message);
-}
-/**
- * Logger utility for server errors
- * @param context The context of the log (e.g., "A2AServer", "TaskStore")
- * @param message The message to log
- * @param error The error object
- * @param data Optional additional data
- */
-export function logError(context, message, error, data) {
-    const logData = {
-        component: context,
-        err: error instanceof Error ? error : new Error(String(error)),
-    };
-    if (data !== undefined) {
-        logData.data = data;
-    }
-    if (level === "silent") {
-        return;
-    }
-    logger.error(logData, message);
-}
-/**
- * Logger utility for server warnings
- * @param context The context of the log (e.g., "A2AServer", "TaskStore")
- * @param message The message to log
- * @param data Optional data to include in the log
- */
-export function logWarn(context, message, data) {
-    const logData = { component: context };
-    if (data !== undefined) {
-        logData.data = data;
-    }
-    if (level === "silent" || level === "error") {
-        return;
-    }
-    logger.warn(logData, message);
-}
-/**
- * Logger utility for server information
- * @param context The context of the log (e.g., "A2AServer", "TaskStore")
- * @param message The message to log
- * @param data Optional data to include in the log
- */
-export function logInfo(context, message, data) {
-    const logData = { component: context };
-    if (data !== undefined) {
-        logData.data = data;
-    }
-    if (level === "error" ||
-        level === "warning" ||
-        level === "silent") {
-        return;
-    }
-    logger.info(logData, message);
-}

package/dist/browser/utils/logging/logger.d.ts

@@ -1,18 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * A lightweight cross-platform logger instance
- */
-export declare const logger: Console;
-export declare let level: "trace" | "verbose" | "debug" | "info" | "warning" | "error" | "silent";
-/**
- * Configures the logger with the specified options
- * @param options - Logger configuration options
- */
-export declare function configureLogger(options: {
-    level?: "trace" | "verbose" | "debug" | "info" | "warning" | "error" | "silent";
-    name?: string;
-    prettyPrint?: boolean;
-}): Console;

package/dist/browser/utils/logging/logger.js

@@ -1,18 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * A lightweight cross-platform logger instance
- */
-export const logger = console;
-export let level = "silent";
-/**
- * Configures the logger with the specified options
- * @param options - Logger configuration options
- */
-export function configureLogger(options) {
-    level = options.level || "silent";
-    return logger;
-}
-configureLogger({ level: "silent" });

package/dist/services/a2a/factory/event.d.ts

@@ -1,58 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * @fileoverview A2A Event Manager Factory
- *
- * This module provides factory functions for creating A2A-specific event managers
- * that handle the complete lifecycle of agent-to-agent communication tasks.
- * It integrates with the core event management system while providing A2A-specific
- * behavior for state management, task tracking, and error handling.
- *
- * @module A2AEventFactory
- * @version 0.5.7
- * @since 0.5.6
- * @author The Artinet Project
- */
-import { EventManager } from "../../core/managers/event.js";
-import { Command, State, Update, A2AServiceInterface, EventManagerOptions } from "../../../types/index.js";
-/**
- * Creates an A2A-specific event manager with integrated task and state management.
- *
- * This factory function creates an event manager tailored for A2A operations,
- * providing comprehensive lifecycle management for agent-to-agent communication
- * tasks. It handles state persistence, task tracking, error scenarios, and
- * cancellation while integrating with the broader A2A service 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
- *
- * @param service - The A2A service instance for state and connection management
- * @param id - Optional context ID (generates UUID if not provided)
- * @param eventOverrides - Optional event handling overrides
- * @returns Configured EventManager instance for A2A operations
- *
- * @example
- * ```typescript
- * const eventManager = createEventManager(
- *   a2aService,
- *   'context-123',
- *   {
- *     onStart: async (context) => {
- *       console.log('A2A task starting');
- *       return await initializeA2AState(context);
- *     },
- *     onComplete: async (finalState) => {
- *       console.log('A2A task completed');
- *       await notifyCompletion(finalState);
- *     }
- *   }
- * );
- * ```
- *
- * @public
- * @since 0.5.6
- */
-export declare function createEventManager<TCommand extends Command = Command, TState extends State = State, TUpdate extends Update = Update>(service: A2AServiceInterface<TCommand, TState, TUpdate>, id?: string, eventOverrides?: EventManagerOptions<TCommand, TState, TUpdate>): EventManager<TCommand, TState, TUpdate>;

package/dist/services/a2a/factory/event.js

@@ -1,177 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * @fileoverview A2A Event Manager Factory
- *
- * This module provides factory functions for creating A2A-specific event managers
- * that handle the complete lifecycle of agent-to-agent communication tasks.
- * It integrates with the core event management system while providing A2A-specific
- * behavior for state management, task tracking, and error handling.
- *
- * @module A2AEventFactory
- * @version 0.5.7
- * @since 0.5.6
- * @author The Artinet Project
- */
-import { EventManager } from "../../core/managers/event.js";
-import { TaskState, } from "../../../types/index.js";
-import { INTERNAL_ERROR, INVALID_PARAMS, CANCEL_UPDATE, FAILED_UPDATE, logError, } from "../../../utils/index.js";
-import { loadState, processUpdate } from "../state/index.js";
-import { v4 as uuidv4 } from "uuid";
-/**
- * Creates an A2A-specific event manager with integrated task and state management.
- *
- * This factory function creates an event manager tailored for A2A operations,
- * providing comprehensive lifecycle management for agent-to-agent communication
- * tasks. It handles state persistence, task tracking, error scenarios, and
- * cancellation while integrating with the broader A2A service 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
- *
- * @param service - The A2A service instance for state and connection management
- * @param id - Optional context ID (generates UUID if not provided)
- * @param eventOverrides - Optional event handling overrides
- * @returns Configured EventManager instance for A2A operations
- *
- * @example
- * ```typescript
- * const eventManager = createEventManager(
- *   a2aService,
- *   'context-123',
- *   {
- *     onStart: async (context) => {
- *       console.log('A2A task starting');
- *       return await initializeA2AState(context);
- *     },
- *     onComplete: async (finalState) => {
- *       console.log('A2A task completed');
- *       await notifyCompletion(finalState);
- *     }
- *   }
- * );
- * ```
- *
- * @public
- * @since 0.5.6
- */
-export function createEventManager(service, id, eventOverrides) {
-    const contextId = id ?? uuidv4();
-    /**
-     * Task store implementation that bridges between event management and A2A service state management.
-     *
-     * This store provides the interface needed by the legacy update processing logic
-     * while integrating with the A2A service's state management capabilities.
-     */
-    const taskStore = {
-        save: async (data) => {
-            if (!data.task?.id) {
-                throw INTERNAL_ERROR({
-                    data: {
-                        message: "Task ID is required",
-                    },
-                });
-            }
-            service.setState(data.task.id, data);
-        },
-        load: async (taskId) => {
-            return (await service.getState(taskId).catch(() => null)) ?? null;
-        },
-    };
-    // Configure A2A-specific event handling options
-    const options = {
-        onStart: async (context) => {
-            const request = context.command;
-            if (!request || (!request.message && !("message" in request))) {
-                throw INVALID_PARAMS("No request detected");
-            }
-            let currentContextId = contextId;
-            if (request.message.contextId) {
-                currentContextId = request.message.contextId;
-            }
-            service.addConnection(currentContextId);
-            const currentState = await loadState(taskStore, request.message, request.metadata, request.message.taskId, currentContextId);
-            return currentState;
-        },
-        onCancel: async (current, update) => {
-            const localContextId = update.contextId ?? contextId;
-            const localTaskId = update.taskId ?? update.id;
-            service.addCancellation(localContextId);
-            const cancellation = CANCEL_UPDATE(localTaskId, localContextId);
-            const cancelUpdate = {
-                ...update,
-                ...cancellation,
-                status: {
-                    ...update.status,
-                    ...cancellation.status,
-                    state: TaskState.canceled,
-                },
-                final: true,
-            };
-            await processUpdate(taskStore, {
-                context: {
-                    contextId: localContextId,
-                    task: current.task,
-                    userMessage: current.task?.status?.message ?? {},
-                    isCancelled: () => service.isCancelled(localContextId),
-                    history: [], //deprecating history
-                },
-                current: current,
-                update: cancelUpdate,
-            });
-        },
-        onUpdate: async (current, update) => {
-            if (service.isCancelled(contextId)) {
-                return current;
-            }
-            try {
-                const currentState = (await processUpdate(taskStore, {
-                    context: {
-                        contextId: contextId,
-                        task: current.task,
-                        userMessage: current.task?.status?.message ?? {},
-                        isCancelled: () => service.isCancelled(contextId),
-                        history: [], //deprecating history
-                    },
-                    current: current,
-                    update: update,
-                }));
-                return currentState;
-            }
-            catch (error) {
-                logError(`onUpdate[${contextId}]:`, "error detected", error, update);
-                throw error;
-            }
-        },
-        onError: async (current, error) => {
-            logError(`onError[${contextId}]`, "error detected", error, current);
-            if (!current ||
-                (!current.task?.contextId && !current?.contextId)) {
-                return;
-            }
-            const failedUpdate = FAILED_UPDATE(current.task?.id, current.task?.contextId ?? contextId, "failed-update", error instanceof Error ? error.message : String(error));
-            await processUpdate(taskStore, {
-                context: {
-                    contextId: current.task?.contextId ?? contextId,
-                    task: current.task,
-                    userMessage: current.task?.status?.message ?? {},
-                    isCancelled: () => service.isCancelled(contextId),
-                    history: [], //deprecating history
-                },
-                current: current,
-                update: failedUpdate,
-            });
-        },
-        onComplete: async () => {
-            service.removeCancellation(contextId);
-            service.removeConnection(contextId);
-        },
-    };
-    return new EventManager(contextId, {
-        ...options,
-        ...eventOverrides, // Override options take precedence over defaults
-    });
-}

package/dist/services/a2a/factory/method.d.ts

@@ -1,6 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { MethodOptions } from "../../../types/index.js";
-export declare function createMethods(methods?: Partial<MethodOptions>): MethodOptions;

package/dist/services/a2a/managers/cancellation.d.ts

@@ -1,11 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { CancellationManagerInterface } from "../../../types/index.js";
-export declare class CancellationManager implements CancellationManagerInterface {
-    private cancellations;
-    addCancellation(id: string): void;
-    removeCancellation(id: string): void;
-    isCancelled(id: string): boolean;
-}

package/dist/services/a2a/managers/cancellation.js

@@ -1,16 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export class CancellationManager {
-    cancellations = new Set();
-    addCancellation(id) {
-        this.cancellations.add(id);
-    }
-    removeCancellation(id) {
-        this.cancellations.delete(id);
-    }
-    isCancelled(id) {
-        return this.cancellations.has(id);
-    }
-}

package/dist/services/a2a/managers/connection.d.ts

@@ -1,11 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { ConnectionManagerInterface } from "../../../types/index.js";
-export declare class ConnectionManager implements ConnectionManagerInterface {
-    private connections;
-    addConnection(id: string): void;
-    removeConnection(id: string): void;
-    isConnected(id: string): boolean;
-}

package/dist/services/a2a/managers/connection.js

@@ -1,16 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export class ConnectionManager {
-    connections = new Set();
-    addConnection(id) {
-        this.connections.add(id);
-    }
-    removeConnection(id) {
-        this.connections.delete(id);
-    }
-    isConnected(id) {
-        return this.connections.has(id);
-    }
-}

package/dist/services/a2a/managers/context.d.ts

@@ -1,11 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { Command, State, Update, CoreContext, ContextManagerInterface } from "../../../types/index.js";
-export declare class ContextManager<TCommand extends Command = Command, TState extends State = State, TUpdate extends Update = Update> implements ContextManagerInterface<TCommand, TState, TUpdate> {
-    private contexts;
-    deleteContext(id: string): void;
-    setContext(id: string, context: CoreContext<TCommand, TState, TUpdate>): void;
-    getContext(id: string): CoreContext<TCommand, TState, TUpdate> | undefined;
-}