@aeolus-fleet/gateway 0.0.0-stage → 0.0.0

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() + deps.waitMs;
+    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: new Date(sentAt.getTime() + deps.deadlineMs),
+        });
+        return ok(await answerWithin(deps, { fleetId: caller.fleetId, messageId, handle, since: sentAt }));
+    };
+}
+//# 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: a gateway default while statements carry none. */
+    deadlineAt: Date;
+    /** 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 (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 (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,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5D,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,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,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,29 @@
+/**
+ * Use case: the gateway takes the replies to an outside client's calls, as
+ * the crew of the client's proxy ship (Q9 a), until it is stopped. A reply
+ * naming a call is kept on it, then acknowledged and handled: the gateway's
+ * store is the confirmation, so nothing is acknowledged before it is kept.
+ * Any other delivery stays unacknowledged, for the inbox of a later slice.
+ * Core 0.28's receiveReply (aeolus-fleet#953) takes this one's place.
+ */
+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 } from './ports.js';
+export type CollectReplies = (input: {
+    party: McpClientParty;
+    signal: AbortSignal;
+}) => Promise<{
+    ended: 'stopped' | 'crewRefused';
+}>;
+interface CollectRepliesDeps {
+    crew: Pick<ProxyShipCrew, 'pushReceive' | 'ack' | 'handled'>;
+    calls: ClientCalls;
+    clock: Clock;
+    sleep: Sleep;
+    /** How long it waits before it looks again, once a round took no reply. */
+    pollMs: number;
+}
+export declare function createCollectReplies(deps: CollectRepliesDeps): CollectReplies;
+export {};

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

