@agenticprimitives/a2a 0.0.0-alpha.4 → 0.0.0-alpha.40

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":"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"}

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

@@ -0,0 +1,41 @@
+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'];
+    /** Visibility of a NON-delegated (conversational) task on top of the delegated-task party rule — normally
+     *  its owner. Spec 408 §2.5: absent ⇒ such a task is NOBODY's unless `visibility: 'single-tenant'` is declared. */
+    canSeeOwnTask?: (task: TaskV1, principal: Principal | null) => Promise<boolean> | boolean;
+    /** Spec 408 §2.5 — every conversational task is the one caller's (a single-principal deployment). */
+    visibility?: 'single-tenant';
+    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;uHACmH;IACnH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC1F,qGAAqG;IACrG,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,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"}

package/dist/standard/from-agent.js

@@ -0,0 +1,133 @@
+import { AP_DELEGATED_TASK_EXTENSION, DELEGATED_TASK_CARD_EXTENSION, GET_TASK_ARTIFACT_METHOD, delegatedInput, delegatedTaskAsV1, isPartyToDelegatedTask, readDelegatedTask, toProfileMessage, } from './delegated.js';
+import { wireToDelegation } from '../session-wire.js';
+import { A2A_ERROR, A2aError, JSONRPC_ERROR } from './errors.js';
+import { createMemoryPushStore, createStandardA2aServer, } from './server.js';
+/** Project a runtime record into the 1.0 shape. */
+export const recordAsV1 = (r) => delegatedTaskAsV1({
+    task: { taskId: r.task.taskId, state: r.task.state, assignee: r.task.assignee, permissionGrantRef: r.task.permissionGrantRef },
+    principal: r.principal, sender: r.sender, skill: r.skill,
+    inbound: (r.inbound ?? []).map((m) => ({ messageId: m.messageId, sender: m.sender, threadId: m.threadId, createdAt: m.createdAt, bodyRef: m.bodyRef, bodyHash: m.bodyHash })),
+    artifacts: (r.artifacts ?? []).map((a) => ({ artifactId: a.artifactId, artifactKind: a.artifactKind, bodyRef: a.bodyRef, bodyHash: a.contentHash })),
+    ...(r.error ? { error: r.error } : {}),
+    ...(r.rev !== undefined ? { rev: r.rev } : {}),
+    ...(r.updatedAt !== undefined ? { updatedAt: r.updatedAt } : {}),
+});
+/** 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 function taskStoreOverAgent(runtime, own) {
+    return {
+        async get(id) {
+            const rec = /^0x[0-9a-fA-F]{64}$/.test(id) ? await runtime.get(id).catch(() => null) : null;
+            return rec ? recordAsV1(rec) : own.get(id);
+        },
+        put: (t) => own.put(t),
+        async all() {
+            const mine = await own.all();
+            if (!runtime.list)
+                return mine;
+            const theirs = (await runtime.list(200).catch(() => [])).map(recordAsV1);
+            return [...theirs, ...mine];
+        },
+    };
+}
+const REFUSES_PLAIN = 'this agent takes delegation-authorized tasks; carry the delegated-task extension on the message';
+/**
+ * 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 function createAgentBackedServer(opts) {
+    const tasks = taskStoreOverAgent(opts.runtimeStore, opts.ownStore);
+    const card = {
+        ...opts.card,
+        capabilities: {
+            ...opts.card.capabilities,
+            extensions: [
+                ...(opts.card.capabilities.extensions ?? []).filter((e) => e.uri !== AP_DELEGATED_TASK_EXTENSION),
+                { ...DELEGATED_TASK_CARD_EXTENSION },
+            ],
+        },
+    };
+    return createStandardA2aServer({
+        card,
+        tasks,
+        push: opts.push ?? createMemoryPushStore(),
+        ...(opts.principal ? { principal: opts.principal } : {}),
+        ...(opts.versions ? { versions: opts.versions } : {}),
+        ...(opts.fetch ? { fetch: opts.fetch } : {}),
+        ...(opts.now ? { now: opts.now } : {}),
+        executor: opts.executor ?? { execute: async (ctx) => ctx.reject([{ text: REFUSES_PLAIN }]) },
+        // A delegated task is the RUNTIME's: it keeps its id, its states and its gates.
+        beforeSend: async ({ message, configuration }, principal) => {
+            const ext = readDelegatedTask(message);
+            if (ext === null)
+                return null; // an ordinary conversation
+            if ('error' in ext)
+                throw new A2aError(JSONRPC_ERROR.InvalidParams, ext.error);
+            // The caller at the door and the party the grant names must be the same agent. The runtime checks
+            // this too (delegate === requester); doing it here as well means an impostor never reaches it.
+            if (principal && ext.requester.toLowerCase() !== principal.agent.toLowerCase()) {
+                throw new A2aError(JSONRPC_ERROR.InvalidParams, `the delegated task names ${ext.requester} as its requester; you are calling as ${principal.agent}`);
+            }
+            const profileMessage = toProfileMessage(message, ext);
+            const params = {
+                // The wire carries `salt` as a decimal string; the runtime hashes a bigint.
+                delegation: wireToDelegation(ext.delegation),
+                requester: ext.requester,
+                message: profileMessage,
+                input: delegatedInput(message),
+                ...(configuration?.taskPushNotificationConfig?.url ? { pushConfig: { url: configuration.taskPushNotificationConfig.url, ...(configuration.taskPushNotificationConfig.token ? { token: configuration.taskPushNotificationConfig.token } : {}) } } : {}),
+            };
+            const r = ext.taskId
+                ? await opts.agent.resubmit({ ...params, taskId: ext.taskId })
+                : await opts.agent.messageSend(params);
+            if (!r.ok)
+                throw new A2aError(r.code === -32001 ? JSONRPC_ERROR.InvalidParams : r.code, r.message);
+            const rec = await opts.runtimeStore.get(r.result.taskId);
+            // The projection is the answer; falling back to a synthetic task would report a state nothing holds.
+            if (!rec)
+                throw new A2aError(A2A_ERROR.InvalidAgentResponse, `the runtime accepted task ${r.result.taskId} and the store does not hold it`);
+            return { task: recordAsV1(rec) };
+        },
+        onCancel: async (task, principal) => {
+            if (!isPartyToDelegatedTask(task, principal?.agent))
+                return null; // not the runtime's — the ordinary path
+            // The door authenticated this caller; the runtime re-runs the party test and nothing else.
+            const r = await opts.agent.tasksCancelAs({ taskId: task.id, caller: principal.agent });
+            if (!r.ok)
+                throw new A2aError(r.code, r.message);
+            const rec = await opts.runtimeStore.get(task.id);
+            return rec ? recordAsV1(rec) : null;
+        },
+        canSeeTask: async (task, principal, op) => {
+            const delegated = task.metadata?.[AP_DELEGATED_TASK_EXTENSION] !== undefined;
+            if (delegated)
+                return isPartyToDelegatedTask(task, principal?.agent);
+            return opts.canSeeOwnTask ? (await opts.canSeeOwnTask(task, principal)) === true : opts.visibility === 'single-tenant';
+        },
+        // THE ARTIFACT BODY READ (the extension's one method). The profile's `tasks/artifact` was the only wire path
+        // to a body — the projection carries a ref and a hash, never the body (A2A-INV-04) — and the fold dropped it
+        // without a 1.0 successor; the skills corpus agent, which reads the documents its dispatched tasks produce,
+        // was the consumer that found out. The door's principal must be a PARTY (sender or assignee, the runtime's
+        // own test); an unauthenticated caller, a non-party, and an artifact of another task all read as not found.
+        methods: {
+            [GET_TASK_ARTIFACT_METHOD]: async (params, principal) => {
+                const id = String(params.id ?? params.taskId ?? '');
+                const artifactId = String(params.artifactId ?? '');
+                if (!/^0x[0-9a-fA-F]{64}$/.test(id) || !artifactId)
+                    throw new A2aError(JSONRPC_ERROR.InvalidParams, 'GetTaskArtifact takes { id, artifactId }');
+                if (!principal?.agent)
+                    throw new A2aError(A2A_ERROR.TaskNotFound, undefined, { id });
+                const r = await opts.agent.tasksArtifactAs({ taskId: id, artifactId: artifactId, caller: principal.agent });
+                if (!r.ok)
+                    throw new A2aError(A2A_ERROR.TaskNotFound, undefined, { id });
+                return {
+                    artifactId: r.result.artifactId,
+                    ...(r.result.artifactKind ? { name: r.result.artifactKind } : {}),
+                    parts: [{ data: r.result.body ?? null }],
+                    metadata: { bodyRef: r.result.bodyRef, residency: 'vault' },
+                };
+            },
+        },
+    });
+}
+//# sourceMappingURL=from-agent.js.map

package/dist/standard/from-agent.js.map

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

package/dist/standard/index.d.ts

@@ -0,0 +1,10 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './server.js';
+export * from './caller.js';
+export * from './delegated.js';
+export * from './from-agent.js';
+export * from './client.js';
+export * from './mount.js';
+export * from './app-delegation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/standard/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/standard/index.js

@@ -0,0 +1,14 @@
+// @agenticprimitives/a2a/standard — the A2A 1.0 standard surface (spec 372 S1), beside the delegation
+// profile at the package root. A door for every A2A 1.0 client and the official TCK; never a grant.
+export * from './types.js';
+export * from './errors.js';
+export * from './server.js';
+export * from './caller.js';
+export * from './delegated.js';
+export * from './from-agent.js';
+export * from './client.js';
+// Spec 372 S2/S4, spec 399 §4 — mounting this surface in front of a harness: card fields, task-id shape, the
+// one task view, the two admission schemes, delegated/engagement dispatch, the reply-kind → state table.
+export * from './mount.js';
+export * from './app-delegation.js';
+//# sourceMappingURL=index.js.map

package/dist/standard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/standard/index.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,oGAAoG;AACpG,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,6GAA6G;AAC7G,yGAAyG;AACzG,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/standard/mount.d.ts

@@ -0,0 +1,94 @@
+import type { Address } from 'viem';
+import type { ExecutionContext, Principal, StandardServerConfig, StandardTaskStore } from './server.js';
+import type { PartV1, TaskV1 } from './types.js';
+/** The delegation runtime mints 32-byte hex task ids; a standard server's own conversational tasks are
+ *  uuids. That is how a read knows which side holds a task — the shape is minted, not guessed. */
+export declare const isRuntimeTaskId: (id: unknown) => boolean;
+/** The text of a message's parts, joined; `data` parts that are strings count as text. */
+export declare const partsText: (parts: PartV1[]) => string;
+/** The first structured `data` part, or null. */
+export declare const partsData: (parts: PartV1[]) => Record<string, unknown> | null;
+/** Spec 390 W2 — the W3C Trace Context a request arrived with, as headers to forward on the next hop so the
+ *  run's record keeps it. Ids only: nothing admits on these. */
+export declare function traceHeadersOf(h: Headers): Record<string, string>;
+export interface StandardCardFieldsOpts {
+    /** Where this surface takes A2A 1.0 JSON-RPC. */
+    messageUrl: string;
+    /** The card extensions this surface admits (default: the delegated-task and engagement extensions). */
+    extensions?: Array<{
+        uri: string;
+        [k: string]: unknown;
+    }>;
+    /** The bearer scheme a person presents (default: a Home session — it names the asking person and grants nothing). */
+    bearer?: {
+        name: string;
+        bearerFormat: string;
+        description: string;
+    };
+}
+/**
+ * The 1.0 fields a live card needs on top of what a runtime already builds: an interface with a protocol
+ * version, input/output modes, skills with names, the extensions this surface admits and the bearer scheme.
+ * Additive — every field the card carried stays; a released card (spec 347 §8) is served byte-for-byte and
+ * never passes through here.
+ */
+export declare function withStandardCardFields(live: Record<string, unknown>, opts: StandardCardFieldsOpts): Record<string, unknown>;
+/** A JSON-RPC call forwarded to the agent's own delegation runtime; the response comes back verbatim. */
+export type DelegatedRpc = (agent: Address, rpc: unknown, principal: Principal | null) => Promise<{
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+}>;
+/**
+ * ONE TASK VIEW over two stores (spec 372 S4): a 32-byte hex id can only be the runtime's, so a read asks
+ * the object that owns it; anything else is a conversation this server made. A caller cannot tell, and
+ * must not have to. Writes go to the local store only — a delegated task is the runtime's to write.
+ */
+export declare function runtimeBackedTaskStore(input: {
+    local: StandardTaskStore;
+    agent: Address;
+    rpc: DelegatedRpc;
+}): StandardTaskStore;
+/**
+ * What runs in front of `SendMessage` and `CancelTask` when the agent has a delegation runtime and/or answers
+ * engagement probes. A message carrying the DELEGATED-TASK extension is forwarded to the runtime, which keeps
+ * its own task id (two ids for one task would make `GetTask` a coin toss). An engagement PROBE is answered
+ * with a MESSAGE and no task (spec 336 §5) — the provider's own document — and only for a known caller who is
+ * the requester it names, addressed to this agent. A malformed engagement document is refused, never ignored.
+ */
+export declare function delegatedDispatch(input: {
+    agent: Address;
+    rpc?: DelegatedRpc;
+    answerProbe?: (input: {
+        agent: Address;
+        probe: Record<string, unknown>;
+        caller: Principal | null;
+    }) => Promise<Record<string, unknown>>;
+}): Pick<StandardServerConfig, 'beforeSend' | 'onCancel'>;
+/** A delegated task is visible to its parties; a conversation, to whoever had it (its `asker`). A task
+ *  nobody claimed is NOBODY'S (R917-P-6, spec 408 §2.6): the old "single-tenant shape" made every
+ *  asker-less task world-readable, and a runtime with two tenants is not single-tenant. Compared
+ *  lowercased on both sides — the caller assertion lowercases the agent (`caller.ts`), a task's
+ *  metadata may not. */
+export declare function canSeeDelegatedOrOwnTask(task: TaskV1, principal: Principal | null): boolean;
+/**
+ * TWO SCHEMES, ONE MECHANISM EACH (ADR-0013). `Bearer` is a PERSON's session; `A2A-Session` is an AGENT's
+ * session wire, verified on chain per request (spec 372 S3c). The scheme token selects which runs — neither
+ * is ever tried because the other failed, and each fails closed on its own terms. `first` is the product's
+ * own door (an in-process marker, say): it answers a principal, `null` to refuse, or `undefined` to say the
+ * request is not its to judge.
+ */
+export declare function principalBySchemes(input: {
+    bearer: (token: string) => Promise<Principal | null>;
+    wire?: ((request: Request) => Promise<Principal | null>) | null;
+    first?: (request: Request) => Principal | null | undefined;
+}): (request: Request) => Promise<Principal | null>;
+/** The task state a harness reply's KIND maps to (spec 372 S4): a question parks as INPUT_REQUIRED, an act
+ *  that needs a mandate as AUTH_REQUIRED, an answer or a done act completes, a refusal rejects, an error fails. */
+export type ReplySettlement = 'completed' | 'input-required' | 'auth-required' | 'rejected' | 'failed';
+export declare function settlementForReplyKind(kind: string | undefined): ReplySettlement;
+/** Move the task to a settlement with the given parts. */
+export declare function settleTask(ctx: ExecutionContext, settlement: ReplySettlement, parts: PartV1[]): Promise<void>;
+//# sourceMappingURL=mount.d.ts.map