@acquiredintelligence/attend 0.0.0-stage → 0.2.0

package/dist/server/serve.js

@@ -0,0 +1,238 @@
+import { createServer } from 'node:http';
+import { readFileSync } from 'node:fs';
+import { createAttend } from '../attend.js';
+import { KINDS } from '../core/types.js';
+import { memoryStore } from '../memory.js';
+import { eventsServer } from './install.js';
+import { ndjsonIngest } from './ingest.js';
+/** What `attend serve` runs: attend.run, eventsServer over store.log, ndjsonIngest, one HTTP listener. */
+export function serve(attend, store, options) {
+    const events = eventsServer(store.log, { ...options.events, ...(options.principal ? { principal: options.principal } : {}) });
+    const ingest = options.principal ? { principal: options.principal } : {};
+    const routes = { 'POST /v1/ingest': ndjsonIngest(attend, ingest) };
+    if (options.ingest?.stream !== false)
+        routes['POST /v1/ingest/stream'] = ndjsonIngest(attend, { ...ingest, stream: true });
+    const handler = events.http({ path: '/mcp', routes });
+    const server = createServer((req, res) => { void Promise.resolve(handler(req, res)).catch(() => res.destroy()); });
+    const controller = new AbortController();
+    let failure;
+    let closing;
+    let address = '';
+    const running = attend.run({ signal: controller.signal }).catch((error) => { failure = { error }; void close().catch(() => undefined); });
+    const ready = new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.once('listening', () => {
+            const bound = server.address();
+            address = typeof bound === 'string' || bound === null
+                ? `http+unix://${encodeURIComponent(bound ?? '')}`
+                : `http://${bound.family === 'IPv6' ? `[${bound.address}]` : bound.address}:${bound.port}`;
+            resolve();
+        });
+    });
+    ready.catch(() => { void close().catch(() => undefined); });
+    const closed = new Promise((resolve) => server.once('close', () => resolve()));
+    if ('path' in options.listen)
+        server.listen(options.listen.path);
+    else
+        server.listen(options.listen.port, options.listen.host ?? '127.0.0.1');
+    function close() {
+        closing ??= (async () => {
+            controller.abort();
+            await running;
+            await events.close();
+            server.closeAllConnections();
+            if (server.listening)
+                await new Promise((resolve) => server.close(() => resolve()));
+            if (failure)
+                throw failure.error;
+        })();
+        return closing;
+    }
+    return {
+        url() {
+            if (!address)
+                throw new Error('attend: serve is not listening yet; await ready');
+            return address;
+        },
+        ready,
+        closed,
+        close,
+    };
+}
+const USAGE = 'usage: attend serve [--store memory|sqlite:<file>|postgres:<url>|redis:<url>] [--judge rule|jev|decisions] [--kinds <json|file>] [--host h] [--port n] [--socket path] [--act-threshold n] [--token t]';
+const HELP = `${USAGE}
+
+  flag              env                    default     meaning
+  --store           ATTEND_STORE           memory      where state and the decision log live
+  --judge           ATTEND_JUDGE           rule        rule | jev (TYPESAFE_API_KEY) | decisions (OPENAI_API_KEY, --judge-model)
+  --judge-model     ATTEND_JUDGE_MODEL                 model id for the decisions judge
+  --kinds           ATTEND_KINDS                       event name -> kind, inline JSON or a JSON file
+  --default-kind    ATTEND_DEFAULT_KIND    consequence kind for names --kinds does not list
+  --host            ATTEND_HOST            127.0.0.1
+  --port            ATTEND_PORT            8787        0 picks a free port
+  --socket          ATTEND_SOCKET                      listen on a unix socket instead
+  --act-threshold   ATTEND_ACT_THRESHOLD   off         number in (0, 1]
+  --token           ATTEND_TOKEN                       require Authorization: Bearer <token>
+`;
+class UsageError extends Error {
+}
+const FLAGS = {
+    store: 'ATTEND_STORE', judge: 'ATTEND_JUDGE', 'judge-model': 'ATTEND_JUDGE_MODEL', kinds: 'ATTEND_KINDS', 'default-kind': 'ATTEND_DEFAULT_KIND',
+    host: 'ATTEND_HOST', port: 'ATTEND_PORT', socket: 'ATTEND_SOCKET', 'act-threshold': 'ATTEND_ACT_THRESHOLD', token: 'ATTEND_TOKEN',
+};
+function parseFlags(args, env) {
+    const given = {};
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        const match = /^--([a-z-]+)(?:=(.*))?$/s.exec(arg);
+        if (!match || !(match[1] in FLAGS))
+            throw new UsageError(`unknown argument ${arg}`);
+        const value = match[2] ?? args[++i];
+        if (value === undefined)
+            throw new UsageError(`--${match[1]} needs a value`);
+        given[match[1]] = value;
+    }
+    return Object.fromEntries(Object.entries(FLAGS).map(([flag, name]) => [flag, given[flag] ?? env[name]]));
+}
+function kindFunction(flags) {
+    const fallback = flags['default-kind'] ?? 'consequence';
+    if (!KINDS.includes(fallback))
+        throw new UsageError(`--default-kind must be one of ${KINDS.join(', ')}`);
+    let map = {};
+    const source = flags.kinds;
+    if (source !== undefined && source !== '') {
+        try {
+            map = JSON.parse(source.trimStart().startsWith('{') ? source : readFileSync(source, 'utf8'));
+        }
+        catch (error) {
+            throw new UsageError(`--kinds is not a JSON object or a readable JSON file: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (typeof map !== 'object' || map === null || Array.isArray(map))
+            throw new UsageError('--kinds must be a JSON object of event name to kind');
+        for (const [name, kind] of Object.entries(map)) {
+            if (typeof kind !== 'string' || !KINDS.includes(kind))
+                throw new UsageError(`--kinds: "${name}" must map to one of ${KINDS.join(', ')}`);
+        }
+    }
+    return (event) => (Object.hasOwn(map, event.name) ? map[event.name] : fallback);
+}
+async function judgeFor(flags, env) {
+    switch (flags.judge ?? 'rule') {
+        case 'rule': return async ({ window }) => ({ route: window.reason === 'flush' ? 'interrupt' : 'queue' });
+        case 'jev': {
+            if (!env.TYPESAFE_API_KEY)
+                throw new UsageError('--judge jev needs TYPESAFE_API_KEY in the environment');
+            return (await import('../jev.js')).jevJudge({ apiKey: env.TYPESAFE_API_KEY });
+        }
+        case 'decisions': {
+            if (!env.OPENAI_API_KEY)
+                throw new UsageError('--judge decisions needs OPENAI_API_KEY in the environment');
+            if (!flags['judge-model'])
+                throw new UsageError('--judge decisions needs --judge-model (or ATTEND_JUDGE_MODEL)');
+            return (await import('../decisions.js')).decisionsJudge({ apiKey: env.OPENAI_API_KEY, model: flags['judge-model'] });
+        }
+        default: throw new UsageError(`--judge must be rule, jev or decisions, not "${flags.judge}"`);
+    }
+}
+async function storeFor(spec, env, cleanup) {
+    if (spec === 'memory')
+        return memoryStore();
+    const missing = (name) => new UsageError(`--store ${spec.split(':')[0]} needs the "${name}" package: npm install ${name}`);
+    if (spec.startsWith('sqlite:')) {
+        const file = spec.slice('sqlite:'.length);
+        if (!file)
+            throw new UsageError('--store sqlite:<file> needs a file path');
+        const { DatabaseSync } = await import('node:sqlite');
+        const db = new DatabaseSync(file);
+        cleanup.push(async () => db.close());
+        return (await import('../sqlite.js')).sqliteStore(db);
+    }
+    if (spec === 'postgres' || spec.startsWith('postgres:') || spec.startsWith('postgresql:')) {
+        const url = spec === 'postgres' ? env.DATABASE_URL : spec.startsWith('postgres://') || spec.startsWith('postgresql://') ? spec : spec.slice('postgres:'.length);
+        if (!url)
+            throw new UsageError('--store postgres needs a URL: postgres:<url> or DATABASE_URL');
+        const pg = await import('pg').catch(() => { throw missing('pg'); });
+        const pool = new (pg.default ?? pg).Pool({ connectionString: url });
+        cleanup.push(() => pool.end());
+        const { migrate, postgresStore } = await import('../postgres.js');
+        await migrate(pool);
+        return postgresStore(pool);
+    }
+    if (spec === 'redis' || spec.startsWith('redis:') || spec.startsWith('rediss:')) {
+        const url = spec === 'redis' ? env.REDIS_URL : spec.startsWith('redis://') || spec.startsWith('rediss://') ? spec : spec.slice('redis:'.length);
+        if (!url)
+            throw new UsageError('--store redis needs a URL: redis:<url> or REDIS_URL');
+        const redis = await import('redis').catch(() => { throw missing('redis'); });
+        const client = redis.createClient({ url });
+        await client.connect();
+        cleanup.push(async () => { client.destroy(); });
+        return (await import('../redis.js')).redisStore((args) => client.sendCommand(args));
+    }
+    throw new UsageError(`--store must be memory, sqlite:<file>, postgres:<url> or redis:<url>, not "${spec}"`);
+}
+/** The `attend` command. Returns the exit code once the server has shut down. */
+export async function cli(argv, env, io = {}) {
+    const out = io.out ?? ((text) => void process.stdout.write(text));
+    const err = io.err ?? ((text) => void process.stderr.write(text));
+    if (argv.includes('--help') || argv.includes('-h')) {
+        out(HELP);
+        return 0;
+    }
+    const cleanup = [];
+    let store;
+    let server;
+    try {
+        if (argv[0] !== 'serve')
+            throw new UsageError(argv[0] === undefined ? 'missing command' : `unknown command "${argv[0]}"`);
+        const flags = parseFlags(argv.slice(1), env);
+        const kind = kindFunction(flags);
+        const threshold = flags['act-threshold'] === undefined ? undefined : Number(flags['act-threshold']);
+        if (threshold !== undefined && !(threshold > 0 && threshold <= 1))
+            throw new UsageError('--act-threshold must be a number in (0, 1]');
+        const port = flags.port === undefined ? 8787 : Number(flags.port);
+        if (!Number.isInteger(port) || port < 0 || port > 65535)
+            throw new UsageError('--port must be an integer from 0 to 65535');
+        const judge = await judgeFor(flags, env);
+        await import('@modelcontextprotocol/server').catch(() => { throw new Error('attend serve needs the MCP server package: npm install @modelcontextprotocol/server zod'); });
+        store = await storeFor(flags.store ?? 'memory', env, cleanup);
+        const token = flags.token;
+        const principal = token ? (req) => (req.headers.authorization === `Bearer ${token}` ? { id: 'attend', scopes: [''] } : null) : undefined;
+        const attend = createAttend({ store, judge, kind, sink: 'log', deadLetter: 'log', ...(threshold === undefined ? {} : { actThreshold: threshold }) });
+        server = serve(attend, store, { listen: flags.socket ? { path: flags.socket } : { port, host: flags.host ?? '127.0.0.1' }, ...(principal ? { principal } : {}) });
+        await server.ready;
+        const url = server.url();
+        out(`attend serving ${url}  (ingest POST ${url}/v1/ingest, MCP ${url}/mcp)\n`);
+        const stop = new AbortController();
+        const onSignal = () => stop.abort();
+        if (io.signal)
+            io.signal.addEventListener('abort', onSignal, { once: true });
+        else {
+            process.once('SIGINT', onSignal);
+            process.once('SIGTERM', onSignal);
+        }
+        if (io.signal?.aborted)
+            stop.abort();
+        await Promise.race([new Promise((resolve) => stop.signal.addEventListener('abort', () => resolve(), { once: true })), server.closed]);
+        process.off('SIGINT', onSignal);
+        process.off('SIGTERM', onSignal);
+        const finished = server;
+        server = undefined;
+        await finished.close();
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof UsageError) {
+            err(`attend: ${error.message}\n${USAGE}\n`);
+            return 2;
+        }
+        err(`attend: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    finally {
+        await server?.close().catch((error) => { err(`attend: ${error instanceof Error ? error.message : String(error)}\n`); });
+        await store?.close?.();
+        for (const close of cleanup)
+            await close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=serve.js.map

package/dist/server/serve.js.map

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

package/dist/server/sessions.d.ts

@@ -0,0 +1,14 @@
+export interface Sessions {
+    open(): string | null;
+    touch(id: string): boolean;
+    hold(id: string): () => void;
+    close(id: string): void;
+    dispose(): void;
+}
+/** attend's session table, with a cap and idle expiry. */
+export declare function createSessions(options: {
+    max: number;
+    idleMs: number;
+    onClose?: (id: string) => void;
+}): Sessions;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/server/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/server/sessions.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAAG,QAAQ,CAmCjH"}

package/dist/server/sessions.js

@@ -0,0 +1,54 @@
+import { randomUUID } from 'node:crypto';
+/** attend's session table, with a cap and idle expiry. */
+export function createSessions(options) {
+    const entries = new Map();
+    function close(id) { if (entries.delete(id))
+        options.onClose?.(id); }
+    function expire() {
+        const now = Date.now();
+        for (const [id, entry] of entries)
+            if (!entry.holds && now - entry.touched >= options.idleMs)
+                close(id);
+    }
+    const timer = setInterval(expire, Math.max(1, Math.min(options.idleMs, 60_000)));
+    timer.unref();
+    return {
+        open() {
+            expire();
+            if (entries.size >= options.max)
+                return null;
+            const id = randomUUID();
+            entries.set(id, { touched: Date.now(), holds: 0 });
+            return id;
+        },
+        touch(id) {
+            const entry = entries.get(id);
+            if (!entry)
+                return false;
+            if (!entry.holds && Date.now() - entry.touched >= options.idleMs) {
+                close(id);
+                return false;
+            }
+            entry.touched = Date.now();
+            return true;
+        },
+        hold(id) {
+            const entry = entries.get(id);
+            if (!entry)
+                return () => undefined;
+            entry.holds++;
+            let released = false;
+            return () => {
+                if (released)
+                    return;
+                released = true;
+                if (--entry.holds === 0)
+                    entry.touched = Date.now();
+            };
+        },
+        close,
+        dispose() { clearInterval(timer); for (const id of entries.keys())
+            close(id); },
+    };
+}
+//# sourceMappingURL=sessions.js.map

package/dist/server/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/server/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,OAAwE;IACrG,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8C,CAAC;IACtE,SAAS,KAAK,CAAC,EAAU,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7E,SAAS,MAAM;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,OAAO;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM;gBAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACjF,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,OAAO;QACL,IAAI;YACF,MAAM,EAAE,CAAC;YACT,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YAC7C,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAAC,OAAO,EAAE,CAAC;QACzF,CAAC;QACD,KAAK,CAAC,EAAE;YACN,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAAC,OAAO,KAAK,CAAC;YAAC,CAAC;YAC9F,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAAC,OAAO,IAAI,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,EAAE;YACL,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK;gBAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;YACnC,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,OAAO,GAAG,EAAE;gBACV,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,IAAI,EAAE,KAAK,CAAC,KAAK,KAAK,CAAC;oBAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtD,CAAC,CAAC;QACJ,CAAC;QACD,KAAK;QACL,OAAO,KAAK,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE;YAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KAChF,CAAC;AACJ,CAAC"}

package/dist/server/stream.d.ts

@@ -0,0 +1,11 @@
+import { type Principal, type ServerContext, type StreamEventsResult, type StreamNotification, type StreamParams } from './types.js';
+/** Owned queue and in-flight work, for checking stream memory bounds. */
+export declare function streamUsage(context: ServerContext): {
+    count: number;
+    queuedBytes: number;
+    writeBytes: number;
+    pageRows: number;
+};
+/** Sends a subscription in order, replaying the log whenever its live outbox fills. */
+export declare function streamEvents(context: ServerContext, params: StreamParams, principal: Principal, subscriptionId: string | number, send: (notification: StreamNotification) => Promise<void>, signal: AbortSignal): Promise<StreamEventsResult>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/server/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/server/stream.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAK3J,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAGhI;AAWD,uFAAuF;AACvF,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0InP"}

package/dist/server/stream.js

@@ -0,0 +1,216 @@
+import { setImmediate as yieldTurn } from 'node:timers/promises';
+import { encodeCursor, lostBefore, resolveStart } from './cursor.js';
+import { eventsError, matches, parseSubscription, queryFor } from './events.js';
+import { eventNotification, notificationJSON } from './fanout.js';
+import { SUBSCRIPTION_ID_META } from './types.js';
+const streams = new WeakMap();
+/** Owned queue and in-flight work, for checking stream memory bounds. */
+export function streamUsage(context) {
+    const active = streams.get(context);
+    return { count: active?.size ?? 0, queuedBytes: [...active ?? []].reduce((sum, stream) => sum + stream.bytes, 0), writeBytes: [...active ?? []].reduce((sum, stream) => sum + stream.writeBytes, 0), pageRows: [...active ?? []].reduce((sum, stream) => sum + stream.pageRows, 0) };
+}
+function abortable(promise, signal) {
+    return new Promise((resolve, reject) => {
+        const abort = () => reject(new DOMException('Stream aborted', 'AbortError'));
+        signal.addEventListener('abort', abort, { once: true });
+        promise.then(resolve, reject).finally(() => signal.removeEventListener('abort', abort));
+        if (signal.aborted)
+            abort();
+    });
+}
+/** Sends a subscription in order, replaying the log whenever its live outbox fills. */
+export async function streamEvents(context, params, principal, subscriptionId, send, signal) {
+    const { filter, cursor, maxAgeMs } = parseSubscription(params, principal);
+    const max = context.options.maxStreamsPerPrincipal ?? 256;
+    const active = streams.get(context) ?? new Set();
+    streams.set(context, active);
+    if ([...active].filter((stream) => stream.principal === principal.id).length >= max)
+        throw eventsError('ResourceExhausted', 'Stream quota exceeded', { limit: 'streams', max });
+    const outbox = { principal: principal.id, bytes: 0, writeBytes: 0, pageRows: 0 };
+    active.add(outbox);
+    const combined = AbortSignal.any([signal, context.signal]);
+    const _meta = { [SUBSCRIPTION_ID_META]: subscriptionId };
+    const complete = { resultType: 'complete', _meta };
+    let unsubscribe = () => undefined;
+    let wake = () => undefined;
+    try {
+        const now = Date.now();
+        const epoch = await abortable(context.epoch(), combined);
+        const start = await abortable(resolveStart(context.log, epoch, cursor), combined);
+        let checked = start.after;
+        const sinceAt = maxAgeMs !== undefined && !start.fromNow ? now - maxAgeMs : undefined;
+        let agePending = sinceAt;
+        let truncated = start.truncated;
+        let behind = !start.fromNow;
+        let pendingError;
+        let lastFrame = Date.now();
+        let sent = 0;
+        const queue = [];
+        const budget = context.options.streamBufferBytes ?? 1_048_576;
+        const heartbeatMs = Math.max(1, Math.min(context.options.heartbeatMs ?? 15_000, 30_000));
+        const fanout = context.fanout;
+        const clear = () => { queue.length = 0; outbox.bytes = 0; };
+        const later = (position, than) => position !== null && (than === null || context.log.compare(position, than) > 0);
+        const positionCursor = () => encodeCursor({ epoch, position: checked ?? '' });
+        async function write(notification) {
+            combined.throwIfAborted();
+            outbox.writeBytes = Buffer.byteLength(notificationJSON(notification)) + 8;
+            try {
+                await abortable(send(notification), combined);
+            }
+            finally {
+                outbox.writeBytes = 0;
+            }
+            lastFrame = Date.now();
+            if (++sent % 64 === 0)
+                await abortable(yieldTurn(), combined);
+        }
+        async function pause(ms) {
+            let timer;
+            try {
+                await abortable(new Promise((resolve) => { wake = resolve; timer = setTimeout(resolve, ms); }), combined);
+            }
+            finally {
+                clearTimeout(timer);
+                wake = () => undefined;
+            }
+        }
+        async function reading(promise) {
+            let settled;
+            promise.then((value) => { settled = { value }; wake(); }, (error) => { settled = { error }; wake(); });
+            const outcome = () => settled;
+            let result = outcome();
+            while (result === undefined) {
+                await pause(Math.max(1, heartbeatMs - (Date.now() - lastFrame)));
+                result = outcome();
+                if (result === undefined && Date.now() - lastFrame >= heartbeatMs)
+                    await write({ method: 'notifications/events/heartbeat', params: { cursor: positionCursor(), _meta } });
+            }
+            if ('error' in result)
+                throw result.error;
+            return result.value;
+        }
+        unsubscribe = fanout.subscribe(filter, (row) => {
+            if (behind || !later(row.position, checked) || combined.aborted)
+                return;
+            const notification = eventNotification(row, filter, context.options.payload?.maxEventsBytes, epoch, subscriptionId);
+            const bytes = Buffer.byteLength(notificationJSON(notification)) + 8;
+            if (outbox.bytes + bytes > budget) {
+                clear();
+                behind = true;
+            }
+            else {
+                queue.push({ position: row.position, notification, bytes });
+                outbox.bytes += bytes;
+            }
+            wake();
+        }, {
+            change: () => wake(),
+            gap: () => { clear(); behind = true; wake(); },
+            error: (error) => { pendingError = { reason: error }; behind = true; clear(); wake(); },
+        });
+        async function read() {
+            const cached = sinceAt === undefined ? fanout.cached(checked) : null;
+            return cached ?? context.log.read({ after: checked, ...queryFor(filter), ...(sinceAt === undefined ? {} : { sinceAt }), limit: 256, scanLimit: 1024 });
+        }
+        await abortable(fanout.ready, combined);
+        if (later(fanout.checked(), checked))
+            behind = true;
+        let page;
+        if (behind) {
+            try {
+                page = await abortable(read(), combined);
+                if (await abortable(lostBefore(context.log, checked, page, agePending), combined)) {
+                    checked = null;
+                    truncated = true;
+                    page = undefined;
+                }
+                agePending = undefined;
+            }
+            catch (error) {
+                if (combined.aborted)
+                    throw error;
+                pendingError = { reason: error };
+            }
+        }
+        await write({ method: 'notifications/events/active', params: { cursor: positionCursor(), truncated, _meta } });
+        while (!combined.aborted) {
+            if (!context.descriptors.some((descriptor) => descriptor.name === filter.name)) {
+                await write({ method: 'notifications/events/terminated', params: { error: eventsError('NotFound', 'Event type removed', { kind: 'event' }).toJSON(), _meta } });
+                throw new DOMException('Event type removed', 'AbortError');
+            }
+            if (pendingError !== undefined) {
+                const error = pendingError.reason;
+                pendingError = undefined;
+                await write({ method: 'notifications/events/error', params: { error: eventsError('Transient', 'Store temporarily unavailable', { reason: error instanceof Error ? error.message : String(error) }).toJSON(), _meta } });
+                await pause(Math.min(100, heartbeatMs));
+            }
+            if (behind) {
+                let lost = false;
+                try {
+                    page ??= await reading(read());
+                    lost = await reading(lostBefore(context.log, checked, page, agePending));
+                    agePending = undefined;
+                }
+                catch (error) {
+                    if (combined.aborted)
+                        throw error;
+                    pendingError = { reason: error };
+                    continue;
+                }
+                if (lost) {
+                    checked = null;
+                    page = undefined;
+                    await write({ method: 'notifications/events/active', params: { cursor: positionCursor(), truncated: true, _meta } });
+                    continue;
+                }
+                outbox.pageRows = page.rows.length;
+                for (const row of page.rows) {
+                    if (later(row.position, checked) && matches(filter, row) && (sinceAt === undefined || row.at >= sinceAt)) {
+                        await write(eventNotification(row, filter, context.options.payload?.maxEventsBytes, epoch, subscriptionId));
+                        checked = row.position;
+                    }
+                }
+                if (later(page.checked, checked))
+                    checked = page.checked;
+                const more = page.more;
+                page = undefined;
+                outbox.pageRows = 0;
+                if (Date.now() - lastFrame >= heartbeatMs)
+                    await write({ method: 'notifications/events/heartbeat', params: { cursor: positionCursor(), _meta } });
+                if (more || later(fanout.checked(), checked))
+                    continue;
+                behind = false;
+                continue;
+            }
+            const next = queue.shift();
+            if (next) {
+                outbox.bytes -= next.bytes;
+                if (later(next.position, checked)) {
+                    await write(next.notification);
+                    checked = next.position;
+                }
+                continue;
+            }
+            if (later(fanout.checked(), checked))
+                checked = fanout.checked();
+            if (Date.now() - lastFrame >= heartbeatMs)
+                await write({ method: 'notifications/events/heartbeat', params: { cursor: positionCursor(), _meta } });
+            await pause(Math.max(1, heartbeatMs - (Date.now() - lastFrame)));
+        }
+        if (signal.aborted)
+            throw new DOMException('Stream aborted', 'AbortError');
+        return complete;
+    }
+    catch (error) {
+        if (context.signal.aborted && !signal.aborted)
+            return complete;
+        throw error;
+    }
+    finally {
+        unsubscribe();
+        wake();
+        active.delete(outbox);
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/server/stream.js.map

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

package/dist/server/tools.d.ts

@@ -0,0 +1,22 @@
+import type { JsonObject } from '../core/types.js';
+import type { Principal, ServerContext } from './types.js';
+/** An MCP tool offered by the event server. */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: JsonObject;
+}
+/** Text and structured representations of a tool result. */
+export type ToolResult = {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    structuredContent?: JsonObject;
+    isError?: boolean;
+};
+/** attend_wait and attend_window. */
+export declare function listTools(): ToolDefinition[];
+/** Calls a tool, preserving application errors as structured tool results. */
+export declare function callTool(context: ServerContext, name: unknown, args: unknown, principal: Principal, signal: AbortSignal): Promise<ToolResult>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/server/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/server/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,qCAAqC;AACrC,wBAAgB,SAAS,IAAI,cAAc,EAAE,CAO5C;AAED,8EAA8E;AAC9E,wBAAsB,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA8BnJ"}