@@ -0,0 +1,44 @@
+/** The fleet's codes for a crew token it no longer takes. */
+const CREW_REFUSED = new Set(['UNAUTHORIZED', 'LEASE_ENDED']);
+/** The most deliveries core's pushReceive takes at once. */
+const PUSH_RECEIVE_MAX = 10;
+export function createCollectReplies(deps) {
+    /** Keeps a reply that names one of the party's calls, then confirms it: whether it was taken. */
+    const taken = async ({ party, crewToken }, delivery) => {
+        if (delivery.inReplyTo === null) {
+            return false;
+        }
+        const call = await deps.calls.findByMessage(party.fleetId, delivery.inReplyTo);
+        if (call?.party !== party.name) {
+            return false;
+        }
+        const { deliveryId, messageId, contentType, payload } = delivery;
+        await deps.calls.addReply({ fleetId: party.fleetId, messageId: call.messageId }, { deliveryId, messageId, contentType, payload, receivedAt: deps.clock.now() });
+        const acked = await deps.crew.ack(crewToken, deliveryId);
+        if (!acked.isOk) {
+            // Kept already: the fleet hands it again, and keeping it again changes nothing.
+            return false;
+        }
+        await deps.crew.handled(crewToken, deliveryId);
+        return true;
+    };
+    return async ({ party, signal }) => {
+        const crewToken = party.crewToken;
+        if (crewToken === null) {
+            return { ended: 'crewRefused' };
+        }
+        while (!signal.aborted) {
+            const received = await deps.crew.pushReceive(crewToken, { max: PUSH_RECEIVE_MAX, signal });
+            if (!received.isOk && CREW_REFUSED.has(received.error.code)) {
+                return { ended: 'crewRefused' };
+            }
+            const deliveries = received.isOk ? received.value : [];
+            const outcomes = await Promise.all(deliveries.map((delivery) => taken({ party, crewToken }, delivery)));
+            if (!outcomes.includes(true)) {
+                await deps.sleep(deps.pollMs, signal);
+            }
+        }
+        return { ended: '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,44 @@
+/**
+ * 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;
+}
+/** 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 },
+    };
+}
+/** 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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"}

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

@@ -0,0 +1,85 @@
+import type { FleetId, MessageId, ShipId, ShipKind } from '@aeolus-fleet/common';
+import type { FleetRefusal } from '../connection/ports.js';
+import type { Result } from '../shared/result.js';
+import type { CallReply, ClientCall } from './client-call.js';
+/** One thing a ship offers, as its statement says it (decision 0047): MCP's tool fields and A2A's modes. */
+export interface Capability {
+    name: string;
+    title?: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    /** The media types to send it, the first the one to use. */
+    inputModes?: string[];
+    /** The media types that come back, the first the one to expect. */
+    outputModes?: string[];
+}
+/** A ship's statement as discovery shows it: its crew's, the note it was commissioned with, or none. */
+export type DiscoveredStatement = {
+    by: 'crew';
+    summary: string;
+    capabilities: Capability[];
+} | {
+    by: 'commission';
+} | null;
+/** A ship the caller may send to now, as discover answers it. */
+export interface DiscoveredShip {
+    shipId: ShipId;
+    kind: ShipKind;
+    statement: DiscoveredStatement;
+}
+/** Outbound port: the fleet's discover, as a proxy ship's crew calls it. */
+export interface Discovery {
+    discover(crewToken: string): Promise<Result<DiscoveredShip[], FleetRefusal>>;
+}
+/**
+ * Outbound port: the name an outside client knows a ship by. Derived, never
+ * stored, the same for the same ship, and telling nothing of the ship's name
+ * or id: the gateway translates both ways, as NAT does.
+ */
+export interface ShipAliases {
+    aliasOf(fleetId: FleetId, shipId: ShipId): string;
+}
+/** Outbound port: the fleet's send, as a proxy ship's crew calls it. The same idempotency key answers the same message. */
+export interface CallSender {
+    send(crewToken: string, message: {
+        to: ShipId;
+        contentType: string;
+        payload: string;
+        idempotencyKey: string;
+    }): Promise<Result<{
+        messageId: MessageId;
+    }, FleetRefusal>>;
+}
+/**
+ * Outbound port: the keys of an outside client's call, derived under the
+ * gateway's own key. The outside sees only opaque ids, never a `msg_` id.
+ */
+export interface CallKeys {
+    /** The send's key for a client's own idempotency key: the same for the same party and key. */
+    idempotencyKeyOf(given: {
+        fleetId: FleetId;
+        party: string;
+        key: string;
+    }): string;
+    /** A new send key, for a call the client gave none. */
+    newIdempotencyKey(): string;
+    /** The handle the client reads its call by. */
+    handleOf(fleetId: FleetId, messageId: MessageId): string;
+}
+/** Outbound port: outside clients' calls, one per message, each with the replies naming it. */
+export interface ClientCalls {
+    /** Keeps a call with no replies; a call kept for its message already stays as it was. */
+    save(call: Omit<ClientCall, 'replies'>): Promise<void>;
+    /** Keeps a reply on the call its message names, once per delivery. */
+    addReply(call: {
+        fleetId: FleetId;
+        messageId: MessageId;
+    }, reply: CallReply): Promise<void>;
+    findByMessage(fleetId: FleetId, messageId: MessageId): Promise<ClientCall | undefined>;
+    /** The party's call by its handle; none of another party's. */
+    findByHandle(caller: {
+        fleetId: FleetId;
+        party: string;
+    }, handle: string): Promise<ClientCall | undefined>;
+}

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

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

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

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

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

@@ -0,0 +1,23 @@
+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 CallState, type ClientCall } from './client-call.js';
+import type { ClientCalls } from './ports.js';
+/** A call as its client reads it (interop 3.4): its handle, when it was sent, its state and since when, with its answer once completed. */
+export type ReadCall = {
+    handle: string;
+    createdAt: Date;
+    updatedAt: Date;
+} & CallState;
+/** The call as its client reads it now. */
+export declare function readCallOf(call: ClientCall, now: Date): ReadCall;
+export type ReadClientCall = (caller: {
+    fleetId: FleetId;
+    party: string;
+}, handle: string) => Promise<Result<ReadCall, DomainError<'NO_SUCH_CALL'>>>;
+/** Use case: an outside client reads its own call by the handle it was answered; no other party's. */
+export declare function createReadClientCall(deps: {
+    calls: ClientCalls;
+    clock: Clock;
+}): ReadClientCall;

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

@@ -0,0 +1,15 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { stateOf, stateSince } from './client-call.js';
+/** The call as its client reads it now. */
+export function readCallOf(call, now) {
+    return { handle: call.handle, createdAt: call.sentAt, updatedAt: stateSince(call, now), ...stateOf(call, now) };
+}
+/** Use case: an outside client reads its own call by the handle it was answered; no other party's. */
+export function createReadClientCall(deps) {
+    return async ({ fleetId, party }, handle) => {
+        const call = await deps.calls.findByHandle({ fleetId, party }, handle);
+        return call ? ok(readCallOf(call, deps.clock.now())) : refuse('NO_SUCH_CALL', 'This party made no call with that handle');
+    };
+}
+//# sourceMappingURL=read-client-call.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-client-call.js","sourceRoot":"","sources":["../../../src/core/mcp-in/read-client-call.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAmC,MAAM,kBAAkB,CAAC;AAMxF,2CAA2C;AAC3C,MAAM,UAAU,UAAU,CAAC,IAAgB,EAAE,GAAS;IACpD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;AAClH,CAAC;AAID,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAAC,IAA0C;IAC7E,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,0CAA0C,CAAC,CAAC;IAC5H,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/mcp-out/content-types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The content types that carry an outside tool's call and its result over
+ * the fleet (orchestrator-1 on aeolus-fleet#876, Q7): the input type names
+ * the tool, and its payload is the tool's arguments as a JSON object; the
+ * result type names the tool too, and its payload is the tool's result.
+ */
+export declare function toolInputType(tool: string): string;
+export declare function toolResultType(tool: string): string;
+/** The tool a message of this content type calls; none for another type, or the input type without a name. */
+export declare function toolCalledBy(contentType: string): string | undefined;
+/** Whether a message of this content type carries a tool's result. */
+export declare function isToolResultType(contentType: string): boolean;

package/dist/core/mcp-out/content-types.js

@@ -0,0 +1,28 @@
+/**
+ * The content types that carry an outside tool's call and its result over
+ * the fleet (orchestrator-1 on aeolus-fleet#876, Q7): the input type names
+ * the tool, and its payload is the tool's arguments as a JSON object; the
+ * result type names the tool too, and its payload is the tool's result.
+ */
+const TOOL_INPUT = 'application/vnd.aeolus.mcp-tool+json';
+const TOOL_RESULT = 'application/vnd.aeolus.mcp-result+json';
+export function toolInputType(tool) {
+    return `${TOOL_INPUT}; name=${tool}`;
+}
+export function toolResultType(tool) {
+    return `${TOOL_RESULT}; name=${tool}`;
+}
+/** The tool a message of this content type calls; none for another type, or the input type without a name. */
+export function toolCalledBy(contentType) {
+    const [type, ...parameters] = contentType.split(';').map((part) => part.trim());
+    if (type?.toLowerCase() !== TOOL_INPUT) {
+        return undefined;
+    }
+    const name = parameters.find((parameter) => parameter.toLowerCase().startsWith('name='))?.slice('name='.length);
+    return name === undefined || name === '' ? undefined : name;
+}
+/** Whether a message of this content type carries a tool's result. */
+export function isToolResultType(contentType) {
+    return contentType.split(';')[0]?.trim().toLowerCase() === TOOL_RESULT;
+}
+//# sourceMappingURL=content-types.js.map

package/dist/core/mcp-out/content-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types.js","sourceRoot":"","sources":["../../../src/core/mcp-out/content-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,GAAG,sCAAsC,CAAC;AAC1D,MAAM,WAAW,GAAG,wCAAwC,CAAC;AAE7D,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,GAAG,UAAU,UAAU,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,GAAG,WAAW,UAAU,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,8GAA8G;AAC9G,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,MAAM,CAAC,IAAI,EAAE,GAAG,UAAU,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,IAAI,IAAI,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,CAAC;QACvC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChH,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC;AACzE,CAAC"}