@aeolus-fleet/gateway 0.29.1 → 0.30.0

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

@@ -0,0 +1,124 @@
+/**
+ * The ports of pushing an outside A2A client's task to its webhook (slice 4):
+ * where its push configs and the pushes still to make are kept, how a
+ * webhook's host resolves, how a push is POSTed, and how a task's change is
+ * written as the A2A events the webhook gets.
+ */
+import type { FleetId } from '@aeolus-fleet/common';
+import type { Result } from '../shared/result.js';
+import type { TaskView } from './task-view.js';
+/** What the webhook is called with besides its URL: the config's token, and its authentication, kept in the vault. */
+export interface WebhookCredentials {
+    token: string | null;
+    authentication: {
+        scheme: string;
+        credentials: string;
+    } | null;
+}
+/** A push config of an outside A2A client's task (TaskPushNotificationConfig): where and how each change of the task is pushed. */
+export interface PushConfig extends WebhookCredentials {
+    fleetId: FleetId;
+    party: string;
+    taskId: string;
+    id: string;
+    url: string;
+    createdAt: Date;
+    /** The task as last noticed, as `markOf` tells it; changes are pushed from there. */
+    noticedMark: string;
+    /** Whether the task is still followed: once it ended, nothing more is noticed. */
+    isFollowing: boolean;
+}
+interface Caller {
+    fleetId: FleetId;
+    party: string;
+}
+interface ConfigKey {
+    taskId: string;
+    id: string;
+}
+export interface PushConfigs {
+    /** Keeps the config, in place of one of the same task and id. */
+    save(config: PushConfig): Promise<void>;
+    find(caller: Caller, key: ConfigKey): Promise<PushConfig | undefined>;
+    /** The task's configs, oldest first, at most the limit after the cursor; the cursor of the next page, none at the end. */
+    list(caller: Caller, page: {
+        taskId: string;
+        limit: number;
+        after?: string;
+    }): Promise<{
+        configs: PushConfig[];
+        next: string | null;
+    }>;
+    /** Removes the config and the pushes still to make for it: whether there was one. */
+    remove(caller: Caller, key: ConfigKey): Promise<boolean>;
+    /** The party's configs whose task is still followed. */
+    following(caller: Caller): Promise<PushConfig[]>;
+    /** In one unit of work: the change noticed on the config, and a push still to make for each event, in order. */
+    notice(caller: Caller, change: ConfigKey & {
+        mark: string;
+        isFollowing: boolean;
+        events: string[];
+        at: Date;
+    }): Promise<void>;
+}
+/** A push still to make: one event of a config's task, POSTed to its webhook. */
+export interface Push {
+    pushId: string;
+    config: PushConfig;
+    /** The event as the webhook gets it: A2A JSON. */
+    body: string;
+    /** How many times it was POSTed already. */
+    attempts: number;
+}
+export interface Pushes {
+    /** The party's pushes due now: per config, its oldest still to make, once its time came; at most the limit. */
+    due(caller: Caller, page: {
+        now: Date;
+        limit: number;
+    }): Promise<Push[]>;
+    delivered(caller: Caller, push: {
+        pushId: string;
+        attempts: number;
+        at: Date;
+    }): Promise<void>;
+    /** Another attempt at the time given, after the attempts made. */
+    again(caller: Caller, push: {
+        pushId: string;
+        attempts: number;
+        at: Date;
+    }): Promise<void>;
+    /** No attempt more, with why. */
+    givenUp(caller: Caller, push: {
+        pushId: string;
+        attempts: number;
+        reason: string;
+        at: Date;
+    }): Promise<void>;
+}
+export interface HostResolver {
+    /** The addresses a host resolves to; none when it does not resolve. */
+    addressesOf(host: string): Promise<string[]>;
+}
+/** Why a POST got no answer: the host resolved to an address the webhook is not reached at, or nothing answered. */
+export type PostFailure = {
+    kind: 'ADDRESS_REFUSED';
+} | {
+    kind: 'UNREACHABLE';
+    message: string;
+};
+export interface WebhookPoster {
+    /** POSTs the body as JSON to the URL with the credentials, connecting only to a public address: the HTTP status it answered. */
+    post(url: string, push: {
+        body: string;
+    } & WebhookCredentials): Promise<Result<{
+        status: number;
+    }, PostFailure>>;
+}
+export interface PushEvents {
+    /** The events a webhook gets for the task as it stands now, as A2A JSON: a new artifact first, then the status. */
+    eventsOf(view: TaskView): string[];
+}
+export interface PushConfigIds {
+    newId(): string;
+}
+export {};

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

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

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

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

