@artinet/sdk 0.5.18 → 0.6.0-preview.2

package/dist/services/a2a/state/update/artifact.d.ts

@@ -1,10 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { Artifact } from "../../../../types/index.js";
-export declare function updateByIndex(append: boolean, artifacts: Artifact[], index: number, artifactUpdate: Artifact): {
-    artifacts: Artifact[];
-    replaced: boolean;
-};
-export declare function processArtifactUpdate(append: boolean, artifacts: Artifact[], artifactUpdate: Artifact): Artifact[];

package/dist/services/a2a/state/update/artifact.js

@@ -1,39 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export function updateByIndex(append, artifacts, index, artifactUpdate) {
-    if (append) {
-        const existingArtifact = artifacts[index];
-        existingArtifact.parts.push(...artifactUpdate.parts);
-        if (artifactUpdate.metadata) {
-            existingArtifact.metadata = {
-                ...(existingArtifact.metadata || {}),
-                ...artifactUpdate.metadata,
-            };
-        }
-        if (artifactUpdate.description) {
-            existingArtifact.description = artifactUpdate.description;
-        }
-        if (artifactUpdate.name) {
-            existingArtifact.name = artifactUpdate.name;
-        }
-        artifacts[index] = existingArtifact;
-    }
-    else {
-        artifacts[index] = { ...artifactUpdate };
-    }
-    return { artifacts, replaced: true };
-}
-export function processArtifactUpdate(append, artifacts, artifactUpdate) {
-    const existingIndex = artifacts.findIndex((a) => a.artifactId === artifactUpdate.artifactId);
-    let replaced = false;
-    let newArtifacts = artifacts;
-    if (existingIndex !== -1) {
-        ({ artifacts: newArtifacts, replaced } = updateByIndex(append, artifacts, existingIndex, artifactUpdate));
-    }
-    if (!replaced) {
-        newArtifacts.push({ ...artifactUpdate });
-    }
-    return newArtifacts;
-}

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

@@ -1,2 +0,0 @@
-export * from "./update.js";
-export * from "./artifact.js";

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

@@ -1,2 +0,0 @@
-export * from "./update.js";
-export * from "./artifact.js";

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

@@ -1,23 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { TaskContext, Message, Task, TaskArtifactUpdateEvent, TaskStatusUpdateEvent, UpdateEvent, TaskAndHistory } from "../../../../types/index.js";
-export declare enum UpdateKind {
-    Message = "message",
-    Task = "task",
-    StatusUpdate = "status-update",
-    ArtifactUpdate = "artifact-update"
-}
-export interface UpdateProps<T extends UpdateEvent = UpdateEvent> {
-    context: TaskContext;
-    current: TaskAndHistory;
-    update: T;
-}
-type UpdateFunction<T extends UpdateEvent> = (props: UpdateProps<T>) => Promise<boolean>;
-export declare const updateMessage: UpdateFunction<Message>;
-export declare const updateTask: UpdateFunction<Task>;
-export declare const updateTaskStatusUpdate: UpdateFunction<TaskStatusUpdateEvent>;
-export declare const updateTaskArtifactUpdate: UpdateFunction<TaskArtifactUpdateEvent>;
-export declare const updateState: UpdateFunction<UpdateEvent>;
-export {};

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

