@alvin0/ai-agent-sdk-a2a 0.1.0

package/dist/server-ejQSEjqI.d.mts

@@ -0,0 +1,116 @@
+import { A2A_PROTOCOL_VERSION as A2A_PROTOCOL_VERSION$1, AgentCard, AgentCard as AgentCard$1, AgentProvider, Message, Part, Role as Role$1, SecurityRequirement, SecurityScheme, Task, TaskState as TaskState$1 } from "@a2a-js/sdk";
+import { ModelRegistry, SdkLogger, SupportSafeError } from "@alvin0/ai-agent-sdk-core";
+import { AgentEvent as AgentEvent$1, AgentExecutor, AgentExecutor as AgentExecutor$1, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultRequestHandler, DefaultRequestHandler as DefaultRequestHandler$1, ExecutionEventBus, ExecutionEventBus as ExecutionEventBus$1, InMemoryTaskStore as InMemoryTaskStore$1, JsonRpcTransportHandler, RequestContext, RequestContext as RequestContext$1, ServerCallContext, TaskStore, TaskStore as TaskStore$1 } from "@a2a-js/sdk/server";
+import { AgentSession, AgentSessionOptions, DefinedAgent } from "@alvin0/ai-agent-sdk-core/agent";
+//#region src/server/agent-card.d.ts
+interface AgentCardFromDefinitionOptions {
+  readonly url: string;
+  readonly protocolBinding?: 'JSONRPC' | 'HTTP+JSON' | 'GRPC' | (string & {});
+  readonly version?: string;
+  readonly provider?: AgentProvider;
+  readonly documentationUrl?: string;
+  readonly iconUrl?: string;
+  readonly tags?: readonly string[];
+  readonly examples?: readonly string[];
+  readonly securitySchemes?: Readonly<Record<string, SecurityScheme>>;
+  readonly securityRequirements?: readonly SecurityRequirement[];
+  readonly requireHttps?: boolean;
+}
+declare function createAgentCardFromDefinition(agent: DefinedAgent, options: AgentCardFromDefinitionOptions): AgentCard;
+//#endregion
+//#region src/server.d.ts
+interface DefinedAgentA2AExecutorOptions {
+  readonly agent: DefinedAgent;
+  readonly logger?: SdkLogger;
+  /** Required unless createSession supplies a fully configured session. */
+  readonly registry?: ModelRegistry;
+  readonly sessionOptions?: Omit<AgentSessionOptions, 'conversationId' | 'registry'>;
+  /** Customize session construction for request-specific registries, tools, or policy. */
+  readonly createSession?: (context: RequestContext, signal?: AbortSignal) => AgentSession | Promise<AgentSession>;
+  /** Opt-in host policy: reject calls without an authenticated A2A principal. */
+  readonly requireAuthenticated?: boolean;
+  /**
+   * Map a request to the host's ownership boundary (user, device, workspace,
+   * API client, etc.). Defaults to the authenticated A2A principal.
+   */
+  readonly sessionOwner?: (context: RequestContext, signal?: AbortSignal) => string | Promise<string>;
+  /** Maximum retained context sessions. Defaults to 1,000. */
+  readonly maxSessions?: number;
+  /** Maximum tasks executing or queued across the executor. Defaults to 1,000. */
+  readonly maxRunningTasks?: number;
+  /** Maximum tasks executing or queued against one retained session. Defaults to 16. */
+  readonly maxTasksPerSession?: number;
+  /** Idle session retention. Defaults to 30 minutes. */
+  readonly sessionTtlMs?: number;
+  /** Maximum serialized inbound A2A message size. Defaults to 1 MiB. */
+  readonly maxInputBytes?: number;
+  /** Maximum UTF-8 response size published to A2A. Defaults to 1 MiB. */
+  readonly maxOutputBytes?: number;
+  /** Maximum time dispose waits for cooperative providers. Defaults to 30 seconds. */
+  readonly disposeTimeoutMs?: number;
+  /** End-to-end bound for session creation, queueing, and agent execution. Defaults to 10 minutes. */
+  readonly taskTimeoutMs?: number;
+  /** Maximum wait for the private error observer. Defaults to 5 seconds. */
+  readonly observerTimeoutMs?: number;
+  /** Return raw internal error text to callers. Unsafe and disabled by default. */
+  readonly exposeInternalErrors?: boolean;
+  /** Receives the original error for private logging/telemetry. */
+  readonly onError?: (error: unknown, context: RequestContext) => void | Promise<void>;
+}
+interface A2ADisposeReport {
+  readonly status: 'disposed' | 'failed' | 'timed-out';
+  readonly alreadyDisposed: boolean;
+  readonly error?: SupportSafeError;
+}
+/**
+ * Adapt a provider-neutral DefinedAgent to the official A2A AgentExecutor contract.
+ * Sessions are retained by A2A contextId, so protocol follow-ups preserve history.
+ */
+declare class DefinedAgentA2AExecutor implements AgentExecutor {
+  private readonly options;
+  private readonly sessions;
+  private readonly running;
+  private readonly maxSessions;
+  private readonly maxRunningTasks;
+  private readonly maxTasksPerSession;
+  private readonly sessionTtlMs;
+  private readonly maxInputBytes;
+  private readonly maxOutputBytes;
+  private readonly disposeTimeoutMs;
+  private readonly taskTimeoutMs;
+  private readonly observerTimeoutMs;
+  private disposed;
+  private disposeTask;
+  private disposeReport;
+  constructor(options: DefinedAgentA2AExecutorOptions);
+  execute(context: RequestContext, eventBus: ExecutionEventBus): Promise<void>;
+  cancelTask(taskId: string, eventBus: ExecutionEventBus): Promise<void>;
+  /** Cancel active work and permanently release retained context sessions. */
+  dispose(reason?: unknown): Promise<void>;
+  /** Return bounded support evidence while retaining dispose() compatibility. */
+  disposeWithReport(reason?: unknown): Promise<A2ADisposeReport>;
+  private acquireContextSession;
+  private releaseContextSession;
+  private pruneSessions;
+  private resolveSessionKey;
+  private assertAccess;
+  private assertInputBudget;
+  private publishFailure;
+  private reportError;
+  private createContextSession;
+}
+interface DefinedAgentA2AServerOptions extends DefinedAgentA2AExecutorOptions {
+  readonly agentCard: AgentCard;
+  readonly taskStore?: TaskStore;
+}
+interface DefinedAgentA2AServer {
+  readonly agentCard: AgentCard;
+  readonly executor: DefinedAgentA2AExecutor;
+  readonly taskStore: TaskStore;
+  readonly requestHandler: DefaultRequestHandler;
+}
+/** Assemble the transport-neutral official A2A server components. */
+declare function createDefinedAgentA2AServer(options: DefinedAgentA2AServerOptions): DefinedAgentA2AServer;
+//#endregion
+export { TaskStore$1 as C, createAgentCardFromDefinition as E, TaskState$1 as S, AgentCardFromDefinitionOptions as T, Part as _, AgentExecutor$1 as a, ServerCallContext as b, DefaultRequestHandler$1 as c, DefinedAgentA2AServer as d, DefinedAgentA2AServerOptions as f, Message as g, JsonRpcTransportHandler as h, AgentEvent$1 as i, DefinedAgentA2AExecutor as l, InMemoryTaskStore$1 as m, A2A_PROTOCOL_VERSION$1 as n, DefaultExecutionEventBus as o, ExecutionEventBus$1 as p, AgentCard$1 as r, DefaultExecutionEventBusManager as s, A2ADisposeReport as t, DefinedAgentA2AExecutorOptions as u, RequestContext$1 as v, createDefinedAgentA2AServer as w, Task as x, Role$1 as y };
+//# sourceMappingURL=server-ejQSEjqI.d.mts.map