package/dist/core/a2a-in/push-config-view.d.ts

@@ -0,0 +1,8 @@
+import type { PushConfig } from './ports.js';
+/** A push config as its client reads it back: never its token or authentication, which stay in the vault. */
+export interface PushConfigView {
+    taskId: string;
+    id: string;
+    url: string;
+}
+export declare const pushConfigViewOf: (config: PushConfig) => PushConfigView;

package/dist/core/a2a-in/push-config-view.js

@@ -0,0 +1,2 @@
+export const pushConfigViewOf = (config) => ({ taskId: config.taskId, id: config.id, url: config.url });
+//# sourceMappingURL=push-config-view.js.map

package/dist/core/a2a-in/push-config-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-config-view.js","sourceRoot":"","sources":["../../../src/core/a2a-in/push-config-view.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAkB,EAAkB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC"}

package/dist/core/a2a-in/push-to-webhooks.d.ts

@@ -0,0 +1,19 @@
+import type { Sleep } from '../mcp-out/run-party.js';
+import type { A2aCaller } from './authenticate-a2a-client.js';
+import type { DeliverPushes } from './deliver-pushes.js';
+import type { NoticeTaskChanges } from './notice-task-changes.js';
+export type PushToWebhooks = (input: {
+    caller: A2aCaller;
+    signal: AbortSignal;
+}) => Promise<void>;
+/**
+ * Use case: an outside A2A client's pushes, round after round until stopped (slice 4): its tasks' changes noticed, then the pushes due delivered.
+ * A failure of the gateway's own (its database) is reported and the round is tried again after the poll: what was kept stays kept.
+ */
+export declare function createPushToWebhooks(deps: {
+    notice: NoticeTaskChanges;
+    deliver: DeliverPushes;
+    sleep: Sleep;
+    pollMs: number;
+    failed: (error: unknown) => void;
+}): PushToWebhooks;

package/dist/core/a2a-in/push-to-webhooks.js

@@ -0,0 +1,19 @@
+/**
+ * Use case: an outside A2A client's pushes, round after round until stopped (slice 4): its tasks' changes noticed, then the pushes due delivered.
+ * A failure of the gateway's own (its database) is reported and the round is tried again after the poll: what was kept stays kept.
+ */
+export function createPushToWebhooks(deps) {
+    return async ({ caller, signal }) => {
+        while (!signal.aborted) {
+            try {
+                await deps.notice(caller);
+                await deps.deliver(caller);
+            }
+            catch (error) {
+                deps.failed(error);
+            }
+            await deps.sleep(deps.pollMs, signal);
+        }
+    };
+}
+//# sourceMappingURL=push-to-webhooks.js.map

package/dist/core/a2a-in/push-to-webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-to-webhooks.js","sourceRoot":"","sources":["../../../src/core/a2a-in/push-to-webhooks.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAA2H;IAC9J,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAClC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/a2a-in/read-a2a-task.d.ts

@@ -0,0 +1,12 @@
+import type { ClientCalls } from '../mcp-in/ports.js';
+import type { Clock } from '../shared/clock.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { A2aCaller } from './authenticate-a2a-client.js';
+import { type TaskView } from './task-view.js';
+export type ReadA2aTask = (caller: A2aCaller, taskId: string) => Promise<Result<TaskView, DomainError<'TASK_NOT_FOUND'>>>;
+/** Use case: an outside A2A client reads one of its own tasks as it stands (GetTask); another party's is not found. */
+export declare function createReadA2aTask(deps: {
+    calls: Pick<ClientCalls, 'findTask'>;
+    clock: Clock;
+}): ReadA2aTask;

