@aeolus-fleet/gateway 0.29.1 → 0.30.0

package/dist/core/a2a-out/follow-agent-task.js.map

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

package/dist/core/a2a-out/hand-a2a-message.d.ts

@@ -0,0 +1,36 @@
+import { type HandOutcome, type PushedDelivery } from '../mcp-out/hand-call.js';
+import type { A2aAgentParty } from '../parties/party.js';
+import type { PartyStore } from '../parties/ports.js';
+import type { Clock } from '../shared/clock.js';
+import type { AgentEndpoint } from './agent-endpoint.js';
+import type { FollowAgentTask } from './follow-agent-task.js';
+import type { A2aAgents, AgentCalls, AgentKeys, AgentShipCrew, GatewayStatuses } from './ports.js';
+export type HandA2aMessage = (input: {
+    party: A2aAgentParty;
+    endpoint: AgentEndpoint;
+    delivery: PushedDelivery;
+    signal: AbortSignal;
+}) => Promise<HandOutcome>;
+/**
+ * Use case: the gateway hands one delivery of an outside A2A agent's proxy
+ * ship to the agent (slice 6, flow 4.2): handed with the next number on
+ * channel a2a, then SendMessage under a messageId derived from the
+ * message, so the agent sees a message handed again as the same one. An
+ * answer that takes it is acknowledged, then its task followed until it
+ * ends; a message answer is replied and handled; a refusal is acknowledged,
+ * replied rejected and handled. With no answer, it is handed again when the
+ * agent is repeatable (A9), else reported not handled. An answer to a reply
+ * the gateway sent continues that reply's task. Each step is kept before
+ * the next, so a delivery that comes again picks up where it stopped.
+ */
+export declare function createHandA2aMessage(deps: {
+    crew: AgentShipCrew;
+    agents: A2aAgents;
+    calls: AgentCalls;
+    keys: AgentKeys;
+    statuses: GatewayStatuses;
+    parties: PartyStore;
+    follow: FollowAgentTask;
+    clock: Clock;
+    deadlineMs: number;
+}): HandA2aMessage;

package/dist/core/a2a-out/hand-a2a-message.js

