@amalgm/chat 0.1.1 → 0.2.0

package/dist/events/tool-shape.js

@@ -1,225 +0,0 @@
-/**
- * Internal port of engine `chat-core/tool-shape.js` (173 lines): tool
- * identity — kind classification, human titles, and MCP name parsing
- * (`mcp__<server>__<tool>`, `amalgm_<tool>`), ported byte-exact.
- *
- * NOTE (dedupe): the canonical public home for tool identity is the
- * transcript module (`src/transcript/`, per ROADMAP). This copy exists so
- * `src/events` + `src/wire` build stand-alone; unify when the transcript
- * port lands. Not re-exported from the events barrel.
- */
-import { compactText, isRecord, stringifyResult } from './tool-display.js';
-/** Engine tool-shape.js:9-17. Hostname without `www.`; unparseable URLs compact to 80 chars. */
-export function hostLabel(url) {
-    if (url === undefined || url === null || url === '')
-        return '';
-    try {
-        const host = new URL(String(url)).hostname.replace(/^www\./, '');
-        return host || String(url);
-    }
-    catch {
-        return compactText(url, 80);
-    }
-}
-/** Engine tool-shape.js:19-28. */
-export function humanizeToolName(value = '') {
-    const text = String(value || '')
-        .replace(/^mcp__/, '')
-        .replace(/^amalgm[_-]/i, '')
-        .replace(/__/g, ' ')
-        .replace(/[_-]+/g, ' ')
-        .trim();
-    if (!text)
-        return 'Tool';
-    return text.charAt(0).toUpperCase() + text.slice(1);
-}
-/** Engine tool-shape.js:30-37. `mcp__<server>__<tool>` or `amalgm_<tool>`; null otherwise. */
-export function parseMcpName(name = '') {
-    const text = String(name || '');
-    const mcp = text.match(/^mcp__([^_]+(?:_[^_]+)*)__([\s\S]+)$/);
-    if (mcp)
-        return { server: mcp[1], tool: mcp[2] };
-    const amalgm = text.match(/^amalgm_(.+)$/);
-    if (amalgm)
-        return { server: 'amalgm', tool: amalgm[1] };
-    return null;
-}
-/** Engine tool-shape.js:39-51. Falsy errors normalize to undefined; records keep themselves as `details`. */
-export function normalizeError(error, fallback = 'Tool failed') {
-    if (!error)
-        return undefined;
-    if (typeof error === 'string')
-        return { message: error };
-    if (isRecord(error)) {
-        const message = error['message'] || error['error'] || error['details'] || fallback;
-        return {
-            message: typeof message === 'string' ? message : stringifyResult(message),
-            ...(error['code'] ? { code: String(error['code']) } : {}),
-            details: error,
-        };
-    }
-    return { message: String(error) || fallback };
-}
-/** Engine tool-shape.js:53-76. Canonical kind classifier (name, then MCP, then input-shape heuristics). */
-export function toolKind(name = '', input = {}, metadata = {}) {
-    const clean = String(name || '').toLowerCase();
-    const compact = clean.replace(/[^a-z0-9]/g, '');
-    const mcp = metadata['mcp'] || parseMcpName(name);
-    if (metadata['subagent'] || clean === 'task' || clean.includes('spawnagent') || clean.includes('collabagent'))
-        return 'subagent';
-    if (clean.includes('todo'))
-        return 'todo';
-    if (clean.includes('question') || clean.includes('askuser'))
-        return 'question';
-    if (compact.includes('toolsearch'))
-        return 'search';
-    if (clean.includes('bash') || clean.includes('command'))
-        return 'bash';
-    if (clean.includes('websearch') || clean === 'websearch')
-        return 'web_search';
-    if (clean.includes('browser') || mcp?.tool?.startsWith?.('browser_'))
-        return 'browser';
-    if (clean.includes('webfetch') || clean === 'webfetch')
-        return 'browser';
-    if (clean.includes('read'))
-        return 'file_read';
-    if (clean.includes('write'))
-        return 'file_write';
-    if (clean.includes('edit') || clean.includes('filechange'))
-        return 'file_edit';
-    if (mcp)
-        return 'mcp';
-    if (input && typeof input === 'object') {
-        const record = input;
-        if (record['command'] !== undefined)
-            return 'bash';
-        if (record['url'] !== undefined)
-            return 'browser';
-        if (record['query'] !== undefined)
-            return 'web_search';
-        if (record['file_path'] !== undefined || record['filePath'] !== undefined || record['path'] !== undefined)
-            return 'file_read';
-    }
-    return 'unknown';
-}
-/**
- * Engine tool-shape.js:78-88. Browser action out of a tool name, across
- * naming eras: current toolbox__browser_open, era-2
- * toolbox__browser_browser_open / browser_open, and bare
- * record_start/cua_click. Null for non-browser tools.
- */
-function browserAction(name) {
-    const match = String(name || '').match(/^(?:toolbox__browser_|browser_)(.+)$/);
-    if (match)
-        return match[1].replace(/^browser_/, '');
-    if (/^(?:record_(?:start|stop|list)|cua(?:_[a-z_]+)?)$/.test(String(name)))
-        return name;
-    return null;
-}
-/** Engine tool-shape.js:90-123. */
-function titleFromMcp(tool, input = {}) {
-    const name = String(tool || '');
-    const action = browserAction(name);
-    if (action === 'open')
-        return input['url'] ? `Opening ${hostLabel(input['url'])}` : 'Opening browser page';
-    if (action === 'snapshot')
-        return 'Reading browser page';
-    if (action === 'screenshot' || action === 'cua_screenshot')
-        return 'Taking browser screenshot';
-    if (action === 'fill')
-        return input['text'] ? `Typing "${compactText(input['text'], 60)}"` : 'Typing in browser';
-    if (action === 'click')
-        return 'Clicking in browser';
-    if (action === 'press')
-        return input['key'] ? `Pressing ${compactText(input['key'], 20)}` : 'Pressing key in browser';
-    if (action === 'eval')
-        return 'Running JavaScript in browser';
-    if (action === 'wait')
-        return 'Waiting for page';
-    if (action === 'cli')
-        return Array.isArray(input['args']) ? `Browser: ${compactText(input['args'].join(' '), 60)}` : 'Running browser command';
-    if (action === 'cua') {
-        const cuaAction = String(input['action'] || '');
-        if (cuaAction === 'screenshot')
-            return 'Taking browser screenshot';
-        if (cuaAction === 'type')
-            return input['text'] ? `Typing "${compactText(input['text'], 60)}"` : 'Typing in browser';
-        return cuaAction ? `Browser ${cuaAction.replace(/_/g, ' ')} (coordinates)` : 'Browser computer-use action';
-    }
-    if (action === 'dialog')
-        return input['action'] === 'dismiss' ? 'Dismissing browser dialog' : 'Accepting browser dialog';
-    if (action === 'tab')
-        return `Browser tab ${compactText(String(input['action'] || 'list'), 20)}`;
-    if (action === 'console')
-        return 'Reading browser console';
-    if (action === 'close')
-        return 'Closing browser session';
-    if (action === 'record_start')
-        return 'Starting browser recording';
-    if (action === 'record_stop')
-        return 'Saving browser recording';
-    if (action === 'record_list')
-        return 'Listing browser recordings';
-    if (action === 'auth_list')
-        return 'Listing browser logins';
-    if (name === 'apps_register')
-        return input['cwd'] ? `Registering app from ${compactText(input['cwd'], 60)}` : 'Registering app';
-    if (name === 'apps_start')
-        return 'Starting app';
-    if (name === 'apps_stop')
-        return 'Stopping app';
-    if (name === 'apps_list')
-        return 'Listing apps';
-    if (name === 'agents_list')
-        return 'Listing agents';
-    if (name === 'talk_to_agent')
-        return 'Talking to agent';
-    return humanizeToolName(action || name);
-}
-/** Engine tool-shape.js:125-157. Descriptor > metadata title > MCP title > per-tool heuristics > fallback. */
-export function titleForTool({ name, input = {}, error, metadata = {}, fallback } = {}) {
-    if (metadata['actionDescriptor'])
-        return compactText(metadata['actionDescriptor'], 160);
-    if (metadata['title'])
-        return compactText(metadata['title'], 160);
-    const mcp = metadata['mcp'] || parseMcpName(name);
-    if (mcp)
-        return titleFromMcp(mcp.tool, input);
-    const clean = String(name || '').toLowerCase();
-    const compact = clean.replace(/[^a-z0-9]/g, '');
-    const action = metadata['action'];
-    if (action?.['type'] === 'search') {
-        return `Searching ${compactText(action['query'] || input['query'] || 'the web', 80)}`;
-    }
-    if (action?.['type'] === 'openPage') {
-        const host = hostLabel(action['url'] || input['url'] || input['query']);
-        return host ? `Opening ${host}` : 'Opening web page';
-    }
-    if (action?.['type'] === 'findInPage') {
-        const pattern = action['pattern'] || input['pattern'];
-        const url = action['url'] || input['url'];
-        const host = hostLabel(url) || 'current page';
-        return pattern ? `Finding "${compactText(pattern, 60)}" on ${host}` : `Finding text on ${host}`;
-    }
-    if (compact.includes('toolsearch')) {
-        const selected = String(input['query'] || '').replace(/^select:/i, '').trim();
-        return selected ? `Selecting ${compactText(selected, 80)}` : 'Selecting tool';
-    }
-    if (clean.includes('websearch'))
-        return input['query'] ? `Searching ${compactText(input['query'], 80)}` : 'Searching the web';
-    if (clean.includes('webfetch'))
-        return input['url'] ? `Opening ${hostLabel(input['url'])}` : 'Opening web page';
-    if (clean === 'bash' || clean.includes('command'))
-        return input['command'] ? `$ ${compactText(input['command'], 120)}` : 'Running command';
-    if (clean === 'task' || metadata['subagent'])
-        return compactText(input['description'] || metadata['description'] || fallback || 'Running subagent', 120);
-    if (error)
-        return normalizeError(error)?.message || 'Tool failed';
-    return compactText(fallback || humanizeToolName(name), 120);
-}
-/** Engine tool-shape.js:159-162. */
-export function mcpMetadataFromName(name) {
-    const mcp = parseMcpName(name);
-    return mcp ? { mcp } : {};
-}
-//# sourceMappingURL=tool-shape.js.map

