@acquiredintelligence/attend 0.0.0-stage → 0.2.0

package/dist/server/tools.js

@@ -0,0 +1,55 @@
+import { EventsError, eventsError, occurrenceFor } from './events.js';
+import { pollEvents } from './poll.js';
+/** attend_wait and attend_window. */
+export function listTools() {
+    return [
+        { name: 'attend_wait', description: 'Wait for routed decisions or dead letters after your saved cursor, then persist the returned cursor.', inputSchema: {
+                type: 'object', additionalProperties: false, properties: { name: { type: 'string', default: 'attention.decision' }, arguments: { type: 'object' }, cursor: { type: ['string', 'null'] }, waitMs: { type: 'integer', minimum: 0, maximum: 30000, default: 30000 }, maxEvents: { type: 'integer', minimum: 1, maximum: 20, default: 20 } },
+            } },
+        { name: 'attend_window', description: 'Read the full event window for a decision you are allowed to see.', inputSchema: { type: 'object', additionalProperties: false, required: ['decisionId'], properties: { decisionId: { type: 'string' } } } },
+    ];
+}
+/** Calls a tool, preserving application errors as structured tool results. */
+export async function callTool(context, name, args, principal, signal) {
+    if (name !== 'attend_wait' && name !== 'attend_window')
+        throw eventsError('InvalidParams', 'Unknown tool', { field: 'name', reason: 'unknown tool' });
+    try {
+        const value = args === undefined ? {} : args;
+        if (typeof value !== 'object' || value === null || (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null))
+            throw eventsError('InvalidParams', 'Invalid arguments', { field: 'arguments', reason: 'must be an object' });
+        const values = value;
+        const allowed = name === 'attend_wait' ? ['name', 'arguments', 'cursor', 'maxEvents', 'waitMs'] : ['decisionId'];
+        for (const key of Object.keys(values))
+            if (!allowed.includes(key))
+                throw eventsError('InvalidParams', 'Unknown argument', { field: `arguments.${key}`, reason: 'unknown' });
+        let structuredContent;
+        if (name === 'attend_wait') {
+            const cap = (key, fallback, minimum) => {
+                const value = values[key];
+                if (value === undefined)
+                    return fallback;
+                if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < minimum)
+                    throw eventsError('InvalidParams', `Invalid ${key}`, { field: key, reason: `must be a safe integer >= ${minimum}` });
+                return Math.min(value, fallback);
+            };
+            const result = await pollEvents(context, { ...values, name: values.name ?? 'attention.decision', maxEvents: cap('maxEvents', 20, 1), waitMs: cap('waitMs', 30_000, 0) }, principal, signal);
+            structuredContent = { events: result.events.map((event) => ({ ...event })), cursor: result.cursor, truncated: result.truncated };
+        }
+        else {
+            if (typeof values.decisionId !== 'string')
+                throw eventsError('InvalidParams', 'Invalid decisionId', { field: 'decisionId', reason: 'required' });
+            const row = await context.log.find('decision', values.decisionId);
+            if (!row || !principal.scopes.some((grant) => row.scope.startsWith(grant)))
+                throw eventsError('NotFound', 'Decision not found', { kind: 'decision' });
+            const occurrence = occurrenceFor(row, 'events', context.options.payload?.maxEventsBytes);
+            structuredContent = { ...occurrence.data, ...(occurrence._meta?.['attend/eventsOmitted'] ? { eventsOmitted: true } : {}) };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(structuredContent) }], structuredContent };
+    }
+    catch (error) {
+        if (!(error instanceof EventsError))
+            throw error;
+        return { content: [{ type: 'text', text: error.message }], structuredContent: { error: { ...error.toJSON() } }, isError: true };
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/server/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/server/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAiBvC,qCAAqC;AACrC,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,sGAAsG,EAAE,WAAW,EAAE;gBACvJ,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE;aACzU,EAAE;QACH,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,mEAAmE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE;KACpP,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAsB,EAAE,IAAa,EAAE,IAAa,EAAE,SAAoB,EAAE,MAAmB;IAC5H,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,eAAe;QAAE,MAAM,WAAW,CAAC,eAAe,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IACtJ,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;YAAE,MAAM,WAAW,CAAC,eAAe,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC9P,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QACjH,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,MAAM,WAAW,CAAC,eAAe,EAAE,kBAAkB,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5K,IAAI,iBAA6B,CAAC;QAClC,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,QAAgB,EAAE,OAAe,EAAE,EAAE;gBAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO,QAAQ,CAAC;gBACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,OAAO;oBAAE,MAAM,WAAW,CAAC,eAAe,EAAE,WAAW,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,6BAA6B,OAAO,EAAE,EAAE,CAAC,CAAC;gBACvM,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACnC,CAAC,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,oBAAoB,EAAE,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YAC5L,iBAAiB,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACnI,CAAC;aAAM,CAAC;YACN,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;gBAAE,MAAM,WAAW,CAAC,eAAe,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACjJ,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;YAClE,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAAE,MAAM,WAAW,CAAC,UAAU,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YACtJ,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACzF,iBAAiB,GAAG,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAA2B,CAAC;QACtJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACrG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC;YAAE,MAAM,KAAK,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClI,CAAC;AACH,CAAC"}

package/dist/server/types.d.ts

@@ -0,0 +1,351 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ToolResult } from './tools.js';
+import type { Fanout } from './fanout.js';
+import type { DecisionLog, Position } from '../store/types.js';
+import type { DeliveredRoute, Entry, JsonObject, Route, SettleReason } from '../core/types.js';
+export declare const EVENTS_EXTENSION = "io.modelcontextprotocol/events";
+export declare const SUBSCRIPTION_ID_META = "io.modelcontextprotocol/subscriptionId";
+export declare const DECISION_EVENT = "attention.decision";
+export declare const DEAD_LETTER_EVENT = "attention.deadLetter";
+export type AttendEventName = typeof DECISION_EVENT | typeof DEAD_LETTER_EVENT;
+export type DeliveryMode = 'poll' | 'push';
+export interface EventDescriptor {
+    name: string;
+    description: string;
+    delivery: DeliveryMode[];
+    inputSchema: JsonObject;
+    payloadSchema: JsonObject;
+    _meta?: JsonObject;
+}
+/** Every result this extension defines carries `resultType: "complete"`. */
+export interface CompleteResult {
+    resultType: 'complete';
+}
+export interface ListEventsParams {
+    cursor?: string;
+}
+export interface ListEventsResult extends CompleteResult {
+    events: EventDescriptor[];
+    nextCursor?: string;
+}
+/** An absent `cursor` means null, in both directions. */
+export interface EventOccurrence<D extends object = JsonObject> {
+    eventId: string;
+    name: string;
+    timestamp: string;
+    data: D;
+    cursor?: string | null;
+    _meta?: JsonObject;
+}
+/** `attention.decision` arguments. The schema starts strict and only loosens. `scope` and `scopePrefix` are exclusive. */
+export interface DecisionArguments {
+    scope?: string;
+    scopePrefix?: string;
+    routes?: DeliveredRoute[];
+    minProbability?: number;
+    include?: 'notice' | 'events';
+}
+export interface DeadLetterArguments {
+    scope?: string;
+    scopePrefix?: string;
+    stage?: 'judge' | 'sink';
+}
+/** `attention.decision` data: triage fields only. The full window is behind `include: "events"` or the `attend_window` tool. */
+export interface AttentionDecisionData {
+    decisionId: string;
+    scope: string;
+    route: DeliveredRoute;
+    probabilities: Record<Route, number>;
+    predicates: Record<string, number>;
+    confidence: number | null;
+    reason: SettleReason;
+    settledAt: string;
+    decidedAt: string;
+    eventCount: number;
+    eventIds: string[];
+    dropped: number;
+    gap: boolean;
+    waits: number;
+    /** `defaultNotice(decision)`. */
+    notice: string;
+    /** With `include: "events"` only, capped at 1 MiB; past the cap it is omitted and `_meta["attend/eventsOmitted"]` is set. */
+    events?: Entry[];
+}
+export interface AttentionDeadLetterData {
+    letterId: string;
+    scope: string;
+    stage: 'judge' | 'sink';
+    message: string;
+    permanent: boolean;
+    attempts: number;
+    decisionId: string | null;
+    route: DeliveredRoute | null;
+    reason: SettleReason;
+    eventCount: number;
+    eventIds: string[];
+    at: string;
+}
+/** `waitMs` (a long poll) is accepted, not advertised. */
+export interface PollParams {
+    name: string;
+    arguments?: JsonObject;
+    cursor?: string | null;
+    maxAgeMs?: number;
+    maxEvents?: number;
+    waitMs?: number;
+}
+export interface PollResult extends CompleteResult {
+    events: EventOccurrence[];
+    cursor: string | null;
+    truncated: boolean;
+    hasMore: boolean;
+    nextPollMs: number;
+}
+export interface StreamParams {
+    name: string;
+    arguments?: JsonObject;
+    cursor?: string | null;
+    maxAgeMs?: number;
+}
+/** Carried on every `notifications/events/*` message: the parent `events/stream` request's JSON-RPC id. */
+export interface SubscriptionMeta {
+    'io.modelcontextprotocol/subscriptionId': string | number;
+}
+export interface EventsErrorObject {
+    code: number;
+    message: string;
+    data?: JsonObject;
+}
+/** `active` always comes first. Heartbeats come at least every 30 s. */
+export type StreamNotification = {
+    method: 'notifications/events/active';
+    params: {
+        cursor: string | null;
+        truncated: boolean;
+        _meta: SubscriptionMeta;
+    };
+} | {
+    method: 'notifications/events/event';
+    params: EventOccurrence & {
+        _meta: SubscriptionMeta & JsonObject;
+    };
+} | {
+    method: 'notifications/events/heartbeat';
+    params: {
+        cursor: string | null;
+        _meta: SubscriptionMeta;
+    };
+} | {
+    method: 'notifications/events/error';
+    params: {
+        error: EventsErrorObject;
+        _meta: SubscriptionMeta;
+    };
+} | {
+    method: 'notifications/events/terminated';
+    params: {
+        error: EventsErrorObject;
+        _meta: SubscriptionMeta;
+    };
+};
+/** The final frame, sent only when the server closes the stream. */
+export interface StreamEventsResult extends CompleteResult {
+    _meta: SubscriptionMeta;
+}
+/** `v1.<epoch>.<position>` cursors: opaque to clients, one sequence per store. */
+export interface CursorParts {
+    epoch: string;
+    position: Position;
+}
+/** Compiled subscription arguments. Matching is O(1) once the fan-out index has found the candidate. */
+export interface SubscriptionFilter {
+    name: AttendEventName;
+    scope?: string;
+    scopePrefix?: string;
+    routes: number;
+    minProbability: number;
+    stage?: 'judge' | 'sink';
+    include: 'notice' | 'events';
+    /** Granted prefixes a row's scope must start with one of: set when the principal holds several grants and the arguments name neither scope nor scopePrefix. */
+    grants?: readonly string[];
+}
+/** `scopes` are granted prefixes; `['']` grants every scope. */
+export interface Principal {
+    id: string;
+    scopes: readonly string[];
+}
+export type PrincipalResolver = (req: IncomingMessage) => Promise<Principal | null> | Principal | null;
+export interface EventsServerOptions {
+    name?: string;
+    version?: string;
+    /** stdio and InMemory transports use `localPrincipal`; HTTP uses `principal(req)`. */
+    principal?: PrincipalResolver;
+    localPrincipal?: Principal;
+    /** Default 15,000; a heartbeat must come at least every 30 s. */
+    heartbeatMs?: number;
+    /** Bytes of encoded frames one stream may buffer before it falls back to catch-up. Default 1 MiB. */
+    streamBufferBytes?: number;
+    /** A ResourceExhausted {limit: "streams"} quota per principal, not a concurrency cap. Default 256. */
+    maxStreamsPerPrincipal?: number;
+    poll?: {
+        defaultMaxEvents?: number;
+        maxEvents?: number;
+        nextPollMs?: number;
+    };
+    /** Registers `attend_wait` and `attend_window`. Default true. */
+    tools?: boolean;
+    payload?: {
+        maxEventsBytes?: number;
+    };
+}
+/** A JSON-RPC request as the MCP SDK hands it to `fallbackRequestHandler`. */
+export interface McpRequestLike {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: {
+        [key: string]: unknown;
+    };
+}
+/** The slice of the MCP SDK 2.x request context the handlers use. */
+export interface McpRequestContextLike {
+    mcpReq: {
+        id: string | number;
+        signal: AbortSignal;
+        notify(notification: {
+            method: string;
+            params?: {
+                [key: string]: unknown;
+            };
+        }): Promise<void>;
+    };
+}
+/** The slice of an MCP SDK 2.x `Server` that `install` uses: capability registration before connect, and one zod-free fallback handler. */
+export interface McpServerLike {
+    /** Registers a typed handler; `install` composes the app's `tools/list` and `tools/call` handlers with attend's tools through it. */
+    setRequestHandler(method: string, ...args: unknown[]): void;
+    registerCapabilities(capabilities: {
+        extensions?: Record<string, JsonObject>;
+        tools?: JsonObject;
+    }): void;
+    fallbackRequestHandler?(request: McpRequestLike, ctx: McpRequestContextLike): Promise<{
+        [key: string]: unknown;
+    }>;
+}
+/** A tool `inputSchema` as an MCP SDK 2.x `McpServer` takes it: a Standard Schema that also carries its JSON Schema. */
+export interface McpToolSchemaLike {
+    readonly '~standard': {
+        readonly version: 1;
+        readonly vendor: string;
+        validate(value: unknown): {
+            value: unknown;
+        };
+        readonly jsonSchema: {
+            input(options: unknown): JsonObject;
+            output(options: unknown): JsonObject;
+        };
+    };
+}
+/** The slice of an MCP SDK 2.x `McpServer` that `install` uses: its tool registry, and its low-level `server` for events/*. */
+export interface McpToolServerLike {
+    readonly server: McpServerLike;
+    registerTool(name: string, config: {
+        description: string;
+        inputSchema: McpToolSchemaLike;
+    }, callback: (args: unknown, ctx: McpRequestContextLike) => Promise<ToolResult>): unknown;
+}
+export type HttpRoute = (req: IncomingMessage, res: ServerResponse) => void | Promise<void>;
+export interface HttpHandlerOptions {
+    /** Default '/mcp'. */
+    path?: string;
+    /** Extra routes on the same port, such as 'POST /v1/ingest'. */
+    routes?: Record<string, HttpRoute>;
+    /** Defaults: 10,000 sessions, 1,800,000 ms idle. */
+    sessions?: {
+        max?: number;
+        idleMs?: number;
+    };
+    /** Builds the SDK Server or McpServer for a new session, for an app that wants its own tools on the same endpoint. `install` is applied to it. */
+    newServer?: () => (McpServerLike | McpToolServerLike) & {
+        connect(transport: unknown): Promise<void>;
+    };
+}
+export interface EventsServer {
+    readonly descriptors: readonly EventDescriptor[];
+    /** For `server/discover` and `initialize`. */
+    capabilities(): {
+        extensions: Record<string, JsonObject>;
+    };
+    /** Pass an McpServer to register attend's tools beside the app's; on a low-level Server, attend serves tools from its fallback and composes with tools/list and tools/call handlers set before or after install. Call before connect, after the app sets its own fallbackRequestHandler. */
+    install(server: McpServerLike | McpToolServerLike, options?: {
+        principal?: Principal;
+    }): void;
+    /**
+     * The Streamable HTTP endpoint. `events/stream` is served by attend's own SSE writer: drain on
+     * write() === false, abort on 'close', a setImmediate yield every 64 frames, catch-up instead of
+     * drop. A guard first checks session, MCP-Protocol-Version, Mcp-Method, Accept and the principal.
+     * Every other method goes to the SDK transport.
+     */
+    http(options: HttpHandlerOptions): HttpRoute;
+    close(): Promise<void>;
+}
+/** Server-internal: what every events/* handler reads, built once by `eventsServer`. */
+export interface ServerContext {
+    readonly log: DecisionLog;
+    /** The log's epoch, read on first use and kept: it never changes for a store. */
+    epoch(): Promise<string>;
+    readonly options: EventsServerOptions;
+    readonly descriptors: readonly EventDescriptor[];
+    /** Aborts when `EventsServer.close()` runs: long polls answer at once, and P9's streams end with their final frame. */
+    readonly signal: AbortSignal;
+    /** The process's shared tail cache and fan-out index (design §6.9), built by `createFanout(log)` on first read of this property and closed by `EventsServer.close()`. Phase P9 implements it; poll and the tools never read it. */
+    readonly fanout: Fanout;
+}
+/** NDJSON lines. */
+export type IngestLine = {
+    scope: string;
+    id: string;
+    at: number;
+    name: string;
+    data: JsonObject;
+    text?: string;
+} | {
+    scope: string;
+    flush: true;
+} | {
+    scope: string;
+    end: true;
+};
+export interface IngestResult {
+    accepted: number;
+    duplicates: number;
+    rejected: {
+        line: number;
+        scope: string | null;
+        error: 'invalid' | 'outbox_full' | 'backpressure' | 'too_large' | 'forbidden' | 'conflict' | 'internal';
+    }[];
+}
+export interface NdjsonIngestOptions {
+    /** True: a long-lived NDJSON body, answered with {ack, through} and {credit} lines. False: one request, one IngestResult. */
+    stream?: boolean;
+    maxBodyBytes?: number;
+    maxLineBytes?: number;
+    /** Lines are accepted only for scopes inside the principal's grants. */
+    principal?: PrincipalResolver;
+    /** Default 64 lines parsed per macrotask. */
+    slice?: number;
+}
+export interface ServeOptions {
+    listen: {
+        port: number;
+        host?: string;
+    } | {
+        path: string;
+    };
+    principal?: PrincipalResolver;
+    events?: Omit<EventsServerOptions, 'principal'>;
+    ingest?: {
+        stream?: boolean;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE/F,eAAO,MAAM,gBAAgB,mCAAmC,CAAC;AACjE,eAAO,MAAM,oBAAoB,2CAA2C,CAAC;AAC7E,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,OAAO,cAAc,GAAG,OAAO,iBAAiB,CAAC;AAC/E,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,WAAW,EAAE,UAAU,CAAC;IACxB,aAAa,EAAE,UAAU,CAAC;IAC1B,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,UAAU;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,0HAA0H;AAC1H,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED,gIAAgI;AAChI,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,6HAA6H;IAC7H,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,2GAA2G;AAC3G,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3D;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,6BAA6B,CAAC;IAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,gBAAgB,CAAA;KAAE,CAAA;CAAE,GACzH;IAAE,MAAM,EAAE,4BAA4B,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG;QAAE,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAAA;KAAE,CAAA;CAAE,GAC5G;IAAE,MAAM,EAAE,gCAAgC,CAAC;IAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,gBAAgB,CAAA;KAAE,CAAA;CAAE,GACxG;IAAE,MAAM,EAAE,4BAA4B,CAAC;IAAC,MAAM,EAAE;QAAE,KAAK,EAAE,iBAAiB,CAAC;QAAC,KAAK,EAAE,gBAAgB,CAAA;KAAE,CAAA;CAAE,GACvG;IAAE,MAAM,EAAE,iCAAiC,CAAC;IAAC,MAAM,EAAE;QAAE,KAAK,EAAE,iBAAiB,CAAC;QAAC,KAAK,EAAE,gBAAgB,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjH,oEAAoE;AACpE,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,wGAAwG;AACxG,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,+JAA+J;IAC/J,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,gEAAgE;AAChE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;AAEvG,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sGAAsG;IACtG,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,IAAI,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACrC;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,MAAM,EAAE,WAAW,CAAC;QACpB,MAAM,CAAC,YAAY,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE;gBAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;aAAE,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC9F,CAAC;CACH;AAED,2IAA2I;AAC3I,MAAM,WAAW,aAAa;IAC5B,qIAAqI;IACrI,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5D,oBAAoB,CAAC,YAAY,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1G,sBAAsB,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;CACnH;AAED,wHAAwH;AACxH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG;YAAE,KAAK,EAAE,OAAO,CAAA;SAAE,CAAC;QAC7C,QAAQ,CAAC,UAAU,EAAE;YAAE,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC;YAAC,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAA;SAAE,CAAC;KACpG,CAAC;CACH;AAED,+HAA+H;AAC/H,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,iBAAiB,CAAA;KAAE,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;CACpL;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5F,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,kJAAkJ;IAClJ,SAAS,CAAC,EAAE,MAAM,CAAC,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAAE,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CACxG;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;IACjD,8CAA8C;IAC9C,YAAY,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;KAAE,CAAC;IAC3D,4RAA4R;IAC5R,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9F;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,iFAAiF;IACjF,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;IACjD,uHAAuH;IACvH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,mOAAmO;IACnO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,oBAAoB;AACpB,MAAM,MAAM,UAAU,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACxF;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAC9B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,SAAS,GAAG,aAAa,GAAG,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAA;KAAE,EAAE,CAAC;CAC7J;AAED,MAAM,WAAW,mBAAmB;IAClC,6HAA6H;IAC7H,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,MAAM,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/B"}

package/dist/server/types.js

@@ -0,0 +1,5 @@
+export const EVENTS_EXTENSION = 'io.modelcontextprotocol/events';
+export const SUBSCRIPTION_ID_META = 'io.modelcontextprotocol/subscriptionId';
+export const DECISION_EVENT = 'attention.decision';
+export const DEAD_LETTER_EVENT = 'attention.deadLetter';
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,gBAAgB,GAAG,gCAAgC,CAAC;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,wCAAwC,CAAC;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,sBAAsB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `attend/server`: MCP Events over a store's decision log, with polling, streaming and
+ * Streamable HTTP, plus NDJSON ingestion and a combined server. A read-only process can
+ * serve decisions without running a judge.
+ */
+export { eventsServer } from './server/install.js';
+export { ndjsonIngest } from './server/ingest.js';
+export { serve } from './server/serve.js';
+export { DEAD_LETTER_EVENT, DECISION_EVENT, EVENTS_EXTENSION } from './server/types.js';
+export type { AttentionDeadLetterData, AttentionDecisionData, DeadLetterArguments, DecisionArguments, EventOccurrence, EventsServer, EventsServerOptions, HttpHandlerOptions, HttpRoute, IngestLine, IngestResult, NdjsonIngestOptions, Principal, PrincipalResolver, ServeOptions } from './server/types.js';
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxF,YAAY,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/server.js

@@ -0,0 +1,10 @@
+/**
+ * `attend/server`: MCP Events over a store's decision log, with polling, streaming and
+ * Streamable HTTP, plus NDJSON ingestion and a combined server. A read-only process can
+ * serve decisions without running a judge.
+ */
+export { eventsServer } from './server/install.js';
+export { ndjsonIngest } from './server/ingest.js';
+export { serve } from './server/serve.js';
+export { DEAD_LETTER_EVENT, DECISION_EVENT, EVENTS_EXTENSION } from './server/types.js';
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/shell/budget.d.ts

@@ -0,0 +1,4 @@
+import type { JudgeBudget } from '../core/types.js';
+/** (contextTokens − reservedTokens) × windowShare × bytesPerToken. */
+export declare function windowBytesFor(budget: JudgeBudget, windowShare: number): number;
+//# sourceMappingURL=budget.d.ts.map

package/dist/shell/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/shell/budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/E"}

package/dist/shell/budget.js

@@ -0,0 +1,5 @@
+/** (contextTokens − reservedTokens) × windowShare × bytesPerToken. */
+export function windowBytesFor(budget, windowShare) {
+    return Math.floor((budget.contextTokens - (budget.reservedTokens ?? 0)) * windowShare * (budget.bytesPerToken ?? 4));
+}
+//# sourceMappingURL=budget.js.map

package/dist/shell/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/shell/budget.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAE,WAAmB;IACrE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,GAAG,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC;AACvH,CAAC"}

package/dist/shell/copy.d.ts

@@ -0,0 +1,20 @@
+import type { DeadLetter, Decision, Event, Window } from '../core/types.js';
+/** Copies and validates an event at the JSON boundary, and measures its rendered bytes. */
+export declare function copyEventSized(event: Event, fill?: {
+    id(): string;
+    at(): number;
+}): {
+    event: Event;
+    bytes: number;
+};
+/** Waits for active window copies when advancing a deterministic test clock. */
+export declare function drainCopies(): Promise<void>;
+/** Copies one slice synchronously and yields between any remaining slices. */
+export declare function copyWindowSliced(window: Window, slice?: number): Window | Promise<Window>;
+/** Copies a decision and slices the copy of its window. */
+export declare function copyDecision(decision: Decision): Decision | Promise<Decision>;
+/** Copies a dead letter and both windows it may contain. */
+export declare function copyLetter(letter: DeadLetter): DeadLetter | Promise<DeadLetter>;
+/** Estimates JSON bytes without serializing the record on the memory-store path. */
+export declare function recordBytes(value: unknown): number;
+//# sourceMappingURL=copy.d.ts.map

package/dist/shell/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/shell/copy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI5E,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE;IAAE,EAAE,IAAI,MAAM,CAAC;IAAC,EAAE,IAAI,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAUnH;AAID,gFAAgF;AAChF,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBrF;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAI7E;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAO/E;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOlD"}

package/dist/shell/copy.js

@@ -0,0 +1,73 @@
+import { copyEvent } from '../internal/shared.js';
+import { estimateRenderedBytes } from '../core/window.js';
+/** Copies and validates an event at the JSON boundary, and measures its rendered bytes. */
+export function copyEventSized(event, fill) {
+    const copied = copyEvent(event, fill !== undefined);
+    if (fill) {
+        if (copied.id === undefined)
+            copied.id = fill.id();
+        if (copied.at === undefined)
+            copied.at = fill.at();
+    }
+    if (typeof copied.id !== 'string' || typeof copied.name !== 'string' || (copied.text !== undefined && typeof copied.text !== 'string')) {
+        throw new TypeError('attend: event id, name and text must be strings');
+    }
+    return { event: copied, bytes: estimateRenderedBytes(copied) };
+}
+const copying = new Set();
+/** Waits for active window copies when advancing a deterministic test clock. */
+export async function drainCopies() {
+    while (copying.size > 0)
+        await Promise.all(copying);
+}
+/** Copies one slice synchronously and yields between any remaining slices. */
+export function copyWindowSliced(window, slice = 64) {
+    if (!Number.isSafeInteger(slice) || slice < 1)
+        throw new RangeError('attend: slice must be a positive integer');
+    const events = [];
+    let i = 0;
+    function copySlice() {
+        const end = Math.min(i + slice, window.events.length);
+        for (; i < end; i += 1)
+            events.push(structuredClone(window.events[i]));
+        if (i < window.events.length)
+            return new Promise((resolve) => setImmediate(resolve)).then(copySlice);
+        return { ...window, events };
+    }
+    const result = copySlice();
+    if (result instanceof Promise) {
+        copying.add(result);
+        void result.then(() => copying.delete(result), () => copying.delete(result));
+    }
+    return result;
+}
+/** Copies a decision and slices the copy of its window. */
+export function copyDecision(decision) {
+    const copy = { ...decision, probabilities: { ...decision.probabilities }, predicates: { ...decision.predicates } };
+    const window = copyWindowSliced(decision.window);
+    return window instanceof Promise ? window.then((window) => ({ ...copy, window })) : { ...copy, window };
+}
+/** Copies a dead letter and both windows it may contain. */
+export function copyLetter(letter) {
+    const window = copyWindowSliced(letter.window);
+    const decision = letter.decision === null ? null : copyDecision(letter.decision);
+    if (window instanceof Promise || decision instanceof Promise) {
+        return Promise.all([window, decision]).then(([window, decision]) => ({ ...letter, window, decision }));
+    }
+    return { ...letter, window, decision };
+}
+/** Estimates JSON bytes without serializing the record on the memory-store path. */
+export function recordBytes(value) {
+    if (value === null)
+        return 4;
+    if (typeof value === 'string')
+        return Buffer.byteLength(value) + 2;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value).length;
+    if (Array.isArray(value))
+        return 2 + value.reduce((sum, item) => sum + recordBytes(item) + 1, 0);
+    if (typeof value === 'object')
+        return 2 + Object.entries(value).reduce((sum, [key, item]) => sum + Buffer.byteLength(key) + 4 + recordBytes(item), 0);
+    return 0;
+}
+//# sourceMappingURL=copy.js.map

package/dist/shell/copy.js.map

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

package/dist/shell/decisions.d.ts

@@ -0,0 +1,6 @@
+import type { Clock } from '../core/types.js';
+import type { DecisionLog } from '../store/types.js';
+import type { DecisionCursorPage, DecisionFilter, DecisionReadOptions } from './types.js';
+/** Streams copied decision rows, paging immediately while the log has more to scan. */
+export declare function readDecisions(log: DecisionLog, clock: Clock, filter: DecisionFilter, options: DecisionReadOptions): AsyncIterable<DecisionCursorPage>;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/shell/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/shell/decisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAY1F,uFAAuF;AACvF,wBAAuB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAAC,kBAAkB,CAAC,CA0B5J"}