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

package/dist/standard/types.d.ts

@@ -0,0 +1,186 @@
+export type TaskStateV1 = 'TASK_STATE_UNSPECIFIED' | 'TASK_STATE_SUBMITTED' | 'TASK_STATE_WORKING' | 'TASK_STATE_COMPLETED' | 'TASK_STATE_FAILED' | 'TASK_STATE_CANCELED' | 'TASK_STATE_INPUT_REQUIRED' | 'TASK_STATE_REJECTED' | 'TASK_STATE_AUTH_REQUIRED';
+export declare const TERMINAL_STATES: ReadonlySet<TaskStateV1>;
+export type RoleV1 = 'ROLE_UNSPECIFIED' | 'ROLE_USER' | 'ROLE_AGENT';
+/** One part: exactly one of `text` / `raw` (base64 bytes) / `url` / `data`. `mediaType` + `filename` qualify a file. */
+export interface PartV1 {
+    text?: string;
+    raw?: string;
+    url?: string;
+    data?: unknown;
+    filename?: string;
+    mediaType?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface MessageV1 {
+    messageId: string;
+    role: RoleV1;
+    parts: PartV1[];
+    contextId?: string;
+    taskId?: string;
+    referenceTaskIds?: string[];
+    extensions?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface ArtifactV1 {
+    artifactId: string;
+    parts: PartV1[];
+    name?: string;
+    description?: string;
+    extensions?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface TaskStatusV1 {
+    state: TaskStateV1;
+    message?: MessageV1;
+    timestamp?: string;
+}
+export interface TaskV1 {
+    id: string;
+    contextId: string;
+    status: TaskStatusV1;
+    artifacts?: ArtifactV1[];
+    history?: MessageV1[];
+    metadata?: Record<string, unknown>;
+}
+export interface TaskStatusUpdateEventV1 {
+    taskId: string;
+    contextId: string;
+    status: TaskStatusV1;
+    metadata?: Record<string, unknown>;
+}
+export interface TaskArtifactUpdateEventV1 {
+    taskId: string;
+    contextId: string;
+    artifact: ArtifactV1;
+    append?: boolean;
+    lastChunk?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/** One SSE `data:` line of a streaming method — exactly one member set. */
+export type StreamResponseV1 = {
+    task: TaskV1;
+} | {
+    message: MessageV1;
+} | {
+    statusUpdate: TaskStatusUpdateEventV1;
+} | {
+    artifactUpdate: TaskArtifactUpdateEventV1;
+};
+export interface SendMessageConfigurationV1 {
+    acceptedOutputModes?: string[];
+    historyLength?: number;
+    returnImmediately?: boolean;
+    taskPushNotificationConfig?: TaskPushNotificationConfigV1;
+}
+export interface SendMessageRequestV1 {
+    message: MessageV1;
+    configuration?: SendMessageConfigurationV1;
+    metadata?: Record<string, unknown>;
+    tenant?: string;
+}
+export type SendMessageResponseV1 = {
+    task: TaskV1;
+} | {
+    message: MessageV1;
+};
+export interface PushNotificationConfigV1 {
+    id?: string;
+    url: string;
+    token?: string;
+    authentication?: {
+        scheme: string;
+        credentials?: string;
+    };
+}
+export interface TaskPushNotificationConfigV1 extends PushNotificationConfigV1 {
+    taskId?: string;
+    tenant?: string;
+}
+export interface AgentInterfaceV1 {
+    url: string;
+    protocolBinding: 'JSONRPC' | 'GRPC' | 'HTTP+JSON' | string;
+    protocolVersion: string;
+    tenant?: string;
+}
+export interface AgentSkillV1 {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+}
+export interface AgentCardV1 {
+    name: string;
+    description: string;
+    version: string;
+    supportedInterfaces: AgentInterfaceV1[];
+    capabilities: {
+        streaming?: boolean;
+        pushNotifications?: boolean;
+        extendedAgentCard?: boolean;
+        extensions?: Array<{
+            uri: string;
+            description?: string;
+            required?: boolean;
+            params?: Record<string, unknown>;
+        }>;
+    };
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    skills: AgentSkillV1[];
+    provider?: {
+        organization: string;
+        url: string;
+    };
+    documentationUrl?: string;
+    iconUrl?: string;
+    securitySchemes?: Record<string, SecuritySchemeV1>;
+    securityRequirements?: Array<{
+        schemes: Record<string, {
+            list: string[];
+        }>;
+    }>;
+    signatures?: Array<{
+        protected: string;
+        signature: string;
+        header?: Record<string, unknown>;
+    }>;
+}
+export type SecuritySchemeV1 = {
+    httpAuthSecurityScheme: {
+        scheme: string;
+        bearerFormat?: string;
+        description?: string;
+    };
+} | {
+    apiKeySecurityScheme: {
+        name: string;
+        location: string;
+        description?: string;
+    };
+} | {
+    mtlsSecurityScheme: {
+        description?: string;
+    };
+};
+export interface JsonRpcRequest {
+    jsonrpc?: string;
+    id?: string | number | null;
+    method?: string;
+    params?: unknown;
+}
+export type JsonRpcResponse = {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    result: unknown;
+} | {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    error: {
+        code: number;
+        message: string;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/standard/types.js

@@ -0,0 +1,14 @@
+// THE A2A 1.0 WIRE, AS PROTO-JSON — spec 372 S1.
+//
+// These are the shapes the official TCK validates responses against (its bundled `a2a.json`, generated
+// from `a2a.proto` at v1.0.0): lowerCamelCase field names, enum values as their proto strings
+// (`TASK_STATE_COMPLETED`, `ROLE_USER`), timestamps as RFC 3339 strings. Since the fold (spec 372 S4) they
+// are the ONLY wire shapes this package speaks.
+//
+// They are still not the runtime's own task types (`../types.ts`): that record carries vault refs, a grant
+// hash and a principal, and it is the system of record. What travels is a PROJECTION of it
+// (`delegated/delegatedTaskAsV1`) — refs and hashes, never bodies.
+export const TERMINAL_STATES = new Set([
+    'TASK_STATE_COMPLETED', 'TASK_STATE_FAILED', 'TASK_STATE_CANCELED', 'TASK_STATE_REJECTED',
+]);
+//# sourceMappingURL=types.js.map

package/dist/standard/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/standard/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,uGAAuG;AACvG,8FAA8F;AAC9F,2GAA2G;AAC3G,gDAAgD;AAChD,EAAE;AACF,2GAA2G;AAC3G,2FAA2F;AAC3F,mEAAmE;AAanE,MAAM,CAAC,MAAM,eAAe,GAA6B,IAAI,GAAG,CAAc;IAC5E,sBAAsB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,qBAAqB;CAC1F,CAAC,CAAC"}

package/dist/subject-ask.d.ts

@@ -0,0 +1,96 @@
+import type { Address } from '@agenticprimitives/types';
+export declare const AP_SUBJECT_ASK_EXTENSION_URI = "https://agenticprimitives.org/a2a/subject-ask/v1";
+/** The credential the asker holds, which the receiver verifies FOR ITSELF. A Home session names the person.
+ *  Spec 397 — `app-delegation`: the person asked their own agent THROUGH A CLIENT they authorized, and no session
+ *  exists; what travels is the ORIGINAL admission evidence verbatim — the `A2A-Session` authorization (the
+ *  per-request assertion signed by the app's key, session-wrapped with the person's ask-as-me wire) and the exact
+ *  body it bound. The receiver re-verifies the wire against the person on chain, the assertion's signature, its
+ *  freshness and audience, that the body it binds was addressed to the asker's own agent, and spends the
+ *  assertion once on ITS OWN object — one routed hop per receiver, never a replay to the same one. */
+export type SubjectAskCredentialV1 = {
+    kind: 'home-session';
+    token: string;
+} | {
+    kind: 'app-delegation';
+    authorization: string;
+    body: string;
+};
+/** The request A sends B. */
+export interface SubjectAskV1 {
+    extension: typeof AP_SUBJECT_ASK_EXTENSION_URI;
+    version: 1;
+    /** The delegated request: ONE capability step with the person's own words as arguments (the receiver
+     *  resolves them in the asker's tier as it would any ask), and the goal for the record. */
+    request: {
+        capability: string;
+        args: Record<string, unknown>;
+        goal: string;
+    };
+    /** Who is asking, and the credential they hold that the receiver verifies for itself. A Home session names
+     *  the person; a stewardship wire, when carried, is presented — never asserted. */
+    asker: {
+        agent: Address;
+        credential: SubjectAskCredentialV1;
+        presented?: unknown[];
+    };
+    /** The causal correlation: A's stable operation identity for this step, and the run it belongs to. */
+    correlation: {
+        operationId: string;
+        runRef: string;
+        stepRef: string;
+        intentDigest: string;
+    };
+    /** Spec 397 — the AGENT THAT ROUTED this step when it is not the asker's own (a person asking AT an organization,
+     *  whose agent routes one step onward). A forwarded app credential is bound to the ask at THAT agent; the receiver
+     *  accepts a bound body addressed to the asker's own agent or to this one, and nothing else. */
+    route?: {
+        agent: Address;
+    };
+    /** Spec 374 W2 — A CONTINUATION of the receiver's own parked run: the asker (a steward there) now
+     *  presents the mandate the receiver asked for, or supplies the answer it prompted for. The receiver
+     *  resumes THAT run under its own gates; nothing here is trusted beyond naming which run. */
+    continue?: {
+        runRef: string;
+        presented?: unknown[];
+        supplied?: unknown[];
+    };
+}
+/** The answer B returns A. */
+export interface SubjectAnswerV1 {
+    extension: typeof AP_SUBJECT_ASK_EXTENSION_URI;
+    version: 1;
+    /** The receiver's principal — the enduring agent, not its service endpoint. */
+    agent: Address;
+    /** Which request this answers (R), so A's next receipt can name S. */
+    inResponseTo: {
+        operationId: string;
+        runRef: string;
+        stepRef: string;
+    };
+    /** What happened on B's side, in B's words. A refusal is an answer; a need is a question B raised. */
+    outcome: 'answer' | 'refused' | 'needs' | 'error';
+    result?: unknown;
+    said?: string;
+    /** B's own run and the receipts of the steps it ran — evidence, never authority. */
+    run: {
+        runRef: string;
+        receipts: Array<{
+            stepRef: string;
+            capability?: string;
+            status: string;
+            binding?: unknown;
+        }>;
+    };
+}
+/** Structural validation of a request. Authority is NOT judged here — the receiver verifies the credential
+ *  and derives standing itself; this only refuses a request that is not this profile. */
+export declare function validateSubjectAsk(x: unknown): {
+    ok: true;
+    ask: SubjectAskV1;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function subjectAsk(input: Omit<SubjectAskV1, 'extension' | 'version'>): SubjectAskV1;
+export declare function subjectAnswer(input: Omit<SubjectAnswerV1, 'extension' | 'version'>): SubjectAnswerV1;
+//# sourceMappingURL=subject-ask.d.ts.map

package/dist/subject-ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-ask.d.ts","sourceRoot":"","sources":["../src/subject-ask.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD,eAAO,MAAM,4BAA4B,qDAAqD,CAAC;AAE/F;;;;;;sGAMsG;AACtG,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,4BAA4B,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC;IACX;+FAC2F;IAC3F,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E;uFACmF;IACnF,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,sBAAsB,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IACrF,sGAAsG;IACtG,WAAW,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5F;;oGAEgG;IAChG,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3B;;iGAE6F;IAC7F,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CAC5E;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,4BAA4B,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC;IACX,+EAA+E;IAC/E,KAAK,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,YAAY,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,sGAAsG;IACtG,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CACvH;AAID;yFACyF;AACzF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAqBhH;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,YAAY,CAE3F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,eAAe,CAEpG"}

package/dist/subject-ask.js

@@ -0,0 +1,45 @@
+export const AP_SUBJECT_ASK_EXTENSION_URI = 'https://agenticprimitives.org/a2a/subject-ask/v1';
+const isAddr = (v) => typeof v === 'string' && /^0x[0-9a-fA-F]{40}$/.test(v);
+/** Structural validation of a request. Authority is NOT judged here — the receiver verifies the credential
+ *  and derives standing itself; this only refuses a request that is not this profile. */
+export function validateSubjectAsk(x) {
+    const errors = [];
+    const a = x;
+    if (!a || typeof a !== 'object')
+        return { ok: false, errors: ['not an object'] };
+    if (a.extension !== AP_SUBJECT_ASK_EXTENSION_URI)
+        errors.push(`extension: expected ${AP_SUBJECT_ASK_EXTENSION_URI}`);
+    if (a.version !== 1)
+        errors.push('version: expected 1');
+    if (!a.request || typeof a.request.capability !== 'string' || !a.request.capability)
+        errors.push('request.capability: required');
+    if (!a.request || !a.request.args || typeof a.request.args !== 'object' || Array.isArray(a.request.args))
+        errors.push('request.args: an object');
+    if (!a.request || typeof a.request.goal !== 'string')
+        errors.push('request.goal: required');
+    if (!a.asker || !isAddr(a.asker.agent))
+        errors.push('asker.agent: an address');
+    const cred = a.asker?.credential;
+    const credOk = !!cred && ((cred.kind === 'home-session' && typeof cred.token === 'string' && !!cred.token)
+        || (cred.kind === 'app-delegation' && typeof cred.authorization === 'string' && /^A2A-Session\s/i.test(cred.authorization) && typeof cred.body === 'string'));
+    if (!credOk)
+        errors.push('asker.credential: { kind: home-session, token } or { kind: app-delegation, authorization, body }');
+    if (a.asker?.presented !== undefined && !Array.isArray(a.asker.presented))
+        errors.push('asker.presented: a list of wires when given');
+    if (a.route !== undefined && (!a.route || typeof a.route !== 'object' || !isAddr(a.route.agent)))
+        errors.push('route: { agent } — an address, when given');
+    const k = a.continue;
+    if (k !== undefined && (!k || typeof k !== 'object' || typeof k.runRef !== 'string' || !k.runRef || (k.presented !== undefined && !Array.isArray(k.presented)) || (k.supplied !== undefined && !Array.isArray(k.supplied))))
+        errors.push('continue: { runRef, presented?[], supplied?[] }');
+    const c = a.correlation;
+    if (!c || !['operationId', 'runRef', 'stepRef', 'intentDigest'].every((k) => typeof c[k] === 'string' && c[k]))
+        errors.push('correlation: { operationId, runRef, stepRef, intentDigest } required');
+    return errors.length ? { ok: false, errors } : { ok: true, ask: a };
+}
+export function subjectAsk(input) {
+    return { extension: AP_SUBJECT_ASK_EXTENSION_URI, version: 1, ...input };
+}
+export function subjectAnswer(input) {
+    return { extension: AP_SUBJECT_ASK_EXTENSION_URI, version: 1, ...input };
+}
+//# sourceMappingURL=subject-ask.js.map

package/dist/subject-ask.js.map

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

package/dist/subject-hop.d.ts

@@ -0,0 +1,75 @@
+import { type SubjectAskV1, type SubjectAnswerV1 } from './subject-ask.js';
+import { type HandoffV1 } from './handoff.js';
+import type { AgentCardV1, MessageV1, TaskV1 } from './standard/types.js';
+/** The A2A 1.0 JSON-RPC endpoint a card publishes, or null when it publishes none. */
+export declare function a2aEndpointOf(card: (Pick<AgentCardV1, 'supportedInterfaces'> & {
+    protocolVersion?: string;
+}) | null | undefined): string | null;
+/** The message that carries a subject-ask over the wire: the goal as text, the profile as metadata. */
+export declare function subjectAskMessage(profile: SubjectAskV1): MessageV1;
+/** The subject-ask a received message carries, validated; null when it carries none. */
+export declare function subjectAskOf(message: Pick<MessageV1, 'metadata'>): {
+    ask: SubjectAskV1;
+} | {
+    errors: string[];
+} | null;
+export declare const SUBJECT_ANSWER_ARTIFACT = "subject-answer";
+/**
+ * Appendix M8 — THE RECEIVER'S RUN, NAMED BY THE SENDER. A routed step's run at the subject's agent is
+ * addressable before it answers, so the sender can read its progress while it runs and its record can
+ * cite it by reference. Derived from the correlation the sender minted; the receiver adopts it for a
+ * fresh ask (a resume names the run it continues instead).
+ */
+export declare function routedRunRefFor(correlation: {
+    runRef: string;
+    stepRef: string;
+}): string;
+/** The receiver's `/harness/ask` envelope, as the task's `subject-answer` artifact carries it. */
+export declare function subjectEnvelopeOf(task: Pick<TaskV1, 'artifacts'> | null | undefined): Record<string, unknown> | null;
+export interface SubjectHopInput {
+    /** Spec 390 W2 — W3C Trace Context for the hop: the sender's trace, the routed step as the parent span. */
+    traceparent?: string;
+    tracestate?: string;
+    /** Where the subject's card is served (`https://<host>/.well-known/agent-card.json`). */
+    cardUrl: string;
+    profile: SubjectAskV1;
+    /** `atl:cardDigest` from the subject's name records — the sha256 of the released card's bytes. When the
+     *  name pins one, a served card that differs is refused: the pin is the name's word about its card. */
+    pinnedDigest?: string;
+    /** The asker's Home session — the `Authorization` bearer, which is also the credential the profile names. */
+    /** The asker's Home session as the bearer; absent when the profile carries the forwarded app credential (spec 397 W4). */
+    session?: string;
+    fetch: (input: string, init: RequestInit) => Promise<Response>;
+}
+export type SubjectHopOutcome = {
+    ok: true;
+    endpoint: string;
+    task: TaskV1;
+    envelope: Record<string, unknown>;
+} | {
+    ok: false;
+    endpoint?: string;
+    refused: string;
+    status?: number;
+    task?: TaskV1;
+};
+/**
+ * The hop: fetch the card, take its 1.0 endpoint, send ONE message, read the artifact. A task that ended
+ * without the artifact is relayed in the receiver's status words (a rejection, a need), never retried.
+ */
+export declare function sendSubjectAskOverWire(input: SubjectHopInput): Promise<SubjectHopOutcome>;
+/** The message that delivers a finished routed act's outcome to the creditor's agent. */
+export declare function subjectAnswerMessage(answer: SubjectAnswerV1): MessageV1;
+/** The delivered answer a received message carries, structurally checked; null when it carries none. */
+export declare function subjectAnswerOf(message: Pick<MessageV1, 'metadata'>): {
+    answer: SubjectAnswerV1;
+} | {
+    errors: string[];
+} | null;
+export declare function handoffMessage(h: HandoffV1): MessageV1;
+export declare function handoffOf(message: Pick<MessageV1, 'metadata'>): {
+    handoff: HandoffV1;
+} | {
+    errors: string[];
+} | null;
+//# sourceMappingURL=subject-hop.d.ts.map

package/dist/subject-hop.d.ts.map

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

package/dist/subject-hop.js

@@ -0,0 +1,170 @@
+// A ROUTED ASK ACROSS DEPLOYMENTS — spec 366 R4 / 374 §4 / 376. Promoted from the runtime app in spec 399 W0
+// (§4): the HOP is protocol, every A2A service that routes a step to another agent makes it the same way.
+//
+// Inside one deployment a routed step (spec 366 R1) is made in-process. To an agent served ELSEWHERE the hop
+// is a network call, and it rides the one wire there is (spec 372 S4): an A2A 1.0 `SendMessage` whose
+// `message.metadata` carries the SUBJECT-ASK PROFILE (`SubjectAskV1`), and whose reply comes back as the
+// task's `subject-answer` artifact — the receiver's own ask envelope, verbatim.
+//
+// Resolved through the card, not assumed: the caller says where the card is served, and the CARD says where
+// the agent takes A2A 1.0 requests. A card that publishes no such interface is an agent that cannot be asked
+// this way, and the sender says so — it never reads the subject's records locally instead (R3), and it never
+// guesses a path (ADR-0013).
+//
+// Everything here is pure: the caller supplies `fetch`; nothing reads a store or a chain.
+import { AP_SUBJECT_ASK_EXTENSION_URI, validateSubjectAsk } from './subject-ask.js';
+import { AP_HANDOFF_EXTENSION_URI, validateHandoff } from './handoff.js';
+/** The A2A 1.0 JSON-RPC endpoint a card publishes, or null when it publishes none. */
+export function a2aEndpointOf(card) {
+    // A RELEASED card (the Studio's, signed) states the protocol version ONCE at the top; the live card
+    // states it per interface. Either says 1.x or the interface is not one this hop can use.
+    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)) && typeof i.url === 'string' && /^https:\/\//.test(i.url));
+    return hit?.url ?? null;
+}
+const hex32 = () => `0x${[...crypto.getRandomValues(new Uint8Array(32))].map((b) => b.toString(16).padStart(2, '0')).join('')}`;
+/** The message that carries a subject-ask over the wire: the goal as text, the profile as metadata. */
+export function subjectAskMessage(profile) {
+    return {
+        messageId: hex32(),
+        role: 'ROLE_USER',
+        parts: [{ text: profile.request.goal }],
+        extensions: [AP_SUBJECT_ASK_EXTENSION_URI],
+        metadata: { [AP_SUBJECT_ASK_EXTENSION_URI]: profile },
+    };
+}
+/** The subject-ask a received message carries, validated; null when it carries none. */
+export function subjectAskOf(message) {
+    const raw = message.metadata?.[AP_SUBJECT_ASK_EXTENSION_URI];
+    if (raw === undefined)
+        return null;
+    const v = validateSubjectAsk(raw);
+    return v.ok ? { ask: v.ask } : { errors: v.errors };
+}
+export const SUBJECT_ANSWER_ARTIFACT = 'subject-answer';
+/**
+ * Appendix M8 — THE RECEIVER'S RUN, NAMED BY THE SENDER. A routed step's run at the subject's agent is
+ * addressable before it answers, so the sender can read its progress while it runs and its record can
+ * cite it by reference. Derived from the correlation the sender minted; the receiver adopts it for a
+ * fresh ask (a resume names the run it continues instead).
+ */
+export function routedRunRefFor(correlation) {
+    return `routed-${correlation.runRef}-${correlation.stepRef}`.replace(/[^A-Za-z0-9._:-]/g, '_');
+}
+/** The receiver's `/harness/ask` envelope, as the task's `subject-answer` artifact carries it. */
+export function subjectEnvelopeOf(task) {
+    const art = (task?.artifacts ?? []).find((a) => a.name === SUBJECT_ANSWER_ARTIFACT);
+    const part = art?.parts.find((p) => p.data && typeof p.data === 'object' && !Array.isArray(p.data));
+    return part ? part.data : null;
+}
+/**
+ * The hop: fetch the card, take its 1.0 endpoint, send ONE message, read the artifact. A task that ended
+ * without the artifact is relayed in the receiver's status words (a rejection, a need), never retried.
+ */
+export async function sendSubjectAskOverWire(input) {
+    let card = null;
+    try {
+        const res = await input.fetch(input.cardUrl, { method: 'GET', headers: { accept: 'application/json' } });
+        if (!res.ok)
+            return { ok: false, refused: `its card at ${input.cardUrl} answered ${res.status}`, status: res.status };
+        const text = await res.text();
+        if (input.pinnedDigest) {
+            const served = `0x${[...new Uint8Array(await crypto.subtle.digest('SHA-256', new TextEncoder().encode(text)))].map((b) => b.toString(16).padStart(2, '0')).join('')}`;
+            if (served !== input.pinnedDigest.toLowerCase())
+                return { ok: false, refused: `the card served at ${input.cardUrl} is not the one its name pins (atl:cardDigest ${input.pinnedDigest.slice(0, 12)}…, served ${served.slice(0, 12)}…)` };
+        }
+        card = JSON.parse(text);
+    }
+    catch (e) {
+        return { ok: false, refused: `its card at ${input.cardUrl} could not be read: ${e instanceof Error ? e.message : String(e)}` };
+    }
+    const endpoint = a2aEndpointOf(card);
+    if (!endpoint)
+        return { ok: false, refused: 'its card publishes no A2A 1.0 endpoint this agent can ask' };
+    const rpc = { jsonrpc: '2.0', id: 1, method: 'SendMessage', params: { message: subjectAskMessage(input.profile) } };
+    let res;
+    try {
+        res = await input.fetch(endpoint, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json', accept: 'application/json', 'a2a-version': '1.0', ...(input.session ? { authorization: `Bearer ${input.session}` } : {}), ...(input.traceparent ? { traceparent: input.traceparent } : {}), ...(input.tracestate ? { tracestate: input.tracestate } : {}) },
+            body: JSON.stringify(rpc),
+        });
+    }
+    catch (e) {
+        return { ok: false, endpoint, refused: `could not reach ${endpoint}: ${e instanceof Error ? e.message : String(e)}` };
+    }
+    const body = (await res.json().catch(() => null));
+    if (!body)
+        return { ok: false, endpoint, refused: `${endpoint} answered ${res.status} with no JSON-RPC body`, status: res.status };
+    if (body.error)
+        return { ok: false, endpoint, refused: `${endpoint} answered ${body.error.code}: ${body.error.message}`, status: res.status };
+    const task = body.result?.task;
+    if (!task)
+        return { ok: false, endpoint, refused: `${endpoint} answered with a message, not a task`, status: res.status };
+    const envelope = subjectEnvelopeOf(task);
+    if (envelope)
+        return { ok: true, endpoint, task, envelope };
+    const said = (task.status?.message?.parts ?? []).map((p) => (typeof p.text === 'string' ? p.text : '')).filter(Boolean).join(' ');
+    return { ok: false, endpoint, task, refused: `${task.status?.state ?? 'unknown state'}${said ? `: ${said}` : ''}`, status: res.status };
+}
+// ── The answer, delivered (spec 374 §4) ──────────────────────────────────────────────────────────────
+//
+// When a routed ACT finishes at the subject's agent — its steward signed, or refused — the outcome is
+// DELIVERED to the creditor's agent as a message under the same extension URI: a `SubjectAnswerV1` whose
+// `inResponseTo` names the creditor's own correlation. The two payloads share a URI and are told apart
+// by shape (an ask has `request`; an answer has `inResponseTo`), so one metadata key carries both halves
+// of one conversation.
+const isAddr = (v) => typeof v === 'string' && /^0x[0-9a-fA-F]{40}$/.test(v);
+/** The message that delivers a finished routed act's outcome to the creditor's agent. */
+export function subjectAnswerMessage(answer) {
+    return {
+        messageId: hex32(),
+        role: 'ROLE_AGENT',
+        parts: [{ text: answer.said ?? (answer.outcome === 'answer' ? 'Done.' : answer.outcome) }],
+        extensions: [AP_SUBJECT_ASK_EXTENSION_URI],
+        metadata: { [AP_SUBJECT_ASK_EXTENSION_URI]: answer },
+    };
+}
+/** The delivered answer a received message carries, structurally checked; null when it carries none. */
+export function subjectAnswerOf(message) {
+    const raw = message.metadata?.[AP_SUBJECT_ASK_EXTENSION_URI];
+    if (raw === undefined || raw === null || typeof raw !== 'object' || !('inResponseTo' in raw))
+        return null;
+    const errors = [];
+    if (raw.extension !== AP_SUBJECT_ASK_EXTENSION_URI)
+        errors.push(`extension: expected ${AP_SUBJECT_ASK_EXTENSION_URI}`);
+    if (raw.version !== 1)
+        errors.push('version: expected 1');
+    if (!isAddr(raw.agent))
+        errors.push('agent: an address');
+    const r = raw.inResponseTo;
+    if (!r || !['operationId', 'runRef', 'stepRef'].every((k) => typeof r[k] === 'string' && r[k]))
+        errors.push('inResponseTo: { operationId, runRef, stepRef }');
+    if (!['answer', 'refused', 'needs', 'error'].includes(String(raw.outcome)))
+        errors.push('outcome: answer | refused | needs | error');
+    if (!raw.run || typeof raw.run.runRef !== 'string')
+        errors.push('run.runRef: required');
+    return errors.length ? { errors } : { answer: raw };
+}
+// ── The hand-off (spec 376) ───────────────────────────────────────────────────────────────────────────
+//
+// One step, run elsewhere under a child mandate. Rides the one wire as a `SendMessage` whose metadata
+// carries the hand-off profile; the specialist answers with the same `subject-answer` artifact a routed
+// ask does, so the parent reads it with the same reader.
+export function handoffMessage(h) {
+    return {
+        messageId: hex32(),
+        role: 'ROLE_USER',
+        parts: [{ text: h.intent.goal }],
+        extensions: [AP_HANDOFF_EXTENSION_URI],
+        metadata: { [AP_HANDOFF_EXTENSION_URI]: h },
+    };
+}
+export function handoffOf(message) {
+    const raw = message.metadata?.[AP_HANDOFF_EXTENSION_URI];
+    if (raw === undefined)
+        return null;
+    const v = validateHandoff(raw);
+    return v.ok ? { handoff: v.handoff } : { errors: v.errors };
+}
+//# sourceMappingURL=subject-hop.js.map

package/dist/subject-hop.js.map

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