package/dist/events/tool-shape.js.map

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

package/dist/turns/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * @amalgm/chat — turns module barrel. The turn machine's pure laws:
- * the TurnStore tempstore (stores.js), the status vocabulary, the replay
- * grammar (streams.js), and the /active + /runtime-idle query shapes
- * (engine.js:101-118).
- */
-export { TURN_STATUSES, IDLE_STATUS, ACTIVE_STATUSES, STOP_REASONS, isActiveStatus, isTerminalStatus, type TurnStatus, type QueryStatus, type ActiveStatus, type StopReason, } from './status.js';
-export { TurnStore, addChunkOrThrow, RAW_STREAM_WRITE_FAILED_MESSAGE, type TurnChunk, type TurnEntry, type StartTurnInput, type ChunkFrame, type AddChunkOptions, type TurnListener, } from './turn-store.js';
-export { HEARTBEAT_INTERVAL_MS, KEEP_ALIVE_FRAME, SSE_HEADERS, CHAT_STREAM_FALLBACK_ERROR, jsonSse, namedSse, normalizeAfterIndex, parseAfterIndexParam, findTurn, createTurnTail, createRawTempTail, chatErrorWrites, type ReplayFormat, type TailOutput, type TurnTail, type TurnTailOptions, } from './replay.js';
-export { activeQuery, idleStatusQuery, type ActiveQueryResult, type IdleStatusResult, } from './queries.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/turns/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,eAAe,EACf,+BAA+B,EAC/B,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,0BAA0B,EAC1B,OAAO,EACP,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC"}

