@amalgm/channels 0.1.0

package/dist/src/contract.d.ts

@@ -0,0 +1,83 @@
+export type ChannelScope = 'channels:read' | 'channels:send';
+export type ChannelPreference = 'auto' | 'email';
+export type DeliveryStatus = 'pending' | 'sending' | 'delivered' | 'failed';
+export interface ChannelPrincipal {
+    readonly userId: string;
+    readonly scopes: readonly ChannelScope[];
+}
+export interface NotifyUserInput {
+    readonly message: string;
+    readonly title?: string;
+    readonly channel?: ChannelPreference;
+    readonly idempotencyKey?: string;
+}
+export interface Delivery {
+    readonly id: string;
+    readonly channel: Exclude<ChannelPreference, 'auto'>;
+    readonly title?: string;
+    readonly message: string;
+    readonly idempotencyKey: string;
+    readonly status: DeliveryStatus;
+    readonly attempts: number;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly deliveredAt?: string;
+    readonly providerId?: string;
+    readonly error?: string;
+}
+export interface DeliveryPage {
+    readonly items: readonly Delivery[];
+    readonly total: number;
+    readonly limit: number;
+    readonly offset: number;
+    readonly hasMore: boolean;
+}
+export interface ListDeliveries {
+    readonly status?: DeliveryStatus;
+    readonly limit?: number;
+    readonly offset?: number;
+}
+export interface NormalizedListDeliveries {
+    readonly status?: DeliveryStatus;
+    readonly limit: number;
+    readonly offset: number;
+}
+export interface Channels {
+    notify(input: NotifyUserInput): Promise<Delivery>;
+    list(query?: ListDeliveries): Promise<DeliveryPage>;
+    get(deliveryId: string): Promise<Delivery | null>;
+}
+export interface ChannelsService {
+    for(principal: ChannelPrincipal): Channels;
+}
+export interface PendingDelivery {
+    readonly id: string;
+    readonly userId: string;
+    readonly channel: 'email';
+    readonly title?: string;
+    readonly message: string;
+    readonly idempotencyKey: string;
+    readonly leaseToken: string;
+    readonly attempts: number;
+}
+export interface DeliveryRepository {
+    enqueue(userId: string, input: Required<NotifyUserInput>): 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>;
+    fail(delivery: PendingDelivery, error: string, now: Date): Promise<boolean>;
+}
+export interface RecipientDirectory {
+    emailForUser(userId: string): Promise<string>;
+}
+export interface EmailProvider {
+    send(input: Readonly<{
+        to: string;
+        subject: string;
+        text: string;
+        idempotencyKey: string;
+    }>): Promise<{
+        readonly providerId: string;
+    }>;
+}

package/dist/src/contract.js

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

package/dist/src/contract.js.map

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

package/dist/src/errors.d.ts

@@ -0,0 +1,5 @@
+export type ChannelsErrorCode = 'validation' | 'forbidden' | 'not_found' | 'provider' | 'internal';
+export declare class ChannelsError extends Error {
+    readonly code: ChannelsErrorCode;
+    constructor(code: ChannelsErrorCode, message: string);
+}

package/dist/src/errors.js

@@ -0,0 +1,9 @@
+export class ChannelsError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ChannelsError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAE3B,IAAI;IADf,YACW,IAAuB,EAChC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;oBAHN,IAAI;QAIb,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/src/http.d.ts

@@ -0,0 +1,6 @@
+import type { ChannelPrincipal, ChannelsService } from './contract.js';
+export type AuthenticateChannelsRequest = (request: Request) => Promise<ChannelPrincipal>;
+export declare function createChannelsApi(options: {
+    readonly service: ChannelsService;
+    readonly authenticate: AuthenticateChannelsRequest;
+}): (request: Request) => Promise<Response>;

package/dist/src/http.js

