agentfootprint 9.64.0 → 9.65.0

package/dist/adapters/hosting/foundryResponses.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * adapters/hosting/foundryResponses — an agent behind Microsoft Foundry's
+ * hosted-agent contract.
+ *
+ * ── The split, and why it is here ────────────────────────────────────────────
+ * Two different things are needed to serve a Foundry hosted agent, and only one
+ * of them is Microsoft's:
+ *
+ *   • The **Responses protocol** — `input` items, a `response` object, the
+ *     named streaming lifecycle. That is a protocol several runtimes speak, so
+ *     it lives in `responsesWire.ts` with no vendor in it.
+ *   • The **hosting contract** — port 8088, `POST /responses`, a `HEAD` probe
+ *     on the same path, `GET /readiness` answering `{"status":"healthy"}`, and
+ *     `agent_session_id` as a session alias. That IS this runtime's contract,
+ *     the same way `/invocations` and `X-Amzn-…` are another's, and it is what
+ *     this file supplies.
+ *
+ * So this file is a configuration, not an implementation. Everything hard —
+ * draining on close, aborting when the caller hangs up, failing a handler that
+ * throws or answers nothing — is `httpHost`'s, shared with every other adapter
+ * rather than reimplemented here where the two would drift.
+ *
+ * ── What it does NOT do ──────────────────────────────────────────────────────
+ * **Workflow Visualizer topology is not provided.** The Inspector can invoke
+ * this host and render its answer; it does not learn that the answer came from
+ * four composed agents, because nothing in the Responses protocol carries that
+ * and inventing a channel for it would be claiming a compatibility this has
+ * never demonstrated. An agent's internal structure is readable from
+ * agentfootprint's own recorders.
+ *
+ * Everything the protocol does not carry — tool calls, image and file input,
+ * function-call output, structured output — is refused by name. See
+ * `responsesWire.ts`.
+ *
+ * This is an **inbound hosting adapter**: it is the door callers arrive at. It
+ * is not a model provider, and it has nothing to do with which model the agent
+ * calls — for Foundry models, that is `openai()` with the endpoint's base URL.
+ *
+ * @example  An agent behind the Inspector
+ *   import { foundryResponsesHost, memorySessions, standingAgent } from 'agentfootprint/hosting';
+ *
+ *   const handle = await standingAgent({
+ *     agent,
+ *     sessions: memorySessions(),
+ *     host: foundryResponsesHost(),
+ *   });
+ *   process.on('SIGTERM', () => void handle.close());
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.foundryResponsesHost = exports.FOUNDRY_SESSION_FIELDS = exports.FOUNDRY_READINESS_PATH = exports.FOUNDRY_INVOKE_PATH = exports.DEFAULT_FOUNDRY_PORT = void 0;
+const httpHost_js_1 = require("../../hosting/httpHost.js");
+const responsesWire_js_1 = require("./responsesWire.js");
+/** The port a Foundry hosted agent is expected on. */
+exports.DEFAULT_FOUNDRY_PORT = 8088;
+/** The path that takes a turn. */
+exports.FOUNDRY_INVOKE_PATH = '/responses';
+/** The path a Foundry hosted agent answers a readiness probe on. */
+exports.FOUNDRY_READINESS_PATH = '/readiness';
+/**
+ * Session aliases this contract accepts, in precedence order.
+ *
+ * `conversation` is the protocol's own; `agent_session_id` is this runtime's;
+ * `session_id` is the spelling several clients send anyway. First one present
+ * wins, so a caller using any of the three reaches the same session.
+ */
+exports.FOUNDRY_SESSION_FIELDS = [
+    'conversation',
+    'agent_session_id',
+    'session_id',
+];
+/**
+ * One mebibyte: large enough for any resume or job description this door was
+ * built to carry, small enough that a hostile caller cannot spend the heap.
+ */
+const DEFAULT_MAX_BODY_BYTES = 1_048_576;
+/**
+ * An {@link HttpHost} speaking Foundry's hosted-agent contract.
+ *
+ * @param options - Port, interface, model label and body ceiling.
+ */
+function foundryResponsesHost(options = {}) {
+    const { server, onUnhandled, model, hostname } = options;
+    // `port` and `hostname` name a socket a caller-owned server already bound, so
+    // they are passed only when this host is the one binding. Defaulting the port
+    // unconditionally would turn "attach to my server" into a refusal.
+    const socket = server
+        ? { server }
+        : {
+            port: options.port ?? exports.DEFAULT_FOUNDRY_PORT,
+            ...(hostname === undefined ? {} : { hostname }),
+            ...(onUnhandled === undefined ? {} : { onUnhandled }),
+        };
+    return (0, httpHost_js_1.httpHost)({
+        name: 'foundryResponsesHost',
+        wire: (0, responsesWire_js_1.responsesWire)({
+            ...(model === undefined ? {} : { defaultModel: model }),
+            sessionFields: exports.FOUNDRY_SESSION_FIELDS,
+            health: { status: 'healthy' },
+        }),
+        invokePath: exports.FOUNDRY_INVOKE_PATH,
+        healthPath: exports.FOUNDRY_READINESS_PATH,
+        // The Inspector asks whether the door is there before it uses it.
+        invokeHeadProbe: true,
+        maxBodyBytes: options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES,
+        ...socket,
+    });
+}
+exports.foundryResponsesHost = foundryResponsesHost;
+//# sourceMappingURL=foundryResponses.js.map