package/dist/turns/index.js

@@ -1,11 +0,0 @@
-/**
- * @amalgm/chat — turns module barrel. The turn machine's pure laws:
- * the TurnStore tempstore (stores.js), the status vocabulary, the replay
- * grammar (streams.js), and the /active + /runtime-idle query shapes
- * (engine.js:101-118).
- */
-export { TURN_STATUSES, IDLE_STATUS, ACTIVE_STATUSES, STOP_REASONS, isActiveStatus, isTerminalStatus, } from './status.js';
-export { TurnStore, addChunkOrThrow, RAW_STREAM_WRITE_FAILED_MESSAGE, } from './turn-store.js';
-export { HEARTBEAT_INTERVAL_MS, KEEP_ALIVE_FRAME, SSE_HEADERS, CHAT_STREAM_FALLBACK_ERROR, jsonSse, namedSse, normalizeAfterIndex, parseAfterIndexParam, findTurn, createTurnTail, createRawTempTail, chatErrorWrites, } from './replay.js';
-export { activeQuery, idleStatusQuery, } from './queries.js';
-//# sourceMappingURL=index.js.map

package/dist/turns/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/turns/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,GAKjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,eAAe,EACf,+BAA+B,GAOhC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,0BAA0B,EAC1B,OAAO,EACP,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,eAAe,GAKhB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,eAAe,GAGhB,MAAM,cAAc,CAAC"}

