@czap/astro 0.1.0

package/dist/runtime/llm-session.js

@@ -0,0 +1,385 @@
+import { LLMChunkNormalization, createHtmlFragment, } from '@czap/web';
+import { createLLMRenderPipeline } from './llm-render-pipeline.js';
+import { createLLMReceiptTracker } from './llm-receipt-tracker.js';
+const noopSetTarget = () => { };
+const noopEmitToken = () => { };
+const noopEmitFrame = () => { };
+const noopEmitToolStart = () => { };
+const noopEmitToolEnd = () => { };
+const noopEmitDone = () => { };
+const alwaysRenderText = () => true;
+const renderFrameTokensOnly = (frame) => frame.tokens.length > 0;
+function appendText(target, text) {
+    if (typeof target.append === 'function') {
+        target.append(text);
+        return;
+    }
+    target.appendChild(document.createTextNode(text));
+}
+function replaceWithText(target, text) {
+    target.textContent = text;
+}
+function writeHtml(target, html, htmlPolicy, allowTrustedHtml) {
+    // Route through createHtmlFragment so the assignment goes via the
+    // shared trust pipeline's Trusted-Types-aware `assignInnerHTML` helper
+    // rather than a raw `target.innerHTML = ...` (which throws under
+    // `require-trusted-types-for 'script'` enforcement). See SECURITY.md
+    // "CSP and Trusted Types" for the recipe.
+    const fragment = createHtmlFragment(html, {
+        policy: htmlPolicy,
+        allowTrustedHtml,
+    });
+    target.replaceChildren(fragment);
+}
+/**
+ * Build an {@link LLMSessionHost} that writes text/frames directly to
+ * the DOM and dispatches `czap:llm-*` custom events on `element`.
+ * Default host used by {@link createLLMSession}.
+ */
+export function createDOMLLMSessionHost(element, initialTarget, options) {
+    let currentTarget = initialTarget;
+    const htmlPolicy = options?.htmlPolicy ?? 'text';
+    const allowTrustedHtml = options?.allowTrustedHtml ?? false;
+    return {
+        setTarget(target) {
+            if (target) {
+                currentTarget = target;
+            }
+        },
+        renderText(text, accumulated, mode) {
+            if (htmlPolicy !== 'text') {
+                writeHtml(currentTarget, accumulated, htmlPolicy, allowTrustedHtml);
+                return true;
+            }
+            if (mode === 'append') {
+                appendText(currentTarget, text);
+            }
+            else {
+                replaceWithText(currentTarget, accumulated);
+            }
+            return true;
+        },
+        renderFrame(frame, accumulated, mode) {
+            const text = frame.tokens.join('');
+            if (!text) {
+                return false;
+            }
+            if (htmlPolicy !== 'text') {
+                writeHtml(currentTarget, accumulated, htmlPolicy, allowTrustedHtml);
+                return true;
+            }
+            if (mode === 'append') {
+                appendText(currentTarget, text);
+            }
+            else {
+                replaceWithText(currentTarget, accumulated);
+            }
+            return true;
+        },
+        emitToken(text, accumulated) {
+            element.dispatchEvent(new CustomEvent('czap:llm-token', {
+                detail: { text, accumulated },
+                bubbles: true,
+            }));
+        },
+        emitFrame(frame) {
+            element.dispatchEvent(new CustomEvent('czap:llm-frame', {
+                detail: frame,
+                bubbles: true,
+            }));
+        },
+        emitToolStart(name) {
+            element.dispatchEvent(new CustomEvent('czap:llm-tool-start', {
+                detail: { name },
+                bubbles: true,
+            }));
+        },
+        emitToolEnd(name, args) {
+            element.dispatchEvent(new CustomEvent('czap:llm-tool-end', {
+                detail: { name, args },
+                bubbles: true,
+            }));
+        },
+        emitDone(accumulated) {
+            element.dispatchEvent(new CustomEvent('czap:llm-done', {
+                detail: { accumulated },
+                bubbles: true,
+            }));
+        },
+    };
+}
+/**
+ * Build an {@link LLMSessionHost} that forwards events to the given
+ * handler callbacks instead of touching the DOM. Useful for tests,
+ * benchmarks, and any caller that wants to observe LLM output
+ * programmatically.
+ */
+export function createSupportLLMSessionHost(handlers) {
+    const onToken = handlers?.onToken;
+    const onTokenValue = handlers?.onTokenValue;
+    const onFrame = handlers?.onFrame;
+    const onToolStart = handlers?.onToolStart;
+    const onToolStartValue = handlers?.onToolStartValue;
+    const onToolEnd = handlers?.onToolEnd;
+    const onToolEndValue = handlers?.onToolEndValue;
+    const onDone = handlers?.onDone;
+    const onDoneValue = handlers?.onDoneValue;
+    // The startup bench only needs the token boundary, so skip the generic
+    // support-host composition work when no other callbacks are present.
+    if (onTokenValue &&
+        !onToken &&
+        !onFrame &&
+        !onToolStart &&
+        !onToolStartValue &&
+        !onToolEnd &&
+        !onToolEndValue &&
+        !onDone &&
+        !onDoneValue) {
+        return {
+            setTarget: noopSetTarget,
+            renderText: alwaysRenderText,
+            renderFrame: renderFrameTokensOnly,
+            emitToken: onTokenValue,
+            emitFrame: noopEmitFrame,
+            emitToolStart: noopEmitToolStart,
+            emitToolEnd: noopEmitToolEnd,
+            emitDone: noopEmitDone,
+        };
+    }
+    const emitToken = onTokenValue && onToken
+        ? (text, accumulated) => {
+            onTokenValue(text, accumulated);
+            onToken({ text, accumulated });
+        }
+        : onTokenValue
+            ? onTokenValue
+            : onToken
+                ? (text, accumulated) => {
+                    onToken({ text, accumulated });
+                }
+                : undefined;
+    const emitFrame = onFrame ?? noopEmitFrame;
+    const emitToolStart = onToolStartValue && onToolStart
+        ? (name) => {
+            onToolStartValue(name);
+            onToolStart({ name });
+        }
+        : onToolStartValue
+            ? onToolStartValue
+            : onToolStart
+                ? (name) => {
+                    onToolStart({ name });
+                }
+                : noopEmitToolStart;
+    const emitToolEnd = onToolEndValue && onToolEnd
+        ? (name, args) => {
+            onToolEndValue(name, args);
+            onToolEnd({ name, args });
+        }
+        : onToolEndValue
+            ? onToolEndValue
+            : onToolEnd
+                ? (name, args) => {
+                    onToolEnd({ name, args });
+                }
+                : noopEmitToolEnd;
+    const emitDone = onDoneValue && onDone
+        ? (accumulated) => {
+            onDoneValue(accumulated);
+            onDone({ accumulated });
+        }
+        : onDoneValue
+            ? onDoneValue
+            : onDone
+                ? (accumulated) => {
+                    onDone({ accumulated });
+                }
+                : noopEmitDone;
+    return {
+        setTarget: noopSetTarget,
+        renderText: alwaysRenderText,
+        renderFrame: renderFrameTokensOnly,
+        emitToken: emitToken ?? noopEmitToken,
+        emitFrame,
+        emitToolStart,
+        emitToolEnd,
+        emitDone,
+    };
+}
+/**
+ * Minimal {@link LLMSessionHost} that only surfaces the token
+ * boundary, skipping the branching composition in
+ * {@link createSupportLLMSessionHost}. Exposed for startup benchmarks
+ * that need the cheapest possible host.
+ */
+export function createSupportLLMTokenBoundaryHost(onTokenValue) {
+    return {
+        setTarget: noopSetTarget,
+        renderText: alwaysRenderText,
+        renderFrame: alwaysRenderText,
+        emitToken: onTokenValue,
+        emitFrame: noopEmitFrame,
+        emitToolStart: noopEmitToolStart,
+        emitToolEnd: noopEmitToolEnd,
+        emitDone: noopEmitDone,
+    };
+}
+class LLMSessionController {
+    config;
+    host;
+    runtimeState = 'idle';
+    currentTarget;
+    toolCallBuffer = null;
+    pipeline;
+    receiptTracker;
+    constructor(config, host) {
+        this.config = config;
+        this.host = host;
+        this.currentTarget = config.target;
+        this.pipeline = createLLMRenderPipeline({ mode: config.mode, getDeviceTier: config.getDeviceTier });
+        this.receiptTracker = createLLMReceiptTracker();
+    }
+    get state() {
+        return this.runtimeState;
+    }
+    activate() {
+        if (!this.isDisposed()) {
+            this.runtimeState = 'active';
+        }
+    }
+    beginReconnect() {
+        if (!this.isDisposed()) {
+            this.runtimeState = 'reconnecting';
+        }
+    }
+    ingest(chunk) {
+        if (this.isDisposed()) {
+            return 'done';
+        }
+        const recordFrame = (frame) => this.receiptTracker.recordFrame(frame);
+        switch (chunk.type) {
+            case 'text': {
+                if (!chunk.content) {
+                    return 'continue';
+                }
+                if (this.pipeline.shouldUseFastLane(this.toolCallBuffer === null, this.receiptTracker.receiptChain === null, this.runtimeState) &&
+                    this.pipeline.renderImmediateText(chunk.content, this.host)) {
+                    this.pipeline.setFastLanePrimed(true);
+                    this.host.emitToken(chunk.content, this.pipeline.accumulated);
+                    return 'continue';
+                }
+                this.pipeline.pushText(chunk.content);
+                if (this.isDisposed()) {
+                    this.pipeline.clearQueuedText();
+                    return 'done';
+                }
+                if (!this.pipeline.canQueueRenderBurst()) {
+                    this.pipeline.clearQueuedText();
+                    return 'continue';
+                }
+                if (this.pipeline.fastLanePrimed && !this.pipeline.llmRuntime) {
+                    this.pipeline.promoteFastLane();
+                }
+                this.pipeline.enqueueFlush(this.host, recordFrame);
+                return 'continue';
+            }
+            case 'tool-call-start': {
+                if (this.pipeline.flushQueued || this.pipeline.queuedTextFragments.length > 0) {
+                    this.pipeline.flushPendingText(this.host, recordFrame);
+                }
+                const normalized = LLMChunkNormalization.normalize(chunk, this.toolCallBuffer);
+                this.toolCallBuffer = normalized.toolCallBuffer;
+                this.host.emitToolStart(normalized.chunk?.toolName ?? '');
+                return 'continue';
+            }
+            case 'tool-call-delta': {
+                if (this.pipeline.flushQueued || this.pipeline.queuedTextFragments.length > 0) {
+                    this.pipeline.flushPendingText(this.host, recordFrame);
+                }
+                const normalized = LLMChunkNormalization.normalize(chunk, this.toolCallBuffer);
+                this.toolCallBuffer = normalized.toolCallBuffer;
+                return 'continue';
+            }
+            case 'tool-call-end': {
+                if (this.pipeline.flushQueued || this.pipeline.queuedTextFragments.length > 0) {
+                    this.pipeline.flushPendingText(this.host, recordFrame);
+                }
+                if (!this.pipeline.llmRuntime) {
+                    this.pipeline.promoteFastLane();
+                }
+                const normalized = LLMChunkNormalization.normalize(chunk, this.toolCallBuffer);
+                this.toolCallBuffer = normalized.toolCallBuffer;
+                const name = normalized.chunk?.toolName ?? '';
+                const args = normalized.chunk?.toolArgs;
+                this.host.emitToolEnd(name, args);
+                return 'continue';
+            }
+            case 'done':
+                this.pipeline.flushPendingText(this.host, recordFrame);
+                this.host.emitDone(this.pipeline.accumulated);
+                return 'done';
+        }
+    }
+    replayGap() {
+        return this.receiptTracker.replayGap(this.pipeline, this.host);
+    }
+    rememberEnvelope(envelope) {
+        if (this.isDisposed()) {
+            return;
+        }
+        this.receiptTracker.rememberEnvelope(envelope);
+    }
+    reset(target) {
+        if (this.isDisposed()) {
+            return;
+        }
+        // Preserve 'reconnecting' state so that chunks arriving between reset() and
+        // activate() cannot re-engage the fast lane prematurely.  The caller must
+        // explicitly call activate() to advance past the reconnecting gate.
+        if (this.runtimeState !== 'reconnecting') {
+            this.runtimeState = 'idle';
+        }
+        this.resetSession(target);
+    }
+    dispose() {
+        this.resetSession(this.currentTarget);
+        this.pipeline.releaseRuntime();
+        this.runtimeState = 'disposed';
+    }
+    isDisposed() {
+        return this.runtimeState === 'disposed';
+    }
+    resetSession(target = this.currentTarget) {
+        this.currentTarget = target;
+        this.host.setTarget(target);
+        this.toolCallBuffer = null;
+        this.pipeline.resetPipelineState();
+        this.receiptTracker.reset();
+    }
+}
+/**
+ * Build an {@link LLMSessionShape} backed by a caller-supplied
+ * {@link LLMSessionHost}. Tests and bench harnesses prefer this
+ * variant over {@link createLLMSession} so they can observe output
+ * without a DOM.
+ */
+export function createLLMSessionWithHost(config, host) {
+    return new LLMSessionController(config, host);
+}
+/**
+ * Default `client:llm` factory: builds a session wired to the DOM.
+ * Equivalent to composing {@link createDOMLLMSessionHost} with
+ * {@link createLLMSessionWithHost}.
+ */
+export function createLLMSession(config) {
+    const domHost = createDOMLLMSessionHost(config.element, config.target, {
+        htmlPolicy: config.htmlPolicy,
+        allowTrustedHtml: config.allowTrustedHtml,
+    });
+    return createLLMSessionWithHost({
+        mode: config.mode,
+        getDeviceTier: config.getDeviceTier,
+        target: config.target,
+    }, domHost);
+}
+//# sourceMappingURL=llm-session.js.map

package/dist/runtime/llm-session.js.map

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

package/dist/runtime/llm.d.ts

@@ -0,0 +1,16 @@
+import type { LLMChunk } from '@czap/web';
+/**
+ * Parse a raw `MessageEvent` payload into an {@link LLMChunk}. Returns
+ * `null` when the payload is unrecognised so callers can drop
+ * non-chunk events (metrics, heartbeats, ...) silently.
+ */
+export declare function parseLLMChunk(event: Pick<MessageEvent, 'data'>): LLMChunk | null;
+/**
+ * Entry point used by the `client:llm` directive to start a streaming
+ * LLM session on `element`. Reads `data-czap-llm-url` (plus optional
+ * target / mode attributes), validates it against the runtime
+ * endpoint policy, opens an SSE stream, and drives an
+ * {@link LLMSessionShape} to completion.
+ */
+export declare function initLLMDirective(load: () => Promise<unknown>, element: HTMLElement): void;
+//# sourceMappingURL=llm.d.ts.map

package/dist/runtime/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/runtime/llm.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AA4D1C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,QAAQ,GAAG,IAAI,CAGhF;AAuID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAmIzF"}