@@ -0,0 +1,64 @@
+import { ChannelsError } from './errors.js';
+export function createChannelsApi(options) {
+    return async (request) => {
+        try {
+            const sdk = options.service.for(await options.authenticate(request));
+            const url = new URL(request.url);
+            const parts = url.pathname.split('/').filter(Boolean).map(decodeURIComponent);
+            const method = request.method.toUpperCase();
+            if (parts[0] !== 'v1')
+                return json(404, { error: 'Not found' });
+            if (parts[1] === 'notifications' && parts.length === 2 && method === 'POST') {
+                const body = await objectBody(request);
+                return json(202, await sdk.notify({
+                    message: String(body.message ?? ''),
+                    ...(body.title === undefined ? {} : { title: String(body.title) }),
+                    ...(body.channel === undefined ? {} : { channel: body.channel }),
+                    ...(body.idempotencyKey === undefined ? {} : { idempotencyKey: String(body.idempotencyKey) }),
+                }));
+            }
+            if (parts[1] === 'deliveries' && parts.length === 2 && method === 'GET') {
+                return json(200, await sdk.list({
+                    ...(url.searchParams.has('status') ? { status: url.searchParams.get('status') } : {}),
+                    ...(url.searchParams.has('limit') ? { limit: Number(url.searchParams.get('limit')) } : {}),
+                    ...(url.searchParams.has('offset') ? { offset: Number(url.searchParams.get('offset')) } : {}),
+                }));
+            }
+            if (parts[1] === 'deliveries' && parts[2] && parts.length === 3 && method === 'GET') {
+                const delivery = await sdk.get(parts[2]);
+                return delivery ? json(200, delivery) : json(404, { error: 'Not found', code: 'not_found' });
+            }
+            return json(405, { error: 'Method not allowed' });
+        }
+        catch (error) {
+            if (error instanceof ChannelsError)
+                return json(status(error.code), { error: error.message, code: error.code });
+            const code = error instanceof Error && 'code' in error ? String(error.code) : 'internal';
+            return json(code.startsWith('dpop_') || code.includes('access') ? 401 : 500, {
+                error: code === 'internal' ? 'Channels service failed' : 'Authorization denied', code,
+            });
+        }
+    };
+}
+async function objectBody(request) {
+    const body = await request.json().catch(() => null);
+    if (!body || typeof body !== 'object' || Array.isArray(body)) {
+        throw new ChannelsError('validation', 'Request body must be a JSON object');
+    }
+    return body;
+}
+function json(status, body) {
+    return Response.json(body, { status, headers: { 'cache-control': 'no-store' } });
+}
+function status(code) {
+    if (code === 'validation')
+        return 400;
+    if (code === 'forbidden')
+        return 403;
+    if (code === 'not_found')
+        return 404;
+    if (code === 'provider')
+        return 502;
+    return 500;
+}
+//# sourceMappingURL=http.js.map

package/dist/src/http.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,7 @@
+export * from './contract.js';
+export * from './errors.js';
+export * from './validation.js';
+export * from './service.js';
+export * from './worker.js';
+export * from './http.js';
+export * from './client.js';

package/dist/src/index.js

@@ -0,0 +1,8 @@
+export * from './contract.js';
+export * from './errors.js';
+export * from './validation.js';
+export * from './service.js';
+export * from './worker.js';
+export * from './http.js';
+export * from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/src/mcp.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Channels } from './contract.js';
+export declare function createChannelsMcpServer(channels: Channels): McpServer;

package/dist/src/mcp.js

