@drscrewdriver/dsh-better-display 0.3.3-fork.1

package/lib/types/client/settings.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type OpenPrefs } from './SettingsSection.js';
+export declare function installBetterDisplaySettings(ctx: Context, prefs: OpenPrefs): void;
+//# sourceMappingURL=settings.d.ts.map

package/lib/types/client/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/client/settings.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAuD,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAiD3G,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAoBjF"}

package/lib/types/client/settings.js

@@ -0,0 +1,60 @@
+import { settingsCopyFor, zh, en } from './settings-copy.js';
+import { SettingsSection } from './SettingsSection.js';
+import { firstSessionId, skillsFromListResult } from './skill-status.js';
+function languageTag(ctx) {
+    const locale = (ctx.get?.('locale') ?? ctx.locale);
+    const snap = locale?.getSnapshot?.();
+    return snap?.locale ?? snap?.language
+        ?? (typeof document !== 'undefined' ? document.documentElement.lang : undefined)
+        ?? (typeof navigator !== 'undefined' ? navigator.language : undefined);
+}
+function createSkillProbe(ctx) {
+    return {
+        fetchHostStatus: async () => {
+            const sessions = ctx.sessions;
+            const snap = sessions?.list?.getSnapshot?.();
+            const id = firstSessionId(snap);
+            const cwd = id && snap?.byId ? snap.byId[id]?.cwd : undefined;
+            const url = cwd
+                ? `/better-display/skill-status?cwd=${encodeURIComponent(cwd)}`
+                : '/better-display/skill-status';
+            const res = await fetch(url);
+            if (!res.ok)
+                return undefined;
+            return await res.json();
+        },
+        listRemoteSkills: async () => {
+            const remote = ctx.remote;
+            const skills = remote?.skills
+                ?? ctx.get?.('remote.skills')
+                ?? (ctx.get?.('remote')?.skills);
+            const sessions = ctx.sessions;
+            const sessionId = firstSessionId(sessions?.list?.getSnapshot?.());
+            if (!skills?.list || !sessionId)
+                return undefined;
+            return skillsFromListResult(await skills.list({ sessionId }));
+        },
+    };
+}
+export function installBetterDisplaySettings(ctx, prefs) {
+    const locale = (ctx.get?.('locale') ?? ctx.locale);
+    if (locale?.register) {
+        ctx.effect(() => locale.register('better-display', { zh, en }), 'dsh-better-display: settings copy');
+    }
+    const checkSkill = createSkillProbe(ctx);
+    const injected = () => ({
+        prefs,
+        copy: settingsCopyFor(languageTag(ctx)),
+        languageTag: languageTag(ctx),
+        checkSkill,
+    });
+    ctx.slots.inject('settings.section', () => ctx.slots.register({
+        name: 'settings.section',
+        id: 'better-display',
+        order: 40,
+        label: () => locale?.bind?.('better-display')?.('nav') || settingsCopyFor(languageTag(ctx)).nav,
+        locale: locale?.bind ? 'better-display' : undefined,
+        inject: injected,
+    }, SettingsSection));
+}
+//# sourceMappingURL=settings.js.map

package/lib/types/client/settings.js.map

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

package/lib/types/client/skill-status.d.ts

