@a2anet/a2a-utils 0.1.0 → 0.4.0

package/dist/files/file-store.d.ts

@@ -0,0 +1,24 @@
+/**
+ * FileStore abstract interface.
+ */
+import type { Artifact } from "@a2a-js/sdk";
+/** Abstract interface for file storage. */
+export interface FileStore {
+    /**
+     * Save file parts from an artifact.
+     *
+     * Returns list of storage locations where files were saved
+     * (e.g. local paths, cloud URIs, etc.).
+     */
+    save(taskId: string, artifact: Artifact): Promise<string[]>;
+    /**
+     * Get storage locations for a saved artifact's files.
+     * Returns empty list if not found.
+     */
+    get(taskId: string, artifactId: string): Promise<string[]>;
+    /**
+     * Delete saved files for an artifact.
+     */
+    delete(taskId: string, artifactId: string): Promise<void>;
+}
+//# sourceMappingURL=file-store.d.ts.map

package/dist/files/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../src/files/file-store.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,2CAA2C;AAC3C,MAAM,WAAW,SAAS;IACtB;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5D;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE3D;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D"}

package/dist/files/file-store.js

@@ -0,0 +1,5 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=file-store.js.map

package/dist/files/file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.js","sourceRoot":"","sources":["../../src/files/file-store.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,sCAAsC"}

package/dist/files/index.d.ts

@@ -0,0 +1,3 @@
+export type { FileStore } from "./file-store.js";
+export { LocalFileStore } from "./local-file-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/files/index.js

@@ -0,0 +1,5 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+export { LocalFileStore } from "./local-file-store.js";
+//# sourceMappingURL=index.js.map

package/dist/files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,sCAAsC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/files/local-file-store.d.ts

@@ -0,0 +1,26 @@
+import type { Artifact } from "@a2a-js/sdk";
+import type { FileStore } from "./file-store.js";
+/**
+ * Store artifact files on the local filesystem.
+ *
+ * Files are saved to ``storageDir/taskId/artifactId/filename``.
+ */
+export declare class LocalFileStore implements FileStore {
+    private readonly storageDir;
+    constructor(storageDir: string);
+    /**
+     * Save file parts from an artifact to disk.
+     *
+     * Returns list of local file paths where files were saved.
+     */
+    save(taskId: string, artifact: Artifact): Promise<string[]>;
+    /**
+     * Get file paths for a saved artifact.
+     *
+     * Returns list of paths, or empty list if directory does not exist.
+     */
+    get(taskId: string, artifactId: string): Promise<string[]>;
+    /** Delete saved files for an artifact. */
+    delete(taskId: string, artifactId: string): Promise<void>;
+}
+//# sourceMappingURL=local-file-store.d.ts.map

package/dist/files/local-file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-store.d.ts","sourceRoot":"","sources":["../../src/files/local-file-store.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,EAAE,MAAM;IAM9B;;;;OAIG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA8CjE;;;;OAIG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBhE,0CAA0C;IACpC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQlE"}

package/dist/files/local-file-store.js

