apcore-a2a 0.1.0

package/dist/adapters/skill-mapper.js

@@ -0,0 +1,46 @@
+export class SkillMapper {
+    toSkill(descriptor) {
+        const description = descriptor.description;
+        if (!description)
+            return null;
+        return {
+            id: descriptor.module_id,
+            name: this.humanizeModuleId(descriptor.module_id),
+            description,
+            tags: [...(descriptor.tags ?? [])],
+            inputModes: this.computeInputModes(descriptor),
+            outputModes: this.computeOutputModes(descriptor),
+            examples: this.buildExamples(descriptor),
+        };
+    }
+    humanizeModuleId(moduleId) {
+        return moduleId
+            .replace(/\./g, " ")
+            .replace(/_/g, " ")
+            .replace(/\b\w/g, (c) => c.toUpperCase());
+    }
+    computeInputModes(descriptor) {
+        const schema = descriptor.input_schema;
+        if (!schema)
+            return ["text/plain"];
+        if (schema.type === "string")
+            return ["application/json", "text/plain"];
+        return ["application/json"];
+    }
+    computeOutputModes(descriptor) {
+        const schema = descriptor.output_schema;
+        if (!schema)
+            return ["text/plain"];
+        return ["application/json"];
+    }
+    buildExamples(descriptor) {
+        const examples = descriptor.examples ?? [];
+        const result = [];
+        for (const ex of examples.slice(0, 10)) {
+            if (ex.title)
+                result.push(String(ex.title));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=skill-mapper.js.map

package/dist/adapters/skill-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mapper.js","sourceRoot":"","sources":["../../src/adapters/skill-mapper.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,WAAW;IACtB,OAAO,CAAC,UAA4B;QAClC,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC3C,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAE9B,OAAO;YACL,EAAE,EAAE,UAAU,CAAC,SAAS;YACxB,IAAI,EAAE,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,SAAS,CAAC;YACjD,WAAW;YACX,IAAI,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAClC,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC;YAC9C,WAAW,EAAE,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC;YAChD,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;SACzC,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,QAAgB;QAC/B,OAAO,QAAQ;aACZ,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;aAClB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9C,CAAC;IAEO,iBAAiB,CAAC,UAA4B;QACpD,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;QACxE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9B,CAAC;IAEO,kBAAkB,CAAC,UAA4B;QACrD,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACnC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,UAA4B;QACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACvC,IAAI,EAAE,CAAC,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/auth/index.d.ts

@@ -0,0 +1,5 @@
+export type { Authenticator } from "./types.js";
+export { JWTAuthenticator, type ClaimMapping } from "./jwt.js";
+export { createAuthMiddleware } from "./middleware.js";
+export { authIdentityStore, getAuthIdentity } from "./storage.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/auth/index.js

@@ -0,0 +1,4 @@
+export { JWTAuthenticator } from "./jwt.js";
+export { createAuthMiddleware } from "./middleware.js";
+export { authIdentityStore, getAuthIdentity } from "./storage.js";
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAqB,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/auth/jwt.d.ts

@@ -0,0 +1,30 @@
+import jwt from "jsonwebtoken";
+import { type Identity } from "apcore-js";
+import type { Authenticator } from "./types.js";
+export interface ClaimMapping {
+    idClaim?: string;
+    typeClaim?: string;
+    rolesClaim?: string;
+    attrsClaims?: string[];
+}
+export interface JWTAuthenticatorOptions {
+    algorithms?: jwt.Algorithm[];
+    audience?: string;
+    issuer?: string;
+    claimMapping?: ClaimMapping;
+    requireClaims?: string[];
+}
+export declare class JWTAuthenticator implements Authenticator {
+    private key;
+    private algorithms;
+    private audience?;
+    private issuer?;
+    private claimMapping;
+    private requireClaims;
+    constructor(key: string, opts?: JWTAuthenticatorOptions);
+    authenticate(headers: Record<string, string>): Identity | null;
+    securitySchemes(): Record<string, unknown>;
+    private decodeToken;
+    private payloadToIdentity;
+}
+//# sourceMappingURL=jwt.d.ts.map

package/dist/auth/jwt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../../src/auth/jwt.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,cAAc,CAAC;AAC/B,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,aAAa,CAAW;gBAEpB,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,uBAAuB;IAcvD,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,GAAG,IAAI;IAa9D,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1C,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,iBAAiB;CAgB1B"}

package/dist/auth/jwt.js

@@ -0,0 +1,76 @@
+import jwt from "jsonwebtoken";
+import { createIdentity } from "apcore-js";
+export class JWTAuthenticator {
+    key;
+    algorithms;
+    audience;
+    issuer;
+    claimMapping;
+    requireClaims;
+    constructor(key, opts) {
+        this.key = key;
+        this.algorithms = opts?.algorithms ?? ["HS256"];
+        this.audience = opts?.audience;
+        this.issuer = opts?.issuer;
+        this.claimMapping = {
+            idClaim: opts?.claimMapping?.idClaim ?? "sub",
+            typeClaim: opts?.claimMapping?.typeClaim ?? "type",
+            rolesClaim: opts?.claimMapping?.rolesClaim ?? "roles",
+            attrsClaims: opts?.claimMapping?.attrsClaims ?? [],
+        };
+        this.requireClaims = opts?.requireClaims ?? ["sub"];
+    }
+    authenticate(headers) {
+        const authHeader = headers.authorization ?? headers.Authorization ?? "";
+        if (!authHeader.toLowerCase().startsWith("bearer "))
+            return null;
+        const token = authHeader.slice(7).trim();
+        if (!token)
+            return null;
+        const payload = this.decodeToken(token);
+        if (!payload)
+            return null;
+        return this.payloadToIdentity(payload);
+    }
+    securitySchemes() {
+        return { bearerAuth: { type: "http", scheme: "bearer", bearerFormat: "JWT" } };
+    }
+    decodeToken(token) {
+        try {
+            const opts = {
+                algorithms: this.algorithms,
+            };
+            if (this.audience)
+                opts.audience = this.audience;
+            if (this.issuer)
+                opts.issuer = this.issuer;
+            const payload = jwt.verify(token, this.key, opts);
+            if (typeof payload === "string")
+                return null;
+            for (const claim of this.requireClaims) {
+                if (!(claim in payload))
+                    return null;
+            }
+            return payload;
+        }
+        catch {
+            return null;
+        }
+    }
+    payloadToIdentity(payload) {
+        const mapping = this.claimMapping;
+        const identityId = payload[mapping.idClaim];
+        if (identityId == null)
+            return null;
+        const identityType = String(payload[mapping.typeClaim] ?? "user");
+        const rawRoles = payload[mapping.rolesClaim];
+        const roles = Array.isArray(rawRoles) ? rawRoles.map(String) : [];
+        const attrs = {};
+        for (const claim of mapping.attrsClaims) {
+            if (claim in payload)
+                attrs[claim] = payload[claim];
+        }
+        return createIdentity(String(identityId), identityType, roles, attrs);
+    }
+}
+//# sourceMappingURL=jwt.js.map

package/dist/auth/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../src/auth/jwt.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,cAAc,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAiB,MAAM,WAAW,CAAC;AAkB1D,MAAM,OAAO,gBAAgB;IACnB,GAAG,CAAS;IACZ,UAAU,CAAkB;IAC5B,QAAQ,CAAU;IAClB,MAAM,CAAU;IAChB,YAAY,CAAyB;IACrC,aAAa,CAAW;IAEhC,YAAY,GAAW,EAAE,IAA8B;QACrD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG;YAClB,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,IAAI,KAAK;YAC7C,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,IAAI,MAAM;YAClD,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,IAAI,OAAO;YACrD,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,IAAI,EAAE;SACnD,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,YAAY,CAAC,OAA+B;QAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QACxE,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,eAAe;QACb,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,CAAC;IACjF,CAAC;IAEO,WAAW,CAAC,KAAa;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,GAAsB;gBAC9B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC;YACF,IAAI,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YACjD,IAAI,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAE3C,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClD,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAE7C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvC,IAAI,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC;oBAAE,OAAO,IAAI,CAAC;YACvC,CAAC;YAED,OAAO,OAAkC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,iBAAiB,CAAC,OAAgC;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;QAClC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,UAAU,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QAEpC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAElE,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,KAAK,IAAI,OAAO;gBAAE,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/auth/middleware.d.ts

@@ -0,0 +1,10 @@
+import type { Request, Response, NextFunction } from "express";
+import type { Authenticator } from "./types.js";
+export interface AuthMiddlewareOptions {
+    authenticator: Authenticator;
+    exemptPaths?: Set<string>;
+    exemptPrefixes?: Set<string>;
+    requireAuth?: boolean;
+}
+export declare function createAuthMiddleware(opts: AuthMiddlewareOptions): (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/auth/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/auth/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAQD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,IAQtD,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,IAAI,CA2B/D"}

package/dist/auth/middleware.js

@@ -0,0 +1,33 @@
+import { authIdentityStore } from "./storage.js";
+const DEFAULT_EXEMPT_PATHS = new Set([
+    "/.well-known/agent-card.json",
+    "/health",
+    "/metrics",
+]);
+export function createAuthMiddleware(opts) {
+    const { authenticator, exemptPaths = DEFAULT_EXEMPT_PATHS, exemptPrefixes = new Set(), requireAuth = true, } = opts;
+    return (req, res, next) => {
+        const path = req.path;
+        if (exemptPaths.has(path) || [...exemptPrefixes].some((p) => path.startsWith(p))) {
+            next();
+            return;
+        }
+        const headers = {};
+        for (const [key, value] of Object.entries(req.headers)) {
+            if (typeof value === "string")
+                headers[key] = value;
+        }
+        const identity = authenticator.authenticate(headers);
+        if (identity === null && requireAuth) {
+            res.status(401).set("WWW-Authenticate", "Bearer").json({
+                error: "Unauthorized",
+                detail: "Missing or invalid Bearer token",
+            });
+            return;
+        }
+        authIdentityStore.run(identity, () => {
+            next();
+        });
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/auth/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/auth/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AASjD,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,8BAA8B;IAC9B,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,IAA2B;IAC9D,MAAM,EACJ,aAAa,EACb,WAAW,GAAG,oBAAoB,EAClC,cAAc,GAAG,IAAI,GAAG,EAAU,EAClC,WAAW,GAAG,IAAI,GACnB,GAAG,IAAI,CAAC;IAET,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAC/D,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QAEtB,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtD,CAAC;QAED,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAErD,IAAI,QAAQ,KAAK,IAAI,IAAI,WAAW,EAAE,CAAC;YACrC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC;gBACrD,KAAK,EAAE,cAAc;gBACrB,MAAM,EAAE,iCAAiC;aAC1C,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE;YACnC,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/auth/storage.d.ts

@@ -0,0 +1,5 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { Identity } from "apcore-js";
+export declare const authIdentityStore: AsyncLocalStorage<Identity | null>;
+export declare function getAuthIdentity(): Identity | null;
+//# sourceMappingURL=storage.d.ts.map

package/dist/auth/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/auth/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,eAAO,MAAM,iBAAiB,oCAA2C,CAAC;AAE1E,wBAAgB,eAAe,IAAI,QAAQ,GAAG,IAAI,CAEjD"}

package/dist/auth/storage.js

@@ -0,0 +1,6 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+export const authIdentityStore = new AsyncLocalStorage();
+export function getAuthIdentity() {
+    return authIdentityStore.getStore() ?? null;
+}
+//# sourceMappingURL=storage.js.map

package/dist/auth/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/auth/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAmB,CAAC;AAE1E,MAAM,UAAU,eAAe;IAC7B,OAAO,iBAAiB,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC;AAC9C,CAAC"}

package/dist/auth/types.d.ts

@@ -0,0 +1,6 @@
+import type { Identity } from "apcore-js";
+export interface Authenticator {
+    authenticate(headers: Record<string, string>): Identity | null;
+    securitySchemes(): Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC/D,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C"}

package/dist/auth/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/auth/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":""}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+export declare function resolveAuthKey(authKey?: string): string | undefined;
+export declare function main(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA4CA,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYnE;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsD1C"}

package/dist/cli.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+import { existsSync, statSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+function printUsage() {
+    console.log(`
+apcore-a2a - A2A Protocol Server for apcore modules
+
+Usage:
+  apcore-a2a serve --extensions-dir <path> [options]
+
+Required:
+  --extensions-dir <path>    Path to apcore extensions directory
+
+Options:
+  --host <address>           Bind host (default: 127.0.0.1)
+  --port <number>            Bind port (default: 8000)
+  --name <string>            Agent name
+  --description <string>     Agent description
+  --version-str <string>     Agent version
+  --url <string>             Public URL
+  --auth-type <type>         Auth type: bearer
+  --auth-key <key>           JWT secret key (literal, file path, or JWT_SECRET env)
+  --auth-issuer <string>     JWT issuer
+  --auth-audience <string>   JWT audience
+  --push-notifications       Enable push notifications
+  --explorer                 Enable explorer UI
+  --cors-origins <origins>   Comma-separated CORS origins
+  --execution-timeout <ms>   Execution timeout in ms (default: 300000)
+  --log-level <level>        Log level: debug, info, warning, error
+  --metrics                  Enable metrics endpoint
+  --version                  Show version
+  --help                     Show this help
+`);
+}
+function fail(message, exitCode = 1) {
+    console.error(`Error: ${message}`);
+    process.exit(exitCode);
+}
+export function resolveAuthKey(authKey) {
+    if (authKey) {
+        try {
+            if (existsSync(authKey) && statSync(authKey).isFile()) {
+                return readFileSync(authKey, "utf-8").trim();
+            }
+        }
+        catch {
+            // not a file, use as literal
+        }
+        return authKey;
+    }
+    return process.env.JWT_SECRET;
+}
+export async function main() {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            options: {
+                "extensions-dir": { type: "string" },
+                host: { type: "string", default: "127.0.0.1" },
+                port: { type: "string", default: "8000" },
+                name: { type: "string" },
+                description: { type: "string" },
+                "version-str": { type: "string" },
+                url: { type: "string" },
+                "auth-type": { type: "string" },
+                "auth-key": { type: "string" },
+                "auth-issuer": { type: "string" },
+                "auth-audience": { type: "string" },
+                "push-notifications": { type: "boolean", default: false },
+                explorer: { type: "boolean", default: false },
+                "cors-origins": { type: "string" },
+                "execution-timeout": { type: "string", default: "300000" },
+                "log-level": { type: "string", default: "info" },
+                metrics: { type: "boolean", default: false },
+                version: { type: "boolean", default: false },
+                help: { type: "boolean", default: false },
+            },
+            allowPositionals: true,
+            strict: false,
+        });
+    }
+    catch (e) {
+        fail(String(e));
+    }
+    const { values, positionals } = parsed;
+    if (values.help) {
+        printUsage();
+        return;
+    }
+    if (values.version) {
+        const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+        console.log(`apcore-a2a v${pkg.version}`);
+        return;
+    }
+    const command = positionals[0];
+    if (command !== "serve") {
+        printUsage();
+        process.exit(1);
+    }
+    await runServe(values);
+}
+async function runServe(values) {
+    const extensionsDir = values["extensions-dir"];
+    if (!extensionsDir) {
+        fail("--extensions-dir is required");
+    }
+    const resolved = resolve(extensionsDir);
+    if (!existsSync(resolved)) {
+        fail(`Extensions directory not found: ${resolved}`);
+    }
+    if (!statSync(resolved).isDirectory()) {
+        fail(`Not a directory: ${resolved}`);
+    }
+    // Load registry
+    const { Registry } = await import("apcore-js");
+    const registry = new Registry({ extensionsDir: resolved });
+    const modules = registry.list();
+    if (modules.length === 0) {
+        fail(`No modules discovered in ${resolved}`);
+    }
+    console.log(`Discovered ${modules.length} module(s): ${modules.join(", ")}`);
+    // Build auth
+    let auth;
+    if (values["auth-type"] === "bearer") {
+        const key = resolveAuthKey(values["auth-key"]);
+        if (!key) {
+            fail("--auth-key is required when --auth-type is bearer");
+        }
+        const { JWTAuthenticator } = await import("./auth/jwt.js");
+        auth = new JWTAuthenticator(key, {
+            issuer: values["auth-issuer"],
+            audience: values["auth-audience"],
+        });
+    }
+    const host = values.host ?? "127.0.0.1";
+    const port = parseInt(values.port ?? "8000", 10);
+    // Warn on 0.0.0.0 without auth
+    if (host === "0.0.0.0" && !auth) {
+        console.warn("Warning: --host 0.0.0.0 binds to all network interfaces without authentication; " +
+            "consider using --host 127.0.0.1 or enabling --auth-type bearer");
+    }
+    const corsOrigins = values["cors-origins"]
+        ? values["cors-origins"].split(",").map((s) => s.trim())
+        : undefined;
+    const { serve } = await import("./serve.js");
+    serve(registry, {
+        host,
+        port,
+        name: values.name,
+        description: values.description,
+        version: values["version-str"],
+        url: values.url,
+        auth,
+        explorer: !!values.explorer,
+        corsOrigins,
+        executionTimeout: parseInt(values["execution-timeout"] ?? "300000", 10),
+        logLevel: values["log-level"],
+        metrics: !!values.metrics,
+    });
+}
+// Only run when executed directly (not imported in tests)
+const thisFile = fileURLToPath(import.meta.url);
+const isMain = typeof process !== "undefined" &&
+    process.argv[1] &&
+    resolve(process.argv[1]) === resolve(thisFile);
+if (isMain) {
+    main().catch((e) => {
+        console.error(e);
+        process.exit(2);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client/card-fetcher.d.ts

@@ -0,0 +1,13 @@
+export declare class AgentCardFetcher {
+    private url;
+    private ttl;
+    private headers;
+    private cached;
+    private cachedAt;
+    constructor(baseUrl: string, opts?: {
+        ttl?: number;
+        headers?: Record<string, string>;
+    });
+    fetch(): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=card-fetcher.d.ts.map

package/dist/client/card-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-fetcher.d.ts","sourceRoot":"","sources":["../../src/client/card-fetcher.ts"],"names":[],"mappings":"AAEA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,QAAQ,CAAK;gBAET,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAMhF,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAwBhD"}

package/dist/client/card-fetcher.js

@@ -0,0 +1,34 @@
+import { A2ADiscoveryError } from "./exceptions.js";
+export class AgentCardFetcher {
+    url;
+    ttl;
+    headers;
+    cached = null;
+    cachedAt = 0;
+    constructor(baseUrl, opts) {
+        this.url = `${baseUrl}/.well-known/agent-card.json`;
+        this.ttl = opts?.ttl ?? 300;
+        this.headers = opts?.headers ?? {};
+    }
+    async fetch() {
+        const now = performance.now() / 1000;
+        if (this.cached && now - this.cachedAt < this.ttl) {
+            return this.cached;
+        }
+        const response = await fetch(this.url, { headers: this.headers });
+        if (!response.ok) {
+            throw new A2ADiscoveryError(`Agent Card fetch failed: HTTP ${response.status} from ${this.url}`);
+        }
+        let card;
+        try {
+            card = (await response.json());
+        }
+        catch (e) {
+            throw new A2ADiscoveryError(`Invalid JSON in Agent Card from ${this.url}: ${e}`);
+        }
+        this.cached = card;
+        this.cachedAt = now;
+        return card;
+    }
+}
+//# sourceMappingURL=card-fetcher.js.map

package/dist/client/card-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-fetcher.js","sourceRoot":"","sources":["../../src/client/card-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,OAAO,gBAAgB;IACnB,GAAG,CAAS;IACZ,GAAG,CAAS;IACZ,OAAO,CAAyB;IAChC,MAAM,GAAmC,IAAI,CAAC;IAC9C,QAAQ,GAAG,CAAC,CAAC;IAErB,YAAY,OAAe,EAAE,IAAyD;QACpF,IAAI,CAAC,GAAG,GAAG,GAAG,OAAO,8BAA8B,CAAC;QACpD,IAAI,CAAC,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,iBAAiB,CACzB,iCAAiC,QAAQ,CAAC,MAAM,SAAS,IAAI,CAAC,GAAG,EAAE,CACpE,CAAC;QACJ,CAAC;QAED,IAAI,IAA6B,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;QAC5D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,iBAAiB,CAAC,mCAAmC,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/client/client.d.ts

@@ -0,0 +1,30 @@
+export declare class A2AClient {
+    private url;
+    private headers;
+    private timeout;
+    private cardFetcher;
+    constructor(url: string, opts?: {
+        auth?: string;
+        timeout?: number;
+        cardTtl?: number;
+    });
+    private validateUrl;
+    discover(): Promise<Record<string, unknown>>;
+    sendMessage(message: Record<string, unknown>, opts?: {
+        metadata?: Record<string, unknown>;
+        contextId?: string;
+    }): Promise<Record<string, unknown>>;
+    getTask(taskId: string): Promise<Record<string, unknown>>;
+    cancelTask(taskId: string): Promise<Record<string, unknown>>;
+    listTasks(opts?: {
+        contextId?: string;
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
+    streamMessage(message: Record<string, unknown>, opts?: {
+        metadata?: Record<string, unknown>;
+        contextId?: string;
+    }): AsyncGenerator<Record<string, unknown>>;
+    close(): void;
+    private jsonrpcCall;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAsBA,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAmB;gBAE1B,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAYrF,OAAO,CAAC,WAAW;IAWb,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI5C,WAAW,CACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAM7B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIzD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI5D,SAAS,CAAC,IAAI,CAAC,EAAE;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAM7B,aAAa,CAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA2D1C,KAAK,IAAI,IAAI;YAIC,WAAW;CAiC1B"}