@a2anet/a2a-utils 0.1.0 → 0.3.0

package/dist/client/agent-manager.js

@@ -0,0 +1,243 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Agent management for A2A applications.
+ */
+import * as fs from "node:fs";
+import { DefaultAgentCardResolver } from "@a2a-js/sdk/client";
+/**
+ * Manages A2A agent cards keyed by user-defined agent IDs.
+ *
+ * Agents are configured via a dict mapping agent_id to config, or a JSON file path.
+ */
+export class AgentManager {
+    config;
+    agents = {};
+    initErrors = {};
+    initialized = false;
+    initPromise = null;
+    timeout;
+    /**
+     * Initialize the agent manager.
+     *
+     * @param agents - Agent config as:
+     *   - object: {"agent-id": {"url": "https://...", "custom_headers": {"X-API-Key": "..."}}}
+     *   - string: path to agents.json file with the same structure
+     *   - null: empty, add agents later
+     * @param opts.timeout - HTTP timeout in seconds for fetching agent cards (default: 15s).
+     */
+    constructor(agents = null, opts) {
+        this.timeout = opts?.timeout ?? 15.0;
+        this.config = this.loadConfig(agents);
+    }
+    /** Load and validate agent config. */
+    loadConfig(agents) {
+        if (agents === null) {
+            return {};
+        }
+        if (typeof agents === "string") {
+            const text = fs.readFileSync(agents, "utf-8");
+            return JSON.parse(text);
+        }
+        return { ...agents };
+    }
+    /** Lazily fetch all agent cards on first use (double-check locking). */
+    async ensureInitialized() {
+        if (this.initialized)
+            return;
+        // Single-flight pattern
+        if (this.initPromise === null) {
+            this.initPromise = this.doInitialize();
+        }
+        await this.initPromise;
+    }
+    async doInitialize() {
+        if (this.initialized)
+            return;
+        if (Object.keys(this.config).length === 0) {
+            console.warn("No agents configured");
+            this.initialized = true;
+            return;
+        }
+        const entries = Object.entries(this.config);
+        const results = await Promise.allSettled(entries.map(([agentId, cfg]) => this.fetchAgent(agentId, cfg)));
+        this.initErrors = {};
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            if (result.status === "rejected") {
+                const aid = entries[i][0];
+                const url = this.config[aid]?.url ?? "unknown";
+                const reason = result.reason;
+                const errorMsg = `${reason?.constructor?.name ?? "Error"}: ${reason}`;
+                this.initErrors[aid] = errorMsg;
+                console.error(`Error loading agent '${aid}' from ${url}: ${errorMsg}`);
+            }
+        }
+        if (Object.keys(this.agents).length > 0) {
+            console.info(`Successfully initialized ${Object.keys(this.agents).length} agent(s)`);
+        }
+        else {
+            console.warn("No agents were successfully initialized");
+        }
+        this.initialized = true;
+    }
+    /** Fetch a single agent card and register it. */
+    async fetchAgent(agentId, config) {
+        const url = config.url;
+        const customHeaders = config.custom_headers ?? {};
+        const [baseUrl, cardPath] = this.parseAgentCardUrl(url);
+        const resolver = new DefaultAgentCardResolver({
+            fetchImpl: this.createFetchImpl(customHeaders),
+        });
+        const agentCard = await resolver.resolve(baseUrl, cardPath);
+        this.agents[agentId] = {
+            agentCard,
+            customHeaders,
+        };
+    }
+    /** Create a fetch implementation that applies the configured timeout and custom headers. */
+    createFetchImpl(customHeaders) {
+        const wrappedFetch = (input, init) => {
+            const timeoutSignal = AbortSignal.timeout(this.timeout * 1000);
+            const signal = init?.signal != null
+                ? AbortSignal.any([init.signal, timeoutSignal])
+                : timeoutSignal;
+            const mergedInit = {
+                ...init,
+                signal,
+                headers: {
+                    ...init?.headers,
+                    ...customHeaders,
+                },
+            };
+            return fetch(input, mergedInit);
+        };
+        wrappedFetch.preconnect = fetch.preconnect;
+        return wrappedFetch;
+    }
+    /** Parse agent card URL into base_url and card_path. */
+    parseAgentCardUrl(url) {
+        const parsed = new URL(url);
+        const baseUrl = `${parsed.protocol}//${parsed.host}`;
+        const cardPath = parsed.pathname;
+        return [baseUrl, cardPath];
+    }
+    /**
+     * Register a new agent at runtime.
+     *
+     * @param agentId - User-defined agent identifier.
+     * @param url - Agent card URL.
+     * @param customHeaders - Optional custom HTTP headers.
+     *
+     * @throws Error if agentId is already registered.
+     */
+    async addAgent(agentId, url, customHeaders) {
+        await this.ensureInitialized();
+        if (agentId in this.agents) {
+            throw new Error(`Agent '${agentId}' is already registered`);
+        }
+        const config = {
+            url,
+            custom_headers: customHeaders ?? {},
+        };
+        await this.fetchAgent(agentId, config);
+    }
+    /**
+     * Retrieve agent by ID.
+     *
+     * @param agentId - User-defined agent identifier.
+     *
+     * @returns AgentURLAndCustomHeaders, or null if not found.
+     */
+    async getAgent(agentId) {
+        await this.ensureInitialized();
+        return this.agents[agentId] ?? null;
+    }
+    /**
+     * Get errors from the most recent initialization attempt.
+     *
+     * @returns Object mapping agent_id to error message for agents that failed to load.
+     */
+    get initializationErrors() {
+        return { ...this.initErrors };
+    }
+    /**
+     * Get all registered agents.
+     *
+     * @returns Object mapping agent_id to AgentURLAndCustomHeaders.
+     */
+    async getAgents() {
+        await this.ensureInitialized();
+        return { ...this.agents };
+    }
+    /**
+     * Format a single agent card into a summary object.
+     *
+     * @param card - The agent card to format.
+     * @param detail - Detail level — "name", "basic", "skills", or "full".
+     *
+     * @returns Summary object for the agent.
+     */
+    formatAgentForLlm(card, detail) {
+        if (detail === "name") {
+            return { name: card.name };
+        }
+        if (detail === "basic") {
+            return { name: card.name, description: card.description };
+        }
+        if (detail === "skills") {
+            const skillNames = card.skills ? card.skills.map((s) => s.name) : [];
+            return {
+                name: card.name,
+                description: card.description,
+                skills: skillNames,
+            };
+        }
+        // "full"
+        const skills = [];
+        if (card.skills) {
+            for (const s of card.skills) {
+                skills.push({ name: s.name, description: s.description ?? "" });
+            }
+        }
+        return {
+            name: card.name,
+            description: card.description,
+            skills,
+        };
+    }
+    /**
+     * Generate summary for a single agent.
+     *
+     * @param agentId - User-defined agent identifier.
+     * @param detail - Detail level — "name", "basic", "skills", or "full".
+     *
+     * @returns Summary object for the agent, or null if not found.
+     */
+    async getAgentForLlm(agentId, detail = "basic") {
+        await this.ensureInitialized();
+        const agent = this.agents[agentId];
+        if (!agent) {
+            return null;
+        }
+        return this.formatAgentForLlm(agent.agentCard, detail);
+    }
+    /**
+     * Generate summary of all agents.
+     *
+     * @param detail - Detail level — "name", "basic", "skills", or "full".
+     *
+     * @returns Object mapping agent_id to summary object, sorted by agent_id.
+     */
+    async getAgentsForLlm(detail = "basic") {
+        await this.ensureInitialized();
+        const result = {};
+        const sortedKeys = Object.keys(this.agents).sort();
+        for (const agentId of sortedKeys) {
+            result[agentId] = this.formatAgentForLlm(this.agents[agentId].agentCard, detail);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=agent-manager.js.map

package/dist/client/agent-manager.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,4 @@
+export { A2ASession } from "./a2a-session.js";
+export { A2ATools } from "./a2a-tools.js";
+export { AgentManager } from "./agent-manager.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,7 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+export { A2ASession } from "./a2a-session.js";
+export { A2ATools } from "./a2a-tools.js";
+export { AgentManager } from "./agent-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,sCAAsC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

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.2.0";
+export { A2ASession } from "./client/a2a-session.js";
+export { A2ATools } from "./client/a2a-tools.js";
+export { AgentManager } from "./client/agent-manager.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,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,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.2.0"; // x-release-please-version
+// Core
+export { A2ASession } from "./client/a2a-session.js";
+export { A2ATools } from "./client/a2a-tools.js";
+export { AgentManager } from "./client/agent-manager.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,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,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"}