package/dist/core/a2a-in/read-a2a-task.js

@@ -0,0 +1,11 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { taskViewOf } from './task-view.js';
+/** Use case: an outside A2A client reads one of its own tasks as it stands (GetTask); another party's is not found. */
+export function createReadA2aTask(deps) {
+    return async (caller, taskId) => {
+        const task = await deps.calls.findTask(caller, taskId);
+        return task === undefined ? refuse('TASK_NOT_FOUND', `No task ${taskId}`) : ok(taskViewOf(task, deps.clock.now()));
+    };
+}
+//# sourceMappingURL=read-a2a-task.js.map

package/dist/core/a2a-in/read-a2a-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-a2a-task.js","sourceRoot":"","sources":["../../../src/core/a2a-in/read-a2a-task.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAiB,MAAM,gBAAgB,CAAC;AAI3D,uHAAuH;AACvH,MAAM,UAAU,iBAAiB,CAAC,IAA4D;IAC5F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvD,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACrH,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/a2a-in/read-push-config.d.ts

@@ -0,0 +1,16 @@
+import type { ClientCalls } from '../mcp-in/ports.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { A2aCaller } from './authenticate-a2a-client.js';
+import type { PushConfigs } from './ports.js';
+import { type PushConfigView } from './push-config-view.js';
+export type ReadPushConfig = (input: {
+    caller: A2aCaller;
+    taskId: string;
+    id: string;
+}) => Promise<Result<PushConfigView, DomainError<'TASK_NOT_FOUND' | 'PUSH_CONFIG_NOT_FOUND'>>>;
+/** Use case: an outside A2A client reads a push config of one of its own tasks (GetTaskPushNotificationConfig, slice 4), without its credentials. */
+export declare function createReadPushConfig(deps: {
+    calls: Pick<ClientCalls, 'findTask'>;
+    configs: Pick<PushConfigs, 'find'>;
+}): ReadPushConfig;

package/dist/core/a2a-in/read-push-config.js

@@ -0,0 +1,14 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { pushConfigViewOf } from './push-config-view.js';
+/** Use case: an outside A2A client reads a push config of one of its own tasks (GetTaskPushNotificationConfig, slice 4), without its credentials. */
+export function createReadPushConfig(deps) {
+    return async ({ caller, taskId, id }) => {
+        if ((await deps.calls.findTask(caller, taskId)) === undefined) {
+            return refuse('TASK_NOT_FOUND', `No task ${taskId}`);
+        }
+        const config = await deps.configs.find(caller, { taskId, id });
+        return config === undefined ? refuse('PUSH_CONFIG_NOT_FOUND', `No push config ${id} on the task ${taskId}`) : ok(pushConfigViewOf(config));
+    };
+}
+//# sourceMappingURL=read-push-config.js.map

package/dist/core/a2a-in/read-push-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-push-config.js","sourceRoot":"","sources":["../../../src/core/a2a-in/read-push-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAuB,MAAM,uBAAuB,CAAC;AAI9E,qJAAqJ;AACrJ,MAAM,UAAU,oBAAoB,CAAC,IAAkF;IACrH,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC9D,OAAO,MAAM,CAAC,gBAAgB,EAAE,WAAW,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/D,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,uBAAuB,EAAE,kBAAkB,EAAE,gBAAgB,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7I,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/a2a-in/remove-push-config.d.ts

@@ -0,0 +1,15 @@
+import type { ClientCalls } from '../mcp-in/ports.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { A2aCaller } from './authenticate-a2a-client.js';
+import type { PushConfigs } from './ports.js';
+export type RemovePushConfig = (input: {
+    caller: A2aCaller;
+    taskId: string;
+    id: string;
+}) => Promise<Result<undefined, DomainError<'TASK_NOT_FOUND'>>>;
+/** Use case: an outside A2A client removes a push config of one of its own tasks (DeleteTaskPushNotificationConfig, slice 4), and the pushes still to make for it. Removing one no longer there succeeds, so a delete sent again does. */
+export declare function createRemovePushConfig(deps: {
+    calls: Pick<ClientCalls, 'findTask'>;
+    configs: Pick<PushConfigs, 'remove'>;
+}): RemovePushConfig;