@@ -0,0 +1,25 @@
+import { CONVENTIONAL_SKILL_ROOTS, GENERATIVE_MCPAPPS_SKILL, SKILL_PACK_RELATIVE, publicSkillRoots, skillListIncludes, skillsFromListResult, toPublicSkillStatus, type HostSkillStatus } from '../skill-status.js';
+export { CONVENTIONAL_SKILL_ROOTS, GENERATIVE_MCPAPPS_SKILL, SKILL_PACK_RELATIVE, publicSkillRoots, skillListIncludes, skillsFromListResult, toPublicSkillStatus, };
+export type { HostSkillStatus };
+export interface SkillStatusSnapshot {
+    readonly name: typeof GENERATIVE_MCPAPPS_SKILL;
+    readonly installed: boolean;
+    readonly via: 'skills.list' | 'skill-root' | null;
+    readonly roots: HostSkillStatus['roots'];
+    readonly packPath?: string;
+    readonly hostReached: boolean;
+}
+export interface SkillStatusProbe {
+    listRemoteSkills?: () => Promise<readonly {
+        readonly name?: string;
+    }[] | undefined>;
+    fetchHostStatus?: () => Promise<HostSkillStatus | undefined>;
+}
+export declare function detectGenerativeMcpappsSkill(probe: SkillStatusProbe): Promise<SkillStatusSnapshot>;
+/** mkdir/cp using conventional relative roots only. Host paths are ignored. */
+export declare function shortestInstallCommand(_status?: Pick<SkillStatusSnapshot, 'packPath' | 'roots'>): string;
+export declare function firstSessionId(list: {
+    ids?: readonly string[];
+    byId?: Record<string, unknown>;
+} | undefined): string | undefined;
+//# sourceMappingURL=skill-status.d.ts.map

package/lib/types/client/skill-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-status.d.ts","sourceRoot":"","sources":["../../../src/client/skill-status.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,CAAC;AACF,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,wBAAwB,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC,CAAC;IACpF,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;CAC9D;AAED,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6BxG;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,MAAM,CAGxG;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIhI"}

package/lib/types/client/skill-status.js

@@ -0,0 +1,44 @@
+import { CONVENTIONAL_SKILL_ROOTS, GENERATIVE_MCPAPPS_SKILL, SKILL_PACK_RELATIVE, publicSkillRoots, skillListIncludes, skillsFromListResult, toPublicSkillStatus, } from '../skill-status.js';
+export { CONVENTIONAL_SKILL_ROOTS, GENERATIVE_MCPAPPS_SKILL, SKILL_PACK_RELATIVE, publicSkillRoots, skillListIncludes, skillsFromListResult, toPublicSkillStatus, };
+export async function detectGenerativeMcpappsSkill(probe) {
+    let host;
+    if (probe.fetchHostStatus) {
+        try {
+            host = await probe.fetchHostStatus();
+        }
+        catch {
+            host = undefined;
+        }
+    }
+    let remoteHit = false;
+    if (probe.listRemoteSkills) {
+        try {
+            remoteHit = skillListIncludes(await probe.listRemoteSkills());
+        }
+        catch {
+            remoteHit = false;
+        }
+    }
+    const installed = Boolean(host?.installed || remoteHit);
+    const via = remoteHit ? 'skills.list' : (host?.via ?? null);
+    const publicHost = host === undefined ? undefined : toPublicSkillStatus(host);
+    return {
+        name: GENERATIVE_MCPAPPS_SKILL,
+        installed,
+        via,
+        roots: publicHost?.roots ?? publicSkillRoots(),
+        hostReached: host !== undefined,
+    };
+}
+/** mkdir/cp using conventional relative roots only. Host paths are ignored. */
+export function shortestInstallCommand(_status) {
+    const dest = CONVENTIONAL_SKILL_ROOTS[0];
+    return `mkdir -p ${dest} && cp -R ${SKILL_PACK_RELATIVE} ${dest}/`;
+}
+export function firstSessionId(list) {
+    if (list?.ids && list.ids.length > 0)
+        return list.ids[0];
+    const keys = list?.byId ? Object.keys(list.byId) : [];
+    return keys[0];
+}
+//# sourceMappingURL=skill-status.js.map

package/lib/types/client/skill-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-status.js","sourceRoot":"","sources":["../../../src/client/skill-status.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,CAAC;AAiBF,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,KAAuB;IACxE,IAAI,IAAiC,CAAC;IACtC,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,SAAS,GAAG,iBAAiB,CAAC,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,IAAI,SAAS,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,SAAS;QACT,GAAG;QACH,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,gBAAgB,EAAE;QAC9C,WAAW,EAAE,IAAI,KAAK,SAAS;KAChC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,sBAAsB,CAAC,OAAyD;IAC9F,MAAM,IAAI,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO,YAAY,IAAI,aAAa,mBAAmB,IAAI,IAAI,GAAG,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAA6E;IAC1G,IAAI,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/lib/types/client/store.d.ts

