@plurnk/plurnk-a2a 1.9.0

package/dist/A2aProjection.js

@@ -0,0 +1,183 @@
+import { AgentCard, Artifact, Message, Task, taskStateToJSON, } from "@a2a-js/sdk";
+const serialized = (codec, value) => `${JSON.stringify(codec.toJSON(value), null, 2)}\n`;
+/** Model-oriented projections of canonical A2A v1 resources. */
+export default class A2aProjection {
+    static taskPath(taskId) {
+        return `/tasks/${encodeURIComponent(taskId)}`;
+    }
+    static messagePath(messageId) {
+        return `/messages/${encodeURIComponent(messageId)}`;
+    }
+    static artifactPath(taskId, artifactId) {
+        return `${A2aProjection.taskPath(taskId)}/artifacts/${encodeURIComponent(artifactId)}`;
+    }
+    static taskIdentity(pathname) {
+        const match = /^\/tasks\/([^/]+)$/.exec(pathname);
+        if (match === null)
+            return null;
+        try {
+            const taskId = decodeURIComponent(match[1]);
+            return A2aProjection.taskPath(taskId) === pathname ? taskId : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    static artifactIdentity(pathname) {
+        const match = /^\/tasks\/([^/]+)\/artifacts\/([^/]+)$/.exec(pathname);
+        if (match === null)
+            return null;
+        try {
+            const taskId = decodeURIComponent(match[1]);
+            const artifactId = decodeURIComponent(match[2]);
+            return A2aProjection.artifactPath(taskId, artifactId) === pathname
+                ? { taskId, artifactId }
+                : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    static taskSeed(task) {
+        return {
+            channels: {
+                body: { content: "", mimetype: "text/markdown", state: "active" },
+                json: { content: "", mimetype: "application/json", state: "active" },
+            },
+            attributes: {
+                kind: "task",
+                taskId: task.id,
+                contextId: task.contextId,
+            },
+        };
+    }
+    static taskEntry(task, authority) {
+        const content = A2aProjection.taskContent(task, authority);
+        return {
+            channels: {
+                body: { content: content.body, mimetype: "text/markdown" },
+                json: { content: content.json, mimetype: "application/json" },
+            },
+            attributes: {
+                kind: "task",
+                taskId: task.id,
+                contextId: task.contextId,
+            },
+        };
+    }
+    static taskContent(task, authority) {
+        const state = taskStateToJSON(task.status?.state ?? 0)
+            .replace(/^TASK_STATE_/, "")
+            .toLowerCase()
+            .replaceAll("_", "-");
+        const statusMessage = task.status?.message === undefined
+            ? []
+            : ["message:", A2aProjection.#parts(task.status.message.parts)];
+        const artifacts = task.artifacts.length === 0
+            ? "none"
+            : task.artifacts.map((artifact) => {
+                const label = artifact.name.length > 0 ? artifact.name : artifact.artifactId;
+                return `- ${label}: a2a://${authority}${A2aProjection.artifactPath(task.id, artifact.artifactId)}`;
+            }).join("\n");
+        return {
+            body: [
+                `state: ${state}`,
+                `taskId: ${task.id}`,
+                `contextId: ${task.contextId}`,
+                ...statusMessage,
+                "artifacts:",
+                artifacts,
+                "",
+            ].join("\n"),
+            json: serialized(Task, task),
+        };
+    }
+    static messageEntry(message) {
+        return {
+            channels: {
+                body: {
+                    content: [
+                        `messageId: ${message.messageId}`,
+                        `contextId: ${message.contextId}`,
+                        "",
+                        A2aProjection.#parts(message.parts),
+                    ].join("\n"),
+                    mimetype: "text/markdown",
+                },
+                json: { content: serialized(Message, message), mimetype: "application/json" },
+            },
+            attributes: {
+                kind: "message",
+                messageId: message.messageId,
+                contextId: message.contextId,
+            },
+        };
+    }
+    static artifactEntry(task, artifact) {
+        return {
+            channels: {
+                body: {
+                    content: [
+                        `artifactId: ${artifact.artifactId}`,
+                        `taskId: ${task.id}`,
+                        `contextId: ${task.contextId}`,
+                        ...(artifact.name.length === 0 ? [] : [`name: ${artifact.name}`]),
+                        ...(artifact.description.length === 0 ? [] : [`description: ${artifact.description}`]),
+                        "",
+                        A2aProjection.#parts(artifact.parts),
+                    ].join("\n"),
+                    mimetype: "text/markdown",
+                },
+                json: { content: serialized(Artifact, artifact), mimetype: "application/json" },
+            },
+            attributes: {
+                kind: "artifact",
+                taskId: task.id,
+                contextId: task.contextId,
+                artifactId: artifact.artifactId,
+            },
+        };
+    }
+    static agentCardEntry(card) {
+        const skills = card.skills.length === 0
+            ? "none"
+            : card.skills.map((skill) => `- ${skill.id}: ${skill.description}`).join("\n");
+        return {
+            channels: {
+                body: {
+                    content: [
+                        `# ${card.name}`,
+                        "",
+                        card.description,
+                        "",
+                        "skills:",
+                        skills,
+                        "",
+                    ].join("\n"),
+                    mimetype: "text/markdown",
+                },
+                json: { content: serialized(AgentCard, card), mimetype: "application/json" },
+            },
+            attributes: { kind: "agent-card" },
+        };
+    }
+    static #parts(parts) {
+        if (parts.length === 0)
+            return "(no content)";
+        return parts.map((part, index) => {
+            const heading = parts.length === 1 ? "" : `### Part ${index + 1}\n\n`;
+            const content = part.content;
+            if (content === undefined)
+                return `${heading}(empty part)`;
+            if (content.$case === "text")
+                return `${heading}${content.value}`;
+            if (content.$case === "url")
+                return `${heading}${content.value}`;
+            if (content.$case === "data") {
+                return `${heading}\`\`\`json\n${JSON.stringify(content.value, null, 2)}\n\`\`\``;
+            }
+            return `${heading}[${part.mediaType || "application/octet-stream"}; ${content.value.length} bytes; exact base64 in #json]`;
+        }).join("\n\n");
+    }
+}
+//# sourceMappingURL=A2aProjection.js.map

package/dist/A2aProjection.js.map

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

package/dist/Functionality.d.ts

@@ -0,0 +1,77 @@
+import type { AgentCard } from "@a2a-js/sdk";
+import type { Client } from "@a2a-js/sdk/client";
+import { type FunctionalityCandidate, type FunctionalityDiscoverQuery, type JsonSchema, type ProblemDetails } from "@plurnk/plurnk-contracts";
+export declare const AGENTS_FAMILY = "agents";
+export declare const AGENTS_OWNER = "@plurnk/plurnk-a2a";
+interface WorkerIdentity {
+    readonly workspaceId: number;
+    readonly workerId: number;
+}
+type Outcome = {
+    readonly state: "active";
+    readonly detail?: object;
+} | {
+    readonly state: "unavailable";
+    readonly problem: ProblemDetails;
+} | {
+    readonly state: "authorization-required";
+    readonly authorization: {
+        readonly url: string;
+    };
+};
+interface Preparation extends WorkerIdentity {
+    readonly enabled: ReadonlyMap<string, object>;
+    readonly previous: unknown | null;
+    readonly failure: "publish-unavailable" | "reject";
+    readonly force?: string;
+    retain(): () => void;
+}
+interface Prepared {
+    readonly runtimes: readonly never[];
+    readonly documents: readonly {
+        readonly pathname: string;
+        readonly content: string;
+    }[];
+    readonly outcomes: ReadonlyMap<string, Outcome>;
+    readonly snapshot: unknown;
+    commit(): Promise<void>;
+    abort(): Promise<void>;
+}
+export interface FunctionalityFamilyHandle {
+    invoke(verb: "list" | "discover" | "add" | "enable" | "disable" | "remove", params: unknown, identity: WorkerIdentity): Promise<{
+        readonly status: number;
+        readonly body: unknown;
+    }>;
+    refresh(identity: WorkerIdentity): Promise<void>;
+}
+export declare class A2aFunctionalityError extends Error {
+    readonly problem: ProblemDetails;
+    constructor(problem: ProblemDetails, cause?: unknown);
+}
+export declare const aliasOfCard: (card: AgentCard) => string;
+export declare const renderAgent: (alias: string, card: AgentCard) => string;
+export default class A2aFunctionality {
+    #private;
+    readonly family = "agents";
+    readonly namespaceOwner = "@plurnk/plurnk-a2a";
+    readonly summary = "Outbound A2A agents: remote peers addressed as a2a://<alias>, enabled per Worker.";
+    readonly definitionSchema: JsonSchema;
+    constructor(env?: NodeJS.ProcessEnv);
+    attach(handle: FunctionalityFamilyHandle): void;
+    get handle(): FunctionalityFamilyHandle;
+    resolve(authority: string, workerId: number): Client | null;
+    available(): Promise<readonly {
+        alias: string;
+        definition: object;
+        enabled: boolean;
+    }[]>;
+    discover(query: FunctionalityDiscoverQuery): Promise<readonly FunctionalityCandidate[]>;
+    admit(input: unknown): Promise<{
+        alias: string;
+        definition: object;
+    }>;
+    prepare(preparation: Preparation): Promise<Prepared>;
+    teardown(_snapshot: unknown, identity: WorkerIdentity): Promise<void>;
+}
+export {};
+//# sourceMappingURL=Functionality.d.ts.map

package/dist/Functionality.d.ts.map

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

package/dist/Functionality.js

@@ -0,0 +1,247 @@
+import { Problems, Validator, } from "@plurnk/plurnk-contracts";
+import { outboundDefinitions, serviceEnabledNames } from "./config.js";
+import { connectHttpJsonAgentFromCard, discoverAgentCard } from "./HttpJsonClient.js";
+export const AGENTS_FAMILY = "agents";
+export const AGENTS_OWNER = "@plurnk/plurnk-a2a";
+const DEFINITION = { $ref: "https://schemas.plurnk.xyz/v0/A2aAgentDefinition.json" };
+const ALIAS = /^[a-z][a-z0-9-]*$/u;
+const ENV_REFERENCE = /^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$/u;
+export class A2aFunctionalityError extends Error {
+    problem;
+    constructor(problem, cause) {
+        super(problem.detail, cause === undefined ? undefined : { cause });
+        this.name = "A2aFunctionalityError";
+        this.problem = problem;
+    }
+}
+const problem = (code, status, detail, extensions = {}) => Problems.create("a2a:functionality", code, status, detail, {
+    stage: "a2a-functionality",
+    retryable: status === 409 || status >= 500,
+    ...extensions,
+});
+const failure = (code, status, detail, extensions = {}, cause) => new A2aFunctionalityError(problem(code, status, detail, extensions), cause);
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const messageOf = (cause) => cause instanceof Error ? cause.message : String(cause);
+const sameDefinition = (left, right) => JSON.stringify(left) === JSON.stringify(right);
+// A symbolic `${NAME}` reference resolves at connection; anything else is literal.
+const resolveReference = (value, env, alias, field) => {
+    const match = ENV_REFERENCE.exec(value);
+    if (match === null)
+        return value;
+    const resolved = env[match[1]];
+    if (resolved === undefined || resolved.length === 0) {
+        throw failure("authorization-unresolved", 409, `A2A agent '${alias}' references ${value} in ${field}, which is not set in the service environment.`, { agent: alias, field, reference: value, retryable: true });
+    }
+    return resolved;
+};
+export const aliasOfCard = (card) => {
+    const slug = card.name.toLowerCase().replace(/[^a-z0-9]+/gu, "-").replace(/^-+|-+$/gu, "");
+    const candidate = /^[a-z]/u.test(slug) ? slug : `agent${slug.length === 0 ? "" : `-${slug}`}`;
+    return ALIAS.test(candidate) ? candidate : "agent";
+};
+// {§a2a-agents-catalog} — one concise model-facing document per active alias:
+// identity to choose among agents and the invocation form; the exact card and
+// its skills stay pullable through `READ a2a://<alias>`.
+export const renderAgent = (alias, card) => {
+    const description = card.description.trim().replace(/\s+/gu, " ");
+    const version = card.version.trim().length === 0 ? "" : ` v${card.version.trim()}`;
+    const streaming = card.capabilities?.streaming === true ? "yes" : "no";
+    return [
+        `# ${alias}`,
+        "",
+        "## Summary",
+        "",
+        `a2a://${alias} — ${card.name}${version}: ${description}`,
+        "",
+        "## Invocation",
+        "",
+        "```plurnk",
+        `## SEND0 [200] (a2a://${alias})`,
+        "Describe the work for this agent; a Task answers 102 and its result wakes the next turn.",
+        "```",
+        "",
+        `streaming: ${streaming} · card and skills: \`READ a2a://${alias}\``,
+    ].join("\n");
+};
+export default class A2aFunctionality {
+    family = AGENTS_FAMILY;
+    namespaceOwner = AGENTS_OWNER;
+    summary = "Outbound A2A agents: remote peers addressed as a2a://<alias>, enabled per Worker.";
+    definitionSchema = DEFINITION;
+    #env;
+    #snapshots = new Map();
+    #handle = null;
+    constructor(env = process.env) {
+        this.#env = env;
+    }
+    attach(handle) {
+        this.#handle = handle;
+    }
+    get handle() {
+        if (this.#handle === null)
+            throw new Error("A2A agents Functionality is not attached to its coordinator handle.");
+        return this.#handle;
+    }
+    // The `a2a` scheme's resolver: the alias in the Functionality of the Worker
+    // the operation acts in. Unknown or disabled → null (404 at the scheme);
+    // unavailable → its one exact preparation Problem.
+    resolve(authority, workerId) {
+        const snapshot = this.#snapshots.get(workerId);
+        if (snapshot === undefined)
+            return null;
+        const attachment = snapshot.attachments.get(authority);
+        if (attachment !== undefined)
+            return attachment.client;
+        const unavailable = snapshot.unavailable.get(authority);
+        if (unavailable !== undefined)
+            throw new A2aFunctionalityError(structuredClone(unavailable.problem));
+        return null;
+    }
+    async available() {
+        const enabled = new Set(serviceEnabledNames(this.#env));
+        return outboundDefinitions(this.#env).map((definition) => ({
+            alias: definition.name,
+            definition,
+            enabled: enabled.has(definition.name),
+        }));
+    }
+    async discover(query) {
+        if (query.configuration !== undefined) {
+            const overlay = Object.fromEntries(Object.entries(query.configuration).filter(([, value]) => typeof value === "string"));
+            let definitions;
+            try {
+                definitions = outboundDefinitions(overlay);
+            }
+            catch (cause) {
+                throw failure("configuration-invalid", 400, `The offered A2A configuration is invalid: ${messageOf(cause)}`, { retryable: false }, cause);
+            }
+            return definitions.map((definition) => ({
+                alias: definition.name,
+                definition,
+                provenance: { kind: "client-configuration", source: `PLURNK_A2A_${definition.name.toUpperCase()}` },
+            }));
+        }
+        if (query.source !== undefined) {
+            const source = query.source;
+            if (!/^https?:\/\//u.test(source)) {
+                throw failure("source-invalid", 400, `A2A discovery takes an absolute HTTP(S) agent URL; got ${JSON.stringify(source)}.`, { source, retryable: false });
+            }
+            let card;
+            try {
+                card = await discoverAgentCard(source);
+            }
+            catch (cause) {
+                throw failure("card-unreachable", 502, `No standard Agent Card could be discovered at '${source}': ${messageOf(cause)}`, { source, retryable: true }, cause);
+            }
+            const alias = aliasOfCard(card);
+            return [{
+                    alias,
+                    summary: card.description,
+                    definition: { name: alias, url: source },
+                    provenance: { kind: "agent-card", source, reference: card.name },
+                }];
+        }
+        if (query.query !== undefined) {
+            throw failure("registry-not-configured", 501, "A2A registry search requires a configured downstream registry; none is configured.", { query: query.query, recovery: "Discover an explicit agent URL.", retryable: false });
+        }
+        return [];
+    }
+    async admit(input) {
+        const params = isRecord(input) ? input : {};
+        let definition;
+        try {
+            definition = structuredClone(Validator.assertA2aAgentDefinition(structuredClone(params.definition)));
+        }
+        catch (cause) {
+            throw failure("definition-invalid", 400, "The A2A agent definition is invalid.", { retryable: false }, cause);
+        }
+        const alias = typeof params.alias === "string" ? params.alias : definition.name;
+        if (alias !== definition.name) {
+            throw failure("alias-mismatch", 400, `Alias '${alias}' must equal the definition's name '${definition.name}'.`, { alias, name: definition.name, retryable: false });
+        }
+        return { alias, definition };
+    }
+    async #attach(alias, definition) {
+        const headers = {};
+        for (const [name, value] of Object.entries(definition.headers ?? {})) {
+            headers[name] = resolveReference(value, this.#env, alias, `headers.${name}`);
+        }
+        if (definition.authorization !== undefined) {
+            headers.Authorization = `Bearer ${resolveReference(definition.authorization.token, this.#env, alias, "authorization.token")}`;
+        }
+        let card;
+        try {
+            card = await discoverAgentCard(definition.url, definition.cardPath, { headers });
+        }
+        catch (cause) {
+            throw failure("card-unreachable", 502, `A2A agent '${alias}' has no discoverable standard Agent Card at ${definition.url}: ${messageOf(cause)}`, { agent: alias, url: definition.url, retryable: true }, cause);
+        }
+        let client;
+        try {
+            client = await connectHttpJsonAgentFromCard(card, { headers });
+        }
+        catch (cause) {
+            throw failure("interface-unsupported", 502, `A2A agent '${alias}' advertises no usable HTTP+JSON 1.0 interface: ${messageOf(cause)}`, { agent: alias, url: definition.url, interfaces: card.supportedInterfaces.map(({ protocolBinding, protocolVersion }) => `${protocolBinding} ${protocolVersion}`), retryable: false }, cause);
+        }
+        return { definition, card, client };
+    }
+    async prepare(preparation) {
+        const previous = preparation.previous;
+        const attachments = new Map();
+        const unavailable = new Map();
+        const outcomes = new Map();
+        for (const [alias, raw] of preparation.enabled) {
+            const definition = raw;
+            const kept = previous?.attachments.get(alias);
+            if (kept !== undefined && sameDefinition(kept.definition, definition) && preparation.force !== alias) {
+                attachments.set(alias, kept);
+            }
+            else {
+                const carried = previous?.unavailable.get(alias);
+                const fresh = carried === undefined || !sameDefinition(carried.definition, definition) || preparation.force === alias;
+                try {
+                    attachments.set(alias, await this.#attach(alias, definition));
+                }
+                catch (cause) {
+                    if (!(cause instanceof A2aFunctionalityError))
+                        throw cause;
+                    if (preparation.failure === "reject" && fresh)
+                        throw cause;
+                    if (fresh)
+                        console.error(`A2A agent '${alias}' unavailable: ${cause.problem.detail}`);
+                    unavailable.set(alias, { definition, problem: structuredClone(cause.problem) });
+                    outcomes.set(alias, { state: "unavailable", problem: structuredClone(cause.problem) });
+                    continue;
+                }
+            }
+            const { card } = attachments.get(alias);
+            outcomes.set(alias, {
+                state: "active",
+                detail: {
+                    name: card.name,
+                    version: card.version,
+                    description: card.description,
+                    skills: card.skills.map(({ id }) => id),
+                    streaming: card.capabilities?.streaming === true,
+                },
+            });
+        }
+        const documents = [...attachments]
+            .toSorted(([left], [right]) => left.localeCompare(right))
+            .map(([alias, { card }]) => ({ pathname: `agents/${encodeURIComponent(alias)}.md`, content: renderAgent(alias, card) }));
+        const snapshot = { attachments, unavailable };
+        const { workerId } = preparation;
+        return {
+            runtimes: [],
+            documents,
+            outcomes,
+            snapshot,
+            commit: async () => { this.#snapshots.set(workerId, snapshot); },
+            abort: async () => { },
+        };
+    }
+    async teardown(_snapshot, identity) {
+        this.#snapshots.delete(identity.workerId);
+    }
+}
+//# sourceMappingURL=Functionality.js.map

package/dist/Functionality.js.map

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

package/dist/HttpJsonClient.d.ts

@@ -0,0 +1,21 @@
+import { type Client } from "@a2a-js/sdk/client";
+import type { AgentCard } from "@a2a-js/sdk";
+export interface HttpJsonConnectionOptions {
+    /** Exact request headers applied to card discovery and every protocol request. */
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly fetchImpl?: typeof fetch;
+}
+/**
+ * Discover one standard A2A Agent Card without creating a client: inert
+ * discovery. The standard well-known card path is used unless `agentCardPath`
+ * is given.
+ */
+export declare const discoverAgentCard: (baseUrl: string, agentCardPath?: string, options?: HttpJsonConnectionOptions) => Promise<AgentCard>;
+/**
+ * Discover an A2A v1 Agent Card and connect through its HTTP+JSON interface.
+ * The standard well-known card path is used unless `agentCardPath` is given.
+ */
+export declare const connectHttpJsonAgent: (baseUrl: string, agentCardPath?: string, options?: HttpJsonConnectionOptions) => Promise<Client>;
+/** Connect through an already-discovered card (no second discovery request). */
+export declare const connectHttpJsonAgentFromCard: (card: AgentCard, options?: HttpJsonConnectionOptions) => Promise<Client>;
+//# sourceMappingURL=HttpJsonClient.d.ts.map

package/dist/HttpJsonClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpJsonClient.d.ts","sourceRoot":"","sources":["../src/HttpJsonClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,MAAM,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,yBAAyB;IACtC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACrC;AAWD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,YACjB,MAAM,kBACC,MAAM,YACb,yBAAyB,KACnC,OAAO,CAAC,SAAS,CAAoG,CAAC;AAEzH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,YACpB,MAAM,kBACC,MAAM,YACb,yBAAyB,KACnC,OAAO,CAAC,MAAM,CAQhB,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,4BAA4B,SAC/B,SAAS,YACN,yBAAyB,KACnC,OAAO,CAAC,MAAM,CAQhB,CAAC"}

package/dist/HttpJsonClient.js

@@ -0,0 +1,41 @@
+import { ClientFactory, DefaultAgentCardResolver, RestTransportFactory, } from "@a2a-js/sdk/client";
+const fetchWith = ({ headers, fetchImpl = fetch }) => {
+    if (headers === undefined || Object.keys(headers).length === 0)
+        return fetchImpl;
+    return (input, init) => {
+        const merged = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
+        for (const [name, value] of Object.entries(headers))
+            merged.set(name, value);
+        return fetchImpl(input, { ...init, headers: merged });
+    };
+};
+/**
+ * Discover one standard A2A Agent Card without creating a client: inert
+ * discovery. The standard well-known card path is used unless `agentCardPath`
+ * is given.
+ */
+export const discoverAgentCard = (baseUrl, agentCardPath, options = {}) => new DefaultAgentCardResolver({ fetchImpl: fetchWith(options) }).resolve(baseUrl, agentCardPath);
+/**
+ * Discover an A2A v1 Agent Card and connect through its HTTP+JSON interface.
+ * The standard well-known card path is used unless `agentCardPath` is given.
+ */
+export const connectHttpJsonAgent = (baseUrl, agentCardPath, options = {}) => {
+    const fetchImpl = fetchWith(options);
+    const factory = new ClientFactory({
+        transports: [new RestTransportFactory({ fetchImpl })],
+        preferredTransports: ["HTTP+JSON"],
+        cardResolver: new DefaultAgentCardResolver({ fetchImpl }),
+    });
+    return factory.createFromUrl(baseUrl, agentCardPath);
+};
+/** Connect through an already-discovered card (no second discovery request). */
+export const connectHttpJsonAgentFromCard = (card, options = {}) => {
+    const fetchImpl = fetchWith(options);
+    const factory = new ClientFactory({
+        transports: [new RestTransportFactory({ fetchImpl })],
+        preferredTransports: ["HTTP+JSON"],
+        cardResolver: new DefaultAgentCardResolver({ fetchImpl }),
+    });
+    return factory.createFromAgentCard(card);
+};
+//# sourceMappingURL=HttpJsonClient.js.map

package/dist/HttpJsonClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpJsonClient.js","sourceRoot":"","sources":["../src/HttpJsonClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,aAAa,EACb,wBAAwB,EACxB,oBAAoB,GAEvB,MAAM,oBAAoB,CAAC;AAS5B,MAAM,SAAS,GAAG,CAAC,EAAE,OAAO,EAAE,SAAS,GAAG,KAAK,EAA6B,EAAgB,EAAE;IAC1F,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACjF,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QACpG,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7E,OAAO,SAAS,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC;AACN,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC7B,OAAe,EACf,aAAsB,EACtB,OAAO,GAA8B,EAAE,EACrB,EAAE,CAAC,IAAI,wBAAwB,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAEzH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAChC,OAAe,EACf,aAAsB,EACtB,OAAO,GAA8B,EAAE,EACxB,EAAE;IACjB,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC;QAC9B,UAAU,EAAE,CAAC,IAAI,oBAAoB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,mBAAmB,EAAE,CAAC,WAAW,CAAC;QAClC,YAAY,EAAE,IAAI,wBAAwB,CAAC,EAAE,SAAS,EAAE,CAAC;KAC5D,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AACzD,CAAC,CAAC;AAEF,gFAAgF;AAChF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CACxC,IAAe,EACf,OAAO,GAA8B,EAAE,EACxB,EAAE;IACjB,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC;QAC9B,UAAU,EAAE,CAAC,IAAI,oBAAoB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,mBAAmB,EAAE,CAAC,WAAW,CAAC;QAClC,YAAY,EAAE,IAAI,wBAAwB,CAAC,EAAE,SAAS,EAAE,CAAC;KAC5D,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC"}

package/dist/Module.d.ts

@@ -0,0 +1,32 @@
+import { type AgentCard } from "@a2a-js/sdk";
+import type { ApplicationPort } from "@plurnk/plurnk-contracts";
+import { type A2aWorkspaceConfiguration } from "./WorkspaceBinding.ts";
+export interface A2aModuleOptions {
+    readonly workspace: A2aWorkspaceConfiguration;
+    readonly card: AgentCard;
+    readonly host?: string;
+    readonly port?: number;
+    readonly endpointPath?: string;
+    /** Canonical public endpoint URL when it cannot be inferred from the listener. */
+    readonly endpointUrl?: string;
+}
+export interface A2aModuleRegistration {
+    start(port: ApplicationPort): Promise<Module>;
+}
+export default class Module {
+    #private;
+    private constructor();
+    static init(options: A2aModuleOptions): A2aModuleRegistration;
+    listen(): Promise<{
+        host: string;
+        port: number;
+        endpoint: string;
+    }>;
+    address(): {
+        host: string;
+        port: number;
+    };
+    agentCard(): AgentCard;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=Module.d.ts.map