package/dist/core/a2a-in/remove-push-config.js

@@ -0,0 +1,13 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+/** Use case: an outside A2A client removes a push config of one of its own tasks (DeleteTaskPushNotificationConfig, slice 4), and the pushes still to make for it. Removing one no longer there succeeds, so a delete sent again does. */
+export function createRemovePushConfig(deps) {
+    return async ({ caller, taskId, id }) => {
+        if ((await deps.calls.findTask(caller, taskId)) === undefined) {
+            return refuse('TASK_NOT_FOUND', `No task ${taskId}`);
+        }
+        await deps.configs.remove(caller, { taskId, id });
+        return ok(undefined);
+    };
+}
+//# sourceMappingURL=remove-push-config.js.map

package/dist/core/a2a-in/remove-push-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-push-config.js","sourceRoot":"","sources":["../../../src/core/a2a-in/remove-push-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAMtD,0OAA0O;AAC1O,MAAM,UAAU,sBAAsB,CAAC,IAAoF;IACzH,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC9D,OAAO,MAAM,CAAC,gBAAgB,EAAE,WAAW,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAClD,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/a2a-in/send-a2a-message.d.ts

@@ -0,0 +1,34 @@
+import type { CallKeys, CallSender, ClientCalls } from '../mcp-in/ports.js';
+import type { Sleep } from '../mcp-out/run-party.js';
+import type { PartyStore } from '../parties/ports.js';
+import type { Clock } from '../shared/clock.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { A2aCaller } from './authenticate-a2a-client.js';
+import type { FindReachedShip, FindReachedShipRefusal } from './find-reached-ship.js';
+import { type InboundMessage } from './inbound-message.js';
+import { type TaskView } from './task-view.js';
+/** The most a payload holds (decision 0006). */
+export declare const PAYLOAD_MAX_BYTES = 65536;
+export type SendA2aMessageRefusal = FindReachedShipRefusal | DomainError<'PAYLOAD_TOO_LARGE' | 'TASK_NOT_FOUND' | 'TASK_TERMINAL' | 'CONTEXT_MISMATCH' | 'NOT_REACHABLE' | 'SEND_REFUSED'>;
+export type SendA2aMessage = (input: {
+    caller: A2aCaller;
+    alias: string;
+    message: InboundMessage;
+    isBlocking: boolean;
+}) => Promise<Result<TaskView, SendA2aMessageRefusal>>;
+interface SendA2aMessageDeps {
+    parties: Pick<PartyStore, 'find'>;
+    findReachedShip: FindReachedShip;
+    sender: CallSender;
+    calls: ClientCalls;
+    keys: CallKeys;
+    clock: Clock;
+    sleep: Sleep;
+    /** The most a send waits for its answer, whatever its capability states. */
+    waitMaxMs: number;
+    /** How often it reads the task while it waits. */
+    waitPollMs: number;
+}
+export declare function createSendA2aMessage(deps: SendA2aMessageDeps): SendA2aMessage;
+export {};

package/dist/core/a2a-in/send-a2a-message.js

