indusagi-coding-agent 0.2.3 → 0.2.5

package/dist/types/runtime-bridge/runtime-bridge.test.d.ts

@@ -1,17 +0,0 @@
-/**
- * Phase 5 runtime-bridge — behavioral tests.
- *
- * Exercises the provider-routing layer end to end with **no real CLI spawned**:
- * every external exchange is driven over a hand-written fake {@link ChildTransport}
- * that replays scripted {@link ChildMessage}s. Four properties are pinned:
- *
- *   (1) the single {@link BridgeEventSink} maps a {@link NormalizedEvent} sequence
- *       onto the right framework {@link AssistantMessageEventStream} events;
- *   (2) the `claude-cli` {@link RuntimeBridge}, driven over a fake transport,
- *       produces a text + finish event stream;
- *   (3) {@link RuntimeBroker.route} (and the dispatch half, `exchange`) picks the
- *       external bridge for a model carrying an {@link ExternalRuntimeSpec} and the
- *       framework path otherwise;
- *   (4) `requiresCredential` reflects the spec's `authMode`.
- */
-export {};

package/dist/types/runtime-bridge/sink.d.ts

@@ -1,59 +0,0 @@
-/**
- * The single {@link BridgeEventSink} implementation — the one place the
- * imperative push-stream idiom every bridge shares is written down.
- *
- * Each external runtime emits its own wire dialect; a bridge's parser maps that
- * dialect onto the provider-neutral {@link NormalizedEvent} union and drives a
- * sink. This module owns everything else:
- *
- *   - the accumulating {@link AssistantMessage} `partial` that every framework
- *     event carries (built in-place exactly like the framework's own producers,
- *     so a runtime-backed turn is indistinguishable from a network turn to the
- *     consumer);
- *   - the content-block index bookkeeping (a block's index is its position in
- *     `partial.content`, opened lazily on first emission of its kind);
- *   - the lazily-started lifecycle (`start` is implicit on first emission, and
- *     idempotent) and the terminal `finishSuccess` / `finishError` settle;
- *   - the `NormalizedEvent -> framework event` mapping, in {@link emit}, so the
- *     per-bridge code stays a pure parser.
- *
- * The framework push surface this writes through —
- * `pushStart / pushTextStart / pushTextDelta / pushTextEnd /
- *  pushThinkingStart / pushThinkingDelta / pushThinkingEnd /
- *  pushToolCallStart / pushToolCallDelta / pushToolCallEnd /
- *  pushDone / pushError` on {@link AssistantMessageEventStream} — is consumed
- * verbatim from the framework; this module never re-derives event shapes.
- *
- * Streaming contract honored (matching the framework's own adapters): a text or
- * thinking block opens with a `*_start` once the block has been appended to
- * `partial.content`, streams `*_delta`s while the running content accumulates
- * in-place, and closes with a `*_end` carrying the final content. A tool call is
- * a single self-contained block (`start -> delta(args) -> end`). The terminal
- * `done` / `error` event carries the fully-accumulated message.
- */
-import type { AssistantMessage, BridgeEventSink } from "./contract";
-/**
- * The model-identity fields stamped onto every `partial` {@link AssistantMessage}
- * the sink emits. A bridge supplies these from the bound {@link Model} so a
- * runtime-backed turn reports the same `api` / `provider` / `model` triple a
- * network turn would — keeping the accumulated message uniform regardless of
- * which path produced it.
- */
-export interface BridgeMessageSeed {
-    /** The bound model's `api` dialect identifier. */
-    readonly api: AssistantMessage["api"];
-    /** The bound model's provider slug. */
-    readonly provider: AssistantMessage["provider"];
-    /** The bound model's id (the value stamped into `AssistantMessage.model`). */
-    readonly model: string;
-}
-/**
- * Construct a {@link BridgeEventSink} seeded with the bound model's identity.
- * The single sanctioned way a bridge obtains a sink: it creates one, drives it
- * with {@link NormalizedEvent}s (or the convenience emitters), and returns
- * {@link BridgeEventSink.stream}. The imperative push idiom lives entirely
- * inside the returned sink.
- *
- * @param seed the bound model's `api` / `provider` / `model` identity
- */
-export declare function createBridgeSink(seed: BridgeMessageSeed): BridgeEventSink;

package/dist/types/sessions/contract.d.ts