@@ -0,0 +1,99 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * LocalFileStore — filesystem-backed file storage.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+/**
+ * Store artifact files on the local filesystem.
+ *
+ * Files are saved to ``storageDir/taskId/artifactId/filename``.
+ */
+export class LocalFileStore {
+    storageDir;
+    constructor(storageDir) {
+        this.storageDir = storageDir;
+        // Ensure storage dir exists (sync in constructor, matching Python)
+        fs.mkdir(storageDir, { recursive: true }).catch(() => { });
+    }
+    /**
+     * Save file parts from an artifact to disk.
+     *
+     * Returns list of local file paths where files were saved.
+     */
+    async save(taskId, artifact) {
+        const savedPaths = [];
+        const artifactDir = path.join(this.storageDir, taskId, artifact.artifactId);
+        for (let i = 0; i < artifact.parts.length; i++) {
+            const part = artifact.parts[i];
+            if (part.kind !== "file") {
+                continue;
+            }
+            const fileObj = part.file;
+            let name = fileObj.name ? path.basename(fileObj.name) : `file_${i}`;
+            name = name.replace(/\.\./g, "").replace(/^\.+/, "");
+            if (!name) {
+                name = `file_${i}`;
+            }
+            await fs.mkdir(artifactDir, { recursive: true });
+            const filePath = path.join(artifactDir, name);
+            // Path traversal check
+            const resolvedPath = path.resolve(filePath);
+            const resolvedDir = path.resolve(artifactDir);
+            const relative = path.relative(resolvedDir, resolvedPath);
+            if (relative.startsWith("..") || path.isAbsolute(relative)) {
+                throw new Error(`Filename '${fileObj.name}' resolves outside storage directory`);
+            }
+            if ("bytes" in fileObj) {
+                const data = Buffer.from(fileObj.bytes, "base64");
+                await fs.writeFile(filePath, data);
+            }
+            else if ("uri" in fileObj) {
+                const response = await fetch(fileObj.uri);
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                const buffer = Buffer.from(await response.arrayBuffer());
+                await fs.writeFile(filePath, buffer);
+            }
+            savedPaths.push(filePath);
+        }
+        return savedPaths;
+    }
+    /**
+     * Get file paths for a saved artifact.
+     *
+     * Returns list of paths, or empty list if directory does not exist.
+     */
+    async get(taskId, artifactId) {
+        const artifactDir = path.join(this.storageDir, taskId, artifactId);
+        try {
+            const entries = await fs.readdir(artifactDir);
+            const files = [];
+            for (const entry of entries.sort()) {
+                const filePath = path.join(artifactDir, entry);
+                const stat = await fs.stat(filePath);
+                if (stat.isFile()) {
+                    files.push(filePath);
+                }
+            }
+            return files;
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Delete saved files for an artifact. */
+    async delete(taskId, artifactId) {
+        const artifactDir = path.join(this.storageDir, taskId, artifactId);
+        try {
+            await fs.rm(artifactDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore if doesn't exist
+        }
+    }
+}
+//# sourceMappingURL=local-file-store.js.map

package/dist/files/local-file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-store.js","sourceRoot":"","sources":["../../src/files/local-file-store.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export declare const VERSION = "0.4.0";
+export { A2ASession } from "./client/a2a-session.js";
+export { A2ATools } from "./client/a2a-tools.js";
+export { A2AAgents } from "./client/a2a-agents.js";
+export { JSONTaskStore } from "./tasks/json-task-store.js";
+export { DataArtifacts, TextArtifacts, minimizeArtifacts } from "./artifacts/index.js";
+export type { FileStore } from "./files/file-store.js";
+export { LocalFileStore } from "./files/local-file-store.js";
+export type { AgentURLAndCustomHeaders, ArtifactForLLM, DataPartForLLM, FilePartForLLM, MessageForLLM, TaskForLLM, TaskStatusForLLM, TextPartForLLM, } from "./types.js";
+export { ArtifactSettings, TERMINAL_OR_ACTIONABLE_STATES } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGvF,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,YAAY,EACR,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,cAAc,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+export const VERSION = "0.4.0"; // x-release-please-version
+// Core
+export { A2ASession } from "./client/a2a-session.js";
+export { A2ATools } from "./client/a2a-tools.js";
+export { A2AAgents } from "./client/a2a-agents.js";
+export { JSONTaskStore } from "./tasks/json-task-store.js";
+// Artifacts
+export { DataArtifacts, TextArtifacts, minimizeArtifacts } from "./artifacts/index.js";
+export { LocalFileStore } from "./files/local-file-store.js";
+export { ArtifactSettings, TERMINAL_OR_ACTIONABLE_STATES } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,sCAAsC;AAEtC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B;AAE3D,OAAO;AACP,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIvF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAa7D,OAAO,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC"}

package/dist/tasks/index.d.ts

@@ -0,0 +1,2 @@
+export { JSONTaskStore } from "./json-task-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tasks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/tasks/index.js

@@ -0,0 +1,5 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+export { JSONTaskStore } from "./json-task-store.js";
+//# sourceMappingURL=index.js.map

package/dist/tasks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,sCAAsC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/tasks/json-task-store.d.ts

@@ -0,0 +1,32 @@
+import type { Task } from "@a2a-js/sdk";
+import type { TaskStore } from "@a2a-js/sdk/server";
+/**
+ * Persists Task objects as individual JSON files.
+ *
+ * Each task is stored at ``{storageDir}/{taskId}.json``.
+ */
+export declare class JSONTaskStore implements TaskStore {
+    readonly _storageDir: string;
+    constructor(storageDir: string);
+    /**
+     * Save a task to disk.
+     *
+     * @param task - The Task object to persist.
+     */
+    save(task: Task): Promise<void>;
+    /**
+     * Load a task from disk.
+     *
+     * @param taskId - The task ID to look up.
+     *
+     * @returns Task if found, undefined otherwise.
+     */
+    load(taskId: string): Promise<Task | undefined>;
+    /**
+     * Delete a task from disk.
+     *
+     * @param taskId - The task ID to delete.
+     */
+    delete(taskId: string): Promise<void>;
+}
+//# sourceMappingURL=json-task-store.d.ts.map

package/dist/tasks/json-task-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-task-store.d.ts","sourceRoot":"","sources":["../../src/tasks/json-task-store.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,UAAU,EAAE,MAAM;IAM9B;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrC;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IAUrD;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAS9C"}

package/dist/tasks/json-task-store.js

@@ -0,0 +1,66 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * JSON file-based task store implementing the A2A SDK TaskStore interface.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+/**
+ * Persists Task objects as individual JSON files.
+ *
+ * Each task is stored at ``{storageDir}/{taskId}.json``.
+ */
+export class JSONTaskStore {
+    _storageDir;
+    constructor(storageDir) {
+        this._storageDir = storageDir;
+        // Ensure storage dir exists
+        fs.mkdir(storageDir, { recursive: true }).catch(() => { });
+    }
+    /**
+     * Save a task to disk.
+     *
+     * @param task - The Task object to persist.
+     */
+    async save(task) {
+        await fs.mkdir(this._storageDir, { recursive: true });
+        const filePath = path.join(this._storageDir, `${task.id}.json`);
+        const data = JSON.stringify(task, null, 2);
+        await fs.writeFile(filePath, data);
+        console.debug(`Saved task ${task.id} to ${filePath}`);
+    }
+    /**
+     * Load a task from disk.
+     *
+     * @param taskId - The task ID to look up.
+     *
+     * @returns Task if found, undefined otherwise.
+     */
+    async load(taskId) {
+        const filePath = path.join(this._storageDir, `${taskId}.json`);
+        try {
+            const text = await fs.readFile(filePath, "utf-8");
+            return JSON.parse(text);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Delete a task from disk.
+     *
+     * @param taskId - The task ID to delete.
+     */
+    async delete(taskId) {
+        const filePath = path.join(this._storageDir, `${taskId}.json`);
+        try {
+            await fs.unlink(filePath);
+            console.debug(`Deleted task ${taskId}`);
+        }
+        catch {
+            // Ignore if doesn't exist
+        }
+    }
+}
+//# sourceMappingURL=json-task-store.js.map

package/dist/tasks/json-task-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-task-store.js","sourceRoot":"","sources":["../../src/tasks/json-task-store.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,sCAAsC;AAEtC;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACb,WAAW,CAAS;IAE7B,YAAY,UAAkB;QAC1B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,4BAA4B;QAC5B,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,IAAU;QACjB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,EAAE,OAAO,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAS,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC;YACD,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACL,0BAA0B;QAC9B,CAAC;IACL,CAAC;CACJ"}

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Typed interfaces for LLM-facing A2A responses.
+ */
+import type { AgentCard, TaskState } from "@a2a-js/sdk";
+export interface AgentURLAndCustomHeaders {
+    readonly agentCard: AgentCard;
+    readonly customHeaders: Record<string, string>;
+}
+export declare const TERMINAL_OR_ACTIONABLE_STATES: ReadonlySet<string>;
+/** Configuration for artifact minimization and viewing. */
+export declare class ArtifactSettings {
+    readonly sendMessageCharacterLimit: number;
+    readonly minimizedObjectStringLength: number;
+    readonly viewArtifactCharacterLimit: number;
+    constructor(opts?: {
+        sendMessageCharacterLimit?: number;
+        minimizedObjectStringLength?: number;
+        viewArtifactCharacterLimit?: number;
+    });
+}
+export interface TextPartForLLM {
+    readonly kind: "text";
+    readonly text: string;
+    readonly _total_lines?: number;
+    readonly _total_characters?: number;
+    readonly _start_line_range?: string;
+    readonly _end_line_range?: string;
+    readonly _start_character_range?: string;
+    readonly _end_character_range?: string;
+    readonly _tip?: string;
+}
+export interface DataPartForLLM {
+    readonly kind: "data";
+    readonly data: unknown;
+}
+export interface FilePartForLLM {
+    readonly kind: "file";
+    readonly name: string | null;
+    readonly mimeType: string | null;
+    readonly uri: string | Record<string, unknown> | null;
+    readonly bytes: Record<string, unknown> | null;
+}
+export interface ArtifactForLLM {
+    readonly artifactId: string;
+    readonly description: string | null;
+    readonly name: string | null;
+    readonly parts: ReadonlyArray<TextPartForLLM | DataPartForLLM | FilePartForLLM>;
+}
+export interface MessageForLLM {
+    readonly contextId: string | null;
+    readonly kind: "message";
+    readonly parts: ReadonlyArray<TextPartForLLM | DataPartForLLM | FilePartForLLM>;
+}
+export interface TaskStatusForLLM {
+    readonly state: TaskState;
+    readonly message: MessageForLLM | null;
+}
+export interface TaskForLLM {
+    readonly id: string;
+    readonly contextId: string;
+    readonly kind: "task";
+    readonly status: TaskStatusForLLM;
+    readonly artifacts: ReadonlyArray<ArtifactForLLM>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,23 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+export const TERMINAL_OR_ACTIONABLE_STATES = new Set([
+    "completed",
+    "canceled",
+    "failed",
+    "rejected",
+    "input-required",
+    "auth-required",
+]);
+/** Configuration for artifact minimization and viewing. */
+export class ArtifactSettings {
+    sendMessageCharacterLimit;
+    minimizedObjectStringLength;
+    viewArtifactCharacterLimit;
+    constructor(opts) {
+        this.sendMessageCharacterLimit = opts?.sendMessageCharacterLimit ?? 50_000;
+        this.minimizedObjectStringLength = opts?.minimizedObjectStringLength ?? 5_000;
+        this.viewArtifactCharacterLimit = opts?.viewArtifactCharacterLimit ?? 50_000;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,sCAAsC;AAatC,MAAM,CAAC,MAAM,6BAA6B,GAAwB,IAAI,GAAG,CAAS;IAC9E,WAAW;IACX,UAAU;IACV,QAAQ;IACR,UAAU;IACV,gBAAgB;IAChB,eAAe;CAClB,CAAC,CAAC;AAEH,2DAA2D;AAC3D,MAAM,OAAO,gBAAgB;IAChB,yBAAyB,CAAS;IAClC,2BAA2B,CAAS;IACpC,0BAA0B,CAAS;IAE5C,YAAY,IAIX;QACG,IAAI,CAAC,yBAAyB,GAAG,IAAI,EAAE,yBAAyB,IAAI,MAAM,CAAC;QAC3E,IAAI,CAAC,2BAA2B,GAAG,IAAI,EAAE,2BAA2B,IAAI,KAAK,CAAC;QAC9E,IAAI,CAAC,0BAA0B,GAAG,IAAI,EAAE,0BAA0B,IAAI,MAAM,CAAC;IACjF,CAAC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@a2anet/a2a-utils",
-    "version": "0.1.0",
+    "version": "0.4.0",
     "description": "A collection of utilities for discovering, communicating, and authenticating with A2A Servers",
     "type": "module",
     "exports": {
@@ -11,7 +11,9 @@
     },
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
-    "files": ["dist"],
+    "files": [
+        "dist"
+    ],
     "scripts": {
         "build": "tsc",
         "check": "biome check .",
@@ -20,7 +22,11 @@
         "test": "bun test",
         "test:coverage": "bun test --coverage"
     },
-    "keywords": ["a2a", "agent-to-agent", "utilities"],
+    "keywords": [
+        "a2a",
+        "agent-to-agent",
+        "utilities"
+    ],
     "author": "A2A Net <hello@a2anet.com>",
     "license": "Apache-2.0",
     "repository": {
@@ -31,10 +37,17 @@
         "url": "https://github.com/a2anet/a2a-utils/issues"
     },
     "homepage": "https://github.com/a2anet/a2a-utils#readme",
+    "dependencies": {
+        "@a2a-js/sdk": "^0.3.10",
+        "uuid": "^11.1.0"
+    },
     "devDependencies": {
         "@biomejs/biome": "^1.9.0",
         "@types/bun": "latest",
+        "@types/uuid": "^10.0.0",
         "typescript": "^5.7.0"
     },
-    "trustedDependencies": ["@biomejs/biome"]
+    "trustedDependencies": [
+        "@biomejs/biome"
+    ]
 }