apcore-a2a 0.1.0

package/dist/explorer/index.js

@@ -0,0 +1,2 @@
+export { createExplorerRouter } from "./handler.js";
+//# sourceMappingURL=index.js.map

package/dist/explorer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/explorer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { serve, asyncServe } from "./serve.js";
+export { A2AClient } from "./client/index.js";
+export type { Authenticator, ClaimMapping } from "./auth/index.js";
+export { JWTAuthenticator } from "./auth/index.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":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { serve, asyncServe } from "./serve.js";
+export { A2AClient } from "./client/index.js";
+export { JWTAuthenticator } from "./auth/index.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,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/serve.d.ts

@@ -0,0 +1,38 @@
+import type { Express } from "express";
+import type { Registry } from "./adapters/agent-card.js";
+import type { Authenticator } from "./auth/types.js";
+import type { TaskStore } from "@a2a-js/sdk/server";
+export interface AsyncServeOptions {
+    name?: string;
+    description?: string;
+    version?: string;
+    url?: string;
+    auth?: Authenticator;
+    taskStore?: TaskStore;
+    corsOrigins?: string[];
+    explorer?: boolean;
+    explorerPrefix?: string;
+    executionTimeout?: number;
+    metrics?: boolean;
+}
+export interface ServeOptions extends AsyncServeOptions {
+    host?: string;
+    port?: number;
+    logLevel?: string;
+    shutdownTimeout?: number;
+}
+interface RegistryWithConfig extends Registry {
+    config?: Record<string, unknown>;
+}
+interface ExecutorLike {
+    callAsync(moduleId: string, inputs?: Record<string, unknown> | null, context?: unknown): Promise<Record<string, unknown>>;
+    registry?: RegistryWithConfig;
+}
+export declare function resolveRegistryAndExecutor(obj: unknown): {
+    registry: RegistryWithConfig;
+    executor: ExecutorLike;
+};
+export declare function asyncServe(registryOrExecutor: unknown, opts?: AsyncServeOptions): Promise<Express>;
+export declare function serve(registryOrExecutor: unknown, opts?: ServeOptions): void;
+export {};
+//# sourceMappingURL=serve.d.ts.map

package/dist/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAUpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,kBAAmB,SAAQ,QAAQ;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,UAAU,YAAY;IACpB,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,OAAO,GACX;IAAE,QAAQ,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CA0B1D;AAED,wBAAsB,UAAU,CAC9B,kBAAkB,EAAE,OAAO,EAC3B,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAwDlB;AAED,wBAAgB,KAAK,CACnB,kBAAkB,EAAE,OAAO,EAC3B,IAAI,GAAE,YAAiB,GACtB,IAAI,CAyBN"}

package/dist/serve.js