package/dist/turns/queries.d.ts

@@ -1,36 +0,0 @@
-/**
- * Turn query response shapes — engine `chat-core/engine.js:101-118`, the
- * pure builders behind `GET /active` and `GET /runtime-idle`
- * (server.js:101,45). They read only a TurnStore; the host serializes.
- */
-import type { TurnStore } from './turn-store.js';
-import { type QueryStatus } from './status.js';
-/** `GET /active` response body (engine.js:101-109). */
-export interface ActiveQueryResult {
-    active: boolean;
-    codeSessionId: string;
-    assistantMessageId: string | null;
-    status: QueryStatus;
-}
-/**
- * `ChatCore.active()` (engine.js:101-109): the session's active entry, with
- * the active flag re-checked against the status predicate (a `cancelling`
- * turn is still active) and `'idle'` synthesized when nothing is stored.
- * Falsy assistantMessageId coerces to null via `||`, as the engine does.
- */
-export declare function activeQuery(store: TurnStore, sessionId: string): ActiveQueryResult;
-/** `GET /runtime-idle` response body (engine.js:111-118). */
-export interface IdleStatusResult {
-    idle: boolean;
-    active_turns: number;
-    tempstore_count: number;
-}
-/**
- * `ChatCore.idleStatus()` (engine.js:111-118): idle iff no turn holds a
- * tempstore slot; both counters report the same activeCount. The engine's
- * `typeof this.turns.activeCount === 'function'` guard is dropped — the
- * store is typed here, so activeCount always exists (engineParity: true,
- * guard unreachable).
- */
-export declare function idleStatusQuery(store: TurnStore): IdleStatusResult;
-//# sourceMappingURL=queries.d.ts.map

package/dist/turns/queries.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/turns/queries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAe,KAAK,WAAW,EAAkB,MAAM,aAAa,CAAC;AAE5E,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAQlF;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,CAOlE"}

package/dist/turns/queries.js

@@ -1,37 +0,0 @@
-/**
- * Turn query response shapes — engine `chat-core/engine.js:101-118`, the
- * pure builders behind `GET /active` and `GET /runtime-idle`
- * (server.js:101,45). They read only a TurnStore; the host serializes.
- */
-import { IDLE_STATUS, isActiveStatus } from './status.js';
-/**
- * `ChatCore.active()` (engine.js:101-109): the session's active entry, with
- * the active flag re-checked against the status predicate (a `cancelling`
- * turn is still active) and `'idle'` synthesized when nothing is stored.
- * Falsy assistantMessageId coerces to null via `||`, as the engine does.
- */
-export function activeQuery(store, sessionId) {
-    const entry = store.active(sessionId);
-    return {
-        active: !!entry && isActiveStatus(entry.status),
-        codeSessionId: sessionId,
-        assistantMessageId: entry?.assistantMessageId || null,
-        status: entry?.status || IDLE_STATUS,
-    };
-}
-/**
- * `ChatCore.idleStatus()` (engine.js:111-118): idle iff no turn holds a
- * tempstore slot; both counters report the same activeCount. The engine's
- * `typeof this.turns.activeCount === 'function'` guard is dropped — the
- * store is typed here, so activeCount always exists (engineParity: true,
- * guard unreachable).
- */
-export function idleStatusQuery(store) {
-    const tempstoreCount = store.activeCount();
-    return {
-        idle: tempstoreCount === 0,
-        active_turns: tempstoreCount,
-        tempstore_count: tempstoreCount,
-    };
-}
-//# sourceMappingURL=queries.js.map

