@ap3x/a2a 1.0.0 → 2.1.0

package/dist/task-store.d.ts

@@ -0,0 +1,61 @@
+import { type Message, type Task, type TaskState, type TaskStatusUpdateEvent } from "./model";
+/** Thrown when an operation references a task id the store does not hold. */
+export declare class TaskNotFoundError extends Error {
+    readonly taskId: string;
+    constructor(taskId: string);
+}
+/** Thrown when a transition would leave a terminal state. */
+export declare class IllegalTaskTransitionError extends Error {
+    readonly taskId: string;
+    readonly from: TaskState;
+    readonly to: TaskState;
+    constructor(taskId: string, from: TaskState, to: TaskState);
+}
+export type TaskSubscriber = (event: TaskStatusUpdateEvent) => void;
+export interface TaskStoreOptions {
+    /** Injected clock (epoch millis) — status timestamps derive from it. */
+    now: () => number;
+    /**
+     * Retain at most this many TERMINAL tasks: each terminal transition evicts
+     * the oldest terminal tasks beyond the cap (in-flight tasks are never
+     * evicted). Default: unbounded — long-lived servers should set it.
+     */
+    maxRetainedTasks?: number;
+}
+export interface CreateTaskOptions {
+    /** Multi-turn thread id; generated when omitted. */
+    contextId?: string;
+    /** Initial message history (e.g. the message that created the task). */
+    history?: Message[];
+}
+export interface ListTasksFilter {
+    contextId?: string;
+    state?: TaskState;
+}
+export declare class TaskStore {
+    private readonly now;
+    private readonly maxRetainedTasks?;
+    private readonly tasks;
+    private readonly subscribers;
+    constructor(options: TaskStoreOptions);
+    /** Create a task in the `submitted` state. */
+    create(options?: CreateTaskOptions): Task;
+    get(id: string): Task | undefined;
+    list(filter?: ListTasksFilter): Task[];
+    /**
+     * Transition a task to `state`, notify its subscribers, and — when the new
+     * state is terminal — clear those subscribers. Leaving a terminal state
+     * throws {@link IllegalTaskTransitionError}.
+     */
+    updateState(id: string, state: TaskState, message?: Message): Task;
+    /** Drop the oldest TERMINAL tasks beyond `maxRetainedTasks` (no-op when unset). */
+    private evictBeyondRetention;
+    /** Cancel a task (illegal from a terminal state, like any other exit). */
+    cancel(id: string): Task;
+    /** Subscribe to a task's status updates; returns an unsubscribe function. */
+    subscribe(taskId: string, fn: TaskSubscriber): () => void;
+    /** Live subscriber count for a task (0 after a terminal transition). */
+    subscriberCount(taskId: string): number;
+    private timestamp;
+}
+//# sourceMappingURL=task-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-store.d.ts","sourceRoot":"","sources":["../src/task-store.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,qBAAqB,EAE3B,MAAM,SAAS,CAAC;AAEjB,6EAA6E;AAC7E,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM;CAK3B;AAED,6DAA6D;AAC7D,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;gBAEX,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS;CAO3D;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;gBAE1D,OAAO,EAAE,gBAAgB;IAOrC,8CAA8C;IAC9C,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,IAAI;IAW7C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIjC,IAAI,CAAC,MAAM,GAAE,eAAoB,GAAG,IAAI,EAAE;IAU1C;;;;OAIG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IA2BlE,mFAAmF;IACnF,OAAO,CAAC,oBAAoB;IAe5B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,6EAA6E;IAC7E,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,GAAG,MAAM,IAAI;IAczD,wEAAwE;IACxE,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIvC,OAAO,CAAC,SAAS;CAGlB"}

package/package.json

@@ -1,27 +1,38 @@
 {
   "name": "@ap3x/a2a",
-  "version": "1.0.0",
-  "description": "A2A protocol client, server, and swarm integration for @ap3x/core",
+  "version": "2.1.0",
+  "description": "Agent-to-agent (A2A) protocol client, server, and swarm integration",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AP3X-Dev/AP3X.git",
+    "directory": "packages/a2a"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
-  "peerDependencies": {
-    "@ap3x/core": "^1.0.0"
+  "files": ["dist", "proto"],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean --tsconfig tsconfig.build.json && tsc -p tsconfig.build.json",
+    "prepublishOnly": "node ../../scripts/publish-gate.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@ap3x/agent-core": "0.2.0",
+    "@grpc/grpc-js": "^1.13.4",
+    "@grpc/proto-loader": "^0.8.0",
+    "@sinclair/typebox": "^0.34.49"
   },
   "devDependencies": {
-    "typescript": "^5.4.0",
-    "vitest": "^2.0.0",
-    "@ap3x/core": "1.0.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "@a2a-js/sdk": "0.3.13"
   }
-}
+}