package/dist/adapters/hosting/foundryResponses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundryResponses.js","sourceRoot":"","sources":["../../../src/adapters/hosting/foundryResponses.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;;;AAIH,2DAAoE;AACpE,yDAAmD;AAEnD,sDAAsD;AACzC,QAAA,oBAAoB,GAAG,IAAI,CAAC;AAEzC,kCAAkC;AACrB,QAAA,mBAAmB,GAAG,YAAY,CAAC;AAEhD,oEAAoE;AACvD,QAAA,sBAAsB,GAAG,YAAY,CAAC;AAEnD;;;;;;GAMG;AACU,QAAA,sBAAsB,GAAsB;IACvD,cAAc;IACd,kBAAkB;IAClB,YAAY;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAqBzC;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,UAAuC,EAAE;IAC5E,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACzD,8EAA8E;IAC9E,8EAA8E;IAC9E,mEAAmE;IACnE,MAAM,MAAM,GAAG,MAAM;QACnB,CAAC,CAAC,EAAE,MAAM,EAAE;QACZ,CAAC,CAAC;YACE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,4BAAoB;YAC1C,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;YAC/C,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;SACtD,CAAC;IAEN,OAAO,IAAA,sBAAQ,EAAC;QACd,IAAI,EAAE,sBAAsB;QAC5B,IAAI,EAAE,IAAA,gCAAa,EAAC;YAClB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;YACvD,aAAa,EAAE,8BAAsB;YACrC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;SAC9B,CAAC;QACF,UAAU,EAAE,2BAAmB;QAC/B,UAAU,EAAE,8BAAsB;QAClC,kEAAkE;QAClE,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,sBAAsB;QAC5D,GAAG,MAAM;KACV,CAAC,CAAC;AACL,CAAC;AA3BD,oDA2BC"}

