@amalgm/channels 0.1.1 → 0.1.3

package/dist/src/cli/input.js

@@ -0,0 +1,38 @@
+import fs from 'node:fs/promises';
+import { ChannelsError } from '../errors.js';
+export async function readChannelsCliInput(input, ports) {
+    if (input.kind === 'empty')
+        return {};
+    let source;
+    try {
+        if (input.kind === 'inline')
+            source = input.value;
+        else if (input.kind === 'file')
+            source = await (ports.readFile ?? readFile)(input.filename);
+        else
+            source = await (ports.readStdin ?? readStdin)();
+    }
+    catch (error) {
+        throw new ChannelsError('validation', `Cannot read Channels command input: ${message(error)}`);
+    }
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch {
+        throw new ChannelsError('validation', 'Channels command input must be valid JSON');
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new ChannelsError('validation', 'Channels command input must be a JSON object');
+    }
+    return value;
+}
+const readFile = (filename) => fs.readFile(filename, 'utf8');
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(Buffer.from(chunk));
+    return Buffer.concat(chunks).toString('utf8');
+}
+const message = (error) => error instanceof Error ? error.message : String(error);
+//# sourceMappingURL=input.js.map

package/dist/src/cli/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/cli/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQ7C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAuB,EACvB,KAA4B;IAE5B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC;IACtC,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC;aAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;;YACvF,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC,EAAE,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,uCAAuC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,2CAA2C,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,8CAA8C,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAErE,KAAK,UAAU,SAAS;IACtB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC"}

package/dist/src/cli/main.d.ts

@@ -0,0 +1,7 @@
+import { type ChannelsCliIo } from './run.js';
+export interface ChannelsCliMainOptions extends ChannelsCliIo {
+    readonly argv?: string[];
+    readonly env?: NodeJS.ProcessEnv;
+    readonly fetch?: typeof globalThis.fetch;
+}
+export declare function runChannelsCliMain(options?: ChannelsCliMainOptions): Promise<number>;

package/dist/src/cli/main.js

@@ -0,0 +1,27 @@
+import {} from '../command-surface.js';
+import { ChannelsError } from '../errors.js';
+import { runChannelsCli } from './run.js';
+import { createShellChannelsCommands } from './shell-runtime.js';
+export function runChannelsCliMain(options = {}) {
+    const argv = options.argv ?? process.argv.slice(2);
+    const env = options.env ?? process.env;
+    return runChannelsCli(argv, lazyCommands(() => commandsFromEnvironment(env, options.fetch)), options);
+}
+function commandsFromEnvironment(env, fetch) {
+    const runtimeUrl = env.AMALGM_CHANNELS_RUNTIME_URL || env.AMALGM_MCP_URL;
+    const runtimeToken = env.AMALGM_RUNTIME_TOKEN;
+    if (!runtimeUrl || !runtimeToken) {
+        throw new ChannelsError('runtime_unavailable', 'A running Amalgm Shell runtime is required (AMALGM_MCP_URL and AMALGM_RUNTIME_TOKEN)');
+    }
+    return createShellChannelsCommands({ runtimeUrl, runtimeToken, ...(fetch ? { fetch } : {}) });
+}
+function lazyCommands(open) {
+    let commands;
+    return {
+        execute(name, input, context) {
+            commands ??= open();
+            return commands.execute(name, input, context);
+        },
+    };
+}
+//# sourceMappingURL=main.js.map

package/dist/src/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/cli/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAsB,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAQjE,MAAM,UAAU,kBAAkB,CAAC,UAAkC,EAAE;IACrE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,OAAO,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACxG,CAAC;AAED,SAAS,uBAAuB,CAC9B,GAAsB,EACtB,KAA0C;IAE1C,MAAM,UAAU,GAAG,GAAG,CAAC,2BAA2B,IAAI,GAAG,CAAC,cAAc,CAAC;IACzE,MAAM,YAAY,GAAG,GAAG,CAAC,oBAAoB,CAAC;IAC9C,IAAI,CAAC,UAAU,IAAI,CAAC,YAAY,EAAE,CAAC;QACjC,MAAM,IAAI,aAAa,CACrB,qBAAqB,EACrB,sFAAsF,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,2BAA2B,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,YAAY,CAAC,IAA4B;IAChD,IAAI,QAAsC,CAAC;IAC3C,OAAO;QACL,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO;YAC1B,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cli/run.d.ts