@@ -0,0 +1,98 @@
+import http from "node:http";
+import { A2AServerFactory } from "./server/factory.js";
+const DEFAULT_EXECUTION_TIMEOUT = parseInt(process.env.A2A_EXECUTION_TIMEOUT ?? "300000", 10);
+const AUTH_REQUIRED = ["authenticate", "securitySchemes"];
+const TASK_STORE_REQUIRED = ["save", "load"];
+export function resolveRegistryAndExecutor(obj) {
+    const o = obj;
+    // Check executor first (more specific — callAsync is distinctive)
+    if (typeof o.callAsync === "function") {
+        const executor = o;
+        const registry = executor.registry;
+        if (!registry) {
+            throw new TypeError("Expected apcore Registry or Executor: executor has no .registry property");
+        }
+        return { registry, executor };
+    }
+    if (typeof o.list === "function" && typeof o.getDefinition === "function") {
+        const registry = o;
+        const nestedExecutor = o.executor;
+        const executor = typeof nestedExecutor?.callAsync === "function"
+            ? nestedExecutor
+            : registry;
+        return { registry, executor };
+    }
+    throw new TypeError("Expected apcore Registry or Executor");
+}
+export async function asyncServe(registryOrExecutor, opts = {}) {
+    const { registry, executor } = resolveRegistryAndExecutor(registryOrExecutor);
+    // Validate registry has at least one module
+    const modules = registry.list();
+    if (modules.length === 0) {
+        throw new ValueError("Registry contains zero modules; at least one module is required to serve an A2A agent");
+    }
+    // Resolve metadata with fallbacks
+    const projectConfig = registry.config?.project ?? {};
+    const resolvedName = opts.name ?? projectConfig.name ?? "apcore-agent";
+    const resolvedVersion = opts.version ?? projectConfig.version ?? "0.0.0";
+    const resolvedDescription = opts.description ??
+        projectConfig.description ??
+        `apcore agent with ${modules.length} skills`;
+    // Protocol validation
+    if (opts.auth) {
+        const missing = AUTH_REQUIRED.filter((m) => typeof opts.auth[m] !== "function");
+        if (missing.length > 0) {
+            throw new TypeError(`auth missing required methods: ${missing.join(", ")}`);
+        }
+    }
+    if (opts.taskStore) {
+        const missing = TASK_STORE_REQUIRED.filter((m) => typeof opts.taskStore[m] !== "function");
+        if (missing.length > 0) {
+            throw new TypeError(`taskStore missing required methods: ${missing.join(", ")}`);
+        }
+    }
+    const factory = new A2AServerFactory();
+    const { app } = factory.create(registry, executor, {
+        name: resolvedName,
+        description: resolvedDescription,
+        version: resolvedVersion,
+        url: opts.url ?? "http://localhost:8000",
+        taskStore: opts.taskStore,
+        auth: opts.auth,
+        corsOrigins: opts.corsOrigins,
+        explorer: opts.explorer,
+        explorerPrefix: opts.explorerPrefix,
+        executionTimeout: opts.executionTimeout ?? DEFAULT_EXECUTION_TIMEOUT,
+        metrics: opts.metrics,
+    });
+    return app;
+}
+export function serve(registryOrExecutor, opts = {}) {
+    const host = opts.host ?? "0.0.0.0";
+    const port = opts.port ?? 8000;
+    const resolvedUrl = opts.url ?? `http://${host}:${port}`;
+    asyncServe(registryOrExecutor, { ...opts, url: resolvedUrl })
+        .then((app) => {
+        const server = http.createServer(app);
+        const shutdown = () => {
+            server.close(() => process.exit(0));
+            setTimeout(() => process.exit(1), (opts.shutdownTimeout ?? 30) * 1000);
+        };
+        process.on("SIGTERM", shutdown);
+        process.on("SIGINT", shutdown);
+        server.listen(port, host, () => {
+            console.log(`A2A agent listening on ${resolvedUrl}`);
+        });
+    })
+        .catch((e) => {
+        console.error(`Failed to start A2A agent: ${e}`);
+        process.exit(1);
+    });
+}
+class ValueError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ValueError";
+    }
+}
+//# sourceMappingURL=serve.js.map

