@artinet/sdk 0.5.18 → 0.6.0-preview.2

package/dist/services/a2a/helpers/message-builder.js

@@ -1,61 +0,0 @@
-import { v4 as uuidv4 } from "uuid";
-export class MessageBuilder {
-    message = {
-        role: "user",
-        parts: [],
-        metadata: undefined,
-        extensions: undefined,
-        referenceTaskIds: undefined,
-        messageId: uuidv4(),
-        taskId: undefined,
-        contextId: undefined,
-        kind: "message",
-    };
-    constructor(message = {}) {
-        this.message.role = message.role ?? this.message.role;
-        this.message.parts = message.parts ?? this.message.parts;
-        this.message.metadata = message.metadata ?? this.message.metadata;
-        this.message.extensions = message.extensions ?? this.message.extensions;
-        this.message.referenceTaskIds =
-            message.referenceTaskIds ?? this.message.referenceTaskIds;
-        this.message.messageId = message.messageId ?? this.message.messageId;
-        this.message.taskId = message.taskId ?? this.message.taskId;
-        this.message.contextId = message.contextId ?? this.message.contextId;
-    }
-    valueOf() {
-        return this.message;
-    }
-}
-export class MessageSendConfigurationBuilder {
-    configuration = {
-        acceptedOutputModes: undefined,
-        historyLength: undefined,
-        pushNotificationConfig: undefined,
-        blocking: undefined,
-    };
-    constructor(configuration = {}) {
-        this.configuration.acceptedOutputModes =
-            configuration?.acceptedOutputModes ??
-                this.configuration.acceptedOutputModes;
-        this.configuration.historyLength =
-            configuration?.historyLength ?? this.configuration.historyLength;
-        this.configuration.pushNotificationConfig =
-            configuration?.pushNotificationConfig ??
-                this.configuration.pushNotificationConfig;
-        this.configuration.blocking =
-            configuration?.blocking ?? this.configuration.blocking;
-    }
-    valueOf() {
-        return this.configuration;
-    }
-}
-export const createMessageSendParams = (messageSendParams) => {
-    const isString = typeof messageSendParams === "string";
-    return {
-        message: new MessageBuilder(isString
-            ? { parts: [{ text: messageSendParams, kind: "text" }] }
-            : messageSendParams.message).valueOf(),
-        configuration: new MessageSendConfigurationBuilder(isString ? undefined : messageSendParams.configuration).valueOf(),
-        metadata: isString ? undefined : messageSendParams.metadata,
-    };
-};

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;
-}

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

@@ -1,16 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export class ContextManager {
-    contexts = new Map();
-    deleteContext(id) {
-        this.contexts.delete(id);
-    }
-    setContext(id, context) {
-        this.contexts.set(id, context);
-    }
-    getContext(id) {
-        return this.contexts.get(id);
-    }
-}

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

@@ -1,5 +0,0 @@
-export * from "./cancellation.js";
-export * from "./connection.js";
-export * from "./context.js";
-export * from "../factory/event.js";
-export * from "./task.js";

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

@@ -1,5 +0,0 @@
-export * from "./cancellation.js";
-export * from "./connection.js";
-export * from "./context.js";
-export * from "../factory/event.js";
-export * from "./task.js";

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

@@ -1,11 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { TaskManagerInterface, TaskAndHistory } from "../../../types/index.js";
-export declare class TaskManager<TaskType extends TaskAndHistory> implements TaskManagerInterface<TaskType> {
-    private states;
-    getState(id: string): TaskType | Promise<TaskType | undefined> | undefined;
-    setState(id: string, data: TaskType): Promise<void> | void;
-    getStates(): Promise<string[]> | string[];
-}

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

@@ -1,16 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export class TaskManager {
-    states = new Map();
-    getState(id) {
-        return this.states.get(id);
-    }
-    setState(id, data) {
-        this.states.set(id, data);
-    }
-    getStates() {
-        return Array.from(this.states.keys());
-    }
-}

package/dist/services/a2a/methods/cancel-task.d.ts

@@ -1,7 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { TaskIdParams, Task, MethodParams } from "../../../types/index.js";
-export declare function cancelTask(input: TaskIdParams, params: Omit<MethodParams, "engine" | "signal">): Promise<Task>;
-export type CancelTaskMethod = typeof cancelTask;

package/dist/services/a2a/methods/cancel-task.js