@@ -0,0 +1,13 @@
+import { type ChannelsCommands } from '../command-surface.js';
+import type { Channels } from '../contract.js';
+import { type ChannelsCliInputPorts } from './input.js';
+interface Output {
+    write(chunk: string): unknown;
+}
+export interface ChannelsCliIo extends ChannelsCliInputPorts {
+    stdout?: Output;
+    stderr?: Output;
+}
+export declare const channelsCliHelp = "amalgm channels \u2014 deliberate messages over user channels\n\nUsage:\n  amalgm channels send [--input JSON | --file PATH | --stdin]\n  amalgm-channels send [--input JSON | --file PATH | --stdin]\n\nCommands (identical to the Channels MCP task surface):\n  send    Send one durable message to the current user\n\nInput is one JSON object with message, channel, and optional title and\nidempotency_key fields. The current channel is \"email\". Output is one JSON\nsuccess or error envelope. The recipient is always the signed-in user.\n";
+export declare function runChannelsCli(argv: string[], backend: Channels | ChannelsCommands, io?: ChannelsCliIo): Promise<number>;
+export {};

package/dist/src/cli/run.js

@@ -0,0 +1,47 @@
+import { createChannelsCommands } from '../command-surface.js';
+import { ChannelsError } from '../errors.js';
+import { parseChannelsCliArguments } from './arguments.js';
+import { readChannelsCliInput } from './input.js';
+export const channelsCliHelp = `amalgm channels — deliberate messages over user channels
+
+Usage:
+  amalgm channels send [--input JSON | --file PATH | --stdin]
+  amalgm-channels send [--input JSON | --file PATH | --stdin]
+
+Commands (identical to the Channels MCP task surface):
+  send    Send one durable message to the current user
+
+Input is one JSON object with message, channel, and optional title and
+idempotency_key fields. The current channel is "email". Output is one JSON
+success or error envelope. The recipient is always the signed-in user.
+`;
+export async function runChannelsCli(argv, backend, io = {}) {
+    const stdout = io.stdout ?? process.stdout;
+    const stderr = io.stderr ?? process.stderr;
+    try {
+        const parsed = parseChannelsCliArguments(argv);
+        if (parsed.kind === 'help') {
+            stdout.write(channelsCliHelp);
+            return 0;
+        }
+        const input = await readChannelsCliInput(parsed.input, io);
+        const commands = isCommands(backend) ? backend : createChannelsCommands(backend);
+        stdout.write(`${JSON.stringify({ result: await commands.execute(parsed.command, input) })}\n`);
+        return 0;
+    }
+    catch (error) {
+        stderr.write(`${JSON.stringify(failure(error))}\n`);
+        return 1;
+    }
+}
+function isCommands(value) {
+    return 'execute' in value && typeof value.execute === 'function';
+}
+function failure(error) {
+    return { error: {
+            code: error instanceof ChannelsError ? error.code : 'internal',
+            message: error instanceof Error ? error.message : String(error),
+            ...(error instanceof ChannelsError && error.status !== undefined ? { status: error.status } : {}),
+        } };
+}
+//# sourceMappingURL=run.js.map

package/dist/src/cli/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/cli/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAyB,MAAM,uBAAuB,CAAC;AAEtF,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAA8B,MAAM,YAAY,CAAC;AAS9E,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;CAY9B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAc,EACd,OAAoC,EACpC,KAAoB,EAAE;IAEtB,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAC9B,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACjF,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAkC;IACpD,OAAO,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC;AACnE,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,EAAE,KAAK,EAAE;YACd,IAAI,EAAE,KAAK,YAAY,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU;YAC9D,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/D,GAAG,CAAC,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClG,EAAE,CAAC;AACN,CAAC"}

package/dist/src/cli/shell-runtime.d.ts

