@amalgm/chat 0.1.0 → 0.1.2

package/PURPOSE.md

@@ -17,7 +17,7 @@ itself — independent of any particular host, harness, or UI. If it spawns a
 process, opens a socket, or touches a disk, it is a host adapter behind a
 port, not a law.
 
-## The seven jobs
+## The eight jobs
 
 1. **The event grammar.** One canonical vocabulary (`text.delta` …
    `usage.final` … `done`) that every harness's native events are translated
@@ -49,6 +49,10 @@ port, not a law.
    the ownership fork (amalgm billing → proxy meters via egress; byok /
    provider_auth → local logging), and the cost rules (unknown cost is
    null, never zero).
+8. **Session-bound relays.** Amalgm-auth turns reach the billing proxy only
+   through a per-session egress token, and harness MCP traffic reaches only
+   servers frozen into that session's contract. Request paths never choose
+   an arbitrary credential or destination.
 
 ## Axioms
 
@@ -81,13 +85,17 @@ port, not a law.
 10. **Amalgm dogfoods its own SDK.** The end state (spec §10): ChatView's
     data layer imports nothing but `@amalgm/chat`; the engine host mounts
     these laws instead of containing them.
+11. **Relay authority comes from the frozen contract.** Egress replaces the
+    session token with the host's proxy credential and stamps usage identity;
+    MCP relay replaces caller auth with the selected frozen server headers.
+    Neither relay accepts an upstream URL from the request.
 
 ## Five surfaces
 
 | Surface | Form | Status |
 |---|---|---|
 | SDK | `@amalgm/chat` (this package's `src/`) | porting |
-| API | router factory a host mounts | after SDK |
+| API | router factory a host mounts | chat payloads served |
 | CLI | `amalgm-chat` diagnostic commands | after SDK |
 | MCP | tool definitions + dispatch | after SDK |
 | Skill | `skills/chat/SKILL.md` | after SDK |

package/README.md

@@ -18,6 +18,7 @@ src/contract/     harnesses, model identities, freeze algebra, chatInput,
 src/warm/         warm-payload laws: revision, fingerprint, cache policies
 src/usage/        token algebra, turn finalization, ownership fork, catalog
 src/normalizers/  claude · codex · opencode · cursor · pi → the grammar
+src/api/          fetch adapters over SDK services
 src/ports.ts      the ports a host injects (clock, hash, uuid)
 host/             the reference host: adapters, tooling, orchestration,
                   chat-server shell (effectful, imports the laws from dist)
@@ -31,6 +32,30 @@ npm install
 npm test                      # build + every exam
 ```
 
+## Serve the machine chat-payload API
+
+```js
+import { createChatPayloadApi } from '@amalgm/chat/api';
+import { ChatPayloadStore } from '@amalgm/chat/warm';
+
+const payloads = new ChatPayloadStore({
+  store: {
+    read: () => readPayloadMapFromYourHost(),
+    write: (next) => writePayloadMapFromYourHost(next),
+  },
+  clockIso: () => new Date().toISOString(),
+  clockMs: () => Date.now(),
+  emit: (event) => publishStateEventFromYourHost(event),
+});
+
+const api = createChatPayloadApi(payloads);
+const response = await api(new Request('http://local/chat-payloads'));
+```
+
+The adapter preserves the engine's `/chat-payloads` list, lookup, and write
+contract. The host chooses persistence, clocks, and state-event delivery;
+record normalization, retention, and route responses stay in this package.
+
 Rules of the house: `src/` is pure — one runtime dependency (zod, axiom 9),
 no `node:*`, no env, no ambient clock; hosts inject effects through
 `src/ports.ts`. `host/` is effectful by design but never re-implements a

package/dist/api/chat-payloads.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Fetch API adapter for engine
+ * `runtime/scripts/amalgm-mcp/server/routes/chat-payloads.js`.
+ * Route matching and response shapes are byte-for-byte laws; persistence and
+ * clocks are already behind `ChatPayloadStore` ports.
+ */
+import type { ChatPayloadStore } from '../warm/store.js';
+export type ChatPayloadApi = (request: Request) => Promise<Response>;
+export declare function createChatPayloadApi(store: ChatPayloadStore): ChatPayloadApi;
+//# sourceMappingURL=chat-payloads.d.ts.map

package/dist/api/chat-payloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-payloads.d.ts","sourceRoot":"","sources":["../../src/api/chat-payloads.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc,CAoC5E"}

package/dist/api/chat-payloads.js

@@ -0,0 +1,57 @@
+/**
+ * Fetch API adapter for engine
+ * `runtime/scripts/amalgm-mcp/server/routes/chat-payloads.js`.
+ * Route matching and response shapes are byte-for-byte laws; persistence and
+ * clocks are already behind `ChatPayloadStore` ports.
+ */
+export function createChatPayloadApi(store) {
+    return async (request) => {
+        try {
+            const url = new URL(request.url);
+            const method = request.method.toUpperCase();
+            if (url.pathname === '/chat-payloads' && method === 'GET') {
+                const id = url.searchParams.get('id');
+                const payload = id ? store.get(id) : null;
+                return json(payload ? 200 : (id ? 404 : 200), {
+                    ...(id && payload ? { payload } : {}),
+                    payloads: store.list(),
+                    ...(id && !payload ? { error: 'Chat payload not found' } : {}),
+                });
+            }
+            if (url.pathname === '/chat-payloads/get' && method === 'POST') {
+                const body = await jsonBody(request);
+                const payload = store.get(value(body, 'id') || value(body, 'payloadId'));
+                if (!payload)
+                    return json(404, { error: 'Chat payload not found' });
+                return json(200, { payload });
+            }
+            if (url.pathname === '/chat-payloads' && (method === 'PUT' || method === 'POST')) {
+                const payload = store.write(await jsonBody(request));
+                return json(200, { success: true, payload });
+            }
+            return new Response('Not found', {
+                status: 404,
+                headers: { 'content-type': 'text/plain' },
+            });
+        }
+        catch {
+            return json(500, { error: 'Internal server error' });
+        }
+    };
+}
+async function jsonBody(request) {
+    const raw = await request.text();
+    return raw ? JSON.parse(raw) : {};
+}
+function value(input, key) {
+    return input && typeof input === 'object' && !Array.isArray(input)
+        ? input[key]
+        : undefined;
+}
+function json(status, body) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { 'content-type': 'application/json' },
+    });
+}
+//# sourceMappingURL=chat-payloads.js.map

package/dist/api/chat-payloads.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,4 @@
+/** @amalgm/chat API adapters — thin doors over the SDK laws. */
+export type { ChatPayloadApi } from './chat-payloads.js';
+export { createChatPayloadApi } from './chat-payloads.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,3 @@
+/** @amalgm/chat API adapters — thin doors over the SDK laws. */
+export { createChatPayloadApi } from './chat-payloads.js';
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAGhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.d.ts

@@ -10,7 +10,9 @@
  *                freeze algebra, chatInput, payload merge, input
  *   warm/        warm-payload laws: revision, fingerprint, cache policies
  *   usage/       token algebra, turn finalization, ownership fork, catalog
+ *   api/         thin fetch adapters over SDK services
  *   normalizers/ native harness events → the grammar (wave B)
+ *   relay/       session-bound egress and MCP forwarding laws
  *
  * Hosts inject effects through the port types in `ports.ts` (axiom 7).
  * Prefer the subpath exports (`@amalgm/chat/<module>`) — name collisions
@@ -23,5 +25,7 @@ export * as turns from './turns/index.js';
 export * as contract from './contract/index.js';
 export * as warm from './warm/index.js';
 export * as usage from './usage/index.js';
+export * as api from './api/index.js';
+export * as relay from './relay/index.js';
 export type { ClockMsPort, ClockIsoPort, Sha256HexPort, RandomUuidPort } from './ports.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -10,7 +10,9 @@
  *                freeze algebra, chatInput, payload merge, input
  *   warm/        warm-payload laws: revision, fingerprint, cache policies
  *   usage/       token algebra, turn finalization, ownership fork, catalog
+ *   api/         thin fetch adapters over SDK services
  *   normalizers/ native harness events → the grammar (wave B)
+ *   relay/       session-bound egress and MCP forwarding laws
  *
  * Hosts inject effects through the port types in `ports.ts` (axiom 7).
  * Prefer the subpath exports (`@amalgm/chat/<module>`) — name collisions
@@ -23,4 +25,6 @@ export * as turns from './turns/index.js';
 export * as contract from './contract/index.js';
 export * as warm from './warm/index.js';
 export * as usage from './usage/index.js';
+export * as api from './api/index.js';
+export * as relay from './relay/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}

package/dist/relay/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Session-bound relay laws.
+ * Engine references:
+ *  - runtime/scripts/chat-core/egress.js
+ *  - runtime/scripts/chat-core/tooling/mcp-relay.js
+ *  - runtime/scripts/chat-core/tooling/mcp-bundle.js
+ *  - runtime/scripts/chat-core/server.js:115-133
+ */
+export interface RelayHeader {
+    readonly name: string;
+    readonly value: string;
+}
+export interface RelayServer {
+    readonly name: string;
+    readonly type: 'http' | 'sse';
+    readonly url: string;
+    readonly headers: readonly RelayHeader[];
+}
+export interface ChatRelayContract {
+    readonly sessionId: string;
+    readonly userId?: string;
+    readonly computerId?: string;
+    readonly agentId?: string;
+    readonly harness?: string;
+    readonly authMethod: string;
+    readonly modelId?: string;
+    readonly usageModelId?: string;
+    readonly cwd?: string;
+    readonly usageOwner?: string;
+    readonly auth?: {
+        readonly tokenRef?: string | null;
+    };
+    readonly mcpServers?: readonly unknown[];
+}
+export interface ChatRelayTurn {
+    readonly turnId?: string;
+    readonly assistantMessageId?: string;
+}
+export type RelayFetchPort = (input: string, init: RequestInit) => Promise<Response>;
+export interface ChatRelayApiOptions {
+    readonly contractForSession: (sessionId: string) => ChatRelayContract | null;
+    readonly turnForSession?: (sessionId: string) => ChatRelayTurn | null;
+    readonly proxyCredentials: () => Promise<{
+        readonly baseUrl: string;
+        readonly token: string;
+    }>;
+    readonly defaultMcpServer?: (contract: ChatRelayContract) => unknown;
+    readonly fetch: RelayFetchPort;
+}
+export declare function parseEgressPath(pathname: unknown): {
+    sessionId: string;
+    upstreamPath: string;
+} | null;
+export declare function parseMcpRelayPath(pathname: unknown): {
+    sessionId: string;
+    serverName: string;
+} | null;
+export declare function metadataHeaders(contract: ChatRelayContract, turn?: ChatRelayTurn | null): Record<string, string>;
+export declare function safeMcpServerName(name: unknown): string;
+export declare function headerArrayToRecord(headers: unknown): Record<string, string>;
+export declare function normalizeMcpServer(server: unknown): RelayServer | null;
+export declare function mcpServers(contract: ChatRelayContract, defaultServer?: unknown): RelayServer[];
+export declare function findMcpRelayTarget(contract: ChatRelayContract, serverName: unknown, defaultServer?: unknown): RelayServer | null;
+export declare function createChatRelayApi(options: ChatRelayApiOptions): (request: Request) => Promise<Response>;
+//# sourceMappingURL=index.d.ts.map

package/dist/relay/index.d.ts.map

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

package/dist/relay/index.js

@@ -0,0 +1,197 @@
+/**
+ * Session-bound relay laws.
+ * Engine references:
+ *  - runtime/scripts/chat-core/egress.js
+ *  - runtime/scripts/chat-core/tooling/mcp-relay.js
+ *  - runtime/scripts/chat-core/tooling/mcp-bundle.js
+ *  - runtime/scripts/chat-core/server.js:115-133
+ */
+const MCP_HOP_HEADERS = new Set([
+    'connection',
+    'content-length',
+    'host',
+    'keep-alive',
+    'proxy-authenticate',
+    'proxy-authorization',
+    'te',
+    'trailer',
+    'transfer-encoding',
+    'upgrade',
+]);
+const EGRESS_DROP_REQUEST_HEADERS = new Set([
+    'host', 'authorization', 'x-api-key', 'connection', 'content-length', 'accept-encoding',
+]);
+const EGRESS_DROP_RESPONSE_HEADERS = new Set(['connection', 'content-encoding', 'transfer-encoding']);
+export function parseEgressPath(pathname) {
+    const parts = String(pathname || '').split('/').filter(Boolean);
+    if (parts[0] !== 'egress' || !parts[1])
+        return null;
+    return { sessionId: decodeURIComponent(parts[1]), upstreamPath: `/${parts.slice(2).join('/')}` };
+}
+export function parseMcpRelayPath(pathname) {
+    const parts = String(pathname || '').split('/').filter(Boolean);
+    if (parts[0] !== 'mcp-relay' || !parts[1] || !parts[2])
+        return null;
+    return { sessionId: decodeURIComponent(parts[1]), serverName: decodeURIComponent(parts[2]) };
+}
+export function metadataHeaders(contract, turn = null) {
+    return {
+        'x-amalgm-session-id': contract.sessionId,
+        'x-amalgm-message-id': turn?.assistantMessageId || turn?.turnId || '',
+        'x-amalgm-turn-id': turn?.turnId || '',
+        'x-amalgm-agent-id': contract.agentId || '',
+        'x-amalgm-harness-id': contract.harness || '',
+        'x-amalgm-auth-method': contract.authMethod,
+        'x-amalgm-model-id': contract.usageModelId || contract.modelId || '',
+        'x-amalgm-cwd': contract.cwd || '',
+        'x-amalgm-usage-owner': contract.usageOwner || '',
+    };
+}
+export function safeMcpServerName(name) {
+    return String(name || '')
+        .trim()
+        .replace(/[^A-Za-z0-9_.-]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        || 'mcp';
+}
+export function headerArrayToRecord(headers) {
+    const out = {};
+    for (const header of Array.isArray(headers) ? headers : []) {
+        const value = header;
+        const name = String(value?.name || '').trim();
+        if (name)
+            out[name] = String(value?.value || '');
+    }
+    return out;
+}
+export function normalizeMcpServer(server) {
+    if (!server || typeof server !== 'object')
+        return null;
+    const input = server;
+    const name = safeMcpServerName(input.name);
+    const url = String(input.url || '').trim();
+    if (!name || !url)
+        return null;
+    const rawHeaders = Array.isArray(input.headers)
+        ? input.headers
+        : Object.entries(input.headers && typeof input.headers === 'object' ? input.headers : {})
+            .filter(([headerName, value]) => headerName && value != null)
+            .map(([headerName, value]) => ({ name: headerName, value: String(value) }));
+    return {
+        name,
+        type: String(input.type || '').toLowerCase() === 'sse' ? 'sse' : 'http',
+        url,
+        headers: rawHeaders.map((header) => ({
+            name: String(header.name || ''),
+            value: String(header.value || ''),
+        })),
+    };
+}
+export function mcpServers(contract, defaultServer) {
+    const byName = new Map();
+    const add = (server) => {
+        const normalized = normalizeMcpServer(server);
+        if (normalized)
+            byName.set(normalized.name, normalized);
+    };
+    if (defaultServer)
+        add(defaultServer);
+    for (const server of Array.isArray(contract.mcpServers) ? contract.mcpServers : [])
+        add(server);
+    return [...byName.values()];
+}
+export function findMcpRelayTarget(contract, serverName, defaultServer) {
+    const clean = safeMcpServerName(serverName);
+    return mcpServers(contract, defaultServer).find((server) => server.name === clean) || null;
+}
+export function createChatRelayApi(options) {
+    return async (request) => {
+        const url = new URL(request.url);
+        if (request.method === 'GET' && url.pathname === '/egress') {
+            return json(200, { service: 'egress', sessionBound: true, route: '/egress/:session/*' });
+        }
+        if (request.method === 'GET' && url.pathname === '/mcp-relay') {
+            return json(200, { service: 'mcp-relay', sessionBound: true, route: '/mcp-relay/:session/:server' });
+        }
+        const egress = parseEgressPath(url.pathname);
+        if (egress)
+            return forwardEgress(request, url, egress, options);
+        const relay = parseMcpRelayPath(url.pathname);
+        if (relay)
+            return forwardMcpRelay(request, url, relay, options);
+        return json(404, { error: 'Not found' });
+    };
+}
+async function forwardEgress(request, url, route, options) {
+    const contract = options.contractForSession(route.sessionId);
+    if (!contract || contract.authMethod !== 'amalgm') {
+        return json(404, { error: 'No Amalgm egress session', sessionId: route.sessionId });
+    }
+    const authorization = request.headers.get('authorization') || '';
+    const bearer = authorization.replace(/^Bearer\s+/i, '').trim();
+    const provided = bearer || (request.headers.get('x-api-key') || '').trim();
+    if (!contract.auth?.tokenRef || provided !== contract.auth.tokenRef) {
+        return json(401, { error: 'Invalid egress token' });
+    }
+    const proxy = await options.proxyCredentials();
+    const headers = copyHeaders(request.headers, EGRESS_DROP_REQUEST_HEADERS);
+    Object.assign(headers, metadataHeaders(contract, options.turnForSession?.(route.sessionId) || null));
+    headers.Authorization = `Bearer ${proxy.token}`;
+    const body = await requestBody(request);
+    const response = await options.fetch(`${proxy.baseUrl.replace(/\/$/, '')}${route.upstreamPath}${url.search}`, { method: request.method, headers, ...(body ? { body } : {}) });
+    return copyResponse(response, EGRESS_DROP_RESPONSE_HEADERS);
+}
+async function forwardMcpRelay(request, url, route, options) {
+    const contract = options.contractForSession(route.sessionId);
+    if (!contract)
+        return json(404, { error: 'No MCP relay session', sessionId: route.sessionId });
+    const target = findMcpRelayTarget(contract, route.serverName, options.defaultMcpServer?.(contract));
+    if (!target)
+        return json(404, { error: 'Unknown MCP server', serverName: route.serverName });
+    const headers = copyHeaders(request.headers, new Set([...MCP_HOP_HEADERS, 'authorization']));
+    Object.assign(headers, headerArrayToRecord(target.headers), {
+        'x-amalgm-session-id': contract.sessionId,
+        'x-amalgm-user-id': contract.userId || '',
+        'x-amalgm-computer-id': contract.computerId || '',
+    });
+    for (const key of Object.keys(headers))
+        if (!headers[key])
+            delete headers[key];
+    const body = await requestBody(request);
+    const response = await options.fetch(`${target.url}${url.search}`, {
+        method: request.method,
+        headers,
+        ...(body ? { body } : {}),
+        redirect: 'manual',
+    });
+    return copyResponse(response, MCP_HOP_HEADERS);
+}
+function copyHeaders(headers, drop) {
+    const out = {};
+    headers.forEach((value, name) => {
+        if (!drop.has(name.toLowerCase()))
+            out[name] = value;
+    });
+    return out;
+}
+async function requestBody(request) {
+    if (request.method === 'GET' || request.method === 'HEAD')
+        return undefined;
+    const body = await request.arrayBuffer();
+    return body.byteLength > 0 ? body : undefined;
+}
+function copyResponse(response, drop) {
+    const headers = new Headers();
+    response.headers.forEach((value, name) => {
+        if (!drop.has(name.toLowerCase()))
+            headers.set(name, value);
+    });
+    return new Response(response.body, { status: response.status, headers });
+}
+function json(status, body) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { 'content-type': 'application/json', 'cache-control': 'no-cache' },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/relay/index.js.map

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

package/dist/warm/index.d.ts

@@ -13,4 +13,6 @@ export type { LaunchEnvelopeCacheEntry } from './client-cache.js';
 export { CACHE_WARM_DELAY_MS, machineKey, launchEnvelopeCacheKey, launchEnvelopePayloadKey, usableEntry, } from './client-cache.js';
 export type { ChatPayloadStoreRecord } from './store-policy.js';
 export { CHAT_PAYLOADS_META_KEY, CHAT_PAYLOADS_RESOURCE, CHAT_PAYLOAD_TTL_MS, CHAT_PAYLOAD_MAX_RECORDS, isPlainObject, cleanString, normalizeChatPayloadRecord, recordTimestamp, sweepChatPayloads, } from './store-policy.js';
+export type { ChatPayloadMapStore, ChatPayloadStateEvent, ChatPayloadStoreOptions, } from './store.js';
+export { ChatPayloadStore } from './store.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/warm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/warm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,8BAA8B,EAC9B,eAAe,EACf,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,UAAU,EACV,+BAA+B,EAC/B,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,aAAa,EACb,WAAW,EACX,8BAA8B,EAC9B,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/warm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,8BAA8B,EAC9B,eAAe,EACf,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,UAAU,EACV,+BAA+B,EAC/B,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,aAAa,EACb,WAAW,EACX,8BAA8B,EAC9B,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/warm/index.js

@@ -8,4 +8,5 @@ export { CONFIRMED_WRITE_TTL_MS, machinePayloadWriteKey, chatPayloadRevision, is
 export { ENVELOPE_TTL_MS, MAX_ENVELOPES, stableValue, fingerprintLaunchEnvelopeInput, envelopeExpiresAt, pruneAgentLaunchEnvelopes, } from './envelope-cache.js';
 export { CACHE_WARM_DELAY_MS, machineKey, launchEnvelopeCacheKey, launchEnvelopePayloadKey, usableEntry, } from './client-cache.js';
 export { CHAT_PAYLOADS_META_KEY, CHAT_PAYLOADS_RESOURCE, CHAT_PAYLOAD_TTL_MS, CHAT_PAYLOAD_MAX_RECORDS, isPlainObject, cleanString, normalizeChatPayloadRecord, recordTimestamp, sweepChatPayloads, } from './store-policy.js';
+export { ChatPayloadStore } from './store.js';
 //# sourceMappingURL=index.js.map

package/dist/warm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/warm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,OAAO,EACL,UAAU,EACV,+BAA+B,EAC/B,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAQtB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAMvB,OAAO,EACL,eAAe,EACf,aAAa,EACb,WAAW,EACX,8BAA8B,EAC9B,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/warm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,OAAO,EACL,UAAU,EACV,+BAA+B,EAC/B,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAQtB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAMvB,OAAO,EACL,eAAe,EACf,aAAa,EACb,WAAW,EACX,8BAA8B,EAC9B,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/warm/store.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Machine chat-payload store — the effect-port composition of engine
+ * `runtime/scripts/amalgm-mcp/lib/chat-payloads.js`.
+ *
+ * The record, revision, and sweep decisions remain chat law. A host owns the
+ * bytes and clocks through these ports, so this module never touches disk or
+ * ambient time (PURPOSE.md axiom 7).
+ */
+import type { ClockIsoPort, ClockMsPort } from '../ports.js';
+import { CHAT_PAYLOADS_RESOURCE } from './store-policy.js';
+import type { ChatPayloadStoreRecord } from './store-policy.js';
+export interface ChatPayloadMapStore {
+    read(): Record<string, unknown>;
+    write(payloads: Record<string, ChatPayloadStoreRecord>): void;
+}
+export type ChatPayloadStateEvent = {
+    resource: typeof CHAT_PAYLOADS_RESOURCE;
+    op: 'invalidate';
+    source: 'chat-payloads-gc';
+} | {
+    resource: typeof CHAT_PAYLOADS_RESOURCE;
+    op: 'update';
+    id: string;
+    value: ChatPayloadStoreRecord;
+    source: string;
+};
+export interface ChatPayloadStoreOptions {
+    store: ChatPayloadMapStore;
+    clockIso: ClockIsoPort;
+    clockMs: ClockMsPort;
+    emit?: (event: ChatPayloadStateEvent) => void;
+}
+export declare class ChatPayloadStore {
+    #private;
+    constructor(options: ChatPayloadStoreOptions);
+    list(): Record<string, ChatPayloadStoreRecord>;
+    get(id: unknown): ChatPayloadStoreRecord | null;
+    write(input: unknown, options?: {
+        source?: string;
+    }): ChatPayloadStoreRecord;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/warm/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/warm/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,sBAAsB,EAKvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,IAAI,CAAC;CAC/D;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,EAAE,OAAO,sBAAsB,CAAC;IAAC,EAAE,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GACzF;IACE,QAAQ,EAAE,OAAO,sBAAsB,CAAC;IACxC,EAAE,EAAE,QAAQ,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,sBAAsB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC/C;AAED,qBAAa,gBAAgB;;gBAOf,OAAO,EAAE,uBAAuB;IAO5C,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAK9C,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI;IAO/C,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,sBAAsB;CAkCjF"}

package/dist/warm/store.js

@@ -0,0 +1,69 @@
+/**
+ * Machine chat-payload store — the effect-port composition of engine
+ * `runtime/scripts/amalgm-mcp/lib/chat-payloads.js`.
+ *
+ * The record, revision, and sweep decisions remain chat law. A host owns the
+ * bytes and clocks through these ports, so this module never touches disk or
+ * ambient time (PURPOSE.md axiom 7).
+ */
+import { CHAT_PAYLOADS_RESOURCE, cleanString, isPlainObject, normalizeChatPayloadRecord, sweepChatPayloads, } from './store-policy.js';
+export class ChatPayloadStore {
+    #store;
+    #clockIso;
+    #clockMs;
+    #emit;
+    #sweepDone = false;
+    constructor(options) {
+        this.#store = options.store;
+        this.#clockIso = options.clockIso;
+        this.#clockMs = options.clockMs;
+        this.#emit = options.emit ?? (() => undefined);
+    }
+    list() {
+        this.#sweepOnce();
+        return this.#store.read();
+    }
+    get(id) {
+        this.#sweepOnce();
+        const payloadId = cleanString(id);
+        if (!payloadId)
+            return null;
+        return this.#store.read()[payloadId] ?? null;
+    }
+    write(input, options = {}) {
+        this.#sweepOnce();
+        const current = this.#store.read();
+        const inputId = isPlainObject(input) ? cleanString(input['id'] || input['payloadId']) : null;
+        const existing = inputId
+            ? current[inputId] ?? null
+            : null;
+        const record = normalizeChatPayloadRecord(input, existing, this.#clockIso);
+        this.#store.write({
+            ...current,
+            [record.id]: record,
+        });
+        this.#emit({
+            resource: CHAT_PAYLOADS_RESOURCE,
+            op: 'update',
+            id: record.id,
+            value: record,
+            source: options.source || 'chat-payloads',
+        });
+        return record;
+    }
+    #sweepOnce() {
+        if (this.#sweepDone)
+            return;
+        this.#sweepDone = true;
+        const result = sweepChatPayloads(this.#store.read(), this.#clockMs());
+        if (!result.changed)
+            return;
+        this.#store.write(result.next);
+        this.#emit({
+            resource: CHAT_PAYLOADS_RESOURCE,
+            op: 'invalidate',
+            source: 'chat-payloads-gc',
+        });
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/warm/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/warm/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAyB3B,MAAM,OAAO,gBAAgB;IAClB,MAAM,CAAsB;IAC5B,SAAS,CAAe;IACxB,QAAQ,CAAc;IACtB,KAAK,CAAyC;IACvD,UAAU,GAAG,KAAK,CAAC;IAEnB,YAAY,OAAgC;QAC1C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAED,IAAI;QACF,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAA4C,CAAC;IACtE,CAAC;IAED,GAAG,CAAC,EAAW;QACb,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,SAAS,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,SAAS,CAAwC,IAAI,IAAI,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,KAAc,EAAE,UAA+B,EAAE;QACrD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7F,MAAM,QAAQ,GAAG,OAAO;YACtB,CAAC,CAAE,OAAO,CAAC,OAAO,CAAwC,IAAI,IAAI;YAClE,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAChB,GAAI,OAAkD;YACtD,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC;YACT,QAAQ,EAAE,sBAAsB;YAChC,EAAE,EAAE,QAAQ;YACZ,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,eAAe;SAC1C,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC;YACT,QAAQ,EAAE,sBAAsB;YAChC,EAAE,EAAE,YAAY;YAChB,MAAM,EAAE,kBAAkB;SAC3B,CAAC,CAAC;IACL,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/chat",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "The Amalgm chat SDK — the conversation pipeline's laws: turns, messages, streaming assembly, event normalization, and transcript truth, behind host-injected adapters.",
   "type": "module",
   "license": "UNLICENSED",
@@ -47,6 +47,14 @@
     "./normalizers": {
       "types": "./dist/normalizers/index.d.ts",
       "default": "./dist/normalizers/index.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "default": "./dist/api/index.js"
+    },
+    "./relay": {
+      "types": "./dist/relay/index.d.ts",
+      "default": "./dist/relay/index.js"
     }
   },
   "files": [