@@ -1,79 +0,0 @@
-/**
- * Session Library contract — the value types the library surface speaks in.
- *
- * The library sits on top of the conductor's persistent transcript store: it
- * enumerates the session files a workspace has accumulated, opens one back into
- * a live {@link TranscriptStore}, and projects the resulting node tree into the
- * flat shapes a navigator and a forking picker consume.
- *
- * These records are the *catalog/navigation* projections — the minimum a chooser
- * UI needs. They deliberately hold no framework message objects: text is already
- * reduced to a short preview, and identity is carried by stable string ids so a
- * caller can list, rename, delete, walk, and fork without rehydrating payloads.
- */
-/**
- * One persisted session as the library catalogs it — what a chooser shows in a
- * list before anything is opened.
- *
- * `id` is the bare session identifier (the filename stem the conductor's
- * filesystem backend writes to); `path` is its absolute on-disk location. The
- * remaining fields are best-effort enrichments filled when the library is asked
- * to peek inside a file: a derived `name`, file `lastModified`/`size`, the
- * `messageCount` of conversational nodes, and a short `preview` of the opening
- * user turn. Any of them may be absent when only a shallow listing was taken.
- */
-export interface SavedSession {
-    /** Bare session identifier — the filename stem, no extension or directory. */
-    readonly id: string;
-    /** Absolute on-disk path the session persists to. */
-    readonly path: string;
-    /** Human-facing label for the session, when one could be derived. */
-    readonly name?: string;
-    /** Last-modified wall-clock time of the file, in epoch milliseconds. */
-    readonly lastModified?: number;
-    /** Byte size of the session file on disk. */
-    readonly size?: number;
-    /** Count of conversational (user/assistant/tool) nodes in the transcript. */
-    readonly messageCount?: number;
-    /** Short single-line excerpt of the opening turn, for at-a-glance recognition. */
-    readonly preview?: string;
-}
-/**
- * One row in the flattened view of a loaded transcript tree.
- *
- * The conductor stores a branchable tree of nodes; a navigator wants a single
- * ordered list it can render and select against. Each {@link BranchNode} names
- * its `id`, its `parent` link (so a caller can still reconstruct the tree),
- * a render-ready `label`, the indentation `depth` from the root, and two flags:
- * `isLeaf` for a tip of the tree and `isCurrent` for the node the active head
- * points at.
- */
-export interface BranchNode {
-    /** Stable id of the underlying transcript node. */
-    readonly id: string;
-    /** Parent node id, or `null` for a transcript root. */
-    readonly parent: string | null;
-    /** Render-ready, depth-indented one-line label. */
-    readonly label: string;
-    /** Distance from the root (a root is depth 0). */
-    readonly depth: number;
-    /** True when this node has no children — a tip of the tree. */
-    readonly isLeaf: boolean;
-    /** True when the active head currently points at this node. */
-    readonly isCurrent: boolean;
-}
-/**
- * A past user turn offered as a fork point.
- *
- * To re-ask or re-edit an earlier prompt, a caller picks one of these and the
- * conductor branches the transcript at `entryId`. `text` is the full prompt
- * text; `preview` is the trimmed single-line form a picker renders.
- */
-export interface PriorTurn {
-    /** Id of the transcript node this user turn lives on (the fork target). */
-    readonly entryId: string;
-    /** Full text of the user prompt. */
-    readonly text: string;
-    /** Trimmed single-line excerpt of {@link text}, for display. */
-    readonly preview: string;
-}