@@ -0,0 +1,35 @@
+import type { EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
+import { type FoldIntensity } from './fold-intensity.js';
+import type { DeliverableOpenMode } from './open-file.js';
+export interface ReaderState {
+    expanded: Record<string, boolean>;
+    motion: boolean;
+    /** Derived from foldIntensity; kept so older persisted snapshots still read. */
+    autoFold: boolean;
+    /** Default stays the system app. `sidebar` is opt-in. */
+    deliverableOpenMode: DeliverableOpenMode;
+    /**
+     * 0 = no auto-fold, 1 = current-main fold-on-next-reasoning (default),
+     * 2 = process-summary mode from community PR #14.
+     */
+    foldIntensity: FoldIntensity;
+    /** Translucent frosted chrome. Default off so opaque main chrome stays. */
+    frostedGlass: boolean;
+    /** Rounded answer bubbles. Default on; off lays answers flat on the page. */
+    bubbles: boolean;
+    /** Derived from foldIntensity === 2; kept for older #14 snapshots. */
+    processOnly: boolean;
+}
+type ReaderActions = {
+    setExpanded: (draft: ReaderState, key: string, value: boolean) => void;
+    resetExpanded: (draft: ReaderState) => void;
+    setMotion: (draft: ReaderState, value: boolean) => void;
+    setAutoFold: (draft: ReaderState, value: boolean) => void;
+    setDeliverableOpenMode: (draft: ReaderState, value: DeliverableOpenMode) => void;
+    setFoldIntensity: (draft: ReaderState, value: FoldIntensity) => void;
+    setFrostedGlass: (draft: ReaderState, value: boolean) => void;
+    setBubbles: (draft: ReaderState, value: boolean) => void;
+};
+export declare function createReaderStore(): EngineStoreHandle<ReaderState, ReaderActions>;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/lib/types/client/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/client/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,mBAAmB,EAAE,mBAAmB,CAAC;IACzC;;;OAGG;IACH,aAAa,EAAE,aAAa,CAAC;IAC7B,2EAA2E;IAC3E,YAAY,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,WAAW,EAAE,OAAO,CAAC;CACtB;AACD,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvE,aAAa,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D,sBAAsB,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjF,gBAAgB,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACrE,eAAe,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9D,UAAU,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D,CAAC;AAQF,wBAAgB,iBAAiB,IAAI,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,CA4BjF"}

package/lib/types/client/store.js

@@ -0,0 +1,37 @@
+import { defineStore } from '@deepseek-ai/dsh-client-store';
+import { FOLD_INTENSITY_DEFAULT, autoFoldFromIntensity, processOnlyFromIntensity, } from './fold-intensity.js';
+function applyFoldIntensity(draft, value) {
+    draft.foldIntensity = value;
+    draft.autoFold = autoFoldFromIntensity(value);
+    draft.processOnly = processOnlyFromIntensity(value);
+}
+export function createReaderStore() {
+    return defineStore({
+        init: () => ({
+            expanded: {},
+            motion: true,
+            autoFold: true,
+            deliverableOpenMode: 'external',
+            foldIntensity: FOLD_INTENSITY_DEFAULT,
+            frostedGlass: false,
+            bubbles: true,
+            processOnly: false,
+        }),
+        persist: 'dsh.reader.v1',
+        actions: {
+            setExpanded: (draft, key, value) => { draft.expanded[key] = value; },
+            resetExpanded: draft => { draft.expanded = {}; },
+            setMotion: (draft, value) => { draft.motion = value; },
+            setAutoFold: (draft, value) => {
+                applyFoldIntensity(draft, value
+                    ? (draft.foldIntensity === 2 ? 2 : 1)
+                    : 0);
+            },
+            setDeliverableOpenMode: (draft, value) => { draft.deliverableOpenMode = value; },
+            setFoldIntensity: (draft, value) => { applyFoldIntensity(draft, value); },
+            setFrostedGlass: (draft, value) => { draft.frostedGlass = value; },
+            setBubbles: (draft, value) => { draft.bubbles = value; },
+        },
+    });
+}
+//# sourceMappingURL=store.js.map

package/lib/types/client/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/client/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,GAEzB,MAAM,qBAAqB,CAAC;AAiC7B,SAAS,kBAAkB,CAAC,KAAkB,EAAE,KAAoB;IAClE,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC;IAC5B,KAAK,CAAC,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC9C,KAAK,CAAC,WAAW,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,CAAC;QACjB,IAAI,EAAE,GAAgB,EAAE,CAAC,CAAC;YACxB,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,IAAI;YACd,mBAAmB,EAAE,UAAU;YAC/B,aAAa,EAAE,sBAAsB;YACrC,YAAY,EAAE,KAAK;YACnB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,KAAK;SACnB,CAAC;QACF,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE;YACP,WAAW,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,KAAc,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;YACrF,aAAa,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC;YAChD,SAAS,EAAE,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;YAC/D,WAAW,EAAE,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;gBACrC,kBAAkB,CAAC,KAAK,EAAE,KAAK;oBAC7B,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACrC,CAAC,CAAC,CAAC,CAAC,CAAC;YACT,CAAC;YACD,sBAAsB,EAAE,CAAC,KAAK,EAAE,KAA0B,EAAE,EAAE,GAAG,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC,CAAC,CAAC;YACrG,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAoB,EAAE,EAAE,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;YACxF,eAAe,EAAE,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE,GAAG,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC;YAC3E,UAAU,EAAE,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC;SAClE;KACF,CAAC,CAAC;AACL,CAAC"}

package/lib/types/client/stream-buffer.d.ts

@@ -0,0 +1,37 @@
+/** Presentation only. The original session string remains the source of truth. */
+export declare const STREAM_TIMING: {
+    readonly catchUpMs: 520;
+    readonly maxQueuedMs: 600;
+    readonly finishMs: 96;
+    readonly revealMs: 350;
+    readonly minimumRate: 260;
+    /** Weight of the newest arrival sample in the smoothed source rate. */
+    readonly rateWeight: 0.35;
+    /** A longer gap is a pause between runs, not a slow model: keep the estimate. */
+    readonly rateGapMs: 250;
+};
+export declare class StreamBuffer {
+    target: string;
+    visible: string;
+    revision: number;
+    private boundaries;
+    private arrivals;
+    private lastAt;
+    private credit;
+    private finishAt;
+    private rateEwma;
+    private lastArrival;
+    constructor(initial?: string);
+    get pending(): boolean;
+    private segment;
+    /** Non-append updates, cancellations and hidden/reduced views never replay. */
+    update(text: string, now: number, options?: {
+        immediate?: boolean;
+        finished?: boolean;
+    }): void;
+    /** Smoothed source rate, so one jittery transport chunk cannot set the pace. */
+    private observe;
+    flush(): void;
+    advance(now: number): boolean;
+}
+//# sourceMappingURL=stream-buffer.d.ts.map

package/lib/types/client/stream-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-buffer.d.ts","sourceRoot":"","sources":["../../../src/client/stream-buffer.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAOlF,eAAO,MAAM,aAAa;;;;;;IAMxB,uEAAuE;;IAEvE,iFAAiF;;CAEzE,CAAC;AAcX,qBAAa,YAAY;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,SAAK;IACb,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAAuB;gBAE9B,OAAO,SAAK;IAMxB,IAAI,OAAO,IAAI,OAAO,CAAqD;IAE3E,OAAO,CAAC,OAAO;IAOf,+EAA+E;IAC/E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IA0BlG,gFAAgF;IAChF,OAAO,CAAC,OAAO;IAYf,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CA4B9B"}

package/lib/types/client/stream-buffer.js

@@ -0,0 +1,150 @@
+/** Presentation only. The original session string remains the source of truth. */
+// The reveal runs at the rate the source is actually producing (feed-forward)
+// plus a proportional term that closes whatever backlog jitter left behind.
+// A proportional-only controller drains exactly one window per window, so the
+// display trails live output by catchUpMs forever — unreadable-but-smooth at
+// 75 chars/s, permanently behind at 1000. The feed-forward term is what makes
+// the pace adapt to the model instead of to a fixed constant.
+export const STREAM_TIMING = {
+    catchUpMs: 520,
+    maxQueuedMs: 600,
+    finishMs: 96,
+    revealMs: 350,
+    minimumRate: 260,
+    /** Weight of the newest arrival sample in the smoothed source rate. */
+    rateWeight: 0.35,
+    /** A longer gap is a pause between runs, not a slow model: keep the estimate. */
+    rateGapMs: 250,
+};
+const graphemes = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+function atOrAfter(values, target) {
+    let low = 0;
+    let high = values.length - 1;
+    while (low < high) {
+        const middle = (low + high) >>> 1;
+        if (values[middle] < target)
+            low = middle + 1;
+        else
+            high = middle;
+    }
+    return low;
+}
+export class StreamBuffer {
+    target;
+    visible;
+    revision = 0;
+    boundaries = [0];
+    arrivals = [];
+    lastAt = null;
+    credit = 0;
+    finishAt = null;
+    rateEwma = 0;
+    lastArrival = null;
+    constructor(initial = '') {
+        this.target = initial;
+        this.visible = initial;
+        this.segment(0);
+    }
+    get pending() { return this.visible.length < this.target.length; }
+    segment(from) {
+        const index = atOrAfter(this.boundaries, from);
+        this.boundaries.length = index;
+        for (const part of graphemes.segment(this.target.slice(from)))
+            this.boundaries.push(from + part.index);
+        if (this.boundaries.at(-1) !== this.target.length)
+            this.boundaries.push(this.target.length);
+    }
+    /** Non-append updates, cancellations and hidden/reduced views never replay. */
+    update(text, now, options = {}) {
+        if (options.immediate || !text.startsWith(this.target)) {
+            if (text !== this.target)
+                this.revision++;
+            this.target = text;
+            this.flush();
+            this.boundaries = [0];
+            this.segment(0);
+            return;
+        }
+        if (text !== this.target) {
+            const wasPending = this.pending;
+            const grew = text.length - this.target.length;
+            const from = this.boundaries.at(-2) ?? 0;
+            this.observe(grew, now);
+            this.target = text;
+            // Re-segment the previous last cluster: an emoji/combining sequence can
+            // itself span transport chunks. Frozen source prefixes are not scanned.
+            this.segment(from);
+            this.arrivals.push({ end: text.length, at: now });
+            if (!wasPending) {
+                this.lastAt = now;
+                this.credit = 0;
+            }
+        }
+        if (options.finished && this.finishAt === null)
+            this.finishAt = now + STREAM_TIMING.finishMs;
+        if (!options.finished)
+            this.finishAt = null;
+        if (this.target.length - this.visible.length > 8192) {
+            this.revision++;
+            this.flush();
+        }
+    }
+    /** Smoothed source rate, so one jittery transport chunk cannot set the pace. */
+    observe(grew, now) {
+        const previous = this.lastArrival;
+        this.lastArrival = now;
+        if (previous === null || grew <= 0)
+            return;
+        const elapsed = now - previous;
+        if (elapsed <= 0 || elapsed > STREAM_TIMING.rateGapMs)
+            return;
+        const sample = grew * 1000 / elapsed;
+        this.rateEwma = this.rateEwma === 0
+            ? sample
+            : this.rateEwma * (1 - STREAM_TIMING.rateWeight) + sample * STREAM_TIMING.rateWeight;
+    }
+    flush() {
+        this.visible = this.target;
+        this.arrivals = [];
+        this.credit = 0;
+        this.lastAt = null;
+        this.lastArrival = null;
+        this.finishAt = null;
+    }
+    advance(now) {
+        if (!this.pending)
+            return false;
+        const before = this.visible.length;
+        const index = atOrAfter(this.boundaries, before);
+        const remaining = this.boundaries.length - index - 1;
+        const delta = Math.max(0, now - (this.lastAt ?? now));
+        this.lastAt = now;
+        const windowMs = this.finishAt === null ? STREAM_TIMING.catchUpMs : Math.max(16, Math.min(STREAM_TIMING.catchUpMs, this.finishAt - now));
+        // Feed-forward keeps pace with the source; the proportional term then drains
+        // whatever backlog is left, so lag decays instead of settling at one window.
+        const rate = Math.max(STREAM_TIMING.minimumRate, this.rateEwma + remaining * 1000 / windowMs);
+        this.credit += rate * delta / 1000;
+        const count = Math.floor(this.credit);
+        this.credit -= count;
+        let end = this.boundaries[Math.min(this.boundaries.length - 1, index + count)];
+        for (const item of this.arrivals) {
+            if (now - item.at < STREAM_TIMING.maxQueuedMs)
+                break;
+            end = Math.max(end, this.boundaries[atOrAfter(this.boundaries, item.end)]);
+        }
+        if (this.finishAt !== null && now >= this.finishAt)
+            end = this.target.length;
+        // Never expose half of a surrogate pair while the source can still grow.
+        if (end && /[\uD800-\uDBFF]/.test(this.target[end - 1]) && this.finishAt === null)
+            end--;
+        end = Math.max(before, end);
+        this.visible = this.target.slice(0, end);
+        this.arrivals = this.arrivals.filter(item => item.end > end);
+        if (!this.pending) {
+            this.credit = 0;
+            this.lastAt = null;
+        }
+        return end !== before;
+    }
+}
+//# sourceMappingURL=stream-buffer.js.map

package/lib/types/client/stream-buffer.js.map

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

package/lib/types/client/streaming.d.ts

@@ -0,0 +1,18 @@
+export declare const StreamMotionContext: import("react").Context<{
+    enabled: boolean;
+    activatedAt: number;
+    paused?: boolean;
+    resumed?: boolean;
+}>;
+export declare function useStreamingText(source: string, streaming: boolean, options: {
+    startedAt?: number;
+    interrupted: boolean;
+    selected: boolean;
+}): {
+    text: string;
+    pending: boolean;
+    revision: number;
+    formatStreaming: boolean;
+    reveal: boolean;
+};
+//# sourceMappingURL=streaming.d.ts.map

package/lib/types/client/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../../src/client/streaming.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB;aAA4B,OAAO;iBAAe,MAAM;aAAW,OAAO;cAAY,OAAO;EAAuC,CAAC;AAErK,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE;;;;;;EA+D5I"}

package/lib/types/client/streaming.js

@@ -0,0 +1,84 @@
+import { createContext, useContext, useEffect, useLayoutEffect, useRef, useState } from 'react';
+import { StreamBuffer } from './stream-buffer.js';
+import { WORD_MOTION } from './word-timeline.js';
+export const StreamMotionContext = createContext({ enabled: false, activatedAt: 0 });
+export function useStreamingText(source, streaming, options) {
+    const { enabled, activatedAt, paused = false, resumed = false } = useContext(StreamMotionContext);
+    const fresh = resumed || (options.startedAt ?? 0) >= activatedAt;
+    const buffer = useRef();
+    // Only newly mounted content after a fold uses the catch-up path. History and
+    // user-opened drawers stay immediate; already mounted prefixes never replay.
+    if (!buffer.current)
+        buffer.current = new StreamBuffer(enabled && (streaming || resumed) && fresh ? '' : source);
+    const [display, setDisplay] = useState(() => ({ text: buffer.current.visible, revision: 0 }));
+    const [finalizing, setFinalizing] = useState(streaming);
+    const frame = useRef(0);
+    const immediate = !enabled || options.interrupted || options.selected;
+    const publish = () => {
+        const current = buffer.current;
+        setDisplay(previous => previous.text === current.visible && previous.revision === current.revision ? previous : { text: current.visible, revision: current.revision });
+    };
+    const handoff = useRef(resumed);
+    const presentationClock = useRef(performance.now());
+    useLayoutEffect(() => {
+        cancelAnimationFrame(frame.current);
+        const current = buffer.current;
+        // While the choreography holds the reveal, keep the buffer absorbing the
+        // source instead of returning early: the target must never lag behind what
+        // arrived, or the text would keep catching up long after the fold settled.
+        // Dropping the frame loop is what pauses the reveal; the target still tracks.
+        if (paused && !immediate && !document.hidden) {
+            current.update(source, performance.now(), { immediate: false, finished: !streaming });
+            publish();
+            return;
+        }
+        let previous = performance.now();
+        current.update(source, handoff.current ? presentationClock.current : previous, { immediate: immediate || document.hidden, finished: !streaming && !resumed });
+        publish();
+        const tick = (now) => {
+            // A delayed browser frame must not dump the whole buffered response at
+            // first paint. Bound catch-up by visible frame time for this handoff only.
+            presentationClock.current += Math.min(32, Math.max(0, now - previous));
+            previous = now;
+            if (document.hidden)
+                current.flush();
+            else
+                current.advance(handoff.current ? presentationClock.current : now);
+            publish();
+            if (current.pending)
+                frame.current = requestAnimationFrame(tick);
+            else
+                handoff.current = false;
+        };
+        if (current.pending)
+            frame.current = requestAnimationFrame(tick);
+        return () => cancelAnimationFrame(frame.current);
+    }, [source, streaming, immediate, paused, resumed]);
+    useEffect(() => {
+        const hidden = () => {
+            if (!document.hidden)
+                return;
+            cancelAnimationFrame(frame.current);
+            buffer.current.flush();
+            publish();
+            setFinalizing(false);
+        };
+        document.addEventListener('visibilitychange', hidden);
+        return () => document.removeEventListener('visibilitychange', hidden);
+    }, []);
+    const pending = display.text !== source;
+    useEffect(() => {
+        if (streaming || pending) {
+            setFinalizing(true);
+            return;
+        }
+        if (immediate || document.hidden) {
+            setFinalizing(false);
+            return;
+        }
+        const timer = setTimeout(() => setFinalizing(false), WORD_MOTION.duration + WORD_MOTION.maxDelay);
+        return () => clearTimeout(timer);
+    }, [streaming, pending, immediate]);
+    return { text: immediate ? source : display.text, pending: !immediate && pending, revision: display.revision, formatStreaming: streaming || (!immediate && (pending || finalizing)), reveal: enabled && !options.interrupted && !options.selected };
+}
+//# sourceMappingURL=streaming.js.map

package/lib/types/client/streaming.js.map

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

package/lib/types/client/timeline.d.ts

@@ -0,0 +1,26 @@
+export interface TimelineItem {
+    readonly turn: number;
+    readonly prompt: string;
+    readonly response: string;
+    readonly hasDeliverables: boolean;
+    readonly anchor: {
+        readonly kind: 'loaded';
+        readonly key: string;
+    } | {
+        readonly kind: 'unloaded';
+        readonly seq: number;
+    };
+}
+interface LoadedTurnNavigationItem {
+    readonly turn: number;
+    readonly anchorKey: string;
+    readonly prompt: string;
+    readonly response: string;
+}
+/**
+ * Merge host turn outline with loaded navigation items and turn deliverables.
+ * Guarantees strictly ascending turn order and dedupes entries.
+ */
+export declare function mergeTimelineItems(loaded: readonly LoadedTurnNavigationItem[] | undefined, outline: unknown, turnsWithDeliverables?: ReadonlySet<number>): readonly TimelineItem[];
+export {};
+//# sourceMappingURL=timeline.d.ts.map

package/lib/types/client/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../src/client/timeline.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,MAAM,EACX;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GACjD;QAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AASD,UAAU,wBAAwB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,wBAAwB,EAAE,GAAG,SAAS,EACvD,OAAO,EAAE,OAAO,EAChB,qBAAqB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC1C,SAAS,YAAY,EAAE,CA0CzB"}