@aeolus-fleet/gateway 0.0.0-stage → 0.28.0

package/dist/core/installation/request-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-id.js","sourceRoot":"","sources":["../../../src/core/installation/request-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAI/D,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAA8B,EAC9B,OAAmD;IAEnD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,OAAO,CAAC,SAAS,+BAA+B,CAAC,CAAC;AAC/J,CAAC"}

package/dist/core/installation/served.d.ts

@@ -0,0 +1,12 @@
+import type { FleetId } from '@aeolus-fleet/common';
+import type { FleetSwitches, InstallationMode } from './ports.js';
+/** Whether the gateway serves the fleet now: off, it does nothing for that fleet. */
+export type IsServed = (fleetId: FleetId) => Promise<boolean>;
+/**
+ * Policy: the gateway serves every fleet of an open installation, and a fleet
+ * of an enabled one only once the hosting service switched it on (decision 0021).
+ */
+export declare function createIsServed(deps: {
+    installation: InstallationMode;
+    switches: FleetSwitches;
+}): IsServed;

package/dist/core/installation/served.js

@@ -0,0 +1,8 @@
+/**
+ * Policy: the gateway serves every fleet of an open installation, and a fleet
+ * of an enabled one only once the hosting service switched it on (decision 0021).
+ */
+export function createIsServed(deps) {
+    return async (fleetId) => deps.installation === 'open' || (await deps.switches.find(fleetId)) === true;
+}
+//# sourceMappingURL=served.js.map

package/dist/core/installation/served.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"served.js","sourceRoot":"","sources":["../../../src/core/installation/served.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAiE;IAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;AACzG,CAAC"}

package/dist/core/installation/set-fleet-enabled.d.ts

@@ -0,0 +1,25 @@
+import type { FleetId } from '@aeolus-fleet/common';
+import type { Clock } from '../shared/clock.js';
+import type { DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { FleetSwitches, InstallationRequests, RequestHasher } from './ports.js';
+export type SetFleetEnabled = (input: {
+    requestId: string;
+    fleetId: FleetId;
+    isEnabled: boolean;
+}) => Promise<Result<{
+    fleetId: FleetId;
+    isEnabled: boolean;
+}, DomainError<'REQUEST_ID_USED'>>>;
+/**
+ * Use case: the hosting service switches the gateway on or off for a fleet
+ * (decision 0021). Off keeps everything of the fleet, so on again resumes,
+ * whatever network the fleet has (interop I-3). A replayed request id
+ * answers what it answered first and changes nothing.
+ */
+export declare function createSetFleetEnabled(deps: {
+    switches: FleetSwitches;
+    requests: InstallationRequests;
+    hasher: RequestHasher;
+    clock: Clock;
+}): SetFleetEnabled;

package/dist/core/installation/set-fleet-enabled.js

@@ -0,0 +1,22 @@
+import { ok } from '../shared/result.js';
+import { earlierAnswer } from './request-id.js';
+/**
+ * Use case: the hosting service switches the gateway on or off for a fleet
+ * (decision 0021). Off keeps everything of the fleet, so on again resumes,
+ * whatever network the fleet has (interop I-3). A replayed request id
+ * answers what it answered first and changes nothing.
+ */
+export function createSetFleetEnabled(deps) {
+    return async ({ requestId, fleetId, isEnabled }) => {
+        const requestHash = deps.hasher.hash(`setEnabled ${fleetId} ${String(isEnabled)}`);
+        const earlier = await earlierAnswer(deps.requests, { requestId, requestHash });
+        if (earlier !== undefined) {
+            return 'isOk' in earlier ? earlier : ok({ fleetId, isEnabled: earlier.isEnabled === true });
+        }
+        const at = deps.clock.now();
+        await deps.switches.set(fleetId, { isEnabled, at });
+        await deps.requests.record({ requestId, kind: 'setEnabled', requestHash, fleetId, isEnabled, at });
+        return ok({ fleetId, isEnabled });
+    };
+}
+//# sourceMappingURL=set-fleet-enabled.js.map

package/dist/core/installation/set-fleet-enabled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-fleet-enabled.js","sourceRoot":"","sources":["../../../src/core/installation/set-fleet-enabled.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQhD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAKrC;IACC,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;QACjD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACnG,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/mcp-in/call-tool.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Use case: an outside MCP client calls a tool (interop 3.3). The call is a
+ * message the party's proxy ship sends to the tool's ship, and the client is
+ * answered a handle only once the fleet's send answered OK: the message is
+ * stored before any answer, and the gateway never answers OK itself. It
+ * then waits for the answer as long as the capability states, at most the
+ * gateway's own most (interop 3.3, 5.3): answered within it, the client gets
+ * the answer itself; else its handle and the state. The call fails at the
+ * capability's deadline, and never by time when it states none (3.4).
+ */
+import type { FleetId } from '@aeolus-fleet/common';
+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 ListTools } from './list-tools.js';
+import type { CallKeys, CallSender, ClientCalls } from './ports.js';
+import { type ReadCall } from './read-client-call.js';
+export type CallToolRefusal = DomainError<'PARTY_NOT_CREWED' | 'FLEET_UNAVAILABLE' | 'NO_SUCH_TOOL' | 'INVALID_ARGUMENTS' | 'NOT_REACHABLE' | 'SEND_REFUSED'>;
+export type CallTool = (caller: {
+    fleetId: FleetId;
+    party: string;
+}, call: {
+    name: string;
+    arguments: Record<string, unknown>;
+}) => Promise<Result<ReadCall, CallToolRefusal>>;
+interface CallToolDeps {
+    parties: PartyStore;
+    listTools: ListTools;
+    sender: CallSender;
+    calls: ClientCalls;
+    keys: CallKeys;
+    clock: Clock;
+    sleep: Sleep;
+    /** The most a call waits for its answer before it is answered its handle, whatever its capability states. */
+    waitMaxMs: number;
+    /** How often it reads the call while it waits. */
+    waitPollMs: number;
+}
+export declare function createCallTool(deps: CallToolDeps): CallTool;
+export {};