@@ -0,0 +1,132 @@
+import { MAY_HAVE_RUN } from '../mcp-out/hand-call.js';
+import { replyContentOf } from './agent-event.js';
+import { outboundMessageOf } from './agent-message.js';
+/** The channel the gateway hands an outside agent's delivery through (interop 5.1). */
+const A2A_CHANNEL = 'a2a';
+const AGAIN = { kind: 'again' };
+/**
+ * Use case: the gateway hands one delivery of an outside A2A agent's proxy
+ * ship to the agent (slice 6, flow 4.2): handed with the next number on
+ * channel a2a, then SendMessage under a messageId derived from the
+ * message, so the agent sees a message handed again as the same one. An
+ * answer that takes it is acknowledged, then its task followed until it
+ * ends; a message answer is replied and handled; a refusal is acknowledged,
+ * replied rejected and handled. With no answer, it is handed again when the
+ * agent is repeatable (A9), else reported not handled. An answer to a reply
+ * the gateway sent continues that reply's task. Each step is kept before
+ * the next, so a delivery that comes again picks up where it stopped.
+ */
+export function createHandA2aMessage(deps) {
+    return async ({ party, endpoint, delivery, signal }) => {
+        const { crewToken, fleetId } = party;
+        if (crewToken === null) {
+            return AGAIN;
+        }
+        const caller = { fleetId, party: party.name };
+        /**
+         * Replies once, under a key of the delivery and what it says, then acknowledges and handles it. The agent's
+         * answer is kept first, so a delivery that comes again after a lost acknowledgement sends the same reply and
+         * is handled, never judged as one that may have run.
+         */
+        const answered = async (call, event) => {
+            if (call !== undefined && call.state !== 'answered') {
+                await deps.calls.save({ ...call, state: 'answered', answer: event });
+            }
+            const steps = [
+                () => deps.crew.send(crewToken, { to: delivery.senderShipId, inReplyTo: delivery.messageId, contentType: event.contentType, payload: event.payload, idempotencyKey: deps.keys.replyKeyOf(fleetId, { taskId: delivery.messageId, event: event.key }) }),
+                () => deps.crew.ack(crewToken, delivery.deliveryId),
+                () => deps.crew.handled(crewToken, delivery.deliveryId),
+            ];
+            for (const step of steps) {
+                if (!(await step()).isOk) {
+                    return AGAIN;
+                }
+            }
+            if (call !== undefined) {
+                await deps.calls.save({ ...call, state: 'done' });
+            }
+            return { kind: 'handled' };
+        };
+        const repliedEvent = (call, event) => answered(call, { ...replyContentOf(event), key: event.json });
+        const mayHaveRun = async (call) => {
+            await deps.calls.save({ ...call, state: 'mayHaveRun' });
+            // A refused report leaves the call judged: it is reported again each time it comes, and never sent again.
+            await deps.crew.notHandled(crewToken, { deliveryId: delivery.deliveryId, reason: MAY_HAVE_RUN });
+            return { kind: 'notHandled' };
+        };
+        const followed = async (call, events) => {
+            if (!(await deps.crew.ack(crewToken, delivery.deliveryId)).isOk) {
+                return AGAIN;
+            }
+            return deps.follow({ party, endpoint, call, signal, events });
+        };
+        const kept = await deps.calls.find(caller, delivery.deliveryId);
+        if (kept?.state === 'mayHaveRun') {
+            return mayHaveRun(kept);
+        }
+        if (kept?.state === 'answered' && kept.answer !== null) {
+            return answered(kept, kept.answer);
+        }
+        if (kept?.state === 'following') {
+            return followed(kept, []);
+        }
+        if (kept?.state === 'done') {
+            return (await deps.crew.handled(crewToken, delivery.deliveryId)).isOk ? { kind: 'handled' } : AGAIN;
+        }
+        const continued = delivery.inReplyTo === null ? undefined : await deps.calls.taskOfReply(caller, delivery.inReplyTo);
+        const call = kept ?? {
+            deliveryId: delivery.deliveryId,
+            fleetId,
+            party: party.name,
+            messageId: delivery.messageId,
+            senderShipId: delivery.senderShipId,
+            state: 'sending',
+            taskId: continued?.taskId ?? null,
+            contextId: continued?.contextId ?? null,
+            deadlineAt: new Date(deps.clock.now().getTime() + deps.deadlineMs),
+            answer: null,
+            replied: [],
+            chunkPlaces: {},
+        };
+        const message = outboundMessageOf(delivery, { messageId: deps.keys.messageIdOf(fleetId, delivery.messageId), taskId: call.taskId, contextId: call.contextId });
+        if (!message.isOk) {
+            return answered(undefined, { contentType: 'text/plain', payload: message.error.message, key: message.error.message });
+        }
+        // The mark as it is now, not as the worker found the party: an approver may mark the agent while it runs.
+        const now = await deps.parties.find(fleetId, party.name);
+        const isRepeatable = now?.kind === 'a2aAgent' ? now.isRepeatable : party.isRepeatable;
+        // Handed before with no answer kept and not judged unsent: the gateway stopped mid send, so it may have run.
+        if (delivery.state === 'handed' && kept?.state !== 'notSent' && !isRepeatable) {
+            return mayHaveRun(call);
+        }
+        const handed = await deps.crew.handed(crewToken, { deliveryId: delivery.deliveryId, handOverNumber: (delivery.handOverNumber ?? 0) + 1, channel: A2A_CHANNEL });
+        if (!handed.isOk) {
+            return AGAIN;
+        }
+        if (handed.value === 'undeliverable') {
+            return { kind: 'undeliverable' };
+        }
+        const sending = { ...call, state: 'sending' };
+        await deps.calls.save(sending);
+        const outcome = await deps.agents.send({ endpoint, credential: party.credential }, message.value);
+        switch (outcome.kind) {
+            case 'task': {
+                const following = { ...sending, state: 'following', taskId: outcome.taskId, contextId: outcome.contextId };
+                await deps.calls.save(following);
+                return followed(following, outcome.events);
+            }
+            case 'message':
+                return repliedEvent(sending, outcome.event);
+            case 'refused': {
+                const rejected = deps.statuses.statusOf({ taskId: call.taskId ?? '', contextId: call.contextId ?? '', state: 'rejected', reason: outcome.reason, messageId: deps.keys.replyKeyOf(fleetId, { taskId: delivery.messageId, event: outcome.reason }) });
+                return repliedEvent(sending, rejected);
+            }
+            case 'notSent':
+                await deps.calls.save({ ...sending, state: 'notSent' });
+                return AGAIN;
+            case 'unanswered':
+                return isRepeatable ? AGAIN : mayHaveRun(sending);
+        }
+    };
+}
+//# sourceMappingURL=hand-a2a-message.js.map