package/dist/adapters/hosting/responsesWire.js

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * adapters/hosting/responsesWire — the Responses protocol, as an `HttpWire`.
+ *
+ * ── What this is, and what it deliberately is not ────────────────────────────
+ * This file speaks the **Responses** wire protocol: a request carries `input`
+ * as text or as message items, a reply is a `response` object with an id and a
+ * status, and a stream is a LIFECYCLE of named events that open the response,
+ * announce output, carry deltas, and close each part before closing the
+ * response itself.
+ *
+ * That protocol is nobody's product. It is the shape a Responses-speaking
+ * client sends and expects, and several hosted runtimes speak it. So it lives
+ * here as a dialect on its own, and the runtimes that CONFIGURE it — their
+ * paths, their ports, their probe bodies, their session aliases — live in their
+ * own files beside this one. Keeping the split means the next runtime that
+ * speaks Responses is a configuration rather than a copy, and it means no
+ * vendor's spelling ends up in the protocol.
+ *
+ * ── The subset ───────────────────────────────────────────────────────────────
+ * A text turn, streamed or not, with a session. Deliberately not the whole
+ * Responses API: tool calls, reasoning items, image/file input, structured
+ * output and function-call output are NOT carried, and each is REFUSED by name
+ * rather than dropped — a request whose content this dialect cannot represent
+ * is answered 400 before a turn is paid for, never answered 200 with the parts
+ * it happened to understand.
+ *
+ * @example  A host that speaks Responses on paths of its own choosing
+ *   httpHost({
+ *     name: 'myResponsesHost',
+ *     wire: responsesWire({ defaultModel: 'my-agent' }),
+ *     invokePath: '/responses',
+ *     healthPath: '/health',
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.responsesWire = exports.readResponsesSession = exports.readResponsesInput = exports.PUBLIC_FAILURE_MESSAGE = exports.DEFAULT_SESSION_FIELDS = void 0;
+const node_crypto_1 = require("node:crypto");
+const errors_js_1 = require("../../hosting/errors.js");
+/** Body fields that may carry a session id, in the order they are consulted. */
+exports.DEFAULT_SESSION_FIELDS = ['conversation', 'session_id'];
+/**
+ * What a caller is told when a handler THREW.
+ *
+ * A thrown error's message is the author's note to their own logs — a query, a
+ * path, a token in a connection string — and none of it is the caller's. A
+ * handler that CHOSE to fail chose its words for the caller, so those travel
+ * unchanged. The host tells this dialect which happened; it never guesses from
+ * the message.
+ */
+exports.PUBLIC_FAILURE_MESSAGE = 'The agent could not complete this request.';
+const DEFAULT_MODEL = 'agentfootprint';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function nonEmptyString(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : undefined;
+}
+/**
+ * The text of one message's content, or a refusal naming what was in it.
+ *
+ * Every non-text part is refused rather than skipped: a resume with an attached
+ * image, silently reduced to the text around it, is a wrong answer delivered
+ * confidently.
+ */
+function inputTextFromContent(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content)) {
+        throw new errors_js_1.WireRequestRefusal('unsupported_input', 'message content must be text or an array of input_text parts');
+    }
+    const text = [];
+    for (const part of content) {
+        if (!isRecord(part) || part.type !== 'input_text' || typeof part.text !== 'string') {
+            const kind = isRecord(part) && typeof part.type === 'string' ? part.type : 'unknown';
+            throw new errors_js_1.WireRequestRefusal('unsupported_input', `this dialect carries text input only; '${kind}' input is not supported`);
+        }
+        text.push(part.text);
+    }
+    return text.join('');
+}
+/** The turn's text: a bare string, or the user message items that carry it. */
+function readResponsesInput(input) {
+    if (typeof input === 'string')
+        return input;
+    if (input === undefined || input === null) {
+        throw new errors_js_1.WireRequestRefusal('invalid_input', 'input is required');
+    }
+    if (!Array.isArray(input)) {
+        throw new errors_js_1.WireRequestRefusal('invalid_input', 'input must be text or an array of Responses message items');
+    }
+    const messages = [];
+    for (const item of input) {
+        if (!isRecord(item)) {
+            throw new errors_js_1.WireRequestRefusal('invalid_input', 'each input item must be an object');
+        }
+        // `type` is optional in the Responses grammar for a plain message.
+        if (item.type !== undefined && item.type !== 'message') {
+            throw new errors_js_1.WireRequestRefusal('unsupported_input', `this dialect carries message items only; '${String(item.type)}' items are not supported`);
+        }
+        if (item.role !== 'user') {
+            throw new errors_js_1.WireRequestRefusal('unsupported_input', `this dialect carries user messages only; role '${String(item.role)}' is not supported`);
+        }
+        messages.push(inputTextFromContent(item.content));
+    }
+    return messages.join('\n\n');
+}
+exports.readResponsesInput = readResponsesInput;
+/** The session this request claims, by whichever of its aliases it used. */
+function readResponsesSession(body, fields) {
+    for (const field of fields) {
+        const value = body[field];
+        // `conversation` is an object in the Responses grammar and a bare string in
+        // several dialects of it. Both are read, because refusing the spelling a
+        // client already sends teaches nothing.
+        const found = isRecord(value) ? nonEmptyString(value.id) : nonEmptyString(value);
+        if (found !== undefined)
+            return found;
+    }
+    return undefined;
+}
+exports.readResponsesSession = readResponsesSession;
+function identityFor(facts, options) {
+    const body = facts?.body ?? {};
+    const nonce = (0, node_crypto_1.randomUUID)().replaceAll('-', '');
+    return {
+        responseId: `resp_${nonce}`,
+        messageId: `msg_${nonce}`,
+        createdAt: Math.floor(Date.now() / 1000),
+        model: nonEmptyString(body.model) ?? options.defaultModel,
+        sessionId: readResponsesSession(body, options.sessionFields),
+    };
+}
+function outputPart(text) {
+    return { type: 'output_text', text, annotations: [], logprobs: [] };
+}
+function outputItem(identity, text, status) {
+    return {
+        id: identity.messageId,
+        type: 'message',
+        status,
+        role: 'assistant',
+        content: status === 'completed' ? [outputPart(text)] : [],
+    };
+}
+function responseObject(identity, status, text = '', error = null) {
+    return {
+        id: identity.responseId,
+        object: 'response',
+        created_at: identity.createdAt,
+        status,
+        error,
+        incomplete_details: null,
+        instructions: null,
+        parallel_tool_calls: true,
+        model: identity.model,
+        output: status === 'completed' ? [outputItem(identity, text, 'completed')] : [],
+        conversation: identity.sessionId === undefined ? null : { id: identity.sessionId },
+        usage: null,
+    };
+}
+/**
+ * What a caller may be told about a failure.
+ *
+ * A refusal this library authored carries a `code` and says what it says. A
+ * handler that threw carries none, and its words do not travel.
+ */
+function errorBody(message, code, origin) {
+    if (origin === 'threw') {
+        return { code: 'server_error', message: exports.PUBLIC_FAILURE_MESSAGE, type: 'server_error' };
+    }
+    return code === undefined
+        ? { code: 'server_error', message, type: 'server_error' }
+        : { code, message, type: 'invalid_request_error' };
+}
+/**
+ * The nine-event lifecycle one streamed response is made of.
+ *
+ * Holds this response's identity and its sequence counter, which is why it is
+ * built per request: two callers sharing a counter would each see a stream that
+ * skips numbers, and two sharing an id would see each other's response.
+ */
+function responsesFraming(identity) {
+    let sequence = 0;
+    let outputStarted = false;
+    let streamed = '';
+    let sawDelta = false;
+    const frame = (event, fields) => ({
+        event,
+        data: { type: event, sequence_number: sequence++, ...fields },
+    });
+    /**
+     * The two frames that must precede any text. Emitted on the first delta
+     * rather than at open, because a response that fails before producing a word
+     * never opened an output item and should not claim it did.
+     */
+    const begin = () => {
+        if (outputStarted)
+            return [];
+        outputStarted = true;
+        return [
+            frame('response.output_item.added', {
+                output_index: 0,
+                item: outputItem(identity, '', 'in_progress'),
+            }),
+            frame('response.content_part.added', {
+                item_id: identity.messageId,
+                output_index: 0,
+                content_index: 0,
+                part: outputPart(''),
+            }),
+        ];
+    };
+    const delta = (text) => {
+        if (text === '')
+            return [];
+        const frames = begin();
+        sawDelta = true;
+        streamed += text;
+        frames.push(frame('response.output_text.delta', {
+            item_id: identity.messageId,
+            output_index: 0,
+            content_index: 0,
+            delta: text,
+            logprobs: [],
+        }));
+        return frames;
+    };
+    return {
+        open: () => [
+            frame('response.created', { response: responseObject(identity, 'in_progress') }),
+            frame('response.in_progress', { response: responseObject(identity, 'in_progress') }),
+        ],
+        chunk: (text) => delta(text),
+        complete: (output) => {
+            const frames = [];
+            // A handler that streamed nothing still owes the caller its text, and one
+            // that streamed a PREFIX of it owes the rest. Anything else — a final
+            // output that contradicts what was streamed — is left as it was streamed:
+            // frames already on the wire cannot be taken back, and re-sending the
+            // whole text would duplicate what the caller already rendered.
+            if (!sawDelta)
+                frames.push(...delta(output));
+            else if (output.startsWith(streamed) && output.length > streamed.length) {
+                frames.push(...delta(output.slice(streamed.length)));
+            }
+            frames.push(...begin());
+            // THE COMPLETION IS AUTHORITATIVE — this library's law, and it outranks
+            // the protocol's own tidiness. When a handler's chunks were a preview of
+            // different final text rather than a prefix of it, the deltas already on
+            // the wire cannot be recalled, and this reports the ANSWER rather than
+            // the preview. The two then disagree, which is a documented limit of
+            // streaming a preview; reporting the preview as the answer would be a
+            // wrong answer, which is not.
+            const text = output;
+            frames.push(frame('response.output_text.done', {
+                item_id: identity.messageId,
+                output_index: 0,
+                content_index: 0,
+                text,
+                logprobs: [],
+            }), frame('response.content_part.done', {
+                item_id: identity.messageId,
+                output_index: 0,
+                content_index: 0,
+                part: outputPart(text),
+            }), frame('response.output_item.done', {
+                output_index: 0,
+                item: outputItem(identity, text, 'completed'),
+            }), frame('response.completed', { response: responseObject(identity, 'completed', text) }));
+            return frames;
+        },
+        failure: (message, code, origin) => [
+            frame('response.failed', {
+                response: responseObject(identity, 'failed', '', errorBody(message, code, origin)),
+            }),
+        ],
+    };
+}
+/**
+ * An `HttpWire` speaking the Responses protocol.
+ *
+ * Pair it with `httpHost` and the paths your deployment contract names. The
+ * host keeps its own promises — draining, aborting on disconnect, failing a
+ * handler that throws or answers nothing — and this supplies only the dialect.
+ */
+function responsesWire(options = {}) {
+    const resolved = {
+        defaultModel: options.defaultModel ?? DEFAULT_MODEL,
+        sessionFields: options.sessionFields ?? exports.DEFAULT_SESSION_FIELDS,
+    };
+    const health = options.health ?? { status: 'ok' };
+    return {
+        readRequest(facts) {
+            const input = readResponsesInput(facts.body.input);
+            if (input.trim() === '') {
+                throw new errors_js_1.WireRequestRefusal('invalid_input', 'input text must not be empty');
+            }
+            const sessionId = readResponsesSession(facts.body, resolved.sessionFields);
+            return { input, ...(sessionId === undefined ? {} : { sessionId }) };
+        },
+        // This dialect's callers choose in the body and never touch `Accept`.
+        wantsStream: (facts) => facts.body.stream === true,
+        stream: (facts) => responsesFraming(identityFor(facts, resolved)),
+        health: () => health,
+        output: (output, facts) => responseObject(identityFor(facts, resolved), 'completed', output),
+        chunk: (text) => ({ type: 'response.output_text.delta', delta: text }),
+        failure: (message, code, facts, origin) => {
+            // A terminal that ended an ACCEPTED response is reported as a failed
+            // response object — that is what the protocol says a response that got
+            // as far as running and then stopped looks like. A coded refusal ended
+            // the REQUEST before any of that, and gets the error envelope a client
+            // reads off a 4xx.
+            if (code === undefined) {
+                return responseObject(identityFor(facts, resolved), 'failed', '', errorBody(message, undefined, origin));
+            }
+            return { error: errorBody(message, code, origin) };
+        },
+    };
+}
+exports.responsesWire = responsesWire;
+//# sourceMappingURL=responsesWire.js.map

