@artinet/sdk 0.5.17 → 0.6.0-preview.1

package/dist/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/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/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/types/schemas/index.d.ts

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

package/dist/types/schemas/index.js

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

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

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

package/dist/utils/logging/index.js

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

package/dist/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/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/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/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/utils/storage/memory.d.ts

@@ -1,25 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { TaskAndHistory, TaskManagerInterface } from "../../types/index.js";
-/**
- * In-memory implementation of the TaskStore interface.
- * Stores tasks and their history in memory. Not persisted between server restarts.
- */
-export declare class InMemoryTaskStore implements TaskManagerInterface<TaskAndHistory> {
-    private store;
-    /**
-     * Loads a task and its history by task ID.
-     * @param taskId The ID of the task to load.
-     * @returns A promise resolving to the task and history, or null if not found.
-     */
-    getState(taskId: string): Promise<TaskAndHistory | undefined>;
-    /**
-     * Saves a task and its history.
-     * @param data The task and history to save.
-     * @returns A promise that resolves when the save is complete.
-     */
-    setState(taskId: string, data: TaskAndHistory): Promise<void>;
-    getStates(): Promise<string[]>;
-}

package/dist/utils/storage/memory.js

@@ -1,47 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { logDebug } from "../logging/log.js";
-/**
- * In-memory implementation of the TaskStore interface.
- * Stores tasks and their history in memory. Not persisted between server restarts.
- */
-export class InMemoryTaskStore {
-    store = new Map();
-    /**
-     * Loads a task and its history by task ID.
-     * @param taskId The ID of the task to load.
-     * @returns A promise resolving to the task and history, or null if not found.
-     */
-    async getState(taskId) {
-        logDebug("InMemoryTaskStore", `Loading task: ${taskId}`);
-        const entry = this.store.get(taskId);
-        // Return copies to prevent external mutation
-        return entry
-            ? {
-                task: { ...entry.task },
-                history: [...entry.history],
-            }
-            : undefined;
-    }
-    /**
-     * Saves a task and its history.
-     * @param data The task and history to save.
-     * @returns A promise that resolves when the save is complete.
-     */
-    async setState(taskId, data) {
-        logDebug("InMemoryTaskStore", `Saving task: ${data.task.id}`);
-        if (taskId !== data.task.id) {
-            throw new Error("Task ID mismatch");
-        }
-        // Store copies to prevent internal mutation if caller reuses objects
-        this.store.set(taskId, {
-            task: { ...data.task },
-            history: [...data.history],
-        });
-    }
-    async getStates() {
-        return Array.from(this.store.keys());
-    }
-}