package/dist/server-ejQSEjqI.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-ejQSEjqI.d.mts","names":[],"sources":["../src/server/agent-card.ts","../src/server.ts"],"mappings":";;;;;UAIiB;WACN;WACA;WACA;WACA,WAAW;WACX;WACA;WACA;WACA;WACA,kBAAkB,SAAS,eAAe;WAC1C,gCAAgC;WAChC;;iBAGK,8BACd,OAAO,cACP,SAAS,iCACR;;;UCec;WACN,OAAO;WACP,SAAS;;WAET,WAAW;WACX,iBAAiB,KAAK;;WAEtB,iBACP,SAAS,gBACT,SAAS,gBACN,eAAe,QAAQ;;WAEnB;;;;;WAKA,gBAAgB,SAAS,gBAAgB,SAAS,yBAAyB;;WAE3E;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA,WAAW,gBAAgB,SAAS,0BAA0B;;UAGxD;WACN;WACA;WACA,QAAQ;;;;;;cAyBN,mCAAmC;mBAC7B;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;UACT;UACA;UACA;EAER,YAAY,SAAS;EAqBf,QAAQ,SAAS,gBAAgB,UAAU,oBAAoB;EA0I/D,WAAW,gBAAgB,UAAU,oBAAoB;;EAuBzD,QAAQ,mBAAuD;;EAsC/D,kBAAkB,mBAAmB,QAAQ;UAarC;UAmCN;UASA;UAMM;UAWN;UAOA;UAMA;UAgBM;UAMA;;UAiBC,qCAAqC;WAC3C,WAAW;WACX,YAAY;;UAGN;WACN,WAAW;WACX,UAAU;WACV,WAAW;WACX,gBAAgB;;;iBAIX,4BACd,SAAS,+BACR"}