package/dist/adapters/hosting/responsesWire.js.map

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

package/dist/esm/adapters/hosting/foundryResponses.d.ts

@@ -0,0 +1,89 @@
+/**
+ * adapters/hosting/foundryResponses — an agent behind Microsoft Foundry's
+ * hosted-agent contract.
+ *
+ * ── The split, and why it is here ────────────────────────────────────────────
+ * Two different things are needed to serve a Foundry hosted agent, and only one
+ * of them is Microsoft's:
+ *
+ *   • The **Responses protocol** — `input` items, a `response` object, the
+ *     named streaming lifecycle. That is a protocol several runtimes speak, so
+ *     it lives in `responsesWire.ts` with no vendor in it.
+ *   • The **hosting contract** — port 8088, `POST /responses`, a `HEAD` probe
+ *     on the same path, `GET /readiness` answering `{"status":"healthy"}`, and
+ *     `agent_session_id` as a session alias. That IS this runtime's contract,
+ *     the same way `/invocations` and `X-Amzn-…` are another's, and it is what
+ *     this file supplies.
+ *
+ * So this file is a configuration, not an implementation. Everything hard —
+ * draining on close, aborting when the caller hangs up, failing a handler that
+ * throws or answers nothing — is `httpHost`'s, shared with every other adapter
+ * rather than reimplemented here where the two would drift.
+ *
+ * ── What it does NOT do ──────────────────────────────────────────────────────
+ * **Workflow Visualizer topology is not provided.** The Inspector can invoke
+ * this host and render its answer; it does not learn that the answer came from
+ * four composed agents, because nothing in the Responses protocol carries that
+ * and inventing a channel for it would be claiming a compatibility this has
+ * never demonstrated. An agent's internal structure is readable from
+ * agentfootprint's own recorders.
+ *
+ * Everything the protocol does not carry — tool calls, image and file input,
+ * function-call output, structured output — is refused by name. See
+ * `responsesWire.ts`.
+ *
+ * This is an **inbound hosting adapter**: it is the door callers arrive at. It
+ * is not a model provider, and it has nothing to do with which model the agent
+ * calls — for Foundry models, that is `openai()` with the endpoint's base URL.
+ *
+ * @example  An agent behind the Inspector
+ *   import { foundryResponsesHost, memorySessions, standingAgent } from 'agentfootprint/hosting';
+ *
+ *   const handle = await standingAgent({
+ *     agent,
+ *     sessions: memorySessions(),
+ *     host: foundryResponsesHost(),
+ *   });
+ *   process.on('SIGTERM', () => void handle.close());
+ */
+/// <reference types="node" />
+import type { IncomingMessage, Server, ServerResponse } from 'node:http';
+import { type HttpHost } from '../../hosting/httpHost.js';
+/** The port a Foundry hosted agent is expected on. */
+export declare const DEFAULT_FOUNDRY_PORT = 8088;
+/** The path that takes a turn. */
+export declare const FOUNDRY_INVOKE_PATH = "/responses";
+/** The path a Foundry hosted agent answers a readiness probe on. */
+export declare const FOUNDRY_READINESS_PATH = "/readiness";
+/**
+ * Session aliases this contract accepts, in precedence order.
+ *
+ * `conversation` is the protocol's own; `agent_session_id` is this runtime's;
+ * `session_id` is the spelling several clients send anyway. First one present
+ * wins, so a caller using any of the three reaches the same session.
+ */
+export declare const FOUNDRY_SESSION_FIELDS: readonly string[];
+export interface FoundryResponsesHostOptions {
+    /** Port to bind. Default {@link DEFAULT_FOUNDRY_PORT}. Pass `0` for an ephemeral test port. */
+    readonly port?: number;
+    /** Interface to bind. Default `'0.0.0.0'` — a container's door has to be reachable from outside it. */
+    readonly hostname?: string;
+    /** Model label echoed in `response` objects when the request names none. */
+    readonly model?: string;
+    /** Ceiling on a request body. Default one mebibyte. */
+    readonly maxBodyBytes?: number;
+    /**
+     * A `node:http` server you own, to ATTACH these routes to rather than binding
+     * one. Refused together with `port`/`hostname`, which would name a socket
+     * this host does not bind.
+     */
+    readonly server?: Server;
+    /** Answer a path this host does not own. Private-server mode only. */
+    readonly onUnhandled?: (req: IncomingMessage, res: ServerResponse) => void;
+}
+/**
+ * An {@link HttpHost} speaking Foundry's hosted-agent contract.
+ *
+ * @param options - Port, interface, model label and body ceiling.
+ */
+export declare function foundryResponsesHost(options?: FoundryResponsesHostOptions): HttpHost;