package/dist/core/a2a-out/hand-a2a-message.js.map

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

package/dist/core/a2a-out/mark-a2a-agent.d.ts

@@ -0,0 +1,24 @@
+import type { Actor } from '../actors/authenticate-actor.js';
+import type { PartyStore } from '../parties/ports.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { StateA2aAgent } from './state-a2a-agent.js';
+export type MarkA2aAgentRefusal = DomainError<'NOT_AN_APPROVER' | 'NO_SUCH_PARTY'>;
+export type MarkA2aAgent = (input: {
+    actor: Actor;
+    name: string;
+    isRepeatable: boolean;
+}) => Promise<Result<{
+    isRepeatable: boolean; /** Why the proxy ship's statement waits for its next one; none when the fleet sees the mark now. */
+    statementRefusal: string | null;
+}, MarkA2aAgentRefusal>>;
+/**
+ * Use case: an actor holding gateway:approve marks an outside A2A agent not
+ * repeatable, or repeatable again (A9): the whole agent, as A2A names no
+ * call apart from its message. The mark is kept first, then the proxy ship
+ * is stated anew; while it cannot be, the mark waits for its next statement.
+ */
+export declare function createMarkA2aAgent(deps: {
+    parties: PartyStore;
+    stateA2aAgent: StateA2aAgent;
+}): MarkA2aAgent;

package/dist/core/a2a-out/mark-a2a-agent.js

@@ -0,0 +1,24 @@
+import { APPROVING_SCOPE } from '../parties/approver.js';
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+/**
+ * Use case: an actor holding gateway:approve marks an outside A2A agent not
+ * repeatable, or repeatable again (A9): the whole agent, as A2A names no
+ * call apart from its message. The mark is kept first, then the proxy ship
+ * is stated anew; while it cannot be, the mark waits for its next statement.
+ */
+export function createMarkA2aAgent(deps) {
+    return async ({ actor, name, isRepeatable }) => {
+        if (!actor.scopes.includes(APPROVING_SCOPE)) {
+            return refuse('NOT_AN_APPROVER', `Marking an outside A2A agent needs ${APPROVING_SCOPE}`);
+        }
+        const party = await deps.parties.find(actor.fleetId, name);
+        if (party?.kind !== 'a2aAgent') {
+            return refuse('NO_SUCH_PARTY', `There is no outside A2A agent ${name}`);
+        }
+        await deps.parties.save({ ...party, isRepeatable });
+        const stated = await deps.stateA2aAgent({ fleetId: actor.fleetId, name });
+        return ok({ isRepeatable, statementRefusal: stated.isOk ? null : stated.error.message });
+    };
+}
+//# sourceMappingURL=mark-a2a-agent.js.map

package/dist/core/a2a-out/mark-a2a-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-a2a-agent.js","sourceRoot":"","sources":["../../../src/core/a2a-out/mark-a2a-agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAStD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA2D;IAC5F,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE;QAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC5C,OAAO,MAAM,CAAC,iBAAiB,EAAE,sCAAsC,eAAe,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3D,IAAI,KAAK,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC,eAAe,EAAE,iCAAiC,IAAI,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/a2a-out/ports.d.ts

