@a2aletheia/sdk 0.2.1 → 0.2.2

package/dist/agent/index.d.ts

@@ -1,6 +1,8 @@
 export { AletheiaAgent } from "./aletheia-agent.js";
 export { AgentResponse } from "./agent-response.js";
 export { AgentContextImpl } from "./agent-context.js";
+export { RedisTaskStore } from "./redis-task-store.js";
+export type { RedisTaskStoreOptions, RedisLike, } from "./redis-task-store.js";
 export type { AletheiaAgentConfig, AletheiaExtensions, AgentHandler, CancelHandler, AgentContext, Part, TextPart, DataPart, FilePart, Artifact, AgentCard, AgentSkill, AgentCapabilities, Message, Task, TaskState, TaskStatus, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, ExecutionEventBus, TaskStore, AgentExecutionEvent, AgentExecutor, } from "./types.js";
 export { InMemoryTaskStore, A2AError, RequestContext, DefaultExecutionEventBus, } from "@a2a-js/sdk/server";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,YAAY,EAEZ,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,IAAI,EACJ,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,SAAS,EACT,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACd,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EACV,qBAAqB,EACrB,SAAS,GACV,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,YAAY,EAEZ,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,IAAI,EACJ,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,SAAS,EACT,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACd,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/agent/index.js

@@ -4,6 +4,8 @@ export { AletheiaAgent } from "./aletheia-agent.js";
 export { AgentResponse } from "./agent-response.js";
 // Context implementation
 export { AgentContextImpl } from "./agent-context.js";
+// Redis task store
+export { RedisTaskStore } from "./redis-task-store.js";
 // Re-export useful classes from @a2a-js/sdk/server
 export { InMemoryTaskStore, A2AError, RequestContext, DefaultExecutionEventBus, } from "@a2a-js/sdk/server";
 //# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,yBAAyB;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AA8BtD,mDAAmD;AACnD,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACd,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,yBAAyB;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAkCvD,mDAAmD;AACnD,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACd,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/agent/redis-task-store.d.ts

@@ -0,0 +1,40 @@
+import type { Task } from "@a2a-js/sdk";
+import type { TaskStore } from "@a2a-js/sdk/server";
+/**
+ * Minimal subset of a Redis client that {@link RedisTaskStore} needs.
+ * Compatible with ioredis, node-redis v4, and most Redis client libraries.
+ */
+export interface RedisLike {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ...args: unknown[]): Promise<unknown>;
+    del(...args: unknown[]): Promise<unknown>;
+}
+export interface RedisTaskStoreOptions {
+    /** Key prefix. Default: `"aletheia:task:"` */
+    prefix?: string;
+    /** TTL in seconds. Default: `86400` (24 hours). Set to `0` to disable. */
+    ttlSeconds?: number;
+}
+/**
+ * A {@link TaskStore} backed by any Redis-like client.
+ *
+ * @example
+ * ```ts
+ * import IORedis from "ioredis";
+ * import { RedisTaskStore } from "@a2aletheia/sdk/agent";
+ *
+ * const redis = new IORedis("redis://localhost:6379");
+ * const taskStore = new RedisTaskStore(redis, { ttlSeconds: 3600 });
+ *
+ * const agent = new AletheiaAgent({ taskStore, ... });
+ * ```
+ */
+export declare class RedisTaskStore implements TaskStore {
+    private readonly redis;
+    private readonly prefix;
+    private readonly ttl;
+    constructor(redis: RedisLike, options?: RedisTaskStoreOptions);
+    save(task: Task): Promise<void>;
+    load(taskId: string): Promise<Task | undefined>;
+}
+//# sourceMappingURL=redis-task-store.d.ts.map

package/dist/agent/redis-task-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-task-store.d.ts","sourceRoot":"","sources":["../../src/agent/redis-task-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAMvD,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;CAStD"}

package/dist/agent/redis-task-store.js

