@agnt-id/a2a 0.1.0

package/dist/convert.d.ts

@@ -0,0 +1,51 @@
+import type { AgentCard, ToAgentCardOptions } from "./types.js";
+/**
+ * Minimal shape of an .agnt record — matches @agnt-id/resolve AgntRecord
+ * without requiring the dependency at compile time.
+ */
+export type AgntRecordLike = {
+    wallets?: Record<string, string>;
+    agentId?: string;
+    a2a?: string;
+    mcp?: string;
+    texts?: Record<string, string>;
+    identity?: string;
+    wallet?: string;
+    did?: string;
+    skills?: string[];
+    domains?: string[];
+    a2aVersion?: string;
+    profileURI?: string;
+    x402Support?: boolean;
+};
+/**
+ * Minimal shape of a resolved .agnt name.
+ */
+export type AgntNameLike = {
+    name: string;
+    owner: string;
+    records: AgntRecordLike;
+};
+/**
+ * Convert a resolved .agnt name to a Google A2A Agent Card.
+ *
+ * @param agnt - Resolved .agnt name data
+ * @param options - Optional overrides and additions
+ * @returns A well-formed A2A AgentCard
+ */
+export declare function toAgentCard(agnt: AgntNameLike, options?: ToAgentCardOptions): AgentCard;
+/**
+ * Serialize an A2A Agent Card to JSON (pretty-printed).
+ */
+export declare function agentCardToJSON(card: AgentCard): string;
+/**
+ * Resolve a .agnt name and return its A2A Agent Card.
+ * Requires @agnt-id/resolve to be installed.
+ *
+ * @param name - .agnt name or label (e.g. "alice" or "alice.agnt")
+ * @param options - Agent card options + optional gateway/chainId
+ */
+export declare function fromAgnt(name: string, options?: ToAgentCardOptions & {
+    gateway?: string;
+    chainId?: string;
+}): Promise<AgentCard | null>;

package/dist/convert.js