@@ -1,43 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { TaskState, } from "../../../types/index.js";
-import { FINAL_STATES, TASK_NOT_FOUND, TASK_NOT_CANCELABLE, } from "../../../utils/index.js";
-export async function cancelTask(input, params) {
-    const { service, contextManager } = params;
-    const originalState = await service.getState(input.id);
-    const task = originalState?.task;
-    if (!task) {
-        throw TASK_NOT_FOUND({ taskId: input.id });
-    }
-    if (FINAL_STATES.includes(task.status.state)) {
-        throw TASK_NOT_CANCELABLE("Task is in a final state: " + task.status.state);
-    }
-    service.addCancellation(input.id);
-    const cancelledTask = {
-        ...task,
-        status: {
-            ...task.status,
-            state: TaskState.canceled,
-        },
-    };
-    const context = contextManager.getContext(task.contextId ?? input.id);
-    if (!context) {
-        service.setState(input.id, {
-            ...originalState,
-            task: {
-                ...originalState?.task,
-                ...cancelledTask,
-            },
-            history: [], //deprecating history
-        });
-        return cancelledTask;
-    }
-    context.events.on("complete", () => {
-        service.removeCancellation(input.id);
-        contextManager.deleteContext(context.contextId);
-    });
-    await context.events.onCancel(cancelledTask);
-    return cancelledTask;
-}

package/dist/services/a2a/methods/get-task.d.ts

@@ -1,112 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { TaskQueryParams, MethodParams } from "../../../types/index.js";
-export declare function getTask(input: TaskQueryParams, params: Omit<MethodParams, "engine" | "contextManager" | "signal">): Promise<{
-    id: string;
-    status: {
-        state: "failed" | "unknown" | "completed" | "canceled" | "rejected" | "submitted" | "working" | "input-required" | "auth-required";
-        message?: {
-            role: "user" | "agent";
-            kind: "message";
-            parts: ({
-                file: {
-                    bytes: string;
-                    name?: string | undefined;
-                    mimeType?: string | undefined;
-                    uri?: undefined;
-                } | {
-                    uri: string;
-                    name?: string | undefined;
-                    bytes?: undefined;
-                    mimeType?: string | undefined;
-                };
-                kind: "file";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                text: string;
-                kind: "text";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                data: Record<string, unknown>;
-                kind: "data";
-                metadata?: Record<string, unknown> | undefined;
-            })[];
-            messageId: string;
-            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> | undefined;
-    history?: {
-        role: "user" | "agent";
-        kind: "message";
-        parts: ({
-            file: {
-                bytes: string;
-                name?: string | undefined;
-                mimeType?: string | undefined;
-                uri?: undefined;
-            } | {
-                uri: string;
-                name?: string | undefined;
-                bytes?: undefined;
-                mimeType?: string | undefined;
-            };
-            kind: "file";
-            metadata?: Record<string, unknown> | undefined;
-        } | {
-            text: string;
-            kind: "text";
-            metadata?: Record<string, unknown> | undefined;
-        } | {
-            data: Record<string, unknown>;
-            kind: "data";
-            metadata?: Record<string, unknown> | undefined;
-        })[];
-        messageId: string;
-        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 | undefined;
-                mimeType?: string | undefined;
-                uri?: undefined;
-            } | {
-                uri: string;
-                name?: string | undefined;
-                bytes?: undefined;
-                mimeType?: string | undefined;
-            };
-            kind: "file";
-            metadata?: Record<string, unknown> | undefined;
-        } | {
-            text: string;
-            kind: "text";
-            metadata?: Record<string, unknown> | undefined;
-        } | {
-            data: Record<string, unknown>;
-            kind: "data";
-            metadata?: Record<string, unknown> | undefined;
-        })[];
-        name?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-        extension?: string[] | undefined;
-    }[] | undefined;
-}>;
-export type GetTaskMethod = typeof getTask;

package/dist/services/a2a/methods/get-task.js

@@ -1,16 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { TASK_NOT_FOUND } from "../../../utils/index.js";
-import { getLatestHistory } from "../helpers/index.js";
-export async function getTask(input, params) {
-    const { service } = params;
-    const state = await service.getState(input.id);
-    const task = state?.task;
-    if (!task) {
-        throw TASK_NOT_FOUND({ taskId: input.id });
-    }
-    task.history = getLatestHistory(task, input.historyLength);
-    return task;
-}