package/dist/turns/queries.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../src/turns/queries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAoB,cAAc,EAAE,MAAM,aAAa,CAAC;AAU5E;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,SAAiB;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC;QAC/C,aAAa,EAAE,SAAS;QACxB,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,IAAI,IAAI;QACrD,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,WAAW;KACrC,CAAC;AACJ,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,cAAc,KAAK,CAAC;QAC1B,YAAY,EAAE,cAAc;QAC5B,eAAe,EAAE,cAAc;KAChC,CAAC;AACJ,CAAC"}

package/dist/turns/replay.d.ts

@@ -1,105 +0,0 @@
-/**
- * The replay grammar — engine `chat-core/streams.js` (160 lines), with the
- * host I/O peeled off. streams.js mixes SSE response plumbing (headers,
- * heartbeat timers, `res.write`) with the replay LAW: which payloads a tail
- * emits, in what order, and when the stream closes. This module is the law
- * as pure functions; the host owns the socket, the timer, and the actual
- * subscription wiring.
- *
- * Host contract (mirrors streams.js:97-117):
- *   1. `createTurnTail(entry, options)` — apply `tail.initial` writes; if
- *      `initial.end`, close.
- *   2. `store.subscribe(entry.turnId, (chunk, current) => ...)` — feed each
- *      emission through `tail.next(chunk, current)`; write its writes; close
- *      on `end`. (Subscribe before applying `initial` to match the engine;
- *      the cursor guard makes duplicate delivery harmless.)
- *   3. Every `HEARTBEAT_INTERVAL_MS`, write `KEEP_ALIVE_FRAME` while open.
- */
-import type { TurnChunk, TurnEntry, TurnStore } from './turn-store.js';
-/** Heartbeat cadence (streams.js:5). */
-export declare const HEARTBEAT_INTERVAL_MS = 15000;
-/** The comment frame the heartbeat writes (streams.js:31), byte-exact. */
-export declare const KEEP_ALIVE_FRAME = ": keep-alive\n\n";
-/**
- * The SSE response headers the host must send before any tail write
- * (sse.js:198-204). Documented contract — writing them is host work.
- */
-export declare const SSE_HEADERS: {
-    readonly 'Content-Type': "text/event-stream";
-    readonly 'Cache-Control': "no-cache, no-transform";
-    readonly Connection: "keep-alive";
-};
-/**
- * The two tail formats (streams.js:63):
- * - `frame`    — `/chat` live tail: chunk `data` bytes written verbatim.
- * - `raw-temp` — `/raw-temp` replay: named SSE events
- *   `existing` {chunks, total} → `chunk` {chunk, total} → `complete` {total}.
- */
-export type ReplayFormat = 'frame' | 'raw-temp';
-/** Anonymous SSE data frame (streams.js:7-9). */
-export declare function jsonSse(data: unknown): string;
-/** Named SSE event frame (streams.js:11-13). */
-export declare function namedSse(event: string, data: unknown): string;
-/** Cursor normalization (streams.js:58-60): any non-finite value → -1. */
-export declare function normalizeAfterIndex(afterIndex: unknown): number;
-/**
- * Route-layer cursor parse (server.js:43):
- * `Number(searchParams.get('afterIndex') ?? -1)`. A missing param is -1; a
- * garbage param becomes NaN, which {@link normalizeAfterIndex} folds to -1
- * inside the tail. An empty-string param is 0 — engine-faithful quirk.
- */
-export declare function parseAfterIndexParam(value: string | null): number;
-/**
- * Tail selection (streams.js:120-122): the id is tried as a session first —
- * active turn, else latest-by-session — then as a literal turn id.
- */
-export declare function findTurn(store: TurnStore, id: string): TurnEntry | null;
-/** One step's output: payloads to write, then whether to close the stream. */
-export interface TailOutput {
-    writes: string[];
-    end: boolean;
-}
-export interface TurnTailOptions {
-    /** Defaults to 'frame' (streams.js:63). */
-    format?: ReplayFormat;
-    /** Replay cursor; non-finite values normalize to -1 (streams.js:64). */
-    afterIndex?: number;
-}
-export interface TurnTail {
-    /**
-     * The backlog pass (streams.js:104-117): existing chunks past the cursor,
-     * plus immediate completion when the turn is already terminal.
-     */
-    readonly initial: TailOutput;
-    /**
-     * One subscription emission (streams.js:97-101): a chunk write, or — on a
-     * status notification — completion if the status is terminal.
-     */
-    next(chunk: TurnChunk | null, current: TurnEntry): TailOutput;
-}
-/**
- * The core of `writeTurnTail` (streams.js:62-118) as a cursor-holding pure
- * state machine. No sockets, no timers: each call returns the exact payload
- * strings the engine would have written.
- */
-export declare function createTurnTail(entry: TurnEntry, options?: TurnTailOptions): TurnTail;
-/**
- * `writeRawTempStream` selection (streams.js:124-134): resolve the id via
- * {@link findTurn}; `null` means the host answers 404 (no tail exists).
- */
-export declare function createRawTempTail(store: TurnStore, id: string, afterIndex?: number): {
-    entry: TurnEntry;
-    tail: TurnTail;
-} | null;
-/**
- * Default error message when a failed turn carries none (streams.js:148).
- */
-export declare const CHAT_STREAM_FALLBACK_ERROR = "Internal server error";
-/**
- * The frames `/chat` writes when `runTurn` rejects (streams.js:148-152):
- * an error frame, then a complete frame with `stopReason: 'error'`. After
- * writing these the host closes the stream — this is the second half of the
- * save_failed rule: the tail held the socket open so these bytes land first.
- */
-export declare function chatErrorWrites(message?: string | null): string[];
-//# sourceMappingURL=replay.d.ts.map