@@ -0,0 +1,48 @@
+const DEFAULT_PREFIX = "aletheia:task:";
+const DEFAULT_TTL = 86400; // 24 hours
+/**
+ * A {@link TaskStore} backed by any Redis-like client.
+ *
+ * @example
+ * ```ts
+ * import IORedis from "ioredis";
+ * import { RedisTaskStore } from "@a2aletheia/sdk/agent";
+ *
+ * const redis = new IORedis("redis://localhost:6379");
+ * const taskStore = new RedisTaskStore(redis, { ttlSeconds: 3600 });
+ *
+ * const agent = new AletheiaAgent({ taskStore, ... });
+ * ```
+ */
+export class RedisTaskStore {
+    redis;
+    prefix;
+    ttl;
+    constructor(redis, options) {
+        this.redis = redis;
+        this.prefix = options?.prefix ?? DEFAULT_PREFIX;
+        this.ttl = options?.ttlSeconds ?? DEFAULT_TTL;
+    }
+    async save(task) {
+        const key = `${this.prefix}${task.id}`;
+        const value = JSON.stringify(task);
+        if (this.ttl > 0) {
+            await this.redis.set(key, value, "EX", this.ttl);
+        }
+        else {
+            await this.redis.set(key, value);
+        }
+    }
+    async load(taskId) {
+        const raw = await this.redis.get(`${this.prefix}${taskId}`);
+        if (!raw)
+            return undefined;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=redis-task-store.js.map

package/dist/agent/redis-task-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-task-store.js","sourceRoot":"","sources":["../../src/agent/redis-task-store.ts"],"names":[],"mappings":"AAoBA,MAAM,cAAc,GAAG,gBAAgB,CAAC;AACxC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,WAAW;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,cAAc;IACR,KAAK,CAAY;IACjB,MAAM,CAAS;IACf,GAAG,CAAS;IAE7B,YAAY,KAAgB,EAAE,OAA+B;QAC3D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,cAAc,CAAC;QAChD,IAAI,CAAC,GAAG,GAAG,OAAO,EAAE,UAAU,IAAI,WAAW,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAU;QACnB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAS,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -1,65 +1,65 @@
-{
-  "name": "@a2aletheia/sdk",
-  "version": "0.2.1",
-  "description": "SDK for integrating with the Aletheia A2A Agent Discovery Registry",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./agent": {
-      "types": "./dist/agent/index.d.ts",
-      "default": "./dist/agent/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "keywords": [
-    "a2a",
-    "agent",
-    "discovery",
-    "aletheia",
-    "multi-agent",
-    "ai-agents"
-  ],
-  "author": "",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/weedeej/aletheia"
-  },
-  "dependencies": {
-    "@a2a-js/sdk": "^0.2.5",
-    "@noble/ed25519": "^2.1.0",
-    "@noble/hashes": "^2.0.1",
-    "viem": "^2.21.0",
-    "zod": "^3.24.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.21",
-    "rimraf": "^6.0.1",
-    "@types/node": "^20",
-    "typescript": "^5.9.2",
-    "vitest": "^2.1.0"
-  },
-  "peerDependencies": {
-    "express": ">=4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "express": {
-      "optional": true
-    }
-  },
-  "scripts": {
-    "build": "tsc",
-    "check-types": "tsc --noEmit",
-    "lint": "eslint .",
-    "test": "vitest run",
-    "clean": "rimraf dist"
-  }
-}
+{
+  "name": "@a2aletheia/sdk",
+  "version": "0.2.2",
+  "description": "SDK for integrating with the Aletheia A2A Agent Discovery Registry",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "default": "./dist/agent/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "clean": "rimraf dist"
+  },
+  "keywords": [
+    "a2a",
+    "agent",
+    "discovery",
+    "aletheia",
+    "multi-agent",
+    "ai-agents"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/weedeej/aletheia"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "^0.2.5",
+    "@noble/ed25519": "^2.1.0",
+    "@noble/hashes": "^2.0.1",
+    "viem": "^2.21.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "rimraf": "^6.0.1",
+    "@types/node": "^20",
+    "typescript": "^5.9.2",
+    "vitest": "^2.1.0"
+  },
+  "peerDependencies": {
+    "express": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  }
+}