@@ -0,0 +1,66 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod/v3';
+const outputSchema = { result: z.unknown() };
+export function createChannelsMcpServer(channels) {
+    const server = new McpServer({ name: 'amalgm-channels-mcp-server', version: '0.1.0' });
+    server.registerTool('amalgm_channels_notify_user', {
+        title: 'Notify current user',
+        description: 'Queue one durable notification to the authenticated Amalgm user. The caller cannot select another recipient. Supply an idempotency key when retrying the same logical message.',
+        inputSchema: {
+            message: z.string().min(1).max(4_000).describe('Notification text.'),
+            title: z.string().min(1).max(160).optional().describe('Short notification title.'),
+            channel: z.enum(['auto', 'email']).optional().describe('Delivery preference. Auto currently resolves to email.'),
+            idempotency_key: z.string().min(1).max(200).optional().describe('Stable key for safe retries of this exact notification.'),
+        },
+        outputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ message, title, channel, idempotency_key }) => result(await channels.notify({
+        message,
+        ...(title === undefined ? {} : { title }),
+        ...(channel === undefined ? {} : { channel }),
+        ...(idempotency_key === undefined ? {} : { idempotencyKey: idempotency_key }),
+    })));
+    server.registerTool('amalgm_channels_list_deliveries', {
+        title: 'List notification deliveries',
+        description: 'List the authenticated user\'s durable notification delivery history.',
+        inputSchema: {
+            status: z.enum(['pending', 'sending', 'delivered', 'failed']).optional(),
+            limit: z.number().int().min(1).max(100).optional(),
+            offset: z.number().int().min(0).optional(),
+        },
+        outputSchema,
+        annotations: readOnly(),
+    }, async ({ status, limit, offset }) => result(await channels.list({
+        ...(status === undefined ? {} : { status }),
+        ...(limit === undefined ? {} : { limit }),
+        ...(offset === undefined ? {} : { offset }),
+    })));
+    server.registerTool('amalgm_channels_get_delivery', {
+        title: 'Get notification delivery',
+        description: 'Get one durable notification delivery by id for the authenticated user.',
+        inputSchema: { delivery_id: z.string().min(1).max(200) },
+        outputSchema,
+        annotations: readOnly(),
+    }, async ({ delivery_id }) => result(await channels.get(delivery_id)));
+    return server;
+}
+function result(value) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(value) }],
+        structuredContent: { result: value },
+    };
+}
+function readOnly() {
+    return {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/src/mcp.js.map

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

package/dist/src/service.d.ts

@@ -0,0 +1,2 @@
+import type { ChannelsService, DeliveryRepository } from './contract.js';
+export declare function createChannelsService(repository: DeliveryRepository): ChannelsService;

package/dist/src/service.js

@@ -0,0 +1,29 @@
+import { ChannelsError } from './errors.js';
+import { deliveryQuery, identifier, notification } from './validation.js';
+export function createChannelsService(repository) {
+    return Object.freeze({
+        for(principal) {
+            const userId = identifier(principal.userId, 'principal.userId');
+            const scopes = new Set(principal.scopes);
+            return Object.freeze({
+                async notify(input) {
+                    requireScope(scopes, 'channels:send');
+                    return repository.enqueue(userId, notification(input));
+                },
+                async list(query) {
+                    requireScope(scopes, 'channels:read');
+                    return repository.list(userId, deliveryQuery(query));
+                },
+                async get(deliveryId) {
+                    requireScope(scopes, 'channels:read');
+                    return repository.get(userId, identifier(deliveryId, 'deliveryId'));
+                },
+            });
+        },
+    });
+}
+function requireScope(scopes, required) {
+    if (!scopes.has(required))
+        throw new ChannelsError('forbidden', `Missing scope: ${required}`);
+}
+//# sourceMappingURL=service.js.map

package/dist/src/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,UAAU,qBAAqB,CAAC,UAA8B;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,CAAC,SAA2B;YAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAS,SAAS,CAAC,MAAM,CAAC,CAAC;YACjD,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,KAAK,CAAC,MAAM,CAAC,KAAwC;oBACnD,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;oBACtC,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;gBACzD,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,KAAuC;oBAChD,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;oBACtC,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;gBACvD,CAAC;gBACD,KAAK,CAAC,GAAG,CAAC,UAAkB;oBAC1B,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;oBACtC,OAAO,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;gBACtE,CAAC;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,MAA2B,EAAE,QAAgB;IACjE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,aAAa,CAAC,WAAW,EAAE,kBAAkB,QAAQ,EAAE,CAAC,CAAC;AAChG,CAAC"}

package/dist/src/validation.d.ts

@@ -0,0 +1,4 @@
+import type { ListDeliveries, NormalizedListDeliveries, NotifyUserInput } from './contract.js';
+export declare function notification(input: NotifyUserInput): Required<NotifyUserInput>;
+export declare function deliveryQuery(input?: ListDeliveries): NormalizedListDeliveries;
+export declare function identifier(value: string, name: string): string;

package/dist/src/validation.js

@@ -0,0 +1,48 @@
+import { randomUUID } from 'node:crypto';
+import { ChannelsError } from './errors.js';
+const statuses = new Set(['pending', 'sending', 'delivered', 'failed']);
+export function notification(input) {
+    const message = bounded(input.message, 'message', 1, 4_000);
+    const title = input.title === undefined
+        ? 'Amalgm reminder'
+        : bounded(input.title, 'title', 1, 160);
+    const channel = input.channel ?? 'auto';
+    if (channel !== 'auto' && channel !== 'email') {
+        throw new ChannelsError('validation', 'channel must be auto or email');
+    }
+    const idempotencyKey = input.idempotencyKey === undefined
+        ? randomUUID()
+        : bounded(input.idempotencyKey, 'idempotencyKey', 1, 200);
+    return Object.freeze({ message, title, channel, idempotencyKey });
+}
+export function deliveryQuery(input = {}) {
+    const limit = input.limit ?? 50;
+    const offset = input.offset ?? 0;
+    if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+        throw new ChannelsError('validation', 'limit must be an integer from 1 to 100');
+    }
+    if (!Number.isInteger(offset) || offset < 0) {
+        throw new ChannelsError('validation', 'offset must be a non-negative integer');
+    }
+    if (input.status !== undefined && !statuses.has(input.status)) {
+        throw new ChannelsError('validation', 'status is invalid');
+    }
+    return {
+        ...(input.status === undefined ? {} : { status: input.status }),
+        limit,
+        offset,
+    };
+}
+export function identifier(value, name) {
+    return bounded(value, name, 1, 200);
+}
+function bounded(value, name, minimum, maximum) {
+    if (typeof value !== 'string')
+        throw new ChannelsError('validation', `${name} must be a string`);
+    const normalized = value.trim();
+    if (normalized.length < minimum || normalized.length > maximum) {
+        throw new ChannelsError('validation', `${name} must be ${minimum}-${maximum} characters`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=validation.js.map

package/dist/src/validation.js.map

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

package/dist/src/worker.d.ts

@@ -0,0 +1,15 @@
+import type { DeliveryRepository, EmailProvider, RecipientDirectory } from './contract.js';
+export interface ChannelsWorkerOptions {
+    readonly batchSize?: number;
+    readonly leaseSeconds?: number;
+    readonly now?: () => Date;
+    readonly log?: (event: string, details: Readonly<Record<string, unknown>>) => void;
+}
+export declare class ChannelsWorker {
+    #private;
+    private readonly repository;
+    private readonly directory;
+    private readonly email;
+    constructor(repository: DeliveryRepository, directory: RecipientDirectory, email: EmailProvider, options?: ChannelsWorkerOptions);
+    drainOnce(): Promise<number>;
+}

package/dist/src/worker.js

@@ -0,0 +1,46 @@
+export class ChannelsWorker {
+    repository;
+    directory;
+    email;
+    #batchSize;
+    #leaseSeconds;
+    #now;
+    #log;
+    constructor(repository, directory, email, options = {}) {
+        this.repository = repository;
+        this.directory = directory;
+        this.email = email;
+        this.#batchSize = options.batchSize ?? 20;
+        this.#leaseSeconds = options.leaseSeconds ?? 60;
+        this.#now = options.now ?? (() => new Date());
+        this.#log = options.log ?? (() => { });
+    }
+    async drainOnce() {
+        const deliveries = await this.repository.claim(this.#batchSize, this.#leaseSeconds);
+        await Promise.all(deliveries.map((delivery) => this.#deliver(delivery)));
+        return deliveries.length;
+    }
+    async #deliver(delivery) {
+        try {
+            const to = await this.directory.emailForUser(delivery.userId);
+            const result = await this.email.send({
+                to,
+                subject: delivery.title ?? 'Amalgm reminder',
+                text: delivery.message,
+                idempotencyKey: delivery.idempotencyKey,
+            });
+            await this.repository.complete(delivery, result.providerId, this.#now());
+            this.#log('delivery.completed', { deliveryId: delivery.id, attempts: delivery.attempts });
+        }
+        catch (error) {
+            const message = safeError(error);
+            await this.repository.fail(delivery, message, this.#now());
+            this.#log('delivery.failed', { deliveryId: delivery.id, error: message });
+        }
+    }
+}
+function safeError(error) {
+    const message = error instanceof Error ? error.message : 'Provider delivery failed';
+    return message.replace(/[\r\n]+/g, ' ').slice(0, 500);
+}
+//# sourceMappingURL=worker.js.map

package/dist/src/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/worker.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,cAAc;IAON,UAAU;IACV,SAAS;IACT,KAAK;IARf,UAAU,CAAS;IACnB,aAAa,CAAS;IACtB,IAAI,CAAa;IACjB,IAAI,CAA4C;IAEzD,YACmB,UAA8B,EAC9B,SAA6B,EAC7B,KAAoB,EACrC,OAAO,GAA0B,EAAE;0BAHlB,UAAU;yBACV,SAAS;qBACT,KAAK;QAGtB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QACpF,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO,UAAU,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAyB;QACtC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBACnC,EAAE;gBACF,OAAO,EAAE,QAAQ,CAAC,KAAK,IAAI,iBAAiB;gBAC5C,IAAI,EAAE,QAAQ,CAAC,OAAO;gBACtB,cAAc,EAAE,QAAQ,CAAC,cAAc;aACxC,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;CACF;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC;IACpF,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@amalgm/channels",
+  "version": "0.1.0",
+  "description": "Amalgm's SDK and hosted service for durable user notification delivery.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amalgm-inc/amalgm-channels.git"
+  },
+  "publishConfig": { "access": "public" },
+  "exports": {
+    ".": { "types": "./dist/src/index.d.ts", "import": "./dist/src/index.js" },
+    "./mcp": { "types": "./dist/src/mcp.d.ts", "import": "./dist/src/mcp.js" },
+    "./host": { "types": "./dist/host/index.d.ts", "import": "./dist/host/index.js" }
+  },
+  "files": ["dist", "supabase", "skills", "PURPOSE.md", "README.md"],
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "check": "tsx scripts/check-tree.ts && tsc -p tsconfig.json --noEmit",
+    "test": "tsx --test test/*.test.ts",
+    "verify": "npm run check && npm test && npm run build",
+    "prepack": "npm run build",
+    "start": "node dist/host/main.js"
+  },
+  "engines": { "node": ">=20" },
+  "dependencies": {
+    "@amalgm/core": "0.4.2",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@supabase/supabase-js": "2.57.4",
+    "jose": "^6.1.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "tsx": "^4.23.1",
+    "typescript": "^7.0.2"
+  }
+}

package/skills/channels/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: amalgm-channels
+description: Send a durable notification to the current Amalgm user or inspect their delivery history through the Channels tools.
+---
+
+# Amalgm Channels
+
+Use Channels when the user asks to be notified, reminded, emailed, or contacted
+by an automation. Channels always addresses the authenticated current user. Do
+not ask for or pass their email address.
+
+## Send
+
+Call `amalgm_channels_notify_user` with concise `message` text. Add a short
+`title` when it improves recognition. Use `channel: auto` unless the user
+explicitly asks for email.
+
+When the notification belongs to an automation run, always pass that durable
+run id as `idempotency_key`. Retrying the same run will then return the original
+delivery instead of sending twice.
+
+The returned `pending` state means the message is durably queued, not yet
+delivered. Use `amalgm_channels_get_delivery` if confirmed delivery matters.
+
+## Inspect
+
+Use `amalgm_channels_list_deliveries` for history and status filtering. Delivery
+records expose content, attempts, safe provider status, and timestamps; they do
+not expose recipient coordinates or provider credentials.