@agenticprimitives/a2a 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/standard/client.js

@@ -0,0 +1,86 @@
+import { TERMINAL_STATES } from './types.js';
+async function sha256Hex(text) {
+    const buf = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(text));
+    return `0x${[...new Uint8Array(buf)].map((b) => b.toString(16).padStart(2, '0')).join('')}`;
+}
+/** The A2A 1.0 JSON-RPC endpoint a card publishes (top-level `protocolVersion` covers a released card's interfaces). */
+export function jsonRpcEndpointOf(card) {
+    const top = /^1\./.test(String(card.protocolVersion ?? ''));
+    const hit = (card.supportedInterfaces ?? []).find((i) => i.protocolBinding === 'JSONRPC' && (/^1\./.test(String(i.protocolVersion ?? '')) || (i.protocolVersion === undefined && top)) && /^https:\/\//.test(String(i.url ?? '')));
+    return hit?.url ?? null;
+}
+/** Fetch a card, digest its bytes, read its endpoint. A card without a 1.x JSON-RPC interface is refused. */
+export async function resolveAgentCard(cardUrl, fetchImpl = fetch, expectDigest) {
+    if (!/^https:\/\//.test(cardUrl))
+        throw new Error('an agent card is fetched over https only');
+    const res = await fetchImpl(cardUrl, { headers: { accept: 'application/json' } });
+    if (!res.ok)
+        throw new Error(`the card at ${cardUrl} answered ${res.status}`);
+    const text = await res.text();
+    let card;
+    try {
+        card = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`the card at ${cardUrl} is not JSON`);
+    }
+    const cardDigest = await sha256Hex(text);
+    if (expectDigest && expectDigest.toLowerCase() !== cardDigest.toLowerCase())
+        throw new Error(`the card at ${cardUrl} is not the one pinned (${expectDigest.slice(0, 14)}… expected, ${cardDigest.slice(0, 14)}… served)`);
+    const endpoint = jsonRpcEndpointOf(card);
+    if (!endpoint)
+        throw new Error(`${card.name ?? cardUrl} publishes no A2A 1.x JSON-RPC interface`);
+    return { card, cardDigest, endpoint, cardUrl };
+}
+const hex32 = () => `0x${[...crypto.getRandomValues(new Uint8Array(32))].map((b) => b.toString(16).padStart(2, '0')).join('')}`;
+export function createStandardA2aClient(o) {
+    const fetchImpl = o.fetch ?? fetch;
+    let seq = 0;
+    const rpc = async (method, params) => {
+        const res = await fetchImpl(o.endpoint, { method: 'POST', headers: { 'content-type': 'application/json', accept: 'application/json', 'a2a-version': '1.0', ...(o.headers ?? {}) }, body: JSON.stringify({ jsonrpc: '2.0', id: ++seq, method, params }) });
+        const body = (await res.json().catch(() => null));
+        if (!body)
+            throw new Error(`${o.endpoint} answered ${res.status} with no JSON-RPC body`);
+        if ('error' in body)
+            throw new Error(`${o.endpoint} ${method}: ${body.error.code} ${body.error.message}`);
+        return body.result;
+    };
+    const textOf = (t, m) => {
+        const parts = [];
+        const take = (ps) => { for (const p of ps ?? [])
+            if (typeof p.text === 'string' && p.text.trim())
+                parts.push(p.text.trim()); };
+        take(m?.parts);
+        take(t?.status?.message?.parts);
+        for (const a of t?.artifacts ?? [])
+            take(a.parts);
+        return parts.join('\n');
+    };
+    const client = {
+        async sendMessage(parts, opts) {
+            const message = { messageId: hex32(), role: 'ROLE_USER', parts, ...(opts?.contextId ? { contextId: opts.contextId } : {}), ...(opts?.taskId ? { taskId: opts.taskId } : {}), ...(opts?.extensions ? { extensions: opts.extensions } : {}), ...(opts?.metadata ? { metadata: opts.metadata } : {}) };
+            return rpc('SendMessage', { message });
+        },
+        async getTask(id) { return rpc('GetTask', { id }); },
+        async awaitTask(id, opts) {
+            const deadline = Date.now() + (opts?.timeoutMs ?? 20_000);
+            let last = await client.getTask(id);
+            while (!TERMINAL_STATES.has(last.status.state) && last.status.state !== 'TASK_STATE_INPUT_REQUIRED' && last.status.state !== 'TASK_STATE_AUTH_REQUIRED' && Date.now() < deadline) {
+                await new Promise((r) => setTimeout(r, opts?.everyMs ?? 500));
+                last = await client.getTask(id);
+            }
+            return last;
+        },
+        async ask(text, opts) {
+            const sent = await client.sendMessage([{ text }], opts?.metadata ? { metadata: opts.metadata } : undefined);
+            if (sent.message)
+                return { text: textOf(undefined, sent.message), message: sent.message };
+            if (!sent.task)
+                throw new Error('the agent answered with neither a task nor a message');
+            const task = TERMINAL_STATES.has(sent.task.status.state) ? sent.task : await client.awaitTask(sent.task.id, { timeoutMs: opts?.timeoutMs });
+            return { text: textOf(task), task };
+        },
+    };
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/standard/client.js.map

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

package/dist/standard/delegated.d.ts

@@ -0,0 +1,121 @@
+import type { Hex } from 'viem';
+import type { TaskState } from '@agenticprimitives/fulfillment';
+import type { DelegationWireV1 } from '../session-wire.js';
+import type { MessageV1, PartV1, TaskV1, TaskStateV1 } from './types.js';
+export declare const AP_DELEGATED_TASK_EXTENSION = "https://agenticprimitives.org/a2a/delegated-task/v1";
+/** What a `SendMessage` carries to create a delegation-authorized task. Rides in
+ *  `message.metadata[AP_DELEGATED_TASK_EXTENSION]`, with the URI also listed in `message.extensions`. */
+export interface DelegatedTaskV1 {
+    extension: typeof AP_DELEGATED_TASK_EXTENSION;
+    version: 1;
+    /** The grant that authorizes this task. Its delegate is the party the runtime checks against `requester`. */
+    delegation: DelegationWireV1;
+    /** The party the delegation was issued to — the principal's delegate, on whose behalf the task runs. */
+    requester: string;
+    /** The skill the receiving agent should run. Unknown ⇒ the task is rejected, as before. */
+    skill: string;
+    /** The SA that authored this message (signs the envelope). */
+    sender: string;
+    /** keccak over the input body — signed, and what binds `message.parts` to the signature. */
+    bodyHash: Hex;
+    /** Where the body will live in the assignee's vault. A placeholder the runtime overwrites with where it
+     *  actually landed; not signed, because `bodyHash` is what binds the content. */
+    bodyRef: {
+        owner: string;
+        recordType: string;
+    };
+    /** The sender's signature over `hashA2aMessage(envelope)` — re-derived and re-checked by the runtime. */
+    signature: Hex;
+    /** Seconds since the epoch, as the sender wrote it into the signed envelope. */
+    createdAt: number;
+    /** An existing task to resubmit against (the auth-required loop): a fresh grant for a parked task. */
+    taskId?: Hex;
+}
+/** The exact envelope the runtime verifies — rebuilt from the 1.0 message plus the extension, so
+ *  `hashA2aMessage` over it is byte-for-byte what the sender signed. */
+export interface ProfileMessageV1 {
+    messageId: string;
+    threadId?: string;
+    sender: string;
+    skill: string;
+    bodyRef: {
+        owner: string;
+        recordType: string;
+    };
+    bodyHash: Hex;
+    signature: Hex;
+    createdAt: number;
+}
+/** Rebuild the signed envelope from what arrived on the 1.0 wire. */
+export declare function toProfileMessage(message: MessageV1, ext: DelegatedTaskV1): ProfileMessageV1;
+/** The declaration a card makes so a peer learns this agent takes delegated tasks before calling. */
+export declare const DELEGATED_TASK_CARD_EXTENSION: {
+    readonly uri: "https://agenticprimitives.org/a2a/delegated-task/v1";
+    readonly required: false;
+    readonly description: "A task authorized by an ERC-7710 delegation carried on the message; the caller is authenticated by the Authorization header and must be the delegation's delegate. Adds the method GetTaskArtifact { id, artifactId } — a party reads an artifact BODY, which the task projection carries only as a ref and a hash (A2A-INV-04).";
+};
+/** The extension's one method beyond the core set: the artifact-body read a party is entitled to. */
+export declare const GET_TASK_ARTIFACT_METHOD: "GetTaskArtifact";
+/**
+ * Read the extension off a message. `null` when the message does not declare it — that is an ordinary
+ * conversational message, not an error. A message that DECLARES it and carries a malformed body is an
+ * error, and says which field: silently treating it as conversational would run the wrong executor under
+ * an authority the sender believed they had presented.
+ */
+export declare function readDelegatedTask(message: MessageV1 | null | undefined): DelegatedTaskV1 | {
+    error: string;
+} | null;
+/** Attach the extension to a message a client is about to send. */
+export declare function withDelegatedTask(message: MessageV1, req: Omit<DelegatedTaskV1, 'extension' | 'version'>): MessageV1;
+/** The input body a delegated task carries: one data part, so the raw body hash the caller signed binds it. */
+export declare const delegatedInputPart: (input: unknown) => PartV1;
+/** Read the input back off a delegated message. */
+export declare function delegatedInput(message: MessageV1): unknown;
+/** The profile's task states are the 1.0 states under other names — one for one, no remainder. */
+export declare const TASK_STATE_V1: Readonly<Record<TaskState, TaskStateV1>>;
+/** The runtime's name for a 1.0 state. `TASK_STATE_UNSPECIFIED` has no runtime name and is a `failed`
+ *  reading — a task in no state is not a task anyone should act on. */
+export declare function taskStateFromV1(state: TaskStateV1 | string): TaskState;
+/** What the projection needs from the runtime's record — structural, so this file imports no runtime. */
+export interface DelegatedTaskSourceV1 {
+    task: {
+        taskId: string;
+        state: TaskState;
+        assignee: string;
+        permissionGrantRef?: string;
+    };
+    principal: string;
+    sender: string;
+    skill: string;
+    inbound?: Array<{
+        messageId: string;
+        sender: string;
+        threadId?: string;
+        createdAt?: number;
+        bodyRef?: unknown;
+        bodyHash?: string;
+    }>;
+    artifacts?: Array<{
+        artifactId: string;
+        artifactKind?: string;
+        bodyRef?: unknown;
+        bodyHash?: string;
+    }>;
+    error?: string;
+    rev?: number;
+    updatedAt?: number;
+}
+/**
+ * Project a delegation-authorized task into the A2A 1.0 shape a client reads.
+ *
+ * BODIES DO NOT COME ALONG (A2A-INV-04). A message body and an artifact body live in the assignee's vault;
+ * what travels is the REF and the hash, in `metadata`, exactly as the profile's `tasks/get` returned refs
+ * only. A party reads a body with the artifact op it was already entitled to use — the projection widens
+ * nothing, and inlining here would have quietly turned a ref into a disclosure.
+ */
+export declare function delegatedTaskAsV1(src: DelegatedTaskSourceV1): TaskV1;
+/** The parties to a delegated task: its sender, the principal they act for, and the assignee. A `GetTask`
+ *  or `CancelTask` from anyone else is answered as though the task did not exist — telling a stranger that
+ *  it does is itself a disclosure (the profile's own rule, kept). */
+export declare function isPartyToDelegatedTask(task: TaskV1, agent: string | null | undefined): boolean;
+//# sourceMappingURL=delegated.d.ts.map

package/dist/standard/delegated.d.ts.map

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

package/dist/standard/delegated.js

@@ -0,0 +1,170 @@
+export const AP_DELEGATED_TASK_EXTENSION = 'https://agenticprimitives.org/a2a/delegated-task/v1';
+/** Rebuild the signed envelope from what arrived on the 1.0 wire. */
+export function toProfileMessage(message, ext) {
+    return {
+        messageId: message.messageId,
+        ...(message.contextId ? { threadId: message.contextId } : {}),
+        sender: ext.sender,
+        skill: ext.skill,
+        bodyRef: ext.bodyRef,
+        bodyHash: ext.bodyHash,
+        signature: ext.signature,
+        createdAt: ext.createdAt,
+    };
+}
+/** The declaration a card makes so a peer learns this agent takes delegated tasks before calling. */
+export const DELEGATED_TASK_CARD_EXTENSION = {
+    uri: AP_DELEGATED_TASK_EXTENSION,
+    required: false,
+    description: 'A task authorized by an ERC-7710 delegation carried on the message; the caller is authenticated by the Authorization header and must be the delegation\'s delegate. Adds the method GetTaskArtifact { id, artifactId } — a party reads an artifact BODY, which the task projection carries only as a ref and a hash (A2A-INV-04).',
+};
+/** The extension's one method beyond the core set: the artifact-body read a party is entitled to. */
+export const GET_TASK_ARTIFACT_METHOD = 'GetTaskArtifact';
+const isWire = (d) => {
+    const w = d;
+    return !!w && typeof w === 'object'
+        && typeof w.delegator === 'string' && /^0x[0-9a-fA-F]{40}$/.test(w.delegator)
+        && typeof w.delegate === 'string' && /^0x[0-9a-fA-F]{40}$/.test(w.delegate)
+        && typeof w.authority === 'string' && Array.isArray(w.caveats)
+        && (typeof w.salt === 'string' || typeof w.salt === 'number')
+        && typeof w.signature === 'string';
+};
+/**
+ * Read the extension off a message. `null` when the message does not declare it — that is an ordinary
+ * conversational message, not an error. A message that DECLARES it and carries a malformed body is an
+ * error, and says which field: silently treating it as conversational would run the wrong executor under
+ * an authority the sender believed they had presented.
+ */
+export function readDelegatedTask(message) {
+    // No message at all is not this extension's business: the server's own validation says what is missing.
+    if (!message || typeof message !== 'object')
+        return null;
+    const declared = (message.extensions ?? []).includes(AP_DELEGATED_TASK_EXTENSION);
+    const raw = message.metadata?.[AP_DELEGATED_TASK_EXTENSION];
+    if (!declared && raw === undefined)
+        return null;
+    if (raw === undefined)
+        return { error: `message declares ${AP_DELEGATED_TASK_EXTENSION} and carries no metadata under it` };
+    const d = raw;
+    if (!isWire(d.delegation))
+        return { error: 'delegated-task: `delegation` is not a delegation wire' };
+    if (typeof d.skill !== 'string' || !d.skill.trim())
+        return { error: 'delegated-task: `skill` is required' };
+    const addr = (v) => typeof v === 'string' && /^0x[0-9a-fA-F]{40}$/.test(v);
+    if (!addr(d.requester))
+        return { error: 'delegated-task: `requester` must be an address' };
+    if (!addr(d.sender))
+        return { error: 'delegated-task: `sender` must be an address' };
+    if (typeof d.bodyHash !== 'string' || !/^0x[0-9a-fA-F]{64}$/.test(d.bodyHash))
+        return { error: 'delegated-task: `bodyHash` must be a 32-byte hash' };
+    if (!d.bodyRef || typeof d.bodyRef !== 'object' || !addr(d.bodyRef.owner))
+        return { error: 'delegated-task: `bodyRef.owner` must be an address' };
+    if (typeof d.signature !== 'string' || !d.signature.startsWith('0x'))
+        return { error: 'delegated-task: `signature` is required — the runtime re-derives the digest and checks it' };
+    if (typeof d.createdAt !== 'number' || !Number.isFinite(d.createdAt))
+        return { error: 'delegated-task: `createdAt` must be a number of seconds' };
+    if (d.taskId !== undefined && !/^0x[0-9a-fA-F]{64}$/.test(String(d.taskId)))
+        return { error: 'delegated-task: `taskId` must be a 32-byte hex id' };
+    // 1.0 lets a messageId be any string; the signed envelope's is a 32-byte hex, because that is what
+    // `hashA2aMessage` encodes. Caught here so the sender is told, rather than the digest failing to build.
+    if (!/^0x[0-9a-fA-F]{64}$/.test(message.messageId ?? ''))
+        return { error: 'delegated-task: `message.messageId` must be a 32-byte hex id — it is part of the signed envelope' };
+    return {
+        extension: AP_DELEGATED_TASK_EXTENSION, version: 1,
+        delegation: d.delegation, requester: d.requester, skill: d.skill.trim(),
+        sender: d.sender, bodyHash: d.bodyHash,
+        bodyRef: d.bodyRef, signature: d.signature,
+        createdAt: d.createdAt, ...(d.taskId ? { taskId: d.taskId } : {}),
+    };
+}
+/** Attach the extension to a message a client is about to send. */
+export function withDelegatedTask(message, req) {
+    return {
+        ...message,
+        extensions: [...new Set([...(message.extensions ?? []), AP_DELEGATED_TASK_EXTENSION])],
+        metadata: { ...(message.metadata ?? {}), [AP_DELEGATED_TASK_EXTENSION]: { extension: AP_DELEGATED_TASK_EXTENSION, version: 1, ...req } },
+    };
+}
+/** The input body a delegated task carries: one data part, so the raw body hash the caller signed binds it. */
+export const delegatedInputPart = (input) => ({ data: input ?? null });
+/** Read the input back off a delegated message. */
+export function delegatedInput(message) {
+    const part = (message.parts ?? []).find((p) => p.data !== undefined);
+    return part ? part.data : null;
+}
+/** The profile's task states are the 1.0 states under other names — one for one, no remainder. */
+export const TASK_STATE_V1 = {
+    submitted: 'TASK_STATE_SUBMITTED',
+    working: 'TASK_STATE_WORKING',
+    completed: 'TASK_STATE_COMPLETED',
+    failed: 'TASK_STATE_FAILED',
+    canceled: 'TASK_STATE_CANCELED',
+    'input-required': 'TASK_STATE_INPUT_REQUIRED',
+    rejected: 'TASK_STATE_REJECTED',
+    'auth-required': 'TASK_STATE_AUTH_REQUIRED',
+};
+const V1_TO_STATE = Object.fromEntries(Object.entries(TASK_STATE_V1).map(([k, v]) => [v, k]));
+/** The runtime's name for a 1.0 state. `TASK_STATE_UNSPECIFIED` has no runtime name and is a `failed`
+ *  reading — a task in no state is not a task anyone should act on. */
+export function taskStateFromV1(state) {
+    return V1_TO_STATE[state] ?? 'failed';
+}
+/**
+ * Project a delegation-authorized task into the A2A 1.0 shape a client reads.
+ *
+ * BODIES DO NOT COME ALONG (A2A-INV-04). A message body and an artifact body live in the assignee's vault;
+ * what travels is the REF and the hash, in `metadata`, exactly as the profile's `tasks/get` returned refs
+ * only. A party reads a body with the artifact op it was already entitled to use — the projection widens
+ * nothing, and inlining here would have quietly turned a ref into a disclosure.
+ */
+export function delegatedTaskAsV1(src) {
+    const at = new Date(src.updatedAt ?? Date.now()).toISOString();
+    const history = (src.inbound ?? []).map((m) => ({
+        messageId: m.messageId,
+        role: 'ROLE_USER',
+        parts: [{ data: { bodyRef: m.bodyRef ?? null, bodyHash: m.bodyHash ?? null } }],
+        contextId: m.threadId ?? src.task.taskId,
+        taskId: src.task.taskId,
+        metadata: { sender: m.sender, ...(m.createdAt ? { createdAt: m.createdAt } : {}) },
+    }));
+    const artifacts = (src.artifacts ?? []).map((a) => ({
+        artifactId: a.artifactId,
+        ...(a.artifactKind ? { name: a.artifactKind } : {}),
+        parts: [{ data: { bodyRef: a.bodyRef ?? null, bodyHash: a.bodyHash ?? null } }],
+        metadata: { residency: 'vault', note: 'the body lives in the assignee\'s vault; read it with the artifact op' },
+    }));
+    return {
+        id: src.task.taskId,
+        contextId: (src.inbound ?? [])[0]?.threadId ?? src.task.taskId,
+        status: {
+            state: TASK_STATE_V1[src.task.state],
+            timestamp: at,
+            ...(src.error ? { message: { messageId: `${src.task.taskId}:error`, role: 'ROLE_AGENT', parts: [{ text: src.error }], contextId: src.task.taskId, taskId: src.task.taskId } } : {}),
+        },
+        ...(artifacts.length ? { artifacts } : {}),
+        ...(history.length ? { history } : {}),
+        metadata: {
+            [AP_DELEGATED_TASK_EXTENSION]: {
+                skill: src.skill,
+                principal: src.principal,
+                sender: src.sender,
+                assignee: src.task.assignee,
+                ...(src.task.permissionGrantRef ? { permissionGrantRef: src.task.permissionGrantRef } : {}),
+                ...(src.rev !== undefined ? { rev: src.rev } : {}),
+            },
+        },
+    };
+}
+/** The parties to a delegated task: its sender, the principal they act for, and the assignee. A `GetTask`
+ *  or `CancelTask` from anyone else is answered as though the task did not exist — telling a stranger that
+ *  it does is itself a disclosure (the profile's own rule, kept). */
+export function isPartyToDelegatedTask(task, agent) {
+    if (!agent)
+        return false;
+    const m = task.metadata?.[AP_DELEGATED_TASK_EXTENSION];
+    if (!m)
+        return false;
+    const who = agent.toLowerCase();
+    return [m.principal, m.sender, m.assignee].some((a) => typeof a === 'string' && a.toLowerCase() === who);
+}
+//# sourceMappingURL=delegated.js.map

package/dist/standard/delegated.js.map

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

package/dist/standard/errors.d.ts

@@ -0,0 +1,31 @@
+export declare const A2A_ERROR: {
+    readonly TaskNotFound: -32001;
+    readonly TaskNotCancelable: -32002;
+    readonly PushNotificationNotSupported: -32003;
+    readonly UnsupportedOperation: -32004;
+    readonly ContentTypeNotSupported: -32005;
+    readonly InvalidAgentResponse: -32006;
+    readonly ExtendedAgentCardNotConfigured: -32007;
+    readonly ExtensionSupportRequired: -32008;
+    readonly VersionNotSupported: -32009;
+};
+export declare const JSONRPC_ERROR: {
+    readonly ParseError: -32700;
+    readonly InvalidRequest: -32600;
+    readonly MethodNotFound: -32601;
+    readonly InvalidParams: -32602;
+    readonly Internal: -32603;
+};
+export declare class A2aError extends Error {
+    readonly code: number;
+    readonly metadata?: Record<string, string> | undefined;
+    constructor(code: number, message?: string, metadata?: Record<string, string> | undefined);
+}
+export interface JsonRpcErrorObject {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/** The JSON-RPC error object for an error: A2A-specific codes carry ErrorInfo in a `data` array. */
+export declare function toJsonRpcError(e: unknown): JsonRpcErrorObject;
+//# sourceMappingURL=errors.d.ts.map

package/dist/standard/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/standard/errors.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,SAAS;;;;;;;;;;CAUZ,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AA+BX,qBAAa,QAAS,SAAQ,KAAK;aACL,IAAI,EAAE,MAAM;aAAoC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;gBAAjF,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAkB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAA;CAI9G;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAY7D"}

package/dist/standard/errors.js

@@ -0,0 +1,75 @@
+// A2A 1.0 ERRORS ON THE JSON-RPC BINDING — spec 372 S1 (A2A spec §5.4 + §9.5).
+//
+// Every A2A-specific error carries a `google.rpc.ErrorInfo` in `error.data[]`: the reason in UPPER_SNAKE
+// without the "Error" suffix, the domain `a2a-protocol.org`. A client that only reads the code still gets
+// the standard number; one that reads the data learns which task, which version, which content type.
+export const A2A_ERROR = {
+    TaskNotFound: -32001,
+    TaskNotCancelable: -32002,
+    PushNotificationNotSupported: -32003,
+    UnsupportedOperation: -32004,
+    ContentTypeNotSupported: -32005,
+    InvalidAgentResponse: -32006,
+    ExtendedAgentCardNotConfigured: -32007,
+    ExtensionSupportRequired: -32008,
+    VersionNotSupported: -32009,
+};
+export const JSONRPC_ERROR = {
+    ParseError: -32700,
+    InvalidRequest: -32600,
+    MethodNotFound: -32601,
+    InvalidParams: -32602,
+    Internal: -32603,
+};
+const REASON = {
+    [-32001]: 'TASK_NOT_FOUND',
+    [-32002]: 'TASK_NOT_CANCELABLE',
+    [-32003]: 'PUSH_NOTIFICATION_NOT_SUPPORTED',
+    [-32004]: 'UNSUPPORTED_OPERATION',
+    [-32005]: 'CONTENT_TYPE_NOT_SUPPORTED',
+    [-32006]: 'INVALID_AGENT_RESPONSE',
+    [-32007]: 'EXTENDED_AGENT_CARD_NOT_CONFIGURED',
+    [-32008]: 'EXTENSION_SUPPORT_REQUIRED',
+    [-32009]: 'VERSION_NOT_SUPPORTED',
+};
+const MESSAGE = {
+    [-32001]: 'Task not found',
+    [-32002]: 'Task cannot be canceled',
+    [-32003]: 'Push notifications are not supported',
+    [-32004]: 'This operation is not supported',
+    [-32005]: 'Incompatible content types',
+    [-32006]: 'Invalid agent response',
+    [-32007]: 'Extended agent card is not configured',
+    [-32008]: 'A required extension is not supported',
+    [-32009]: 'Unsupported A2A protocol version',
+    [-32700]: 'Invalid JSON payload',
+    [-32600]: 'Request payload validation error',
+    [-32601]: 'Method not found',
+    [-32602]: 'Invalid parameters',
+    [-32603]: 'Internal error',
+};
+export class A2aError extends Error {
+    code;
+    metadata;
+    constructor(code, message, metadata) {
+        super(message ?? MESSAGE[code] ?? 'A2A error');
+        this.code = code;
+        this.metadata = metadata;
+        this.name = 'A2aError';
+    }
+}
+/** The JSON-RPC error object for an error: A2A-specific codes carry ErrorInfo in a `data` array. */
+export function toJsonRpcError(e) {
+    if (e instanceof A2aError) {
+        const reason = REASON[e.code];
+        if (reason) {
+            return {
+                code: e.code, message: e.message,
+                data: [{ '@type': 'type.googleapis.com/google.rpc.ErrorInfo', reason, domain: 'a2a-protocol.org', metadata: { ...(e.metadata ?? {}), timestamp: new Date().toISOString() } }],
+            };
+        }
+        return { code: e.code, message: e.message, ...(e.metadata ? { data: e.metadata } : {}) };
+    }
+    return { code: JSONRPC_ERROR.Internal, message: MESSAGE[-32603], data: { detail: e instanceof Error ? e.message : String(e) } };
+}
+//# sourceMappingURL=errors.js.map

package/dist/standard/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/standard/errors.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,yGAAyG;AACzG,0GAA0G;AAC1G,qGAAqG;AAErG,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,EAAE,CAAC,KAAK;IACpB,iBAAiB,EAAE,CAAC,KAAK;IACzB,4BAA4B,EAAE,CAAC,KAAK;IACpC,oBAAoB,EAAE,CAAC,KAAK;IAC5B,uBAAuB,EAAE,CAAC,KAAK;IAC/B,oBAAoB,EAAE,CAAC,KAAK;IAC5B,8BAA8B,EAAE,CAAC,KAAK;IACtC,wBAAwB,EAAE,CAAC,KAAK;IAChC,mBAAmB,EAAE,CAAC,KAAK;CACnB,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,UAAU,EAAE,CAAC,KAAK;IAClB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,aAAa,EAAE,CAAC,KAAK;IACrB,QAAQ,EAAE,CAAC,KAAK;CACR,CAAC;AAEX,MAAM,MAAM,GAA2B;IACrC,CAAC,CAAC,KAAK,CAAC,EAAE,gBAAgB;IAC1B,CAAC,CAAC,KAAK,CAAC,EAAE,qBAAqB;IAC/B,CAAC,CAAC,KAAK,CAAC,EAAE,iCAAiC;IAC3C,CAAC,CAAC,KAAK,CAAC,EAAE,uBAAuB;IACjC,CAAC,CAAC,KAAK,CAAC,EAAE,4BAA4B;IACtC,CAAC,CAAC,KAAK,CAAC,EAAE,wBAAwB;IAClC,CAAC,CAAC,KAAK,CAAC,EAAE,oCAAoC;IAC9C,CAAC,CAAC,KAAK,CAAC,EAAE,4BAA4B;IACtC,CAAC,CAAC,KAAK,CAAC,EAAE,uBAAuB;CAClC,CAAC;AAEF,MAAM,OAAO,GAA2B;IACtC,CAAC,CAAC,KAAK,CAAC,EAAE,gBAAgB;IAC1B,CAAC,CAAC,KAAK,CAAC,EAAE,yBAAyB;IACnC,CAAC,CAAC,KAAK,CAAC,EAAE,sCAAsC;IAChD,CAAC,CAAC,KAAK,CAAC,EAAE,iCAAiC;IAC3C,CAAC,CAAC,KAAK,CAAC,EAAE,4BAA4B;IACtC,CAAC,CAAC,KAAK,CAAC,EAAE,wBAAwB;IAClC,CAAC,CAAC,KAAK,CAAC,EAAE,uCAAuC;IACjD,CAAC,CAAC,KAAK,CAAC,EAAE,uCAAuC;IACjD,CAAC,CAAC,KAAK,CAAC,EAAE,kCAAkC;IAC5C,CAAC,CAAC,KAAK,CAAC,EAAE,sBAAsB;IAChC,CAAC,CAAC,KAAK,CAAC,EAAE,kCAAkC;IAC5C,CAAC,CAAC,KAAK,CAAC,EAAE,kBAAkB;IAC5B,CAAC,CAAC,KAAK,CAAC,EAAE,oBAAoB;IAC9B,CAAC,CAAC,KAAK,CAAC,EAAE,gBAAgB;CAC3B,CAAC;AAEF,MAAM,OAAO,QAAS,SAAQ,KAAK;IACL;IAAgD;IAA5E,YAA4B,IAAY,EAAE,OAAgB,EAAkB,QAAiC;QAC3G,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,CAAC;QADrB,SAAI,GAAJ,IAAI,CAAQ;QAAoC,aAAQ,GAAR,QAAQ,CAAyB;QAE3G,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAQD,oGAAoG;AACpG,MAAM,UAAU,cAAc,CAAC,CAAU;IACvC,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO;gBAChC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC;aAC9K,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3F,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACnI,CAAC"}

package/dist/standard/from-agent.d.ts

@@ -0,0 +1,38 @@
+import type { A2aAgent } from '../agent.js';
+import type { TaskStore } from '../task-store.js';
+import type { TaskRecord } from '../types.js';
+import { type PushConfigStore, type Principal, type StandardExecutor, type StandardServer, type StandardServerConfig, type StandardTaskStore } from './server.js';
+import type { AgentCardV1, MessageV1, TaskV1 } from './types.js';
+/** Project a runtime record into the 1.0 shape. */
+export declare const recordAsV1: (r: TaskRecord) => TaskV1;
+/** A read-only `StandardTaskStore` over the runtime's own store, plus a writable side for tasks this
+ *  server creates itself (a plain conversation). One `GetTask` answers from whichever holds the id. */
+export declare function taskStoreOverAgent(runtime: TaskStore, own: StandardTaskStore): StandardTaskStore;
+export interface AgentBackedServerOptions {
+    /** The delegation-authorized runtime this wire serves. */
+    agent: A2aAgent;
+    /** The runtime's task store — read for `GetTask` / `ListTasks`, never written here. */
+    runtimeStore: TaskStore;
+    card: AgentCardV1;
+    /** Where this server's own (non-delegated) tasks live. */
+    ownStore: StandardTaskStore;
+    push?: PushConfigStore;
+    /** What answers a message that carries no delegated-task extension — an ordinary conversation. Omit and
+     *  such a message is refused, saying what this agent takes. */
+    executor?: StandardExecutor;
+    principal?: StandardServerConfig['principal'];
+    /** Extra visibility on top of the delegated-task party rule (e.g. the owner of a conversational task). */
+    canSeeOwnTask?: (task: TaskV1, principal: Principal | null) => Promise<boolean> | boolean;
+    versions?: string[];
+    fetch?: typeof fetch;
+    now?: () => number;
+}
+/**
+ * Build the ONE server this agent serves: A2A 1.0 methods, the delegation-authorized runtime behind
+ * `SendMessage`-with-extension, and an ordinary conversation behind `SendMessage` without one.
+ */
+export declare function createAgentBackedServer(opts: AgentBackedServerOptions): StandardServer;
+/** The message a client sends to reach the runtime: what `A2aWireAdapter.submitTask` builds. Exported so a
+ *  consumer can construct one without the adapter. */
+export type { MessageV1 };
+//# sourceMappingURL=from-agent.d.ts.map

package/dist/standard/from-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-agent.d.ts","sourceRoot":"","sources":["../../src/standard/from-agent.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO9C,OAAO,EAEL,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EACpI,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEjE,mDAAmD;AACnD,eAAO,MAAM,UAAU,MAAO,UAAU,KAAG,MAQzC,CAAC;AAEH;uGACuG;AACvG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,CAchG;AAED,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,KAAK,EAAE,QAAQ,CAAC;IAChB,uFAAuF;IACvF,YAAY,EAAE,SAAS,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB;mEAC+D;IAC/D,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,SAAS,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC9C,0GAA0G;IAC1G,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC1F,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG,cAAc,CAyFtF;AAED;sDACsD;AACtD,YAAY,EAAE,SAAS,EAAE,CAAC"}