package/dist/services/a2a/methods/resubscribe-task.d.ts

@@ -1,7 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { TaskIdParams, UpdateEvent, MethodParams } from "../../../types/index.js";
-export declare function resubscribe(input: TaskIdParams, params: MethodParams): AsyncGenerator<NonNullable<UpdateEvent>, void, unknown>;
-export type ResubscribeTaskMethod = typeof resubscribe;

package/dist/services/a2a/methods/resubscribe-task.js

@@ -1,80 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { Kind, } from "../../../types/index.js";
-import { createContext } from "../factory/context.js";
-import { FINAL_STATES, INVALID_REQUEST, TASK_NOT_FOUND, } from "../../../utils/index.js";
-import { StreamManager } from "../../core/managers/stream.js";
-const createMessageParams = (task) => {
-    const latestUserMessage = task.history
-        ?.filter((msg) => msg.role === "user")
-        ?.pop();
-    if (!latestUserMessage) {
-        throw INVALID_REQUEST("No user message found");
-    }
-    const messageParams = {
-        message: {
-            ...latestUserMessage,
-            taskId: task.id,
-            contextId: latestUserMessage.contextId ?? task.contextId,
-        },
-        metadata: task.metadata,
-    };
-    return messageParams;
-};
-const flushArtifacts = (taskId, contextId, task, stream) => {
-    if (task.artifacts && task.artifacts.length > 0) {
-        for (const artifact of task.artifacts) {
-            const artifactUpdate = {
-                kind: Kind["artifact-update"],
-                taskId,
-                contextId,
-                artifact,
-                lastChunk: task.artifacts.length === 1,
-                metadata: task.metadata,
-            };
-            stream.addUpdate(artifactUpdate);
-            task.artifacts.shift();
-        }
-    }
-};
-export async function* resubscribe(input, params) {
-    const { service, engine, contextManager, signal } = params;
-    const state = await service.getState(input.id);
-    if (!state || !state.task) {
-        throw TASK_NOT_FOUND({ taskId: input.id });
-    }
-    const contextId = state.task?.contextId;
-    const stream = new StreamManager();
-    const context = createContext(createMessageParams(state.task), service, contextManager, signal, contextId, {
-        ...service.eventOverrides,
-        onStart: async (context) => {
-            const request = context.command;
-            const task = state.task;
-            const taskId = request?.message.taskId ?? task.id;
-            const contextId = request?.message.contextId ??
-                task.contextId ??
-                stream.getContextId();
-            const statusUpdate = {
-                kind: "status-update",
-                taskId,
-                contextId,
-                status: task.status,
-                final: false,
-                metadata: task.metadata,
-            };
-            stream.addUpdate(statusUpdate);
-            if (FINAL_STATES.includes(task.status.state)) {
-                flushArtifacts(taskId, contextId, task, stream);
-                stream.setCompleted();
-            }
-            return state;
-        },
-    });
-    context.events.on("error", () => {
-        context.events.onComplete();
-    });
-    stream.setExecutionContext(context);
-    yield* stream.stream(engine, service);
-}

package/dist/services/a2a/methods/send-message.d.ts

@@ -1,7 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { MessageSendParams, SendMessageSuccessResult, MethodParams } from "../../../types/index.js";
-export declare function sendMessage(input: MessageSendParams, params: MethodParams): Promise<SendMessageSuccessResult>;
-export type SendMessageMethod = typeof sendMessage;

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

@@ -1,36 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * 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;
-    const context = createContext(input, service, contextManager, signal, contextId ?? undefined, service.eventOverrides);
-    context.events.on("complete", () => {
-        contextManager.deleteContext(context.events.contextId);
-    });
-    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();
-    const task = state.task ?? state;
-    task.history = getLatestHistory(task, input.configuration?.historyLength);
-    return task;
-}

package/dist/services/a2a/methods/stream-message.d.ts

@@ -1,8 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { MessageSendParams, UpdateEvent } from "../../../types/index.js";
-import { MethodParams } from "../../../types/index.js";
-export declare function streamMessage(input: MessageSendParams, params: MethodParams): AsyncGenerator<NonNullable<UpdateEvent>, void, unknown>;
-export type StreamMessageMethod = typeof streamMessage;

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