package/dist/esm/adapters/hosting/foundryResponses.js

@@ -0,0 +1,106 @@
+/**
+ * adapters/hosting/foundryResponses — an agent behind Microsoft Foundry's
+ * hosted-agent contract.
+ *
+ * ── The split, and why it is here ────────────────────────────────────────────
+ * Two different things are needed to serve a Foundry hosted agent, and only one
+ * of them is Microsoft's:
+ *
+ *   • The **Responses protocol** — `input` items, a `response` object, the
+ *     named streaming lifecycle. That is a protocol several runtimes speak, so
+ *     it lives in `responsesWire.ts` with no vendor in it.
+ *   • The **hosting contract** — port 8088, `POST /responses`, a `HEAD` probe
+ *     on the same path, `GET /readiness` answering `{"status":"healthy"}`, and
+ *     `agent_session_id` as a session alias. That IS this runtime's contract,
+ *     the same way `/invocations` and `X-Amzn-…` are another's, and it is what
+ *     this file supplies.
+ *
+ * So this file is a configuration, not an implementation. Everything hard —
+ * draining on close, aborting when the caller hangs up, failing a handler that
+ * throws or answers nothing — is `httpHost`'s, shared with every other adapter
+ * rather than reimplemented here where the two would drift.
+ *
+ * ── What it does NOT do ──────────────────────────────────────────────────────
+ * **Workflow Visualizer topology is not provided.** The Inspector can invoke
+ * this host and render its answer; it does not learn that the answer came from
+ * four composed agents, because nothing in the Responses protocol carries that
+ * and inventing a channel for it would be claiming a compatibility this has
+ * never demonstrated. An agent's internal structure is readable from
+ * agentfootprint's own recorders.
+ *
+ * Everything the protocol does not carry — tool calls, image and file input,
+ * function-call output, structured output — is refused by name. See
+ * `responsesWire.ts`.
+ *
+ * This is an **inbound hosting adapter**: it is the door callers arrive at. It
+ * is not a model provider, and it has nothing to do with which model the agent
+ * calls — for Foundry models, that is `openai()` with the endpoint's base URL.
+ *
+ * @example  An agent behind the Inspector
+ *   import { foundryResponsesHost, memorySessions, standingAgent } from 'agentfootprint/hosting';
+ *
+ *   const handle = await standingAgent({
+ *     agent,
+ *     sessions: memorySessions(),
+ *     host: foundryResponsesHost(),
+ *   });
+ *   process.on('SIGTERM', () => void handle.close());
+ */
+import { httpHost } from '../../hosting/httpHost.js';
+import { responsesWire } from './responsesWire.js';
+/** The port a Foundry hosted agent is expected on. */
+export const DEFAULT_FOUNDRY_PORT = 8088;
+/** The path that takes a turn. */
+export const FOUNDRY_INVOKE_PATH = '/responses';
+/** The path a Foundry hosted agent answers a readiness probe on. */
+export const FOUNDRY_READINESS_PATH = '/readiness';
+/**
+ * Session aliases this contract accepts, in precedence order.
+ *
+ * `conversation` is the protocol's own; `agent_session_id` is this runtime's;
+ * `session_id` is the spelling several clients send anyway. First one present
+ * wins, so a caller using any of the three reaches the same session.
+ */
+export const FOUNDRY_SESSION_FIELDS = [
+    'conversation',
+    'agent_session_id',
+    'session_id',
+];
+/**
+ * One mebibyte: large enough for any resume or job description this door was
+ * built to carry, small enough that a hostile caller cannot spend the heap.
+ */
+const DEFAULT_MAX_BODY_BYTES = 1_048_576;
+/**
+ * An {@link HttpHost} speaking Foundry's hosted-agent contract.
+ *
+ * @param options - Port, interface, model label and body ceiling.
+ */
+export function foundryResponsesHost(options = {}) {
+    const { server, onUnhandled, model, hostname } = options;
+    // `port` and `hostname` name a socket a caller-owned server already bound, so
+    // they are passed only when this host is the one binding. Defaulting the port
+    // unconditionally would turn "attach to my server" into a refusal.
+    const socket = server
+        ? { server }
+        : {
+            port: options.port ?? DEFAULT_FOUNDRY_PORT,
+            ...(hostname === undefined ? {} : { hostname }),
+            ...(onUnhandled === undefined ? {} : { onUnhandled }),
+        };
+    return httpHost({
+        name: 'foundryResponsesHost',
+        wire: responsesWire({
+            ...(model === undefined ? {} : { defaultModel: model }),
+            sessionFields: FOUNDRY_SESSION_FIELDS,
+            health: { status: 'healthy' },
+        }),
+        invokePath: FOUNDRY_INVOKE_PATH,
+        healthPath: FOUNDRY_READINESS_PATH,
+        // The Inspector asks whether the door is there before it uses it.
+        invokeHeadProbe: true,
+        maxBodyBytes: options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES,
+        ...socket,
+    });
+}
+//# sourceMappingURL=foundryResponses.js.map