package/dist/turns/replay.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/turns/replay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGvE,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;AAEhD,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAE7C;AAED,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAE7D;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEjE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEvE;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,EAAE,SAAS,GAAG,UAAU,CAAC;CAC/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,QAAQ,CA4DxF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,EAAE,EAAE,MAAM,EACV,UAAU,CAAC,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,IAAI,CAU7C;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,0BAA0B,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAMjE"}

package/dist/turns/replay.js

@@ -1,163 +0,0 @@
-/**
- * The replay grammar — engine `chat-core/streams.js` (160 lines), with the
- * host I/O peeled off. streams.js mixes SSE response plumbing (headers,
- * heartbeat timers, `res.write`) with the replay LAW: which payloads a tail
- * emits, in what order, and when the stream closes. This module is the law
- * as pure functions; the host owns the socket, the timer, and the actual
- * subscription wiring.
- *
- * Host contract (mirrors streams.js:97-117):
- *   1. `createTurnTail(entry, options)` — apply `tail.initial` writes; if
- *      `initial.end`, close.
- *   2. `store.subscribe(entry.turnId, (chunk, current) => ...)` — feed each
- *      emission through `tail.next(chunk, current)`; write its writes; close
- *      on `end`. (Subscribe before applying `initial` to match the engine;
- *      the cursor guard makes duplicate delivery harmless.)
- *   3. Every `HEARTBEAT_INTERVAL_MS`, write `KEEP_ALIVE_FRAME` while open.
- */
-import { isTerminalStatus } from './status.js';
-/** Heartbeat cadence (streams.js:5). */
-export const HEARTBEAT_INTERVAL_MS = 15_000;
-/** The comment frame the heartbeat writes (streams.js:31), byte-exact. */
-export const KEEP_ALIVE_FRAME = ': keep-alive\n\n';
-/**
- * The SSE response headers the host must send before any tail write
- * (sse.js:198-204). Documented contract — writing them is host work.
- */
-export const SSE_HEADERS = {
-    'Content-Type': 'text/event-stream',
-    'Cache-Control': 'no-cache, no-transform',
-    Connection: 'keep-alive',
-};
-/** Anonymous SSE data frame (streams.js:7-9). */
-export function jsonSse(data) {
-    return `data: ${JSON.stringify(data)}\n\n`;
-}
-/** Named SSE event frame (streams.js:11-13). */
-export function namedSse(event, data) {
-    return `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
-}
-/** Cursor normalization (streams.js:58-60): any non-finite value → -1. */
-export function normalizeAfterIndex(afterIndex) {
-    return Number.isFinite(afterIndex) ? afterIndex : -1;
-}
-/**
- * Route-layer cursor parse (server.js:43):
- * `Number(searchParams.get('afterIndex') ?? -1)`. A missing param is -1; a
- * garbage param becomes NaN, which {@link normalizeAfterIndex} folds to -1
- * inside the tail. An empty-string param is 0 — engine-faithful quirk.
- */
-export function parseAfterIndexParam(value) {
-    return Number(value ?? -1);
-}
-/**
- * Tail selection (streams.js:120-122): the id is tried as a session first —
- * active turn, else latest-by-session — then as a literal turn id.
- */
-export function findTurn(store, id) {
-    return store.latest(id) || store.get(id);
-}
-/**
- * The core of `writeTurnTail` (streams.js:62-118) as a cursor-holding pure
- * state machine. No sockets, no timers: each call returns the exact payload
- * strings the engine would have written.
- */
-export function createTurnTail(entry, options = {}) {
-    const format = options.format || 'frame';
-    let lastSent = normalizeAfterIndex(options.afterIndex);
-    // streams.js:66-78 — the guarded chunk write; advances the cursor.
-    const writeChunk = (writes, chunk, current) => {
-        if (!chunk || chunk.index <= lastSent)
-            return;
-        if (format === 'raw-temp') {
-            writes.push(namedSse('chunk', {
-                codeSessionId: current.sessionId,
-                chunk,
-                total: current.chunks.length,
-            }));
-        }
-        else {
-            writes.push(chunk.data);
-        }
-        lastSent = chunk.index;
-    };
-    // streams.js:80-95 — the completion rule. raw-temp always writes the
-    // `complete` event and closes. frame format writes nothing and closes —
-    // UNLESS the status is `save_failed`: the /chat route still owes the tail
-    // an error frame after runTurn rejects, so the stream must stay open for
-    // it (streams.js:90-94; the frames themselves are chatErrorWrites()).
-    const complete = (writes, current) => {
-        if (format === 'raw-temp') {
-            writes.push(namedSse('complete', {
-                codeSessionId: current.sessionId,
-                total: current.chunks.length,
-            }));
-            return true;
-        }
-        return current.status !== 'save_failed';
-    };
-    // streams.js:104-117 — the backlog pass.
-    const initial = { writes: [], end: false };
-    const existing = entry.chunks.filter((chunk) => chunk.index > lastSent);
-    if (format === 'raw-temp') {
-        initial.writes.push(namedSse('existing', {
-            codeSessionId: entry.sessionId,
-            assistantMessageId: entry.assistantMessageId,
-            chunks: existing,
-            total: existing.length,
-        }));
-        if (existing.length)
-            lastSent = existing[existing.length - 1].index;
-    }
-    else {
-        for (const chunk of existing)
-            writeChunk(initial.writes, chunk, entry);
-    }
-    if (isTerminalStatus(entry.status))
-        initial.end = complete(initial.writes, entry);
-    return {
-        initial,
-        next(chunk, current) {
-            const out = { writes: [], end: false };
-            if (chunk)
-                writeChunk(out.writes, chunk, current);
-            else if (isTerminalStatus(current.status))
-                out.end = complete(out.writes, current);
-            return out;
-        },
-    };
-}
-/**
- * `writeRawTempStream` selection (streams.js:124-134): resolve the id via
- * {@link findTurn}; `null` means the host answers 404 (no tail exists).
- */
-export function createRawTempTail(store, id, afterIndex) {
-    const entry = findTurn(store, id);
-    if (!entry)
-        return null;
-    return {
-        entry,
-        tail: createTurnTail(entry, {
-            format: 'raw-temp',
-            afterIndex: normalizeAfterIndex(afterIndex),
-        }),
-    };
-}
-/**
- * Default error message when a failed turn carries none (streams.js:148).
- */
-export const CHAT_STREAM_FALLBACK_ERROR = 'Internal server error';
-/**
- * The frames `/chat` writes when `runTurn` rejects (streams.js:148-152):
- * an error frame, then a complete frame with `stopReason: 'error'`. After
- * writing these the host closes the stream — this is the second half of the
- * save_failed rule: the tail held the socket open so these bytes land first.
- */
-export function chatErrorWrites(message) {
-    const resolved = message || CHAT_STREAM_FALLBACK_ERROR;
-    return [
-        jsonSse({ _type: 'error', message: resolved }),
-        jsonSse({ _type: 'complete', stopReason: 'error' }),
-    ];
-}
-//# sourceMappingURL=replay.js.map

package/dist/turns/replay.js.map

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