@@ -1,21 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { StreamManager } from "../../core/managers/stream.js";
-import { createContext } from "../factory/context.js";
-export async function* streamMessage(input, params) {
-    const { service, engine, contextManager, signal } = params;
-    let contextId = input.message.contextId;
-    const context = createContext(input, service, contextManager, signal, contextId ?? undefined, service.eventOverrides);
-    const stream = new StreamManager(context);
-    contextId = stream.getContextId();
-    context.events.on("complete", () => {
-        contextManager.deleteContext(contextId);
-        stream.setCompleted();
-    });
-    context.events.on("error", () => {
-        context.events.onComplete();
-    });
-    yield* stream.stream(engine, service);
-}

package/dist/services/a2a/state/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./update/index.js";
-export * from "./process.js";
-export * from "./load.js";

package/dist/services/a2a/state/index.js

@@ -1,3 +0,0 @@
-export * from "./update/index.js";
-export * from "./process.js";
-export * from "./load.js";

package/dist/services/a2a/state/load.d.ts

@@ -1,14 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { Message, TaskAndHistory, TaskStore } from "../../../types/index.js";
-/**
- * Loads or creates a task and its history.
- * @param taskId The task ID
- * @param message The message to process
- * @param contextId Optional context ID
- * @param metadata Optional metadata
- * @returns The task and history
- */
-export declare function loadState(taskStore: TaskStore, message: Message, metadata?: Record<string, unknown> | null, taskId?: string | null, contextId?: string | null): Promise<TaskAndHistory>;

package/dist/services/a2a/state/load.js

@@ -1,71 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { getCurrentTimestamp, logError } from "../../../utils/index.js";
-import { TaskState, } from "../../../types/index.js";
-import { v4 as uuidv4 } from "uuid";
-async function getReferences(referenceTaskIds, taskStore) {
-    try {
-        const references = await Promise.all(referenceTaskIds.map((referenceTaskId) => {
-            return taskStore.load(referenceTaskId);
-        }));
-        return references
-            .filter((reference) => reference !== null)
-            .map((reference) => reference?.task);
-    }
-    catch (error) {
-        logError("getReferences", "failed to load references", error, {
-            referenceTaskIds,
-        });
-        return [];
-    }
-}
-/**
- * Loads or creates a task and its history.
- * @param taskId The task ID
- * @param message The message to process
- * @param contextId Optional context ID
- * @param metadata Optional metadata
- * @returns The task and history
- */
-export async function loadState(taskStore, message, metadata, taskId, contextId) {
-    if (taskId) {
-        const existingData = await taskStore.load(taskId);
-        if (existingData) {
-            return {
-                ...existingData,
-                task: {
-                    ...existingData.task,
-                    metadata: {
-                        //we'll update the metadata to ensure it's the latest
-                        ...existingData.task.metadata,
-                        ...metadata,
-                        //we'll update the referencedTasks we have the latest versions
-                        referencedTasks: await getReferences(message.referenceTaskIds ?? [], taskStore),
-                    },
-                },
-            };
-        }
-    }
-    const timestamp = getCurrentTimestamp();
-    const newTask = {
-        id: taskId ?? uuidv4(),
-        contextId: contextId ?? uuidv4(),
-        kind: "task",
-        status: {
-            state: TaskState.submitted,
-            timestamp,
-        },
-        metadata: {
-            ...metadata,
-            //we should only need to load referenceTasks once; on the creation of a new task
-            //we'll store them in the metadata for now until we're sure they will remain in the A2A spec
-            referencedTasks: await getReferences(message.referenceTaskIds ?? [], taskStore),
-        },
-        history: [message],
-    };
-    message.taskId = newTask.id;
-    message.contextId = newTask.contextId;
-    return { task: newTask, history: [] };
-}

package/dist/services/a2a/state/process.d.ts

@@ -1,7 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { TaskAndHistory, TaskStore } from "../../../types/index.js";
-import { UpdateProps } from "./update/update.js";
-export declare function processUpdate(taskStore: TaskStore, updateProps: UpdateProps): Promise<TaskAndHistory>;

package/dist/services/a2a/state/process.js

@@ -1,13 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { updateState } from "./update/update.js";
-export async function processUpdate(taskStore, updateProps) {
-    if (!(await updateState(updateProps))) {
-        console.error("processUpdate: Invalid update", updateProps);
-        throw new Error("processUpdate: Invalid update");
-    }
-    await taskStore.save(updateProps.current);
-    return updateProps.current;
-}