@@ -0,0 +1,200 @@
+/**
+ * The ports of A2A out: how the gateway reads an outside A2A agent's card,
+ * as the proto's AgentCard states it, keeping only what it uses (slice 5);
+ * and how it hands the agent a message and follows its task, keeping each
+ * call so a restart follows on and sends nothing twice (slice 6).
+ */
+import type { DeliveryId, FleetId, MessageId, ShipId } from '@aeolus-fleet/common';
+import type { CallSender } from '../mcp-in/ports.js';
+import type { ProxyShipCrew } from '../mcp-out/hand-call.js';
+import type { Result } from '../shared/result.js';
+import type { McpServerCredential } from '../vault/credential.js';
+import type { AgentEndpoint } from './agent-endpoint.js';
+import type { AgentEvent, ChunkPlaces } from './agent-event.js';
+import type { OutboundMessage } from './agent-message.js';
+/** An address the agent answers at, in one binding and one version of A2A. */
+export interface AgentInterface {
+    readonly url: string;
+    readonly protocolBinding: string;
+    readonly protocolVersion: string;
+}
+/** One thing the agent can do (A2A's AgentSkill): its media types, when it names its own. */
+export interface AgentSkill {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly inputModes: readonly string[];
+    readonly outputModes: readonly string[];
+}
+/** An outside A2A agent's public card. */
+export interface AgentCard {
+    readonly name: string;
+    readonly description: string;
+    readonly supportedInterfaces: readonly AgentInterface[];
+    readonly defaultInputModes: readonly string[];
+    readonly defaultOutputModes: readonly string[];
+    /** Whether the card states streaming, so the gateway follows a task by SubscribeToTask. */
+    readonly isStreaming: boolean;
+    readonly skills: readonly AgentSkill[];
+}
+/** Why a card could not be read: nothing answered with one, or what answered is no AgentCard. */
+export type CardFailure = {
+    kind: 'UNREACHABLE';
+    reason: string;
+} | {
+    kind: 'NOT_A_CARD';
+    reason: string;
+};
+export interface AgentCards {
+    /** The card at its address, read with no credential, as a public card is. */
+    read(cardUrl: string): Promise<Result<AgentCard, CardFailure>>;
+}
+/** Where and how the gateway calls an agent: its endpoint, and the credential from the vault. */
+export interface AgentConnection {
+    readonly endpoint: AgentEndpoint;
+    readonly credential: McpServerCredential;
+}
+/**
+ * How SendMessage ended (6):
+ * - task: the agent took it as a task, with what it tells of it so far;
+ * - message: the agent answered with a message and no task;
+ * - refused: an A2A error or an HTTP 4xx, so it did not run;
+ * - notSent: the gateway never reached the agent (its credential could not be had), so it did not run;
+ * - unanswered: a 5xx, a timeout or a broken connection: whether it ran is unknown.
+ */
+export type SendOutcome = {
+    readonly kind: 'task';
+    readonly taskId: string;
+    readonly contextId: string;
+    readonly events: readonly AgentEvent[];
+} | {
+    readonly kind: 'message';
+    readonly event: AgentEvent;
+} | {
+    readonly kind: 'refused';
+    readonly reason: string;
+} | {
+    readonly kind: 'notSent';
+    readonly reason: string;
+} | {
+    readonly kind: 'unanswered';
+    readonly reason: string;
+};
+/** GetTask: the task as it stands, its status and each artifact; gone when the agent knows it no more; refused (an A2A error or an HTTP 4xx); or no answer. */
+export type TaskRead = {
+    readonly kind: 'read';
+    readonly events: readonly AgentEvent[];
+} | {
+    readonly kind: 'gone';
+    readonly reason: string;
+} | {
+    readonly kind: 'refused';
+    readonly reason: string;
+} | {
+    readonly kind: 'unanswered';
+    readonly reason: string;
+};
+/** How a SubscribeToTask stream ended: the agent closed it, the task is gone, the agent refused it (as it does for a task that ended), or it broke. */
+export type SubscriptionEnd = {
+    readonly kind: 'closed';
+} | {
+    readonly kind: 'gone';
+    readonly reason: string;
+} | {
+    readonly kind: 'refused';
+    readonly reason: string;
+} | {
+    readonly kind: 'broken';
+    readonly reason: string;
+};
+/** Outbound port: the outside A2A agents the gateway calls, through @a2a-js/sdk's client (A11). */
+export interface A2aAgents {
+    /** SendMessage, returning at once (return_immediately). */
+    send(connection: AgentConnection, message: OutboundMessage): Promise<SendOutcome>;
+    getTask(connection: AgentConnection, taskId: string): Promise<TaskRead>;
+    /** SubscribeToTask: each event the stream sends, in turn, until it ends, the timeout passes (broken) or the signal aborts. */
+    subscribe(connection: AgentConnection, follow: {
+        taskId: string;
+        timeoutMs: number;
+        signal: AbortSignal;
+        onEvent: (event: AgentEvent) => Promise<void>;
+    }): Promise<SubscriptionEnd>;
+}
+/** Outbound port: the A2A statuses the gateway itself tells of a task: failed at its deadline, rejected when the agent refused the message. */
+export interface GatewayStatuses {
+    statusOf(status: {
+        taskId: string;
+        contextId: string;
+        state: 'failed' | 'rejected';
+        reason: string;
+        messageId: string;
+    }): AgentEvent;
+}
+/** Outbound port: the ids the gateway derives, so the same message and event always get the same ones. */
+export interface AgentKeys {
+    /** The A2A messageId the agent gets for a fleet message: stable, so a message handed again is the same to the agent. */
+    messageIdOf(fleetId: FleetId, messageId: MessageId): string;
+    /** The idempotency key of a reply: the same event of the same task is one reply. */
+    replyKeyOf(fleetId: FleetId, of: {
+        taskId: string;
+        event: string;
+    }): string;
+}
+/**
+ * What the gateway keeps of a message to an outside agent, so a restart never sends again what may have run, and follows on:
+ * - sending: handed, and SendMessage sent or about to be;
+ * - notSent: the agent was not reached, so nothing ran;
+ * - answered: the agent answered with a message or refused it; the reply kept, then sent, acknowledged and handled;
+ * - following: the agent took it as its task; acknowledged, and followed until it ends;
+ * - mayHaveRun: sent with no answer, and the agent is not repeatable;
+ * - done: handled.
+ */
+export interface AgentCall {
+    readonly deliveryId: DeliveryId;
+    readonly fleetId: FleetId;
+    readonly party: string;
+    readonly messageId: MessageId;
+    readonly senderShipId: ShipId;
+    readonly state: 'sending' | 'notSent' | 'answered' | 'following' | 'mayHaveRun' | 'done';
+    /** The agent's task: the one a follow-up continues while sending, its own once it took it. */
+    readonly taskId: string | null;
+    readonly contextId: string | null;
+    /** When the gateway gives up following and replies failed (the gateway's timing). */
+    readonly deadlineAt: Date;
+    /** The reply to the agent's answer, once it answered with a message or refused: sent again as the same reply when the delivery comes again. */
+    readonly answer: AgentAnswer | null;
+    /** What each reply of the follow was, by the event's identity: kept, so a restart sends none again. */
+    readonly replied: readonly string[];
+    /** Where the next chunk of each artifact goes, as the replies so far leave it. */
+    readonly chunkPlaces: ChunkPlaces;
+}
+/** A reply as the gateway sends it: its content, and what its idempotency key derives from. */
+export interface AgentAnswer {
+    readonly contentType: string;
+    readonly payload: string;
+    readonly key: string;
+}
+interface Caller {
+    fleetId: FleetId;
+    party: string;
+}
+/** Outbound port: the gateway's messages to outside agents, by delivery, and which task each reply it sent tells of. */
+export interface AgentCalls {
+    find(caller: Caller, deliveryId: DeliveryId): Promise<AgentCall | undefined>;
+    save(call: AgentCall): Promise<void>;
+    /** The party's calls whose task is still followed. */
+    following(caller: Caller): Promise<AgentCall[]>;
+    /** Keeps that this reply tells of this task, so an answer to it continues the task. */
+    saveReply(caller: Caller, reply: {
+        messageId: MessageId;
+        taskId: string;
+        contextId: string;
+    }): Promise<void>;
+    taskOfReply(caller: Caller, messageId: MessageId): Promise<{
+        taskId: string;
+        contextId: string;
+    } | undefined>;
+}
+/** Outbound port: the fleet's calls an outside agent's proxy ship's crew makes; a reply is a send that answers its message id. */
+export type AgentShipCrew = Pick<ProxyShipCrew, 'pushReceive' | 'handed' | 'ack' | 'handled' | 'notHandled'> & CallSender;
+export {};