package/dist/core/mcp-in/call-tool.js

@@ -0,0 +1,82 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { IDEMPOTENCY_ARGUMENT } from './list-tools.js';
+import { readCallOf } from './read-client-call.js';
+/** The message's payload: the arguments as JSON, or a text tool's one text; none for arguments that do not fit the tool. */
+function payloadOf(tool, values) {
+    if (tool.target.isText) {
+        return typeof values.text === 'string' ? values.text : undefined;
+    }
+    return JSON.stringify(values);
+}
+function refusalOf(refused) {
+    switch (refused.code) {
+        // No reason why: the fleet's network rules are not the outside's to read.
+        case 'NOT_REACHABLE':
+            return refuse('NOT_REACHABLE', 'This party may not call that tool now');
+        case 'UNAVAILABLE':
+            return refuse('FLEET_UNAVAILABLE', `The fleet did not answer, so the call may have been sent: call again with the same ${IDEMPOTENCY_ARGUMENT} to send it at most once`);
+        default:
+            return refuse('SEND_REFUSED', `The fleet refused the call: ${refused.message}`);
+    }
+}
+/** No signal ends a wait early: it is bounded by its own time. */
+const UNENDING = new AbortController().signal;
+/** The call as it stands once its answer came or the wait passed, read after each poll; it never sleeps past the wait's end. */
+async function answerWithin(deps, sent) {
+    const waitEnd = sent.since.getTime() + Math.min(sent.waitMs, deps.waitMaxMs);
+    for (;;) {
+        const call = await deps.calls.findByMessage(sent.fleetId, sent.messageId);
+        const read = call ? readCallOf(call, deps.clock.now()) : { handle: sent.handle, createdAt: sent.since, updatedAt: sent.since, state: 'submitted' };
+        const left = waitEnd - deps.clock.now().getTime();
+        if (read.state === 'completed' || read.state === 'failed' || left <= 0) {
+            return read;
+        }
+        await deps.sleep(Math.min(deps.waitPollMs, left), UNENDING);
+    }
+}
+export function createCallTool(deps) {
+    return async (caller, call) => {
+        const listed = await deps.listTools(caller);
+        if (!listed.isOk) {
+            return listed;
+        }
+        const tool = listed.value.find((each) => each.name === call.name);
+        if (!tool) {
+            return refuse('NO_SUCH_TOOL', `No tool ${call.name} is offered to this party now`);
+        }
+        const { [IDEMPOTENCY_ARGUMENT]: key, ...values } = call.arguments;
+        if (key !== undefined && (typeof key !== 'string' || key.length === 0)) {
+            return refuse('INVALID_ARGUMENTS', `${IDEMPOTENCY_ARGUMENT} is a string of at least one character`);
+        }
+        const payload = payloadOf(tool, values);
+        if (payload === undefined) {
+            return refuse('INVALID_ARGUMENTS', 'This tool takes one text argument, a string');
+        }
+        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: argo crews it on the parties page`);
+        }
+        const idempotencyKey = key === undefined ? deps.keys.newIdempotencyKey() : deps.keys.idempotencyKeyOf({ ...caller, key });
+        const sent = await deps.sender.send(party.crewToken, { to: tool.target.shipId, contentType: tool.target.contentType, payload, idempotencyKey });
+        if (!sent.isOk) {
+            return refusalOf(sent.error);
+        }
+        const { messageId } = sent.value;
+        const handle = deps.keys.handleOf(caller.fleetId, messageId);
+        const sentAt = deps.clock.now();
+        await deps.calls.save({
+            fleetId: caller.fleetId,
+            party: caller.party,
+            messageId,
+            handle,
+            shipId: tool.target.shipId,
+            capability: tool.target.capability,
+            outputContentType: tool.target.outputContentType,
+            sentAt,
+            deadlineAt: tool.target.deadlineMs === null ? null : new Date(sentAt.getTime() + tool.target.deadlineMs),
+        });
+        return ok(await answerWithin(deps, { fleetId: caller.fleetId, messageId, handle, since: sentAt, waitMs: tool.target.waitMs }));
+    };
+}
+//# sourceMappingURL=call-tool.js.map

package/dist/core/mcp-in/call-tool.js.map

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

package/dist/core/mcp-in/client-call.d.ts

@@ -0,0 +1,51 @@
+/**
+ * An outside client's call (interop 3.4): the message its proxy ship sent,
+ * the replies naming it, and the one rule for its state. Core keeps no state
+ * of a call: submitted, working, completed and failed are the gateway's,
+ * derived from what it kept and the time.
+ */
+import type { DeliveryId, FleetId, MessageId, ShipId } from '@aeolus-fleet/common';
+/** A reply naming the call's message, as the gateway kept it before acknowledging its delivery. */
+export interface CallReply {
+    deliveryId: DeliveryId;
+    messageId: MessageId;
+    contentType: string;
+    payload: string;
+    receivedAt: Date;
+}
+export interface ClientCall {
+    fleetId: FleetId;
+    party: string;
+    messageId: MessageId;
+    handle: string;
+    shipId: ShipId;
+    capability: string;
+    /** The capability's stated output type, its first output mode; none when it states none. */
+    outputContentType: string | null;
+    sentAt: Date;
+    /** When the call fails without its answer, from its capability's deadline; none never fails by time. */
+    deadlineAt: Date | null;
+    /** In the order the gateway kept them. */
+    replies: CallReply[];
+}
+export type CallState = {
+    state: 'submitted';
+} | {
+    state: 'working';
+} | {
+    state: 'completed';
+    answer: {
+        contentType: string;
+        payload: string;
+    };
+} | {
+    state: 'failed';
+};
+/**
+ * Completed by the first reply of the stated output type, kept before the
+ * deadline; failed at the deadline without one, and a later reply changes
+ * nothing; working once any other reply came; submitted before that.
+ */
+export declare function stateOf(call: ClientCall, now: Date): CallState;
+/** Since when the call is in its state: its sending, its first reply, its answer, or its deadline. */
+export declare function stateSince(call: ClientCall, now: Date): Date;

package/dist/core/mcp-in/client-call.js

@@ -0,0 +1,39 @@
+/** The type a plain text answer comes in, which completes a call to a ship that stated no output type. */
+const PLAIN_TEXT = 'text/plain';
+/** A media type as compared: lower case, with no spaces around its parameters. */
+const normalized = (contentType) => contentType
+    .split(';')
+    .map((part) => part.trim().toLowerCase())
+    .join(';');
+const essenceOf = (contentType) => normalized(contentType).split(';')[0] ?? '';
+function isAnswer(call, reply) {
+    if (call.deadlineAt !== null && reply.receivedAt.getTime() >= call.deadlineAt.getTime()) {
+        return false;
+    }
+    return call.outputContentType === null ? essenceOf(reply.contentType) === PLAIN_TEXT : normalized(reply.contentType) === normalized(call.outputContentType);
+}
+/** The call's state with since when it holds, by the one rule below. */
+function standing(call, now) {
+    const answer = call.replies.find((reply) => isAnswer(call, reply));
+    if (answer) {
+        return { state: { state: 'completed', answer: { contentType: answer.contentType, payload: answer.payload } }, since: answer.receivedAt };
+    }
+    if (call.deadlineAt !== null && now.getTime() >= call.deadlineAt.getTime()) {
+        return { state: { state: 'failed' }, since: call.deadlineAt };
+    }
+    const [first] = call.replies;
+    return first ? { state: { state: 'working' }, since: first.receivedAt } : { state: { state: 'submitted' }, since: call.sentAt };
+}
+/**
+ * Completed by the first reply of the stated output type, kept before the
+ * deadline; failed at the deadline without one, and a later reply changes
+ * nothing; working once any other reply came; submitted before that.
+ */
+export function stateOf(call, now) {
+    return standing(call, now).state;
+}
+/** Since when the call is in its state: its sending, its first reply, its answer, or its deadline. */
+export function stateSince(call, now) {
+    return standing(call, now).since;
+}
+//# sourceMappingURL=client-call.js.map

package/dist/core/mcp-in/client-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-call.js","sourceRoot":"","sources":["../../../src/core/mcp-in/client-call.ts"],"names":[],"mappings":"AAmCA,0GAA0G;AAC1G,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,kFAAkF;AAClF,MAAM,UAAU,GAAG,CAAC,WAAmB,EAAE,EAAE,CACzC,WAAW;KACR,KAAK,CAAC,GAAG,CAAC;KACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;KACxC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEf,MAAM,SAAS,GAAG,CAAC,WAAmB,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAEvF,SAAS,QAAQ,CAAC,IAAgB,EAAE,KAAgB;IAClD,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACxF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAC9J,CAAC;AAED,wEAAwE;AACxE,SAAS,QAAQ,CAAC,IAAgB,EAAE,GAAS;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACnE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IAC3I,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3E,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IAChE,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AAClI,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAgB,EAAE,GAAS;IACjD,OAAO,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC;AACnC,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,UAAU,CAAC,IAAgB,EAAE,GAAS;IACpD,OAAO,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC;AACnC,CAAC"}

package/dist/core/mcp-in/collect-replies.d.ts

@@ -0,0 +1,22 @@
+import type { ProxyShipCrew } from '../mcp-out/hand-call.js';
+import type { Sleep } from '../mcp-out/run-party.js';
+import type { McpClientParty } from '../parties/party.js';
+import type { Clock } from '../shared/clock.js';
+import type { ClientCalls, ReplyReceiver } from './ports.js';
+export type CollectReplies = (input: {
+    party: McpClientParty;
+    signal: AbortSignal;
+}) => Promise<{
+    ended: 'stopped' | 'crewRefused';
+}>;
+interface CollectRepliesDeps {
+    crew: Pick<ProxyShipCrew, 'ack' | 'handled'>;
+    replies: ReplyReceiver;
+    calls: ClientCalls;
+    clock: Clock;
+    sleep: Sleep;
+    /** How long it waits before it looks again for calls to wait on. */
+    pollMs: number;
+}
+export declare function createCollectReplies(deps: CollectRepliesDeps): CollectReplies;
+export {};

package/dist/core/mcp-in/collect-replies.js

@@ -0,0 +1,66 @@
+import { stateOf } from './client-call.js';
+/** The fleet's codes for a crew token it no longer takes. */
+const CREW_REFUSED = new Set(['UNAUTHORIZED', 'LEASE_ENDED']);
+/** The most calls whose reply the gateway waits on at once, for one party. */
+const WAITING_MAX = 10;
+/** Whether the call still waits for its answer: neither completed nor failed at its deadline. */
+function isWaiting(call, now) {
+    const { state } = stateOf(call, now);
+    return state === 'submitted' || state === 'working';
+}
+export function createCollectReplies(deps) {
+    return async ({ party, signal }) => {
+        const crewToken = party.crewToken;
+        if (crewToken === null) {
+            return { ended: 'crewRefused' };
+        }
+        const caller = { fleetId: party.fleetId, party: party.name };
+        const waiting = new Map();
+        /** When each call was last asked for, so every call waited on gets its turn. */
+        const askedAt = new Map();
+        let asks = 0;
+        /** Whether the fleet refused the crew token: set by a wait, read by the run. */
+        const run = { isCrewRefused: false };
+        /** Asks the fleet once for the call's reply, and keeps it, then confirms it. */
+        const waitOn = async (call) => {
+            asks += 1;
+            askedAt.set(call.messageId, asks);
+            const received = await deps.replies.receiveReply(crewToken, { messageId: call.messageId, signal });
+            if (!received.isOk) {
+                if (CREW_REFUSED.has(received.error.code)) {
+                    run.isCrewRefused = true;
+                }
+                return;
+            }
+            const reply = received.value;
+            if (reply === undefined) {
+                return;
+            }
+            await deps.calls.addReply({ fleetId: call.fleetId, messageId: call.messageId }, { ...reply, receivedAt: deps.clock.now() });
+            // Kept already: an acknowledgement the fleet did not take hands the reply again, and keeping it again changes nothing.
+            if ((await deps.crew.ack(crewToken, reply.deliveryId)).isOk) {
+                await deps.crew.handled(crewToken, reply.deliveryId);
+            }
+        };
+        /** A wait whose reply could not be kept: the run ends, and answers its failure. */
+        const failed = [];
+        while (!signal.aborted && !run.isCrewRefused && failed.length === 0) {
+            const now = deps.clock.now();
+            const open = (await deps.calls.waitedOn(caller, now))
+                .filter((call) => isWaiting(call, now) && !waiting.has(call.messageId))
+                .sort((left, right) => (askedAt.get(left.messageId) ?? 0) - (askedAt.get(right.messageId) ?? 0));
+            for (const call of open.slice(0, WAITING_MAX - waiting.size)) {
+                const waited = waitOn(call);
+                waiting.set(call.messageId, waited
+                    .catch(() => {
+                    failed.push(waited);
+                })
+                    .finally(() => waiting.delete(call.messageId)));
+            }
+            await deps.sleep(deps.pollMs, signal);
+        }
+        await Promise.all([...waiting.values(), ...failed]);
+        return { ended: run.isCrewRefused ? 'crewRefused' : 'stopped' };
+    };
+}
+//# sourceMappingURL=collect-replies.js.map

package/dist/core/mcp-in/collect-replies.js.map

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

package/dist/core/mcp-in/list-tools.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Use case: the tools an outside MCP client sees (interop 3.3). Each is a
+ * capability of a ship its party's proxy ship may send to now, as the fleet's
+ * discover answers it: the gateway shows exactly what core answers, and adds
+ * no reach of its own.
+ */
+import type { FleetId, ShipId } from '@aeolus-fleet/common';
+import type { PartyStore } from '../parties/ports.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { Discovery, ShipAliases } from './ports.js';
+/** The optional argument a client gives so that the same call again sends no second message. */
+export declare const IDEMPOTENCY_ARGUMENT = "aeolus_idempotency_key";
+/** The longest tool name MCP clients take. */
+export declare const TOOL_NAME_MAX_LENGTH = 128;
+/** Where a tool's call goes: the ship, its capability, and the content type of the message. */
+export interface ToolTarget {
+    shipId: ShipId;
+    capability: string;
+    contentType: string;
+    /** Whether the message is the call's one text argument, as plain text, rather than its arguments as JSON. */
+    isText: boolean;
+    /** The type the answer comes in, the capability's first output mode; none when it states none. */
+    outputContentType: string | null;
+    /** How long a call waits for its answer, as the capability states it; 0 when it states none. */
+    waitMs: number;
+    /** How long a call may take before it fails, as the capability states it; none when it states none. */
+    deadlineMs: number | null;
+}
+/** A tool as an MCP client lists it, with where its call goes. */
+export interface ListedTool {
+    name: string;
+    title?: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    target: ToolTarget;
+}
+export type ListToolsRefusal = DomainError<'PARTY_NOT_CREWED' | 'FLEET_UNAVAILABLE'>;
+/** Who lists: the fleet and the party its access token names. */
+export type ListTools = (caller: {
+    fleetId: FleetId;
+    party: string;
+}) => Promise<Result<ListedTool[], ListToolsRefusal>>;
+export declare function createListTools(deps: {
+    parties: PartyStore;
+    discovery: Discovery;
+    aliases: ShipAliases;
+}): ListTools;

package/dist/core/mcp-in/list-tools.js

@@ -0,0 +1,70 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+/** The optional argument a client gives so that the same call again sends no second message. */
+export const IDEMPOTENCY_ARGUMENT = 'aeolus_idempotency_key';
+const IDEMPOTENCY_PROPERTY = {
+    type: 'string',
+    description: 'Optional. The same key again sends no second message: give one when you may call again after a lost answer.',
+};
+/** The longest tool name MCP clients take. */
+export const TOOL_NAME_MAX_LENGTH = 128;
+/** Between a ship's alias and its capability's name in a tool name. */
+const TOOL_NAME_SEPARATOR = '__';
+/** The media type a capability that names none takes and answers. */
+const DEFAULT_MODE = 'application/json';
+const TEXT_MODE = 'text/plain';
+/** A media type without its parameters, in lower case. */
+const essenceOf = (mode) => (mode.split(';')[0] ?? '').trim().toLowerCase();
+const isJson = (mode) => essenceOf(mode) === DEFAULT_MODE || essenceOf(mode).endsWith('+json');
+const isObjectSchema = (schema) => schema.type === 'object';
+/** The arguments a capability takes, with the idempotency argument; none for a schema MCP cannot carry. */
+function inputSchemaOf(capability, isText) {
+    if (isText) {
+        return { type: 'object', properties: { text: { type: 'string' }, [IDEMPOTENCY_ARGUMENT]: IDEMPOTENCY_PROPERTY }, required: ['text'] };
+    }
+    const schema = capability.inputSchema ?? { type: 'object' };
+    if (!isObjectSchema(schema)) {
+        return undefined;
+    }
+    const properties = typeof schema.properties === 'object' && schema.properties !== null ? schema.properties : {};
+    return { ...schema, properties: { ...properties, [IDEMPOTENCY_ARGUMENT]: IDEMPOTENCY_PROPERTY } };
+}
+function toolOf({ alias, summary, shipId }, capability) {
+    const contentType = capability.inputModes?.[0] ?? DEFAULT_MODE;
+    const isText = essenceOf(contentType) === TEXT_MODE;
+    const name = `${alias}${TOOL_NAME_SEPARATOR}${capability.name}`;
+    const inputSchema = inputSchemaOf(capability, isText);
+    if ((!isText && !isJson(contentType)) || inputSchema === undefined || name.length > TOOL_NAME_MAX_LENGTH) {
+        return undefined;
+    }
+    // No output schema: a call may answer a handle, and MCP clients check every answer against it.
+    return {
+        name,
+        ...(capability.title === undefined ? {} : { title: capability.title }),
+        description: [capability.description, `Offered by: ${summary}`].filter((part) => part !== undefined).join('\n\n'),
+        inputSchema,
+        target: { shipId, capability: capability.name, contentType, isText, outputContentType: capability.outputModes?.[0] ?? null, waitMs: capability.waitMs ?? 0, deadlineMs: capability.deadlineMs ?? null },
+    };
+}
+/** argo is left out: every ship may send to argo, and argo is no tool (Q12). */
+function toolsOf(ship, alias) {
+    const { statement } = ship;
+    if (ship.kind === 'operator' || statement?.by !== 'crew') {
+        return [];
+    }
+    return statement.capabilities.flatMap((capability) => toolOf({ alias, summary: statement.summary, shipId: ship.shipId }, capability) ?? []);
+}
+export function createListTools(deps) {
+    return async ({ fleetId, party: name }) => {
+        const party = await deps.parties.find(fleetId, name);
+        if (party?.kind !== 'mcpClient' || party.state !== 'crewed' || party.crewToken === null) {
+            return refuse('PARTY_NOT_CREWED', `The party ${name} is not crewed: argo crews it on the parties page`);
+        }
+        const discovered = await deps.discovery.discover(party.crewToken);
+        if (!discovered.isOk) {
+            return refuse('FLEET_UNAVAILABLE', `The fleet did not answer which ships the party reaches: ${discovered.error.message}`);
+        }
+        return ok(discovered.value.flatMap((ship) => toolsOf(ship, deps.aliases.aliasOf(fleetId, ship.shipId))));
+    };
+}
+//# sourceMappingURL=list-tools.js.map

package/dist/core/mcp-in/list-tools.js.map

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