package/dist/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAKvD,MAAM,yBAAyB,GAAG,QAAQ,CACxC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,QAAQ,EAC7C,EAAE,CACH,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,cAAc,EAAE,iBAAiB,CAAU,CAAC;AACnE,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC;AAoCtD,MAAM,UAAU,0BAA0B,CACxC,GAAY;IAEZ,MAAM,CAAC,GAAG,GAA8B,CAAC;IAEzC,kEAAkE;IAClE,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,CAA4B,CAAC;QAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,SAAS,CACjB,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;QAC1E,MAAM,QAAQ,GAAG,CAAkC,CAAC;QACpD,MAAM,cAAc,GAAI,CAA6B,CAAC,QAAoC,CAAC;QAC3F,MAAM,QAAQ,GACZ,OAAO,cAAc,EAAE,SAAS,KAAK,UAAU;YAC7C,CAAC,CAAC,cAAc;YAChB,CAAC,CAAE,QAAoC,CAAC;QAC5C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,kBAA2B,EAC3B,OAA0B,EAAE;IAE5B,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,0BAA0B,CAAC,kBAAkB,CAAC,CAAC;IAE9E,4CAA4C;IAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,UAAU,CAClB,uFAAuF,CACxF,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,MAAM,aAAa,GACf,QAAQ,CAAC,MAAkC,EAAE,OAAmC,IAAI,EAAE,CAAC;IAC3F,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,IAAK,aAAa,CAAC,IAAe,IAAI,cAAc,CAAC;IACnF,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,IAAK,aAAa,CAAC,OAAkB,IAAI,OAAO,CAAC;IACrF,MAAM,mBAAmB,GACvB,IAAI,CAAC,WAAW;QACf,aAAa,CAAC,WAAsB;QACrC,qBAAqB,OAAO,CAAC,MAAM,SAAS,CAAC;IAE/C,sBAAsB;IACtB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAQ,IAAI,CAAC,IAA2C,CAAC,CAAC,CAAC,KAAK,UAAU,CAClF,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,kCAAkC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAQ,IAAI,CAAC,SAAgD,CAAC,CAAC,CAAC,KAAK,UAAU,CACvF,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,uCAAuC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACvC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE;QACjD,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,uBAAuB;QACxC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,yBAAyB;QACpE,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,KAAK,CACnB,kBAA2B,EAC3B,OAAqB,EAAE;IAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;IAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;IAEzD,UAAU,CAAC,kBAAkB,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;SAC1D,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAEtC,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACzE,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAE/B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YAC7B,OAAO,CAAC,GAAG,CAAC,0BAA0B,WAAW,EAAE,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACX,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAW,SAAQ,KAAK;IAC5B,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/server/executor.d.ts

