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

package/dist/conform/index.js

@@ -0,0 +1,232 @@
+// @agenticprimitives/a2a/conform — `ap conform a2a <url>` (spec 399 §2.3 / §3.3): a LIVE conformance probe of an
+// A2A 1.0 agent on the JSON-RPC binding, run from the package so a product repo gates its own deployment. It
+// covers the MUSTs the official TCK holds the standard surface to (spec 372 S1): the card and its interface,
+// the message round trip, task reads, cancel on a terminal task, the JSON-RPC error codes, streaming and push
+// where the card claims them. SHOULD and MAY are reported and never flip the verdict.
+//
+// A DOOR IS PROBED, NEVER A GRANT: a bearer names who is asking (a Home session, a session wire); the probe
+// sends one plain text message and reads it back. Nothing here signs, delegates or acts.
+import { A2A_ERROR, JSONRPC_ERROR } from '../standard/errors.js';
+import { TERMINAL_STATES } from '../standard/types.js';
+const isObj = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+const errorCodeOf = (body) => (isObj(body) && isObj(body.error) && typeof body.error.code === 'number' ? body.error.code : null);
+const hex32 = () => `0x${[...crypto.getRandomValues(new Uint8Array(32))].map((b) => b.toString(16).padStart(2, '0')).join('')}`;
+/** Finalise the report: a MUST that failed flips `ok`. */
+export function summarize(target, checks) {
+    return { target, ok: checks.every((c) => c.level !== 'MUST' || c.ok), checks };
+}
+/** A fixed-width table a person reads; the JSON is what a CI step keeps. */
+export function formatConformanceReport(r) {
+    const lines = [`conform · ${r.target} · ${r.ok ? '✓ conformant' : '✗ NOT conformant'} (${r.checks.filter((c) => c.ok).length}/${r.checks.length} checks)`];
+    for (const c of r.checks)
+        lines.push(`${c.ok ? '✓' : c.level === 'MUST' ? '✗' : '△'} ${c.level.padEnd(6)} ${c.id.padEnd(34)} ${c.detail ?? ''}`.trimEnd());
+    return lines.join('\n');
+}
+/** The card URL for a target: an origin gets `/.well-known/agent-card.json`; a URL ending in `.json` is the card itself. */
+export function cardUrlOf(target) {
+    const u = new URL(target);
+    if (/\.json$/i.test(u.pathname))
+        return u.toString();
+    return `${u.origin}/.well-known/agent-card.json`;
+}
+function parseSse(text) {
+    const frames = [];
+    for (const block of text.split(/\n\n+/)) {
+        const data = block.split('\n').filter((l) => l.startsWith('data:')).map((l) => l.slice(5).trim()).join('\n');
+        if (!data)
+            continue;
+        try {
+            frames.push(JSON.parse(data));
+        }
+        catch {
+            frames.push({ __raw: data });
+        }
+    }
+    return frames;
+}
+/**
+ * Probe an A2A 1.0 agent. `target` is the agent's origin (the card is read from `/.well-known/agent-card.json`)
+ * or the card URL itself; the JSON-RPC endpoint is the one the card publishes. Never throws for a server's
+ * behaviour — an unreachable card is a failed MUST with the reason.
+ */
+export async function conformA2a(target, opts = {}) {
+    const fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);
+    const timeoutMs = opts.timeoutMs ?? 15_000;
+    const checks = [];
+    const add = (id, level, ok, detail) => { checks.push({ id, level, ok, ...(detail ? { detail } : {}) }); return ok; };
+    const auth = opts.bearer ? { authorization: `Bearer ${opts.bearer}` } : {};
+    const timed = async (input, init) => {
+        const ctl = new AbortController();
+        const t = setTimeout(() => ctl.abort(), timeoutMs);
+        try {
+            return await fetchImpl(input, { ...init, signal: ctl.signal });
+        }
+        finally {
+            clearTimeout(t);
+        }
+    };
+    // ── 1. The card ───────────────────────────────────────────────────────────────────────────────────
+    let cardUrl;
+    try {
+        cardUrl = cardUrlOf(target);
+    }
+    catch {
+        add('card.fetch', 'MUST', false, `${target} is not a URL`);
+        return summarize(target, checks);
+    }
+    let card;
+    let cardRes;
+    try {
+        cardRes = await timed(cardUrl, { headers: { accept: 'application/json' } });
+        const text = await cardRes.text();
+        if (cardRes.status !== 200) {
+            add('card.fetch', 'MUST', false, `GET ${cardUrl} → ${cardRes.status}`);
+            return summarize(target, checks);
+        }
+        try {
+            card = JSON.parse(text);
+        }
+        catch {
+            add('card.fetch', 'MUST', false, `GET ${cardUrl} → not JSON`);
+            return summarize(target, checks);
+        }
+    }
+    catch (e) {
+        add('card.fetch', 'MUST', false, `GET ${cardUrl}: ${e instanceof Error ? e.message : String(e)}`);
+        return summarize(target, checks);
+    }
+    add('card.fetch', 'MUST', true, `GET ${cardUrl} → 200 ${cardRes.headers.get('content-type') ?? ''}`.trimEnd());
+    const missing = ['name', 'description', 'version', 'supportedInterfaces', 'capabilities', 'defaultInputModes', 'defaultOutputModes', 'skills'].filter((k) => card[k] === undefined || card[k] === null);
+    const skillsOk = Array.isArray(card.skills) && card.skills.every((s) => isObj(s) && typeof s.id === 'string' && typeof s.name === 'string' && typeof s.description === 'string' && Array.isArray(s.tags));
+    add('card.required-fields', 'MUST', missing.length === 0 && skillsOk, missing.length ? `missing: ${missing.join(', ')}` : skillsOk ? `${card.name} v${card.version}, ${card.skills.length} skill(s)` : 'a skill lacks id/name/description/tags');
+    const iface = (Array.isArray(card.supportedInterfaces) ? card.supportedInterfaces : []).find((i) => isObj(i) && i.protocolBinding === 'JSONRPC' && /^1\./.test(String(i.protocolVersion ?? card.protocolVersion ?? '')) && typeof i.url === 'string');
+    add('card.jsonrpc-interface', 'MUST', !!iface, iface ? `JSONRPC ${String(iface.protocolVersion ?? card.protocolVersion)} at ${iface.url}` : 'no supportedInterfaces entry with protocolBinding JSONRPC and protocolVersion 1.x');
+    add('card.cache-headers', 'SHOULD', !!(cardRes.headers.get('etag') || cardRes.headers.get('last-modified') || cardRes.headers.get('cache-control')), `etag=${cardRes.headers.get('etag') ? 'yes' : 'no'} last-modified=${cardRes.headers.get('last-modified') ? 'yes' : 'no'} cache-control=${cardRes.headers.get('cache-control') ?? 'none'}`);
+    try {
+        const legacy = await timed(`${new URL(cardUrl).origin}/.well-known/agent.json`, { headers: { accept: 'application/json' } });
+        add('card.legacy-path', 'MAY', legacy.status === 200, `/.well-known/agent.json → ${legacy.status}`);
+    }
+    catch { /* a MAY that could not be read is not reported */ }
+    if (!iface)
+        return summarize(target, checks);
+    const endpoint = String(iface.url);
+    // ── 2. The JSON-RPC binding ───────────────────────────────────────────────────────────────────────
+    let seq = 0;
+    const post = async (body, extra = {}) => {
+        const id = typeof body === 'string' ? undefined : (body.id === undefined ? ++seq : body.id);
+        const payload = typeof body === 'string' ? body : JSON.stringify({ jsonrpc: '2.0', id, method: body.method, params: body.params ?? {} });
+        const res = await timed(endpoint, { method: 'POST', headers: { 'content-type': 'application/json', accept: extra.accept ?? 'application/json', 'a2a-version': '1.0', ...auth, ...(extra.headers ?? {}) }, body: payload });
+        const contentType = (res.headers.get('content-type') ?? '').toLowerCase();
+        const text = await res.text();
+        if (/text\/event-stream/.test(contentType)) {
+            const frames = parseSse(text);
+            return { status: res.status, contentType, headers: res.headers, body: frames[frames.length - 1] ?? null, text, frames };
+        }
+        let parsed = null;
+        try {
+            parsed = text ? JSON.parse(text) : null;
+        }
+        catch {
+            parsed = null;
+        }
+        return { status: res.status, contentType, headers: res.headers, body: parsed, text, frames: [] };
+    };
+    const resultOf = (r) => (isObj(r.body) && isObj(r.body.result) ? (r.body.result) : null);
+    let sent;
+    try {
+        sent = await post({ method: 'SendMessage', params: { message: { messageId: hex32(), role: 'ROLE_USER', parts: [{ text: opts.message ?? 'ap conform: a probe message — reply with anything.' }] } } });
+    }
+    catch (e) {
+        add('rpc.reachable', 'MUST', false, `POST ${endpoint}: ${e instanceof Error ? e.message : String(e)}`);
+        return summarize(target, checks);
+    }
+    add('rpc.reachable', 'MUST', true, `POST ${endpoint} → ${sent.status}`);
+    if (sent.status === 401) {
+        add('auth.challenge', 'MUST', /^\s*bearer\b/i.test(sent.headers.get('www-authenticate') ?? ''), `401 WWW-Authenticate: ${sent.headers.get('www-authenticate') ?? '(absent)'}`);
+        add('auth.probe-scope', 'MUST', true, opts.bearer ? 'the supplied bearer was refused — nothing behind the door was probed' : 'unauthenticated: the door is conformant; the message round trip, task reads, cancel, streaming and push were NOT probed — pass a bearer to go further');
+        return summarize(target, checks);
+    }
+    if (opts.bearer) {
+        const bare = await post({ method: 'GetTask', params: { id: hex32() } }, { headers: { authorization: '' } }).catch(() => null);
+        add('auth.unauthenticated-refused', 'MUST', !!bare && bare.status === 401, bare ? `without a bearer: ${bare.status}` : 'the bare request did not answer');
+    }
+    const sr = resultOf(sent);
+    let task = isObj(sr?.task) ? sr.task : null;
+    const message = isObj(sr?.message) ? sr.message : null;
+    const shapeOk = task ? typeof task.id === 'string' && typeof task.contextId === 'string' && isObj(task.status) && typeof task.status.state === 'string' : message ? typeof message.messageId === 'string' && Array.isArray(message.parts) : false;
+    add('rpc.send-message', 'MUST', sent.status === 200 && shapeOk, task ? `task ${task.id} ${task.status.state}` : message ? `a message reply (${message.parts.length} part(s))` : `${sent.status} ${sent.text.slice(0, 160)}`);
+    if (task) {
+        const got = await post({ method: 'GetTask', params: { id: task.id } });
+        const gt = resultOf(got);
+        const echoed = !!gt && gt.id === task.id && Array.isArray(gt.history) && gt.history.some((m) => m.role === 'ROLE_USER');
+        add('rpc.get-task', 'MUST', echoed, gt ? `GetTask → ${gt.status?.state}, history ${gt.history?.length ?? 0}` : `GetTask → ${got.status} ${got.text.slice(0, 120)}`);
+        // Let it settle (bounded), so cancel meets a terminal task where the executor completes at once.
+        const deadline = Date.now() + timeoutMs;
+        let last = gt ?? task;
+        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, 500));
+            const again = resultOf(await post({ method: 'GetTask', params: { id: task.id } }));
+            if (again)
+                last = again;
+        }
+        task = last;
+        const cancel = await post({ method: 'CancelTask', params: { id: task.id } });
+        if (TERMINAL_STATES.has(task.status.state)) {
+            add('rpc.cancel-terminal', 'MUST', errorCodeOf(cancel.body) === A2A_ERROR.TaskNotCancelable, `CancelTask on a ${task.status.state} task → ${errorCodeOf(cancel.body) ?? cancel.status} (TaskNotCancelable is ${A2A_ERROR.TaskNotCancelable})`);
+        }
+        else {
+            const ct = resultOf(cancel);
+            add('rpc.cancel', 'MUST', !!ct && ct.status?.state === 'TASK_STATE_CANCELED', ct ? `CancelTask on a ${task.status.state} task → ${ct.status?.state}` : `CancelTask → ${cancel.status} ${cancel.text.slice(0, 120)}`);
+        }
+        const lt = await post({ method: 'ListTasks', params: { pageSize: 5 } });
+        const ltr = resultOf(lt);
+        add('rpc.list-tasks', 'SHOULD', !!ltr && Array.isArray(ltr.tasks), ltr ? `ListTasks → ${ltr.tasks?.length ?? '?'} task(s)` : `ListTasks → ${errorCodeOf(lt.body) ?? lt.status}`);
+    }
+    const nf = await post({ method: 'GetTask', params: { id: hex32() } });
+    add('rpc.task-not-found', 'MUST', errorCodeOf(nf.body) === A2A_ERROR.TaskNotFound, `GetTask of an unknown id → ${errorCodeOf(nf.body) ?? nf.status} (TaskNotFound is ${A2A_ERROR.TaskNotFound})`);
+    const mnf = await post({ method: 'NoSuchMethod', params: {} });
+    add('rpc.method-not-found', 'MUST', errorCodeOf(mnf.body) === JSONRPC_ERROR.MethodNotFound, `NoSuchMethod → ${errorCodeOf(mnf.body) ?? mnf.status}`);
+    const ip = await post({ method: 'SendMessage', params: { message: { role: 'ROLE_USER' } } });
+    add('rpc.invalid-params', 'MUST', errorCodeOf(ip.body) === JSONRPC_ERROR.InvalidParams, `SendMessage without parts → ${errorCodeOf(ip.body) ?? ip.status}`);
+    const pe = await post('{"jsonrpc":"2.0","id":1,"method":');
+    add('rpc.parse-error', 'MUST', errorCodeOf(pe.body) === JSONRPC_ERROR.ParseError, `malformed JSON → ${errorCodeOf(pe.body) ?? pe.status}`);
+    const ir = await post('{"id":1,"method":"GetTask","params":{}}');
+    add('rpc.invalid-request', 'MUST', errorCodeOf(ir.body) === JSONRPC_ERROR.InvalidRequest, `a body without jsonrpc:"2.0" → ${errorCodeOf(ir.body) ?? ir.status}`);
+    const vv = await post({ method: 'GetTask', params: { id: hex32() } }, { headers: { 'a2a-version': '9.9' } });
+    add('rpc.version-not-supported', 'SHOULD', errorCodeOf(vv.body) === A2A_ERROR.VersionNotSupported, `A2A-Version: 9.9 → ${errorCodeOf(vv.body) ?? vv.status}`);
+    // ── 3. Streaming, as the card claims it ───────────────────────────────────────────────────────────
+    const streaming = card.capabilities?.streaming === true;
+    const ss = await post({ method: 'SendStreamingMessage', params: { message: { messageId: hex32(), role: 'ROLE_USER', parts: [{ text: opts.message ?? 'ap conform: a streamed probe message.' }] } } }, { accept: 'text/event-stream' });
+    if (streaming) {
+        const events = ss.frames.filter((f) => isObj(f) && isObj(f.result) && ['task', 'message', 'statusUpdate', 'artifactUpdate'].some((k) => k in f.result));
+        add('stream.send-streaming-message', 'MUST', ss.status === 200 && /text\/event-stream/.test(ss.contentType) && events.length > 0, `SendStreamingMessage → ${ss.status} ${ss.contentType}, ${events.length} StreamResponse event(s)`);
+        const rs = await post({ method: 'SubscribeToTask', params: { id: hex32() } }, { accept: 'text/event-stream' });
+        add('stream.resubscribe-not-found', 'MUST', errorCodeOf(rs.body) === A2A_ERROR.TaskNotFound, `SubscribeToTask of an unknown id → ${errorCodeOf(rs.body) ?? rs.status}`);
+    }
+    else {
+        add('stream.unsupported-declared', 'MUST', errorCodeOf(ss.body) === A2A_ERROR.UnsupportedOperation, `the card claims no streaming; SendStreamingMessage → ${errorCodeOf(ss.body) ?? ss.status} (UnsupportedOperation is ${A2A_ERROR.UnsupportedOperation})`);
+    }
+    // ── 4. Push notification configs, as the card claims them ─────────────────────────────────────────
+    const push = card.capabilities?.pushNotifications === true;
+    if (task) {
+        const pc = await post({ method: 'CreateTaskPushNotificationConfig', params: { taskId: task.id, pushNotificationConfig: { url: 'https://example.invalid/ap-conform-hook', token: 'probe' } } });
+        if (push) {
+            const created = resultOf(pc);
+            const cid = created && typeof created.id === 'string' ? created.id : null;
+            let roundTrip = false;
+            let deleted = false;
+            if (cid) {
+                const g = resultOf(await post({ method: 'GetTaskPushNotificationConfig', params: { taskId: task.id, id: cid } }));
+                roundTrip = !!g && g.url === 'https://example.invalid/ap-conform-hook';
+                const d = await post({ method: 'DeleteTaskPushNotificationConfig', params: { taskId: task.id, id: cid } });
+                deleted = !!resultOf(d);
+            }
+            add('push.config-round-trip', 'MUST', !!cid && roundTrip && deleted, cid ? `create → get → delete on task ${task.id}${roundTrip ? '' : ' (get did not echo the url)'}${deleted ? '' : ' (delete failed)'}` : `CreateTaskPushNotificationConfig → ${errorCodeOf(pc.body) ?? pc.status} ${pc.text.slice(0, 120)}`);
+        }
+        else {
+            add('push.unsupported-declared', 'MUST', errorCodeOf(pc.body) === A2A_ERROR.PushNotificationNotSupported, `the card claims no push; CreateTaskPushNotificationConfig → ${errorCodeOf(pc.body) ?? pc.status} (PushNotificationNotSupported is ${A2A_ERROR.PushNotificationNotSupported})`);
+        }
+    }
+    return summarize(target, checks);
+}
+//# sourceMappingURL=index.js.map