@@ -1,123 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { getCurrentTimestamp } from "../../../../utils/index.js";
-import { logError } from "../../../../utils/logging/index.js";
-import { processArtifactUpdate } from "./artifact.js";
-export var UpdateKind;
-(function (UpdateKind) {
-    UpdateKind["Message"] = "message";
-    UpdateKind["Task"] = "task";
-    UpdateKind["StatusUpdate"] = "status-update";
-    UpdateKind["ArtifactUpdate"] = "artifact-update";
-})(UpdateKind || (UpdateKind = {}));
-const isMessageInHistory = (task, message) => {
-    return task.history?.find((msg) => msg.messageId === message.messageId);
-};
-const updateHistory = (current, updateMessage) => {
-    if (!isMessageInHistory(current.task, updateMessage)) {
-        // current.history = [...(current.history ?? []), updateMessage]; deprecating history
-        current.task.history = [...(current.task.history ?? []), updateMessage];
-    }
-};
-export const updateMessage = async (props) => {
-    const { context, update } = props;
-    if (!update || update.kind !== UpdateKind.Message) {
-        logError("updateMessage", "Invalid update", update);
-        return false;
-    }
-    context.latestUserMessage = update;
-    return true;
-};
-export const updateTask = async (props) => {
-    const { context, current, update } = props;
-    if (!update || update.kind !== UpdateKind.Task) {
-        logError("updateTask", "Invalid update kind", update);
-        return false;
-    }
-    current.task = { ...current.task, ...update };
-    if (context.latestUserMessage &&
-        !isMessageInHistory(current.task, context.latestUserMessage)) {
-        //todo seems that we can use updateHistory here instead (will change after we deprecate history fully & add update specific tests)
-        current.task.history = [
-            context.latestUserMessage,
-            ...(current.task.history ?? []),
-        ];
-        // current.history = [context.latestUserMessage, ...(current.history ?? [])]; deprecating history
-    }
-    return true;
-};
-export const updateTaskStatusUpdate = async (props) => {
-    const { current, update } = props;
-    if (!update || update.kind !== UpdateKind.StatusUpdate) {
-        logError("updateTaskStatusUpdate", "Invalid update kind", update);
-        return false;
-    }
-    if (current.task.id === update.taskId) {
-        current.task.status = update.status;
-        current.task.status.timestamp = getCurrentTimestamp();
-        if (update.status.message) {
-            updateHistory(current, update.status.message);
-        }
-        return true;
-    }
-    logError("updateTaskStatusUpdate", "Invalid task id", update);
-    return false;
-};
-export const updateTaskArtifactUpdate = async (props) => {
-    const { current, update } = props;
-    if (!update || update.kind !== UpdateKind.ArtifactUpdate) {
-        logError("updateTaskArtifactUpdate", "Invalid update kind", update);
-        return false;
-    }
-    if (current.task.id === update.taskId) {
-        current.task.artifacts = processArtifactUpdate(update.append ?? false, current.task.artifacts ?? [], update.artifact);
-        return true;
-    }
-    logError("updateTaskArtifactUpdate", "Invalid task id", update); //we should never get here, but just in case
-    return true;
-};
-export const updateState = async (props) => {
-    const { context, current, update } = props;
-    if (!update || !update.kind) {
-        logError("update", "Invalid update", update);
-        return false;
-    }
-    if (!current || !current.task || !current.task.id) {
-        logError("update", "Invalid current", current);
-        return false;
-    }
-    if (!context || !context.contextId) {
-        logError("update", "Invalid context", context);
-        return false;
-    }
-    switch (update.kind) {
-        case UpdateKind.Message:
-            return updateMessage({
-                context,
-                current,
-                update: update,
-            });
-        case UpdateKind.Task:
-            return updateTask({
-                context,
-                current,
-                update: update,
-            });
-        case UpdateKind.StatusUpdate:
-            return updateTaskStatusUpdate({
-                context,
-                current,
-                update: update,
-            });
-        case UpdateKind.ArtifactUpdate:
-            return updateTaskArtifactUpdate({
-                context,
-                current,
-                update: update,
-            });
-        default:
-            return false;
-    }
-};

package/dist/services/core/execution/execute.d.ts

@@ -1,6 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { ExecutionEngine, CoreState, CoreUpdate, CoreContext, CoreCommand } from "../../../types/index.js";
-export declare const coreExecute: <TCommand extends CoreCommand = CoreCommand, TUpdate extends CoreUpdate = CoreUpdate, TState extends CoreState = CoreState, TContext extends CoreContext<TCommand, TState, TUpdate> = CoreContext<TCommand, TState, TUpdate>>(engine: ExecutionEngine<TCommand, TState, TUpdate>, context: TContext) => Promise<void>;

package/dist/services/core/execution/execute.js

@@ -1,25 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export const coreExecute = async (engine, context) => {
-    try {
-        if (context.events.onStart) {
-            await context.events.onStart(context);
-        }
-        for await (const update of engine(context)) {
-            if (context.isCancelled() || context.signal.aborted) {
-                await context.events.onCancel(update);
-                break;
-            }
-            await context.events.onUpdate(update);
-        }
-    }
-    catch (error) {
-        context.events.onError(error);
-        throw error;
-    }
-    finally {
-        context.events.onComplete();
-    }
-};