@@ -0,0 +1,9 @@
+import { type ChannelsCommands } from '../command-surface.js';
+export interface ShellChannelsCommandOptions {
+    readonly runtimeUrl: string;
+    readonly runtimeToken: string;
+    readonly fetch?: typeof globalThis.fetch;
+    readonly requestTimeoutMs?: number;
+}
+export declare function createShellChannelsCommands(options: ShellChannelsCommandOptions): ChannelsCommands;
+export declare function shellChannelsEndpoint(runtimeUrl: string): string;

package/dist/src/cli/shell-runtime.js

@@ -0,0 +1,106 @@
+import { channelsCommandDefinition, } from '../command-surface.js';
+import { ChannelsError } from '../errors.js';
+export function createShellChannelsCommands(options) {
+    const endpoint = shellChannelsEndpoint(options.runtimeUrl);
+    const token = options.runtimeToken.trim();
+    if (!token)
+        throw new ChannelsError('validation', 'AMALGM_RUNTIME_TOKEN is required');
+    const request = options.fetch ?? globalThis.fetch;
+    const timeout = options.requestTimeoutMs ?? 15_000;
+    let requestId = 0;
+    return Object.freeze({
+        async execute(name, input = {}) {
+            const definition = channelsCommandDefinition(name);
+            const id = `amalgm-channels-cli-${++requestId}`;
+            let response;
+            try {
+                response = await request(endpoint, {
+                    method: 'POST',
+                    headers: {
+                        accept: 'application/json',
+                        'content-type': 'application/json',
+                        'x-amalgm-runtime-token': token,
+                    },
+                    body: JSON.stringify({
+                        jsonrpc: '2.0', id, method: 'tools/call',
+                        params: { name: definition.mcpName, arguments: input },
+                    }),
+                    signal: AbortSignal.timeout(timeout),
+                });
+            }
+            catch (error) {
+                throw new ChannelsError('runtime_transport', `Amalgm Shell runtime request failed: ${message(error)}`);
+            }
+            const payload = await jsonResponse(response);
+            if (!response.ok) {
+                throw new ChannelsError(response.status === 401 ? 'runtime_unauthorized' : 'runtime_transport', response.status === 401
+                    ? 'The Amalgm Shell runtime rejected the local admission token'
+                    : `Amalgm Shell runtime returned ${response.status}`, response.status);
+            }
+            if (!payload || payload.jsonrpc !== '2.0' || payload.id !== id) {
+                throw new ChannelsError('runtime_protocol', 'Amalgm Shell runtime returned invalid JSON-RPC');
+            }
+            if (payload.error) {
+                throw new ChannelsError('runtime_protocol', payload.error.message || 'Amalgm Shell runtime failed');
+            }
+            return toolResult(payload.result);
+        },
+    });
+}
+export function shellChannelsEndpoint(runtimeUrl) {
+    let url;
+    try {
+        url = new URL(runtimeUrl);
+    }
+    catch {
+        throw new ChannelsError('validation', 'AMALGM_MCP_URL must be an absolute loopback URL');
+    }
+    const loopback = ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname);
+    if (!loopback || !['http:', 'https:'].includes(url.protocol) || url.username || url.password) {
+        throw new ChannelsError('validation', 'AMALGM_MCP_URL must be an absolute loopback URL');
+    }
+    if (!url.pathname.endsWith('/mcp/channels'))
+        url.pathname = '/mcp/channels';
+    url.search = '';
+    url.hash = '';
+    return url.toString();
+}
+async function jsonResponse(response) {
+    const bytes = new Uint8Array(await response.arrayBuffer().catch((error) => {
+        throw new ChannelsError('runtime_transport', `Cannot read Amalgm Shell runtime response: ${message(error)}`);
+    }));
+    if (bytes.byteLength > 2 * 1024 * 1024) {
+        throw new ChannelsError('runtime_protocol', 'Amalgm Shell runtime response is too large');
+    }
+    try {
+        return JSON.parse(Buffer.from(bytes).toString('utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function toolResult(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new ChannelsError('runtime_protocol', 'Channels MCP returned an invalid tool result');
+    }
+    const result = value;
+    if (result.isError === true) {
+        const error = result.structuredContent?.error;
+        throw new ChannelsError(channelsErrorCode(error?.code), typeof error?.message === 'string' ? error.message : 'Channels command failed', typeof error?.status === 'number' ? error.status : undefined);
+    }
+    if (!result.structuredContent || !Object.hasOwn(result.structuredContent, 'result')) {
+        throw new ChannelsError('runtime_protocol', 'Channels MCP returned no structured result');
+    }
+    return result.structuredContent.result;
+}
+function channelsErrorCode(value) {
+    const known = [
+        'validation', 'forbidden', 'not_found', 'provider', 'internal',
+        'runtime_unavailable', 'runtime_transport', 'runtime_unauthorized', 'runtime_protocol',
+    ];
+    return typeof value === 'string' && known.includes(value)
+        ? value
+        : 'internal';
+}
+const message = (error) => error instanceof Error ? error.message : String(error);
+//# sourceMappingURL=shell-runtime.js.map

package/dist/src/cli/shell-runtime.js.map

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

package/dist/src/cli-main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/cli-main.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runChannelsCliMain } from './cli/main.js';
+process.exitCode = await runChannelsCliMain();
+//# sourceMappingURL=cli-main.js.map

package/dist/src/cli-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-main.js","sourceRoot":"","sources":["../../src/cli-main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,CAAC,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC"}

package/dist/src/cli.d.ts

@@ -0,0 +1,3 @@
+export { channelsCliHelp, runChannelsCli, type ChannelsCliIo } from './cli/run.js';
+export { createShellChannelsCommands, shellChannelsEndpoint, type ShellChannelsCommandOptions, } from './cli/shell-runtime.js';
+export { runChannelsCliMain, type ChannelsCliMainOptions } from './cli/main.js';

package/dist/src/cli.js

@@ -0,0 +1,4 @@
+export { channelsCliHelp, runChannelsCli } from './cli/run.js';
+export { createShellChannelsCommands, shellChannelsEndpoint, } from './cli/shell-runtime.js';
+export { runChannelsCliMain } from './cli/main.js';
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAsB,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,GAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAA+B,MAAM,eAAe,CAAC"}

package/dist/src/client.js

@@ -1,8 +1,9 @@
 import { ChannelsError } from './errors.js';
+import { channelsApiError } from './api-error.js';
 export function createChannelsClient(options) {
     const base = options.baseUrl.replace(/\/$/, '');
     const fetch = options.fetch ?? globalThis.fetch;
-    async function request(path, method, body) {
+    async function request(path, method, body, extraHeaders = {}) {
         const url = `${base}${path}`;
         const response = await fetch(url, {
             method,
@@ -10,17 +11,17 @@ export function createChannelsClient(options) {
                 accept: 'application/json',
                 ...(body === undefined ? {} : { 'content-type': 'application/json' }),
                 ...await options.headers(method, url),
+                ...extraHeaders,
             },
             ...(body === undefined ? {} : { body: JSON.stringify(body) }),
         });
         const payload = await response.json().catch(() => ({}));
         if (!response.ok)
-            throw new ChannelsError(payload.code === 'forbidden' || payload.code === 'not_found' || payload.code === 'provider'
-                ? payload.code : response.status >= 500 ? 'internal' : 'validation', payload.error ?? `Channels API returned ${response.status}`);
+            throw channelsApiError(response.status, payload);
         return payload;
     }
     return Object.freeze({
-        notify: (input) => request('/v1/notifications', 'POST', input),
+        send: (input, context = {}) => request('/v1/messages', 'POST', input, context.sessionId ? { 'x-amalgm-session-id': context.sessionId } : {}),
         list: (query = {}) => request(`/v1/deliveries${queryString(query)}`, 'GET'),
         get: async (deliveryId) => {
             try {

package/dist/src/client.js.map

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

package/dist/src/command-surface.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod/v3';
+import type { ChannelSendContext, Channels } from './contract.js';
+export type ChannelsCommandName = 'send';
+export interface ChannelsCommandDefinition {
+    readonly name: ChannelsCommandName;
+    readonly mcpName: 'amalgm_channels_send';
+    readonly title: string;
+    readonly description: string;
+    readonly inputShape: z.ZodRawShape;
+    readonly annotations: Readonly<{
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    }>;
+    invoke(channels: Channels, input: unknown, context?: ChannelSendContext): Promise<unknown>;
+}
+export interface ChannelsCommands {
+    execute(name: ChannelsCommandName, input?: unknown, context?: ChannelSendContext): Promise<unknown>;
+}
+export declare const channelsCommandDefinitions: readonly ChannelsCommandDefinition[];
+export declare function channelsCommandDefinition(name: string): ChannelsCommandDefinition;
+export declare function createChannelsCommands(channels: Channels): ChannelsCommands;

package/dist/src/command-surface.js

@@ -0,0 +1,53 @@
+import { z } from 'zod/v3';
+import { ChannelsError } from './errors.js';
+const sendSchema = z.object({
+    message: z.string().min(1).max(4_000).describe('Message body in Markdown.'),
+    title: z.string().min(1).max(160).optional().describe('Short message title.'),
+    channel: z.enum(['email']).describe('External channel. Email is currently supported.'),
+    idempotency_key: z.string().min(1).max(200).optional()
+        .describe('Stable key for safe retries of this exact message.'),
+}).strict();
+export const channelsCommandDefinitions = Object.freeze([
+    Object.freeze({
+        name: 'send',
+        mcpName: 'amalgm_channels_send',
+        title: 'Send to current user',
+        description: 'Send one deliberate, durable message to the current Amalgm user over the selected channel. Ordinary assistant output is not delivered. The caller cannot select another recipient.',
+        inputShape: sendSchema.shape,
+        annotations: Object.freeze({
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        }),
+        async invoke(channels, input, context = {}) {
+            const value = parse(sendSchema, input);
+            return channels.send({
+                message: value.message,
+                channel: value.channel,
+                ...(value.title === undefined ? {} : { title: value.title }),
+                ...(value.idempotency_key === undefined ? {} : { idempotencyKey: value.idempotency_key }),
+            }, context);
+        },
+    }),
+]);
+export function channelsCommandDefinition(name) {
+    const definition = channelsCommandDefinitions.find((candidate) => candidate.name === name);
+    if (!definition)
+        throw new ChannelsError('validation', `Unknown Channels command: ${name}`);
+    return definition;
+}
+export function createChannelsCommands(channels) {
+    return Object.freeze({
+        execute(name, input = {}, context = {}) {
+            return channelsCommandDefinition(name).invoke(channels, input, context);
+        },
+    });
+}
+function parse(schema, value) {
+    const result = schema.safeParse(value);
+    if (result.success)
+        return result.data;
+    throw new ChannelsError('validation', result.error.issues.map(({ path, message }) => (`${path.length ? path.join('.') : 'input'}: ${message}`)).join('; '));
+}
+//# sourceMappingURL=command-surface.js.map

package/dist/src/command-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-surface.js","sourceRoot":"","sources":["../../src/command-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuB5C,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC7E,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACtF,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;SACnD,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,0BAA0B,GAAyC,MAAM,CAAC,MAAM,CAAC;IAC5F,MAAM,CAAC,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,sBAAsB;QAC/B,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,oLAAoL;QACjM,UAAU,EAAE,UAAU,CAAC,KAAK;QAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;YACzB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB,CAAC;QACF,KAAK,CAAC,MAAM,CAAC,QAAkB,EAAE,KAAc,EAAE,UAA8B,EAAE;YAC/E,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YACvC,OAAO,QAAQ,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC5D,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC;aAC1F,EAAE,OAAO,CAAC,CAAC;QACd,CAAC;KACF,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC3F,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,6BAA6B,IAAI,EAAE,CAAC,CAAC;IAC5F,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAkB;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,CAAC,IAAyB,EAAE,QAAiB,EAAE,EAAE,UAA8B,EAAE;YACtF,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1E,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,KAAK,CAA8B,MAAc,EAAE,KAAc;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACvC,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CACnF,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,EAAE,CACxD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/dist/src/contract.d.ts

@@ -1,16 +1,28 @@
-export type ChannelScope = 'channels:read' | 'channels:send';
-export type ChannelPreference = 'auto' | 'email';
-export type DeliveryStatus = 'pending' | 'sending' | 'delivered' | 'failed';
+export type ChannelScope = 'channels:read' | 'channels:send' | 'channels:receive';
+export type ChannelType = 'email';
+export type ChannelPreference = 'auto' | ChannelType;
+export type DeliveryStatus = 'pending' | 'sending' | 'sent' | 'delivered' | 'failed';
 export interface ChannelPrincipal {
     readonly userId: string;
+    readonly computerId?: string;
     readonly scopes: readonly ChannelScope[];
 }
-export interface NotifyUserInput {
+export interface SendMessageInput {
     readonly message: string;
     readonly title?: string;
     readonly channel?: ChannelPreference;
     readonly idempotencyKey?: string;
 }
+/** Trusted local context. This is never part of the agent-visible tool input. */
+export interface ChannelSendContext {
+    readonly sessionId?: string;
+}
+export interface NormalizedSendMessage {
+    readonly message: string;
+    readonly title: string;
+    readonly channel: ChannelPreference;
+    readonly idempotencyKey: string;
+}
 export interface Delivery {
     readonly id: string;
     readonly channel: Exclude<ChannelPreference, 'auto'>;
@@ -23,6 +35,8 @@ export interface Delivery {
     readonly updatedAt: string;
     readonly deliveredAt?: string;
     readonly providerId?: string;
+    readonly threadId?: string;
+    readonly sessionId?: string;
     readonly error?: string;
 }
 export interface DeliveryPage {
@@ -43,7 +57,7 @@ export interface NormalizedListDeliveries {
     readonly offset: number;
 }
 export interface Channels {
-    notify(input: NotifyUserInput): Promise<Delivery>;
+    send(input: SendMessageInput, context?: ChannelSendContext): Promise<Delivery>;
     list(query?: ListDeliveries): Promise<DeliveryPage>;
     get(deliveryId: string): Promise<Delivery | null>;
 }
@@ -59,14 +73,23 @@ export interface PendingDelivery {
     readonly idempotencyKey: string;
     readonly leaseToken: string;
     readonly attempts: number;
+    readonly thread: Readonly<{
+        id: string;
+        sessionId: string;
+        subject: string;
+        messageId: string;
+        replyToMessageId?: string;
+        references: readonly string[];
+    }>;
 }
 export interface DeliveryRepository {
-    enqueue(userId: string, input: Required<NotifyUserInput>): Promise<Delivery>;
+    enqueue(userId: string, computerId: string | undefined, input: NormalizedSendMessage, context: ChannelSendContext): Promise<Delivery>;
     list(userId: string, query: NormalizedListDeliveries): Promise<DeliveryPage>;
     get(userId: string, deliveryId: string): Promise<Delivery | null>;
     claim(limit: number, leaseSeconds: number): Promise<readonly PendingDelivery[]>;
-    complete(delivery: PendingDelivery, providerId: string, now: Date): Promise<boolean>;
+    markSent(delivery: PendingDelivery, providerId: string, now: Date): Promise<boolean>;
     fail(delivery: PendingDelivery, error: string, now: Date): Promise<boolean>;
+    nextWorkAt(): Promise<Date | null>;
 }
 export interface RecipientDirectory {
     emailForUser(userId: string): Promise<string>;
@@ -76,7 +99,10 @@ export interface EmailProvider {
         to: string;
         subject: string;
         text: string;
+        html: string;
         idempotencyKey: string;
+        replyTo?: string;
+        headers?: Readonly<Record<string, string>>;
     }>): Promise<{
         readonly providerId: string;
     }>;

package/dist/src/email/blocks.d.ts

@@ -0,0 +1,7 @@
+export declare function paragraph(lines: readonly string[]): string;
+export declare function heading(level: number, text: string): string;
+export declare function list(ordered: boolean, items: readonly string[]): string;
+export declare function quote(lines: readonly string[]): string;
+export declare function codeBlock(language: string, source: string): string;
+export declare function divider(): string;
+export declare function table(rows: readonly (readonly string[])[]): string;

package/dist/src/email/blocks.js

@@ -0,0 +1,43 @@
+import { escapeText } from './escape.js';
+import { renderInline } from './inline.js';
+import { BLOCK, EMAIL } from './styles.js';
+export function paragraph(lines) {
+    return `<p style="margin:0;line-height:${BLOCK.paragraphLineHeight};color:${EMAIL.color.text}">${renderInline(lines.join(' '))}</p>`;
+}
+export function heading(level, text) {
+    const safeLevel = Math.min(Math.max(level, 1), 6);
+    const size = BLOCK.headingSizes[safeLevel - 1];
+    return `<h${safeLevel} style="margin:0;font-size:${size}px;font-weight:${BLOCK.headingWeight};color:${EMAIL.color.text};line-height:${BLOCK.headingLineHeight}">${renderInline(text)}</h${safeLevel}>`;
+}
+export function list(ordered, items) {
+    const tag = ordered ? 'ol' : 'ul';
+    const children = items.map((item) => `<li style="margin:4px 0;padding:${BLOCK.listItemPaddingY}px 0;line-height:${BLOCK.listItemLineHeight};color:${EMAIL.color.text}">${renderInline(item)}</li>`).join('');
+    return `<${tag} style="margin:0;padding-left:${BLOCK.listPaddingLeft}px;color:${EMAIL.color.text}">${children}</${tag}>`;
+}
+export function quote(lines) {
+    return `<blockquote style="margin:0;line-height:1.75;font-style:italic;padding:0 0 0 ${BLOCK.quotePaddingLeft}px;border-left:3px solid ${EMAIL.color.grid};color:${EMAIL.color.secondary}">${renderInline(lines.join(' '))}</blockquote>`;
+}
+export function codeBlock(language, source) {
+    const label = escapeText(language.trim().toLowerCase() || 'text');
+    return `<div style="background:${EMAIL.color.background};border:1px solid ${EMAIL.color.border};border-radius:${BLOCK.codeRadius}px;overflow:hidden;margin:0">` +
+        `<div style="padding:7.5px ${BLOCK.codePadding}px;border-bottom:1px solid ${EMAIL.color.border};font-size:11.25px;color:${EMAIL.color.muted};font-family:${EMAIL.font.mono};text-transform:lowercase">${label}</div>` +
+        `<pre style="background:${EMAIL.color.background};padding:${BLOCK.codePadding}px;font-size:12px;font-family:${EMAIL.font.mono};color:${EMAIL.color.text};overflow-x:auto;margin:0;line-height:1.6"><code>${escapeText(source.trimEnd())}</code></pre></div>`;
+}
+export function divider() {
+    return `<hr style="border:0;border-top:1px solid ${EMAIL.color.border};margin:0">`;
+}
+export function table(rows) {
+    const width = Math.max(...rows.map((row) => row.length));
+    const body = rows.map((row, rowIndex) => {
+        const tag = rowIndex === 0 ? 'th' : 'td';
+        const cells = Array.from({ length: width }, (_, column) => {
+            const right = column === width - 1 ? '' : `border-right:1px solid ${EMAIL.color.grid};`;
+            const bottom = rowIndex === rows.length - 1 ? '' : `border-bottom:1px solid ${EMAIL.color.grid};`;
+            const header = rowIndex === 0 ? 'background:#0c0b0a;font-weight:500;' : '';
+            return `<${tag} style="padding:${BLOCK.tableCellPaddingY}px ${BLOCK.tableCellPaddingX}px;text-align:left;vertical-align:top;font-size:14px;line-height:1.5;${right}${bottom}${header}color:${EMAIL.color.text}">${renderInline(row[column] ?? '')}</${tag}>`;
+        }).join('');
+        return `<tr>${cells}</tr>`;
+    }).join('');
+    return `<div style="border:1px solid ${EMAIL.color.grid};border-radius:${BLOCK.tableRadius}px;overflow:hidden;margin:0"><table style="width:100%;border-collapse:collapse">${body}</table></div>`;
+}
+//# sourceMappingURL=blocks.js.map

package/dist/src/email/blocks.js.map

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

package/dist/src/email/escape.d.ts

@@ -0,0 +1,3 @@
+export declare function escapeText(value: string): string;
+export declare function escapeAttribute(value: string): string;
+export declare function safeLink(value: string): string | null;

package/dist/src/email/escape.js

@@ -0,0 +1,19 @@
+export function escapeText(value) {
+    return value
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;');
+}
+export function escapeAttribute(value) {
+    return escapeText(value).replaceAll('"', '&quot;').replaceAll("'", '&#39;');
+}
+export function safeLink(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === 'https:' || url.protocol === 'http:' ? url.toString() : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=escape.js.map

package/dist/src/email/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../../src/email/escape.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}