@@ -0,0 +1,106 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { capabilityFor, contentOf } from './inbound-message.js';
+import { isTerminal, taskViewOf } from './task-view.js';
+/** The most a payload holds (decision 0006). */
+export const PAYLOAD_MAX_BYTES = 65_536;
+/** No signal ends a wait early: it is bounded by its own time. */
+const UNENDING = new AbortController().signal;
+function refusalOf(refused) {
+    switch (refused.code) {
+        // No reason why, and no ship named: the fleet's network rules are not the outside's to read.
+        case 'NOT_REACHABLE':
+            return refuse('NOT_REACHABLE', 'This client may not send to this agent now');
+        case 'UNAVAILABLE':
+            return refuse('FLEET_UNAVAILABLE', 'The message was not answered, so it may have been sent: send it again with the same messageId to send it at most once');
+        default:
+            return refuse('SEND_REFUSED', 'The message was refused');
+    }
+}
+/** The message the follow-up replies to: the task's latest reply, or its latest message while none came. */
+function inReplyToOf(task) {
+    const replies = task.calls.flatMap((call) => call.replies).sort((left, right) => left.receivedAt.getTime() - right.receivedAt.getTime());
+    return replies.at(-1)?.messageId ?? task.calls.at(-1)?.messageId;
+}
+export function createSendA2aMessage(deps) {
+    /** The task as it stands once its answer came or the wait passed, read after each poll; it never sleeps past the wait's end. */
+    const answerWithin = async (sent) => {
+        const waitEnd = sent.since.getTime() + Math.min(sent.waitMs, deps.waitMaxMs);
+        for (;;) {
+            const task = await deps.calls.findTask(sent.caller, sent.taskId);
+            const view = task === undefined ? undefined : taskViewOf(task, deps.clock.now());
+            const left = waitEnd - deps.clock.now().getTime();
+            if (view === undefined || (view.status.state !== 'submitted' && view.status.state !== 'working') || left <= 0) {
+                return view;
+            }
+            await deps.sleep(Math.min(deps.waitPollMs, left), UNENDING);
+        }
+    };
+    /** The task the message continues, if it names one: refused when it is not the caller's, not this ship's, ended, or of another context. */
+    const continued = async (caller, sent) => {
+        const { taskId, contextId } = sent.message;
+        if (taskId === undefined) {
+            return ok(undefined);
+        }
+        const task = await deps.calls.findTask(caller, taskId);
+        if (task === undefined || task.calls.at(-1)?.shipId !== sent.shipId) {
+            return refuse('TASK_NOT_FOUND', `No task ${taskId}`);
+        }
+        if (isTerminal(taskViewOf(task, deps.clock.now()))) {
+            return refuse('TASK_TERMINAL', `The task ${taskId} has ended: send a new message without its taskId`);
+        }
+        if (contextId !== undefined && contextId !== task.contextId) {
+            return refuse('CONTEXT_MISMATCH', `The task ${taskId} is in another context`);
+        }
+        return ok(task);
+    };
+    return async ({ caller, alias, message, isBlocking }) => {
+        const ship = await deps.findReachedShip({ ...caller, alias });
+        if (!ship.isOk) {
+            return ship;
+        }
+        const content = contentOf(message);
+        if (new TextEncoder().encode(content.payload).length > PAYLOAD_MAX_BYTES) {
+            return refuse('PAYLOAD_TOO_LARGE', 'The message is over 64 KB: send where its content lives instead');
+        }
+        const task = await continued(caller, { message, shipId: ship.value.shipId });
+        if (!task.isOk) {
+            return task;
+        }
+        const party = await deps.parties.find(caller.fleetId, caller.party);
+        if (party?.crewToken == null) {
+            return refuse('PARTY_NOT_CREWED', `The party ${caller.party} is not crewed`);
+        }
+        const { statement } = ship.value;
+        const capability = capabilityFor(statement?.by === 'crew' ? statement.capabilities : [], content.contentType);
+        const inReplyTo = task.value === undefined ? undefined : inReplyToOf(task.value);
+        const sent = await deps.sender.send(party.crewToken, {
+            to: ship.value.shipId,
+            ...content,
+            idempotencyKey: deps.keys.idempotencyKeyOf({ ...caller, key: message.messageId }),
+            ...(inReplyTo === undefined ? {} : { inReplyTo }),
+        });
+        if (!sent.isOk) {
+            return refusalOf(sent.error);
+        }
+        const { messageId } = sent.value;
+        const sentAt = deps.clock.now();
+        const taskId = task.value?.taskId ?? deps.keys.handleOf(caller.fleetId, messageId);
+        await deps.calls.saveTask({ ...caller, taskId, contextId: task.value?.contextId ?? message.contextId ?? deps.keys.contextIdOf(caller.fleetId, messageId), createdAt: sentAt });
+        await deps.calls.save({
+            ...caller,
+            messageId,
+            handle: deps.keys.handleOf(caller.fleetId, messageId),
+            shipId: ship.value.shipId,
+            capability: capability?.name ?? null,
+            outputContentType: capability?.outputModes?.[0] ?? null,
+            sentAt,
+            deadlineAt: capability?.deadlineMs === undefined ? null : new Date(sentAt.getTime() + capability.deadlineMs),
+            delivery: null,
+            task: { taskId, message: message.asJson },
+        });
+        const view = await answerWithin({ caller, taskId, since: sentAt, waitMs: isBlocking ? (capability?.waitMs ?? 0) : 0 });
+        return view === undefined ? refuse('TASK_NOT_FOUND', `No task ${taskId}`) : ok(view);
+    };
+}
+//# sourceMappingURL=send-a2a-message.js.map