package/dist/services/core/execution/index.d.ts

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

package/dist/services/core/execution/index.js

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

package/dist/services/core/managers/command.d.ts

@@ -1,39 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { CoreCommand, CommandChannelInterface, CommandChannelProxyInterface, CommandChannelMap } from "../../../types/index.js";
-import { EventEmitter } from "events";
-export declare class CommandChannel<TCommand extends CoreCommand = CoreCommand> extends EventEmitter<CommandChannelMap<TCommand>> implements CommandChannelInterface<TCommand> {
-    private readonly _command;
-    private commands;
-    private resolvers;
-    private done;
-    /**
-     * @param command - The initial command to send
-     * @note The initial command is tied to the channel and cannot be changed
-     */
-    constructor(_command: TCommand);
-    /**
-     * @returns True if the channel is open
-     */
-    get isOpen(): boolean;
-    /**
-     * @returns The list of commands
-     */
-    get commandList(): TCommand[];
-    /**
-     * @returns The current command
-     */
-    get command(): TCommand;
-    /**
-     * @returns The command channel as an async iterable
-     */
-    [Symbol.asyncIterator](): AsyncIterableIterator<TCommand, TCommand, TCommand | undefined>;
-    valueOf(): TCommand;
-    send(command: TCommand): void;
-    close(): void;
-    next(): Promise<IteratorResult<TCommand>>;
-    return(value: TCommand): Promise<IteratorResult<TCommand>>;
-    static create<TCommand extends CoreCommand = CoreCommand>(command: TCommand): CommandChannelProxyInterface<TCommand>;
-}

package/dist/services/core/managers/event.d.ts

@@ -1,18 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { EventEmitter } from "events";
-import { EventManagerInterface, EventManagerOptions, CoreCommand, CoreState, CoreUpdate, CoreContext, EventManagerMap } from "../../../types/index.js";
-export declare class EventManager<TCommand extends CoreCommand = CoreCommand, TState extends CoreState = CoreState, TUpdate extends CoreUpdate = CoreUpdate> extends EventEmitter<EventManagerMap<TCommand, TState, TUpdate>> implements EventManagerInterface<TCommand, TState, TUpdate> {
-    readonly contextId: string;
-    private currentState;
-    private options;
-    constructor(contextId: string, options?: EventManagerOptions<TCommand, TState, TUpdate>);
-    onStart: (context: CoreContext<TCommand, TState, TUpdate>) => Promise<TState>;
-    onCancel: (nextState: TUpdate) => Promise<void>;
-    onUpdate: (nextState: TUpdate) => Promise<TState>;
-    onError: (error: any) => Promise<void>;
-    onComplete: () => Promise<void>;
-    getState: () => TState;
-}

package/dist/services/core/managers/event.js

@@ -1,56 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { EventEmitter } from "events";
-export class EventManager extends EventEmitter {
-    contextId;
-    currentState = {};
-    options;
-    constructor(contextId, options = {}) {
-        super();
-        this.contextId = contextId;
-        this.options = options;
-    }
-    onStart = async (context) => {
-        if (this.options.onStart) {
-            this.currentState = await this.options.onStart(context);
-        }
-        this.emit("start", context.command, this.currentState);
-        return this.currentState;
-    };
-    onCancel = async (nextState) => {
-        if (this.options.onCancel) {
-            await this.options.onCancel(this.currentState, nextState);
-        }
-        this.emit("cancel", nextState);
-    };
-    onUpdate = async (nextState) => {
-        if (this.options.onUpdate) {
-            this.currentState = await this.options.onUpdate(this.currentState, nextState);
-        }
-        else {
-            this.currentState = nextState;
-        }
-        this.emit("update", this.currentState, nextState);
-        return this.currentState;
-    };
-    onError = async (error) => {
-        if (this.options.onError) {
-            await this.options.onError(this.currentState, error);
-        }
-        this.emit("error", error, this.currentState);
-    };
-    onComplete = async () => {
-        if (this.options.onComplete) {
-            await this.options.onComplete(this.currentState);
-        }
-        this.emit("complete", this.currentState);
-    };
-    getState = () => {
-        if (this.options.getState) {
-            return this.options.getState();
-        }
-        return this.currentState;
-    };
-}

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

@@ -1,3 +0,0 @@
-export * from "./command.js";
-export * from "./event.js";
-export * from "./stream.js";

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

