@amalgm/chat 0.1.0

package/dist/transcript/tool-shape.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Port of amalgm-engine `runtime/scripts/chat-core/tool-shape.js` (working
+ * tree, including the cua/dialog/tab/console browser-tool titles and the
+ * apps_register cwd title). Classifies tools into kinds and renders titles.
+ * Pure: deterministic mappings only.
+ */
+export interface McpName {
+    server: string;
+    tool: string;
+}
+export interface NormalizedError {
+    message: string;
+    code?: string | undefined;
+    details?: unknown;
+}
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function hostLabel(url: unknown): string;
+export declare function humanizeToolName(value?: unknown): string;
+export declare function parseMcpName(name?: unknown): McpName | null;
+export declare function normalizeError(error: unknown, fallback?: string): NormalizedError | undefined;
+export declare function toolKind(name?: unknown, input?: unknown, metadata?: unknown): string;
+export interface TitleForToolOptions {
+    name?: unknown;
+    input?: Record<string, unknown> | undefined;
+    output?: unknown;
+    error?: unknown;
+    metadata?: Record<string, unknown> | undefined;
+    fallback?: unknown;
+}
+export declare function titleForTool({ name, input, error, metadata, fallback }?: TitleForToolOptions): string;
+export declare function mcpMetadataFromName(name: unknown): {
+    mcp?: McpName;
+};
+//# sourceMappingURL=tool-shape.d.ts.map

package/dist/transcript/tool-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-shape.d.ts","sourceRoot":"","sources":["../../src/transcript/tool-shape.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQ9C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,OAAY,GAAG,MAAM,CAS5D;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,OAAY,GAAG,OAAO,GAAG,IAAI,CAO/D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAgB,GAAG,eAAe,GAAG,SAAS,CAYpG;AAED,wBAAgB,QAAQ,CAAC,IAAI,GAAE,OAAY,EAAE,KAAK,GAAE,OAAY,EAAE,QAAQ,GAAE,OAAY,GAAG,MAAM,CAyBhG;AAiDD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,KAAU,EAAE,KAAK,EAAE,QAAa,EAAE,QAAQ,EAAE,GAAE,mBAAwB,GAAG,MAAM,CAiCnH;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAGpE"}

package/dist/transcript/tool-shape.js

@@ -0,0 +1,216 @@
+/**
+ * Port of amalgm-engine `runtime/scripts/chat-core/tool-shape.js` (working
+ * tree, including the cua/dialog/tab/console browser-tool titles and the
+ * apps_register cwd title). Classifies tools into kinds and renders titles.
+ * Pure: deterministic mappings only.
+ */
+import { compactText, stringifyResult } from './tool-display.js';
+export function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+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);
+    }
+}
+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);
+}
+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;
+}
+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 };
+}
+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);
+    const meta = metadata;
+    if (meta['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 args = input;
+        if (args['command'] !== undefined)
+            return 'bash';
+        if (args['url'] !== undefined)
+            return 'browser';
+        if (args['query'] !== undefined)
+            return 'web_search';
+        if (args['file_path'] !== undefined || args['filePath'] !== undefined || args['path'] !== undefined)
+            return 'file_read';
+    }
+    return 'unknown';
+}
+/**
+ * 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(name))
+        return name;
+    return null;
+}
+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);
+}
+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 metaAction = metadata['action'];
+    if (metaAction?.['type'] === 'search') {
+        return `Searching ${compactText(metaAction['query'] || input['query'] || 'the web', 80)}`;
+    }
+    if (metaAction?.['type'] === 'openPage') {
+        const host = hostLabel(metaAction['url'] || input['url'] || input['query']);
+        return host ? `Opening ${host}` : 'Opening web page';
+    }
+    if (metaAction?.['type'] === 'findInPage') {
+        const pattern = metaAction['pattern'] || input['pattern'];
+        const url = metaAction['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);
+}
+export function mcpMetadataFromName(name) {
+    const mcp = parseMcpName(name);
+    return mcp ? { mcp } : {};
+}
+//# sourceMappingURL=tool-shape.js.map

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

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

package/dist/turns/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,11 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,36 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,37 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,105 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}