@@ -0,0 +1,26 @@
+import type { AgentExecutor, RequestContext, ExecutionEventBus } from "@a2a-js/sdk/server";
+import type { PartConverter } from "../adapters/parts.js";
+import type { Registry } from "../adapters/agent-card.js";
+export interface ApCoreAgentExecutorOptions {
+    executor: {
+        callAsync(moduleId: string, inputs?: Record<string, unknown> | null, context?: unknown): Promise<Record<string, unknown>>;
+    };
+    partConverter: PartConverter;
+    registry?: Registry;
+    executionTimeout?: number;
+    onStateChange?: (oldState: string, newState: string) => void;
+}
+export declare class ApCoreAgentExecutor implements AgentExecutor {
+    private executor;
+    private partConverter;
+    private registry?;
+    private executionTimeout;
+    private onStateChange?;
+    constructor(opts: ApCoreAgentExecutorOptions);
+    private notify;
+    execute(context: RequestContext, eventBus: ExecutionEventBus): Promise<void>;
+    cancelTask(taskId: string, eventBus: ExecutionEventBus): Promise<void>;
+    private publishFailed;
+    private publishInputRequired;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/server/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/server/executor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAe1D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE;QACR,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACrC,CAAC;IACF,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D;AAED,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,aAAa,CAAC,CAA+C;gBAEzD,IAAI,EAAE,0BAA0B;IAQ5C,OAAO,CAAC,MAAM;IAUR,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwG5E,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5E,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,oBAAoB;CAkB7B"}

package/dist/server/executor.js

@@ -0,0 +1,191 @@
+import { getAuthIdentity } from "../auth/storage.js";
+function utcNow() {
+    return new Date().toISOString();
+}
+function textMessage(text) {
+    return {
+        kind: "message",
+        messageId: crypto.randomUUID(),
+        role: "agent",
+        parts: [{ kind: "text", text }],
+    };
+}
+export class ApCoreAgentExecutor {
+    executor;
+    partConverter;
+    registry;
+    executionTimeout;
+    onStateChange;
+    constructor(opts) {
+        this.executor = opts.executor;
+        this.partConverter = opts.partConverter;
+        this.registry = opts.registry;
+        this.executionTimeout = opts.executionTimeout ?? 300_000;
+        this.onStateChange = opts.onStateChange;
+    }
+    notify(oldState, newState) {
+        if (this.onStateChange) {
+            try {
+                this.onStateChange(oldState, newState);
+            }
+            catch {
+                // Callback errors must not crash the executor
+            }
+        }
+    }
+    async execute(context, eventBus) {
+        // 1. Get skillId from message metadata
+        const metadata = context.userMessage?.metadata ?? {};
+        const skillId = metadata.skillId;
+        if (!skillId) {
+            this.notify("submitted", "failed");
+            this.publishFailed(context, eventBus, "Missing required parameter: metadata.skillId");
+            return;
+        }
+        // 2. Validate skill exists in registry
+        if (this.registry) {
+            try {
+                const known = this.registry.list();
+                if (!known.includes(skillId)) {
+                    this.notify("submitted", "failed");
+                    this.publishFailed(context, eventBus, `Skill not found: ${skillId}`);
+                    return;
+                }
+            }
+            catch {
+                // Registry may be unavailable; proceed optimistically
+            }
+        }
+        // 3. Parse Parts -> apcore input
+        const parts = context.userMessage?.parts ?? [];
+        let descriptor = null;
+        if (this.registry) {
+            try {
+                descriptor = this.registry.getDefinition(skillId);
+            }
+            catch {
+                // Descriptor lookup failure is non-fatal
+            }
+        }
+        let inputs;
+        try {
+            inputs = this.partConverter.partsToInput(parts, descriptor);
+        }
+        catch (e) {
+            this.notify("submitted", "failed");
+            this.publishFailed(context, eventBus, String(e));
+            return;
+        }
+        // 4. Build apcore context with identity
+        const identity = getAuthIdentity();
+        let apcoreCtx = undefined;
+        try {
+            const { Context } = await import("apcore-js");
+            apcoreCtx = identity ? Context.create(null, identity) : Context.create();
+        }
+        catch {
+            // apcore-js Context not available in this environment
+        }
+        // 5. Execute via executor.callAsync() with timeout
+        this.notify("submitted", "working");
+        let output;
+        try {
+            const inputObj = typeof inputs === "string" ? { text: inputs } : inputs;
+            const coro = apcoreCtx
+                ? this.executor.callAsync(skillId, inputObj, apcoreCtx)
+                : this.executor.callAsync(skillId, inputObj);
+            output = await withTimeout(coro, this.executionTimeout);
+        }
+        catch (e) {
+            if (e instanceof TimeoutError) {
+                this.notify("working", "failed");
+                this.publishFailed(context, eventBus, "Execution timed out");
+                return;
+            }
+            const code = e.code;
+            if (code === "APPROVAL_PENDING") {
+                this.notify("working", "input-required");
+                this.publishInputRequired(context, eventBus, String(e));
+                return;
+            }
+            this.notify("working", "failed");
+            this.publishFailed(context, eventBus, "Internal server error");
+            return;
+        }
+        // 6. Publish artifact + completed
+        const artifact = this.partConverter.outputToParts(output, context.taskId);
+        const contextId = context.contextId || context.taskId;
+        eventBus.publish({
+            kind: "artifact-update",
+            taskId: context.taskId,
+            contextId,
+            artifact,
+            append: false,
+            lastChunk: true,
+        });
+        eventBus.publish({
+            kind: "status-update",
+            taskId: context.taskId,
+            contextId,
+            status: { state: "completed", timestamp: utcNow() },
+            final: true,
+        });
+        this.notify("working", "completed");
+    }
+    async cancelTask(taskId, eventBus) {
+        eventBus.publish({
+            kind: "status-update",
+            taskId,
+            contextId: taskId,
+            status: {
+                state: "canceled",
+                timestamp: utcNow(),
+                message: textMessage("Canceled by client"),
+            },
+            final: true,
+        });
+        this.notify("working", "canceled");
+    }
+    publishFailed(context, eventBus, message) {
+        const contextId = context.contextId || context.taskId;
+        eventBus.publish({
+            kind: "status-update",
+            taskId: context.taskId,
+            contextId,
+            status: {
+                state: "failed",
+                timestamp: utcNow(),
+                message: textMessage(message),
+            },
+            final: true,
+        });
+    }
+    publishInputRequired(context, eventBus, message) {
+        const contextId = context.contextId || context.taskId;
+        eventBus.publish({
+            kind: "status-update",
+            taskId: context.taskId,
+            contextId,
+            status: {
+                state: "input-required",
+                timestamp: utcNow(),
+                message: textMessage(message),
+            },
+            final: false,
+        });
+    }
+}
+class TimeoutError extends Error {
+    constructor() {
+        super("Execution timed out");
+        this.name = "TimeoutError";
+    }
+}
+function withTimeout(promise, ms) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new TimeoutError()), ms);
+    });
+    return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));
+}
+//# sourceMappingURL=executor.js.map

