agentfootprint 9.63.0 → 9.65.0

package/dist/esm/core/agent/toolArgsValidation.js

@@ -2,8 +2,10 @@
  * toolArgsValidation — validate LLM-produced tool args against the tool's
  * declared `inputSchema` BEFORE dispatch (backlog #9).
  *
- * Pattern: pure function module — no state, no events; the toolCalls stage
- *          owns when to call it and what to do with the verdict.
+ * Pattern: pure function module — no events, and no state beyond one compiled-
+ *          regex cache (which doubles as the warn-once ledger for `pattern`s
+ *          that do not compile); the toolCalls stage owns when to call it and
+ *          what to do with the verdict.
  * Role:    The model writes tool args as free-form JSON; nothing guaranteed
  *          they match the schema the tool advertised. Dispatching garbage
  *          surfaced as deep tool stack traces (or worse, silent misbehavior).
@@ -14,25 +16,136 @@
  * ── Honest-subset contract ────────────────────────────────────────────────
  * This is NOT a full JSON Schema implementation. It enforces the core that
  * tool schemas in the wild actually use, and IGNORES everything else
- * (permissive on unknown keywords — a schema using `pattern`/`oneOf`/`$ref`
- * still validates the supported core, never false-rejects on the rest):
+ * (permissive on unknown keywords — a schema using `oneOf`/`$ref` still
+ * validates the supported core, never false-rejects on the rest):
  *
  *   ENFORCED: `type` (object/array/string/number/integer/boolean/null,
  *             union arrays), `required`, `properties` (recursive),
  *             `items` (single-schema, recursive), `enum` (primitives),
- *             `additionalProperties: false` ONLY when explicitly set.
- *   IGNORED:  format, pattern, min/max*, oneOf/anyOf/allOf/not, $ref,
+ *             `additionalProperties: false` ONLY when explicitly set,
+ *             and the STRING SHAPE keywords `pattern` / `minLength` /
+ *             `maxLength`.
+ *   IGNORED:  format, numeric min/max, oneOf/anyOf/allOf/not, $ref,
  *             const, dependencies, …
  *
- * ── Security: never echo VALUES ───────────────────────────────────────────
- * Issues name the PATH, the EXPECTED shape, and the TYPE of what arrived —
- * never the supplied value itself. The message flows into history (LLM),
- * the emit channel, and traces; arg values can carry PII or injection
- * payloads. Enum expectations echo SCHEMA values only (already LLM-visible
- * in the tools block).
+ * ── Why string SHAPE joined the subset ────────────────────────────────────
+ * A tool result ended with an offer ("I can also map these ids to volume
+ * names"); the person answered "yes please"; the model bound that sentence as
+ * the IDENTIFIER argument and dispatched. The tool's schema declared the
+ * identifier's shape and this boundary did not read it, so a call that could
+ * never succeed cost a round trip — and the consumer hand-rolled an
+ * affirmative blocklist to do what the declaration already said. A declared
+ * shape a boundary ignores is worse than no declaration: the author believes
+ * it is enforced.
+ *
+ * `pattern` is JSON Schema's own semantics — UNANCHORED, ECMA-262, applied to
+ * strings only. A regex the schema author got wrong must never take dispatch
+ * with it: it is compiled once, and a compile failure degrades to no-pattern
+ * plus one developer warning.
+ *
+ * ── Security: what an issue may echo ──────────────────────────────────────
+ * `type` / `enum` / `required` / `additionalProperties` issues name the PATH,
+ * the EXPECTED shape, and the TYPE of what arrived — never the supplied value.
+ * Enum expectations echo SCHEMA values only (already LLM-visible in the tools
+ * block).
+ *
+ * String-SHAPE issues are the one exception, and it is a narrow one: the
+ * complaint IS the value's shape, so `expected string, got string` teaches
+ * nothing and the correction cannot converge. They carry `value` — a capped
+ * excerpt ({@link MAX_VALUE_CHARS}) of the offending string — plus `hint`, the
+ * parameter's own `description`, which is where an author writes what the
+ * identifier looks like. Neither adds exposure: the value is the model's own
+ * tool-call argument, already verbatim in the history this message is appended
+ * to. The OTel adapter renders `path`/`expected`/`got` only, so third-party
+ * telemetry stays value-free either way.
  */
 /** Cap so a pathological schema/args pair can't flood history or events. */
 const MAX_ISSUES = 10;
+/** Ceiling on the echoed excerpt of an offending string. Enough to recognize
+ *  a sentence bound where an identifier belonged; short enough that a 5 MB
+ *  argument cannot ride the message into history. */
+const MAX_VALUE_CHARS = 80;
+/**
+ * Ceiling on compiled `pattern`s held. Schemas are finite in a process, so
+ * this is a fence against dynamically-minted ones rather than a tuning knob:
+ * past it, patterns compile per call (and a broken one warns again) instead of
+ * the map growing without bound.
+ */
+const MAX_CACHED_PATTERNS = 256;
+/**
+ * Compiled `pattern`s, and the warn-once ledger for the broken ones. A `null`
+ * entry means "this pattern does not compile" — recorded so a schema bug is
+ * reported once to the developer rather than once per dispatch.
+ */
+const patternCache = new Map();
+function compilePattern(pattern) {
+    const cached = patternCache.get(pattern);
+    if (cached !== undefined)
+        return cached;
+    let compiled = null;
+    try {
+        // No flags: JSON Schema `pattern` is an unanchored ECMA-262 match, and a
+        // `g` flag would make the RegExp stateful across calls.
+        compiled = new RegExp(pattern);
+    }
+    catch {
+        console.warn(`[agentfootprint] a tool inputSchema declares a \`pattern\` that is not a valid regular ` +
+            `expression (${pattern}) — it is IGNORED, so this argument's shape is NOT enforced. ` +
+            `Fix the expression or drop the keyword.`);
+    }
+    if (patternCache.size < MAX_CACHED_PATTERNS)
+        patternCache.set(pattern, compiled);
+    return compiled;
+}
+/** A length bound this validator will act on: a non-negative integer. Anything
+ *  else is outside the honest subset and ignored rather than guessed at. */
+function lengthBound(raw) {
+    return typeof raw === 'number' && Number.isInteger(raw) && raw >= 0 ? raw : undefined;
+}
+function excerptOf(value) {
+    return value.length <= MAX_VALUE_CHARS ? value : `${value.slice(0, MAX_VALUE_CHARS)}…`;
+}
+function descriptionOf(schema) {
+    const raw = schema.description;
+    if (typeof raw !== 'string')
+        return undefined;
+    const trimmed = raw.trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+/**
+ * The string SHAPE keywords. At most ONE issue per argument: `pattern`
+ * describes the value completely, so adding "and it is too short" is a second
+ * sentence about one mistake.
+ */
+function checkStringShape(value, schema, path, issues) {
+    const hint = descriptionOf(schema);
+    const teach = (expected, got) => {
+        issues.push({
+            path,
+            expected,
+            got,
+            value: excerptOf(value),
+            ...(hint !== undefined && { hint }),
+        });
+    };
+    const pattern = schema.pattern;
+    if (typeof pattern === 'string') {
+        const regex = compilePattern(pattern);
+        if (regex !== null && !regex.test(value)) {
+            teach(`a string matching ${pattern}`, 'string');
+            return;
+        }
+    }
+    const min = lengthBound(schema.minLength);
+    if (min !== undefined && value.length < min) {
+        teach(`a string of at least ${min} characters`, `string of length ${value.length}`);
+        return;
+    }
+    const max = lengthBound(schema.maxLength);
+    if (max !== undefined && value.length > max) {
+        teach(`a string of at most ${max} characters`, `string of length ${value.length}`);
+    }
+}
 function typeNameOf(value) {
     if (value === null)
         return 'null';
@@ -94,6 +207,12 @@ function validateNode(value, schema, path, issues) {
             return;
         }
     }
+    // String SHAPE — same place, same dial, same result shape as `type`/`enum`
+    // above. Applies to strings only, which is JSON Schema's own rule.
+    if (typeof value === 'string') {
+        checkStringShape(value, schema, path, issues);
+        return;
+    }
     // Object keywords.
     if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
         const record = value;
@@ -169,17 +288,22 @@ export function validateToolArgs(args, inputSchema) {
     return { ok: issues.length === 0, issues };
 }
 /**
- * Render the MODEL-VISIBLE tool result for a rejected call. Names paths,
- * expectations, and received TYPES — never received values. The model
- * already has the full schema in its tools block; pointing at the issues
- * is what makes the retry converge.
+ * Render the MODEL-VISIBLE tool result for a rejected call. Names paths and
+ * expectations; reports received TYPES for structural issues and the capped
+ * offending VALUE for string-shape ones, because a shape complaint that will
+ * not say which string it is about cannot be acted on. `JSON.stringify` quotes
+ * and escapes the excerpt, so a multi-line argument stays one line.
+ *
+ * The parameter's own `description` follows on its own line when the schema
+ * declares one: that sentence is usually the whole correction.
  */
 export function formatToolArgIssues(toolName, issues) {
     const lines = issues.map((issue) => {
         const where = issue.path === '' ? 'arguments' : `'${issue.path}'`;
-        return issue.expected === 'required'
+        const head = issue.expected === 'required'
             ? `- ${where} is required but missing`
-            : `- ${where}: expected ${issue.expected}, got ${issue.got}`;
+            : `- ${where}: expected ${issue.expected}, got ${issue.value === undefined ? issue.got : JSON.stringify(issue.value)}`;
+        return issue.hint === undefined ? head : `${head}\n  ${where} is described as: ${issue.hint}`;
     });
     return (`Invalid arguments for tool '${toolName}' — the call was not executed.\n` +
         `${lines.join('\n')}\n` +

package/dist/esm/core/agent/toolArgsValidation.js.map

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

package/dist/esm/core/agent/types.d.ts

@@ -204,12 +204,17 @@ export interface AgentOptions {
      * are validated against the tool's declared `inputSchema` BEFORE dispatch.
      * On mismatch the tool is NOT executed — the model receives a structured
      * retry message as the tool result (paths + expected shapes + received
-     * TYPES, never the supplied values) and corrects itself on the next
-     * iteration. Emits `agentfootprint.validation.args_invalid`.
+     * TYPES) and corrects itself on the next iteration. Emits
+     * `agentfootprint.validation.args_invalid`.
      * `'warn'` emits the event but executes anyway; `'off'` disables.
      * Validation is an honest JSON-Schema subset (type/required/properties/
-     * items/enum/explicit additionalProperties:false) — unsupported keywords
-     * are ignored, never false-rejecting.
+     * items/enum/explicit additionalProperties:false, plus the string SHAPE
+     * keywords pattern/minLength/maxLength) — unsupported keywords are
+     * ignored, never false-rejecting.
+     *
+     * A string-shape refusal quotes a CAPPED excerpt of the offending value
+     * and the parameter's own `description`, because "expected string, got
+     * string" cannot be acted on; every other issue still names types only.
      */
     readonly toolArgValidation?: ToolArgValidationMode;
     /**

package/dist/esm/events/payloads.d.ts

@@ -951,6 +951,15 @@ export interface ValidationArgsInvalidPayload {
         readonly path: string;
         readonly expected: string;
         readonly got: string;
+        /**
+         * A capped excerpt of the offending STRING — present on string-shape
+         * issues (`pattern` / `minLength` / `maxLength`) only, where the
+         * complaint IS the value's shape. Structural issues (type, enum,
+         * required, additionalProperties) still carry no value at all.
+         */
+        readonly value?: string;
+        /** The parameter's own schema `description`, when it declares one. */
+        readonly hint?: string;
     }>;
     readonly enforced: boolean;
 }

package/dist/esm/hosting/errors.d.ts

@@ -480,4 +480,47 @@ export declare class SessionsNotCarriedError extends Error {
  *   // or branch instead of insisting:
  *   if (host.capabilities.includes('streaming')) { ... }
  */
+/**
+ * Thrown when a request body exceeds the ceiling the host was given.
+ *
+ * A body is memory this process pays for while somebody else fills it, so a
+ * host with a ceiling stops reading at it rather than discovering the limit as
+ * an out-of-memory kill. The read is abandoned at the byte that crossed the
+ * line — nothing further is buffered, and the bytes already read are dropped.
+ *
+ * There is no default ceiling: see `HttpHostOptions.maxBodyBytes` for why the
+ * absence is deliberate and what it costs.
+ */
+export declare class RequestTooLargeError extends Error {
+    readonly limitBytes: number;
+    readonly code: "ERR_REQUEST_TOO_LARGE";
+    constructor(limitBytes: number, hostName: string);
+}
+/**
+ * A dialect's refusal of THIS request — its own status, its own code.
+ *
+ * `readRequest` is a wire's one chance to look at a body before a turn is paid
+ * for, and some dialects can tell from the shape alone that they cannot serve
+ * it: an input item kind this dialect does not carry, a field whose type is
+ * wrong. Throwing this says so with a status the caller can act on, instead of
+ * a 500 that reads as "the server broke" for a request the caller could fix.
+ *
+ * The distinction it keeps: this is the REQUEST being wrong. A dialect that
+ * throws anything else from `readRequest` still gets that request's 500, which
+ * is the honest answer when the dialect itself is what failed.
+ *
+ * @example  A dialect refusing an input kind it does not carry
+ *   throw new WireRequestRefusal(
+ *     'unsupported_input',
+ *     'image input is not carried by this dialect',
+ *   );
+ */
+export declare class WireRequestRefusal extends Error {
+    readonly code: string;
+    /** HTTP status for this refusal. Default 400 — the request is what is wrong. */
+    readonly status: number;
+    constructor(code: string, detail: string, 
+    /** HTTP status for this refusal. Default 400 — the request is what is wrong. */
+    status?: number);
+}
 export declare function requireCapability(host: AgentHost | ConversationHost, capability: HostCapability): void;

package/dist/esm/hosting/errors.js

@@ -718,6 +718,58 @@ export class SessionsNotCarriedError extends Error {
  *   // or branch instead of insisting:
  *   if (host.capabilities.includes('streaming')) { ... }
  */
+/**
+ * Thrown when a request body exceeds the ceiling the host was given.
+ *
+ * A body is memory this process pays for while somebody else fills it, so a
+ * host with a ceiling stops reading at it rather than discovering the limit as
+ * an out-of-memory kill. The read is abandoned at the byte that crossed the
+ * line — nothing further is buffered, and the bytes already read are dropped.
+ *
+ * There is no default ceiling: see `HttpHostOptions.maxBodyBytes` for why the
+ * absence is deliberate and what it costs.
+ */
+export class RequestTooLargeError extends Error {
+    limitBytes;
+    code = 'ERR_REQUEST_TOO_LARGE';
+    constructor(limitBytes, hostName) {
+        super(`[hosting] the '${hostName}' host refuses a request body over ${String(limitBytes)} ` +
+            `bytes. Raise maxBodyBytes if this deployment genuinely carries larger requests.`);
+        this.limitBytes = limitBytes;
+        this.name = 'RequestTooLargeError';
+    }
+}
+/**
+ * A dialect's refusal of THIS request — its own status, its own code.
+ *
+ * `readRequest` is a wire's one chance to look at a body before a turn is paid
+ * for, and some dialects can tell from the shape alone that they cannot serve
+ * it: an input item kind this dialect does not carry, a field whose type is
+ * wrong. Throwing this says so with a status the caller can act on, instead of
+ * a 500 that reads as "the server broke" for a request the caller could fix.
+ *
+ * The distinction it keeps: this is the REQUEST being wrong. A dialect that
+ * throws anything else from `readRequest` still gets that request's 500, which
+ * is the honest answer when the dialect itself is what failed.
+ *
+ * @example  A dialect refusing an input kind it does not carry
+ *   throw new WireRequestRefusal(
+ *     'unsupported_input',
+ *     'image input is not carried by this dialect',
+ *   );
+ */
+export class WireRequestRefusal extends Error {
+    code;
+    status;
+    constructor(code, detail, 
+    /** HTTP status for this refusal. Default 400 — the request is what is wrong. */
+    status = 400) {
+        super(`[hosting] ${detail}`);
+        this.code = code;
+        this.status = status;
+        this.name = 'WireRequestRefusal';
+    }
+}
 export function requireCapability(host, capability) {
     if (host.capabilities.includes(capability))
         return;

package/dist/esm/hosting/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/hosting/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/hosting/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,GAAG,iBAA0B,CAAC;IAC3C,6BAA6B;IACpB,QAAQ,CAAS;IAE1B,YAAY,QAAgB;QAC1B,KAAK,CACH,kBAAkB,QAAQ,sDAAsD;YAC9E,wFAAwF;YACxF,iDAAiD,CACpD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,oBAA6B,CAAC;IAC9C,gDAAgD;IACvC,SAAS,CAAS;IAC3B,mEAAmE;IAC1D,WAAW,CAAU;IAE9B,YAAY,SAAiB,EAAE,WAAoB;QACjD,KAAK,CACH,sBAAsB,SAAS,+BAA+B;YAC5D,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,yEAAyE;YACzE,mEAAmE;YACnE,4DAA4D;YAC5D,qEAAqE,CACxE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChE,CAAC;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,uBAAgC,CAAC;IACjD,mEAAmE;IAC1D,QAAQ,CAAU;IAC3B,uEAAuE;IAC9D,SAAS,CAAU;IAC5B,mEAAmE;IAC1D,MAAM,CAAU;IAEzB,YAAY,QAAiB,EAAE,SAAkB,EAAE,MAAM,GAAG,KAAK;QAC/D,KAAK,CACH,iDAAiD;YAC/C,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;YACvC,mEAAmE;YACnE,CAAC,MAAM;gBACL,CAAC,CAAC,mDAAmD,MAAM,CAAC,SAAS,CAAC,aAAa;oBACjF,0EAA0E;oBAC1E,+EAA+E;oBAC/E,qEAAqE;gBACvE,CAAC,CAAC,uBAAuB;oBACvB,CAAC,SAAS,KAAK,SAAS;wBACtB,CAAC,CAAC,4EAA4E;4BAC5E,2EAA2E;wBAC7E,CAAC,CAAC,YAAY,SAAS,kDAAkD,CAAC;oBAC5E,6DAA6D,CAAC,CACrE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACrD,IAAI,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,GAAG,uBAAgC,CAAC;IACjD,mCAAmC;IAC1B,SAAS,CAAS;IAC3B,6EAA6E;IACpE,OAAO,CAAa;IAE7B,YAAY,SAAiB,EAAE,OAAmB;QAChD,MAAM,KAAK,GACT,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,IAAI,YAAY,CAAC;QAChG,KAAK,CACH,sBAAsB,SAAS,4BAA4B;YACzD,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;YACpE,gFAAgF;YAChF,gFAAgF;YAChF,mEAAmE;YACnE,0EAA0E;YAC1E,+EAA+E,CAClF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,GAAG,oBAA6B,CAAC;IAC9C,iDAAiD;IACxC,SAAS,CAAS;IAE3B,YAAY,SAAiB;QAC3B,KAAK,CACH,4DAA4D,SAAS,WAAW;YAC9E,kFAAkF;YAClF,mFAAmF;YACnF,mFAAmF;YACnF,2BAA2B,CAC9B,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,GAAG,yBAAkC,CAAC;IACnD,qCAAqC;IAC5B,QAAQ,CAAS;IAC1B,iEAAiE;IACxD,SAAS,CAAU;IAE5B,YAAY,QAAgB,EAAE,SAAkB;QAC9C,KAAK,CACH,uCAAuC,QAAQ,kBAAkB;YAC/D,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,gFAAgF;YAChF,gFAAgF;YAChF,mFAAmF;YACnF,qBAAqB,CACxB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1D,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,qBAA8B,CAAC;IAC/C,oCAAoC;IAC3B,QAAQ,CAAS;IAC1B,gDAAgD;IACvC,KAAK,CAAS;IACvB,uCAAuC;IAC9B,aAAa,CAAS;IAE/B,YAAY,QAAgB,EAAE,KAAa,EAAE,aAAqB;QAChE,KAAK,CACH,2BAA2B,KAAK,mBAAmB,QAAQ,oBAAoB;YAC7E,oBAAoB,aAAa,oDAAoD;YACrF,+EAA+E;YAC/E,iFAAiF;YACjF,0EAA0E,CAC7E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,qBAA8B,CAAC;IAE/C,YAAY,MAAc;QACxB,KAAK,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,IAAI,GAAG,+BAAwC,CAAC;IAEzD,YAAY,EAAkB;QAC5B,KAAK,CACH,sBAAsB,EAAE,4DAA4D;YAClF,oFAAoF;YACpF,mFAAmF;YACnF,oFAAoF;YACpF,sBAAsB,CACzB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,uBAAgC,CAAC;IAEjD,YAAY,EAAkB;QAC5B,KAAK,CACH,sBAAsB,EAAE,2DAA2D;YACjF,yEAAyE;YACzE,iFAAiF;YACjF,kFAAkF;YAClF,uEAAuE,CAC1E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,GAAG,wBAAiC,CAAC;IAClD,oCAAoC;IAC3B,GAAG,CAAS;IAErB,YAAY,GAAW;QACrB,KAAK,CACH,uBAAuB,GAAG,0DAA0D;YAClF,kFAAkF;YAClF,+EAA+E;YAC/E,yCAAyC,CAC5C,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,GAAG,0BAAmC,CAAC;IACpD,wDAAwD;IAC/C,GAAG,CAAS;IAErB,YAAY,GAAW,EAAE,QAAiB;QACxC,KAAK,CACH,uBAAuB,GAAG,kBAAkB;YAC1C,CAAC,QAAQ,KAAK,SAAS;gBACrB,CAAC,CAAC,QAAQ,QAAQ,8CAA8C;gBAChE,CAAC,CAAC,iDAAiD,CAAC;YACtD,4EAA4E;YAC5E,mFAAmF;YACnF,6CAA6C,CAChD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,aAAa;IACI;IAArB,YAAqB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,uBAAwB,SAAQ,SAAS;IAC3C,IAAI,GAAG,yBAAkC,CAAC;IACnD,4EAA4E;IACnE,SAAS,CAAU;IAC5B,+EAA+E;IACtE,aAAa,CAAS;IAE/B,YAAY,MAAe,EAAE,SAAkB;QAC7C,MAAM,OAAO,GAAG,MAAM,YAAY,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACtF,KAAK,CACH,YAAY;YACV,CAAC,SAAS,KAAK,SAAS;gBACtB,CAAC,CAAC,4CAA4C;gBAC9C,CAAC,CAAC,YAAY,SAAS,sDAAsD,CAAC;YAChF,iFAAiF;YACjF,kFAAkF;YAClF,yDAAyD;YACzD,0CAA0C,OAAO,IAAI;YACrD,2EAA2E;YAC3E,gBAAgB;YAChB,sFAAsF;YACtF,6EAA6E;YAC7E,kBAAkB,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QACxD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,SAAiB;QAC3B,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,uBAAuB,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC,CAAC;QAC5F,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAoCD;;;;;;;;;GASG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,IAAI,GAAG,2BAAoC,CAAC;IACrD,+DAA+D;IACtD,OAAO,CAAuB;IACvC;mEAC+D;IACtD,WAAW,CAAU;IAE9B,YAAY,OAA6B,EAAE,WAAoB;QAC7D,KAAK,CAAC,4CAA4C,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAED,wEAAwE;AACxE,SAAS,WAAW,CAAC,OAA6B,EAAE,WAAoB;IACtE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,WAAW;gBAChB,CAAC,CAAC,gFAAgF;oBAC9E,oFAAoF;oBACpF,mFAAmF;oBACnF,0EAA0E;oBAC1E,8CAA8C;gBAClD,CAAC,CAAC,4EAA4E;oBAC1E,iFAAiF;oBACjF,6EAA6E;oBAC7E,4CAA4C,CAAC;QACrD,KAAK,SAAS;YACZ,OAAO,CACL,mFAAmF;gBACnF,+DAA+D,CAChE,CAAC;QACJ,KAAK,eAAe;YAClB,OAAO,CACL,6EAA6E;gBAC7E,8EAA8E,CAC/E,CAAC;QACJ,KAAK,gBAAgB;YACnB,OAAO,CACL,gFAAgF;gBAChF,+DAA+D,CAChE,CAAC;QACJ,KAAK,cAAc;YACjB,OAAO,CACL,iFAAiF;gBACjF,iDAAiD,CAClD,CAAC;QACJ,KAAK,sBAAsB;YACzB,OAAO,CACL,iFAAiF;gBACjF,iFAAiF;gBACjF,2DAA2D,CAC5D,CAAC;QACJ,KAAK,cAAc;YACjB,OAAO,CACL,+EAA+E;gBAC/E,iFAAiF;gBACjF,+EAA+E,CAChF,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,IAAI,GAAG,mCAA4C,CAAC;IAC7D,2EAA2E;IAClE,QAAQ,CAAS;IAE1B,YAAY,QAAgB,EAAE,MAAe;QAC3C,KAAK,CACH,yDAAyD,QAAQ,uBAAuB;YACtF,SAAS,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,oCAAoC;YACvF,sFAAsF;YACtF,wBAAwB,CAC3B,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,wEAAwE;AAExE;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,GAAG,uBAAgC,CAAC;IACjD,2EAA2E;IAClE,MAAM,CAAU;IAEzB,YAAY,MAAc,EAAE,MAAe;QACzC,KAAK,CAAC,4CAA4C,MAAM,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACjD,CAAC;CACF;AAED,wEAAwE;AAExE;;;;;;;GAOG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,IAAI,GAAG,+BAAwC,CAAC;IACzD,+BAA+B;IACtB,EAAE,CAAS;IAEpB,YAAY,EAAU;QACpB,KAAK,CACH,cAAc,EAAE,oEAAoE;YAClF,+EAA+E;YAC/E,oFAAoF;YACpF,qFAAqF;YACrF,8EAA8E,CACjF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,IAAI,GAAG,+BAAwC,CAAC;IAChD,EAAE,CAAS;IAEpB,YAAY,EAAU,EAAE,OAAe;QACrC,KAAK,CACH,cAAc,EAAE,wCAAwC,OAAO,wBAAwB;YACrF,kFAAkF;YAClF,8EAA8E;YAC9E,iFAAiF;YACjF,mDAAmD,OAAO,cAAc,CAC3E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,gCAAiC,SAAQ,KAAK;IAChD,IAAI,GAAG,mCAA4C,CAAC;IAC7D,uDAAuD;IAC9C,OAAO,CAAS;IAEzB,YAAY,OAAe;QACzB,KAAK,CACH,aAAa,OAAO,kEAAkE;YACpF,iFAAiF;YACjF,mFAAmF;YACnF,oFAAoF;YACpF,kEAAkE;YAClE,qFAAqF;YACrF,kFAAkF;YAClF,oFAAoF;YACpF,gFAAgF,CACnF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,uBAAgC,CAAC;IACjD,4EAA4E;IACnE,SAAS,CAAS;IAE3B,YAAY,SAAiB;QAC3B,KAAK,CACH,sBAAsB,SAAS,yDAAyD;YACtF,kFAAkF;YAClF,qFAAqF;YACrF,8DAA8D,CACjE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAC7C,IAAI,GAAG,gCAAyC,CAAC;IAC1D,6EAA6E;IACpE,SAAS,CAAS;IAE3B,YAAY,SAAiB;QAC3B,KAAK,CACH,0CAA0C,SAAS,6BAA6B;YAC9E,0EAA0E;YAC1E,kFAAkF;YAClF,iFAAiF;YACjF,oFAAoF;YACpF,mEAAmE;YACnE,mDAAmD;YACnD,mFAAmF;YACnF,mFAAmF;YACnF,uEAAuE,CAC1E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,GAAG,0BAAmC,CAAC;IAC3C,EAAE,CAAS;IAEpB,YAAY,EAAU,EAAE,QAAiB;QACvC,KAAK,CACH,cAAc,EAAE,kBAAkB;YAChC,CAAC,QAAQ,KAAK,SAAS;gBACrB,CAAC,CAAC,QAAQ,QAAQ,8CAA8C;gBAChE,CAAC,CAAC,iDAAiD,CAAC;YACtD,oFAAoF;YACpF,mFAAmF;YACnF,yCAAyC,CAC5C,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH;;;;;;;;;;GAUG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAGxB;IAFZ,IAAI,GAAG,uBAAgC,CAAC;IAEjD,YAAqB,UAAkB,EAAE,QAAgB;QACvD,KAAK,CACH,kBAAkB,QAAQ,sCAAsC,MAAM,CAAC,UAAU,CAAC,GAAG;YACnF,iFAAiF,CACpF,CAAC;QAJiB,eAAU,GAAV,UAAU,CAAQ;QAKrC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEhC;IAGA;IAJX,YACW,IAAY,EACrB,MAAc;IACd,gFAAgF;IACvE,SAAiB,GAAG;QAE7B,KAAK,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;QALpB,SAAI,GAAJ,IAAI,CAAQ;QAGZ,WAAM,GAAN,MAAM,CAAc;QAG7B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAkC,EAClC,UAA0B;IAE1B,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjF,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,CAAC,IAAI,4BAA4B,UAAU,KAAK;QACpE,eAAe,GAAG,wBAAwB;QAC1C,+BAA+B,UAAU,uCAAuC;QAChF,oFAAoF,CACvF,CAAC;AACJ,CAAC"}

package/dist/esm/hosting/httpHost.d.ts

@@ -90,6 +90,72 @@ export interface HttpRequestFacts {
  * going out as one body or as a stream of frames — those are {@link httpHost}'s
  * job, identical for every wire, which is the entire point of separating them.
  */
+/**
+ * One Server-Sent Event: the name it is announced under, and the body that
+ * rides with it.
+ */
+/**
+ * Where a failure came from.
+ *
+ * `'refused'` is the handler CHOOSING to fail with words it picked for the
+ * caller. `'threw'` is an exception this host caught — the message is the
+ * author's note to their own logs, and may name a query, a path or a token.
+ *
+ * The distinction exists because a dialect that sanitises has to sanitise the
+ * right one: replacing both silences deliberate refusals, and replacing
+ * neither publishes stack-trace prose to whoever is on the other end.
+ */
+export type FailureOrigin = 'refused' | 'threw';
+export interface StreamFrame {
+    readonly event: string;
+    readonly data: unknown;
+}
+/**
+ * The frames ONE streaming response is made of.
+ *
+ * ── Why this exists ──────────────────────────────────────────────────────────
+ * A wire's body methods answer "what do the fields say". This answers a
+ * different question: "what SHAPE is a stream". This host's own dialect frames
+ * one homogeneous `chunk` per piece and one terminal frame, and that is a real
+ * shape — but it is not the only one. Several protocols in wide use frame a
+ * stream as a LIFECYCLE instead: named events that open a response, announce
+ * that output is beginning, carry deltas, close each part, and close the
+ * response — every event referring to one response object by id, often
+ * numbered.
+ *
+ * Those cannot be expressed as "a body shape per chunk", because one host
+ * lifecycle point becomes SEVERAL frames, and because the frames share state
+ * (an id minted once, a counter that only goes up). So a dialect that frames
+ * this way supplies one of these PER RESPONSE and keeps that state in it.
+ *
+ * ── The default is one of these ──────────────────────────────────────────────
+ * A wire that supplies none gets framing built from its own body methods —
+ * `chunk`/`complete`/`error`, exactly as before. The incumbent shape is an
+ * INSTANCE of this seam rather than a special case beside it, which is the
+ * reason to believe the seam is in the right place.
+ */
+export interface StreamFraming {
+    /**
+     * Frames to write the moment the stream opens, before the handler runs.
+     * Absent or empty means the stream announces itself with nothing, which is
+     * this host's own behaviour.
+     */
+    open?(): readonly StreamFrame[];
+    /** Frames for one piece of streamed output. */
+    chunk(text: string): readonly StreamFrame[];
+    /** Frames that close a response that completed. */
+    complete(output: string): readonly StreamFrame[];
+    /** Frames that close a response that failed. */
+    failure(message: string, code?: string, origin?: FailureOrigin): readonly StreamFrame[];
+    /**
+     * Frames that close a response ending in one of the other terminals. Absent
+     * means the single-frame default, so a framing written for text alone keeps
+     * working when an artifact or a paused run comes back through it.
+     */
+    awaiting?(pending: PendingAsk): readonly StreamFrame[];
+    artifact?(result: ArtifactWireResult): readonly StreamFrame[];
+    sessions?(result: SessionWireResult): readonly StreamFrame[];
+}
 export interface HttpWire {
     /**
      * Pull the port's vocabulary out of one request. Anything the wire cannot
@@ -151,12 +217,47 @@ export interface HttpWire {
          */
         readonly responseHeaders?: Readonly<Record<string, string>>;
     };
+    /**
+     * Did THIS caller ask for a stream?
+     *
+     * Absent, the answer is the HTTP one: an `Accept` of `text/event-stream`.
+     * That is the right default and the wrong rule for dialects that carry the
+     * choice in the body instead — where a client sets a field and never touches
+     * `Accept`, and a host reading only the header answers one JSON body to a
+     * caller waiting for events.
+     *
+     * Present, this is the whole answer: a dialect that says how its callers ask
+     * is not second-guessed by the header. Read before any reply is framed, so it
+     * decides `content-type` for the request.
+     */
+    wantsStream?(facts: HttpRequestFacts): boolean;
+    /**
+     * Framing for ONE streaming response — see {@link StreamFraming}.
+     *
+     * Called once per streaming request, so whatever the framing has to remember
+     * across its frames (an id minted for this response, a sequence counter) is
+     * per-response state and never shared between callers. Absent, this host
+     * frames the stream with the wire's own body shapes.
+     */
+    stream?(facts: HttpRequestFacts): StreamFraming;
     /** Body for a health probe. `uptimeMs` is how long this host has been serving. */
     health(uptimeMs: number): unknown;
-    /** Body for a reply that completed. */
-    output(output: string): unknown;
-    /** Body for a reply that failed. `code` is the refusal's stable code, when it has one. */
-    failure(message: string, code?: string): unknown;
+    /**
+     * Body for a reply that completed.
+     *
+     * `facts` is the request that produced it, for dialects whose reply repeats
+     * something the request said — a model name, a conversation id. Absent only
+     * where there is no request to show: this host has none to give when a body
+     * is built outside a request's own lifecycle.
+     */
+    output(output: string, facts?: HttpRequestFacts): unknown;
+    /**
+     * Body for a reply that failed. `code` is the refusal's stable code, when it
+     * has one — and its PRESENCE is the signal that the message was authored by
+     * this library rather than thrown by somebody's handler, which is what lets a
+     * dialect decide what is safe to repeat to a caller.
+     */
+    failure(message: string, code?: string, facts?: HttpRequestFacts, origin?: FailureOrigin): unknown;
     /** Body for one streamed piece, when the caller asked for Server-Sent Events. */
     chunk(text: string): unknown;
     /**
@@ -355,6 +456,34 @@ export interface HttpHostOptions {
      *   });
      */
     readonly onUnhandled?: (req: IncomingMessage, res: ServerResponse) => void;
+    /**
+     * Ceiling on a request body, in bytes. Default: **none**.
+     *
+     * ── Why the default is no ceiling ────────────────────────────────────────
+     * Not because unbounded is right — it is not. A body is memory this process
+     * pays for while somebody else fills it, and a host without a ceiling can be
+     * stopped by one caller with a large POST. The default is absent because
+     * every adapter built on this file inherited unbounded reads before this
+     * option existed, and a number chosen here would silently start refusing
+     * requests that deployments are serving today.
+     *
+     * **Set it.** A deployment that knows the largest body it legitimately
+     * carries should say so; a request over the line is refused with
+     * `ERR_REQUEST_TOO_LARGE` (413) and the read is abandoned at the byte that
+     * crossed it, rather than buffered to the end and then judged.
+     */
+    readonly maxBodyBytes?: number;
+    /**
+     * Answer `HEAD` on the invoke path with 204, instead of the 404 an unowned
+     * method gets. Default `false`.
+     *
+     * Some deployment contracts probe a door before using it — "is the agent
+     * here?" — and a probe is not a turn: nothing is read, nothing is run, and
+     * the body is empty by definition. Opt-in, because a host that answered it
+     * unasked would change what every existing adapter says to a method it has
+     * always declined.
+     */
+    readonly invokeHeadProbe?: boolean;
 }
 /** A {@link HostHandle} that also says where it landed. */
 export interface HttpHostHandle extends HostHandle {