package/dist/core/a2a-out/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/core/a2a-out/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/core/a2a-out/ports.ts"],"names":[],"mappings":""}

package/dist/core/a2a-out/read-agent-statement.d.ts

@@ -0,0 +1,13 @@
+import type { Statement, CallTiming } from '../mcp-out/statement.js';
+import { type DomainError } from '../shared/errors.js';
+import type { Result } from '../shared/result.js';
+import type { AgentCards } from './ports.js';
+/** The statement of an outside A2A agent's proxy ship from its card as read now: refused when the card does not answer, is no AgentCard or makes no valid statement. */
+export declare function readAgentStatement(deps: {
+    cards: AgentCards;
+    timing: CallTiming;
+}, agent: {
+    name: string;
+    cardUrl: string;
+    isRepeatable: boolean;
+}): Promise<Result<Statement, DomainError<'CARD_UNREACHABLE' | 'CARD_INVALID'>>>;

package/dist/core/a2a-out/read-agent-statement.js

@@ -0,0 +1,13 @@
+import { refuse } from '../shared/errors.js';
+import { agentStatementOf } from './agent-statement.js';
+/** The statement of an outside A2A agent's proxy ship from its card as read now: refused when the card does not answer, is no AgentCard or makes no valid statement. */
+export async function readAgentStatement(deps, agent) {
+    const card = await deps.cards.read(agent.cardUrl);
+    if (!card.isOk) {
+        return card.error.kind === 'UNREACHABLE'
+            ? refuse('CARD_UNREACHABLE', `The card of ${agent.name} could not be read: ${card.error.reason}`)
+            : refuse('CARD_INVALID', `The card address of ${agent.name} answers no agent card: ${card.error.reason}`);
+    }
+    return agentStatementOf({ partyName: agent.name, card: card.value, isRepeatable: agent.isRepeatable, timing: deps.timing });
+}
+//# sourceMappingURL=read-agent-statement.js.map