package/dist/server.d.mts

@@ -0,0 +1,2 @@
+import { C as TaskStore, E as createAgentCardFromDefinition, S as TaskState, T as AgentCardFromDefinitionOptions, _ as Part, a as AgentExecutor, b as ServerCallContext, c as DefaultRequestHandler, d as DefinedAgentA2AServer, f as DefinedAgentA2AServerOptions, g as Message, h as JsonRpcTransportHandler, i as AgentEvent, l as DefinedAgentA2AExecutor, m as InMemoryTaskStore, n as A2A_PROTOCOL_VERSION, o as DefaultExecutionEventBus, p as ExecutionEventBus, r as AgentCard, s as DefaultExecutionEventBusManager, t as A2ADisposeReport, u as DefinedAgentA2AExecutorOptions, v as RequestContext, w as createDefinedAgentA2AServer, x as Task, y as Role } from "./server-ejQSEjqI.mjs";
+export { A2ADisposeReport, A2A_PROTOCOL_VERSION, type AgentCard, type AgentCardFromDefinitionOptions, AgentEvent, type AgentExecutor, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultRequestHandler, DefinedAgentA2AExecutor, DefinedAgentA2AExecutorOptions, DefinedAgentA2AServer, DefinedAgentA2AServerOptions, type ExecutionEventBus, InMemoryTaskStore, JsonRpcTransportHandler, type Message, type Part, type RequestContext, Role, ServerCallContext, type Task, TaskState, type TaskStore, createAgentCardFromDefinition, createDefinedAgentA2AServer };

package/dist/server.mjs

@@ -0,0 +1,3 @@
+import { a as DefaultRequestHandler, c as JsonRpcTransportHandler, d as TaskState, f as createDefinedAgentA2AServer, i as DefaultExecutionEventBusManager, l as Role, n as AgentEvent, o as DefinedAgentA2AExecutor, p as createAgentCardFromDefinition, r as DefaultExecutionEventBus, s as InMemoryTaskStore, t as A2A_PROTOCOL_VERSION, u as ServerCallContext } from "./server-BX1bnVUG.mjs";
+
+export { A2A_PROTOCOL_VERSION, AgentEvent, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultRequestHandler, DefinedAgentA2AExecutor, InMemoryTaskStore, JsonRpcTransportHandler, Role, ServerCallContext, TaskState, createAgentCardFromDefinition, createDefinedAgentA2AServer };

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@alvin0/ai-agent-sdk-a2a",
+  "author": {
+    "name": "alvin0 - chaulamdinhai",
+    "email": "chaulamdinhai@gmail.com"
+  },
+  "version": "0.1.0",
+  "description": "Node-elevated official A2A client/server bridge for ai-agent-sdk",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alvin0/ai-agent-sdk.git",
+    "directory": "packages/a2a"
+  },
+  "homepage": "https://github.com/alvin0/ai-agent-sdk/tree/main/packages/a2a#readme",
+  "bugs": {
+    "url": "https://github.com/alvin0/ai-agent-sdk/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.mts",
+      "import": "./dist/client.mjs",
+      "default": "./dist/client.mjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.mts",
+      "import": "./dist/server.mjs",
+      "default": "./dist/server.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "1.1.0"
+  },
+  "peerDependencies": {
+    "@alvin0/ai-agent-sdk-core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@alvin0/ai-agent-sdk-core": "^0.1.0",
+    "@arethetypeswrong/cli": "0.18.5",
+    "@types/node": "26.4.0",
+    "publint": "0.3.24",
+    "tsdown": "0.22.14",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11",
+    "wrangler": "4.127.1"
+  },
+  "engines": {
+    "node": ">=22.12"
+  },
+  "aiAgentSdk": {
+    "runtime": "node",
+    "coreApi": 1,
+    "roles": [
+      "agent-transport"
+    ]
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true});require('node:fs').rmSync('artifacts',{recursive:true,force:true})\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --config vitest.config.ts",
+    "pack": "pnpm pack --pack-destination artifacts",
+    "test:pack": "node scripts/test-packed.mts",
+    "check:publint": "publint",
+    "check:types": "attw --profile esm-only --pack ."
+  }
+}