package/dist/core/a2a-in/send-a2a-message.js.map

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

package/dist/core/a2a-in/set-push-config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Use case: an outside A2A client sets a push config on one of its own tasks
+ * (CreateTaskPushNotificationConfig, slice 4). Its webhook is an https URL
+ * reached only at public addresses, as its host resolves now. The config is
+ * kept with its token and authentication, in place of one of the same id,
+ * and the task is followed from as it stands: the changes after it are
+ * pushed. The client is answered the config without its credentials.
+ */
+import type { ClientCalls } from '../mcp-in/ports.js';
+import type { Clock } from '../shared/clock.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { A2aCaller } from './authenticate-a2a-client.js';
+import type { HostResolver, PushConfigIds, PushConfigs, WebhookCredentials } from './ports.js';
+import { type PushConfigView } from './push-config-view.js';
+export type SetPushConfig = (input: {
+    caller: A2aCaller;
+    config: {
+        taskId: string;
+        id?: string;
+        url: string;
+    } & WebhookCredentials;
+}) => Promise<Result<PushConfigView, DomainError<'TASK_NOT_FOUND' | 'WEBHOOK_REFUSED'>>>;
+export declare function createSetPushConfig(deps: {
+    calls: Pick<ClientCalls, 'findTask'>;
+    configs: Pick<PushConfigs, 'save'>;
+    resolver: HostResolver;
+    ids: PushConfigIds;
+    clock: Clock;
+}): SetPushConfig;

package/dist/core/a2a-in/set-push-config.js

@@ -0,0 +1,27 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { pushConfigViewOf } from './push-config-view.js';
+import { isTerminal, markOf, taskViewOf } from './task-view.js';
+import { reachOf } from './webhook-address.js';
+import { webhookUrlOf } from './webhook.js';
+export function createSetPushConfig(deps) {
+    return async ({ caller, config }) => {
+        const task = await deps.calls.findTask(caller, config.taskId);
+        if (task === undefined) {
+            return refuse('TASK_NOT_FOUND', `No task ${config.taskId}`);
+        }
+        const url = webhookUrlOf(config.url);
+        if (!url.isOk) {
+            return url;
+        }
+        if ((await reachOf(deps.resolver, url.value)) !== 'public') {
+            return refuse('WEBHOOK_REFUSED', 'The webhook must resolve to public addresses only');
+        }
+        const now = deps.clock.now();
+        const view = taskViewOf(task, now);
+        const kept = { ...caller, taskId: config.taskId, id: config.id ?? deps.ids.newId(), url: config.url, token: config.token, authentication: config.authentication, createdAt: now, noticedMark: markOf(view), isFollowing: !isTerminal(view) };
+        await deps.configs.save(kept);
+        return ok(pushConfigViewOf(kept));
+    };
+}
+//# sourceMappingURL=set-push-config.js.map

package/dist/core/a2a-in/set-push-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-push-config.js","sourceRoot":"","sources":["../../../src/core/a2a-in/set-push-config.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAuB,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,MAAM,UAAU,mBAAmB,CAAC,IAA4I;IAC9K,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC,gBAAgB,EAAE,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,MAAM,CAAC,iBAAiB,EAAE,mDAAmD,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7O,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/a2a-in/subscribe-to-a2a-task.d.ts