package/dist/core/a2a-out/read-agent-statement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-agent-statement.js","sourceRoot":"","sources":["../../../src/core/a2a-out/read-agent-statement.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,wKAAwK;AACxK,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAA+C,EAC/C,KAA+D;IAE/D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa;YACtC,CAAC,CAAC,MAAM,CAAC,kBAAkB,EAAE,eAAe,KAAK,CAAC,IAAI,uBAAuB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACjG,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,uBAAuB,KAAK,CAAC,IAAI,2BAA2B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,gBAAgB,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9H,CAAC"}

package/dist/core/a2a-out/run-a2a-agent.d.ts

@@ -0,0 +1,26 @@
+import { type RunPartyOf, type Sleep } from '../mcp-out/run-party.js';
+import type { A2aAgentParty } from '../parties/party.js';
+import type { FollowAgentTask } from './follow-agent-task.js';
+import type { HandA2aMessage } from './hand-a2a-message.js';
+import type { AgentCalls, AgentCards, AgentShipCrew } from './ports.js';
+export type RunA2aAgent = RunPartyOf<A2aAgentParty>;
+/**
+ * Use case: the gateway takes the messages of an outside A2A agent's proxy
+ * ship, as its crew, until it is stopped (slice 6, flow 4.2). The card is
+ * read at the start for where the agent is called: the first interface the
+ * gateway calls, followed by SubscribeToTask when it states streaming.
+ * While the card cannot be read or names no such interface, no message is
+ * taken and the card is read again after a wait. The tasks followed when
+ * the gateway stopped are followed first, each in flight as its delivery.
+ */
+export declare function createRunA2aAgent(deps: {
+    cards: AgentCards;
+    crew: Pick<AgentShipCrew, 'pushReceive'>;
+    hand: HandA2aMessage;
+    follow: FollowAgentTask;
+    calls: AgentCalls;
+    sleep: Sleep;
+    pollMs: number;
+    againWaitsMs: readonly number[];
+    cardWaitMs: number;
+}): RunA2aAgent;

package/dist/core/a2a-out/run-a2a-agent.js

@@ -0,0 +1,46 @@
+import { createRunParty } from '../mcp-out/run-party.js';
+import { agentEndpointOf } from './agent-endpoint.js';
+/**
+ * Use case: the gateway takes the messages of an outside A2A agent's proxy
+ * ship, as its crew, until it is stopped (slice 6, flow 4.2). The card is
+ * read at the start for where the agent is called: the first interface the
+ * gateway calls, followed by SubscribeToTask when it states streaming.
+ * While the card cannot be read or names no such interface, no message is
+ * taken and the card is read again after a wait. The tasks followed when
+ * the gateway stopped are followed first, each in flight as its delivery.
+ */
+export function createRunA2aAgent(deps) {
+    const endpointOf = async (party, signal) => {
+        while (!signal.aborted) {
+            const card = await deps.cards.read(party.cardUrl);
+            const endpoint = card.isOk ? agentEndpointOf(card.value) : undefined;
+            if (endpoint !== undefined) {
+                return endpoint;
+            }
+            await deps.sleep(deps.cardWaitMs, signal);
+        }
+        return undefined;
+    };
+    return async ({ party, signal }) => {
+        if (party.crewToken === null) {
+            return { ended: 'crewRefused' };
+        }
+        const endpoint = await endpointOf(party, signal);
+        if (endpoint === undefined) {
+            return { ended: 'stopped' };
+        }
+        const run = createRunParty({
+            crew: deps.crew,
+            handCall: ({ delivery }) => deps.hand({ party, endpoint, delivery, signal }),
+            resume: async () => (await deps.calls.following({ fleetId: party.fleetId, party: party.name })).map((call) => ({
+                deliveryId: call.deliveryId,
+                hand: () => deps.follow({ party, endpoint, call, signal }),
+            })),
+            sleep: deps.sleep,
+            pollMs: deps.pollMs,
+            againWaitsMs: deps.againWaitsMs,
+        });
+        return run({ party, signal });
+    };
+}
+//# sourceMappingURL=run-a2a-agent.js.map