@@ -0,0 +1,84 @@
+/**
+ * Convert a resolved .agnt name to a Google A2A Agent Card.
+ *
+ * @param agnt - Resolved .agnt name data
+ * @param options - Optional overrides and additions
+ * @returns A well-formed A2A AgentCard
+ */
+export function toAgentCard(agnt, options = {}) {
+    const rec = agnt.records;
+    const description = rec.texts?.description ?? `AI agent registered as ${agnt.name}`;
+    const avatar = rec.texts?.avatar;
+    // Derive skills from OASF slugs
+    const skills = (rec.skills ?? []).map((slug) => ({
+        id: slug,
+        name: slug.replaceAll("_", " ").replaceAll("/", " — "),
+        description: slug,
+        tags: rec.domains ?? [],
+    }));
+    if (options.extraSkills) {
+        skills.push(...options.extraSkills);
+    }
+    // If no skills at all, add a generic one based on name
+    if (skills.length === 0) {
+        skills.push({
+            id: "default",
+            name: agnt.name,
+            description,
+            tags: rec.domains ?? [],
+        });
+    }
+    // Build the interface list — A2A endpoint is required
+    const a2aUrl = rec.a2a;
+    const binding = options.protocolBinding ?? "JSONRPC";
+    const protocolVersion = options.protocolVersion ?? "1.0";
+    const card = {
+        name: agnt.name,
+        description,
+        version: options.version ?? "1.0.0",
+        supportedInterfaces: a2aUrl
+            ? [{ url: a2aUrl, protocolBinding: binding, protocolVersion }]
+            : [],
+        skills,
+        defaultInputModes: options.defaultInputModes ?? ["text/plain"],
+        defaultOutputModes: options.defaultOutputModes ?? ["text/plain"],
+    };
+    if (avatar)
+        card.iconUrl = avatar;
+    if (rec.profileURI)
+        card.documentationUrl = rec.profileURI;
+    if (options.provider)
+        card.provider = options.provider;
+    if (options.capabilities)
+        card.capabilities = options.capabilities;
+    if (options.securitySchemes)
+        card.securitySchemes = options.securitySchemes;
+    if (options.securityRequirements)
+        card.securityRequirements = options.securityRequirements;
+    return card;
+}
+/**
+ * Serialize an A2A Agent Card to JSON (pretty-printed).
+ */
+export function agentCardToJSON(card) {
+    return JSON.stringify(card, null, 2);
+}
+/**
+ * Resolve a .agnt name and return its A2A Agent Card.
+ * Requires @agnt-id/resolve to be installed.
+ *
+ * @param name - .agnt name or label (e.g. "alice" or "alice.agnt")
+ * @param options - Agent card options + optional gateway/chainId
+ */
+export async function fromAgnt(name, options = {}) {
+    // Dynamic import so @agnt-id/resolve stays an optional peer dep
+    const { AgntClient } = await import("@agnt-id/resolve");
+    const client = new AgntClient({
+        gateway: options.gateway,
+        chainId: options.chainId,
+    });
+    const result = await client.resolve(name);
+    if (!result)
+        return null;
+    return toAgentCard(result, options);
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { AgntNameLike, AgntRecordLike } from "./convert.js";
+export { agentCardToJSON, fromAgnt, toAgentCard } from "./convert.js";
+export type { AgentCapabilities, AgentCard, AgentCardSignature, AgentExtension, AgentInterface, AgentProvider, AgentSkill, APIKeySecurityScheme, HTTPAuthSecurityScheme, OAuth2SecurityScheme, OAuthFlows, OpenIdConnectSecurityScheme, SecurityRequirement, SecurityScheme, ToAgentCardOptions, } from "./types.js";

package/dist/index.js

@@ -0,0 +1 @@
+export { agentCardToJSON, fromAgnt, toAgentCard } from "./convert.js";

package/dist/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Google A2A protocol types — Agent Card and related structures.
+ * Based on the A2A specification v1.0 / v0.3.
+ * @see https://a2a-protocol.org/latest/specification/
+ */
+/** Top-level A2A Agent Card. */
+export type AgentCard = {
+    /** Human-readable agent name. */
+    name: string;
+    /** Description of what the agent does. */
+    description: string;
+    /** Semantic version string. */
+    version: string;
+    /** URL to an icon image. */
+    iconUrl?: string;
+    /** URL to additional documentation. */
+    documentationUrl?: string;
+    /** Service provider information. */
+    provider?: AgentProvider;
+    /** Protocol bindings ordered by preference. */
+    supportedInterfaces: AgentInterface[];
+    /** Feature flags. */
+    capabilities?: AgentCapabilities;
+    /** Agent abilities / tools. */
+    skills: AgentSkill[];
+    /** Accepted input media types (default: ["text/plain"]). */
+    defaultInputModes?: string[];
+    /** Produced output media types (default: ["text/plain"]). */
+    defaultOutputModes?: string[];
+    /** Named security scheme definitions. */
+    securitySchemes?: Record<string, SecurityScheme>;
+    /** Required security — references keys in securitySchemes. */
+    securityRequirements?: SecurityRequirement[];
+    /** JWS signatures for card integrity. */
+    signatures?: AgentCardSignature[];
+};
+export type AgentProvider = {
+    url: string;
+    organization: string;
+};
+export type AgentInterface = {
+    /** Absolute HTTPS URL. */
+    url: string;
+    /** "JSONRPC" | "GRPC" | "HTTP+JSON" */
+    protocolBinding: string;
+    /** Optional tenant identifier. */
+    tenant?: string;
+    /** Protocol version — "0.3" | "1.0". */
+    protocolVersion?: string;
+};
+export type AgentCapabilities = {
+    streaming?: boolean;
+    pushNotifications?: boolean;
+    extensions?: AgentExtension[];
+    extendedAgentCard?: boolean;
+};
+export type AgentExtension = {
+    uri: string;
+    description?: string;
+    required?: boolean;
+};
+export type AgentSkill = {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+};
+export type SecurityScheme = APIKeySecurityScheme | HTTPAuthSecurityScheme | OAuth2SecurityScheme | OpenIdConnectSecurityScheme;
+export type APIKeySecurityScheme = {
+    type: "apiKey";
+    description?: string;
+    location: "query" | "header" | "cookie";
+    name: string;
+};
+export type HTTPAuthSecurityScheme = {
+    type: "http";
+    description?: string;
+    scheme: string;
+    bearerFormat?: string;
+};
+export type OAuth2SecurityScheme = {
+    type: "oauth2";
+    description?: string;
+    flows: OAuthFlows;
+};
+export type OpenIdConnectSecurityScheme = {
+    type: "openIdConnect";
+    description?: string;
+    openIdConnectUrl: string;
+};
+export type OAuthFlows = {
+    authorizationCode?: {
+        authorizationUrl: string;
+        tokenUrl: string;
+        refreshUrl?: string;
+        scopes: Record<string, string>;
+    };
+    clientCredentials?: {
+        tokenUrl: string;
+        refreshUrl?: string;
+        scopes: Record<string, string>;
+    };
+};
+export type SecurityRequirement = Record<string, string[]>;
+export type AgentCardSignature = {
+    /** JWS compact serialisation. */
+    value: string;
+    /** Key ID or URL. */
+    keyId?: string;
+};
+/** Options for converting a .agnt record to an A2A Agent Card. */
+export type ToAgentCardOptions = {
+    /** Override the agent version (default: "1.0.0"). */
+    version?: string;
+    /** Override the A2A protocol binding (default: "JSONRPC"). */
+    protocolBinding?: "JSONRPC" | "GRPC" | "HTTP+JSON";
+    /** Override the protocol version (default: "1.0"). */
+    protocolVersion?: string;
+    /** Provider details to include. */
+    provider?: AgentProvider;
+    /** Extra capabilities to set. */
+    capabilities?: AgentCapabilities;
+    /** Security schemes to add. */
+    securitySchemes?: Record<string, SecurityScheme>;
+    /** Security requirements to add. */
+    securityRequirements?: SecurityRequirement[];
+    /** Extra skills to append beyond those derived from records. */
+    extraSkills?: AgentSkill[];
+    /** Custom input modes. */
+    defaultInputModes?: string[];
+    /** Custom output modes. */
+    defaultOutputModes?: string[];
+};

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Google A2A protocol types — Agent Card and related structures.
+ * Based on the A2A specification v1.0 / v0.3.
+ * @see https://a2a-protocol.org/latest/specification/
+ */
+export {};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@agnt-id/a2a",
+  "version": "0.1.0",
+  "description": "Generate Google A2A Agent Cards from .agnt names",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": [
+    "agnt",
+    "a2a",
+    "agent",
+    "agent-card",
+    "agent-to-agent",
+    "google-a2a",
+    "naming",
+    "resolve"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@agnt-id/resolve": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@agnt-id/resolve": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}