package/dist/server/executor.js.map

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

package/dist/server/factory.d.ts

@@ -0,0 +1,33 @@
+import type { Express } from "express";
+import type { AgentCard } from "@a2a-js/sdk";
+import { type TaskStore } from "@a2a-js/sdk/server";
+import { type Registry } from "../adapters/agent-card.js";
+import type { Authenticator } from "../auth/types.js";
+export interface A2AServerCreateOptions {
+    name: string;
+    description: string;
+    version: string;
+    url: string;
+    taskStore?: TaskStore;
+    auth?: Authenticator;
+    executionTimeout?: number;
+    corsOrigins?: string[];
+    explorer?: boolean;
+    explorerPrefix?: string;
+    metrics?: boolean;
+}
+export declare class A2AServerFactory {
+    private skillMapper;
+    private schemaConverter;
+    private agentCardBuilder;
+    private partConverter;
+    private registry?;
+    create(registry: Registry, executor: {
+        callAsync(moduleId: string, inputs?: Record<string, unknown> | null, context?: unknown): Promise<Record<string, unknown>>;
+    }, opts: A2AServerCreateOptions): {
+        app: Express;
+        agentCard: AgentCard;
+    };
+    registerModule(moduleId: string, descriptor: unknown): void;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/server/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/server/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAI5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA+BtD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,QAAQ,CAAC,CAAW;IAE5B,MAAM,CACJ,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE;QACR,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACrC,EACD,IAAI,EAAE,sBAAsB,GAC3B;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,SAAS,CAAA;KAAE;IA2JzC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;CAM5D"}

package/dist/server/factory.js

@@ -0,0 +1,177 @@
+import express from "express";
+import { DefaultRequestHandler, DefaultExecutionEventBusManager, InMemoryTaskStore, } from "@a2a-js/sdk/server";
+import { jsonRpcHandler, agentCardHandler, UserBuilder, } from "@a2a-js/sdk/server/express";
+import { SkillMapper } from "../adapters/skill-mapper.js";
+import { SchemaConverter } from "../adapters/schema.js";
+import { AgentCardBuilder } from "../adapters/agent-card.js";
+import { PartConverter } from "../adapters/parts.js";
+import { ApCoreAgentExecutor } from "./executor.js";
+import { createAuthMiddleware } from "../auth/middleware.js";
+const ACTIVE_STATES = new Set(["submitted", "working", "input-required"]);
+class MetricsState {
+    activeTasks = 0;
+    completedTasks = 0;
+    failedTasks = 0;
+    canceledTasks = 0;
+    inputRequiredTasks = 0;
+    totalRequests = 0;
+    startTime = performance.now();
+    uptimeSeconds() {
+        return (performance.now() - this.startTime) / 1000;
+    }
+    onStateTransition(oldState, newState) {
+        const wasActive = ACTIVE_STATES.has(oldState);
+        const nowActive = ACTIVE_STATES.has(newState);
+        if (!wasActive && nowActive)
+            this.activeTasks++;
+        else if (wasActive && !nowActive)
+            this.activeTasks = Math.max(0, this.activeTasks - 1);
+        if (newState === "completed")
+            this.completedTasks++;
+        else if (newState === "failed")
+            this.failedTasks++;
+        else if (newState === "canceled")
+            this.canceledTasks++;
+        else if (newState === "input-required")
+            this.inputRequiredTasks++;
+    }
+}
+export class A2AServerFactory {
+    skillMapper = new SkillMapper();
+    schemaConverter = new SchemaConverter();
+    agentCardBuilder = new AgentCardBuilder(this.skillMapper);
+    partConverter = new PartConverter(this.schemaConverter);
+    registry;
+    create(registry, executor, opts) {
+        this.registry = registry;
+        // Build security schemes
+        const securitySchemes = opts.auth ? opts.auth.securitySchemes() : undefined;
+        // Build capabilities
+        const capabilities = {
+            streaming: true,
+            pushNotifications: false,
+            stateTransitionHistory: true,
+        };
+        // Build AgentCard
+        const agentCard = this.agentCardBuilder.build(registry, {
+            name: opts.name,
+            description: opts.description,
+            version: opts.version,
+            url: opts.url,
+            capabilities,
+            securitySchemes: securitySchemes,
+        });
+        // Build metrics state
+        const metricsState = new MetricsState();
+        // Build executor
+        const onStateChange = opts.metrics
+            ? (o, n) => metricsState.onStateTransition(o, n)
+            : undefined;
+        const apcoreExecutor = new ApCoreAgentExecutor({
+            executor,
+            partConverter: this.partConverter,
+            registry,
+            executionTimeout: opts.executionTimeout,
+            onStateChange,
+        });
+        // Build task store
+        const taskStore = opts.taskStore ?? new InMemoryTaskStore();
+        // Build DefaultRequestHandler
+        const requestHandler = new DefaultRequestHandler(agentCard, taskStore, apcoreExecutor, new DefaultExecutionEventBusManager());
+        // Build Express app
+        const app = express();
+        app.use(express.json());
+        // Auth middleware (before routes)
+        if (opts.auth) {
+            const explorerPrefix = opts.explorerPrefix ?? "/explorer";
+            const exemptPrefixes = opts.explorer ? new Set([explorerPrefix]) : new Set();
+            app.use(createAuthMiddleware({
+                authenticator: opts.auth,
+                exemptPrefixes,
+            }));
+        }
+        // CORS middleware
+        if (opts.corsOrigins && opts.corsOrigins.length > 0) {
+            const origins = new Set(opts.corsOrigins);
+            app.use((req, res, next) => {
+                const origin = req.headers.origin;
+                if (origin && origins.has(origin)) {
+                    res.set("Access-Control-Allow-Origin", origin);
+                    res.set("Access-Control-Allow-Methods", "GET, POST");
+                    res.set("Access-Control-Allow-Headers", "Content-Type, Authorization");
+                }
+                if (req.method === "OPTIONS") {
+                    res.status(204).end();
+                    return;
+                }
+                next();
+            });
+        }
+        // Request counter middleware
+        if (opts.metrics) {
+            app.use((req, _res, next) => {
+                if (req.method === "POST")
+                    metricsState.totalRequests++;
+                next();
+            });
+        }
+        // Agent card endpoint
+        app.get("/.well-known/agent-card.json", agentCardHandler({ agentCardProvider: requestHandler }));
+        // JSON-RPC endpoint
+        app.post("/", jsonRpcHandler({
+            requestHandler,
+            userBuilder: UserBuilder.noAuthentication,
+        }));
+        // Health endpoint
+        app.get("/health", async (_req, res) => {
+            let moduleCount = 0;
+            try {
+                moduleCount = registry.list().length;
+            }
+            catch {
+                // ignore
+            }
+            try {
+                await taskStore.load("__health_probe__");
+            }
+            catch {
+                res.status(503).json({
+                    status: "unhealthy",
+                    reason: "Task store unavailable",
+                    uptimeSeconds: metricsState.uptimeSeconds(),
+                    moduleCount,
+                    version: opts.version,
+                });
+                return;
+            }
+            res.json({
+                status: "healthy",
+                uptimeSeconds: metricsState.uptimeSeconds(),
+                moduleCount,
+                version: opts.version,
+            });
+        });
+        // Metrics endpoint
+        if (opts.metrics) {
+            app.get("/metrics", (_req, res) => {
+                res.json({
+                    activeTasks: metricsState.activeTasks,
+                    completedTasks: metricsState.completedTasks,
+                    failedTasks: metricsState.failedTasks,
+                    canceledTasks: metricsState.canceledTasks,
+                    inputRequiredTasks: metricsState.inputRequiredTasks,
+                    totalRequests: metricsState.totalRequests,
+                    uptimeSeconds: metricsState.uptimeSeconds(),
+                });
+            });
+        }
+        return { app, agentCard };
+    }
+    registerModule(moduleId, descriptor) {
+        if (this.registry?.register) {
+            this.registry.register(moduleId, descriptor);
+        }
+        this.agentCardBuilder.invalidateCache();
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/server/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/server/factory.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAiB,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAE1E,MAAM,YAAY;IAChB,WAAW,GAAG,CAAC,CAAC;IAChB,cAAc,GAAG,CAAC,CAAC;IACnB,WAAW,GAAG,CAAC,CAAC;IAChB,aAAa,GAAG,CAAC,CAAC;IAClB,kBAAkB,GAAG,CAAC,CAAC;IACvB,aAAa,GAAG,CAAC,CAAC;IACV,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAEtC,aAAa;QACX,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACrD,CAAC;IAED,iBAAiB,CAAC,QAAgB,EAAE,QAAgB;QAClD,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE9C,IAAI,CAAC,SAAS,IAAI,SAAS;YAAE,IAAI,CAAC,WAAW,EAAE,CAAC;aAC3C,IAAI,SAAS,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAEvF,IAAI,QAAQ,KAAK,WAAW;YAAE,IAAI,CAAC,cAAc,EAAE,CAAC;aAC/C,IAAI,QAAQ,KAAK,QAAQ;YAAE,IAAI,CAAC,WAAW,EAAE,CAAC;aAC9C,IAAI,QAAQ,KAAK,UAAU;YAAE,IAAI,CAAC,aAAa,EAAE,CAAC;aAClD,IAAI,QAAQ,KAAK,gBAAgB;YAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACpE,CAAC;CACF;AAgBD,MAAM,OAAO,gBAAgB;IACnB,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAChC,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IACxC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1D,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACxD,QAAQ,CAAY;IAE5B,MAAM,CACJ,QAAkB,EAClB,QAMC,EACD,IAA4B;QAE5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,yBAAyB;QACzB,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAE5E,qBAAqB;QACrB,MAAM,YAAY,GAAG;YACnB,SAAS,EAAE,IAAI;YACf,iBAAiB,EAAE,KAAK;YACxB,sBAAsB,EAAE,IAAI;SAC7B,CAAC;QAEF,kBAAkB;QAClB,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE;YACtD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,YAAY;YACZ,eAAe,EAAE,eAAsD;SACxE,CAAc,CAAC;QAEhB,sBAAsB;QACtB,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;QAExC,iBAAiB;QACjB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO;YAChC,CAAC,CAAC,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,cAAc,GAAG,IAAI,mBAAmB,CAAC;YAC7C,QAAQ;YACR,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ;YACR,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,aAAa;SACd,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,iBAAiB,EAAE,CAAC;QAE5D,8BAA8B;QAC9B,MAAM,cAAc,GAAG,IAAI,qBAAqB,CAC9C,SAAS,EACT,SAAS,EACT,cAAc,EACd,IAAI,+BAA+B,EAAE,CACtC,CAAC;QAEF,oBAAoB;QACpB,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAExB,kCAAkC;QAClC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;YAC1D,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC;YACrF,GAAG,CAAC,GAAG,CACL,oBAAoB,CAAC;gBACnB,aAAa,EAAE,IAAI,CAAC,IAAI;gBACxB,cAAc;aACf,CAAC,CACH,CAAC;QACJ,CAAC;QAED,kBAAkB;QAClB,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1C,GAAG,CAAC,GAAG,CAAC,CAAC,GAAY,EAAE,GAAa,EAAE,IAAI,EAAE,EAAE;gBAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;gBAClC,IAAI,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBAClC,GAAG,CAAC,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;oBAC/C,GAAG,CAAC,GAAG,CAAC,8BAA8B,EAAE,WAAW,CAAC,CAAC;oBACrD,GAAG,CAAC,GAAG,CAAC,8BAA8B,EAAE,6BAA6B,CAAC,CAAC;gBACzE,CAAC;gBACD,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC7B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;oBACtB,OAAO;gBACT,CAAC;gBACD,IAAI,EAAE,CAAC;YACT,CAAC,CAAC,CAAC;QACL,CAAC;QAED,6BAA6B;QAC7B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,GAAG,CAAC,GAAG,CAAC,CAAC,GAAY,EAAE,IAAc,EAAE,IAAI,EAAE,EAAE;gBAC7C,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;oBAAE,YAAY,CAAC,aAAa,EAAE,CAAC;gBACxD,IAAI,EAAE,CAAC;YACT,CAAC,CAAC,CAAC;QACL,CAAC;QAED,sBAAsB;QACtB,GAAG,CAAC,GAAG,CACL,8BAA8B,EAC9B,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CACxD,CAAC;QAEF,oBAAoB;QACpB,GAAG,CAAC,IAAI,CACN,GAAG,EACH,cAAc,CAAC;YACb,cAAc;YACd,WAAW,EAAE,WAAW,CAAC,gBAAgB;SAC1C,CAAC,CACH,CAAC;QAEF,kBAAkB;QAClB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;YACxD,IAAI,WAAW,GAAG,CAAC,CAAC;YACpB,IAAI,CAAC;gBACH,WAAW,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC3C,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,MAAM,EAAE,WAAW;oBACnB,MAAM,EAAE,wBAAwB;oBAChC,aAAa,EAAE,YAAY,CAAC,aAAa,EAAE;oBAC3C,WAAW;oBACX,OAAO,EAAE,IAAI,CAAC,OAAO;iBACtB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,GAAG,CAAC,IAAI,CAAC;gBACP,MAAM,EAAE,SAAS;gBACjB,aAAa,EAAE,YAAY,CAAC,aAAa,EAAE;gBAC3C,WAAW;gBACX,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,mBAAmB;QACnB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;gBACnD,GAAG,CAAC,IAAI,CAAC;oBACP,WAAW,EAAE,YAAY,CAAC,WAAW;oBACrC,cAAc,EAAE,YAAY,CAAC,cAAc;oBAC3C,WAAW,EAAE,YAAY,CAAC,WAAW;oBACrC,aAAa,EAAE,YAAY,CAAC,aAAa;oBACzC,kBAAkB,EAAE,YAAY,CAAC,kBAAkB;oBACnD,aAAa,EAAE,YAAY,CAAC,aAAa;oBACzC,aAAa,EAAE,YAAY,CAAC,aAAa,EAAE;iBAC5C,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;IAC5B,CAAC;IAED,cAAc,CAAC,QAAgB,EAAE,UAAmB;QAClD,IAAI,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE,CAAC;IAC1C,CAAC;CACF"}

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+export { A2AServerFactory } from "./factory.js";
+export { ApCoreAgentExecutor } from "./executor.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,3 @@
+export { A2AServerFactory } from "./factory.js";
+export { ApCoreAgentExecutor } from "./executor.js";
+//# sourceMappingURL=index.js.map