package/dist/core/a2a-out/run-a2a-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-a2a-agent.js","sourceRoot":"","sources":["../../../src/core/a2a-out/run-a2a-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA+B,MAAM,yBAAyB,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAsB,MAAM,qBAAqB,CAAC;AAO1E;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAUjC;IACC,MAAM,UAAU,GAAG,KAAK,EAAE,KAAoB,EAAE,MAAmB,EAAsC,EAAE;QACzG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACrE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACjC,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC7B,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,GAAG,GAAG,cAAc,CAAgB;YACxC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC5E,MAAM,EAAE,KAAK,IAAI,EAAE,CACjB,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACzF,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;aAC3D,CAAC,CAAC;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/a2a-out/state-a2a-agent.d.ts

@@ -0,0 +1,26 @@
+import type { FleetId } from '@aeolus-fleet/common';
+import type { StatementDoor } from '../mcp-out/state-party.js';
+import type { CallTiming } from '../mcp-out/statement.js';
+import type { PartyStore } from '../parties/ports.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { AgentCards } from './ports.js';
+export type StateA2aAgent = (input: {
+    fleetId: FleetId;
+    name: string;
+}) => Promise<Result<{
+    capabilities: string[];
+}, DomainError<'NO_SUCH_PARTY' | 'NOT_CREWED' | 'CARD_UNREACHABLE' | 'CARD_INVALID' | 'STATEMENT_REFUSED'>>>;
+/**
+ * Use case: the gateway states what an outside A2A agent's proxy ship
+ * offers, as its crew (slice 5): the skills of its card as read now, with
+ * the agent's repeatable mark (A9). The whole statement replaces the one
+ * before. A card that does not answer or is no longer valid states nothing,
+ * so the last statement stays.
+ */
+export declare function createStateA2aAgent(deps: {
+    parties: PartyStore;
+    cards: AgentCards;
+    door: StatementDoor;
+    timing: CallTiming;
+}): StateA2aAgent;

package/dist/core/a2a-out/state-a2a-agent.js

@@ -0,0 +1,31 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { readAgentStatement } from './read-agent-statement.js';
+/**
+ * Use case: the gateway states what an outside A2A agent's proxy ship
+ * offers, as its crew (slice 5): the skills of its card as read now, with
+ * the agent's repeatable mark (A9). The whole statement replaces the one
+ * before. A card that does not answer or is no longer valid states nothing,
+ * so the last statement stays.
+ */
+export function createStateA2aAgent(deps) {
+    return async ({ fleetId, name }) => {
+        const party = await deps.parties.find(fleetId, name);
+        if (party?.kind !== 'a2aAgent') {
+            return refuse('NO_SUCH_PARTY', `No A2A agent named ${name}`);
+        }
+        if (party.state !== 'crewed' || party.crewToken === null) {
+            return refuse('NOT_CREWED', `The gateway does not crew the proxy ship of ${name} yet`);
+        }
+        const statement = await readAgentStatement(deps, party);
+        if (!statement.isOk) {
+            return statement;
+        }
+        const stated = await deps.door.setStatement(party.crewToken, statement.value);
+        if (!stated.isOk) {
+            return refuse('STATEMENT_REFUSED', `The fleet refused the statement: ${stated.error.message}`);
+        }
+        return ok({ capabilities: statement.value.capabilities.map((capability) => capability.name) });
+    };
+}
+//# sourceMappingURL=state-a2a-agent.js.map

package/dist/core/a2a-out/state-a2a-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-a2a-agent.js","sourceRoot":"","sources":["../../../src/core/a2a-out/state-a2a-agent.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAM/D;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAyF;IAC3H,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC,eAAe,EAAE,sBAAsB,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YACzD,OAAO,MAAM,CAAC,YAAY,EAAE,+CAA+C,IAAI,MAAM,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC,mBAAmB,EAAE,oCAAoC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjG,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC,CAAC;AACJ,CAAC"}