@@ -0,0 +1,18 @@
+import type { ClientCalls } from '../mcp-in/ports.js';
+import type { Clock } from '../shared/clock.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { A2aCaller } from './authenticate-a2a-client.js';
+import type { FollowA2aTask } from './follow-a2a-task.js';
+import { type TaskView } from './task-view.js';
+export type SubscribeToA2aTask = (input: {
+    caller: A2aCaller;
+    taskId: string;
+    signal: AbortSignal;
+}) => Promise<Result<AsyncIterable<TaskView>, DomainError<'TASK_NOT_FOUND' | 'TASK_TERMINAL'>>>;
+/** Use case: an outside A2A client follows one of its own tasks still open (SubscribeToTask); another party's is not found, and an ended one is refused. */
+export declare function createSubscribeToA2aTask(deps: {
+    calls: Pick<ClientCalls, 'findTask'>;
+    clock: Clock;
+    follow: FollowA2aTask;
+}): SubscribeToA2aTask;

package/dist/core/a2a-in/subscribe-to-a2a-task.js

@@ -0,0 +1,17 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { isTerminal, taskViewOf } from './task-view.js';
+/** Use case: an outside A2A client follows one of its own tasks still open (SubscribeToTask); another party's is not found, and an ended one is refused. */
+export function createSubscribeToA2aTask(deps) {
+    return async ({ caller, taskId, signal }) => {
+        const task = await deps.calls.findTask(caller, taskId);
+        if (task === undefined) {
+            return refuse('TASK_NOT_FOUND', `No task ${taskId}`);
+        }
+        if (isTerminal(taskViewOf(task, deps.clock.now()))) {
+            return refuse('TASK_TERMINAL', `The task ${taskId} has ended: read it with GetTask`);
+        }
+        return ok(deps.follow({ caller, taskId, signal }));
+    };
+}
+//# sourceMappingURL=subscribe-to-a2a-task.js.map

package/dist/core/a2a-in/subscribe-to-a2a-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-to-a2a-task.js","sourceRoot":"","sources":["../../../src/core/a2a-in/subscribe-to-a2a-task.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAiB,MAAM,gBAAgB,CAAC;AAIvE,4JAA4J;AAC5J,MAAM,UAAU,wBAAwB,CAAC,IAAmF;IAC1H,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC,gBAAgB,EAAE,WAAW,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;YACnD,OAAO,MAAM,CAAC,eAAe,EAAE,YAAY,MAAM,kCAAkC,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/a2a-in/task-view.d.ts

@@ -0,0 +1,51 @@
+/**
+ * An A2A task as its client reads it (interop 3.4, decision 0060): the
+ * calls its client made in it, in the order sent, read by the one rule of
+ * the call store. Its state is its latest call's: completed by the answer,
+ * input required by a question, the state an `application/a2a+json` reply
+ * carries, failed at the deadline or when the fleet gave the delivery up,
+ * working once the ship took it, submitted before. Its history is the
+ * client's messages and the ship's replies in the order they came.
+ */
+import { type CallReply } from '../mcp-in/client-call.js';
+import type { StoredTask } from '../mcp-in/ports.js';
+export type TaskStatus = {
+    state: 'submitted';
+} | {
+    state: 'working';
+} | {
+    state: 'inputRequired';
+    question: CallReply;
+} | {
+    state: 'completed';
+    answer: CallReply;
+} | {
+    state: 'failed';
+}
+/** The state an A2A reply carries, for the adapter that speaks A2A to read. */
+ | {
+    state: 'carried';
+    reply: CallReply;
+};
+export type TaskEntry = {
+    by: 'client';
+    message: string;
+    at: Date;
+} | {
+    by: 'ship';
+    reply: CallReply;
+};
+export interface TaskView {
+    taskId: string;
+    contextId: string;
+    status: TaskStatus & {
+        since: Date;
+    };
+    history: TaskEntry[];
+}
+/** Whether the task ended: completed or failed, so it takes no follow-up and a follow of it ends. */
+export declare const isTerminal: (view: TaskView) => boolean;
+/** What tells one view of a task from the next: its state, since when, and how much history it holds. */
+export declare const markOf: (view: TaskView) => string;
+/** The task as its client reads it now; a task with no call kept yet is submitted since now. */
+export declare function taskViewOf(task: StoredTask, now: Date): TaskView;