package/dist/conform/index.js.map

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

package/dist/discovery.d.ts

@@ -1,5 +1,9 @@
 import type { Address } from '@agenticprimitives/types';
 import type { AgentCard } from './agent.js';
+/** A2A JSON-RPC path — the one path the package owns (mirrored by value in agent-naming's `dns.ts`; golden-vector tested there). */
+export declare const A2A_JSONRPC_PATH: "/api/a2a";
+/** A2A agent-card discovery path (origin-scoped, hence one host per agent — spec 346 §5). */
+export declare const A2A_AGENT_CARD_PATH: "/.well-known/agent-card.json";
 /** Injected name→SA resolver (e.g. agent-naming's `AgentNamingClient.resolveName`). */
 export type ResolveAgentName = (name: string) => Promise<Address | null>;
 /** Injected endpoint builder — maps an agent name to its A2A base URL (the app owns the hostname pattern,

package/dist/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AAEzE;4EAC4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yFAAyF;AACzF,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AAE/F;0EAC0E;AAC1E,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,WAAW,EAAE,gBAAgB,CAAC;IAAC,WAAW,EAAE,gBAAgB,CAAA;CAAE,GACrE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAU3B;AAED,4GAA4G;AAC5G,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAIvG"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,oIAAoI;AACpI,eAAO,MAAM,gBAAgB,EAAG,UAAmB,CAAC;AACpD,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,EAAG,8BAAuC,CAAC;AAE3E,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AAEzE;4EAC4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yFAAyF;AACzF,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AAE/F;0EAC0E;AAC1E,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,WAAW,EAAE,gBAAgB,CAAC;IAAC,WAAW,EAAE,gBAAgB,CAAA;CAAE,GACrE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAU3B;AAED,4GAA4G;AAC5G,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAIvG"}

package/dist/discovery.js

@@ -1,3 +1,7 @@
+/** A2A JSON-RPC path — the one path the package owns (mirrored by value in agent-naming's `dns.ts`; golden-vector tested there). */
+export const A2A_JSONRPC_PATH = '/api/a2a';
+/** A2A agent-card discovery path (origin-scoped, hence one host per agent — spec 346 §5). */
+export const A2A_AGENT_CARD_PATH = '/.well-known/agent-card.json';
 /** Resolve a target agent: name → SA (injected resolver) → endpoint (injected builder). Returns `null`
  *  when the name has no Smart Account (empty is an answer — ADR-0013). */
 export async function resolveA2aTarget(name, deps) {
@@ -8,8 +12,8 @@ export async function resolveA2aTarget(name, deps) {
     return {
         name,
         agentSA,
-        endpoint: `${base}/api/a2a`,
-        agentCardUrl: `${base}/.well-known/agent-card.json`,
+        endpoint: `${base}${A2A_JSONRPC_PATH}`,
+        agentCardUrl: `${base}${A2A_AGENT_CARD_PATH}`,
     };
 }
 /** Fetch + parse a target's agent-card (skills + capabilities). `fetchFn` is injected. `null` if absent. */

package/dist/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AA0BA;0EAC0E;AAC1E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,IAAsE;IAEtE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxD,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ,EAAE,GAAG,IAAI,UAAU;QAC3B,YAAY,EAAE,GAAG,IAAI,8BAA8B;KACpD,CAAC;AACJ,CAAC;AAED,4GAA4G;AAC5G,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,YAAoB,EAAE,OAAiB;IAC1E,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAc,CAAC;AACvC,CAAC"}
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAOA,oIAAoI;AACpI,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAmB,CAAC;AACpD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAAuC,CAAC;AAqB3E;0EAC0E;AAC1E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,IAAsE;IAEtE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxD,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ,EAAE,GAAG,IAAI,GAAG,gBAAgB,EAAE;QACtC,YAAY,EAAE,GAAG,IAAI,GAAG,mBAAmB,EAAE;KAC9C,CAAC;AACJ,CAAC;AAED,4GAA4G;AAC5G,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,YAAoB,EAAE,OAAiB;IAC1E,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAc,CAAC;AACvC,CAAC"}

package/dist/engagement.d.ts

@@ -0,0 +1,37 @@
+import type { MessageV1 } from './standard/types.js';
+export declare const AP_ENGAGEMENT_EXTENSION_URI = "https://agenticprimitives.org/a2a/intent-engagement/v1";
+/** The card declaration: this agent answers probes (IEP Core). */
+export declare const ENGAGEMENT_CARD_EXTENSION: {
+    readonly uri: "https://agenticprimitives.org/a2a/intent-engagement/v1";
+    readonly required: false;
+    readonly description: "Intent engagement (spec 336): a probe carrying a minimized projection of an intent is answered with an offer, a decline, a question, a referral or an unavailability — as a message, never a task. Nothing before the mandate is authority.";
+};
+export type EngagementWireDocument = {
+    type: string;
+} & Record<string, unknown>;
+/** The wire-level checks on a probe: who, what intent, which projection, by when, with what nonce. */
+export declare function validateEngagementProbe(x: unknown): {
+    ok: true;
+    probe: EngagementWireDocument;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function validateEngagementResponse(x: unknown): {
+    ok: true;
+    response: EngagementWireDocument;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function engagementProbeMessage(probe: EngagementWireDocument, messageId?: string): MessageV1;
+export declare function engagementResponseMessage(response: EngagementWireDocument, messageId?: string): MessageV1;
+/** Read whichever engagement document a message carries. `null` ⇒ not this extension's business. */
+export declare function engagementOf(message: Pick<MessageV1, 'metadata' | 'extensions'>): {
+    probe: EngagementWireDocument;
+} | {
+    response: EngagementWireDocument;
+} | {
+    errors: string[];
+} | null;
+//# sourceMappingURL=engagement.d.ts.map

package/dist/engagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../src/engagement.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,eAAO,MAAM,2BAA2B,2DAA2D,CAAC;AAEpG,kEAAkE;AAClE,eAAO,MAAM,yBAAyB;;;;CAI5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAKhF,sGAAsG;AACtG,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAUjI;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,sBAAsB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAUvI;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAQnG;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CASzG;AAED,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG;IAAE,KAAK,EAAE,sBAAsB,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,sBAAsB,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAQxL"}

package/dist/engagement.js

@@ -0,0 +1,83 @@
+export const AP_ENGAGEMENT_EXTENSION_URI = 'https://agenticprimitives.org/a2a/intent-engagement/v1';
+/** The card declaration: this agent answers probes (IEP Core). */
+export const ENGAGEMENT_CARD_EXTENSION = {
+    uri: AP_ENGAGEMENT_EXTENSION_URI,
+    required: false,
+    description: 'Intent engagement (spec 336): a probe carrying a minimized projection of an intent is answered with an offer, a decline, a question, a referral or an unavailability — as a message, never a task. Nothing before the mandate is authority.',
+};
+const ADDR = /^0x[0-9a-fA-F]{40}$/;
+const HEX32 = /^0x[0-9a-fA-F]{64}$/;
+/** The wire-level checks on a probe: who, what intent, which projection, by when, with what nonce. */
+export function validateEngagementProbe(x) {
+    const errors = [];
+    const p = (x && typeof x === 'object' ? x : {});
+    if (p.type !== 'ap.engagement-probe.v1')
+        errors.push('type: expected ap.engagement-probe.v1');
+    for (const k of ['probeId', 'engagementId', 'campaignId', 'probeNonce', 'replyBy', 'issuedAt', 'objective', 'processing'])
+        if (typeof p[k] !== 'string' || !p[k].trim())
+            errors.push(`${k}: required`);
+    for (const k of ['requester', 'candidate'])
+        if (!ADDR.test(String(p[k] ?? '')))
+            errors.push(`${k}: must be an address`);
+    for (const k of ['intentDigest', 'projectionDigest'])
+        if (!HEX32.test(String(p[k] ?? '')))
+            errors.push(`${k}: must be a 32-byte digest`);
+    if (!p.projection || typeof p.projection !== 'object')
+        errors.push('projection: required');
+    else if ('withholds' in p.projection)
+        errors.push('projection.withholds: never on the wire (336 §3.1)');
+    return errors.length ? { ok: false, errors } : { ok: true, probe: p };
+}
+export function validateEngagementResponse(x) {
+    const errors = [];
+    const r = (x && typeof x === 'object' ? x : {});
+    if (r.type !== 'ap.engagement-response.v1')
+        errors.push('type: expected ap.engagement-response.v1');
+    for (const k of ['responseId', 'inReplyTo', 'engagementId', 'probeNonce', 'issuedAt', 'idempotencyKey'])
+        if (typeof r[k] !== 'string' || !r[k].trim())
+            errors.push(`${k}: required`);
+    if (!ADDR.test(String(r.provider ?? '')))
+        errors.push('provider: must be an address');
+    const content = r.content;
+    const kinds = ['offer', 'needs-clarification', 'human-ux-required', 'referral', 'decline', 'temporarily-unavailable'];
+    if (!content || typeof content !== 'object' || !kinds.includes(String(content.kind)))
+        errors.push(`content.kind: one of ${kinds.join(' | ')}`);
+    return errors.length ? { ok: false, errors } : { ok: true, response: r };
+}
+export function engagementProbeMessage(probe, messageId) {
+    return {
+        messageId: messageId ?? `probe:${String(probe.probeId)}`,
+        role: 'ROLE_USER',
+        parts: [{ text: `Engagement probe ${String(probe.probeId)}: will you take this intent, and on what terms?` }, { data: probe }],
+        extensions: [AP_ENGAGEMENT_EXTENSION_URI],
+        metadata: { [AP_ENGAGEMENT_EXTENSION_URI]: probe },
+    };
+}
+export function engagementResponseMessage(response, messageId) {
+    const kind = String(response.content?.kind ?? 'response');
+    return {
+        messageId: messageId ?? `response:${String(response.responseId)}`,
+        role: 'ROLE_AGENT',
+        parts: [{ text: `Engagement response (${kind}) to probe ${String(response.inReplyTo)}` }, { data: response }],
+        extensions: [AP_ENGAGEMENT_EXTENSION_URI],
+        metadata: { [AP_ENGAGEMENT_EXTENSION_URI]: response },
+    };
+}
+/** Read whichever engagement document a message carries. `null` ⇒ not this extension's business. */
+export function engagementOf(message) {
+    const raw = message.metadata?.[AP_ENGAGEMENT_EXTENSION_URI];
+    const declared = (message.extensions ?? []).includes(AP_ENGAGEMENT_EXTENSION_URI);
+    if (raw === undefined)
+        return declared ? { errors: [`message declares ${AP_ENGAGEMENT_EXTENSION_URI} and carries nothing under it`] } : null;
+    const t = raw?.type;
+    if (t === 'ap.engagement-probe.v1') {
+        const v = validateEngagementProbe(raw);
+        return v.ok ? { probe: v.probe } : { errors: v.errors };
+    }
+    if (t === 'ap.engagement-response.v1') {
+        const v = validateEngagementResponse(raw);
+        return v.ok ? { response: v.response } : { errors: v.errors };
+    }
+    return { errors: [`unknown engagement document type ${String(t)}`] };
+}
+//# sourceMappingURL=engagement.js.map

package/dist/engagement.js.map

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

package/dist/grant.d.ts

@@ -1,9 +1,11 @@
-import { type Address, type Hex } from 'viem';
+import type { Address, Hex } from 'viem';
 import type { Caveat } from '@agenticprimitives/delegation';
 /** The "any skill" sentinel for `allowedMethods` — a grant carrying this selector authorizes every
  *  skill on the recipient agent (use sparingly; a specific selector is the default). */
 export declare const A2A_ANY_SKILL: Hex;
-/** Map a skill name to its 4-byte `allowedMethods` selector: keccak256(utf8(skill))[:4]. */
+/** Map a skill name to its 4-byte `allowedMethods` selector, plus the A2A "any skill" sentinel.
+ *  The mapping itself is `delegation.methodSelector` — the package that owns the encoding owns the
+ *  name→selector rule, so the two cannot drift. */
 export declare function skillSelector(skill: string): Hex;
 /** The deployed enforcer addresses (from the network deployment) the grant pins against. */
 export interface A2aEnforcers {

package/dist/grant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grant.d.ts","sourceRoot":"","sources":["../src/grant.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAOlE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D;wFACwF;AACxF,eAAO,MAAM,aAAa,EAAE,GAAkB,CAAC;AAE/C,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAGhD;AAED,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD,GAAG,MAAM,EAAE,CAMX"}
+{"version":3,"file":"grant.d.ts","sourceRoot":"","sources":["../src/grant.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AASzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D;wFACwF;AACxF,eAAO,MAAM,aAAa,EAAE,GAAkB,CAAC;AAE/C;;mDAEmD;AACnD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAGhD;AAED,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD,GAAG,MAAM,EAAE,CAiBX"}

package/dist/grant.js

@@ -1,17 +1,14 @@
-// Scoped-grant caveat builders (spec 269 FR-4.2). A caller mints a delegation scoped to EXACTLY one
-// recipient agent + one skill so it can't be replayed against a different agent/skill (the A2A
-// non-replayability model — the agent-endpoint analogue of DEL-001's "possession ≠ authority"). Reuses
-// the deployed AllowedTargets / AllowedMethods / Timestamp enforcers — we invent no new ones.
-import { keccak256, toBytes } from 'viem';
-import { buildCaveat, encodeTimestampTerms, encodeAllowedTargetsTerms, encodeAllowedMethodsTerms, } from '@agenticprimitives/delegation';
+import { buildCaveat, buildMethodAuthorityCaveats, encodeAllowedMethodsTerms, encodeAllowedTargetsTerms, encodeTimestampTerms, methodSelector, } from '@agenticprimitives/delegation';
 /** The "any skill" sentinel for `allowedMethods` — a grant carrying this selector authorizes every
  *  skill on the recipient agent (use sparingly; a specific selector is the default). */
 export const A2A_ANY_SKILL = '0x00000000';
-/** Map a skill name to its 4-byte `allowedMethods` selector: keccak256(utf8(skill))[:4]. */
+/** Map a skill name to its 4-byte `allowedMethods` selector, plus the A2A "any skill" sentinel.
+ *  The mapping itself is `delegation.methodSelector` — the package that owns the encoding owns the
+ *  name→selector rule, so the two cannot drift. */
 export function skillSelector(skill) {
     if (skill === '*' || skill === A2A_ANY_SKILL)
         return A2A_ANY_SKILL;
-    return keccak256(toBytes(skill)).slice(0, 10); // 0x + 8 hex = 4 bytes
+    return methodSelector(skill);
 }
 /**
  * Build the caveat set for an A2A grant: a timestamp window, the recipient agent SA as the ONLY allowed
@@ -20,10 +17,21 @@ export function skillSelector(skill) {
  * them, rejecting a grant whose target ≠ this agent or whose method ≠ the requested skill.
  */
 export function buildA2aGrantCaveats(args) {
-    return [
-        buildCaveat(args.enforcers.timestamp, encodeTimestampTerms(args.window.validAfter, args.window.validUntil)),
-        buildCaveat(args.enforcers.allowedTargets, encodeAllowedTargetsTerms([args.recipientAgentSA])),
-        buildCaveat(args.enforcers.allowedMethods, encodeAllowedMethodsTerms([skillSelector(args.skill)])),
-    ];
+    // Same encoding as any method authority — but the target here is the agent being CALLED, not the
+    // agent being acted for. `A2A_ANY_SKILL` is the one A2A-specific case the shared builder has no
+    // notion of, so it is expanded here rather than pushed down into `delegation`.
+    if (args.skill === '*' || args.skill === A2A_ANY_SKILL) {
+        return [
+            buildCaveat(args.enforcers.timestamp, encodeTimestampTerms(args.window.validAfter, args.window.validUntil)),
+            buildCaveat(args.enforcers.allowedTargets, encodeAllowedTargetsTerms([args.recipientAgentSA])),
+            buildCaveat(args.enforcers.allowedMethods, encodeAllowedMethodsTerms([A2A_ANY_SKILL])),
+        ];
+    }
+    return buildMethodAuthorityCaveats({
+        target: args.recipientAgentSA,
+        method: args.skill,
+        enforcers: args.enforcers,
+        window: args.window,
+    });
 }
 //# sourceMappingURL=grant.js.map

package/dist/grant.js.map

@@ -1 +1 @@
-{"version":3,"file":"grant.js","sourceRoot":"","sources":["../src/grant.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,+FAA+F;AAC/F,uGAAuG;AACvG,8FAA8F;AAC9F,OAAO,EAAE,SAAS,EAAE,OAAO,EAA0B,MAAM,MAAM,CAAC;AAClE,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AAGvC;wFACwF;AACxF,MAAM,CAAC,MAAM,aAAa,GAAQ,YAAY,CAAC;AAE/C,4FAA4F;AAC5F,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IACnE,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAQ,CAAC,CAAC,uBAAuB;AAC/E,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAKpC;IACC,OAAO;QACL,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3G,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC9F,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACnG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"grant.js","sourceRoot":"","sources":["../src/grant.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,WAAW,EACX,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,GACf,MAAM,+BAA+B,CAAC;AAGvC;wFACwF;AACxF,MAAM,CAAC,MAAM,aAAa,GAAQ,YAAY,CAAC;AAE/C;;mDAEmD;AACnD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IACnE,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAKpC;IACC,iGAAiG;IACjG,gGAAgG;IAChG,+EAA+E;IAC/E,IAAI,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;QACvD,OAAO;YACL,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC3G,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC9F,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;SACvF,CAAC;IACJ,CAAC;IACD,OAAO,2BAA2B,CAAC;QACjC,MAAM,EAAE,IAAI,CAAC,gBAAgB;QAC7B,MAAM,EAAE,IAAI,CAAC,KAAK;QAClB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/handoff.d.ts

@@ -0,0 +1,42 @@
+import type { Address } from '@agenticprimitives/types';
+export declare const AP_HANDOFF_EXTENSION_URI = "https://agenticprimitives.org/a2a/handoff/v1";
+export interface HandoffV1 {
+    extension: typeof AP_HANDOFF_EXTENSION_URI;
+    version: 1;
+    /** The SUB-intent: the one step in words, with the parent named in its context. Its digest is what the
+     *  child mandate is bound to; the specialist's run is admitted against exactly this. */
+    intent: {
+        goal: string;
+        context?: Record<string, unknown>;
+    };
+    /** The one step, as the parent's plan admitted it. */
+    plan: {
+        steps: Array<{
+            toolId: string;
+            args: Record<string, unknown>;
+            id?: string;
+        }>;
+    };
+    /** The chain, LEAF FIRST: the child, then the mandate it was derived from. Wires, never bodies. */
+    presented: unknown[];
+    /** The parent run's supplied inputs for this step (a second party's approval, a signature), re-keyed to
+     *  the one step: an approval given for the person's mandate is inherited by its child. */
+    supplied?: unknown[];
+    /** Whose run this is a step of, and which step — for the receipt on each side and the resume. */
+    parent: {
+        agent: Address;
+        runRef: string;
+        stepRef: string;
+        operationId: string;
+        childRef: string;
+    };
+}
+export declare function validateHandoff(x: unknown): {
+    ok: true;
+    handoff: HandoffV1;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function handoff(input: Omit<HandoffV1, 'extension' | 'version'>): HandoffV1;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD,eAAO,MAAM,wBAAwB,iDAAiD,CAAC;AAEvF,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,OAAO,wBAAwB,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC;IACX;4FACwF;IACxF,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC5D,sDAAsD;IACtD,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAAC,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACvF,mGAAmG;IACnG,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB;8FAC0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,iGAAiG;IACjG,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACpG;AAID,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAa9G;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,SAAS,CAElF"}