package/dist/esm/adapters/hosting/foundryResponses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundryResponses.js","sourceRoot":"","sources":["../../../../src/adapters/hosting/foundryResponses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAIH,OAAO,EAAE,QAAQ,EAAiB,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,sDAAsD;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,kCAAkC;AAClC,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEhD,oEAAoE;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,cAAc;IACd,kBAAkB;IAClB,YAAY;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAqBzC;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAuC,EAAE;IAC5E,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACzD,8EAA8E;IAC9E,8EAA8E;IAC9E,mEAAmE;IACnE,MAAM,MAAM,GAAG,MAAM;QACnB,CAAC,CAAC,EAAE,MAAM,EAAE;QACZ,CAAC,CAAC;YACE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,oBAAoB;YAC1C,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;YAC/C,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;SACtD,CAAC;IAEN,OAAO,QAAQ,CAAC;QACd,IAAI,EAAE,sBAAsB;QAC5B,IAAI,EAAE,aAAa,CAAC;YAClB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;YACvD,aAAa,EAAE,sBAAsB;YACrC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;SAC9B,CAAC;QACF,UAAU,EAAE,mBAAmB;QAC/B,UAAU,EAAE,sBAAsB;QAClC,kEAAkE;QAClE,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,sBAAsB;QAC5D,GAAG,MAAM;KACV,CAAC,CAAC;AACL,CAAC"}