package/dist/types/sessions/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * Sessions subsystem — public barrel.
- *
- * Exposes the {@link SessionLibrary} (the catalog-and-navigation layer over the
- * conductor's persisted transcripts) and its value contract — the
- * {@link SavedSession} catalog row, the {@link BranchNode} navigator row, and
- * the {@link PriorTurn} fork candidate. Consumers import the session-library
- * surface from `src/sessions` rather than reaching into the individual modules.
- */
-export type { SavedSession, BranchNode, PriorTurn } from "./contract";
-export { SessionLibrary, type SessionLibraryOptions } from "./library";

package/dist/types/sessions/library.d.ts

@@ -1,95 +0,0 @@
-/**
- * SessionLibrary — the catalog-and-navigation layer over persisted transcripts.
- *
- * The conductor owns a single session at a time as a {@link TranscriptStore}.
- * The library owns the *collection*: it scans the workspace `sessions/`
- * directory for the NDJSON files the conductor's filesystem backend writes,
- * lists them as {@link SavedSession} catalog rows, opens any one back into a
- * live store via the store's own loader + {@link replay} reducer, and offers the
- * two read projections a chooser UI needs — a flattened {@link BranchNode} tree
- * for a branch navigator and a {@link PriorTurn} list for re-asking an earlier
- * prompt. It also performs the two file-level mutations a manager needs:
- * renaming and deleting a session on disk.
- *
- * The library never re-implements transcript parsing or message serialization —
- * it delegates entirely to the conductor's transcript-store surface
- * ({@link TranscriptStore}, {@link fsBackend}, {@link replay}). Its own logic is
- * purely the directory enumeration, the tree flatten, and the text reduction.
- */
-import { TranscriptStore } from "../conductor";
-import type { BranchNode, PriorTurn, SavedSession } from "./contract";
-/** Construction inputs — just the directory sessions live under. */
-export interface SessionLibraryOptions {
-    /** Absolute path to the workspace `sessions/` directory. */
-    readonly sessionsDir: string;
-}
-/**
- * The collection-level handle over a workspace's persisted sessions.
- *
- * Construct it with the resolved `sessionsDir` (from the workspace locator),
- * then call {@link list} / {@link open} / {@link rename} / {@link remove} to
- * manage files, and {@link tree} / {@link priorTurns} to project a loaded
- * transcript for navigation and forking.
- */
-export declare class SessionLibrary {
-    #private;
-    constructor(options: SessionLibraryOptions);
-    /** The sessions directory this library is rooted at. */
-    get directory(): string;
-    /**
-     * Enumerate persisted sessions as catalog rows, newest-modified first.
-     *
-     * Scans the directory for `*.ndjson` files and `stat`s each for its size and
-     * modification time. When `deep` is set, it also opens each file to fill in
-     * `messageCount` and the opening-turn `preview`; otherwise it returns the
-     * shallow rows (id/path/size/lastModified) so a large directory lists fast.
-     * A missing directory yields an empty list rather than an error.
-     */
-    list(options?: {
-        readonly deep?: boolean;
-    }): Promise<SavedSession[]>;
-    /**
-     * Open a persisted session back into a live, hydrated {@link TranscriptStore},
-     * or return `null` when no file with that id exists.
-     *
-     * Delegates to the store's own static opener, which reads the backend and
-     * rebuilds state through the {@link replay} reducer — the library adds nothing
-     * to the rehydration beyond binding the filesystem backend.
-     */
-    open(id: string): Promise<TranscriptStore | null>;
-    /**
-     * Rename a session file from one id to another, returning the new absolute
-     * path. The on-disk identifier *is* the filename stem, so this is a plain file
-     * move; the in-file head still names the old id, which the store tolerates on
-     * the next load (the head's leaf is what matters, not its session label).
-     *
-     * @throws if the source file is missing or the target id already exists.
-     */
-    rename(fromId: string, toId: string): Promise<string>;
-    /**
-     * Delete a session file. Returns `true` when a file was removed, `false` when
-     * there was nothing to delete — never throws on an already-absent session.
-     */
-    remove(id: string): Promise<boolean>;
-    /** Absolute path a session id persists to. */
-    pathOf(id: string): string;
-    /**
-     * Flatten a loaded transcript into an ordered {@link BranchNode} list for a
-     * tree navigator.
-     *
-     * Walks every node from each root downward in a stable depth-first order,
-     * emitting one row per node with its render label, depth indentation, leaf
-     * flag, and a current-marker derived from the store's active head. A node is a
-     * leaf when no other node names it as `parent`.
-     */
-    tree(store: TranscriptStore): BranchNode[];
-    /**
-     * Extract the user prompts along a loaded transcript's active branch as fork
-     * candidates, in chronological order.
-     *
-     * Reads the root→leaf branch the store currently points at (the conversation
-     * the agent would replay) and keeps only the user-role nodes that carry real
-     * text, projecting each to a {@link PriorTurn} a forking picker can offer.
-     */
-    priorTurns(store: TranscriptStore): PriorTurn[];
-}

package/dist/types/sessions/sessions.test.d.ts

@@ -1,11 +0,0 @@
-/**
- * SessionLibrary behavioral tests.
- *
- * Exercises the catalog-and-navigation layer end-to-end against a real temp
- * `sessions/` directory: we seed a couple of sessions by driving real
- * {@link TranscriptStore}s over a filesystem backend (so the on-disk NDJSON is
- * the genuine format), then assert the library lists them, opens them, flattens
- * the branch tree, and extracts prior user turns. File mutations (rename/remove)
- * are checked too. No network, no framework agent — just disk + the store.
- */
-export {};

package/dist/types/settings/contract.d.ts

@@ -1,175 +0,0 @@
-/**
- * Settings subsystem — the typed surface of the user-tunable preferences an
- * interactive coding-agent session reads at startup and while it runs.
- *
- * This module declares *only* shapes and frozen defaults — no I/O, no class, no
- * filesystem. It is the single place every preference key is named, typed, and
- * given a fallback. The two-tier manager ({@link "./manager"}) is written
- * against the {@link Preferences} record declared here, and any console surface
- * that toggles a preference reads its value through the same record.
- *
- * Design stance:
- *   - Every key is optional on the record so a partially-written file is a
- *     legal {@link Preferences} value; the manager fills the gaps from
- *     {@link DEFAULT_PREFERENCES} when a reader asks for a concrete value.
- *   - Reasoning-effort vocabulary is borrowed from the framework
- *     ({@link ThinkingLevel}) rather than re-declared, so the agent and the UI
- *     speak the same words.
- *   - The other small string unions ({@link ColourScheme} is a free string,
- *     while {@link EscapeAction}) pin the surfaces a console reads.
- */
-import type { ThinkingLevel } from "indusagi/agent";
-/** Re-exported framework reasoning vocabulary, surfaced through this contract. */
-export type { ThinkingLevel };
-/**
- * What a double-tap of the escape key does in the interactive console.
- *
- *   - `tree`     — open the turn history as a navigable tree of branches.
- *   - `fork`     — open the prior-turn picker to branch off an earlier turn.
- *   - `clear`    — wipe the composer buffer.
- *
- * The legacy `rewind` / `branch` aliases are still accepted and treated as
- * `fork` / `tree` respectively so an older preference file keeps working.
- */
-export type EscapeAction = "tree" | "fork" | "clear" | "rewind" | "branch";
-/** Every {@link EscapeAction} value, as a frozen tuple for menus and guards. */
-export declare const ESCAPE_ACTIONS: readonly EscapeAction[];
-/** Narrow an arbitrary value to a known {@link EscapeAction}. */
-export declare function isEscapeAction(value: unknown): value is EscapeAction;
-/**
- * How a queue of pending turns (steering corrections or follow-up prompts) is
- * drained back into the run.
- *
- *   - `all`           — release every queued turn at once on the next handoff.
- *   - `one-at-a-time` — release a single queued turn per handoff.
- */
-export type DeliveryMode = "all" | "one-at-a-time";
-/** Every {@link DeliveryMode} value, as a frozen tuple for menus and guards. */
-export declare const DELIVERY_MODES: readonly DeliveryMode[];
-/** Narrow an arbitrary value to a known {@link DeliveryMode}. */
-export declare function isDeliveryMode(value: unknown): value is DeliveryMode;
-/**
- * How aggressively the per-tool permission gate auto-allows tool calls before it
- * falls back to asking (or denying):
- *
- *   - `default`      — consult the allow/ask/deny rules; read-only tools are
- *                      auto-allowed, anything else with no matching allow rule
- *                      falls through to `ask`.
- *   - `acceptEdits`  — additionally auto-allow filesystem edits/writes (the
- *                      mutating edit/write/multiedit tools), leaving everything
- *                      else on the `default` path.
- *   - `bypass`       — allow every tool with no prompt (the unsafe "trust all"
- *                      mode; `bypassPermissions` is accepted as an alias).
- *   - `plan`         — deny every mutating tool outright (read-only research only)
- *                      so the agent can plan without touching the workspace.
- */
-export type PermissionMode = "default" | "acceptEdits" | "bypass" | "plan" | "bypassPermissions";
-/** The canonical {@link PermissionMode} values, as a frozen tuple for menus/guards. */
-export declare const PERMISSION_MODES: readonly PermissionMode[];
-/** Narrow an arbitrary value to a known {@link PermissionMode} (folds the alias). */
-export declare function isPermissionMode(value: unknown): value is PermissionMode;
-/**
- * The declarative permission policy a session reads at startup.
- *
- * `allow`/`ask`/`deny` are ordered lists of induscode-style rule strings — a bare
- * tool name (`"Bash"`) or a tool name with an argument specifier
- * (`"Bash(npm run test:*)"`). Across tiers the three lists are concatenated, and
- * `deny` wins over `ask` wins over `allow`. `defaultMode` seeds the session's
- * permission mode when no flag overrides it. Every field is optional so an empty
- * `{}` (or an absent `permissions` key) keeps today's allow-all behavior.
- */
-export interface PermissionSettings {
-    /** Rule strings that auto-allow a matching tool call (lowest precedence). */
-    allow?: string[];
-    /** Rule strings that force a matching tool call to prompt for approval. */
-    ask?: string[];
-    /** Rule strings that hard-block a matching tool call (highest precedence). */
-    deny?: string[];
-    /** The permission mode the session opens in when no flag overrides it. */
-    defaultMode?: PermissionMode;
-}
-/**
- * Every preference an interactive coding-agent session reads, as one flat,
- * fully-optional record.
- *
- * A value of this type may be the empty object (a brand-new install), a sparse
- * project override, or a fully-populated global file — all three are legal.
- * Concrete reads always go through the manager, which layers the project file
- * over the global file over {@link DEFAULT_PREFERENCES}, so a reader never sees
- * `undefined` for a key with a default.
- */
-export interface Preferences {
-    /** Named colour scheme the console renders with (e.g. `"midnight"`). */
-    colourScheme?: string;
-    /** Whether inline image content is rendered in the transcript. */
-    showImages?: boolean;
-    /** Whether the model's reasoning / thinking text is shown as it streams. */
-    showReasoning?: boolean;
-    /** When true, the reasoning block is folded away even if the model emits one. */
-    hideThinking?: boolean;
-    /** Whether oversized images are shrunk to fit before being handed to a provider. */
-    imageAutoResize?: boolean;
-    /** When true, image content is withheld from providers entirely. */
-    blockImages?: boolean;
-    /** Whether discovered skills are surfaced as their own slash commands. */
-    enableSkillCommands?: boolean;
-    /** How queued steering corrections are released back into the run. */
-    steeringMode?: DeliveryMode;
-    /** How queued follow-up prompts are released back into the run. */
-    followUpMode?: DeliveryMode;
-    /** Prefer a condensed changelog after the console updates itself. */
-    collapseChangelog?: boolean;
-    /** Reveal the terminal's own cursor instead of the software-drawn caret. */
-    showHardwareCursor?: boolean;
-    /** Horizontal padding, in columns, around the prompt editor. */
-    editorPaddingX?: number;
-    /** Glob / id patterns selecting which models appear in the picker; empty means all. */
-    enabledModels?: string[];
-    /** Provider id the session defaults to when none is named (e.g. `"anthropic"`). */
-    defaultProvider?: string;
-    /** Model id the session opens with under {@link defaultProvider}. */
-    defaultModel?: string;
-    /** Reasoning effort the session requests by default. */
-    defaultThinkingLevel?: ThinkingLevel;
-    /** Suppress the banner / tips shown on a normal interactive launch. */
-    quietStartup?: boolean;
-    /**
-     * The last product version whose full masthead the user has already seen. The
-     * banner auto-condenses to a one-line header when this equals the running
-     * version (and nothing else demands the full block); it is rewritten to the
-     * running version after the full masthead is shown, so a launch only shows the
-     * big wordmark on the first sight of a version or a version bump.
-     */
-    lastSeenVersion?: string;
-    /** Opt-in static colour-sweep flourish tinting the startup wordmark / emblem. */
-    logoSweep?: boolean;
-    /** When set, motion-flavoured flourishes (e.g. the logo sweep) are suppressed. */
-    reducedMotion?: boolean;
-    /** Whether the window-budget manager compacts the transcript automatically. */
-    autoCompact?: boolean;
-    /** What a double-escape does in the console. */
-    doubleEscapeAction?: EscapeAction;
-    /** Extension-package sources the launcher installs and loads (npm / git / local). */
-    extensionPackages?: string[];
-    /**
-     * The declarative tool-permission policy: ordered allow/ask/deny rule lists and
-     * the opening permission mode. Across the project/global tiers the rule lists
-     * are concatenated (not overridden) and `deny > ask > allow` decides; an absent
-     * value (or an empty object) preserves today's allow-all behavior.
-     */
-    permissions?: PermissionSettings;
-}
-/** The set of legal preference keys, derived from {@link Preferences}. */
-export type SettingKey = keyof Preferences;
-/**
- * The fallback value for every preference, used whenever neither the project
- * nor the global tier supplies a key.
- *
- * Frozen so it can be shared without a defensive copy; the manager spreads it
- * rather than mutating it. Every key in {@link Preferences} appears here with a
- * concrete (non-`undefined`) value, which is what lets a typed reader resolve a
- * guaranteed result.
- */
-export declare const DEFAULT_PREFERENCES: Required<Preferences>;
-/** Every preference key, as a frozen tuple for iteration and validation. */
-export declare const SETTING_KEYS: readonly SettingKey[];

package/dist/types/settings/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * Settings subsystem — public barrel.
- *
- * One import site for the typed {@link Preferences} record and its
- * {@link SettingKey} / {@link EscapeAction} / {@link ThinkingLevel}
- * vocabularies, the frozen {@link DEFAULT_PREFERENCES}, and the two-tier
- * {@link PreferenceStore} reader/writer. Console surfaces and boot stages depend
- * on this module rather than reaching into the individual files.
- */
-export type { Preferences, SettingKey, EscapeAction, DeliveryMode, ThinkingLevel, PermissionMode, PermissionSettings, } from "./contract";
-export { DEFAULT_PREFERENCES, SETTING_KEYS, ESCAPE_ACTIONS, isEscapeAction, DELIVERY_MODES, isDeliveryMode, PERMISSION_MODES, isPermissionMode, } from "./contract";
-export { PreferenceStore } from "./manager";
-export type { PreferenceLocations } from "./manager";

package/dist/types/settings/manager.d.ts

@@ -1,109 +0,0 @@
-/**
- * Settings manager — the two-tier reader/writer over the preference record.
- *
- * Two files back the same {@link Preferences} shape:
- *
- *   - the **global** file, one per machine, living in the resolved workspace
- *     profile directory ({@link Workspace.settingsPath});
- *   - the **project** file, one per checkout, living beside the working tree in
- *     a brand-named config directory.
- *
- * A read layers the project tier over the global tier over
- * {@link DEFAULT_PREFERENCES}: a key set in the project file wins, then the
- * global file, then the built-in default — so a reader of {@link PreferenceStore.get}
- * always receives a concrete value. A write through {@link PreferenceStore.set}
- * lands in the **project** tier only; the global file is left untouched, which
- * keeps a per-checkout override from silently leaking machine-wide.
- *
- * Loading is tolerant: a missing file is the empty record, and a corrupt file
- * (bad JSON, or a JSON value that is not an object) degrades to the empty record
- * rather than throwing, so one mangled file never blocks startup.
- *
- * Construction is injectable. {@link PreferenceStore.fromWorkspace} resolves the
- * two paths from a {@link Workspace} and the working directory; {@link PreferenceStore.atPaths}
- * pins both paths directly, which is what the tests drive against a temp dir so
- * the real home is never read or written.
- */
-import type { Workspace } from "../boot/contract";
-import { type Preferences, type SettingKey } from "./contract";
-/**
- * The resolved location of the two preference tiers.
- *
- * Both are absolute paths. The {@link global} file is machine-wide; the
- * {@link project} file is per-checkout. Either may be absent on disk — the
- * store treats a missing file as the empty record.
- */
-export interface PreferenceLocations {
-    /** Machine-wide preference file (the global tier). */
-    readonly global: string;
-    /** Per-checkout preference file (the project tier). */
-    readonly project: string;
-}
-/**
- * Two-tier preference store: project-over-global-over-default on read, and a
- * project-tier write on save.
- *
- * Construct via {@link fromWorkspace} (resolve from the workspace + cwd) or
- * {@link atPaths} (pin both files explicitly, as the tests do). Internally the
- * two tiers are held in memory and refreshed from disk on construction and on
- * {@link reload}; {@link set} stages a change into the in-memory project tier
- * and {@link save} flushes it.
- */
-export declare class PreferenceStore {
-    private readonly locations;
-    private globalTier;
-    private projectTier;
-    private constructor();
-    /**
-     * Build a store whose two tiers are pinned to explicit absolute paths.
-     *
-     * The direct seam used by tests: point both files at a temp dir and the real
-     * home is never touched. Neither file needs to exist yet.
-     */
-    static atPaths(locations: PreferenceLocations): PreferenceStore;
-    /**
-     * Build a store from a resolved {@link Workspace} (global tier) and a working
-     * directory (project tier).
-     *
-     * The global file is {@link Workspace.settingsPath}; the project file is
-     * `<cwd>/<brand profile dir>/settings.json`, so a checkout carries its own
-     * overrides next to its source. `cwd` defaults to the process working
-     * directory.
-     */
-    static fromWorkspace(workspace: Workspace, cwd?: string): PreferenceStore;
-    /** The two resolved file locations this store reads and writes. */
-    paths(): PreferenceLocations;
-    /** Re-read both tiers from disk, discarding any unsaved staged change. */
-    reload(): void;
-    /**
-     * Read one preference, resolved across the tiers.
-     *
-     * Precedence is project → global → {@link DEFAULT_PREFERENCES}: the first tier
-     * that defines the key (with a non-`undefined` value) wins. The return type is
-     * the concrete default-backed type for the key, so callers never branch on
-     * `undefined`.
-     */
-    get<K extends SettingKey>(key: K): Required<Preferences>[K];
-    /**
-     * Stage a preference into the in-memory **project** tier.
-     *
-     * Does not write to disk on its own — call {@link save} to persist. Setting a
-     * key to `undefined` clears the project-tier override for it, letting the
-     * value fall back to the global tier or the default on the next read.
-     */
-    set<K extends SettingKey>(key: K, value: Preferences[K]): void;
-    /** The fully-resolved snapshot: defaults under global under project. */
-    snapshot(): Required<Preferences>;
-    /** The raw in-memory project tier (the keys a checkout overrides). */
-    projectOverrides(): Preferences;
-    /** The raw in-memory global tier (machine-wide keys). */
-    globalDefaults(): Preferences;
-    /**
-     * Persist the staged in-memory **project** tier to its file.
-     *
-     * Writes the project tier only; the global file is never rewritten here, so a
-     * per-checkout `set` cannot mutate machine-wide preferences. Creates the
-     * containing directory if it is missing.
-     */
-    save(): void;
-}

package/dist/types/settings/settings.test.d.ts

@@ -1,16 +0,0 @@
-/**
- * Settings subsystem — unit tests.
- *
- * Everything runs against a temp directory pinned through
- * {@link PreferenceStore.atPaths}; the real home is never read or written. The
- * tests pin the public store behaviour:
- *
- *   1. Defaults load: a store over two non-existent files resolves every key to
- *      its {@link DEFAULT_PREFERENCES} value.
- *   2. Precedence: a key present in both tiers reads from the project tier, and
- *      a key present only globally still resolves; a corrupt project file falls
- *      back to defaults without throwing.
- *   3. Round-trip: a `set` + `save` writes the project file, and a fresh store
- *      over the same paths reads the persisted value back.
- */
-export {};

package/dist/types/transcript-export/index.d.ts

@@ -1,20 +0,0 @@
-/**
- * Transcript-export subsystem — public barrel.
- *
- * The HTML transcript publisher and its supporting machinery: the table-driven
- * SGR painter ({@link paintSgr}) that turns terminal-styled output into safe HTML
- * spans, the {@link ThemeBridge} that computes export colors from an
- * {@link ExportTheme} via a WCAG luminance LUT, the regenerated page-shell
- * {@link PAGE_SHELL} template with its `{{TOKEN}}` slots and {@link fill} helper,
- * and {@link publishTranscript} which renders a session transcript to a
- * standalone HTML document using `marked`, `highlight.js`, and the painter.
- *
- * Consumers import the publish surface from `src/transcript-export` rather than
- * reaching into individual modules.
- */
-export { paintSgr, tokenizeSgr, foldSgr, SGR_CODE_TABLE } from "./sgr";
-export { DefaultThemeBridge, createThemeBridge, buildLuminanceLut, parseColor, formatColor, } from "./theme-bridge";
-export { PAGE_SHELL, PAGE_STYLES, CLIENT_SCRIPT, fill, type SlotValues, } from "./template";
-export { publishTranscript, type PublishEntry, type PublishMessage, type PublishRole, type MessagePart, } from "./publish";
-export { FALLBACK_EXPORT_THEME, SHELL_SLOTS, SGR_INITIAL_STATE, briefingFault, } from "../briefing/contract";
-export type { ExportTheme, ThemeBridge, ThemeMode, LuminanceLut, Rgb, SgrState, SgrToken, SgrMutation, PublishOptions, WidgetRender, TranscriptPart, ShellSlot, } from "../briefing/contract";