@@ -1,3 +0,0 @@
-export * from "./command.js";
-export * from "./event.js";
-export * from "./stream.js";

package/dist/services/core/managers/stream.d.ts

@@ -1,20 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { StreamManagerInterface, ExecutionEngine, CoreContext, ServiceInterface, CoreCommand, CoreState, CoreUpdate } from "../../../types/index.js";
-export declare class StreamManager<TCommand extends CoreCommand = CoreCommand, TState extends CoreState = CoreState, TUpdate extends CoreUpdate = CoreUpdate> implements StreamManagerInterface<TCommand, TState, TUpdate> {
-    private contextId;
-    private completed;
-    private updates;
-    private executionContext;
-    constructor(executionContext?: CoreContext<TCommand, TState, TUpdate>);
-    getContextId(): string;
-    addUpdate(update: TUpdate): void;
-    getUpdates(): TUpdate[];
-    isCompleted(): boolean;
-    setCompleted(): void;
-    getExecutionContext(): CoreContext<TCommand, TState, TUpdate>;
-    setExecutionContext(executionContext: CoreContext<TCommand, TState, TUpdate>): void;
-    stream(engine: ExecutionEngine<TCommand, TState, TUpdate>, service?: ServiceInterface<TCommand, TState, TUpdate>): AsyncGenerator<Awaited<NonNullable<TUpdate>>, void, unknown>;
-}

package/dist/services/core/managers/stream.js

@@ -1,77 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { coreExecute } from "../execution/execute.js";
-export class StreamManager {
-    contextId = null;
-    completed = false;
-    updates = [];
-    executionContext = null;
-    constructor(executionContext) {
-        if (executionContext) {
-            this.executionContext = executionContext;
-            this.contextId = executionContext.events.contextId;
-        }
-        this.completed = false;
-        this.updates = [];
-    }
-    getContextId() {
-        if (!this.contextId) {
-            throw new Error("Context id not set");
-        }
-        return this.contextId;
-    }
-    addUpdate(update) {
-        this.updates.push(update);
-    }
-    getUpdates() {
-        return this.updates;
-    }
-    isCompleted() {
-        return this.completed;
-    }
-    setCompleted() {
-        this.completed = true;
-    }
-    getExecutionContext() {
-        if (!this.executionContext) {
-            throw new Error("Execution context not set");
-        }
-        return this.executionContext;
-    }
-    setExecutionContext(executionContext) {
-        this.executionContext = executionContext;
-        this.contextId = executionContext.events.contextId;
-    }
-    async *stream(engine, service) {
-        let executionError = null;
-        const context = this.getExecutionContext();
-        context.events.on("update", (_, update) => {
-            if (!context.isCancelled()) {
-                this.addUpdate(update);
-            }
-        });
-        const executePromise = (service ? service.execute(engine, context) : coreExecute(engine, context))
-            .catch((error) => {
-            executionError = error;
-        })
-            .finally(() => {
-            this.setCompleted();
-        });
-        while (!this.isCompleted() || this.getUpdates().length > 0) {
-            if (executionError) {
-                throw executionError;
-            }
-            if (this.getUpdates().length > 0) {
-                yield this.getUpdates().shift();
-            }
-            await new Promise((resolve) => setTimeout(resolve, 10));
-        }
-        await executePromise;
-        this.setCompleted();
-        if (executionError) {
-            throw executionError;
-        }
-    }
-}

package/dist/types/ext.d.ts

@@ -1,13 +0,0 @@
-/**
- * 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";

package/dist/types/ext.js

@@ -1,10 +0,0 @@
-/**
- * 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";

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

@@ -1,3 +0,0 @@
-export * from "./services/index.js";
-export * from "./storage.js";
-export * from "./client.js";

package/dist/types/interfaces/index.js

@@ -1,3 +0,0 @@
-export * from "./services/index.js";
-export * from "./storage.js";
-export * from "./client.js";

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

@@ -1,37 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-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;
-    context: Context;
-}
-export type StepParams<TCommand extends Command = Command, TInboundArgs extends readonly unknown[] = []> = StepArgs<TCommand> & Partial<{
-    content: string;
-    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>>;
-}

package/dist/types/interfaces/services/a2a/builder.js

@@ -1,5 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export {};